Configurare un modulo adattivo per l’azione di invio dell’endpoint REST
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:
-
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 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, 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 di POST e fornire 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. -
Fai clic su Fine.
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 di 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 SharePoint
- Invia usando il modello dati modulo
- Invia ad Azure Blob Storage
- Invia all’endpoint REST
- Invia 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