De handeling Verzenden configureren configuring-the-submit-action

de Adobe adviseert gebruikend de moderne en verlengbare gegevens vangen Componenten van de Kernvoor het creëren van nieuwe Aangepaste Formsof het toevoegen van Aangepaste Forms aan de pagina's van AEM Sites. Deze componenten betekenen een aanzienlijke vooruitgang in de aanmaak van Adaptive Forms en zorgen voor indrukwekkende gebruikerservaring. In dit artikel wordt een oudere aanpak beschreven voor de auteur Adaptive Forms die gebruikmaakt van stichtingscomponenten.

Inleiding om acties in te dienen 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 voor een adaptief 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. Verzenden actie kan synchrone of asynchrone voorlegginggebruiken.

U kunt een verzendactie in de sectie van de Verzending van de Adaptieve eigenschappen van de Container van de Vorm vormen, in sidebar.

Verzendhandeling configureren

De standaardverzendacties die beschikbaar zijn in aangepaste formulieren zijn:

U kunt een aangepaste verzendactie schrijven voor aangepaste formulieren om aan uw gebruiksscenario te voldoen. Voor meer informatie, zie het Schrijven van douane verzendt actie voor adaptieve vormen.

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

legt aan REST eindpunt voor voorlegt optie gaat de gegevens die in de vorm aan een gevormde bevestigingspagina als deel van het verzoek van de GET van HTTP worden gevuld over. U kunt de naam toevoegen van de velden die u wilt aanvragen. De indeling van het verzoek is:

{fieldName}={request parameter name}

Zoals aangetoond in het beeld hieronder, param1 en param2 worden overgegaan als parameters met waarden die van worden gekopieerd textbox en numerieke doos gebieden voor de volgende actie.

U kunt verzoek van de POST ook toelaten en URL verstrekken om het verzoek te posten. Als u gegevens wilt verzenden naar de server van de Experience Manager die als host fungeert voor het formulier, gebruikt u een relatief pad dat overeenkomt met het hoofdpad van de server van de Experience Manager. Bijvoorbeeld /content/forms/af/SampleForm.html. Gebruik absoluut pad om gegevens naar een andere server te verzenden.

voor

Rest Endpoint-verzendhandeling configureren

Post heeft gegevens naar een bron of een extern eindpunt voor de rusttijd verzonden  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

Gebruik voorleggen aan REST Endpoint actie om de voorgelegde gegevens aan een rest URL te posten. 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.

In het bovenstaande voorbeeld wordt door de gebruiker ingevoerde informatie in textbox vastgelegd met parameter param1 . De syntaxis voor het posten van gegevens die zijn vastgelegd met param1 is:

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

Op dezelfde manier zijn de 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 slaat data de XML-gegevens op en slaat att de gegevens in de bijlage op.

E-mail verzenden send-email

verzendt E-mail verzendt actie verzendt een e-mail naar één of meerdere ontvangers op succesvolle voorlegging van de vorm. Het gegenereerde e-mailbericht kan formuliergegevens in een vooraf gedefinieerde indeling bevatten.

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

verzendt PDF via E-mail verzendt actie een e-mail met een PDF die vormgegevens bevat, naar één of meerdere ontvangers op succesvolle voorlegging van de vorm.

Een Forms Workflow aanroepen invoke-a-forms-workflow

voorlegt aan Forms Workflow voorlegt optie verzendt een gegevens xml en dossiergehechtheid (als om het even welk) naar een bestaand LiveCycle van de Adobe of AEM Forms op JEE proces.

Voor informatie over hoe te om Submit aan Forms Workflow te vormen verzend actie, zie Verzenden en verwerkend uw vormgegevens gebruikend vormwerkschema's.

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

voorleggen gebruikend het Model van de Gegevens van de Vorm voorlegt actie schrijft voorgelegde adaptieve vormgegevens voor het gespecificeerde voorwerp van het gegevensmodel in een model van vormgegevens aan zijn gegevensbron. 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 model van vormgegevens, zie de Integratie van Gegevens van AEM Forms.

Forms Portal-verzendactie forms-portal-submit-action

De Portaal van Forms legt Actie optie voor maakt vormgegevens beschikbaar door een Portaal van AEM Forms.

Voor meer informatie over het Portaal van Forms en voorlegt actie, zie Concepten en voorleggingscomponent.

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

Invoke an AEM Workflow legt Actie associeert een Aangepaste Vorm met een AEM Werkschemavoor. Wanneer een formulier wordt verzonden, wordt de bijbehorende workflow automatisch gestart bij de instantie Auteur. U kunt het gegevensbestand, de gehechtheid, en het Document van Verslag aan de omslag met betrekking tot of onder de lading van het werkschema of aan een variabele opslaan. Als de workflow is gemarkeerd voor externe gegevensopslag, is de optie Variabele beschikbaar en niet de optie voor laden. U kunt uit de lijst van variabelen selecteren beschikbaar voor het werkschemamodel. Als de workflow later wordt gemarkeerd voor externe gegevensopslag en niet op het moment dat de workflow wordt gemaakt, moet u ervoor zorgen dat de vereiste variabele configuraties aanwezig zijn.

Alvorens te gebruiken aanvoed een AEM van het Werkschema voorlegt actie, vormt de Experience Manager DS montages. Voor informatie over het creëren van een AEMWerkschema, zie vorm-centric werkschema's op OSGi.

Met de handeling Verzenden wordt het volgende op de laadlocatie van de workflow geplaatst. Houd er echter rekening mee dat alleen de optie Variabele wordt weergegeven als het workflowmodel is gemarkeerd voor externe gegevensopslag, en niet de optie voor laden.

Verzenden naar Power Automate microsoft-power-automate

U kunt een adaptief formulier configureren om een Microsoft® Power Automate Cloud Flow uit te voeren bij verzending. Met het geconfigureerde adaptieve formulier worden vastgelegde gegevens, bijlagen en het document met records naar Power Automate Cloud Flow verzonden voor verwerking. Het helpt u om een aangepaste ervaring op het gebied van gegevensvastlegging op te bouwen en tegelijk de kracht van Microsoft® Power Automate te benutten om bedrijfslogics rond vastgelegde gegevens te bouwen en de workflows van klanten te automatiseren. Hier volgen enkele voorbeelden van wat u kunt doen na de integratie van een adaptief formulier met Microsoft® Power Automate:

De adaptieve redacteur van Forms verstrekt roept een stroom van de Macht Microsoft® verzendt actie om adaptieve vormengegevens, gehechtheid, en Document van Verslag te verzenden aan Macht de Stroom van de Wolk van de Automatisering. Om de Submit actie te gebruiken om gevangen gegevens naar Microsoft® Power Automate te verzenden, verbind uw instantie van AEM Forms met Microsoft® Macht

Na een succesvolle configuratie, gebruik aanhaalt een Macht Microsoft® stroomverzendt actie om gegevens naar een Macht te verzenden automatisch Stroom.

Verzenden naar Microsoft® SharePoint List submit-to-sharedrive

Met de handeling Submit to SharePoint Verzenden wordt een adaptief formulier verbonden met een Microsoft® SharePoint-opslag. U kunt het bestand met formuliergegevens, bijlagen of het document met records verzenden naar de aangesloten Microsoft® SharePoint-opslag.

Een adaptief formulier verbinden met de Microsoft® SharePoint-lijst connect-af-sharepoint-list

Een adaptief formulier verbinden met de Microsoft® SharePoint-lijst:

Een SharePoint List-configuratie maken create-sharepoint-list-configuration

AEM Forms verbinden met uw Microsoft® SharePoint-lijst:

Verzenden met gebruik van het formuliergegevensmodel in een adaptief formulier gebruiken use-submit-using-fdm

U kunt de gemaakte SharePoint List-configuratie in een adaptief formulier gebruiken om gegevens of het gegenereerde Document of Record in een SharePoint-lijst op te slaan. Voer de volgende stappen uit om een SharePoint List-opslagconfiguratie in een adaptief formulier te gebruiken als:

Wanneer u het formulier verzendt, worden de gegevens opgeslagen in de opgegeven Microsoft® Sharepoint List Storage.

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

In elk onlinesysteem voor gegevensvastlegging plaatsen ontwikkelaars doorgaans 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 zijn ook geldig 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 buiten-de-box veldvalidaties van een adaptief formulier die opnieuw worden uitgevoerd op de server zijn:

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

Gebruik Revalidate op server onder de Aangepaste Container van de Vorm in sidebar om server-zijbevestiging voor de huidige vorm toe te laten of onbruikbaar te maken.

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 aan het einde van de server 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

Als er soms complexe validatieregels zijn, bevindt het exacte validatiescript zich in aangepaste functies en roept de auteur deze aangepaste functies aan vanuit de expressie voor veldvalidatie. Om deze bibliotheek van de douanefunctie te maken gekend en beschikbaar terwijl het uitvoeren van server-zijbevestigingen, kan de vormauteur de naam van AEM cliëntbibliotheek onder het Basis lusje van de Eigenschappen van de Container van de Vorm de Adaptieve zoals hieronder getoond vormen.

Aangepaste functies ondersteunen in validatie-expressies

Auteurs kunnen de aangepaste JavaScript-bibliotheek per adaptief formulier configureren. 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 de veiligheid van de Experience Manager en het verharden richtlijnen, vorm de pagina's van de douanefout zoals 404.jsp en 500.jsp. Deze handlers worden aangeroepen wanneer bij het verzenden van een formulier 404 of 500 fouten worden weergegeven. De handlers worden ook geroepen wanneer deze foutencodes op de knoop van Publish worden teweeggebracht.

Voor meer informatie, zie Aanpassen Pagina's die door de Handler van de Foutworden getoond.