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

Componente di base

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:

  1. Apri il modulo adattivo per la modifica e passa alla sezione Invio delle proprietà Contenitore modulo adattivo.

  2. Dall'elenco a discesa Invia azione, selezionare Invia all'endpoint REST.

    Configurazione dellazione Invia allendpoint 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.
    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 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.

    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.

  3. Fai clic su Fine.

Componente core

Per configurare l’azione di invio in base alle specifiche API aperte di Swagger per un modulo adattivo basato su componenti core:

  1. Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.

  2. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Fare clic sulla scheda Invio.

  4. Dall'elenco a discesa Invia azione, selezionare Invia all'endpoint REST.

    Configurazione dellendpoint 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.

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

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.

+++

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
  1. Fai clic su Fine.
Editor universale

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:

  1. Apri il modulo adattivo per la modifica.

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

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

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.

+++

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab