Handeling Adaptief verzenden van formulier
is op van toepassing: ✔️ de Aangepaste Componenten van de Stichting van de Vorm. ❌ Aangepaste Componenten van de Kern van de Vorm. Adobe adviseert het gebruiken van de Componenten van de Kern om Aangepaste Forms aan een Pagina van AEM Sitestoe te voegen of standalone Aangepaste Formstot stand te brengen.
Een handeling Verzenden wordt geactiveerd wanneer een gebruiker op de knop Submit klikt op een adaptief formulier. Forms as a Cloud Service geeft de volgende verzendhandelingen weer.
U kunt ook uitbreiden het gebrek verzendt Actiesom uw eigen te creëren verzendt Actie.
U kunt een handeling Verzenden configureren in de sectie Submission van de eigenschappen van de container van adaptieve formulieren, in de zijbalk.
Verzenden naar REST-eindpunt
Gebruik de handeling Submit to REST Endpoint om de verzonden gegevens naar een rest-URL te verzenden. 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 opmaak van de URL is https://host:port/path_to_rest_end_point . Zorg ervoor dat u de weg vormt om het POST- verzoek 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.
Met de handeling Submit to REST endpoint Verzenden worden de gegevens die in het formulier zijn ingevuld, verzonden naar een geconfigureerde bevestigingspagina als onderdeel van de HTTP GET-aanvraag. 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 numericbox gebieden voor de volgende actie.
U kunt ook Enable POST request opgeven en een URL opgeven om de aanvraag te verzenden. 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.
OPMERKINGE-mail verzenden
Met de handeling Send Email Verzenden kunt u een e-mail verzenden naar een of meer ontvangers wanneer het formulier met succes is verzonden. Het gegenereerde e-mailbericht kan formuliergegevens in een vooraf gedefinieerde indeling bevatten. In de volgende sjabloon worden bijvoorbeeld de naam van de klant, het verzendadres, de naam van de staat en de postcode opgehaald uit de ingediende formuliergegevens.
"
Hi $ {customer_Name},
het volgende wordt geplaatst als uw standaard verschepend adres:
$ {customer_Name},
$ {customer_Shipping_Address},
$ {customer_State},
$ {customer_ZIPCode}
Regards,
WKND
"
- Alle formuliervelden moeten verschillende elementnamen hebben, zelfs als de velden op verschillende deelvensters van een adaptief formulier zijn geplaatst.
- AEM as a Cloud Service vereist dat uitgaande post wordt gecodeerd. Standaard is uitgaande e-mail uitgeschakeld. Om het te activeren, leg een steunkaartje voor aan het Aanvragen van Toegang.
U kunt ook bijlagen en een Document of Record (DoR) aan de e-mail toevoegen. Als u de optie Attach Document of Record wilt inschakelen, configureert u het adaptieve formulier om een Document of Record (DoR) te genereren. U kunt de optie inschakelen om een document met records te genereren op basis van de eigenschappen van een adaptief formulier.
Verzenden met gebruik van FDM (Form Data Model)
Met de handeling Submit using Form Data Model Verzenden worden verzonden gegevens van het adaptieve formulier voor het opgegeven gegevensmodelobject in een formuliergegevensmodel (FDM) naar de gegevensbron. Wanneer u de handeling Verzenden configureert, kunt u een gegevensmodelobject kiezen waarvan de verzonden gegevens u naar de gegevensbron wilt schrijven.
Daarnaast kunt u een formulierbijlage verzenden met een formuliergegevensmodel (FDM) en een Document of Record (DoR) naar de gegevensbron. Voor informatie over het model van vormgegevens (FDM), zie AEM Forms Integratie van Gegevens.
Een AEM-workflow aanroepen
Invoke an AEM Workflow legt Actie associeert een Aangepaste Vorm met een Werkschema van AEMvoor. Wanneer een formulier wordt verzonden, wordt de bijbehorende workflow automatisch gestart bij de instantie Auteur. U kunt het gegevensbestand, de gehechtheid, en Document van Verslag aan de ladingsplaats van het werkschema of aan een variabele opslaan. Als de workflow is gemarkeerd voor externe gegevensopslag en geconfigureerd voor externe gegevensopslag, is alleen de optie Variabele beschikbaar. 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.
Met de handeling Verzenden wordt het volgende geplaatst op de laadlocatie van de werkstroom, of de variabele als de werkstroom is gemarkeerd voor externe gegevensopslag:
-
dossier van Gegevens: Het bevat gegevens die aan de Aangepaste Vorm worden voorgelegd. Met de optie Data File Path kunt u de naam van het bestand en het pad van het bestand ten opzichte van de laadbewerking opgeven. Het pad
/addresschange/data.xmlmaakt bijvoorbeeld een map met de naamaddresschangeen plaatst deze relatief ten opzichte van de laadbewerking. U kunt ook alleendata.xmlopgeven om alleen verzonden gegevens te verzenden zonder een maphiërarchie te maken. Als de workflow is gemarkeerd voor externe gegevensopslag, gebruikt u de optie Variabele en selecteert u de variabele in de lijst met variabelen die beschikbaar zijn voor het workflowmodel. -
Gehechtheid: U kunt de Attachment Path optie gebruiken om de omslagnaam te specificeren om de gehechtheid op te slaan die aan de Aangepaste Vorm wordt geupload. De map wordt gemaakt ten opzichte van de lading. Als de workflow is gemarkeerd voor externe gegevensopslag, gebruikt u de optie Variabele en selecteert u de variabele in de lijst met variabelen die beschikbaar zijn voor het workflowmodel.
-
Document van Verslag: Het bevat het Document van Verslag dat voor de Adaptieve Vorm wordt geproduceerd. U kunt de optie Document of Record Path gebruiken om de naam van het document van het dossier van het Verslag en weg van dossier met betrekking tot de lading te specificeren. Het pad
/addresschange/DoR.pdfmaakt bijvoorbeeld een map met de naamaddresschangeten opzichte van de laadbewerking en plaatst de mapDoR.pdften opzichte van de laadbewerking. U kunt ook alleenDoR.pdfopgeven om alleen Document of Record op te slaan zonder een maphiërarchie te maken. Als de workflow is gemarkeerd voor externe gegevensopslag, gebruikt u de optie Variabele en selecteert u de variabele in de lijst met variabelen die beschikbaar zijn voor het workflowmodel.
Voordat u Invoke an AEM Workflow Handeling verzenden gebruikt, configureert u het volgende voor de AEM DS settings service -configuratie:
-
Processing Server URL: De Verwerkingsserver is de server waarop de Forms- of AEM-workflow wordt geactiveerd. Dit kan gelijk zijn aan de URL van de AEM-auteurinstantie of een andere server.
-
Processing Server User Name: Gebruikersnaam van workflowgebruiker
-
Processing Server Password: Wachtwoord van workflowgebruiker
Verzenden naar SharePoint
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.
Met Verzenden naar SharePoint kunt u:
Een adaptief formulier aansluiten op de SharePoint-documentbibliotheek
U kunt als volgt de Submit to SharePoint Document Library Handeling verzenden in een adaptieve vorm gebruiken:
- creeer een Configuratie van de Bibliotheek van het Document van SharePoint: Het verbindt AEM Forms met uw Opslag van SharePoint Microsoft®.
- gebruik Submit aan SharePoint verzendt actie in een AanpassingsVorm: Het verbindt uw AanpassingsVorm met gevormde SharePoint Microsoft®.
Een SharePoint-documentbibliotheekconfiguratie maken
AEM Forms verbinden met uw Microsoft® Sharepoint Document Library Storage:
-
Ga naar uw 1} instantie van de Auteur van AEM Forms > Tools > Cloud Services > Microsoft® SharePoint .
-
Nadat u de Microsoft® SharePoint hebt geselecteerd, wordt u omgeleid naar SharePoint Browser .
-
Selecteer de Container van de a Configuratie. De configuratie wordt opgeslagen in de geselecteerde Container van de Configuratie.
-
Klik op Create > SharePoint Document Library in de vervolgkeuzelijst. De configuratietovenaar van SharePoint verschijnt.
-
Geef de waarden Title , Client ID , Client Secret en OAuth URL op. Voor informatie over hoe te om identiteitskaart van de Cliënt terug te winnen, Geheime cliënt, identiteitskaart van de Aannemer voor OAuth URL, zie Documentatie Microsoft®.
- U kunt de
Client IDenClient Secretvan uw app ophalen via de Microsoft® Azure-portal. - Voeg in de Microsoft® Azure-portal de Redirect URI toe als
https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Vervang[author-instance]door de URL van de instantie Auteur. - Voeg de API-machtigingen
offline_accessenSites.Manage.Alltoe voor lees- en schrijfmachtigingen. - Gebruik OAuth URL:
https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Vervang<tenant-id>doortenant-idvan uw app via de Microsoft® Azure-portal.
OPMERKINGHet cliënt geheime gebied is verplicht of facultatief hangt van uw Azure Actieve de toepassingsconfiguratie van de Folder af. Als uw toepassing wordt gevormd om een cliëntgeheim te gebruiken, is het verplicht om het cliëntgeheim te verstrekken. - U kunt de
-
Klik op Connect. Bij een geslaagde verbinding wordt het bericht
Connection Successfulweergegeven. -
Nu, uitgezochte > de Bibliotheek van het Document van SharePoint > de Omslag van SharePoint , om de gegevens te bewaren.
OPMERKING- Standaard is
forms-ootb-storage-adaptive-forms-submissionaanwezig op geselecteerde SharePoint-site. - Creeer een omslag als
forms-ootb-storage-adaptive-forms-submission, als niet reeds aanwezig in deDocumentsbibliotheek van de geselecteerde Plaats van SharePoint door te klikken creeer Omslag.
- Standaard is
U kunt deze configuratie voor SharePoint-sites nu gebruiken voor de verzendactie in een adaptief formulier.
SharePoint Document Library Configuration gebruiken in een adaptief formulier
U kunt de gemaakte SharePoint Document Library-configuratie in een adaptief formulier gebruiken om gegevens of gegenereerd Document of Record in een SharePoint-map op te slaan. Voer de volgende stappen uit om een opslagconfiguratie voor SharePoint Document Library in een adaptief formulier te gebruiken als:
-
Creeer een Aangepaste Vorm.
OPMERKING- Selecteer hetzelfde Configuration Container voor een adaptief formulier, waar u de opslagruimte van de SharePoint-documentbibliotheek hebt gemaakt.
- Als er geen Configuration Container is geselecteerd, worden de algemene Storage Configuration -mappen weergegeven in het eigenschappenvenster Handeling verzenden.
-
Selecteer voorleggen Actie als Submit to SharePoint.
-
Selecteer Storage Configuration waar u de gegevens wilt opslaan.
-
Klik op Save om de verzendinstellingen op te slaan.
Wanneer u het formulier verzendt, worden de gegevens opgeslagen in de opgegeven Microsoft® Sharepoint Document Library Storage.
De mapstructuur voor het opslaan van gegevens is /folder_name/form_name/year/month/date/submission_id/data .
OPMERKING/folder_name/form_name/year/month/date/submission_id/data . Nochtans, als u sparen Bijlagen met Oorspronkelijke Naam selecteert, worden de gehechtheid opgeslagen in de omslag gebruikend hun originele filenames.
