Azione di invio modulo adattivo configuring-the-submit-action

Applicabile a: ✔️ Componenti Di Base Per Moduli Adattivi. ❌ Componenti core modulo adattivo. L’Adobe consiglia di utilizzare i Componenti core per aggiungere un Forms adattivo a una pagina AEM Sites o a creare un Forms adattivo indipendente.

Un’azione di invio viene attivata quando un utente fa clic su Invia in un modulo adattivo. Forms as a Cloud Service fornisce le seguenti azioni di invio pronte all’uso.

È inoltre possibile estendere le azioni di invio predefinite per creare un’azione di invio personalizzata.

Puoi configurare un’azione di invio in Invio nella barra laterale, nella sezione delle proprietà Contenitore modulo adattivo.

Invia all’endpoint REST submit-to-rest-endpoint

Utilizza il Invia all’endpoint REST azione per pubblicare i dati inviati su un URL rest. L’URL può essere interno (il server sul quale viene eseguito il rendering del modulo) o esterno.

Per pubblicare i dati su un server interno, specifica il percorso della risorsa. I dati vengono inseriti nel percorso della risorsa. Ad esempio, /content/restEndPoint. Per tali richieste successive, vengono utilizzate le informazioni di autenticazione della richiesta di invio.

Per pubblicare dati su un server esterno, fornisci un URL. Il formato dell’URL è https://host:port/path_to_rest_end_point. Assicurati di configurare il percorso per gestire la richiesta POST in modo anonimo.

Nell’esempio precedente, l’utente ha inserito le informazioni in textbox viene acquisito tramite il parametro param1. Sintassi per pubblicare i dati acquisiti tramite param1 è:

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

Analogamente, i parametri utilizzati per la registrazione di dati e allegati XML sono dataXml e attachments.

Ad esempio, questi due parametri vengono utilizzati nello script per analizzare i dati in un punto finale rest. Utilizza la sintassi seguente per archiviare e analizzare i dati:

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

In questo esempio, data memorizza i dati XML e att memorizza i dati dell'allegato.

Il Invia all’endpoint REST Azione di invio invia i dati compilati nel modulo a una pagina di conferma configurata come parte della richiesta HTTP GET. Puoi aggiungere il nome dei campi da richiedere. Il formato della richiesta è:

{fieldName}={request parameter name}

Come mostrato nell'immagine seguente, param1 e param2 vengono passati come parametri con valori copiati da casella di testo e numericbox campi per l’azione successiva.

È inoltre possibile Abilita richiesta POST e fornisci un URL per pubblicare la richiesta. Per inviare i dati al server AEM che ospita il modulo, utilizzare un percorso relativo corrispondente al percorso radice del server AEM. Ad esempio: /content/forms/af/SampleForm.html. Per inviare dati a qualsiasi altro server, utilizzare il percorso assoluto.

Invia e-mail send-email

È possibile utilizzare Invia e-mail Azione di invio per inviare un’e-mail a uno o più destinatari in seguito all’invio corretto del modulo. L’e-mail generata può contenere dati del modulo in un formato predefinito. Ad esempio, nel modello seguente, il nome del cliente, l’indirizzo di spedizione, il nome dello stato e il codice postale vengono recuperati dai dati del modulo inviati.

"

Ciao ${customer_Name},

Di seguito è riportato l'indirizzo di spedizione predefinito:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Cordiali saluti
WKND

"

Puoi anche includere nell’e-mail allegati e un documento di record (DoR). Per abilitare Allega documento record , configura il modulo adattivo per generare un documento di record (DoR). Puoi abilitare l’opzione per generare un documento di record dalle proprietà del modulo adattivo.

Invia usando il modello dati modulo submit-using-form-data-model

Il Invia utilizzando il modello dati modulo L’azione di invio scrive i dati del modulo adattivo inviati per l’oggetto modello dati specificato in un modello dati modulo nella relativa origine dati. Durante la configurazione dell’azione di invio, puoi scegliere un oggetto modello dati di cui desideri riscrivere i dati inviati nella relativa origine dati.

È inoltre possibile inviare un allegato del modulo all'origine dati utilizzando un modello dati modulo e un documento di record (DoR). Per informazioni sul modello dati del modulo, consulta AEM Forms Integrazione dei dati.

Richiama un flusso di lavoro AEM invoke-an-aem-workflow

Il Richiama un flusso di lavoro AEM Azione di invio associa un modulo adattivo a un Flusso di lavoro AEM. Quando un modulo viene inviato, il flusso di lavoro associato viene avviato automaticamente nell’istanza Autore. Puoi salvare il file di dati, gli allegati e il documento di record nella posizione di payload del flusso di lavoro o in una variabile. Se il flusso di lavoro è contrassegnato per l’archiviazione dati esterna e configurato per un’archiviazione dati esterna, è disponibile solo l’opzione della variabile. Puoi effettuare una selezione dall’elenco di variabili disponibili per il modello di flusso di lavoro. Se il flusso di lavoro è contrassegnato per l’archiviazione di dati esterni in una fase successiva e non al momento della creazione del flusso di lavoro, assicurati che siano presenti le configurazioni di variabili richieste.

L’azione di invio inserisce quanto segue nella posizione di payload del flusso di lavoro, o nella variabile se il flusso di lavoro è contrassegnato per l’archiviazione di dati esterni:

Prima di utilizzare Richiama un flusso di lavoro AEM Azione di invio configura quanto segue per Servizio impostazioni Servizi di dominio AEM configurazione:

Invia a SharePoint submit-to-sharedrive

Il Invia a SharePoint L’azione di invio collega un modulo adattivo a un archivio Microsoft® SharePoint. È possibile inviare il file di dati del modulo, gli allegati o il documento di record all'archivio di Microsoft® Sharepoint connesso.

Utilizzando Invia a SharePoint, puoi:

Collegare un modulo adattivo alla raccolta documenti di SharePoint connect-af-sharepoint-doc-library

Per utilizzare Invia a raccolta documenti di SharePoint Azione di invio in un modulo adattivo:

Creare una configurazione di SharePoint Document Library create-sharepoint-configuration

Per connettere AEM Forms all'archiviazione della raccolta documenti di Microsoft® Sharepoint:

Ora puoi utilizzare questa configurazione di SharePoint Sites per l’azione di invio in un modulo adattivo.

Utilizzare la configurazione della raccolta documenti di SharePoint in un modulo adattivo use-sharepoint-configuartion-in-af

È possibile utilizzare la configurazione della raccolta documenti di SharePoint creata in un modulo adattivo per salvare dati o documenti di record generati in una cartella di SharePoint. Per utilizzare una configurazione di archiviazione SharePoint Document Library in un modulo adattivo, effettua le seguenti operazioni:

Quando si invia il modulo, i dati vengono salvati nell'archivio della raccolta documenti di Microsoft® Sharepoint specificato.
La struttura di cartelle per il salvataggio dei dati è /folder_name/form_name/year/month/date/submission_id/data.

Collegare un modulo adattivo all’elenco di Microsoft® SharePoint connect-af-sharepoint-list

Per utilizzare Invia a elenco SharePoint Azione di invio in un modulo adattivo:

Creare una configurazione dell’elenco SharePoint create-sharepoint-list-configuration

Per collegare AEM Forms all’elenco di Microsoft® Sharepoint:

Utilizzare l’invio utilizzando il modello dati del modulo in un modulo adattivo use-submit-using-fdm

È possibile utilizzare la configurazione dell’elenco SharePoint creata in un modulo adattivo per salvare dati o documenti di record generati in un elenco SharePoint. Per utilizzare una configurazione di archiviazione Elenco SharePoint in un modulo adattivo, effettua le seguenti operazioni:

Quando si invia il modulo, i dati vengono salvati nell'archivio elenco di Microsoft® Sharepoint specificato.

Invia a OneDrive submit-to-onedrive

Il Invia a OneDrive L'azione di invio collega un modulo adattivo a Microsoft® OneDrive. È possibile inviare i dati del modulo, i file, gli allegati o il documento di record all'archivio Microsoft® OneDrive collegato. Per utilizzare Invia a OneDrive Azione di invio in un modulo adattivo:

Crea una configurazione OneDrive create-onedrice-configuration

Per collegare AEM Forms allo storage Microsoft® OneDrive:

Ora puoi utilizzare questa configurazione di archiviazione OneDrive per l'azione di invio in un modulo adattivo.

Usa configurazione OneDrive in un modulo adattivo use-onedrive-configuartion-in-af

È possibile utilizzare la configurazione di archiviazione di OneDrive creata in un modulo adattivo per salvare dati o documenti di record generati in una cartella di OneDrive. Per utilizzare la configurazione di archiviazione OneDrive in un modulo adattivo, effettua le seguenti operazioni:

Quando si invia il modulo, i dati vengono salvati nell'archivio Microsoft® OneDrive specificato.
La struttura di cartelle per il salvataggio dei dati è /folder_name/form_name/year/month/date/submission_id/data.

Invia ad Azure Blob Storage submit-to-azure-blob-storage

Il Invia ad Azure Blob Storage L’azione di invio collega un modulo adattivo a un portale Microsoft® Azure. È possibile inviare i dati del modulo, il file, gli allegati o il documento record ai contenitori di archiviazione di Azure connessi. Per utilizzare l’azione Invia per l’archiviazione BLOB di Azure:

Creare un contenitore di archiviazione BLOB di Azure create-azure-configuration

Per connettere AEM Forms ai contenitori di archiviazione Azure:

Ora puoi utilizzare questa configurazione del contenitore di archiviazione Azure per l’azione di invio in un modulo adattivo.

Utilizzare la configurazione di archiviazione Azure in un modulo adattivo use-azure-storage-configuartion-in-af

Puoi utilizzare la configurazione del contenitore di archiviazione Azure creata in un modulo adattivo per salvare dati o documenti di record generati nel contenitore di archiviazione Azure. Per utilizzare la configurazione del contenitore di archiviazione Azure in un modulo adattivo, effettua le seguenti operazioni:

Quando si invia il modulo, i dati vengono salvati nella configurazione del contenitore di archiviazione Azure specificata.
La struttura di cartelle per il salvataggio dei dati è /configuration_container/form_name/year/month/date/submission_id/data.

Per impostare i valori di una configurazione: Generare configurazioni OSGi utilizzando l’SDK per AEM, e distribuire la configurazione all’istanza di Cloud Service.

Invia a Power Automate microsoft-power-automate

È possibile configurare un modulo adattivo per eseguire un flusso cloud di Microsoft® Power Automate all’invio. Il modulo adattivo configurato invia i dati acquisiti, gli allegati e il documento di record al flusso cloud Power Automate per l’elaborazione. Consente di creare un’esperienza di acquisizione dati personalizzata sfruttando al contempo la potenza di Microsoft® Power Automate per creare logiche di business basate sui dati acquisiti e automatizzare i flussi di lavoro dei clienti. Di seguito sono riportati alcuni esempi di cosa è possibile fare dopo l’integrazione di un modulo adattivo con Microsoft® Power Automate:

L’editor di Forms adattivo fornisce Richiama un flusso Microsoft® Power Automate l’azione di invio per inviare i dati dei moduli adattivi, gli allegati e il documento di record viene inviata a Power Automate Cloud Flow. Per utilizzare l'azione Invia per inviare i dati acquisiti a Microsoft® Power Automate, Collegare l'istanza Forms as a Cloud Service con Microsoft® Power Automate

Dopo una configurazione corretta, utilizza Richiama un flusso Microsoft® Power Automate azione di invio per inviare dati a un flusso Power Automate.

Invia a Workfront Fusion workfront-fusion

È possibile configurare un modulo adattivo per inviare dati a Workfront Fusion al momento dell’invio. Workfront Fusion consente l'automazione dei processi in modo che l'utente possa concentrarsi su nuove attività anziché ripetere più volte le stesse attività. Automatizza attività semplici e complesse, risparmiando tempo e garantendo un'esecuzione coerente dei processi.

L’editor di Forms adattivo fornisce Richiama uno scenario Workfront Fusion azione di invio per inviare dati o allegati di Adaptive Forms a uno scenario Workfront Fusion. Per utilizzare l’azione di invio per inviare i dati acquisiti a uno scenario Workfront Fusion, consulta Inviare un modulo adattivo ad Adobe Workfront Fusion.

Utilizzare l’invio sincrono o asincrono use-synchronous-or-asynchronous-submission

Un’azione di invio può utilizzare l’invio sincrono o asincrono.

Invio sincrono: in genere, i moduli web sono configurati per l’invio sincrono. In un invio sincrono, quando gli utenti inviano un modulo, vengono reindirizzati a una pagina di conferma, a una pagina di ringraziamento oppure, se l’invio non riesce, a una pagina di errore. È possibile selezionare Utilizzare l’invio asincrono per reindirizzare gli utenti a una pagina web o mostrare un messaggio all’invio.

Invio asincrono: le moderne esperienze web, come le applicazioni a pagina singola, stanno guadagnando popolarità: la pagina web rimane statica, mentre l’interazione client-server avviene in background. Ora puoi fornire questa esperienza con Adaptive Forms tramite configurazione dell’invio asincrono.

Riconvalida lato server in modulo adattivo server-side-revalidation-in-adaptive-form

In genere, in qualsiasi sistema di acquisizione dati online, gli sviluppatori inseriscono alcune convalide JavaScript sul lato client per applicare alcune regole di business. Tuttavia, nei browser moderni, gli utenti finali possono ignorare tali convalide ed effettuare manualmente gli invii utilizzando varie tecniche, ad esempio la Console per la creazione di strumenti di browser Web. Tali tecniche sono valide anche per Adaptive Forms. Uno sviluppatore di moduli può creare diverse logiche di convalida, ma tecnicamente gli utenti finali possono ignorarle e inviare dati non validi al server. I dati non validi violano le regole business applicate da un autore di moduli.

La funzione di riconvalida lato server consente inoltre di eseguire le convalide fornite da un autore di Forms adattivo durante la progettazione di un modulo adattivo sul server. Impedisce qualsiasi possibile compromissione dell’invio dei dati e delle violazioni delle regole aziendali rappresentate in termini di convalide dei moduli.

Cosa convalidare su Server? what-to-validate-on-server-br

Tutte le convalide di campo pronte all’uso di un modulo adattivo che vengono rieseguite sul server sono:

Abilitazione della convalida lato server enabling-server-side-validation-br

Utilizza il Riconvalida sul server in Contenitore modulo adattivo nella barra laterale per abilitare o disabilitare la convalida lato server per il modulo corrente.

Abilitazione della convalida lato server

Se l'utente finale ignora tali convalide e invia i moduli, il server esegue nuovamente la convalida. Se la convalida non riesce alla fine del server, la transazione di invio viene interrotta. All’utente viene nuovamente presentato il modulo originale. I dati acquisiti e inviati vengono presentati all’utente come un errore.

Supporto di funzioni personalizzate nelle espressioni di convalida supporting-custom-functions-in-validation-expressions-br

A volte, se ci sono regole di convalida complesse, lo script di convalida esatto risiede nelle funzioni personalizzate e l’autore chiama tali funzioni personalizzate dall’espressione di convalida del campo. Per rendere nota e disponibile questa libreria di funzioni personalizzata durante l’esecuzione delle convalide lato server, l’autore del modulo può configurare il nome della libreria client AEM in Base delle proprietà del Contenitore modulo adattivo, come illustrato di seguito.

Supporto di funzioni personalizzate nelle espressioni di convalida

L’autore può configurare una libreria JavaScript personalizzata per modulo adattivo. Si consiglia di mantenere solo le funzioni riutilizzabili nella libreria, che dipendono dalle librerie di terze parti jquery e underscore.js.

Gestione degli errori nell’azione di invio error-handling-on-submit-action

Come parte delle linee guida sulla sicurezza e l’irrigidimento dell’AEM, configura pagine di errore personalizzate come 400.jsp, 404.jsp e 500.jsp. Questi gestori vengono chiamati quando all’invio di un modulo vengono visualizzati errori 400, 404 o 500. Gli handler vengono chiamati anche quando questi codici di errore vengono attivati sul nodo Publish. Puoi anche creare pagine JSP per altri codici di errore HTTP.

Quando si precompila un modello di dati modulo o un modulo adattivo basato su schema con un reclamo di dati XML o JSON per uno schema che non contiene dati <afData>, <afBoundData>, e </afUnboundData> , i dati dei campi non limitati del modulo adattivo andranno persi. Lo schema può essere uno schema XML, uno schema JSON o un modello dati modulo. I campi non limitati sono campi modulo adattivo senza bindref proprietà.