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 do AEM pré-configurado com o Bloco do Adaptive Forms ou adicionar o Bloco do Adaptive Forms a um projeto existente do AEM.
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.
Pré-requisitos
Antes de começar, verifique se você concluiu as seguintes etapas:
- Configure um projeto do AEM usando o modelo do AEM Forms adicionou o Bloqueio do Adaptive Forms ao seu Projeto do AEM existente e clone o repositório do GitHub correspondente no computador local.
- Verifique se você tem acesso ao Google Sheets ou ao Microsoft SharePoint. Para configurar o Microsoft SharePoint como fonte de conteúdo, consulte Como usar o SharePoint.
Criar um formulário
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 em que os campos de estrutura de tópicos de linhas de uma planilha consulta e os cabeçalhos de coluna definem suas propriedades:
Para continuar com a criação do formulário:
-
Acesse a pasta do projeto do AEM Edge Delivery no Microsoft SharePoint ou no Google Drive.
-
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. -
Verifique se a planilha está compartilhada com o usuário AEM apropriado (por exemplo,
forms@adobe.com
) de acordo com as configurações especificadas para seu projeto. Conceda ao usuário permissão de edição para a planilha. -
Abra a planilha criada e renomeie a planilha padrão como "shared-aem".
-
Para adicionar os campos de formulário, insira linhas e cabeçalhos de coluna na planilha "shared-aem". 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 -
Use o 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>.aem.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 "wefinance", estiver localizado na conta "wkndform" e você estiver usando a ramificação "main", o URL será semelhante ao seguinte:
https://main--wefinance--wkndform.aem.page/enquiry.json
<!—(https://main–wefinance–wkndform.aem.page/enquiry.json)–>
Até agora, você preparou a estrutura do formulário. Agora, para visualizar o formulário:
-
Abra sua conta do Microsoft SharePoint ou Google Drive e navegue até o diretório do projeto do AEM Edge Delivery.
-
Abra um arquivo de documento (por exemplo, arquivo de índice) para incorporar o formulário. Como alternativa, você pode criar um novo documento.
-
Mova para o local desejado no documento onde você pretende adicionar o formulário.
-
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--wkndform.aem.live/enquiry.json
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. -
Use o 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:
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.
Próxima etapa
Prepare sua planilha para começar a aceitar dados no envio do formulário.
Consulte também:
- Introdução ao Edge Delivery Services para AEM Forms
- Criar um formulário usando o Google Sheets ou o Microsoft Excel
- Configure seus arquivos do Google Sheets ou do Microsoft Excel para começar a aceitar dados
- Publicar seu formulário e começar a coletar dados
- Personalize a aparência de seus formulários
- Adicionar seções repetíveis a um formulário
- Mostrar uma mensagem de agradecimento personalizada após o envio do formulário
- Componentes de bloco de formulário adaptável e suas propriedades
- Uso do serviço de envio de formulários