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.
Le proxy de service élimine les opérations suivantes :
Les formulaires HTML5 peuvent utiliser les topologies suivantes pour se connecter aux serveurs AEM.
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 :
Les scripts destinés à s’exécuter sur le serveur sont appelés scripts côté serveur. Le tableau suivant répertorie tous les paramètres utilisés dans les scripts et services web côté serveur.
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. |
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. |
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 |
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. |
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.
Si le proxy publie les données, le service de proxy transmet tous les paramètres, à l’exception de submitUrl, à l’extrémité /bin/xfaforms/submitaction et reçoit des octets XML dans le flux de réponse. 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. Sinon, le message d’erreur Could’t connect to the server (connexion au serveur impossible) s’affiche. La détection anticipée prévient les problèmes lors du remplissage du formulaire par les utilisateurs. La servlet de proxy gère la requête HEAD et ne lance aucune exception.