A referência de contexto do Fusion
Quando sua interface chama attach(...), o Fusion compartilha um objeto context que descreve a sessão atual. Essa página lista cada campo, o que significa e como os identificadores do Fusion e do Adobe IMS se relacionam.
Como ler o contexto
- Valores iniciais:
connection.sharedContext.get("<key>") - Atualizações: Ouça o evento
contextchange. O último objeto chega emevent.detail.context.
Para obter o padrão de código completo, consulte Criar a interface de extensão 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
Chaves de nível superior
imsTokenBearer para chamar APIs do Adobe ou Fusion em nome do usuário. Por ser confidencial, nunca faça logon ou exiba.imsOrgIdXXXXXXXXXXXX@AdobeOrg.imsUserIdorganizationorganization campos neste artigo.teamuseruser campos neste artigo.Fusion ID e IMS ID
Cada entidade tem uma ID do Fusion (usada pelas próprias APIs do Fusion) e, quando ela existe, uma ID do Adobe IMS (usada pelas APIs da plataforma Adobe):
organization.idimsOrgId (também exposto como organization.externalOrgId)team.iduser.idimsUserIdorganization campos
Esses campos são encontrados no registro ativo da organização. A maioria das extensões requer apenas id, name e os identificadores.
idnameexternalOrgIdimsOrgId).externalIdcountryIdtimezoneIdserviceNameteamIdslicensescenariosCountactiveScenariosactiveAppsoperations, operationsExttransfer, transferExtisPausedisDeletedimsEnabledusersCountteam campos
Esses campos estão presentes quando uma equipe está ativa. Você deve fornecer um fallback caso a equipe seja undefined (por exemplo, em uma tela de nível de organização sem nenhuma equipe selecionada).
idnameorganizationIdcountrytimezonelicenseactiveScenariosactiveAppsscenarioDraftsisDeleteduser campos
Esses campos se aplicam ao usuário do Fusion conectado.
idnameemailavatarlocaleen.languagetimezonetimezoneIdcountryIdlocaleIdfeaturesallow_apps, public_templates).usersAdminsRoleIduser pode incluir campos internos adicionais. Você deve confiar somente nos campos documentados aqui. Outros campos podem ser alterados sem aviso prévio e alguns campos relacionados à autenticação nunca devem ser registrados ou exibidos.Datas
O contexto é serializado antes de atingir sua extensão, portanto, os campos de data chegam como cadeias de caracteres (ISO 8601, como "2026-06-24T00:00:00.000Z"), não como objetos Date do JavaScript. Você pode convertê-los se necessário:
const resetDate = new Date(context.organization.nextReset);
Atualizações de contexto
O Fusion reenvia todo o contexto (via contextchange) quando:
- o usuário alterna a organização,
- o usuário alterna equipes ou
- as informações do usuário conectado foram alteradas.
Sempre leia novamente todas as chaves que você usa dentro do seu manipulador contextchange, em vez de considerar que apenas um valor foi alterado.
Práticas recomendadas de segurança
- Nunca registrar, exibir ou persistir
imsToken. Trate-o como uma senha. - Envie o token somente para endpoints confiáveis do Adobe/Fusion, via HTTPS, como um token
Bearer. - Não armazene dados pessoais do contexto além do que seu recurso precisa.
Usar o token para chamar APIs
Para transformar imsToken (mais organization.id / team.id) em Workfront real ou
Dados de fusão, não é possível chamar essas APIs diretamente do navegador, pois o CORS bloqueia
o mesmo. Em vez disso, roteie a chamada por meio de uma pequena ação de tempo de execução do App Builder. Consulte
Chamada de APIs do Workfront e Fusion.
Para continuar o processo de criação de uma extensão personalizada, consulte Publicar sua extensão.