[AEM Forms]{class="badge positive" title="Aplicável ao AEM Forms)."}

Configurar endpoints REST específicos do ambiente para o mesmo Formulário adaptável

Quando você promove um formulário adaptável de desenvolvimento para preparo para produção, o formulário geralmente precisa enviar para um endpoint REST diferente em cada ambiente, enquanto o próprio formulário permanece idêntico. Codificar o URL do endpoint na ação de envio do formulário quebra isso, porque o mesmo URL viaja com o formulário para todos os ambientes.

Este artigo descreve como manter um único Formulário adaptável portátil e ter sua ação Enviar para endpoint REST resolvida para o endpoint correto em cada ambiente. O formulário faz referência a uma configuração REST por nome em vez de por URL, e cada ambiente fornece seu próprio valor para essa configuração.

Pré-requisitos prerequisites

Criar a configuração do serviço RESTful no preparo create-rest-configuration

Na instância do autor de preparo, crie a configuração nomeada à qual o formulário se refere. Defina a URL do Ponto de Extremidade de Serviço para o ponto de extremidade REST ou webhook para preparo.

Aponte o formulário adaptável para o contêiner de configuração set-configuration-container

No preparo, associe o formulário ao Contêiner de configuração que contém a configuração REST.

Configurar a ação de envio para endpoint REST configure-submit-action

No preparo, configure o formulário para enviá-lo por meio da configuração REST nomeada em vez de um URL codificado. Para obter a referência completa da ação de envio, consulte Configurar um Formulário adaptável para a ação de envio do Ponto de Extremidade REST.

O formulário agora resolve seu endpoint de envio por meio da configuração nomeada em vez de um URL fixo.

Promover o formulário do armazenamento temporário à produção promote-across-environments

Depois de configurar e testar o preparo, mova o mesmo formulário e o Contêiner de configuração para a produção. Você pode usar qualquer uma das abordagens a seguir.

Opção 1: abordagem de autor e pacote option-package

Use isso quando os autores mantiverem o formulário e a configuração diretamente em cada ambiente.

Opção 2: abordagem de substituição sensível ao contexto (recomendada para automação) option-context-aware

Use isso quando quiser uma configuração em pacote cujo endpoint, nome de usuário e senha sejam resolvidos automaticamente por ambiente, sem edição manual após a implantação. Essa abordagem substitui as propriedades de configuração usando as variáveis de ambiente do Cloud Manager.

Para configurações REST, você normalmente cria variáveis de ambiente para as propriedades serviceEndPoint, userName e password e, em seguida, faz referência a elas a partir de um arquivo de configuração OsgiConfigurationOverrideProvider em seu projeto.

Para obter o procedimento completo, consulte Configurações da nuvem com reconhecimento de contexto.

Atualizar o URL do ponto de extremidade na produção configure-endpoint-on-production

Depois de instalar o pacote em produção, o Formulário adaptável e a configuração REST name (por exemplo, restTest) correspondem ao preparo. A URL do Ponto de Extremidade de Serviço nessa configuração ainda aponta para o ponto de extremidade de preparo do pacote. Abra a configuração na produção e substitua-a pelo URL do endpoint de produção.

Durante os testes, um inspetor de solicitações, como um serviço de captura de webhook, fornece um URL exclusivo por ambiente para que você possa confirmar qual endpoint recebe cada envio.

Verificar o roteamento verify

Envie o mesmo formulário do armazenamento temporário e da produção e confirme cada publicação de ambiente no seu próprio endpoint, não no URL do outro ambiente.

Práticas recomendadas best-practices

Artigos relacionados related-articles