Skapa en anpassad inskickningsåtgärd för Adaptiv Forms writing-custom-submit-action-for-adaptive-forms

Ett anpassat formulär innehåller flera färdiga inskickningsåtgärder (OTB). En Skicka-åtgärd specificerar vilka åtgärder som ska utföras på data som samlats in via det adaptiva formuläret. Du kan till exempel skicka data via ett e-postmeddelande.

Du kan skapa en anpassad Skicka-åtgärd för att lägga till funktioner som inte ingår i färdiga Skicka-åtgärder eller som inte stöds via en OTB-överföringsåtgärd. Du kan till exempel skicka data till ett arbetsflöde, spara data i ett datalager, skicka e-postmeddelanden till den person som skickar formuläret och skicka ett e-postmeddelande till den person som ansvarar för att bearbeta det inskickade formuläret för godkännande och avslag genom en enda Skicka-åtgärd.

XML-dataformat xml-data-format

XML-data skickas till servern med hjälp av parametern jcr:data request. Skicka åtgärder kan komma åt parametern för att bearbeta data. I följande kod beskrivs formatet för XML-data. De fält som är bundna till formulärmodellen visas i avsnittet afBoundData. Obundna fält visas i avsnittet afUnoundData.

<?xml ?>
<afData>
<afUnboundData>
<data>
<field1>value</field2>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
</data>
</afUnboundData>
<afBoundData>
<!-- xml corresponding to the Form Model /XML Schema -->
</afBoundData>
</afData>

Åtgärdsfält action-fields

En Skicka-åtgärd kan lägga till dolda indatafält (med taggen input i HTML) i det återgivna formuläret HTML. Dessa dolda fält kan innehålla värden som behövs när formulärinlämningen behandlas. När du skickar formuläret bokförs dessa fältvärden som begärandeparametrar som åtgärden Skicka kan använda när formuläret skickas. Indatafälten kallas åtgärdsfält.

En Skicka-åtgärd som även fångar upp den tid det tar att fylla i ett formulär kan lägga till de dolda indatafälten startTime och endTime.

Ett skript kan tillhandahålla värdena för fälten startTime och endTime när formuläret återges och före formuläröverföringen. Skriptet post.jsp för Skicka åtgärd kan sedan komma åt dessa fält med hjälp av parametrarna för begäran och beräkna den totala tid som krävs för att fylla i formuläret.

Bifogade filer file-attachments

Skicka funktionsmakron kan även använda de bifogade filer som du överför med komponenten Bifogad fil. Skicka Action-skript kan komma åt dessa filer med slingan RequestParameter API. Metoden isFormField i API:t hjälper till att identifiera om parametern request är en fil eller ett formulärfält. Du kan iterera över parametrarna för begäran i en Skicka-åtgärd för att identifiera parametrar för bifogade filer.

Följande exempelkod identifierar de bifogade filerna i begäran. Därefter läses data in i filen med Get API. Slutligen skapas ett Document-objekt med hjälp av data och läggs till i en lista.

RequestParameterMap requestParameterMap = slingRequest.getRequestParameterMap();
for (Map.Entry<String, RequestParameter[]> param : requestParameterMap.entrySet()) {
    RequestParameter rpm = param.getValue()[0];
    if(!rpm.isFormField()) {
        fileAttachments.add(new Document(rpm.get()));
    }
}

När du bifogar filer till det adaptiva formuläret validerar servern de bifogade filerna efter att det adaptiva formuläret skickats in och returnerar ett felmeddelande om:

Framåtsökväg och omdirigerings-URL forward-path-and-redirect-url

När du har utfört den nödvändiga åtgärden vidarebefordrar servern Skicka begäran till sökvägen framåt. En åtgärd använder API:t setForwardPath för att ställa in framåtsökvägen på tjänsten Skicka stödlinje.

Om åtgärden inte har någon framåtriktad sökväg dirigeras webbläsaren om med hjälp av omdirigerings-URL:en. Författaren konfigurerar omdirigerings-URL:en med hjälp av Tack-sidan i dialogrutan Redigera anpassat formulär. Du kan också konfigurera omdirigerings-URL:en via Submit Action (Skicka-åtgärd) eller setRedirectUrl API i Submit (Skicka guide). Du kan också konfigurera de Request-parametrar som skickas till Redirect URL med API:t setRedirectParameters i guiden Submit.

Skicka åtgärd submit-action

En Skicka-åtgärd är en sling:Mapp som innehåller följande:

Skapa en anpassad skickaåtgärd creating-a-custom-submit-action

Utför följande steg för att skapa en anpassad Skicka-åtgärd som sparar data i CRX-databasen och sedan skickar ett e-postmeddelande till dig. Det adaptiva formuläret innehåller OTB-innehållet för att skicka Action Store-innehåll (borttaget) som sparar data i CRX-databasen. Dessutom innehåller AEM ett Mail-API som kan användas för att skicka e-postmeddelanden. Konfigurera tjänsten Day CQ Mail via systemkonsolen innan du använder e-post-API:t. Du kan återanvända åtgärden Lagra innehåll (föråldrat) för att lagra data i databasen. Åtgärden Lagra innehåll (föråldrat) finns på platsen /libs/fd/af/components/guideSubittype/store i CRX-databasen.

Använd egenskapen submitService för anpassade överföringsåtgärder submitservice-property

När du anger den anpassade åtgärden Skicka, som innehåller egenskapen submitService, utlöser formuläret FormSubmitActionService när det skickas. FormSubmitActionService använder metoden getServiceName för att hämta värdet för egenskapen submitService. Baserat på värdet för egenskapen submitService anropar tjänsten lämplig sändningsmetod. Inkludera FormSubmitActionService i det anpassade paketet som du överför till servern AEM Forms.

Lägg till egenskapen submitService av typen sträng i sling:Folder för din anpassade skickaåtgärd för att aktivera Adobe Sign för det anpassade formuläret. Du kan bara välja alternativet Enable Adobe Sign i avsnittet Electronic Signature i behållaregenskaperna för det adaptiva formuläret efter att du har angett värdet för egenskapen submitService för den anpassade åtgärden Skicka.