proxy del servizio HTML5 forms html-forms-service-proxy

Il proxy del servizio HTML5 forms è una configurazione che consente di registrare un proxy per il servizio di invio. Per configurare Service Proxy, specifica l’URL del servizio di invio tramite il parametro della richiesta submitServiceProxy.

Vantaggi del proxy di servizio benefits-of-service-proxy-br

Il proxy del servizio elimina i seguenti elementi:

  • Il flusso di lavoro di HTML5 Forms richiede l’apertura del servizio di invio "/content/xfaforms/submit/default" per gli utenti di HTML5 forms. Espone i server dell’AEM a un pubblico non intenzionale più ampio.
  • L’URL del servizio è incorporato nel modello di runtime del modulo. Impossibile modificare il percorso dell'URL del servizio.
  • L’invio è un processo in due fasi. Per inviare i dati del modulo, sono necessari almeno due percorsi al server. Di conseguenza, aumenta il carico sul server.
  • I moduli HTML5 inviano dati nella richiesta POST anziché nella richiesta PDF. Per i flussi di lavoro che coinvolgono moduli PDF e HTML5, sono necessari due diversi metodi di elaborazione degli invii.

Topologie topologies-br

I moduli HTML5 possono utilizzare le seguenti topologie per connettersi ai server AEM.

  • Una topologia in cui i moduli AEM Server o HTML5 inviano dati al server tramite POST.
  • Topologia in cui il server proxy invia i dati POST al server.

Topologie proxy del servizio HTML5 forms

Topologie proxy del servizio HTML5 forms

I moduli HTML5 si connettono ai server AEM per eseguire script lato server, servizi Web e invii. Il runtime XFA dei moduli HTML5 utilizza chiamate Ajax sull’endpoint "/bin/xfaforms/submitaction" con vari parametri per la connessione ai server AEM. I moduli HTML5 consentono di connettere i server AEM per eseguire le operazioni seguenti:

Esecuzione di script lato server e servizi Web execute-server-sided-scripts-and-web-services

Gli script contrassegnati per l'esecuzione sul server sono noti come script lato server. Nella tabella seguente sono elencati tutti i parametri utilizzati negli script lato server e nei servizi Web.

Parametro
Descrizione
attività
L’attività contiene gli eventi che attivano la richiesta. Ad esempio clic, uscita o modifica
contextSom
contextSom contiene l'espressione SOM dell'oggetto in cui vengono eseguiti gli eventi.
Modello
Il modello contiene il modello utilizzato per il rendering del modulo.
contentRoot
contentRoot contiene la directory principale del modello utilizzata per eseguire il rendering del modulo.
Dati
I dati contengono byte di dati utilizzati per il rendering del modulo.
formDom
formDom contiene DOM del modulo HTML5 in formato JSON.
pacchetto
pacchetto specificato come modulo.
debugDir
debugDir contiene la directory di debug utilizzata per il rendering del modulo.

Inviare dati submit-data

Facendo clic sul pulsante di invio, i moduli HTML5 inviano dati al server. Nella tabella seguente sono elencati tutti i parametri inviati dai moduli HTML5 al server.

Parametro
Descrizione
Modello
Modello utilizzato per il rendering del modulo.
contentRoot
directory principale del modello utilizzata per il rendering del modulo.
Dati
byte di dati utilizzati per il rendering del modulo.
formDom
DOM del modulo HTML5 in formato JSON.
submiturl
URL in cui viene pubblicato l'XML dati.
debugDir
Directory di debug utilizzata per il rendering del modulo.

Funzionamento del proxy di invio how-nbsp-the-nbsp-submit-proxy-works

Il proxy del servizio di invio funge da pass-through se il submiturl non è presente nel parametro della richiesta. Funge da pass-through. Invia la richiesta all’endpoint /bin/xfaforms/submitaction e invia la risposta al runtime XFA.

Il proxy del servizio di invio seleziona una topologia se submiturl è presente nel parametro della richiesta.

  • Se i server AEM pubblicano i dati, il servizio proxy funge da pass-through. Invia la richiesta all’endpoint /bin/xfaforms/submitaction e invia la risposta al runtime XFA.

  • Se il proxy pubblica i dati, il servizio proxy trasmette tutti i parametri ad eccezione di submitUrl al /bin/xfaforms/submitaction end point e riceve i byte xml nel flusso di risposta. Successivamente, il servizio proxy invia i byte XML dei dati all'elemento submitUrl per l'elaborazione.

  • Prima di inviare i dati (richiesta POST) a un server, i moduli HTML5 verificano la connettività e la disponibilità del server. Per verificare la connettività e la disponibilità, i moduli HTML inviano una richiesta head vuota al server. Se il server è disponibile, il modulo HTML5 invia i dati (richiesta POST) al server. Se il server non è disponibile, viene visualizzato un messaggio di errore, Impossibile connettersi al server, viene visualizzato. Il rilevamento avanzato impedisce agli utenti di riempire nuovamente il modulo. Il servlet proxy gestisce la richiesta head e non genera un’eccezione.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2