Konfigurieren eines adaptiven Formulars für die REST-Endpunkt-Übermittlungsaktion

Foundation-Komponente

So konfigurieren Sie eine Übermittlungsaktion basierend auf der Swagger Open API-Spezifikation für ein adaptives Formular auf der Grundlage von Foundation-Komponenten:

1. Öffnen Sie das adaptive Formular zur Bearbeitung und navigieren Sie zum Abschnitt Übermittlung der Eigenschaften des Containers für adaptive Formulare.

2. 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 POST-Anfragen werden die Authentifizierungsinformationen der Sendeanfrage 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 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 wird verwendet, wenn Sie die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der HTTP GET-Anforderung weiterleiten möchten. 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.

3. Klicken Sie auf Fertig.

Kernkomponente

So konfigurieren Sie eine Übermittlungsaktion basierend auf der Swagger Open API-Spezifikation für ein adaptives Formular basierend auf Kernkomponenten:

1. Öffnen Sie den Inhalts-Browser und wählen Sie die Guide-Container-Komponente Ihres adaptiven Formulars aus.

2. Klicken Sie auf das Symbol für die Guide-Container-Eigenschaften . Das Dialogfeld „Container für ein adaptives Formular“ wird geöffnet.

3. Klicken Sie auf die Registerkarte Übermittlung.

4. 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 wird verwendet, wenn Sie die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der HTTP GET-Anforderung weiterleiten möchten. 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 für Ihren Service-REST-Endpunkt-Authentifizierungstyp erstellte Konfiguration und die Inhaltstypen auswählen. Weitere Informationen zum Authentifizierungstyp und zu den Inhaltstypen finden Sie unter Datenquellen konfigurieren

1. Klicken Sie auf Fertig.

Universeller Editor

So konfigurieren Sie eine Übermittlungsaktion basierend auf der Swagger Open API-Spezifikation für ein im universellen Editor erstelltes adaptives Formular:

1. Öffnen Sie das adaptive Formular zum Bearbeiten.

2. Klicken Sie im Editor die Erweiterung ​Formulareigenschaften bearbeiten“.
   Das 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 in der Extension Manager. Informationen zum Aktivieren oder Deaktivieren von Erweiterungen im universellen Editor finden im ArtikelExtension Manager-Feature-Highlights}.

   1. Klicken Sie auf **Übermittlung** und wählen Sie **An REST-Endpunkt übermitteln** Übermittlungsaktion 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 wird verwendet, wenn Sie die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der HTTP GET-Anforderung weiterleiten möchten. 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 für Ihren Service-REST-Endpunkt-Authentifizierungstyp erstellte Konfiguration und die Inhaltstypen auswählen. Weitere Informationen zum Authentifizierungstyp und zu den Inhaltstypen finden Sie unter Datenquellen konfigurieren

1. Klicken Sie Speichern und schließen.