Konfigurieren eines adaptiven Formulars für die REST-Endpunkt-Übermittlungsaktion
Die Funktion zum Angeben des REST-Endpunkts per Konfiguration ist ein Early-Adopter-Programm und gilt nur für Kernkomponenten- und Edge Delivery Services-Formulare. Sie können von Ihrer offiziellen E-Mail-ID aus an aem-forms-ea@adobe.com
schreiben, um dem Early-Adopter-Programm beizutreten und Zugriff auf die Funktion anzufordern.
Verwenden Sie die Aktion An REST-Endpunkt übermitteln, um die übertragenen Daten an eine Rest-URL zu veröffentlichen. Die URL kann sich auf einem internen Server (dem Server, auf dem das Formular gerendert wird) oder auf einem externen Server befinden.
AEM as a Cloud Service bietet verschiedene vordefinierte Übermittlungsaktionen für die Verarbeitung von Formularübermittlungen. Weitere Informationen zu diesen Optionen finden Sie im Artikel Übermittlungsaktion für adaptive Formulare.
Vorteile
Einige Vorteile der Konfiguration der Übermittlungsaktion An REST-Endpunkt übermitteln für adaptive Formulare sind:
- Sie ermöglicht die nahtlose Integration von Formulardaten in externe Systeme und Dienste über RESTful-APIs.
- Sie bietet Flexibilität bei der Verarbeitung von Datenübermittlungen aus adaptiven Formularen und unterstützt dynamische und komplexe Datenstrukturen.
- Sie unterstützt die dynamische Zuordnung von Formularfeldern zu Parametern in der REST-Endpunkt-URL, was eine anpassbare und benutzerdefinierte Datenübermittlung ermöglicht.
Konfigurieren der Übermittlungsaktion als „An REST-Endpunkt übermitteln“ steps-to-configure-submit-to-restendpoint-submit-action
So konfigurieren Sie eine Übermittlungsaktion basierend auf der Swagger Open API-Spezifikation für ein auf Foundation-Komponenten basierendes adaptives Formular:
-
Öffnen Sie das adaptive Formular zur Bearbeitung und navigieren Sie zum Abschnitt Übermittlung der Eigenschaften des Containers für adaptive Formulare.
-
Wählen Sie aus der Dropdown-Liste Übermittlungsaktion die Option An REST-Endpunkt übermitteln.
Um Daten auf einem internen Server zu senden, geben Sie den Pfad der Ressource an. Die Daten werden an den Pfad der Ressource gesendet. Beispiel:
/content/restEndPoint
. Für solche Sende-Anfragen werden die Authentifizierungsinformationen der Versandanfrage verwendet.
Mit dieser Option können Sie den Ziel-REST-Endpunkt direkt eingeben.
Geben Sie eine URL an, um Daten an einen externen Server zu senden. Das Format der URL isthttps://host:port/path_to_rest_end_point
. Stellen Sie sicher, dass Sie den Pfad zum Handhaben der POST-Anforderung anonym konfigurieren.
Im obigen Beispiel hat der Benutzer Informationen in die
textbox
eingegeben, die mithilfe von Parameterparam1
erfasst werden. Die Syntax zur Veröffentlichung erfasster Daten mithilfe vonparam1
lautet:String data=request.getParameter("param1");
Auch Parameter, die Sie für die Veröffentlichung von XML-Daten und Anlagen verwenden, sind
dataXml
undattachments
.Beispielsweise können Sie diese beiden Parameter in Ihrem Skript verwenden, um Daten an einem REST-Endpunkt zu analysieren. Verwenden Sie die folgende Syntax, um Daten zu speichern und zu analysieren:
String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");
In diesem Beispiel speichert
data
die XML-Daten, undatt
speichert Anhangdaten.
Die Übermittlungsoption An REST-Endpunkt übermitteln übermittelt die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der HTTP-GET-Anfrage. Sie können den Namen der anzufordernden Felder hinzufügen. Das Format der Anfrage lautet:{fieldName}={request parameter name}
Wie in der folgenden Abbildung dargestellt, werden
param1
undparam2
als Parameter mit Werten, die aus den Feldern textbox und numericbox kopiert wurden, für die nächste Aktion weitergeleitet.Sie können auch POST-Anforderungen aktivieren und eine URL eingeben, um die Anforderung zu veröffentlichen. Um Daten an den AEM-Server, auf dem sich das Formular befindet, zu senden, verwenden Sie einen relativen Pfad entsprechend dem Stammpfad des AEM-Servers. Beispiel:
/content/forms/af/SampleForm.html
. Wenn Sie Daten an irgendeinen anderen Server senden, verwenden Sie den absoluten Pfad. -
Klicken Sie auf Fertig.
So konfigurieren Sie eine Übermittlungsaktion basierend auf der Swagger Open API-Spezifikation für ein auf Kernkomponenten basierendes adaptives Formular:
-
Öffnen Sie den Inhalts-Browser und wählen Sie die Guide-Container-Komponente Ihres adaptiven Formulars aus.
-
Klicken Sie auf das Symbol für die Guide-Container-Eigenschaften
-
Klicken Sie auf die Registerkarte Übermittlung.
-
Wählen Sie aus der Dropdown-Liste Übermittlungsaktion die Option An REST-Endpunkt übermitteln.
Um Daten auf einem internen Server zu senden, geben Sie den Pfad der Ressource an. Die Daten werden an den Pfad der Ressource gesendet. Beispiel:
/content/restEndPoint
. Für solche Sende-Anfragen werden die Authentifizierungsinformationen der Versandanfrage verwendet.Sie haben zwei Möglichkeiten, den REST-Endpunkt anzugeben:
accordion URL Mit dieser Option können Sie den Ziel-REST-Endpunkt direkt eingeben.
Geben Sie eine URL an, um Daten an einen externen Server zu senden. Das Format der URL ist https://host:port/path_to_rest_end_point
. Stellen Sie sicher, dass Sie den Pfad zum Handhaben der POST-Anforderung anonym konfigurieren.
Im obigen Beispiel hat der Benutzer Informationen in die textbox
eingegeben, die mithilfe von Parameter param1
erfasst werden. Die Syntax zur Veröffentlichung erfasster Daten mithilfe von param1
lautet:
String data=request.getParameter("param1");
Auch Parameter, die Sie für die Veröffentlichung von XML-Daten und Anlagen verwenden, sind dataXml
und attachments
.
Beispielsweise können Sie diese beiden Parameter in Ihrem Skript verwenden, um Daten an einem REST-Endpunkt zu analysieren. Verwenden Sie die folgende Syntax, um Daten zu speichern und zu analysieren:
String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");
In diesem Beispiel speichert data
die XML-Daten, und att
speichert Anlagendaten.
Die Übermittlungsoption An REST-Endpunkt übermitteln übermittelt die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der HTTP-GET-Anfrage. Sie können den Namen der anzufordernden Felder hinzufügen. Das Format der Anfrage lautet:
{fieldName}={request parameter name}
Wie in der folgenden Abbildung dargestellt, werden param1
und param2
als Parameter mit Werten, die aus den Feldern textbox und numericbox kopiert wurden, für die nächste Aktion weitergeleitet.
Sie können auch POST-Anforderungen aktivieren und eine URL eingeben, um die Anforderung zu veröffentlichen. Um Daten an den AEM-Server, auf dem sich das Formular befindet, zu senden, verwenden Sie einen relativen Pfad entsprechend dem Stammpfad des AEM-Servers. Beispiel: /content/forms/af/SampleForm.html
. Wenn Sie Daten an irgendeinen anderen Server senden, verwenden Sie den absoluten Pfad.
+++
accordion |
---|
Konfiguration |
Mit dieser Option können Sie eine vordefinierte HTTP-Konfiguration hinzufügen, die über den Konfigurations-Browser von AEM verwaltet wird. Sie können die Konfiguration auswählen, die Sie für den Authentifizierungstyp Ihres Dienst-REST-Endpunkts und die Inhaltstypen erstellt haben. Weitere Informationen zum Authentifizierungstyp und zu den Inhaltstypen finden Sie unter Konfigurieren von Datenquellen. |
- Klicken Sie auf Fertig.
So konfigurieren Sie eine Übermittlungsaktion basierend auf der Swagger Open API-Spezifikation für ein im universellen Editor erstelltes adaptives Formular:
-
Öffnen Sie das adaptive Formular zum Bearbeiten.
-
Klicken Sie im Editor auf die Erweiterung Formulareigenschaften bearbeiten.
Das Dialogfeld Formulareigenschaften wird angezeigt.note note NOTE - Wenn das Symbol Formulareigenschaften bearbeiten in der Benutzeroberfläche des universellen Editors nicht angezeigt wird, aktivieren Sie die Erweiterung Formulareigenschaften bearbeiten im Extension Manager.
- Informationen zum Aktivieren und Deaktivieren von Erweiterungen im universellen Editor finden Sie im Artikel Extension Manager – Highlights der Funktionen.
1. Klicken Sie auf **Übermittlung** und wählen Sie die Übermittlungsaktion **An REST-Endpunkt übermitteln** aus.
Um Daten auf einem internen Server zu senden, geben Sie den Pfad der Ressource an. Die Daten werden an den Pfad der Ressource gesendet. Beispiel:
/content/restEndPoint
. Für solche Sende-Anfragen werden die Authentifizierungsinformationen der Versandanfrage verwendet.Sie haben zwei Möglichkeiten, den REST-Endpunkt anzugeben:
accordion URL Mit dieser Option können Sie den Ziel-REST-Endpunkt direkt eingeben.
Geben Sie eine URL an, um Daten an einen externen Server zu senden. Das Format der URL ist https://host:port/path_to_rest_end_point
. Stellen Sie sicher, dass Sie den Pfad zum Handhaben der POST-Anforderung anonym konfigurieren.
Im obigen Beispiel hat der Benutzer Informationen in die textbox
eingegeben, die mithilfe von Parameter param1
erfasst werden. Die Syntax zur Veröffentlichung erfasster Daten mithilfe von param1
lautet:
String data=request.getParameter("param1");
Auch Parameter, die Sie für die Veröffentlichung von XML-Daten und Anlagen verwenden, sind dataXml
und attachments
.
Beispielsweise können Sie diese beiden Parameter in Ihrem Skript verwenden, um Daten an einem REST-Endpunkt zu analysieren. Verwenden Sie die folgende Syntax, um Daten zu speichern und zu analysieren:
String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");
In diesem Beispiel speichert data
die XML-Daten, und att
speichert Anlagendaten.
Die Übermittlungsoption An REST-Endpunkt übermitteln übermittelt die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der HTTP-GET-Anfrage. Sie können den Namen der anzufordernden Felder hinzufügen. Das Format der Anfrage lautet:
{fieldName}={request parameter name}
Wie in der folgenden Abbildung dargestellt, werden param1
und param2
als Parameter mit Werten, die aus den Feldern textbox und numericbox kopiert wurden, für die nächste Aktion weitergeleitet.
Sie können auch POST-Anforderungen aktivieren und eine URL eingeben, um die Anforderung zu veröffentlichen. Um Daten an den AEM-Server, auf dem sich das Formular befindet, zu senden, verwenden Sie einen relativen Pfad entsprechend dem Stammpfad des AEM-Servers. Beispiel: /content/forms/af/SampleForm.html
. Wenn Sie Daten an irgendeinen anderen Server senden, verwenden Sie den absoluten Pfad.
+++
accordion |
---|
Konfiguration |
Mit dieser Option können Sie eine vordefinierte HTTP-Konfiguration hinzufügen, die über den Konfigurations-Browser von AEM verwaltet wird. Sie können die Konfiguration auswählen, die Sie für den Authentifizierungstyp Ihres Dienst-REST-Endpunkts und die Inhaltstypen erstellt haben. Weitere Informationen zum Authentifizierungstyp und zu den Inhaltstypen finden Sie unter Konfigurieren von Datenquellen. |
- Klicken Sie auf Speichern und schließen.
Best Practices
- Stellen Sie beim Senden von Daten an einen externen Server sicher, dass die URL sicher ist, und konfigurieren Sie den Pfad, um die POST-Anforderung anonym zu verarbeiten und dadurch vertrauliche Informationen zu schützen.
- Alle Felder müssen über verschiedene Elementnamen verfügen, um als Parameter in der REST-URL weitergeleitet zu werden, und zwar auch dann, wenn die Felder in verschiedene Bereiche platziert wurden.
Verwandte Artikel
- E-Mail senden
- Übermitteln an eine SharePoint-Dokumentbibliothek
- Übermitteln an eine SharePoint-Liste
- Mit Formulardatenmodell senden
- An Azure Blob Storage senden
- An REST-Endpunkt senden
- An OneDrive senden
- AEM-Workflow aufrufen
- An Power Automate senden
- An Workfront Fusion senden
- Verbinden eines adaptiven Formulars mit einer Salesforce-Anwendung
- Verbinden eines adaptiven Formulars mit Microsoft
- Verbinden eines adaptiven Formulars mit Adobe Marketo Engage
- Erstellen einer benutzerdefinierten Sendeaktion