Configurar um formulário adaptável para a ação de envio do ponto de extremidade REST

Use o Enviar para Ponto de Extremidade REST ação para publicar os dados enviados em um URL REST. A URL pode ser de um servidor interno (o servidor no qual o formulário é renderizado) ou externo.

O AEM as a Cloud Service oferece várias ações de envio prontas para uso para manipular envios de formulários. Você pode saber mais sobre essas opções na Ação de envio do formulário adaptável artigo.

Vantagens

Algumas das vantagens de configurar a variável Enviar para endpoint REST ações de envio para o Adaptive Forms são:

  • Ele permite a integração perfeita de dados de formulário com sistemas e serviços externos por meio de APIs RESTful.
  • Ele oferece flexibilidade para lidar com envios de dados do Adaptive Forms, oferecendo suporte a estruturas de dados dinâmicas e complexas.
  • Ele oferece suporte ao mapeamento dinâmico de campos de formulário para parâmetros no URL do endpoint REST, permitindo envios de dados adaptáveis e personalizáveis.

Configurar ação de envio Enviar para Ponto de Extremidade REST steps-to-configure-submit-to-restendpoint-submit-action

Para configurar a ação de envio:

  1. Abra o Navegador de conteúdo e selecione a variável Contêiner do guia componente do seu Formulário adaptável.

  2. Clique nas propriedades do Container do guia Propriedades do guia ícone. A caixa de diálogo Contêiner de formulário adaptável é aberta.

  3. Clique em Envio guia.

  4. No Ação de envio selecione Enviar para endpoint Rest.
    Configuração de ação de Enviar para endpoint Rest

    Para publicar dados em um servidor interno, forneça o caminho do recurso. Os dados são publicados no caminho do recurso. Por exemplo, /content/restEndPoint. Para essas solicitações de publicação, as informações de autenticação da solicitação de envio são usadas.

    Para publicar dados em um servidor externo, forneça um URL. O formato do URL é https://host:port/path_to_rest_end_point. Configure o caminho para lidar com a solicitação POST de forma anônima.

    Mapeamento para valores de campo passados como parâmetros da página de agradecimento

    No exemplo acima, o usuário inseriu informações em textbox é capturado usando o parâmetro param1. Sintaxe para publicar dados capturados usando param1 é:

    String data=request.getParameter("param1");

    Da mesma forma, os parâmetros usados para lançar dados XML e anexos são dataXml e attachments.

    Por exemplo, você usa esses dois parâmetros no script para analisar dados para um ponto final rest. Você usa a seguinte sintaxe para armazenar e analisar os dados:

    String data=request.getParameter("dataXml");
    String att=request.getParameter("attachments");

    Neste exemplo, data armazena os dados XML e att armazena dados de anexo.

    A variável Enviar para endpoint REST Ação enviar envia os dados preenchidos no formulário para uma página de confirmação configurada como parte da solicitação HTTP GET. Você pode adicionar o nome do campo a ser solicitado. O formato da solicitação é:

    {fieldName}={request parameter name}

    Como mostrado na imagem abaixo, param1 e param2 são transmitidos como parâmetros com valores copiados do caixa de texto e caixa numérica para a próxima ação.

    Configurar Ação De Envio De Ponto De Extremidade Rest

    Também é possível Habilitar solicitação POST e forneça um URL para publicar a solicitação. Para enviar dados ao servidor AEM que hospeda o formulário, use um caminho relativo correspondente ao caminho raiz do servidor AEM. Por exemplo, /content/forms/af/SampleForm.html. Para enviar dados para qualquer outro servidor, use o caminho absoluto.

  5. Clique em Concluído.

Práticas recomendadas

  • Ao postar dados em um servidor externo, verifique se o URL é seguro e configure o caminho para lidar com a solicitação POST anonimamente para proteger informações confidenciais.
  • Para passar os campos como parâmetros em um URL REST, todos os campos devem ter nomes de elemento diferentes, mesmo se os campos forem colocados em painéis diferentes.

Artigos relacionados

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab