Konfigurera ett anpassat formulär för REST-slutpunktsåtgärd
Möjligheten att ange REST-slutpunkten med hjälp av konfigurationen är ett tidigt Adobe-program och kan endast användas för kärnkomponenter och Edge Delivery Services Forms. Du kan skriva till aem-forms-ea@adobe.com
från ditt officiella e-post-id för att gå med i det tidiga adopterprogrammet och begära åtkomst till funktionen.
Använd åtgärden Submit to REST Endpoint för att skicka skickade data till en REST-URL. URL:en kan vara en intern (servern som formuläret återges på) eller en extern server.
AEM as a Cloud Service erbjuder olika inskickningsåtgärder för att hantera inskickade formulär. Du kan läsa mer om de här alternativen i artikeln Åtgärd för att skicka anpassade formulär.
Fördelar
Några av fördelarna med att konfigurera Submit to REST endpoint-sändningsåtgärden för Adaptiv Forms är:
- Det möjliggör smidig integrering av formulärdata med externa system och tjänster via RESTful API:er.
- Det ger flexibilitet vid hantering av data som skickas från Adaptive Forms, vilket ger stöd för dynamiska och komplexa datastrukturer.
- Det har stöd för dynamisk mappning av formulärfält till parametrar i REST-slutpunkts-URL, vilket möjliggör anpassningsbara och anpassningsbara dataöverföringar.
Konfigurera åtgärden Skicka till REST-slutpunkt steps-to-configure-submit-to-restendpoint-submit-action
Så här konfigurerar du en skicka-åtgärd baserat på Swagger Open API-specifikationen för Adaptive Form som baseras på Foundation-komponenter:
-
Öppna det adaptiva formuläret för redigering och navigera till avsnittet Submission i egenskaperna för den adaptiva formulärbehållaren.
-
I listrutan Submit Action väljer du Submit to Rest endpoint.
Om du vill skicka data till en intern server anger du sökvägen till resursen. Data bokförs som resurssökväg. Exempel:
/content/restEndPoint
. För sådana efterfrågningar används autentiseringsinformationen i förfrågan.
Med det här alternativet kan du ange REST-målslutpunkten direkt.
Ange en URL om du vill skicka data till en extern server. URL-formatet ärhttps://host:port/path_to_rest_end_point
. Se till att du konfigurerar sökvägen så att den hanterar POST-begäran anonymt.
I exemplet ovan hämtas användarinformationen i
textbox
med parameternparam1
. Syntaxen för att bokföra data som har hämtats medparam1
är:String data=request.getParameter("param1");
På samma sätt är parametrar som du använder för att skicka XML-data och bifogade filer
dataXml
ochattachments
.Du kan till exempel använda de här två parametrarna i skriptet för att tolka data till en slutpunkt. Du använder följande syntax för att lagra och analysera data:
String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");
I det här exemplet lagrar
data
XML-data ochatt
lagrar data för bifogade filer.
Åtgärden Submit to REST endpoint Skicka skickar data som är ifyllda i formuläret till en konfigurerad bekräftelsesida som en del av HTTP GET-begäran. Du kan lägga till namnet på fältet som ska begäras. Begäran har följande format:{fieldName}={request parameter name}
Som visas i bilden nedan skickas
param1
ochparam2
som parametrar med värden som kopierats från fälten texbox och numerbox för nästa åtgärd.Du kan också Enable POST request och ange en URL för att skicka begäran. Om du vill skicka data till den AEM-server som är värd för formuläret använder du en relativ sökväg som motsvarar rotsökvägen för AEM-servern. Exempel:
/content/forms/af/SampleForm.html
. Om du vill skicka data till en annan server använder du den absoluta sökvägen. -
Klicka på Done.
Så här konfigurerar du en överföringsåtgärd baserad på Swagger Open API-specifikationen för adaptiva formulär baserade på kärnkomponenter:
-
Öppna innehållsläsaren och markera komponenten Guide Container i det adaptiva formuläret.
-
Klicka på ikonen för egenskaper för stödlinjebehållaren
-
Klicka på fliken Submission.
-
I listrutan Submit Action väljer du Submit to Rest endpoint.
Om du vill skicka data till en intern server anger du sökvägen till resursen. Data bokförs som resurssökväg. Exempel:
/content/restEndPoint
. För sådana efterfrågningar används autentiseringsinformationen i förfrågan.Det finns två alternativ för att ange REST-slutpunkten:
accordion URL Med det här alternativet kan du ange REST-målslutpunkten direkt.
Ange en URL om du vill skicka data till en extern server. URL-formatet är https://host:port/path_to_rest_end_point
. Se till att du konfigurerar sökvägen så att den hanterar POST-begäran anonymt.
I exemplet ovan hämtas användarinformationen i textbox
med parametern param1
. Syntaxen för att bokföra data som har hämtats med param1
är:
String data=request.getParameter("param1");
På samma sätt är parametrar som du använder för att skicka XML-data och bifogade filer dataXml
och attachments
.
Du kan till exempel använda de här två parametrarna i skriptet för att tolka data till en slutpunkt. Du använder följande syntax för att lagra och analysera data:
String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");
I det här exemplet lagrar data
XML-data och att
lagrar data för bifogade filer.
Åtgärden Submit to REST endpoint Skicka skickar data som är ifyllda i formuläret till en konfigurerad bekräftelsesida som en del av HTTP GET-begäran. Du kan lägga till namnet på fältet som ska begäras. Begäran har följande format:
{fieldName}={request parameter name}
Som visas i bilden nedan skickas param1
och param2
som parametrar med värden som kopierats från fälten texbox och numerbox för nästa åtgärd.
Du kan också Enable POST request och ange en URL för att skicka begäran. Om du vill skicka data till den AEM-server som är värd för formuläret använder du en relativ sökväg som motsvarar rotsökvägen för AEM-servern. Exempel: /content/forms/af/SampleForm.html
. Om du vill skicka data till en annan server använder du den absoluta sökvägen.
+++
accordion |
---|
Konfiguration |
Med det här alternativet kan du lägga till en fördefinierad HTTP-konfiguration som hanteras via AEM Configuration Browser. Du kan välja den konfiguration som har skapats för tjänstens autentiseringstyp för återställningsslutpunkt och innehållstyper. Mer information om autentiseringstyp och innehållstyper finns på Konfigurera datakällor |
- Klicka på Done.
Så här konfigurerar du en åtgärd som baseras på Swagger Open API-specifikationen för Adaptive Form som har skapats i Universal Editor:
-
Öppna det adaptiva formuläret för redigering.
-
Klicka på tillägget Redigera formuläregenskaper i redigeraren.
Dialogrutan Formuläregenskaper visas.note note NOTE - Om ikonen Redigera formuläregenskaper inte visas i det universella redigeringsgränssnittet aktiverar du tillägget Redigera formuläregenskaper i Extension Manager.
- Läs artikeln Extension Manager Feature Highlights om du vill veta hur du aktiverar eller inaktiverar tillägg i den universella redigeraren.
1. Klicka på fliken **Skicka** och välj åtgärden **Submit to Rest endpoint** Skicka.
Om du vill skicka data till en intern server anger du sökvägen till resursen. Data bokförs som resurssökväg. Exempel:
/content/restEndPoint
. För sådana efterfrågningar används autentiseringsinformationen i förfrågan.Det finns två alternativ för att ange REST-slutpunkten:
accordion URL Med det här alternativet kan du ange REST-målslutpunkten direkt.
Ange en URL om du vill skicka data till en extern server. URL-formatet är https://host:port/path_to_rest_end_point
. Se till att du konfigurerar sökvägen så att den hanterar POST-begäran anonymt.
I exemplet ovan hämtas användarinformationen i textbox
med parametern param1
. Syntaxen för att bokföra data som har hämtats med param1
är:
String data=request.getParameter("param1");
På samma sätt är parametrar som du använder för att skicka XML-data och bifogade filer dataXml
och attachments
.
Du kan till exempel använda de här två parametrarna i skriptet för att tolka data till en slutpunkt. Du använder följande syntax för att lagra och analysera data:
String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");
I det här exemplet lagrar data
XML-data och att
lagrar data för bifogade filer.
Åtgärden Submit to REST endpoint Skicka skickar data som är ifyllda i formuläret till en konfigurerad bekräftelsesida som en del av HTTP GET-begäran. Du kan lägga till namnet på fältet som ska begäras. Begäran har följande format:
{fieldName}={request parameter name}
Som visas i bilden nedan skickas param1
och param2
som parametrar med värden som kopierats från fälten texbox och numerbox för nästa åtgärd.
Du kan också Enable POST request och ange en URL för att skicka begäran. Om du vill skicka data till den AEM-server som är värd för formuläret använder du en relativ sökväg som motsvarar rotsökvägen för AEM-servern. Exempel: /content/forms/af/SampleForm.html
. Om du vill skicka data till en annan server använder du den absoluta sökvägen.
+++
accordion |
---|
Konfiguration |
Med det här alternativet kan du lägga till en fördefinierad HTTP-konfiguration som hanteras via AEM Configuration Browser. Du kan välja den konfiguration som har skapats för tjänstens autentiseringstyp för återställningsslutpunkt och innehållstyper. Mer information om autentiseringstyp och innehållstyper finns på Konfigurera datakällor |
- Klicka på Save&Close.
Bästa praxis
- När du skickar data till en extern server ska du kontrollera att URL:en är säker och konfigurera sökvägen så att POST-begäran hanteras anonymt för att skydda känslig information.
- Om du vill skicka fälten som parametrar i en REST-URL måste alla fält ha olika elementnamn, även om fälten placeras på olika paneler.
Relaterade artiklar
- Skicka e-post
- Skicka till SharePoint Document Library
- Skicka till SharePoint List
- Skicka med formulärdatamodell
- Skicka till Azure Blob Storage
- Skicka till REST-slutpunkt
- Skicka till OneDrive
- Starta ett AEM-arbetsflöde
- Skicka till Power Automate
- Skicka till Workfront Fusion
- Ansluta anpassat formulär till Salesforce
- Ansluta ett adaptivt formulär till Microsoft
- Ansluta ett adaptivt formulär till Adobe Marketo Engage
- Skapa anpassad skickaåtgärd