HTML 5-formulärtjänstproxy html-forms-service-proxy

HTML5-formulärtjänstens proxy är en konfiguration som registrerar en proxy för överföringstjänsten. Om du vill konfigurera tjänstproxy anger du URL:en för överföringstjänsten via begärandeparametern submitServiceProxy.

Fördelar med tjänstproxy benefits-of-service-proxy-br

Tjänstproxyn eliminerar följande:

  • HTML 5-formulärarbetsflödet kräver att inskickningstjänsten "/content/xfaforms/submission/default" öppnas för HTML5-formuläranvändare. Den exponerar AEM servrar för en större, oavsiktlig publik.
  • Tjänst-URL:en är inbäddad i formulärets körningsmodell. Det går inte att ändra tjänstens URL-sökväg.
  • Inlämningen är en tvåstegsprocess. För att skicka in formulärdata krävs minst två resor till servern. Ökar därmed belastningen på servern.
  • HTML5-formulär skickar data i begäran om POST i stället för på begäran av PDF. För arbetsflöden som omfattar både PDF och HTML 5-formulär krävs två olika metoder för att behandla inskickade data.

Topologies topologies-br

HTML5-formulär kan använda följande topologier för att ansluta till AEM servrar.

  • En topologi där AEM Server eller HTML5-formulär skickar data via POST till servern.
  • En topologi där proxyservern skickar POST till servern.

HTML5-proxytopologier för formulärtjänster

Proxytopologier för HTML5-formulärtjänst

HTML5-formulär kan anslutas till AEM servrar för att köra serverbaserade skript, webbtjänster och överföringar. XFA-miljön för HTML5-formulären använder Ajax-anrop på "/bin/xfaforms/submit"-slutpunkten med olika parametrar för att ansluta till AEM. HTML5-formulär ansluter AEM servrar för att utföra följande åtgärder:

Kör serverbaserade skript och webbtjänster execute-server-sided-scripts-and-web-services

De skript som är markerade för att köras på servern kallas för serverbaserade skript. I följande tabell visas alla parametrar som används i serverbaserade skript och webbtjänster.

Parameter
Beskrivning
aktivitet
Aktiviteten innehåller de händelser som utlöser begäran. Till exempel klicka, avsluta eller ändra
contextAs
contextSOM innehåller SOM-uttryck för objektet där händelser körs.
Mall
Mallen innehåller mallen som används för att återge formuläret.
contentRoot
contentRoot innehåller mallens rotkatalog som används för att återge formuläret.
Data
Data innehåller byte med data som används för att återge formuläret.
formDom
formDom innehåller DOM för HTML5-formuläret i JSON-format.
paket
Paketet anges som formulär.
debugDir
debugDir innehåller den felsökningskatalog som används för att återge formuläret.

Skicka data submit-data

När du klickar på skicka-knappen skickar HTML5-formulär data till servern. I följande tabell visas alla parametrar som HTML5-formulär skickar till servern.

Parameter
Beskrivning
Mall
Mall som används för att återge formuläret.
contentRoot
mallens rotkatalog som används för att återge formuläret.
Data
byte som används för att återge formuläret.
formDom
DOM för HTML5-formuläret i JSON-format.
underordnad
URL:en där data-XML publiceras.
debugDir
Den felsökningskatalog som används för att återge formuläret.

Hur skicka-proxyn fungerar? how-nbsp-the-nbsp-submit-proxy-works

Skicka-tjänstproxyn fungerar som ett genomströmningsalternativ om det inte finns någon skicka-URL i request-parametern. Det fungerar som en genomströmning. Begäran skickas till slutpunkten för /bin/xfaforms/submit och svaret skickas till XFA-miljön.

Skicka-tjänstproxyn väljer en topologi om den skicka-URL:en finns i request-parametern.

  • Om AEM skickar data fungerar proxytjänsten som en vidarekoppling. Begäran skickas till slutpunkten för /bin/xfaforms/submit och svaret skickas till XFA-miljön.

  • Om proxyn skickar data, skickar proxytjänsten alla parametrar utom submitUrl till slutpunkten /bin/xfaforms/submit och tar emot xml-byte i svarsströmmen. Sedan skickar proxytjänsten data-xml-byte till submitUrl för bearbetning.

  • Innan data skickas (begäran om POST) till en server kontrollerar HTML5-formulär serverns anslutning och tillgänglighet. För att verifiera anslutning och tillgänglighet skickar HTML-formulär en tom huvudbegäran till servern. Om servern är tillgänglig skickar HTML5-formuläret data (POST request) till servern. Om servern inte är tillgänglig visas ett felmeddelande, Kunde inte ansluta till servern,. Avancerad identifiering förhindrar att användarna behöver fylla i formuläret på ett enkelt sätt. Proxyservern hanterar huvudbegäran och genererar inget undantag.

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