Inlämningsåtgärd för anpassat formulär configuring-the-submit-action

Gäller för: ✔️ adaptiva formulärets Foundation-komponenter. ❌ Kärnkomponenter för adaptiv form. Adobe rekommenderar att du använder kärnkomponenter för att lägga till adaptiv Forms på en AEM Sites-sida eller för att skapa fristående adaptiv Forms.

En Skicka-åtgärd utlöses när en användare klickar på knappen Submit i ett anpassat formulär. Forms as a Cloud Service tillhandahåller följande Skicka-åtgärder direkt.

Du kan också utöka standardåtgärden för att skickaoch skapa en egen åtgärd för att skicka.

Du kan konfigurera en Skicka-åtgärd i avsnittet Submission i egenskaperna för den anpassade formulärbehållaren i sidofältet.

Skicka till REST-slutpunkt submit-to-rest-endpoint

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.

Om du vill skicka data till en intern server anger du sökvägen till resursen. Data bokförs som resurssökväg. Till exempel /content/restEndPoint. För sådana efterfrågningar används autentiseringsinformationen i förfrågan.

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 POSTENS 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älten 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 servern som är värd för formuläret använder du en relativ sökväg som motsvarar rotsökvägen för AEM. Exempel: /content/forms/af/SampleForm.html. Om du vill skicka data till en annan server använder du den absoluta sökvägen.

Skicka e-post send-email

Du kan använda åtgärden Send Email Skicka för att skicka ett e-postmeddelande till en eller flera mottagare när formuläret har skickats. E-postmeddelandet som genereras kan innehålla formulärdata i ett fördefinierat format. I följande mall hämtas till exempel kundnamn, leveransadress, namn på stat och postnummer från skickade formulärdata.

"

Hej ${customer_Name},

Följande anges som standardleveransadress:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Med vänlig hälsning,
WKND

"

Du kan även bifoga bilagor och ett DoR-dokument (Document of Record) till e-postmeddelandet. Om du vill aktivera alternativet Attach Document of Record konfigurerar du det adaptiva formuläret så att det skapar ett dokument för post (DoR). Du kan aktivera alternativet att generera ett postdokument från egenskaper för anpassat formulär.

Skicka med hjälp av formulärdatamodell (FDM) submit-using-form-data-model

Åtgärden Submit using Form Data Model Skicka skriver skickade adaptiva formulärdata för det angivna datamodellobjektet i en formulärdatamodell (FDM) till datakällan. När du konfigurerar åtgärden Skicka kan du välja ett datamodellsobjekt vars skickade data du vill skriva tillbaka till dess datakälla.

Dessutom kan du skicka en bifogad fil med en FDM (Form Data Model) och ett DoR-dokument (Document of Record) till datakällan. Mer information om formulärdatamodell (FDM) finns i AEM Forms Dataintegrering.

Anropa ett AEM invoke-an-aem-workflow

Åtgärden Invoke an AEM Workflow Skicka associerar ett anpassat formulär med ett AEM arbetsflöde. När ett formulär skickas startar det associerade arbetsflödet automatiskt på författarinstansen. Du kan spara datafilen, bifogade filer och postdokument på arbetsflödets nyttolastplats eller i en variabel. Om arbetsflödet är markerat för extern datalagring och konfigurerat för en extern datalagring är endast variabelalternativet tillgängligt. Du kan välja i listan över variabler som är tillgängliga för arbetsflödesmodellen. Om arbetsflödet markeras för extern datalagring i ett senare skede och inte när arbetsflödet skapas, kontrollerar du att de variabelkonfigurationer som krävs finns på plats.

Åtgärden Skicka placerar följande på arbetsflödets nyttolastplats, eller variabeln om arbetsflödet har markerats för extern datalagring:

Innan du använder åtgärden Invoke an AEM Workflow Skicka ska du konfigurera följande för konfigurationen AEM DS settings service:

Skicka till SharePoint submit-to-sharedrive

Åtgärden Submit to SharePoint för att skicka kopplar ett anpassat formulär till en Microsoft® SharePoint-lagring. Du kan skicka formulärdatafilen, bifogade filer eller arkivdokument till den anslutna Microsoft® Sharepoint-lagringsplatsen.

Med Skicka till SharePoint kan du

Ansluta ett anpassat formulär till SharePoint Document Library connect-af-sharepoint-doc-library

Så här använder du åtgärden Submit to SharePoint Document Library Skicka i en anpassad form:

Skapa en SharePoint Document Library-konfiguration create-sharepoint-configuration

Så här ansluter du AEM Forms till Microsoft® Sharepoint Document Library:

Nu kan du använda den här SharePoint Sites-konfigurationen för att skicka-åtgärden i ett adaptivt formulär.

Använda SharePoint Document Library Configuration i ett adaptivt formulär use-sharepoint-configuartion-in-af

Du kan använda den skapade SharePoint Document Library-konfigurationen i ett adaptivt formulär för att spara data eller generera Document of Record i en SharePoint-mapp. Utför följande steg för att använda lagringskonfigurationen för SharePoint Document Library i ett adaptivt formulär som:

När du skickar formuläret sparas data i den angivna Microsoft® Sharepoint-dokumentbibliotekslagringen.
Mappstrukturen som data ska sparas i är /folder_name/form_name/year/month/date/submission_id/data.

Ansluta ett anpassat formulär till Microsoft® SharePoint List connect-af-sharepoint-list

Så här använder du åtgärden Submit to SharePoint List Skicka i en anpassad form:

Skapa en listkonfiguration för SharePoint create-sharepoint-list-configuration

Så här ansluter du AEM Forms till din Microsoft® Sharepoint-lista:

Använda Skicka med hjälp av formulärdatamodell (FDM) i ett anpassat formulär use-submit-using-fdm

Du kan använda den skapade SharePoint List-konfigurationen i ett adaptivt formulär för att spara data eller skapa ett postdokument i en SharePoint List. Utför följande steg om du vill använda en lagringskonfiguration i SharePoint List i en anpassad form:

När du skickar formuläret sparas data i det angivna lagringsutrymmet för Microsoft® Sharepoint-listan.

Skicka till OneDrive submit-to-onedrive

Åtgärden Submit to OneDrive kopplar ett anpassat formulär till en Microsoft® OneDrive. Du kan skicka formulärdata, filer, bilagor eller arkivdokument till den anslutna Microsoft® OneDrive-lagringsplatsen. Så här använder du åtgärden Submit to OneDrive Skicka i en anpassad form:

Skapa en OneDrive-konfiguration create-onedrice-configuration

Så här ansluter du AEM Forms till din Microsoft® OneDrive-lagring:

Nu kan du använda den här lagringskonfigurationen för OneDrive för att skicka-åtgärden i ett adaptivt formulär.

Använd OneDrive-konfiguration i ett adaptivt formulär use-onedrive-configuartion-in-af

Du kan använda den skapade OneDrive-lagringskonfigurationen i ett adaptivt formulär för att spara data eller skapa ett postdokument i en OneDrive-mapp. Utför följande steg för att använda OneDrive-lagringskonfigurationen i ett adaptivt formulär som:

När du skickar formuläret sparas data i den angivna Microsoft® OneDrive-lagringsplatsen.
Mappstrukturen som data ska sparas i är /folder_name/form_name/year/month/date/submission_id/data.

Skicka till Azure Blob Storage submit-to-azure-blob-storage

Åtgärden Submit to Azure Blob Storage för att skicka kopplar ett anpassat formulär till en Microsoft® Azure-portal. Du kan skicka formulärdata, filer, bilagor eller arkivdokument till de anslutna Azure Storage-behållarna. Så här använder du åtgärden Skicka för Azure Blob Storage:

Skapa en Azure Blob Storage-behållare create-azure-configuration

Så här ansluter du AEM Forms till dina Azure-lagringsbehållare:

Nu kan du använda den här Azure Storage-behållarkonfigurationen för överföringsåtgärden i ett adaptivt formulär.

Använd Azure Storage-konfigurationen i ett adaptivt formulär use-azure-storage-configuartion-in-af

Du kan använda den skapade Azure Storage-behållarkonfigurationen i ett adaptivt formulär för att spara data eller skapa ett dokument av posten i Azure Storage-behållaren. Utför följande steg för att använda konfigurationen av Azure Storage-behållaren i ett adaptivt formulär som:

När du skickar formuläret sparas data i den angivna Azure Storage-behållarkonfigurationen.
Mappstrukturen som data ska sparas i är /configuration_container/form_name/year/month/date/submission_id/data.

Generera OSGi-konfigurationer med AEM SDK och distribuera konfigurationen till din Cloud Service om du vill ange värden för en konfiguration.

Skicka till Power Automate microsoft-power-automate

Du kan konfigurera ett adaptivt formulär så att det kör ett Microsoft® Power Automate Cloud-flöde när du skickar in det. Den konfigurerade adaptiva formen skickar inhämtade data, bilagor och arkivdokument till Power Automate Cloud Flow för bearbetning. Det hjälper er att bygga upp en anpassad datainhämtningsupplevelse och samtidigt utnyttja kraften i Microsoft® Power Automate för att skapa affärslogik kring insamlade data och automatisera kundarbetsflöden. Här är några exempel på vad du kan göra efter att ha integrerat ett adaptivt formulär med Microsoft® Power Automate:

Den adaptiva Forms-redigeraren tillhandahåller Anropa ett Microsoft® Power Automate-flöde för att skicka adaptiva formulärdata, bilagor och arkivdokument som skickas till Power Automate Cloud Flow. Om du vill använda åtgärden Skicka för att skicka hämtade data till Microsoft® Power Automate ansluter du Forms as a Cloud Service-instansen till Microsoft® Power Automate

När konfigurationen är klar kan du använda åtgärden Anropa ett Microsoft® Power Automate-flöde för att skicka data till ett Power Automate-flöde.

Skicka till Workfront Fusion workfront-fusion

Du kan konfigurera ett adaptivt formulär så att data skickas till Workfront Fusion när de skickas. Med Workfront Fusion kan man automatisera processer så att man kan koncentrera sig på nya uppgifter istället för att upprepa samma uppgifter om och om igen. Den automatiserar både enkla och komplexa uppgifter, sparar tid och säkerställer ett konsekvent processutförande.

Den adaptiva Forms-redigeraren innehåller Anropa ett Workfront Fusion-scenario som skickar adaptiva Forms-data eller bilagor till ett Workfront Fusion-scenario. Om du vill använda åtgärden Skicka för att skicka hämtade data till ett Workfront Fusion-scenario läser du Skicka ett anpassat formulär till Adobe Workfront Fusion.

Använd synkron eller asynkron sändning use-synchronous-or-asynchronous-submission

En Skicka-åtgärd kan använda synkron eller asynkron sändning.

Synkron sändning: Webbformulär har vanligtvis konfigurerats att skicka synkront. När användare skickar ett formulär omdirigeras de i en synkron sändning till en bekräftelsesida, en tacksida eller en felsida om det uppstår ett överföringsfel. Du kan välja alternativet Use asynchronous submission om du vill dirigera om användarna till en webbsida eller visa ett meddelande när de skickas.

Asynkron överföring: Moderna webbupplevelser som enkelsidiga program blir allt populärare där webbsidan förblir statisk medan klient-server-interaktion sker i bakgrunden. Du kan nu tillhandahålla den här upplevelsen med Adaptive Forms genom att konfigurera asynkron sändning.

Förtroende på serversidan i adaptiv form server-side-revalidation-in-adaptive-form

I alla onlinesystem för datainhämtning lägger utvecklare vanligtvis in JavaScript-valideringar på klientsidan för att tillämpa några få affärsregler. Men i moderna webbläsare kan slutanvändarna kringgå valideringarna och skicka in dokument manuellt med hjälp av olika tekniker, till exempel DevTools Console för webbläsare. Sådana tekniker gäller även för Adaptive Forms. En formulärutvecklare kan skapa olika valideringslogik, men tekniskt sett kan slutanvändarna kringgå dessa valideringslogik och skicka ogiltiga data till servern. Ogiltiga data skulle bryta mot de affärsregler som en formulärförfattare har infört.

Med funktionen för omvalidering på serversidan kan du även köra de valideringar som en adaptiv Forms-författare har tillhandahållit när han eller hon utformar ett adaptivt formulär på servern. Det förhindrar att inskickade data äventyras och affärsregelöverträdelser som representeras i form av formulärvalidering.

Vad ska valideras på servern? what-to-validate-on-server-br

Alla valideringar av ett adaptivt formulär som körs på servern i fältet OOTB (OOTB) är:

Aktivera validering på serversidan enabling-server-side-validation-br

Använd Revalidate on server under Adaptiv formulärbehållare i sidlisten för att aktivera eller inaktivera validering på serversidan för det aktuella formuläret.

Aktivera validering på serversidan

Om slutanvändaren åsidosätter dessa valideringar och skickar formulären utför servern valideringen igen. Om valideringen misslyckas vid serverslutet stoppas skicka-transaktionen. Användaren får det ursprungliga formuläret igen. Insamlade data och skickade data visas för användaren som ett fel.

Stöd för anpassade funktioner i valideringsuttryck supporting-custom-functions-in-validation-expressions-br

Om det finns komplexa valideringsregler finns ibland det exakta valideringsskriptet i anpassade funktioner och författaren anropar dessa anpassade funktioner från fältvalideringsuttryck. Om du vill att det här anpassade funktionsbiblioteket ska vara känt och tillgängligt vid validering på serversidan kan formulärförfattaren konfigurera namnet på AEM klientbibliotek på fliken Basic i egenskaperna för adaptiv formulärbehållare enligt nedan.

Stöd för anpassade funktioner i valideringsuttryck

Författaren kan konfigurera customJavaScript-bibliotek per adaptiv form. I biblioteket behåller du bara återanvändbara funktioner som är beroende av jquery- och underscore.js-bibliotek från tredje part.

Felhantering vid Skicka-åtgärd error-handling-on-submit-action

Som en del av AEM riktlinjer för säkerhet och skärpa konfigurerar du anpassade felsidor som 400.jsp, 404.jsp och 500.jsp. Dessa hanterare anropas när ett formulär 400-, 404- eller 500-fel skickas. Hanterarna anropas också när dessa felkoder aktiveras på Publish-noden. Du kan också skapa JSP-sidor för andra HTTP-felkoder.

När du förifyller en formulärdatamodell (FDM), eller schemabaserad adaptiv form med XML- eller JSON-dataklagomål till ett schema som inte innehåller <afData> -, <afBoundData> - och </afUnboundData> -taggar, förloras data i obegränsade fält i det adaptiva formuläret. Schemat kan vara ett XML-schema, ett JSON-schema eller en FDM (Form Data Model). Obegränsade fält är adaptiva formulärfält utan egenskapen bindref.