Optimisation des performances du service Forms

Les exemples et les exemples de ce document sont réservés à l’environnement AEM Forms on JEE.

Optimisation des performances du service Forms

Lors du rendu d’un formulaire, vous pouvez définir des options d’exécution qui optimiseront les performances du service Forms. Une autre tâche que vous pouvez effectuer pour améliorer les performances du service Forms consiste à stocker les fichiers XDP dans le référentiel. Toutefois, cette section ne décrit pas comment effectuer cette tâche. (Voir Appel d’un service à l’aide d’une bibliothèque cliente Java.)

REMARQUE

Pour plus d’informations sur le service Forms, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour optimiser les performances du service Forms lors de la génération d’un formulaire, effectuez les tâches suivantes :

  1. Inclure les fichiers de projet.
  2. Créez un objet API client Forms.
  3. Définissez les options d’exécution des performances.
  4. Effectuez le rendu du formulaire.
  5. Ecrivez le flux de données de formulaire dans le navigateur Web client.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un objet API client Forms

Avant d’effectuer par programmation une opération d’API client de service Forms, vous devez créer un client de service Forms. Si vous utilisez l’API Java, créez un objet FormsServiceClient . Si vous utilisez l’API du service Web Forms, créez un objet FormsService .

Définition des options d’exécution des performances

Vous pouvez définir les options d’exécution de performances suivantes afin d’améliorer les performances du service Forms :

  • Mise en cache des formulaires : Vous pouvez mettre en cache un formulaire rendu au format PDF dans le cache du serveur. Chaque formulaire est mis en cache après avoir été généré pour la première fois. Sur un rendu ultérieur, si le formulaire mis en cache est plus récent que l’horodatage de conception de formulaire, le formulaire est récupéré depuis le cache. En mettant en cache des formulaires, vous améliorez les performances du service Forms, car il n’a pas à récupérer la conception de formulaire à partir d’un référentiel.
  • Le rendu des guides de formulaire (obsolète) peut prendre plus de temps que les autres types de transformation. Il est recommandé de mettre en cache les guides de formulaire (obsolète) afin d’améliorer les performances.
  • Option autonome : Si vous n’avez pas besoin du service Forms pour effectuer des calculs côté serveur, vous pouvez définir l’option Autonome sur true, ce qui entraîne la génération de formulaires sans informations d’état. Les informations d’état sont nécessaires si vous souhaitez rendre un formulaire interactif à un utilisateur final qui saisit ensuite les informations dans le formulaire et renvoie le formulaire au service Forms. Le service Forms effectue ensuite une opération de calcul et renvoie le formulaire à l’utilisateur avec les résultats affichés dans le formulaire. Si un formulaire sans informations d’état est renvoyé au service Forms, seules les données XML sont disponibles et les calculs côté serveur ne sont pas effectués.
  • Linearized PDF : Un fichier PDF linéarisé est organisé pour permettre un accès incrémentiel efficace dans un environnement réseau. Le fichier PDF est un fichier PDF valide à tous les égards et est compatible avec toutes les visionneuses et autres applications PDF existantes. En d’autres termes, un PDF linéarisé peut être affiché pendant son téléchargement.
  • Cette option n’améliore pas les performances lorsqu’un formulaire PDF est rendu sur le client.
  • Option GuideRSL : Active la génération du guide de formulaire (obsolète) à l’aide de bibliothèques partagées d’exécution. Cela signifie que la première requête téléchargera un fichier SWF plus petit, ainsi que des bibliothèques partagées plus grandes qui sont stockées dans le cache du navigateur. Pour plus d’informations, voir RSL dans la documentation Flex.
  • Vous pouvez également améliorer les performances du service Forms en effectuant le rendu d’un formulaire sur le client. (Voir Rendu de Forms sur le client.)

Rendu du formulaire

Pour générer le formulaire après avoir défini les options de performances, vous utilisez la même logique d’application que pour générer un formulaire sans options de performances.

Écrire le flux de données de formulaire dans le navigateur Web client

Une fois que le service Forms a rendu un formulaire, il renvoie un flux de données de formulaire que vous devez écrire dans le navigateur Web client. Lorsqu’il est écrit dans le navigateur Web client, le formulaire est visible par l’utilisateur.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Démarrages rapides de l’API Forms Service

Rendu des PDF forms interactifs

Rendu de Forms au format HTML

Création d’applications web qui renvoient Forms

Optimiser les performances à l’aide de l’API Java

Rendre un formulaire avec des performances optimisées à l’aide de l’API Forms (Java) :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-forms-client.jar, dans le chemin de classe de votre projet Java.

  2. Création d’un objet API client Forms

    • Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
    • Créez un objet FormsServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
  3. Définition des options d’exécution des performances

    • Créez un objet PDFFormRenderSpec en utilisant son constructeur.
    • Définissez l’option de cache de formulaire en appelant la méthode setCacheEnabled de l’objet PDFFormRenderSpec et en transmettant true.
    • Définissez l’option linéarisée en appelant la méthode setLinearizedPDF de l’objet PDFFormRenderSpec et en transmettant true.
  4. Rendu du formulaire

    Appelez la méthode renderPDFForm de l’objet FormsServiceClient et transmettez les valeurs suivantes :

    • Une valeur string qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier.
    • Objet com.adobe.idp.Document contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner de données, transmettez un objet com.adobe.idp.Document vide.
    • Objet PDFFormRenderSpec qui stocke des options d’exécution afin d’améliorer les performances.
    • Objet URLSpec contenant des valeurs URI requises par le service Forms.
    • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif qui vous permet de spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.

    La méthode renderPDFForm renvoie un objet FormsResult contenant un flux de données de formulaire qui doit être écrit dans le navigateur Web client.

  5. Écrire le flux de données de formulaire dans le navigateur Web client

    • Créez un objet javax.servlet.ServletOutputStream utilisé pour envoyer un flux de données de formulaire au navigateur Web client.
    • Créez un objet com.adobe.idp.Document en appelant la méthode FormsResult de l’objet getOutputContent.
    • Créez un objet java.io.InputStream en appelant la méthode getInputStream de l’objet com.adobe.idp.Document.
    • Créez un tableau d’octets et renseignez-le avec le flux de données de formulaire en appelant la méthode InputStream de l’objet readet en transmettant le tableau d’octets en tant qu’argument.
    • Appelez la méthode write de l’objet javax.servlet.ServletOutputStream pour envoyer le flux de données de formulaire au navigateur Web client. Transmettez le tableau d’octets à la méthode write .

Voir également

Démarrage rapide (mode SOAP) : Optimisation des performances à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Optimiser les performances à l’aide de l’API de service Web

Rendre un formulaire avec des performances optimisées à l’aide de l’API Forms (service Web) :

  1. Inclure les fichiers de projet

    • Créez des classes proxy Java qui utilisent le WSDL du service Forms.
    • Incluez les classes proxy Java dans le chemin de classe.
  2. Création d’un objet API client Forms

    Créez un objet FormsService et définissez des valeurs d’authentification.

  3. Définition des options d’exécution des performances

    • Créez un objet PDFFormRenderSpec en utilisant son constructeur.
    • Définissez l’option de cache de formulaire en appelant la méthode setCacheEnabled de l’objet PDFFormRenderSpec et en transmettant true.
    • Définissez l’option autonome en appelant la méthode setStandAlone de l’objet PDFFormRenderSpec et en transmettant la valeur true.
    • Définissez l’option linéarisée en appelant la méthode setLinearizedPDF de l’objet PDFFormRenderSpec et en transmettant true.
  4. Rendu du formulaire

    Appelez la méthode renderPDFForm de l’objet FormsService et transmettez les valeurs suivantes :

    • Une valeur string qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier.
    • Objet BLOB contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner les données, transmettez null.
    • Objet PDFFormRenderSpecc qui stocke les options d’exécution.
    • Objet URLSpec contenant des valeurs URI requises par le service Forms.
    • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif qui vous permet de spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.
    • Objet com.adobe.idp.services.holders.BLOBHolder vide renseigné par la méthode . Il est utilisé pour stocker le formulaire PDF rendu.
    • Objet javax.xml.rpc.holders.LongHolder vide renseigné par la méthode . (Cet argument stocke le nombre de pages dans le formulaire).
    • Objet javax.xml.rpc.holders.StringHolder vide renseigné par la méthode . (Cet argument stocke la valeur du paramètre régional).
    • Objet com.adobe.idp.services.holders.FormsResultHolder vide qui contiendra les résultats de cette opération.

    La méthode renderPDFForm renseigne l’objet com.adobe.idp.services.holders.FormsResultHolder transmis en tant que valeur du dernier argument avec un flux de données de formulaire qui doit être écrit dans le navigateur Web client.

  5. Écrire le flux de données de formulaire dans le navigateur Web client

    • Créez un objet FormResult en obtenant la valeur du membre de données value de l’objet com.adobe.idp.services.holders.FormsResultHolder.
    • Créez un objet javax.servlet.ServletOutputStream utilisé pour envoyer un flux de données de formulaire au navigateur Web client.
    • Créez un objet BLOB contenant des données de formulaire en appelant la méthode getOutputContent de l’objet FormsResult.
    • Créez un tableau d’octets et renseignez-le en appelant la méthode getBinaryData de l’objet BLOB. Cette tâche affecte le contenu de l’objet FormsResult au tableau d’octets.
    • Appelez la méthode write de l’objet javax.servlet.http.HttpServletResponse pour envoyer le flux de données de formulaire au navigateur Web client. Transmettez le tableau d’octets à la méthode write .

Voir également

Appel d’AEM Forms à l’aide du codage Base64

Sur cette page