Show Menu
SUJETS×

Proxy de service de formulaires HTML5

Le proxy de service de formulaires HTML5 est une configuration permettant d’enregistrer un proxy pour le service d’envoi. Pour configurer le proxy, précisez l’URL du service d’envoi via le paramètre de demande du proxy de service d’envoi : submissionServiceProxy .

Avantages du proxy de service

Le proxy de service élimine les éléments suivants :
  • Le flux de travail de formulaires HTML5 nécessite une connexion au service d’envoi « /content/xfaforms/submission/default » pour les utilisateurs de formulaires HTML5. Il expose les serveurs AEM à un public plus large et sans précédent.
  • L’URL de service est incluse dans le modèle d’exécution du formulaire. Il est impossible de changer le chemin de l’URL de service.
  • L’envoi est un processus en deux étapes. Pour l'envoi de données au formulaire, au moins deux voyages vers le serveur sont nécessaires. Par conséquent, la charge sur le serveur augmente.
  • Les formulaires HTML5 envoient des données dans la demande de post-traitement au lieu de la demande PDF. Pour le flux de travail impliquant des formulaires PDF et HTML5, deux méthodes différentes sont nécessaires pour traiter les envois.

Topologies

Les formulaires HTML5 peuvent utiliser les topologies suivantes pour se connecter aux serveurs AEM.
  • Une topologie où le serveur AEM ou les formulaires HTML5 envoient des données au serveur par le biais de la demande de post-traitement.
  • Une topologie dans laquelle le serveur proxy envoie des données de post-traitement au serveur.
Topologies du proxy de service de formulaires HTML5
Les formulaires HTML5 se connectent aux serveurs AEM pour exécuter les scripts, les services web et les envois côté serveur. L’exécution XFA des formulaires HTML5 utilise des appels Ajax sur l’extrémité « /bin/xfaforms/submitaction » avec divers paramètres permettant de se connecter aux serveurs AEM. Les formulaires HTML5 connectent les serveurs AEM pour effectuer les opérations suivantes :

Exécuter les scripts et services Web côté serveur

Les scripts destinés à s’exécuter sur le serveur sont appelés scripts côté serveur. Le tableau suivant tous les paramètres utilisés dans les scripts côté serveur et les services Web.
Paramètre
Description
activity
Le paramètre activity contient les événements qui déclenchent la demande. Par exemple : cliquer sur, quitter ou modifier
contextSom
Le paramètre contextSom contient l’expression SOM de l’objet où des événements ont été exécutés.
Template (Modèle)
Le paramètre Template contient le modèle utilisé pour générer le formulaire.
contentRoot
Le paramètre contentRoot contient le répertoire racine du modèle utilisé pour générer le formulaire.
Données
Le paramètre Data contient les octets de données utilisés pour générer le formulaire.
formDom
formDom contient le fichier DOM du formulaire HTML5 au format JSON.
packet
Le paramètre packet est indiqué comme formulaire.
debugDir
Le paramètre debugDir contient le répertoire de débogage utilisé pour générer le formulaire.

Envoi de données

En cliquant sur le bouton Envoyer, les formulaires HTML5 envoient des données au serveur. Le tableau suivant répertorie tous les paramètres que les formulaires HTML5 envoient au serveur.
Paramètre
Description
Template (Modèle)
Motif utilisé pour rendre le formulaire.
contentRoot
le répertoire racine de modèle utilisé pour générer le formulaire.
Données
octets de données utilisés pour générer le formulaire.
formDom
DOM du formulaire HTML5 au format JSON.
submiturl
L’URL de l’emplacement où les données XML sont publiées.
debugDir
Le répertoire de débogage utilisé pour générer le formulaire.

Fonctionnement du proxy d’envoi.

Si submiturl ne figure pas dans le paramètre de requête, le proxy de service d’envoi agit en tant que passerelle. Il agit en tant que passerelle. Il envoie la requête à l’extrémité //bin/xfaforms/submitaction et la réponse à l’exécution XFA.
Si submiturl figure dans le paramètre de requête, le proxy de service d’envoi sélectionne une topologie.
  • Si les serveurs AEM publient les données, le service de proxy agit comme une passerelle. Il envoie la requête à l’extrémité //bin/xfaforms/submitaction et la réponse à l’exécution XFA.
  • If proxy posts the data, the proxy service passes all the parameters except submitUrl to the /bin/xfaforms/submitaction end point and receives xml bytes in response stream. Ensuite, le service de proxy publie les octets XML de données au paramètre submitUrl pour traitement.
  • Avant d’envoyer des données (demande de post-traitement) sur un serveur, les formulaires HTML5 vérifient la connectivité et la disponibilité du serveur. Pour vérifier la connectivité et la disponibilité, les formulaires HTML envoient une première demande vide au serveur. Si le serveur est disponible, les formulaires HTML5 envoie les données (demande de post-traitement) au serveur. If the server is not available, an error message, Could’t connect to the server, is displayed. La détection anticipée prévient les problèmes lors du remplissage du formulaire par les utilisateurs. La servlet proxy traite la demande d'en-tête et ne renvoie pas d'exception.