Forms

Skapa en Excel-arbetsbok eller ett Google-blad var som helst under projektkatalogen. Det här dokumentet använder ett blad i OneDrive som kallas email-form.xlsx i roten av ett AEM projekt.

Se till att AEM användare (till exempel helix@adobe.com) som är konfigurerad för ditt projekt har redigera behörighet på bladet.

Öppna den skapade arbetsboken och ändra namn på standardbladet till incoming.


Obs! AEM skickar inga data till arbetsboken om incoming bladet finns inte.

Förhandsgranska bladet i sidosparken.
Obs! Även om ett blad har förhandsgranskats tidigare måste det förhandsgranskas igen när du har skapat incoming första gången.

Ställ in bladet med de rubriker som matchar de data som hämtas. Du kan antingen göra detta manuellt eller genom att skicka en begäran om POST till formulärflödet i AEM Admin-tjänsten. Administrationstjänsten tittar på informationen i POSTEN och skapar de rubriker/tabeller och ark som behövs för att importera data och få ut det mesta av blanketttjänsten.
Mer information om formatet på POSTENS begäran om att ställa in bladet finns i Admin-API dokumentation och följande exempel:

Begäran:

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

Svar:

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

Du kan använda ett verktyg som bläddra eller Postman för att begära den här POSTEN. Till exempel:

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

Genom ovanstående begäran om POST tillhandahåller vi exempeldata, dvs. formulärfält och exempelvärden som ska användas av administrationstjänsten för att konfigurera formuläret.
Vi rekommenderar att du använder Admin-tjänsten för att konfigurera bladet, men om du vill skapa rubrikerna manuellt kan du läsa dokumentet Manuell inställning av Forms-blad.

När du har skickat POST till administratörstjänsten kommer du att se följande ändringar i arbetsboken.

1. Ett blad med namnet helix-default skapas. Data i det här bladet är de som returneras när en GET begäran görs i bladet. Här kan du sammanfatta data från incoming Blad för konsumtion någon annanstans.
   
   Obs! The helix-default bladet får aldrig innehålla någon personligt identifierbar information eller andra uppgifter som du inte är säker på är tillgängliga för allmänheten.

2. Ett blad med namnet slack skapades. Här kan du ställa in automatiska meddelanden för en Slack-kanal när data hämtas till kalkylbladet. För närvarande har AEM bara stöd för meddelanden till den AEM Slack-organisationen för tekniker och Adobe Enterprise Support.

   1. Om du vill konfigurera meddelanden från Slack anger du teamId på arbetsytan Slack och channel namn eller ID. Du kan också fråga dig om en svart robot (med debug kommando) teamId och channel ID. Använda channel ID i stället för namnet är att föredra eftersom kanalens namn ändras.
      
      Obs! Äldre formulär hade inte teamId kolumn. The teamId ingick i channel kolumn, avgränsad med en # eller /.
   2. Ange title du vill ha och under fält Ange namnen på de fält som du vill se i Slack-meddelandet. Varje rubrik ska avgränsas med kommatecken (t.ex. name, email).