Azione di invio per modulo adattivo

Ultimo aggiornamento: 5 maggio 2025
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Utente
  • Sviluppatore
VersioneCollegamento articolo
AEM 6.5Fai clic qui
AEM as a Cloud Service (Componenti core)Fai clic qui
AEM as a Cloud Service (Componenti di base)Questo articolo

Si applica a: ✔️ componenti di base modulo adattivo. ❌ Componenti core modulo adattivo. Adobe consiglia di utilizzare i Componenti core per aggiungere Forms adattivo a una pagina di AEM Sites o per creare un Forms adattivo autonomo.

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

Puoi anche estendere le azioni di invio predefinite per creare un'azione di invio personalizzata.

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

Configura azione di invio

Invia a endpoint REST

Utilizzare l'azione Invia all'endpoint REST per inviare i dati inviati a 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 POST, 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.

Mappatura dei valori dei campi passati come parametri della pagina di ringraziamento

Nell'esempio precedente, le informazioni immesse dall'utente in textbox vengono acquisite tramite il parametro param1. La 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 i dati dell'allegato.

L'azione di invio Invia all'endpoint REST 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 dai campi textbox e numericbox per l'azione successiva.

Configurazione dellazione di invio dellendpoint REST

Puoi anche abilitare la richiesta POST e fornire un URL per pubblicare la richiesta. Per inviare i dati al server AEM che ospita il modulo, utilizza un percorso relativo corrispondente al percorso principale del server AEM. Ad esempio, /content/forms/af/SampleForm.html. Per inviare dati a qualsiasi altro server, utilizzare il percorso assoluto.

NOTA
Per passare i campi come parametri in un URL REST, tutti i campi devono avere nomi di elementi diversi, anche se i campi sono posizionati su pannelli diversi.

Invia e-mail

È possibile utilizzare l'azione di invio Invia e-mail per inviare un'e-mail a uno o più destinatari quando il modulo viene inviato correttamente. 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},

L'indirizzo di spedizione predefinito è:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Cordiali saluti,
WKND

"
NOTA
  • Tutti i campi modulo devono avere nomi di elementi diversi, anche se i campi sono posizionati su pannelli diversi di un modulo adattivo.
  • AEM as a Cloud Service richiede la crittografia della posta in uscita. Per impostazione predefinita, l’e-mail in uscita è disabilitata. Per attivarlo, invia un ticket di supporto a Richiedendo l'accesso.

Puoi anche includere nell’e-mail allegati e un documento di record (DoR). Per abilitare l'opzione Allega documento di 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 utilizzando il modello dati modulo (FDM)

L'azione di invio Invia tramite modello dati modulo scrive i dati del modulo adattivo inviati per l'oggetto modello dati specificato in un modello dati modulo (FDM) 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 modulo all'origine dati utilizzando un modello dati modulo (FDM) e un documento di record (DoR). Per informazioni sul modello dati modulo (FDM), vedere AEM Forms Integrazione dati.

Richiama un flusso di lavoro AEM

L'azione di invio Richiama un flusso di lavoro AEM 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 l'opzione Percorso file dati per specificare il nome del file e il percorso del file relativo al payload. Il percorso /addresschange/data.xml, ad esempio, crea una cartella denominata addresschange e la inserisce 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: è possibile utilizzare l'opzione 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 record generato per il modulo adattivo. È possibile utilizzare l'opzione Percorso del documento record per specificare il nome del file del documento record e il percorso del file relativo al payload. Ad esempio, il percorso /addresschange/DoR.pdf crea una cartella denominata addresschange relativa al payload e inserisce DoR.pdf relativa al payload. È inoltre possibile specificare solo DoR.pdf per salvare solo il 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 l'azione di invio Richiama un flusso di lavoro AEM, configura quanto segue per la configurazione del servizio impostazioni DS AEM:

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

  • Elaborazione nome utente server: nome utente dell'utente del flusso di lavoro

  • Elaborazione password server: password utente flusso di lavoro

Invia a SharePoint

L'azione di invio Invia a SharePoint 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

Per utilizzare l'azione di invio Invia a raccolta documenti di SharePoint in un modulo adattivo:

  1. Crea una configurazione della libreria di documenti di SharePoint: connette AEM Forms all'archiviazione di Microsoft® Sharepoint.
  2. Utilizzare l'azione Invia a SharePoint in un modulo adattivo: il modulo adattivo viene collegato a Microsoft® SharePoint configurato.

Creare una configurazione di SharePoint Document Library

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

  1. Vai alla tua istanza di AEM Forms Author > Strumenti > Servizi cloud > Microsoft® SharePoint.

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

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

  4. Fare clic su Crea > Libreria documenti di SharePoint dall'elenco a discesa. Viene visualizzata la procedura guidata di configurazione di SharePoint.

    Configurazione Sharepoint

  5. Specifica il 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 la documentazione di Microsoft®.

    • Puoi recuperare Client ID e Client Secret dell'app dal portale Microsoft® Azure.
    • Nel portale Microsoft® Azure, aggiungere 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 le 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 di Microsoft® Azure.
    NOTA
    Il campo segreto client è obbligatorio oppure facoltativo in base alla configurazione dell'applicazione Azure Active Directory. Se l’applicazione è configurata per l’utilizzo di un segreto client, è obbligatorio fornire il segreto client.

  6. Fai clic su Connetti. Se la connessione ha esito positivo, viene visualizzato il messaggio Connection Successful.

  7. Selezionare 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 nella raccolta Documents 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 della raccolta documenti di SharePoint in un modulo adattivo

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

  1. Crea un modulo adattivo.

    NOTA
    • Selezionare lo stesso Contenitore configurazione per un modulo adattivo, in cui è stata creata l'archiviazione della raccolta documenti di SharePoint.
    • Se non è selezionato alcun contenitore di configurazione Contenitore di configurazione, nella finestra delle proprietà dell'azione di invio vengono visualizzate le cartelle globali Configurazione archiviazione.

  2. Seleziona Invia azione come Invia a SharePoint.
    GIF Sharepoint

  3. Selezionare la configurazione archiviazione, in cui si desidera salvare i dati.

  4. Fai clic su Salva per salvare le impostazioni di invio.

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.

NOTA
Gli allegati vengono archiviati anche nella directory /folder_name/form_name/year/month/date/submission_id/data. Tuttavia, se si seleziona Salva allegati con nome originale, gli allegati vengono archiviati nella cartella utilizzando i nomi di file originali.
image