Riferimento al contesto di Fusion
Quando l’interfaccia utente chiama attach(...), Fusion condivide un oggetto context che descrive la sessione corrente. Questa pagina elenca tutti i campi, il loro significato e la correlazione tra gli identificatori Fusion e Adobe IMS.
Come leggere il contesto
- Valori iniziali:
connection.sharedContext.get("<key>") - Aggiornamenti: Ascolta l’evento
contextchange. L’oggetto più recente arriva ilevent.detail.context.
Per il modello di codice completo, vedi Creare l’interfaccia utente dell’estensione personalizzata.
const organization = connection.sharedContext.get("organization");
const fusionOrgId = organization?.id; // Fusion's organization id
const imsOrgId = connection.sharedContext.get("imsOrgId"); // Adobe IMS org id
Tasti di primo livello
imsTokenBearer per chiamare le API Adobe o Fusion per conto dell’utente. Poiché è sensibile, non registrarlo né visualizzarlo.imsOrgIdXXXXXXXXXXXX@AdobeOrg.imsUserIdorganizationorganization campi in questo articolo.teamuseruser campi in questo articolo.ID Fusion e ID IMS
Ogni entità ha un ID Fusion (utilizzato dalle API di Fusion) e, laddove esiste, un ID Adobe IMS (utilizzato dalle API della piattaforma Adobe):
organization.idimsOrgId (esposto anche come organization.externalOrgId)team.iduser.idimsUserIdorganization campi
Questi campi si trovano nel record organizzazione attivo. La maggior parte delle estensioni richiede solo id, name e gli identificatori.
idnameexternalOrgIdimsOrgId).externalIdcountryIdtimezoneIdserviceNameteamIdslicensescenariosCountactiveScenariosactiveAppsoperations, operationsExttransfer, transferExtisPausedisDeletedimsEnabledusersCountteam campi
Questi campi sono presenti quando un team è attivo. È necessario fornire un fallback nel caso in cui il team sia undefined (ad esempio in una schermata a livello di organizzazione senza team selezionato).
idnameorganizationIdcountrytimezonelicenseactiveScenariosactiveAppsscenarioDraftsisDeleteduser campi
Questi campi si applicano all’utente di Fusion connesso.
idnameemailavatarlocaleen.languagetimezonetimezoneIdcountryIdlocaleIdfeaturesallow_apps, public_templates).usersAdminsRoleIduser può includere campi interni aggiuntivi. Utilizza solo i campi qui documentati. Altri campi possono cambiare senza preavviso e alcuni campi correlati all’autenticazione non devono mai essere registrati o visualizzati.Date
Il contesto viene serializzato prima che raggiunga l’estensione, quindi i campi data arrivano come stringhe (ISO 8601, ad esempio "2026-06-24T00:00:00.000Z"), non come oggetti JavaScript Date. Se necessario, puoi convertire questi elementi:
const resetDate = new Date(context.organization.nextReset);
Aggiornamenti contestuali
Fusion invia nuovamente l’intero contesto (tramite contextchange) quando:
- l’utente cambia organizzazione,
- l’utente cambia team, oppure
- le informazioni dell’utente connesso sono state modificate.
Rileggere sempre tutte le chiavi utilizzate all’interno del gestore contextchange anziché presupporre che sia stato modificato un solo valore.
Best practice per la sicurezza
- Non registrare, visualizzare o mantenere
imsToken. Trattala come una password. - Invia il token solo agli endpoint attendibili di Adobe/Fusion, tramite HTTPS, come token
Bearer. - Non memorizzare dati personali dal contesto oltre ciò di cui la funzione ha bisogno.
Utilizza il token per chiamare le API
Per trasformare imsToken (più organization.id / team.id) in Workfront reale o
Fusion data, non è possibile chiamare tali API direttamente dal browser, perché CORS blocca
… Indirizza invece la chiamata tramite una piccola azione di runtime App Builder. Consulta
Chiamata delle API Workfront e Fusion.
Per continuare il processo di creazione di un’estensione personalizzata, vedere Pubblicare l’estensione.