Forms

Crie uma pasta de trabalho do Excel ou uma planilha do Google em qualquer lugar no diretório do projeto. Este documento usa uma planilha no OneDrive chamada email-form.xlsx na raiz de um projeto AEM.

Verifique se o usuário AEM (por exemplo, helix@adobe.com) que está configurado para seu projeto tem editar permissão na folha.

Abra a pasta de trabalho criada e renomeie a planilha padrão para incoming.


Nota: O AEM não enviará dados para esta pasta de trabalho se a variável incoming a planilha não existe.

Visualize a planilha no sidekick.
Nota: Mesmo que uma planilha tenha sido visualizada anteriormente, ela deverá ser visualizada novamente após a criação do incoming pela primeira vez.

Configure a planilha com os cabeçalhos que correspondem aos dados que estão sendo assimilados. Você pode fazer isso manualmente ou enviando uma solicitação POST para a rota do formulário no serviço de AEM Admin. O serviço de administração examinará os dados no corpo do POST e criará os cabeçalhos/tabelas e folhas necessários para assimilar dados e obter o máximo do serviço de formulários.
Para obter detalhes sobre o formato da solicitação POST para configurar sua planilha, consulte o API de administração e o seguinte exemplo:

Solicitação:

POST /form/{owner}/{repo}/{ref}/en/email-form.json HTTP/1.1
{"data":{"firstName":"test"}}

Resposta:

HTTP/1.1 200 OK
{"rowCount":2,"columns":["firstName"]}

Você pode usar uma ferramenta como curl ou Postman para fazer essa solicitação POST. Por exemplo:

curl -s -i -X POST 'https://admin.hlx.page/form/{owner}/{repo}/{ref}/en/email-form.json' \
--header 'Content-Type: application/json' \
--data '{"data":{"firstName":"test"}}'

Por meio da solicitação POST acima, estamos fornecendo dados de amostra, ou seja, os campos de formulário e valores de amostra que serão usados pelo serviço de Administração para configurar o formulário.
O serviço de Administração é recomendado para configurar sua planilha, mas se você quiser criar os cabeçalhos manualmente, consulte o documento Configuração Manual do Forms Sheet.

Após o envio do POST solicitação ao serviço de administração, você verá as seguintes alterações na pasta de trabalho.

1. Uma planilha chamada helix-default é criado. Os dados nesta planilha são os que serão retornados quando uma GET solicitação é feita à planilha. Este é um ótimo local para usar fórmulas de planilha para resumir os dados do incoming folha para consumo noutro lugar.
   
   Nota: A variável helix-default A planilha nunca deve conter informações de identificação pessoal ou outros dados com os quais você não esteja de acordo em se tornar acessível publicamente.

2. Uma planilha chamada slack foi criado. Aqui você pode configurar notificações automáticas para um canal Slack sempre que os dados forem assimilados em sua planilha. Atualmente, o AEM só oferece suporte a notificações para a organização slack de engenharia de AEM, bem como para a organização Adobe Enterprise Support.

   1. Para configurar notificações de Slack, insira o teamId do espaço de trabalho do Slack e do channel nome ou ID. Você também pode perguntar ao slack-bot (com a debug ) para o teamId e a variável channel ID. Usar o channel ID em vez do nome é preferível, pois sobrevive às renomeações de canal.
      
      Nota: Formulários mais antigos não tinham o teamId coluna. A variável teamId foi incluído na channel coluna, separada por uma # ou /.
   2. Insira qualquer título que você deseja e em campos insira os nomes dos campos que deseja ver na notificação Slack. Cada cabeçalho deve ser separado por vírgula (por exemplo, name, email).