Criar um formulário usando o bloco adaptável do Forms

O AEM Forms Edge Delivery fornece um bloco, conhecido como Bloco do Adaptive Forms, para ajudar você a criar formulários facilmente para capturar e armazenar dados capturados. Você pode criar um novo projeto AEM pré-configurado com o Bloco Forms Adaptável ou adicionar o Bloco Forms AEM Adaptável a um projeto existente.

Esses formulários enviam dados diretamente para um arquivo do Microsoft Excel ou do Google Sheets, permitindo que você use um ecossistema vibrante e APIs robustas do Google Sheets, do Microsoft Excel e do Microsoft SharePoint para processar facilmente os dados enviados ou iniciar um fluxo de trabalho de negócios existente.

Ecossistema de criação baseado em documentos

Pré-requisitos

Antes de começar, verifique se você concluiu as seguintes etapas:

Criar um formulário

Etapa 1: Crie um formulário usando o Microsoft Excel ou a Planilha do Google.

Em vez de navegar por processos complexos, é possível criar um formulário sem esforço usando uma planilha. Você pode definir as linhas e colunas que compõem a estrutura do formulário. Cada linha representa um campo de formulário individual e os cabeçalhos de coluna definem as propriedades de campo correspondentes.

Por exemplo, considere a seguinte planilha onde os campos de estrutura de tópicos de linhas para um formulário enquiry e cabeçalhos de coluna definem suas propriedades:

Planilha de consulta

Para continuar com a criação do formulário:

  1. Acesse a pasta do projeto AEM Edge Delivery no Microsoft SharePoint ou Google Drive.

  2. Crie uma Pasta de trabalho do Microsoft Excel ou uma Planilha do Google em qualquer lugar no diretório do projeto do AEM Edge Delivery. Por exemplo, crie uma planilha com o nome enquiry no diretório do projeto AEM Edge Delivery no Google Drive.

    Conteúdo de exemplo na Unidade Google

  3. Verifique se a planilha está compartilhada com o usuário AEM apropriado (por exemplo helix@adobe.com) de acordo com as configurações especificadas para seu projeto. Conceda ao usuário permissão de edição para a planilha.

  4. Abra a planilha criada e renomeie a planilha padrão como "shared-default".

    renomear planilha padrão como padrão compartilhado

  5. Para adicionar os campos de formulário, insira linhas e cabeçalhos de colunas na planilha "shared-default". Cada linha deve representar um campo de formulário, com cabeçalhos de coluna definindo o campo correspondente propriedades.

    Para um início rápido, considere copiar o conteúdo da Planilha de consulta para a sua planilha. Depois de copiar o conteúdo, salve sua planilha.

    embed

    https://video.tv.adobe.com/v/3427468?quality=12&learn=on

  6. Use AEM Sidekick para visualizar a planilha.

    Usar AEM Sidekick para visualizar a planilha

    Ao visualizar, novas guias do navegador exibem o conteúdo da planilha no formato JSON. Certifique-se de capturar a URL de visualização, pois ela é necessária para renderizar o formulário no próximo da seção. O formato do URL é o seguinte:

    code language-json
        https://<branch>--<repository>--<owner>.hlx.live/<form-path>/<form-file-name>.json
    
    • <branch> refere-se à ramificação do seu repositório GitHub.
    • <repository> indica seu repositório GitHub.
    • <owner> refere-se ao nome de usuário da sua conta GitHub que hospeda seu repositório GitHub.

    Por exemplo, se o repositório do seu projeto for chamado de "portal", estiver localizado na conta "wkndforms" e você estiver usando a ramificação "main", o URL será semelhante ao seguinte:

    https://main--portal--wkndforms.hlx.page/enquiry.json

Etapa 2: visualize o formulário usando a página Edge Delivery Services (EDS).

Até agora, você preparou a estrutura do formulário. Agora, para visualizar o formulário:

  1. Abra a conta do Microsoft SharePoint ou do Google AEM Drive e navegue até o diretório do projeto do Edge Delivery.

  2. Abra um arquivo de documento (por exemplo, arquivo de índice) para incorporar o formulário. Como alternativa, crie um novo documento.

  3. Mova para o local desejado no documento onde você pretende adicionar o formulário.

  4. Para criar um bloco de formulário para renderizar o formulário. Selecione Inserir > Tabela e crie uma tabela de uma coluna e duas linhas. Nomeie a tabela como "Formulário" e cole o URL de visualização na segunda linha. Verifique se o URL está formatado como um hiperlink, não como texto simples, como ilustrado abaixo:

    table 0-row-1 1-row-1
    Formulário
    https://main–wefinance–wkndforms.hlx.live/enquiry.json

    Adicionar bloco adaptável do Forms à sua página da Web

    Esse bloco serve como um espaço reservado em que o formulário é incorporado. Na segunda linha do bloco, adicione a URL de visualização do arquivo <form>.json como um hiperlink.

    note important
    IMPORTANT
    Verifique se o URL está formatado como um hiperlink em vez de ser exibido como texto simples.
  5. Use AEM Sidekick para visualizar o documento. A página agora exibe o formulário. Por exemplo, este é o formulário baseado na planilha de consulta:

    Um exemplo de formulário EDS

    Agora, preencha o formulário e clique no botão enviar, você enfrenta um erro, semelhante ao seguinte, porque a planilha ainda não está definida para aceitar os dados.

    erro no envio do formulário

Próxima etapa

Prepare sua planilha para começar a aceitar dados no envio do formulário.

Consulte também:

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