Een aangepaste verzendactie maken voor Adaptieve Forms writing-custom-submit-action-for-adaptive-forms

Een adaptief formulier biedt meerdere OTB-acties (Verzenden buiten de box). In een handeling Verzenden worden de details opgegeven van de handelingen die moeten worden uitgevoerd op de gegevens die via het adaptieve formulier zijn verzameld. Bijvoorbeeld, verzendend gegevens over een e-mail.

U kunt een douane creëren legt Actie voor om functionaliteit toe te voegen niet inbegrepen in uit-van-de-doos Actiesof niet gesteund via één enkele OTB legt Actie voor. Bijvoorbeeld het verzenden van gegevens naar een werkstroom, het opslaan van de gegevens in een gegevensopslag, het verzenden van e-mailbericht naar de persoon die het formulier verzendt, en het verzenden van een e-mail naar de persoon die verantwoordelijk is voor de verwerking van het ingediende formulier voor goedkeuringen en afwijzingen via één verzendhandeling.

XML-gegevensindeling xml-data-format

De XML-gegevens worden naar de servlet verzonden met behulp van de aanvraagparameter jcr:data . Verzendhandelingen hebben toegang tot de parameter om de gegevens te verwerken. In de volgende code wordt de indeling van de XML-gegevens beschreven. De velden die aan het formuliermodel zijn gebonden, worden weergegeven in de sectie afBoundData . De niet verbindende gebieden verschijnen in de afUnoundData sectie.

<?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>

Actievelden action-fields

Een Submit Actie kan verborgen inputgebieden (gebruikend de HTML inputmarkering) aan teruggegeven vorm HTML toevoegen. Deze verborgen velden kunnen waarden bevatten die nodig zijn tijdens de verwerking van formulierverzendingen. Bij het verzenden van het formulier worden deze veldwaarden teruggeplaatst als aanvraagparameters die de verzendactie kan gebruiken tijdens de verwerking van het formulier. De invoervelden worden actievelden genoemd.

Met een handeling Verzenden die ook de tijd vastlegt die nodig is om een formulier in te vullen, kunt u bijvoorbeeld de verborgen invoervelden startTime en endTime toevoegen.

Een script kan de waarden van de velden startTime en endTime opgeven wanneer het formulier wordt gerenderd en vóór het verzenden van het formulier. Met het script Handeling verzenden post.jsp hebt u vervolgens toegang tot deze velden met behulp van aanvraagparameters en kunt u de totale tijd berekenen die nodig is om het formulier in te vullen.

Bestandsbijlagen file-attachments

Verzendhandelingen kunnen ook de bestandsbijlagen gebruiken die u uploadt met de component Bestandsbijlage. Verzend de manuscripten van de Actie kunnen tot deze dossiers toegang hebben gebruikend de van de schuine streep RequestParameter API. De isFormFieldmethode van de API hulp identificeert zich of de verzoekparameter een dossier of een vormgebied is. U kunt de parameters van het Verzoek in een Submit Actie herhalen om de parameters van de Bijlage van het Dossier te identificeren.

De volgende voorbeeldcode identificeert de bestandsbijlagen in de aanvraag. Daarna, leest het de gegevens in het dossier gebruikend krijg API. Ten slotte wordt een object Document gemaakt met behulp van de gegevens en toegevoegd aan een lijst.

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()));
    }
}

Als u bestanden bijvoegt bij het adaptieve formulier, valideert de server de bestandsbijlagen na het verzenden van het adaptieve formulier en wordt een foutbericht geretourneerd als:

Pad doorsturen en URL omleiden forward-path-and-redirect-url

Nadat de vereiste actie is uitgevoerd, stuurt de Submit servlet de aanvraag door naar het voorwaartse pad. Een handeling gebruikt de setForwardPath API om het voorwaartse pad in te stellen in de Guide Submit servlet.

Als de handeling geen voorwaarts pad biedt, leidt de verzendserver de browser om met de Redirect URL. De auteur configureert de omleidings-URL met behulp van de configuratie Bedankt voor de pagina in het dialoogvenster Formulier bewerken. U kunt de Redirect URL ook configureren via de Submit Action of de setRedirectUrl API in de Guide Submit servlet. U kunt de parameters van het Verzoek die naar Redirect URL worden verzonden ook vormen gebruikend setRedirectParameters API in de Gids Submit servlet.

Handeling verzenden submit-action

Een handeling Verzenden is een sling:map die het volgende bevat:

Een aangepaste verzendhandeling maken creating-a-custom-submit-action

Voer de volgende stappen uit om een aangepaste handeling Verzenden te maken die de gegevens opslaat in de CRX-opslagplaats en u vervolgens een e-mail stuurt. Het adaptieve formulier bevat de afgekeurde OOTB-code voor het verzenden van Action Store-inhoud die de gegevens opslaat in de CRX-opslagplaats. Bovendien verstrekt AEM a PostAPI die kan worden gebruikt om e-mail te verzenden. Voordat u de e-mail-API gebruikt, configureert u de Day CQ Mail-service via de systeemconsole. U kunt de actie Store Content (afgekeurd) opnieuw gebruiken om de gegevens in de opslagplaats op te slaan. De actie Store Content (afgekeurd) is beschikbaar op de locatie /libs/fd/af/components/guidesubmittype/store in de CRX-opslagplaats.

Use submitService property for custom Submit Actions submitservice-property

Wanneer u de douane plaatst legt Actie voor, die het submitService bezit omvat, brengt de vorm FormSubmitActionServiceop voorlegging in werking. In FormSubmitActionService wordt de methode getServiceName gebruikt om de waarde voor de eigenschap submitService op te halen. Gebaseerd op de waarde van het submitService bezit, roept de dienst aangewezen voorlegt methode aan. Neem de FormSubmitActionService op in de aangepaste bundel die u uploadt naar de AEM Forms -server.

Voeg de eigenschap submitService van het type tekenreeks toe aan de sling:Folder van de aangepaste handeling Verzenden om Adobe Sign in te schakelen voor het adaptieve formulier. U kunt de optie Enable Adobe Sign alleen selecteren in het gedeelte Electronic Signature van de containereigenschappen van het adaptieve formulier nadat u de waarde hebt ingesteld voor de eigenschap submitService van de aangepaste verzendactie.