De handeling Verzenden configureren configuring-the-submit-action

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Inleiding om acties te verzenden introduction-to-submit-actions

Een verzendactie wordt geactiveerd wanneer een gebruiker op de knop Verzenden klikt op een adaptief formulier. U kunt de verzendactie configureren op het aangepaste formulier. Adaptieve formulieren bevatten een paar elementen uit het vak Acties verzenden. U kunt de standaardverzendacties kopiëren en uitbreiden om uw eigen verzendactie te maken. Op basis van uw vereisten kunt u echter uw eigen verzendactie schrijven en registreren om gegevens in het verzonden formulier te verwerken.

Wanneer een formulier vooraf wordt ingevuld of verzonden, worden de verzonden gegevens naar AEM gerouteerd voor gegevensmassaging naar tussenliggende indelingen. Gegevens worden niet opgeslagen op een AEM-exemplaar, behalve wanneer het adaptieve formulier gebruikmaakt van Acrobat Sign, verify, Forms Portal Concept of submit, of AEM Workflows

U kunt een verzendactie configureren in het dialoogvenster Submission in de zijbalk van de eigenschappen van de container voor adaptieve formulieren.

Verzendhandeling configureren
Afbeelding: Verzendhandeling configureren

De standaardverzendacties die beschikbaar zijn in aangepaste formulieren zijn:

  • Verzenden naar REST-eindpunt
  • E-mail verzenden
  • PDF verzenden via e-mail
  • Een Forms Workflow aanroepen
  • Verzenden met gebruik van formuliergegevensmodel
  • Forms Portal-verzendactie
  • Een AEM-workflow aanroepen
NOTE
PDF verzenden via e-mail verzenden is alleen van toepassing op adaptieve formulieren die XFA-sjabloon gebruiken als formuliermodel.
NOTE
Zorg ervoor dat de [AEM_Installation_Directory]\crx-quickstart\temp\datamanager\ASM folder exists. De map is vereist om bijlagen tijdelijk op te slaan. Als de map niet bestaat, maakt u deze.
CAUTION
Als u prefill een formuliersjabloon, formuliergegevensmodel of op schema gebaseerd adaptief formulier met XML- of JSON-gegevensklacht voor een schema (XML-schema, JSON-schema, formuliersjabloon of formuliergegevensmodel) dat geen gegevens bevat <afdata>, <afbounddata>, en </afunbounddata> -tags, dan worden de gegevens van niet-omsloten velden (Niet-omlijnde velden zijn adaptieve formuliervelden zonder bindref eigenschap) van het adaptieve formulier verloren gaat.

U kunt een aangepaste verzendactie schrijven voor aangepaste formulieren om aan uw gebruiksscenario te voldoen. Zie voor meer informatie Aangepaste verzendactie schrijven voor adaptieve formulieren.

Verzenden naar REST-eindpunt submit-to-rest-endpoint

De Submit to REST endpoint Met deze optie worden de gegevens die in het formulier zijn ingevuld, doorgegeven aan een geconfigureerde bevestigingspagina als onderdeel van de HTTP-aanvraag. U kunt de naam toevoegen van de velden die u wilt aanvragen. De indeling van het verzoek is:

{fieldName}={request parameter name}

Zoals in de onderstaande afbeelding wordt getoond: param1 en param2 worden doorgegeven als parameters met waarden die zijn gekopieerd uit de textbox en numericbox velden voor de volgende actie.

U kunt ook Enable POST request en geef een URL op om de aanvraag te posten. Als u gegevens wilt verzenden naar de AEM server waarop het formulier zich bevindt, gebruikt u een relatief pad dat overeenkomt met het hoofdpad van de AEM server. Bijvoorbeeld /content/forms/af/SampleForm.html. Gebruik absoluut pad om gegevens naar een andere server te verzenden.

Rest Endpoint-verzendhandeling configureren

Rest Endpoint-verzendhandeling configureren

NOTE
Als u de velden als parameters in een REST-URL wilt doorgeven, moeten alle velden verschillende elementnamen hebben, zelfs als de velden op verschillende deelvensters zijn geplaatst.

Gegevens naar een bron of een extern eindpunt voor de rusttijd verzenden  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

Gebruik de Submit to REST Endpoint actie om de verzonden gegevens op een rest-URL te plaatsen. De URL kan van een interne (de server waarop het formulier wordt gegenereerd) of van een externe server zijn.

Om gegevens aan een interne server te posten, verstrek weg van het middel. De gegevens worden gepost de weg van het middel. Bijvoorbeeld /content/restEndPoint. Voor dergelijke postverzoeken wordt de authenticatieinformatie van het verzendverzoek gebruikt.

Geef een URL op om gegevens naar een externe server te posten. De indeling van de URL is https:// host:port/path_to_rest_end_point. Zorg ervoor dat u de weg vormt om het verzoek van de POST anoniem te behandelen.

Toewijzing voor veldwaarden die zijn doorgegeven als parameters voor de pagina Bedankt

In het bovenstaande voorbeeld heeft de gebruiker informatie ingevoerd in textbox wordt vastgelegd met parameter param1. Syntaxis om gegevens te posten die zijn vastgelegd met param1 is:

String data=request.getParameter("param1");

Op dezelfde manier zijn parameters die u gebruikt voor het posten van XML-gegevens en -bijlagen dataXml en attachments.

U gebruikt deze twee parameters in uw script bijvoorbeeld om gegevens te parseren op een eindpunt in de rest. U gebruikt de volgende syntaxis om de gegevens op te slaan en te ontleden:

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

In dit voorbeeld: data de XML-gegevens worden opgeslagen, en att slaat gehechtheidsgegevens op.

E-mail verzenden send-email

De Send Email Met een handeling verzenden wordt een e-mail naar een of meer ontvangers verzonden wanneer het formulier met succes is verzonden. Het gegenereerde e-mailbericht kan formuliergegevens in een vooraf gedefinieerde indeling bevatten.

NOTE
Alle formuliervelden moeten verschillende elementnamen hebben, zelfs als ze op verschillende deelvensters zijn geplaatst), om formuliergegevens op te nemen in een e-mailbericht.

PDF verzenden via e-mail send-pdf-via-email

De Send PDF via Email Met een verzendactie wordt een e-mail met een PDF met formuliergegevens verzonden naar een of meer ontvangers wanneer het formulier met succes is verzonden.

Opmerking: Deze verzendactie is beschikbaar voor op XFA gebaseerde adaptieve formulieren en op XSD gebaseerde aanpassingsformulieren die de sjabloon Document of Record hebben.

Een formulierwerkstroom aanroepen invoke-a-forms-workflow

De Submit to Forms workflow Met de optie Verzenden worden een gegevens-xml en bestandsbijlagen (indien aanwezig) naar een bestaande Adobe LiveCycle of AEM Forms verzonden bij JEE-proces.

Voor informatie over hoe u de handeling Verzenden naar formulierwerkstroom kunt configureren, raadpleegt u Uw formuliergegevens verzenden en verwerken met behulp van formulierworkflows.

Verzenden met gebruik van formuliergegevensmodel submit-using-form-data-model

De Submit using Form Data Model Met deze handeling worden verzonden verzonden verzonden aangepaste formuliergegevens voor het opgegeven gegevensmodelobject in een formuliergegevensmodel naar de gegevensbron ervan. Wanneer het vormen van voorlegt actie, kunt u een voorwerp van het gegevensmodel kiezen waarvan voorgelegde gegevens u terug naar zijn gegevensbron wilt schrijven.

Daarnaast kunt u een formulierbijlage verzenden met behulp van een formuliergegevensmodel en een Document of Record (DoR) naar de gegevensbron.

Voor informatie over het formuliergegevensmodel raadpleegt u AEM Forms-gegevensintegratie.

Forms Portal-verzendactie forms-portal-submit-action

De Forms Portal Submit Action maakt formuliergegevens beschikbaar via een AEM Forms-portal.

Ga voor meer informatie over de Forms Portal en verzend actie naar Concepten en verzendingen.

Een AEM-workflow aanroepen invoke-an-aem-workflow

De Invoke an AEM Workflow Bij verzenden wordt een adaptief formulier gekoppeld aan een AEM Workflow. Wanneer een formulier wordt verzonden, wordt de bijbehorende workflow automatisch gestart op het verwerkingsknooppunt. Bovendien worden het gegevensbestand, de bijlagen, en het document van Verslag, indien van toepassing, bij de ladingsplaats van het werkschema geplaatst.

Voordat u de Invoke an AEM Workflow actie indienen; De AEM DS-instellingen configureren. Voor informatie over het creëren van een AEM- Werkstroom, zie Formuliergerichte workflows op OSGi.

Revalidatie op de server in adaptieve vorm server-side-revalidation-in-adaptive-form

In een systeem voor het vastleggen van online gegevens plaatsen ontwikkelaars gewoonlijk bepaalde JavaScript-validaties op de client om een aantal bedrijfsregels af te dwingen. Maar in moderne browsers, moeten de eindgebruikers die bevestigingen omzeilen en manueel bijdragen gebruikend diverse technieken, zoals Browser van het Web DevTools Console indienen. Dergelijke technieken gelden ook voor adaptieve formulieren. Een formulierontwikkelaar kan verschillende validatielogboeken maken, maar technisch kunnen eindgebruikers die validatielogboeken omzeilen en ongeldige gegevens naar de server verzenden. Ongeldige gegevens zouden de bedrijfsregels overtreden die een auteur van formulieren heeft afgedwongen.

Met de functie voor opnieuw valideren aan de serverzijde kunt u ook de validaties uitvoeren die door de auteur van een adaptief formulier zijn verstrekt tijdens het ontwerpen van een adaptief formulier op de server. Hierdoor wordt voorkomen dat bij het verzenden van gegevens en bij het valideren van formulieren inbreuk wordt gemaakt op de bedrijfsregels.

Wat moet u op de server valideren? what-to-validate-on-server-br

Alle OOTB-veldvalidaties (out-of-box) van een adaptief formulier die opnieuw op de server worden uitgevoerd, zijn:

  • Vereist
  • Clausule voor validatie
  • Validatie-expressie

Validatie op de server inschakelen enabling-server-side-validation-br

Gebruik de Revalidate op server onder Adaptieve formuliercontainer in de zijbalk om validatie aan de serverzijde voor het huidige formulier in of uit te schakelen.

Validatie op de server inschakelen
Afbeelding: Validatie op de server inschakelen

Als de eindgebruiker deze validaties overslaat en de formulieren verzendt, wordt de validatie opnieuw uitgevoerd door de server. Als de validatie op het servereinde mislukt, wordt de verzendtransactie gestopt. De eindgebruiker krijgt het oorspronkelijke formulier opnieuw te zien. De vastgelegde gegevens en verzonden gegevens worden als een fout aan de gebruiker gepresenteerd.

Aangepaste functies ondersteunen in validatie-expressies supporting-custom-functions-in-validation-expressions-br

In geval van complexe validatieregels Het exacte validatiescript bevindt zich in aangepaste functies en de auteur roept deze aangepaste functies aan vanuit de expressie voor veldvalidatie. Als u deze aangepaste functiebibliotheek bekend en beschikbaar wilt maken tijdens het uitvoeren van validaties aan de serverzijde, kan de auteur van het formulier de naam van AEM clientbibliotheek configureren onder de Basic tabblad Adaptieve formuliercontainereigenschappen, zoals hieronder weergegeven.

Aangepaste functies ondersteunen in validatie-expressies
Afbeelding: Aangepaste functies ondersteunen in validatie-expressies

Auteurs kunnen aangepaste javascript-bibliotheek configureren per adaptief formulier. Houd in de bibliotheek alleen de herbruikbare functies die afhankelijk zijn van bibliotheken van derden jquery en underscore.js.

Foutafhandeling bij verzendactie error-handling-on-submit-action

Als deel van AEM veiligheid en het verharden richtlijnen, vorm de pagina's van de douanefout zoals 404.jsp en 500.jsp. Deze handlers worden aangeroepen wanneer een formulier 404- of 500-fouten worden verzonden. De handlers worden ook geroepen wanneer deze foutencodes op de Publish knoop worden teweeggebracht.

Zie voor meer informatie Pagina's aanpassen die worden weergegeven door de fouthandler.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da