Formulare

Erstellen Sie eine Excel-Arbeitsmappe oder ein Google-Blatt an einer beliebigen Stelle in Ihrem Projektverzeichnis. Dieses Dokument verwendet ein Blatt in OneDrive namens email-form.xlsx im Stammverzeichnis eines AEM-Projekts.

Stellen Sie sicher, dass der AEM-Benutzer (z. B. helix@adobe.com), die für Ihr Projekt konfiguriert wurde, hat Berechtigung bearbeiten auf dem Blatt.

Öffnen Sie die erstellte Arbeitsmappe und benennen Sie das Standardblatt in um. incoming.


Hinweis: AEM sendet keine Daten an diese Arbeitsmappe, wenn incoming Blatt existiert nicht.

Zeigen Sie eine Vorschau des Blattes im Sidekick an.
Hinweis: Selbst wenn ein Blatt zuvor in der Vorschau angezeigt wurde, muss es nach dem Erstellen des Formulars erneut in der Vorschau angezeigt werden incoming Blatt zum ersten Mal.

Richten Sie das Blatt mit den Kopfzeilen ein, die den aufgenommenen Daten entsprechen. Sie können dies entweder manuell tun oder indem Sie eine POST-Anfrage an die Formularroute im AEM Admin Service senden. Der Admin-Service untersucht die Daten im Hauptteil der POST und erstellt die erforderlichen Kopfzeilen/Tabellen und Blätter, die erforderlich sind, um Daten aufzunehmen und den Forms-Service optimal zu nutzen.
Einzelheiten zum Format der POST-Anforderung zum Einrichten des Blatts finden Sie in der Admin-API Dokumentation sowie das folgende Beispiel:

Anfrage:

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

Antwort:

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

Sie können ein Tool wie curl oder Postman verwenden, um diese POST-Anfrage zu stellen. Zum Beispiel:

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

Durch die obige Anfrage zur POST stellen wir Beispieldaten bereit, d. h. die Formularfelder und Beispielwerte, die vom Admin-Service für die Einrichtung des Formulars verwendet werden.
Der Admin-Service wird empfohlen, Ihr Blatt einzurichten. Wenn Sie die Kopfzeilen jedoch manuell erstellen möchten, lesen Sie bitte das Dokument . Manuelle Forms Sheet-Einrichtung.

Nach dem Versand von POST Um den Admin-Service anzufordern, werden die folgenden Änderungen an Ihrer Arbeitsmappe angezeigt.

1. Ein Blatt mit dem Namen helix-default wird erstellt. Die Daten in diesem Blatt werden zurückgegeben, wenn ein GET Anforderung wird an das Blatt gesendet. Dies ist ein hervorragender Ort, um Tabellenformeln zu verwenden, um die Daten aus dem incoming Blatt für den Verbrauch anderswo.
   
   Hinweis: Die helix-default Das Blatt sollte niemals persönlich identifizierbare Informationen oder andere Daten enthalten, wenn Sie mit der öffentlichen Zugänglichkeit nicht einverstanden sind.

2. Ein Blatt mit dem Namen slack wurde erstellt. Hier können Sie automatische Benachrichtigungen für einen Slack-Kanal einrichten, wenn Daten in Ihre Tabelle aufgenommen werden. Derzeit unterstützt AEM nur Benachrichtigungen an die AEM Engineering Slack-Organisation sowie die Adobe Enterprise Support-Organisation.

   1. Um Slack-Benachrichtigungen einzurichten, geben Sie Folgendes ein: teamId des Arbeitsbereichs Slack und der channel Name oder ID. Sie können auch den Slack-Bot fragen (mit dem debug Befehl) für die teamId und die channel ID. Verwenden des channel Die ID anstelle des Namens ist vorzuziehen, da sie die Kanalumbenennungen übersteht.
      
      Hinweis: Ältere Formulare hatten nicht die teamId Spalte. Die teamId war in der channel Spalte, durch ein # oder /.
   2. Eingeben beliebiger Werte Anrede Sie möchten und unter Felder Geben Sie die Namen der Felder ein, die in der Slack-Benachrichtigung angezeigt werden sollen. Jede Überschrift sollte durch ein Komma (z. B. name, email).