Formulaires

Créez un classeur Excel ou une feuille Google n’importe où sous votre répertoire de projet. Ce document utilise une feuille dans OneDrive appelée email-form.xlsx à la racine d’un projet AEM.

Assurez-vous que l’utilisateur AEM (par exemple, helix@adobe.com) configuré pour votre projet comporte modifier l’autorisation sur la feuille.

Ouvrez le classeur créé et renommez la feuille par défaut en . incoming.


Remarque : AEM n’enverra aucune donnée à ce classeur si incoming la feuille n’existe pas.

Prévisualisez la feuille dans le sidekick.
Remarque : Même si une feuille a déjà été prévisualisée, elle doit l’être à nouveau après avoir créé incoming feuille pour la première fois.

Configurez la feuille avec les en-têtes qui correspondent aux données ingérées. Vous pouvez le faire manuellement ou en envoyant une demande du POST à l’itinéraire de formulaire dans le service AEM Admin. Le service d’administration examinera les données du corps du POST et créera les en-têtes/tableaux et feuilles nécessaires à l’ingestion des données et à l’exploitation optimale du service Forms.
Pour plus d’informations sur le format de la demande du POST pour configurer votre feuille, voir la API Admin ainsi que l’exemple suivant :

Requête :

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

Réponse :

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

Vous pouvez utiliser un outil tel que curl ou Postman pour effectuer cette requête de POST. Par exemple :

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"}}'

Par le biais de la requête de POST ci-dessus, nous fournissons des exemples de données, c’est-à-dire les champs de formulaire et les valeurs d’exemple qui seront utilisés par le service d’administration pour configurer le formulaire.
Le service Admin est recommandé pour configurer votre feuille, mais si vous souhaitez créer les en-têtes manuellement, reportez-vous au document Configuration manuelle de la feuille de Forms.

Après avoir envoyé le POST requête au service d’administration : les modifications suivantes ont été apportées à votre classeur.

1. Une feuille nommée helix-default est créé. Les données de cette feuille sont celles qui seront renvoyées lorsqu’une GET la demande est effectuée sur la feuille. C’est un excellent endroit pour utiliser des formules de feuille de calcul pour résumer les données du incoming feuille destinée à être consommée ailleurs
   
   Remarque : Le helix-default La fiche ne doit jamais contenir d'informations d'identification personnelle ou d'autres données que vous n'êtes pas d'accord pour être accessible au public.

2. Une feuille nommée slack a été créé. Vous pouvez configurer des notifications automatiques vers un canal de Slack chaque fois que des données sont ingérées dans votre feuille de calcul. Actuellement, AEM ne prend en charge que les notifications destinées à l’organisation AEM Engineering SLACK et à l’organisation de support aux entreprises d’Adobe.

   1. Pour configurer les notifications de Slack, saisissez le teamId de l’espace de travail du Slack et channel nom ou ID. Tu peux aussi demander au slack-bot (avec debug ) pour le teamId et le channel ID. Utilisation de channel Il est préférable de choisir l’identifiant plutôt que le nom, car il survit aux changements de nom de canal.
      
      Remarque : Les formulaires plus anciens n’avaient pas la teamId colonne. Le teamId a été inclus dans channel colonne, séparée par un # ou /.
   2. Enter any titre vous voulez et sous champs saisissez les noms des champs que vous souhaitez afficher dans la notification du Slack. Chaque titre doit être séparé par une virgule (p. ex. name, email).