Optimisation des performances du service Forms

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 est de stocker des fichiers XDP dans le référentiel. Toutefois, cette section ne décrit pas comment effectuer cette tâche. (See Invoking a service using a Java client library.)

Remarque

For more information about the Forms service, see Services Reference for 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. Incluez des fichiers de projet.
  2. Créez un objet API Client Forms.
  3. Définissez les options d’exécution des performances.
  4. Générer le formulaire.
  5. Ecrivez le flux de données du 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 de pouvoir exécuter 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 FormsServiceClient objet. Si vous utilisez l’API du service Web Forms, créez un FormsService objet.

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

Vous pouvez définir les options d’exécution de performances suivantes pour 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’est pas nécessaire de 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 celui des 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 truelaquelle les formulaires sont générés sans informations d’état. Les informations d’état sont nécessaires si vous souhaitez rendre un formulaire interactif à un utilisateur final qui entre ensuite les informations dans le formulaire et envoie 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.
  • PDF linéarisé : 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 égards et 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 à l’exécution. Cela signifie que la première requête télécharge 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 affichant 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 effectuer le rendu d’un formulaire sans options de performances.

Ecrire le flux de données du 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 pour l’utilisateur.

Voir également

Inclusion des fichiers de bibliothèque Java AEM Forms

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

Débuts rapides de l’API du service Forms

Rendu des PDF forms interactifs

Rendu de Forms au format HTML

Création d’Applications web renvoyant Forms

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

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

  1. Inclure les fichiers de projet

    Incluez des 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.
    • Create an FormsServiceClient object by using its constructor and passing the ServiceClientFactory object.
  3. Définition des options d’exécution des performances

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

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

    • Valeur de chaîne qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier.
    • Objet com.adobe.idp.Document contenant des données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données, transmettez un com.adobe.idp.Document objet vide.
    • Objet PDFFormRenderSpec qui stocke les 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 que vous pouvez spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.

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

  5. Ecrire le flux de données du formulaire dans le navigateur Web client

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

Voir également

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

Inclusion des fichiers de bibliothèque Java AEM Forms

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

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

Générer 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 de proxy Java qui utilisent le WSDL du service Forms.
    • Incluez les classes proxy Java dans votre chemin de classe.
  2. Création d’un objet API Client Forms

    Créez un FormsService objet 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 PDFFormRenderSpec setCacheEnabled méthode de l’objet et en transmettant true.
    • Définissez l’option autonome en appelant la PDFFormRenderSpec setStandAlone méthode de l’objet et en transmettant true.
    • Définissez l’option linéarisée en appelant la PDFFormRenderSpec setLinearizedPDF méthode de l’objet et en transmettant true.
  4. Rendu du formulaire

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

    • Valeur de chaîne qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier.
    • Objet BLOB contenant des données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des 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 que vous pouvez spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.
    • Objet vide com.adobe.idp.services.holders.BLOBHolder rempli par la méthode. Elle permet de stocker le formulaire PDF rendu.
    • Objet vide javax.xml.rpc.holders.LongHolder rempli par la méthode. (Cet argument stocke le nombre de pages dans le formulaire).
    • Objet vide javax.xml.rpc.holders.StringHolder rempli par la méthode. (Cet argument stocke la valeur du paramètre régional).
    • Objet vide com.adobe.idp.services.holders.FormsResultHolder qui contiendra les résultats de cette opération.

    La renderPDFForm méthode remplit l’ com.adobe.idp.services.holders.FormsResultHolder objet 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. Ecrire le flux de données du formulaire dans le navigateur Web client

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

Voir également

Appel de AEM Forms à l’aide du codage Base64

Sur cette page