Configurare un modulo adattivo per l’azione di invio dell’endpoint REST
La funzionalità per specificare l'endpoint REST utilizzando la configurazione è un programma per l'adozione anticipata ed è applicabile solo ai Componenti core e a Edge Delivery Services Forms. Puoi scrivere a aem-forms-ea@adobe.com
dal tuo ID e-mail ufficiale per partecipare al programma early adopter e richiedere l'accesso alla funzionalità.
Utilizza 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.
AEM as a Cloud Service offre diverse azioni di invio pronte all’uso per la gestione degli invii di moduli. Ulteriori informazioni su queste opzioni sono disponibili nell'articolo Azione di invio modulo adattivo.
Vantaggi
Alcuni dei vantaggi della configurazione dell'azione di invio Invia all'endpoint REST per Adaptive Forms sono:
- Consente l’integrazione diretta dei dati dei moduli con sistemi e servizi esterni tramite API RESTful.
- Fornisce flessibilità nella gestione delle richieste di dati da Adaptive Forms, supportando strutture di dati dinamiche e complesse.
- Supporta la mappatura dinamica dei campi modulo ai parametri nell’URL dell’endpoint REST, consentendo l’invio di dati adattabili e personalizzabili.
Configurare l’azione di invio Invia a endpoint REST steps-to-configure-submit-to-restendpoint-submit-action
Per configurare l’azione di invio in base alla specifica API aperta Swagger per un modulo adattivo basato su componenti di base, procedi come segue:
-
Apri il modulo adattivo per la modifica e passa alla sezione Invio delle proprietà Contenitore modulo adattivo.
-
Dall'elenco a discesa Invia azione, selezionare Invia all'endpoint REST.
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.
Questa opzione consente di immettere direttamente l’endpoint REST di destinazione.
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, le informazioni immesse dall'utente in
textbox
vengono acquisite tramite il parametroparam1
. La sintassi per pubblicare i dati acquisiti tramiteparam1
è:String data=request.getParameter("param1");
Analogamente, i parametri utilizzati per la registrazione di dati e allegati XML sono
dataXml
eattachments
.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 eatt
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 del campo da richiedere. Il formato della richiesta è:{fieldName}={request parameter name}
Come mostrato nell'immagine seguente,
param1
eparam2
vengono passati come parametri con valori copiati dai campi textbox e numericbox per l'azione successiva.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. -
Fai clic su Fine.
Per configurare l’azione di invio in base alle specifiche API aperte di Swagger per un modulo adattivo basato su componenti core:
-
Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.
-
Fare clic sull'icona delle proprietà del Contenitore Guida TV
-
Fare clic sulla scheda Invio.
-
Dall'elenco a discesa Invia azione, selezionare Invia all'endpoint REST.
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.Sono disponibili due opzioni per specificare l’endpoint REST:
accordion URL Questa opzione consente di immettere direttamente l’endpoint REST di destinazione.
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, 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 del campo 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.
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.
+++
accordion |
---|
Configurazione |
Questa opzione consente di aggiungere una configurazione HTTP predefinita gestita tramite il browser configurazioni di AEM. È possibile selezionare la configurazione creata per il tipo di autenticazione dell'endpoint REST del servizio e i tipi di contenuto. Per ulteriori informazioni sul tipo di autenticazione e sui tipi di contenuto, visita configura origini dati |
- Fai clic su Fine.
Per configurare l’azione di invio in base alle specifiche dell’API aperta Swagger per il modulo adattivo creato nell’editor universale, procedi come segue:
-
Apri il modulo adattivo per la modifica.
-
Fai clic sull'estensione Modifica proprietà modulo nell'editor.
Viene visualizzata la finestra di dialogo Proprietà modulo.note note NOTE - Se l'icona Modifica proprietà modulo non è visibile nell'interfaccia di Universal Editor, abilitare l'estensione Modifica proprietà modulo in Extension Manager.
- Per informazioni su come abilitare o disabilitare le estensioni nell'editor universale, consulta l'articolo Caratteristiche principali di Extension Manager.
1. Fai clic sulla scheda **Invio** e seleziona **Invia all'endpoint REST** azione di invio.
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.Sono disponibili due opzioni per specificare l’endpoint REST:
accordion URL Questa opzione consente di immettere direttamente l’endpoint REST di destinazione.
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, 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 del campo 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.
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.
+++
accordion |
---|
Configurazione |
Questa opzione consente di aggiungere una configurazione HTTP predefinita gestita tramite il browser configurazioni di AEM. È possibile selezionare la configurazione creata per il tipo di autenticazione dell'endpoint REST del servizio e i tipi di contenuto. Per ulteriori informazioni sul tipo di autenticazione e sui tipi di contenuto, visita configura origini dati |
- Fai clic su Salva&Chiudi.
Best practice
- Quando pubblichi i dati su un server esterno, accertati che l’URL sia sicuro e configura il percorso in modo da gestire la richiesta POST in modo anonimo per proteggere le informazioni riservate.
- 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.
Articoli correlati
- Invia e-mail
- Invia a libreria documenti di SharePoint
- Invia a elenco SharePoint
- Inviare utilizzando il modello dati modulo
- Inviare all’archiviazione Blob di Azure
- Inviare all’endpoint REST
- Inviare a OneDrive
- Richiama un flusso di lavoro AEM
- Invia a Power Automate
- Invia a Workfront Fusion
- Collegare un modulo adattivo all’applicazione Salesforce
- Collegare un modulo adattivo a Microsoft
- Collegare un modulo adattivo a Marketo Engage
- Creare un’azione di invio personalizzata