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:

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

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

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

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