Référence du contexte de Fusion
Lorsque votre interface utilisateur appelle attach(...), Fusion partage un objet context décrivant la session en cours. Cette page répertorie tous les champs, ce qu’ils signifient et la manière dont les identifiants Fusion et Adobe IMS sont liés.
Comment lire le contexte
- Valeurs initiales :
connection.sharedContext.get("<key>") - Mises à jour : écouter l’événement
contextchange. Le dernier objet arrive surevent.detail.context.
Pour le modèle de code complet, voir Création de l’interface utilisateur de l’extension personnalisée.
const organization = connection.sharedContext.get("organization");
const fusionOrgId = organization?.id; // Fusion's organization id
const imsOrgId = connection.sharedContext.get("imsOrgId"); // Adobe IMS org id
Clés de niveau supérieur
imsTokenBearer pour appeler les API Adobe ou Fusion au nom de l’utilisateur. Comme il s’agit d’un élément sensible, ne le consignez ni n’affichez.imsOrgIdXXXXXXXXXXXX@AdobeOrg.imsUserIdorganizationorganization champs dans cet article.teamuseruser champs dans cet article.Fusion ID et IMS ID
Chaque entité possède un Fusion ID (utilisé par les propres API de Fusion) et, s’il existe, un Adobe IMS ID (utilisé par les API de la plateforme Adobe) :
organization.idimsOrgId (également exposé en tant que organization.externalOrgId)team.iduser.idimsUserIdorganization champs
Ces champs se trouvent dans l’enregistrement d’organisation actif. La plupart des extensions ne requièrent que des id, des name et les identifiants .
idnameexternalOrgIdimsOrgId).externalIdcountryIdtimezoneIdserviceNameteamIdslicensescenariosCountactiveScenariosactiveAppsoperations, operationsExttransfer, transferExtisPausedisDeletedimsEnabledusersCountteam champs
Ces champs sont présents lorsqu’une équipe est active. Vous devez fournir une solution de secours au cas où l’équipe est undefined (par exemple, sur un écran au niveau de l’organisation sans équipe sélectionnée).
idnameorganizationIdcountrytimezonelicenseactiveScenariosactiveAppsscenarioDraftsisDeleteduser champs
Ces champs s’appliquent à l’utilisateur Fusion connecté.
idnameemailavatarlocaleen.languagetimezonetimezoneIdcountryIdlocaleIdfeaturesallow_apps, public_templates).usersAdminsRoleIduser peut inclure des champs internes supplémentaires. Vous ne devez vous fier qu’aux champs documentés ici. D’autres champs peuvent être modifiés sans préavis et certains champs liés à l’authentification ne doivent jamais être consignés ni affichés.Dates
Le contexte est sérialisé avant d’atteindre votre extension. Par conséquent, les champs de date arrivent sous forme de chaînes (ISO 8601, tel que "2026-06-24T00:00:00.000Z"), et non d’objets de Date JavaScript. Vous pouvez les convertir si nécessaire :
const resetDate = new Date(context.organization.nextReset);
Mises à jour du contexte
Fusion renvoie l’ensemble du contexte (via contextchange) lorsque :
- l’utilisateur change d’organisation,
- l’utilisateur change d’équipe ou
- les informations de l’utilisateur connecté changent.
Lisez toujours à nouveau toutes les clés que vous utilisez dans votre gestionnaire de contextchange plutôt que de supposer qu’une seule valeur a été modifiée.
Bonnes pratiques en matière de sécurité
- Ne jamais enregistrer, afficher ou conserver les
imsToken. Traitez-le comme un mot de passe. - Envoyez le jeton uniquement aux points d’entrée Adobe/Fusion approuvés, via HTTPS, en tant que jeton
Bearer. - Ne stockez pas de données personnelles du contexte au-delà de ce dont votre fonctionnalité a besoin.
Utiliser le jeton pour appeler les API
Pour transformer imsToken (plus organization.id / team.id) en Workfront réel ou
Les données de fusion, vous ne pouvez pas appeler ces API directement à partir du navigateur, car CORS bloque
c’est ça. Acheminez plutôt l’appel via une petite action d’exécution App Builder. Voir
Appel des API Workfront et Fusion.
Pour continuer le processus de création d’une extension personnalisée, voir Publier votre extension.