Konfigurera åtgärden Skicka configuring-the-submit-action

Adobe rekommenderar att du använder den moderna och utbyggbara datainhämtningen Core Componentsför att skapa nya adaptiva Formseller att lägga till adaptiva Forms på AEM Sites-sidor. De här komponenterna utgör ett betydande framsteg när det gäller att skapa adaptiva Forms-filer, vilket ger imponerande användarupplevelser. I den här artikeln beskrivs det äldre sättet att skapa Adaptiv Forms med baskomponenter.

Version
Artikellänk
AEM as a Cloud Service
Klicka här
AEM 6.5
Den här artikeln

Introduktion till att skicka in åtgärder introduction-to-submit-actions

En sändningsåtgärd utlöses när en användare klickar på knappen Skicka i ett anpassat formulär. Du kan konfigurera åtgärden skicka i anpassningsbara formulär. Med adaptiva formulär kan du skicka in ett antal åtgärder direkt. Du kan kopiera och utöka standardåtgärderna för att skicka och skapa en egen sändningsåtgärd. Baserat på dina krav kan du dock skriva och registrera din egen skicka-åtgärd för att bearbeta data i det skickade formuläret. Överföringsåtgärden kan använda synkron eller asynkron sändning.

Du kan konfigurera en skicka-åtgärd i avsnittet Skicka i egenskaperna för den adaptiva formulärbehållaren i sidlisten.

Konfigurera Skicka-åtgärd

Konfigurera Skicka-åtgärd

Standardåtgärderna för att skicka in anpassningsbara formulär är:

  • Skicka till REST-slutpunkt
  • Skicka e-post
  • Skicka PDF via e-post
  • Anropa en Forms Workflow
  • Skicka med formulärdatamodell
  • Forms Portal Submit Action
  • Anropa ett AEM arbetsflöde
  • Skicka till Power Automate
NOTE
Åtgärden Skicka PDF via e-post gäller endast för adaptiva formulär som använder XFA-mall som formulärmodell.
NOTE
Kontrollera att mappen [AEM_Installation_Directory]\crx-quickstart\temp\datamanager\ASM
finns. Katalogen krävs för att temporärt lagra bilagor. Om katalogen inte finns skapar du den.
CAUTION
Om du förifyller en formulärmall, formulärdatamodell eller schemabaserad adaptiv form med XML- eller JSON-data klagomål till ett schema (XML-schema, JSON-schema, formulärmall eller formulärdatamodell) som är data innehåller inte <afData>-, <afBoundData>- och </afUnboundData>-taggar, är data för obegränsade fält (obundna fält) adaptiva formulärfält utan bindref -egenskap) i det adaptiva formuläret går förlorade.

Du kan skriva en anpassad skicka-åtgärd för anpassade formulär för att uppfylla ditt användningssätt. Mer information finns i Skriva anpassad sändningsåtgärd för anpassningsbara formulär.

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

Skicka-alternativet Skicka till REST-slutpunkten 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 textruta och numerisk ruta för nästa åtgärd.

Du kan också Aktivera begäran om POST och ange en URL för att skicka begäran. Om du vill skicka data till Experience Manager-servern som är värd för formuläret använder du en relativ sökväg som motsvarar rotsökvägen för Experience Manager-servern. Exempel: /content/forms/af/SampleForm.html. Om du vill skicka data till en annan server använder du den absoluta sökvägen.

Konfigurerar åtgärden Skicka för resterande slutpunkt

Konfigurerar åtgärden Skicka för resterande slutpunkt

NOTE
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.

Post har skickat data till en resurs eller en extern slutpunkt  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

Använd åtgärden Skicka till REST-slutpunkt 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-adressen har formatet https://host:port/path_to_rest_end_point. Se till att du konfigurerar sökvägen så att den hanterar POSTENS begäran anonymt.

Mappning för fältvärden skickas som parametrar för Tack-sidan

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.

Skicka e-post send-email

Åtgärden Skicka e-post skickar 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.

NOTE
Alla formulärfält måste ha olika elementnamn, även om de finns på olika paneler), för att kunna inkludera formulärdata i ett e-postmeddelande.

Skicka PDF via e-post send-pdf-via-email

Skicka PDF via e-post skickar ett e-postmeddelande med ett PDF som innehåller formulärdata till en eller flera mottagare när formuläret har skickats.

NOTE
Den här överföringsåtgärden är tillgänglig för XFA-baserade adaptiva formulär och XSD-baserade adaptionsformulär som har dokumentmallen.

Anropa en Forms Workflow invoke-a-forms-workflow

Skicka-alternativet Skicka till Forms Workflow skickar en XML-datafil och eventuella bifogade filer till ett befintligt Adobe-LiveCycle eller till AEM Forms i JEE-processen.

Mer information om hur du konfigurerar åtgärden Skicka till Forms Workflow finns i Skicka och bearbeta formulärdata med formulärarbetsflöden.

Skicka med formulärdatamodell submit-using-form-data-model

Åtgärden Skicka med formulärdatamodell skriver skickade adaptiva formulärdata för det angivna datamodellsobjektet i en formulärdatamodell till datakällan. När du konfigurerar skicka-åtgärden 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 hjälp av en formulärdatamodell och en DoR-fil (Document of Record) till datakällan.

Mer information om formulärdatamodell finns i AEM Forms-dataintegrering.

Forms Portal Submit Action forms-portal-submit-action

Med alternativet Forms Portal Submit Action blir formulärdata tillgängliga via en AEM Forms Portal.

Mer information om Forms Portal och skicka-åtgärden finns i Komponenten för utkast och inskickning.

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 i mappen relativt eller under arbetsflödets eller variabelns nyttolast. Om arbetsflödet är markerat för extern datalagring är variabelalternativet tillgängligt och inte nyttolastalternativet. 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.

Innan du använder åtgärden Anropa ett AEM arbetsflöde måste du konfigurera Experience Manager DS-inställningarna. Mer information om hur du skapar ett AEM arbetsflöde finns i Formulärbaserade arbetsflöden i OSGi.

Åtgärden Skicka placerar följande på arbetsflödets nyttolastplats. Observera dock att endast alternativet Variabel visas om arbetsflödesmodellen är markerad för extern datalagring, och inte nyttolastalternativet.

  • Datafil: Den innehåller data som har skickats till det adaptiva formuläret. Du kan använda alternativet Data File Path för att ange filens namn och sökväg i förhållande till nyttolasten. Sökvägen /addresschange/data.xml skapar till exempel en mapp med namnet addresschange och placerar den i förhållande till nyttolasten. Du kan också ange att bara data.xml ska skicka skickade data utan att skapa en mapphierarki. Använd variabelalternativet och välj variabeln i listan med variabler som är tillgängliga för arbetsflödesmodellen.
NOTE
Variabler kan användas oavsett om arbetsflödesmodellen är markerad för extern datalagring eller inte.
  • Bifogade filer: Du kan använda alternativet Attachment Path för att ange mappnamnet för att lagra de bifogade filer som överförts till det anpassade formuläret. Mappen skapas i förhållande till nyttolasten. Om arbetsflödet är markerat för extern datalagring använder du variabelalternativet och väljer variabeln i listan med variabler som är tillgängliga för arbetsflödesmodellen.

  • Postdokument: Det innehåller det postdokument som genererats för det adaptiva formuläret. Du kan använda alternativet Document of Record Path för att ange namnet på filen Dokument för post och sökvägen till filen i förhållande till nyttolasten. Sökvägen /addresschange/DoR.pdf skapar till exempel en mapp med namnet addresschange relativt till nyttolasten och placerar DoR.pdf relativt nyttolasten. Du kan även ange att bara DoR.pdf ska spara postdokument utan att skapa en mapphierarki. Om arbetsflödet är markerat för extern datalagring använder du variabelalternativet och väljer variabeln i listan med variabler som är tillgängliga för arbetsflödesmodellen.

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:

  • Använd adaptiva Forms-data i en Power Automate-affärsprocess
  • Använd Power Automate för att skicka inhämtade data till fler än 500 datakällor eller till något offentligt tillgängligt API
  • Utför komplexa beräkningar på inhämtade data
  • Spara adaptiva Forms-data i lagringssystemen enligt ett fördefinierat schema

Den adaptiva Forms-redigeraren tillhandahåller Anropa ett Microsoft® Power Automate-flöde för att skicka adaptiva formulärdata, bilagor och arkivdokument till Power Automate Cloud Flow. Anslut din AEM Forms-instans med Microsoft® Power Automate om du vill använda åtgärden Skicka för att skicka hämtade data 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 Microsoft® SharePoint List submit-to-sharedrive

NOTE
Listfunktionen Skicka till Microsoft® SharePoint introducerades i AEM 6.5 Forms Service Pack 19 (6.5.19.0).

Åtgärden Submit to SharePoint kopplar ett adaptivt formulär till ett Microsoft® SharePoint-lagringsutrymme. Du kan skicka formulärdatafilen, bifogade filer eller arkivdokument till den anslutna Microsoft® Sharepoint-lagringsplatsen.

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

Så här ansluter du ett adaptivt formulär till Microsoft® SharePoint List:

  1. Skapa en SharePoint-listkonfiguration: Den ansluter AEM Forms till din Microsoft® Sharepoint-listlagring.
  2. Använd åtgärden Skicka med formulärdatamodell i ett adaptivt formulär: Dina anpassade formulärdata skickas till konfigurerade Microsoft® SharePoint.

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

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

  1. Gå till Tools > Cloud Services > Microsoft® SharePoint.

  2. Välj en konfigurationsbehållare. Konfigurationen lagras i den valda konfigurationsbehållaren.

  3. Klicka på Create > SharePoint List i listrutan. Konfigurationsguiden för SharePoint visas.

  4. Ange Title, Client ID, Client Secret och OAuth URL. Mer information om hur du hämtar klient-ID, klienthemlighet, klient-ID för OAuth URL finns i Microsoft®-dokumentation.

    • Du kan hämta Client ID och Client Secret för din app från Microsoft® Azure-portalen.

    • Lägg till omdirigerings-URI som https://[author-instance]/libs/cq/sharepointlist/content/configurations/wizard.html i Microsoft® Azure-portalen. Ersätt [author-instance] med URL:en för din Author-instans.

    • Lägg till API-behörigheterna offline_access och Sites.Manage.All på fliken Microsoft® Graph för att ge läs-/skrivbehörigheter. Lägg till behörigheten AllSites.Manage på fliken Sharepoint om du vill fjärrinteragera med SharePoint-data.

    • Använd OAuth-URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Ersätt <tenant-id> med tenant-id för din app från Microsoft® Azure-portalen.

      note note
      NOTE
      Fältet klienthemlighet är obligatoriskt eller valfritt beroende på din Azure Active Directory-programkonfiguration. Om ditt program är konfigurerat att använda en klienthemlighet är det obligatoriskt att ange klienthemligheten.
  5. Klicka på Connect. Om anslutningen lyckas visas meddelandet Connection Successful.

  6. Välj SharePoint Site och SharePoint List i listrutan.

  7. Tryck på Create för att skapa molnkonfigurationen för Microsoft® SharePointList.

Använda Skicka med formulärdatamodellen 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.

NOTE
I Microsoft® SharePoint List stöds inte följande kolumntyper:
  • bildkolumn
  • metadatakolumn
  • personkolumn
  • extern datakolumn
NOTE
Generera OSGi-konfigurationer med AEM SDK och distribuera konfigurationen till din Cloud Service om du vill ange värden för en konfiguration.

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 också för adaptiva formulär. 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 författare av adaptiva formulär har tillhandahållit när de 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 körklara fältvalideringar av adaptiva formulär som körs på servern är:

  • Obligatoriskt
  • Valideringsbildsats
  • Valideringsuttryck

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

Använd Uppdatera på servern 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

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. Slutanvändaren får originalformuläret igen. Insamlade data och skickade data visas för användaren som ett fel.

NOTE
Validering på serversidan validerar formulärmodellen. Vi rekommenderar att du skapar ett separat klientbibliotek för validering och inte blandar det med andra saker som formatering av HTML och DOM-manipulering i samma klientbibliotek.

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

Ibland finns det komplexa valideringsregler, men det exakta valideringsskriptet finns 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 Grundläggande i egenskaper för adaptiv formulärbehållare enligt nedan.

Stöd för anpassade funktioner i valideringsuttryck

Stöd för anpassade funktioner i valideringsuttryck

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

Felhantering vid sändning error-handling-on-submit-action

Konfigurera anpassade felsidor som 404.jsp och 500.jsp som en del av riktlinjerna för säkerhet och skärpa i Experience Manager. Dessa hanterare anropas när ett formulär 404- eller 500-fel skickas. Hanterarna anropas också när dessa felkoder aktiveras på Publish-noden.

Mer information finns i Anpassa sidor som visas av felhanteraren.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2