Konfigurieren von Übermittlungsaktionen für AEM Forms

Der Formularübermittlungsdienst ist ein von Adobe gehosteter Endpunkt, der sich ideal für einfache Datenerfassungsszenarien eignet.

Unterstützte Ziele

• Tabellen: Google Sheets, Microsoft Excel (OneDrive/SharePoint)
• E-Mail: Senden von Formulardaten an bestimmte E-Mail-Adressen

Konfigurationsschritte

1. Einrichten des Zielzugriffs

   • Für Tabellen: Erteilen Sie Bearbeitungsberechtigungen für forms@adobe.com in der Zieltabelle.
   • Für E-Mail: Überprüfen Sie, ob E-Mail-Adressen von Empfängerinnen und Empfängern erreichbar sind.

2. Konfigurieren der Formularübermittlung

   • Öffnen Sie Ihr Formular in der Authoring-Umgebung.
   • Legen Sie die Übermittlungsaktion auf „Formularübermittlungsdienst“ fest.
   • Geben Sie die URL der Zieltabelle oder die E-Mail-Adressen an.
   • Speichern und veröffentlichen Sie das Formular.

3. Testübermittlung

   • Senden Sie Testdaten über das Formular.
   • Überprüfen Sie, ob die Daten im Ziel angezeigt werden.
   • Überprüfen Sie Fehlerprotokolle, wenn die Übermittlung fehlschlägt.

Wichtige Hinweise

• Das Dienstkonto forms@adobe.com erfordert Bearbeitungszugriff auf Zieltabellen
• E-Mail-Benachrichtigungen werden sofort nach der Formularübermittlung gesendet
• Die Datenvalidierung erfolgt auf der Dienstebene

Senden Sie Formulardaten zur komplexen Verarbeitung direkt an Ihre AEM as a Cloud Service-Veröffentlichungsinstanz.

Verwendung von AEM Publish

• Benutzerdefinierte AEM-Workflows nach der Übermittlung erforderlich
• Integration des Formulardatenmodells (FDM) in Datenbanken
• Integration von Drittanbieterdiensten (Marketo, Power Automate, Workfront Fusion)
• Azure Blob Storage- oder SharePoint-Dokumentbibliotheken
• Komplexe Server-seitige Validierung oder Verarbeitungslogik

Verfügbare Übermittlungsaktionen

• An REST-Endpunkt senden
• Per E-Mail senden (mithilfe der E-Mail-Dienste von AEM)
• Mit Formulardatenmodell senden
• AEM-Workflow aufrufen
• An SharePoint senden
• An OneDrive senden
• An Azure Blob Storage senden
• An Microsoft Power Automate senden
• An Adobe Workfront Fusion Senden
• An Adobe Marketo Engage senden

Konfigurationsanforderungen

​1. Aktualisieren der AEM-Instanz-URL in Edge Delivery

Aktualisieren Sie die URL der AEM Cloud Service-Instanz in der constant.js-Datei im form unter submitBaseUrl. Sie können die URL basierend auf Ihrer Umgebung konfigurieren:

Für Cloud Service-Instanz

export const submitBaseUrl = '<aem-publish-instance-URL>';

Für lokale Entwicklung

export const submitBaseUrl = 'http://localhost:<port-number>';

​2. OSGi Referrer-Filter

Konfigurieren Sie den Referrer-Filter, um Ihre spezifischen Edge Delivery-Site-Domains zuzulassen:

1. Erstellen oder aktualisieren Sie die OSGi-Konfigurationsdatei: org.apache.sling.security.impl.ReferrerFilter.cfg.json

2. Fügen Sie die folgende Konfiguration mit Ihren spezifischen Site-Domains hinzu:

   code language-json
   { "allow.empty": false, "allow.hosts": [ "main--abc--adobe.aem.live", "main--abc1--adobe.aem.live" ], "allow.hosts.regexp": [ "https://.*\\.aem\\.live:443", "https://.*\\.aem\\.page:443", "https://.*\\.hlx\\.page:443", "https://.*\\.hlx\\.live:443" ], "filter.methods": [ "POST", "PUT", "DELETE", "COPY", "MOVE" ], "exclude.agents.regexp": [ "" ] }

3. Bereitstellen der Konfiguration über Cloud Manager

Weitere Informationen zur Konfiguration des OSGi-Referrer-Filters finden Sie im Referrer-FilterHandbuch.

​3. CORS-Probleme (Cross-Origin Resource Sharing)

Konfigurieren Sie CORS-Einstellungen in AEM, um Anfragen von Ihren spezifischen Edge Delivery-Site-Domains zuzulassen:

Entwickler-Localhost

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(http://localhost(:\d+)?$)#" CORSTrusted=true

Edge Delivery Sites - Jede Site-Domain einzeln hinzufügen

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc--adobe\.aem\.live$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc1--adobe\.aem\.live$)#" CORSTrusted=true

Ältere Franklin-Domains (falls noch in Verwendung)

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.page$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.live$)#" CORSTrusted=true

Weitere Informationen zur CORS-Konfiguration finden Sie im CORS-Konfigurationshandbuch.

Informationen zum Aktivieren von CORS für Ihre lokale Entwicklungsumgebung finden Sie im Artikel Grundlegendes zu CORS (Cross-Origin Resource Sharing) .

​4. Konfiguration des Formulars

1. Erstellen Sie das Formular im universellen Editor.
2. Konfigurieren Sie die Übermittlungsaktion für die AEM Forms-Zielaktion.
3. Geben Sie den Pfad des Übermittlungsendpunkts an.
4. Veröffentlichen Sie das Formular auf der Edge Delivery-Site.

1. Erstellen einer Formularstruktur in Google Docs/Sheets
2. Konfigurieren des Endpunkts für den Formularübermittlungsdienst
3. Erteilen von forms@adobe.com-Bearbeitungszugriff auf die Zieltabelle
4. Veröffentlichen des Dokuments auf der Edge Delivery-Site
5. Übermittlung von Testformularen und Datenfluss

1. Erstellen von Formular im universellen Editor
2. Konfigurieren der Übermittlungsaktion zum Aufrufen eines AEM-Workflows
3. Einrichten von Dispatcher und Referrer-Filter in AEM Publish
4. Konfigurieren von CDN-Routing-Regeln
5. Veröffentlichen des Formulars und Testen der Workflow-Ausführung