Configurare un modulo adattivo per l’azione di invio dell’endpoint REST

Utilizza il Invia all’endpoint REST per pubblicare 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 delle richieste di moduli. Per ulteriori informazioni su queste opzioni, consulta Azione di invio modulo adattivo articolo.

Vantaggi

Alcuni dei vantaggi della configurazione di Invia all’endpoint REST le azioni di invio 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 la Contenitore guida componente del modulo adattivo.

  2. Fai clic sulle proprietà Contenitore guida Proprietà guida icona. Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Fai clic su Invio scheda.

  4. Dalla sezione Azione di invio elenco a discesa, seleziona Invia all’endpoint Rest.
    Configurazione dell’azione dell’endpoint Invia a 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 per i valori dei campi passati come parametri della pagina di ringraziamento

    Nell’esempio precedente, l’utente ha inserito le informazioni in textbox viene acquisito tramite il parametro param1. 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 memorizza i dati dell'allegato.

    Il Invia all’endpoint REST Azione di invio 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 da casella di testo e numericbox campi per l’azione successiva.

    Configurazione dell’azione di invio endpoint REST

    È inoltre possibile Abilita richiesta POST e fornisci 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. Clic 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