La referencia de contexto de Fusion
Cuando la interfaz de usuario llama a attach(...), Fusion comparte un objeto context que describe la sesión actual. Esta página enumera todos los campos, qué significa y cómo se relacionan los identificadores IMS de Fusion y Adobe.
Cómo leer el contexto
- Valores iniciales:
connection.sharedContext.get("<key>") - Actualizaciones: Escuche el evento
contextchange. El objeto más reciente llega elevent.detail.context.
Para ver el patrón de código completo, consulte Generar la interfaz de usuario de la extensión personalizada.
const organization = connection.sharedContext.get("organization");
const fusionOrgId = organization?.id; // Fusion's organization id
const imsOrgId = connection.sharedContext.get("imsOrgId"); // Adobe IMS org id
Claves de nivel superior
imsTokenBearer para llamar a las API de Adobe o Fusion en nombre del usuario. Debido a que es confidencial, nunca lo registre ni lo muestre.imsOrgIdXXXXXXXXXXXX@AdobeOrg.imsUserIdorganizationorganization campos en este artículo.teamuseruser campos en este artículo.ID de Fusion e ID de IMS
Cada entidad tiene un Fusion ID (utilizado por las propias API de Fusion) y, si existe, un Adobe IMS ID (utilizado por las API de Adobe Platform):
organization.idimsOrgId (también expuesto como organization.externalOrgId)team.iduser.idimsUserIdorganization campos
Estos campos se encuentran en el registro de organización activo. La mayoría de las extensiones solo requieren id, name y los identificadores.
idnameexternalOrgIdimsOrgId).externalIdcountryIdtimezoneIdserviceNameteamIdslicensescenariosCountactiveScenariosactiveAppsoperations, operationsExttransfer, transferExtisPausedisDeletedimsEnabledusersCountteam campos
Estos campos están presentes cuando un equipo está activo. Debe proporcionar una reserva en caso de que el equipo sea undefined (por ejemplo, en una pantalla de nivel de organización sin ningún equipo seleccionado).
idnameorganizationIdcountrytimezonelicenseactiveScenariosactiveAppsscenarioDraftsisDeleteduser campos
Estos campos se aplican al usuario de Fusion que ha iniciado sesión.
idnameemailavatarlocaleen.languagetimezonetimezoneIdcountryIdlocaleIdfeaturesallow_apps, public_templates).usersAdminsRoleIduser puede incluir campos internos adicionales. Solo debe confiar en los campos documentados aquí. Otros campos pueden cambiar sin previo aviso y algunos campos relacionados con la autenticación nunca deben registrarse ni mostrarse.Fechas
El contexto se serializa antes de que llegue a su extensión, por lo que los campos de fecha se presentan como cadenas (ISO 8601, como "2026-06-24T00:00:00.000Z"), no como objetos de JavaScript Date. Puede convertirlos si es necesario:
const resetDate = new Date(context.organization.nextReset);
Actualizaciones de contexto
Fusion vuelve a enviar todo el contexto (a través de contextchange) cuando:
- el usuario cambia la organización,
- el usuario cambia de equipo, o
- cambia la información del usuario que inició sesión.
Vuelva a leer siempre todas las claves que utilice dentro del controlador contextchange en lugar de suponer que sólo ha cambiado un valor.
Prácticas recomendadas de seguridad
- Nunca registrar, mostrar ni mantener
imsToken. Trátelo como una contraseña. - Envíe el token solo a puntos finales de Adobe/Fusion de confianza, a través de HTTPS, como un token
Bearer. - No almacene datos personales del contexto más allá de lo que necesita su función.
Utilice el token para llamar a las API de
Para convertir imsToken (más organization.id / team.id) en Workfront real o
Los datos de Fusion no permiten llamar a estas API directamente desde el explorador, ya que CORS bloquea
it. En su lugar, enrute la llamada a través de una pequeña acción de tiempo de ejecución de App Builder. Consulte
Llamando a las API de Workfront y Fusion.
Para continuar el proceso de creación de una extensión personalizada, consulta Publicar tu extensión.