Azione di invio modulo adattivo

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.

• Invia all’endpoint REST
• Invia e-mail
• Invia usando il modello dati modulo
• Richiama un flusso di lavoro AEM
• Invia a SharePoint
• Invia a OneDrive
• Invia ad Azure Blob Storage
• Invia a Power Automate

È 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

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. Esempio: /content/forms/af/SampleForm.html. Per inviare dati a qualsiasi altro server, utilizzare il percorso assoluto.

Invia e-mail

È 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

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

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:

• File di dati: contiene i dati inviati al modulo adattivo. È possibile utilizzare Percorso file di dati per specificare il nome del file e il percorso del file relativo al payload. Ad esempio, il /addresschange/data.xml percorso crea una cartella denominata addresschange e lo posiziona in relazione al payload. È inoltre possibile specificare solo data.xml per inviare solo i dati inviati senza creare una gerarchia di cartelle. Se il flusso di lavoro è contrassegnato per l’archiviazione di dati esterni, utilizza l’opzione della variabile e seleziona la variabile dall’elenco di variabili disponibili per il modello di flusso di lavoro.

• Allegati: puoi utilizzare la Percorso allegato per specificare il nome della cartella in cui archiviare gli allegati caricati nel modulo adattivo. La cartella viene creata in relazione al payload. Se il flusso di lavoro è contrassegnato per l’archiviazione di dati esterni, utilizza l’opzione della variabile e seleziona la variabile dall’elenco di variabili disponibili per il modello di flusso di lavoro.

• Documento record: contiene il documento di record generato per il modulo adattivo. È possibile utilizzare Percorso del documento record per specificare il nome del file del documento di record e il percorso del file relativo al payload. Ad esempio, il /addresschange/DoR.pdf percorso crea una cartella denominata addresschange relativo al payload e posiziona il DoR.pdf relativo al payload. È inoltre possibile specificare solo DoR.pdf per salvare solo un documento di record senza creare una gerarchia di cartelle. Se il flusso di lavoro è contrassegnato per l’archiviazione di dati esterni, utilizza l’opzione della variabile e seleziona la variabile dall’elenco di variabili disponibili per il modello di flusso di lavoro.

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

• Elaborazione URL server: il server di elaborazione è il server in cui viene attivato il flusso di lavoro Forms o AEM. Può essere uguale all’URL dell’istanza di authoring AEM o di un altro server.

• Nome utente server di elaborazione: nome utente dell’utente del flusso di lavoro

• Password server di elaborazione: password dell'utente del flusso di lavoro

Invia a SharePoint

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. Per utilizzare Invia a SharePoint Azione di invio in un modulo adattivo:

1. Creare una configurazione SharePoint: collega AEM Forms all’archiviazione Microsoft® Sharepoint.
2. Utilizzare l’azione Invia a SharePoint in un modulo adattivo: collega il modulo adattivo a Microsoft® SharePoint configurato.

Creare una configurazione SharePoint

Per collegare AEM Forms al tuo Microsoft® Sharepoint Storage:

1. Vai al tuo Autore AEM Forms istanza > Strumenti > Cloud Service > Microsoft® SharePoint.

2. Dopo aver selezionato Microsoft® SharePoint, viene reindirizzato a Browser SharePoint.

3. Seleziona un Contenitore configurazione. La configurazione viene archiviata nel Contenitore configurazione selezionato.

4. Fai clic su Crea. Viene visualizzata la procedura guidata di configurazione di SharePoint.
   

5. Specifica la Titolo, ID client, Segreto client e URL OAuth. Per informazioni su come recuperare l’ID client, il segreto client e l’ID tenant per l’URL OAuth, consulta Documentazione di Microsoft®.

   • È possibile recuperare Client ID e Client Secret dell’app dal portale Microsoft® Azure.
   • Nel portale Microsoft® Azure, aggiungi l’URI di reindirizzamento come https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Sostituisci [author-instance] con l’URL dell’istanza di authoring.
   • Aggiungere le autorizzazioni API offline_access e Sites.Manage.All per fornire autorizzazioni di lettura/scrittura.
   • Usa URL OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Sostituisci <tenant-id> con tenant-id dell’app dal portale Microsoft® Azure.
   NOTA

   Il segreto client Il campo è obbligatorio o facoltativo dipende dalla configurazione dell'applicazione Azure Active Directory. Se l’applicazione è configurata per l’utilizzo di un segreto client, è obbligatorio fornire il segreto client.

6. Clic Connetti. In caso di connessione riuscita, il Connection Successful viene visualizzato il messaggio.

7. Ora, seleziona Sito SharePoint > Raccolta documenti > Cartella SharePoint, per salvare i dati.

   NOTA

   • Per impostazione predefinita, forms-ootb-storage-adaptive-forms-submission è presente nel sito SharePoint selezionato.
   • Creare una cartella come forms-ootb-storage-adaptive-forms-submission, se non già presente nel Documents libreria del sito SharePoint selezionato facendo clic su Crea cartella.

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

Utilizzare la configurazione SharePoint in un modulo adattivo

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

1. Creare un Modulo adattivo.

   NOTA

   • Seleziona lo stesso Contenitore configurazione per un modulo adattivo, in cui è stato creato lo storage SharePoint.
   • In caso negativo Contenitore configurazione è selezionato, quindi il Configurazione archiviazione Le cartelle vengono visualizzate nella finestra delle proprietà dell'azione di invio.

2. Seleziona Azione di invio as Invia a SharePoint.
   

3. Seleziona la Configurazione archiviazione, dove desideri salvare i dati.

4. Clic Salva per salvare le impostazioni di invio.

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

Invia a 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:

1. Crea una configurazione OneDrive: collega AEM Forms allo storage Microsoft® OneDrive.
2. Utilizzare l'azione Invia a OneDrive in un modulo adattivo: collega il modulo adattivo a Microsoft® OneDrive configurato.

Crea una configurazione OneDrive

Per collegare AEM Forms allo storage Microsoft® OneDrive:

1. Vai al tuo Autore AEM Forms istanza > Strumenti > Cloud Service > Microsoft® OneDrive.

2. Dopo aver selezionato Microsoft® OneDrive, viene reindirizzato a Browser OneDrive.

3. Seleziona un Contenitore configurazione. La configurazione viene archiviata nel Contenitore configurazione selezionato.

4. Fai clic su Crea. Verrà visualizzata la configurazione guidata di OneDrive.

   

5. Specifica la Titolo, ID client, Segreto client e URL OAuth. Per informazioni su come recuperare l’ID client, il segreto client e l’ID tenant per l’URL OAuth, consulta Documentazione di Microsoft®.

   • È possibile recuperare Client ID e Client Secret dell’app dal portale Microsoft® Azure.
   • Nel portale Microsoft® Azure, aggiungi l’URI di reindirizzamento come https://[author-instance]/libs/cq/onedrive/content/configurations/wizard.html. Sostituisci [author-instance] con l’URL dell’istanza di authoring.
   • Aggiungere le autorizzazioni API offline_access e Files.ReadWrite.All per fornire autorizzazioni di lettura/scrittura.
   • Usa URL OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Sostituisci <tenant-id> con tenant-id dell’app dal portale Microsoft® Azure.
   NOTA

   Il segreto client Il campo è obbligatorio o facoltativo dipende dalla configurazione dell'applicazione Azure Active Directory. Se l’applicazione è configurata per l’utilizzo di un segreto client, è obbligatorio fornire il segreto client.

6. Clic Connetti. In caso di connessione riuscita, il Connection Successful viene visualizzato il messaggio.

7. Ora, seleziona Contenitore OneDrive > [Cartella OneDrive] per salvare i dati.

   NOTA

   • Per impostazione predefinita, forms-ootb-storage-adaptive-forms-submission è presente nel contenitore OneDrive.
   • Creare una cartella come forms-ootb-storage-adaptive-forms-submission, se non già presente facendo clic su Crea cartella.

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

Usa configurazione OneDrive in un modulo adattivo

È 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:

1. Creare un Modulo adattivo.

   NOTA

   • Seleziona lo stesso Contenitore configurazione per un modulo adattivo, in cui è stato creato lo storage OneDrive.
   • In caso negativo Contenitore configurazione è selezionato, quindi il Configurazione archiviazione Le cartelle vengono visualizzate nella finestra delle proprietà dell'azione di invio.

2. Seleziona Azione di invio as Invia a OneDrive.
   

3. Seleziona la Configurazione archiviazione, dove desideri salvare i dati.

4. Clic Salva per salvare le impostazioni di invio.

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

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:

1. Creare un contenitore di archiviazione BLOB di Azure: connette AEM Forms ai contenitori di archiviazione Azure.
2. Utilizzare la configurazione di archiviazione Azure in un modulo adattivo: collega il modulo adattivo ai contenitori di archiviazione Azure configurati.

Creare un contenitore di archiviazione BLOB di Azure

Per connettere AEM Forms ai contenitori di archiviazione Azure:

1. Vai al tuo Autore AEM Forms istanza > Strumenti > Cloud Service > Archiviazione Azure.

2. Dopo aver selezionato Archiviazione Azure, viene reindirizzato a Browser archiviazione Azure.

3. Seleziona un Contenitore configurazione. La configurazione viene archiviata nel Contenitore configurazione selezionato.

4. Fai clic su Crea. Viene visualizzata la procedura guidata Crea configurazione di archiviazione Azure.

   

5. Specifica la Titolo, Account di archiviazione Azure e Chiave di accesso Azure.

   • Puoi recuperare Azure Storage Account nome e Azure Access key dagli account di archiviazione nel portale Microsoft® Azure.

6. Fai clic su Salva.

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

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:

1. Creare un Modulo adattivo.

   NOTA

   • Seleziona lo stesso Contenitore configurazione per un modulo adattivo, in cui è stato creato lo storage OneDrive.
   • In caso negativo Contenitore configurazione è selezionato, quindi il Configurazione archiviazione Le cartelle vengono visualizzate nella finestra delle proprietà dell'azione di invio.

2. Seleziona Azione di invio as Invia ad Azure Blob Storage.
   

3. Seleziona la Configurazione archiviazione, dove desideri salvare i dati.

4. Clic Salva per salvare le impostazioni di invio.

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

È 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 sulla base dei 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:

• Utilizzare dati Forms adattivi in processi aziendali Power Automate
• Utilizza Power Automate per inviare i dati acquisiti a più di 500 origini dati o a qualsiasi API disponibile pubblicamente
• Eseguire calcoli complessi sui dati acquisiti
• Salvataggio dei dati Adaptive Forms sui sistemi di storage secondo una pianificazione predefinita

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.

Utilizzare l’invio sincrono o asincrono

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

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?

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

• Obbligatorio
• Clausola di convalida immagine
• Espressione di convalida

Abilitazione della convalida lato server

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

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. Nella libreria, mantieni solo le funzioni riutilizzabili, che hanno dipendenza da librerie di terze parti jquery e underscore.js.

Gestione degli errori nell’azione di invio

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à.

Risorse Business.Adobe.com