Gerencie seu aplicativo
Use o App Management para associar, instalar, configurar, atualizar e desassociar aplicativos do App Builder à sua instância do Commerce. Os formulários de configuração são gerados a partir do esquema de cada aplicativo, portanto, é possível gerenciar as configurações sem desenvolvimento personalizado da interface do administrador.
Localizar um aplicativo no Administrador
Em Apps > App Management, cada aplicativo aparece como um cartão. A lista pode incluir cada aplicativo associado à instância do Adobe Commerce para a organização do Adobe IMS selecionada. Use os controles acima dos cartões para restringir os resultados:
O campo de pesquisa e ambos os filtros se aplicam juntos. Para exibir a lista completa novamente, desmarque o campo de pesquisa e selecione All Statuses e All Extensibility Patterns.
Revisar detalhes da inscrição
No cartão do aplicativo, selecione Manage > Details para examinar seu nome, descrição e versão. A caixa de diálogo fornece duas guias:
- O Details lista os casos de uso comercial do aplicativo, incluindo eventos e etapas de instalação personalizadas. Revise os rótulos e as descrições para entender o que o aplicativo adiciona ao Commerce.
- App config exibe a configuração do aplicativo como JSON para inspeção.
Adquirir aplicativo
O Acquire App abre uma nova guia do navegador (ou um modo de exibição de navegador separado) no Adobe Exchange, onde você pode descobrir listas de marketplace relacionadas ao Commerce e adicionar aplicativos à sua organização do Adobe IMS. Depois que o aplicativo for adquirido, aprovado e implantado, ele aparecerá em App Management para associação e instalação.
Pré-requisitos
Antes de associar um aplicativo, verifique se você tem o seguinte:
Tutorial
Assista a este vídeo para saber como associar um aplicativo a uma instância do Commerce e definir as configurações.
Associar um aplicativo
O processo de associação importa sites, lojas e visualizações de loja da Commerce e cria o link entre o aplicativo e a instância do Commerce.
Para vincular o aplicativo App Builder a uma instância do Commerce:
-
Navegue até Apps > App Management.
-
Clique em Associate App.
{width="500" modal="regular"}
-
Selecione um Project na lista.
-
Selecione o Workspace.
-
Clique em Associate.
{width="500" modal="regular"}
Instalar um aplicativo
A associação vincula um aplicativo à sua instância do Commerce. Para aplicativos que incluem componentes instaláveis, como eventos, webhooks, extensões da interface do usuário do administrador ou etapas de instalação personalizadas, a instalação aplica esses componentes à instância.
-
Abra a caixa de diálogo de instalação do aplicativo associado em App Management.
-
Revise os casos de uso comercial do aplicativo e as etapas de instalação listadas.
-
Se Pre Installation Instructions forem exibidos, conclua esses pré-requisitos antes de continuar.
{width="600" modal="regular"}
-
Clique em Install.
-
Monitore os indicadores de andamento de itens individuais até a conclusão da instalação.
{width="600" modal="regular"}
note warning WARNING Mantenha a página aberta até que a instalação seja concluída. Fechar ou atualizar a página pode impedir a conclusão correta da instalação. -
Verifique se Successfully Installed é exibido e se os itens concluídos têm marcas de seleção.
{width="600" modal="regular"}
-
Conclua todas as instruções de pós-instalação fornecidas pelo aplicativo e defina suas configurações conforme necessário.
Definir configurações
Depois de associar um aplicativo no modo de exibição App Management, defina suas configurações por meio do formulário:
- No cartão do aplicativo associado, selecione Manage > Configure.
O formulário exibe as configurações que o aplicativo pode definir.
-
Modifique os valores conforme necessário.
-
Clique em Save.
Configuração específica do escopo
Use a configuração específica do escopo quando sites, lojas ou visualizações de loja diferentes precisarem de configurações exclusivas. Por exemplo, habilite um recurso somente para uma região ou exibição de loja específica ou use configurações diferentes por marca. As configurações em um escopo mais baixo substituem as de escopos mais altos.
Para substituir valores globais em um nível de escopo específico:
-
Clique em Change Scope.
-
Selecione um escopo na lista.
-
Modifique os valores para este escopo.
-
Clique em Save.
Gerenciar escopos
Acesse Manage Scopes na tela de detalhes do aplicativo para gerenciar a hierarquia de escopo do seu aplicativo.
Atualizar um aplicativo
Quando o desenvolvedor do aplicativo implanta uma nova versão de um aplicativo instalado, o App Management é notificado de que há uma atualização disponível. A implantação do App Builder e uma atualização do Gerenciamento de aplicativos são operações separadas: a atualização aplica alterações planejadas aos componentes instalados, como eventos, webhooks e extensões da interface do administrador.
Peça ao desenvolvedor do aplicativo para confirmar se ele oferece suporte a atualizações. Para conhecer os pré-requisitos e os requisitos de migração do SDK, consulte Atualizar seu aplicativo na documentação do desenvolvedor.
Revisar e iniciar uma atualização
No modo manual, que é o padrão, você revisa e inicia a atualização em App Management.
-
Registre a versão e a configuração do aplicativo instalado e faça backup dos dados do aplicativo e dos recursos externos com a ajuda do desenvolvedor do aplicativo.
-
Navegue até Apps > App Management e abra a atualização disponível para o aplicativo.
-
Revise as alterações planejadas e quaisquer avisos. Uma atualização pode adicionar, modificar ou remover componentes. Se uma etapa de instalação personalizada for removida, o script de desinstalação não será executado e os recursos criados por ela não serão limpos automaticamente. Confirme qualquer limpeza necessária com o desenvolvedor do aplicativo antes de continuar.
-
Inicie a atualização e monitore o progresso das operações listadas.
-
Revise o resultado da atualização e verifique se há operações com falha. Se a atualização falhar, siga Falha na atualização antes de usar Retry Upgrade.
No modo manual, as alterações planejadas nos componentes instalados do Commerce não são aplicadas até que você inicie a atualização. No entanto, a implantação pode atualizar o código de ação Tempo de execução que o aplicativo instalado já usa antes da execução da atualização.
Atualizações automáticas
O desenvolvedor do seu aplicativo controla o modo de atualização. Peça ao desenvolvedor para confirmar se o aplicativo usa atualizações manuais ou automáticas.
Mudanças na configuração dos negócios
As alterações no esquema de configuração comercial do aplicativo aparecem automaticamente após a implantação. Eles são separados de instalação e atualizações e não acionam uma atualização de aplicativo.
Desassociar um aplicativo
Desassocie um aplicativo quando não precisar mais dele conectado à instância do Commerce. Por exemplo, talvez seja necessário desativar uma integração, alternar para um espaço de trabalho diferente ou limpar as configurações de teste.
Antes de continuar, registre a versão e a configuração instaladas, faça backup dos dados do aplicativo e pergunte ao desenvolvedor do aplicativo quais recursos os scripts de desinstalação do aplicativo removem e quais exigem limpeza manual. Planeje qualquer interrupção do serviço e como restaurar o aplicativo, suas configurações e seus dados. Para atualizações de rotina, atualize o aplicativo em vez de desassociá-lo.
Para remover um aplicativo de uma instância do Commerce:
-
Navegue até Apps > App Management.
-
No cartão do aplicativo, selecione Manage > Unassociate.
-
Revise os casos de uso de negócios e os componentes afetados pela desinstalação, incluindo eventos e etapas de instalação personalizadas.
{width="600" modal="regular"}
-
Confirme a ação.
Documentação relacionada
- Solução de problemas App Management - Resolva problemas comuns de associação, instalação, configuração e atualizações.
- Atualize seu aplicativo - Requisitos do desenvolvedor para modos de atualização, scripts de migração e diagnósticos.