Solução de problemas de extensões personalizadas

Este artigo apresenta algumas soluções para os problemas que você provavelmente encontrará ao criar extensões personalizadas, aproximadamente na ordem em que ocorrem durante o desenvolvimento.

Lista de verificação rápida

Se algo não funcionar, verifique primeiro:

Erro 1060: “O ponto de extensão não existe”

Mensagem completa: CoreConsoleAPISDK ... 1060: Extension point 'fusion/nav-organization/1' does not exist durante aio app deploy.

Significado: O ponto de extensão do Fusion ainda não está habilitado (“integrado”) para sua organização da Adobe. A Adobe valida, no momento da implantação, se o ponto de extensão existe no catálogo da organização. Isto não um problema com seu código ou YAML.

Correção: Peça à equipe do Fusion para integrar os pontos de extensão (fusion/nav-organization/1 e/ou fusion/nav-team/1) para sua organização IMS. Ao solicitar a integração, inclua:

Depois que a integração for confirmada, execute aio app deploy novamente.

“Aguardando mensagem inicial do iframe de destino” / o painel gira para sempre

Significado: O Fusion abriu sua interface do usuário visível, mas não concluiu o handshake. Portanto, o Fusion atingiu o tempo limite.

Causas comuns:

Correção: verifique se suas chamadas de componente visíveis attach({ id }):

useEffect(() => {
  attach({ id: extensionId }).catch(console.error);
}, []);

Para obter mais informações, consulte Criar a interface de extensão personalizada.

O botão de navegação não é exibido no Fusion

Se o botão de navegação da sua extensão personalizada não aparecer no Fusion, verifique esses itens em ordem:

O botão é exibido, mas o painel está em branco

Se o botão for exibido, mas o painel estiver em branco, verifique o seguinte:

O iframe está bloqueado (Política de segurança de conteúdo / “recusou-se a enquadrar”)

O Fusion só permite extensões hospedadas na CDN (*.adobeio-static.net) do App Builder da Adobe, que é onde o aio app deploy coloca seus arquivos por padrão. Se você hospeda sua interface em outro lugar, como um domínio personalizado, o Fusion se recusa a carregá-la. Implante por meio do App Builder conforme documentado ou pergunte à equipe do Fusion se seu domínio pode ser.

O contexto está vazio ou obsoleto

A chamada de uma API falha com um erro CORS

Sintoma: o Console do navegador mostra “Nenhum cabeçalho ‘Access-Control-Allow-Origin’” (ou a solicitação está bloqueada) quando a interface do usuário chama uma API do Workfront/Fusion diretamente.

Correção: não chame essas APIs do navegador. Rotear a chamada por meio de sua própria ação de tempo de execução do App Builder (no lado do servidor, sem CORS) e fazer com que o convidado chame a ação com uma URL relativa de mesma origem. Para obter mais informações, consulte Chamada de APIs do Workfront e Fusion.

A ação de proxy retorna 401 mesmo com um token válido

Significado: com require-adobe-auth: true, o gateway da Adobe valida a chamada antes que sua ação seja executada e pode rejeitá-la ou descartar cabeçalhos personalizados de que você precisa, aparecendo como um 401.

Correção: Defina require-adobe-auth: false na ação e para impor a autorização você mesmo. Exigir um portador de Authorization na ação, encaminhá-lo para upstream e manter um incluo na lista de permissões de destino estrito. Consulte require-adobe-auth: true vs. false.

Fusion GET /api/v3/hooks retorna 400

Significado: O ponto de extremidade dos ganchos é de escopo de equipe, portanto, teamId é um parâmetro de consulta obrigatório.

Correção: Chame /api/v3/hooks?teamId=<team.id>. Ganchos voltam apenas para a equipe ativa. Para cobrir uma organização, repita suas equipes e mescle. Os cenários, por outro lado, aceitam organizationId. Consulte Especificações da API Fusion v3.

aio erros

Coleta de informações para suporte

Colete essas informações para agilizar o diagnóstico: