Rendu de Forms sur le client

Les exemples et exemples de ce document ne concernent que l’environnement AEM Forms on JEE.

Rendu de Forms sur le client

Vous pouvez optimiser la diffusion du contenu PDF et améliorer la capacité du service Forms à gérer la charge réseau en utilisant la fonctionnalité de rendu côté client de Acrobat ou Adobe Reader. Ce processus est connu sous le nom de rendu d’un formulaire au niveau du client. Pour générer un formulaire sur le client, le périphérique client (généralement un navigateur Web) doit utiliser Acrobat 7.0 ou Adobe Reader 7.0 ou une version ultérieure.

Les modifications apportées à un formulaire résultant de l’exécution de script côté serveur ne sont pas répercutées dans un formulaire rendu au client, sauf si le sous-formulaire racine contient l’attribut restoreState défini sur auto. Pour plus d’informations sur cet attribut, voir Forms Designer.

Résumé des étapes

Pour générer un formulaire au niveau du client, 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 du rendu client.
4. Générer un formulaire au niveau du client.
5. Ecrivez le 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 objet FormsServiceClient. Si vous utilisez l’API du service Web Forms, créez un objet FormsService.

Définition des options d’exécution du rendu client

Vous devez définir l’option d’exécution de rendu client pour générer un formulaire au niveau du client en définissant l’option d’exécution RenderAtClient sur true. Ainsi, le formulaire est remis au périphérique client sur lequel il est rendu. Si RenderAtClient est auto (la valeur par défaut), la conception de formulaire détermine si le formulaire est généré au niveau du client. La conception de formulaire doit être une conception de formulaire avec une disposition souple.

Une option d'exécution facultative que vous pouvez définir est l'option SeedPDF. L’option SeedPDF combine le conteneur PDF (document PDF initial) avec la conception de formulaire et les données XML. La conception de formulaire et les données XML sont toutes deux remises à Acrobat ou Adobe Reader, où le formulaire est rendu. L'option SeedPDF peut être utilisée lorsque l'ordinateur client ne dispose pas de polices utilisées dans le formulaire, par exemple lorsqu'un utilisateur final n'est pas autorisé à utiliser une police que le propriétaire du formulaire est autorisé à utiliser.

Designer permet de créer un fichier PDF dynamique simple à utiliser en tant que fichier PDF initial. Pour effectuer cette tâche, procédez comme suit :

1. Déterminez si vous devez incorporer des polices dans le fichier PDF initial. Le fichier PDF initial doit contenir les polices supplémentaires requises par le formulaire généré. Lorsque vous incorporez des polices dans le fichier PDF initial, veillez à ne pas enfreindre les accords de licence de polices. Dans Designer, vous pouvez déterminer si vous pouvez incorporer légalement des polices. Lors de l’enregistrement, si certaines polices ne peuvent pas être incorporées dans le formulaire, Designer affiche un message répertoriant les polices que vous ne pouvez pas incorporer. Ce message n’est pas affiché dans Designer pour les documents PDF statiques.
2. Si vous créez le fichier PDF d’origine dans Designer, il est recommandé d’ajouter au minimum un champ de texte contenant un message. Le message doit être adressé aux utilisateurs des versions antérieures d'Adobe Reader en indiquant qu'ils ont besoin de Acrobat 7.0 ou version ultérieure ou de Adobe Reader 7.0 ou version ultérieure pour vue au document.
3. Enregistrez le fichier PDF initial sous la forme d’un fichier PDF dynamique avec l’extension de nom de fichier PDF.

Générer un formulaire au niveau du client

Pour générer un formulaire au niveau du client, vous devez vous assurer que les options d’exécution de rendu client sont incluses dans la logique de votre application pour générer un formulaire.

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

Le service Forms crée 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 rendu par Acrobat 7.0 ou Adobe Reader 7.0 ou une version ultérieure et est visible par l’utilisateur.

Voir également

Générer un formulaire au niveau du client à l’aide de l’API Java

Générer un formulaire sur le client à l’aide de l’API du service Web

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

Transmission de Documents au service Forms

Création d’Applications web renvoyant Forms

Générer un formulaire sur le client à l’aide de l’API Java

Générer un formulaire sur le client à 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.
   • Créez un objet FormsServiceClient en utilisant son constructeur et en transmettant l'objet ServiceClientFactory.

3. Définition des options d’exécution du rendu client

   • Créez un objet PDFFormRenderSpec en utilisant son constructeur.
   • Définissez l’option d’exécution RenderAtClient en appelant la méthode PDFFormRenderSpec de l’objet setRenderAtClient et en transmettant la valeur d’énumération RenderAtClient.Yes.

4. Générer un formulaire au niveau du client

   Appelez la méthode renderPDFForm de l’objet FormsServiceClient 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. Si vous référencez une conception de formulaire faisant partie d’une application AEM Forms, veillez à spécifier le chemin d’accès complet, tel que Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • 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 les options d’exécution requises pour générer un formulaire au niveau du client.
   • Objet URLSpec contenant des valeurs URI requises par le service Forms pour générer un formulaire.
   • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif et vous pouvez 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. Ecrire le flux de données du formulaire dans le navigateur Web client

   • Créez un objet com.adobe.idp.Document en appelant la méthode FormsResult de l'objet "s getOutputContent.
   • Obtenez le type de contenu de l'objet com.adobe.idp.Document en appelant sa méthode getContentType.
   • Définissez le type de contenu de l'objet javax.servlet.http.HttpServletResponse en appelant sa méthode setContentType et en transmettant le type de contenu de l'objet com.adobe.idp.Document.
   • Créez un objet javax.servlet.ServletOutputStream utilisé pour écrire le flux de données du formulaire dans le navigateur Web client en appelant la méthode javax.servlet.http.HttpServletResponse de l’objet getOutputStream.
   • Créez un objet java.io.InputStream en appelant la méthode com.adobe.idp.Document de l'objet getInputStream.
   • Créez un tableau d’octets et remplissez-le avec le flux de données du formulaire en appelant la méthode InputStream de l’objet read 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 de formulaire au navigateur Web client. Transférez le tableau d’octets à la méthode write.

Voir également

Début rapide (mode SOAP) : Rendu d’un formulaire sur le client à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

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

Générer un formulaire sur le client à l’aide de l’API du service Web

Générer un formulaire sur le client à 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 objet FormsService et définissez des valeurs d’authentification.

3. Définition des options d’exécution du rendu client

   • Créez un objet PDFFormRenderSpec en utilisant son constructeur.
   • Définissez l’option d’exécution RenderAtClient en appelant la méthode PDFFormRenderSpec de l’objet setRenderAtClient et en transmettant la valeur de chaîne RenderAtClient.Yes.

4. Générer un formulaire au niveau du client

   Appelez la méthode renderPDFForm de l’objet FormsService 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. Si vous référencez une conception de formulaire faisant partie d’une application Forms, veillez à spécifier le chemin d’accès complet, tel que Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • Objet BLOB contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner les données, transmettez null. (Voir Préremplissage de Forms avec des dispositions souple.)
   • Objet PDFFormRenderSpec qui stocke les options d’exécution requises pour générer un formulaire au niveau du client.
   • 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 et vous pouvez 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. Ce paramètre 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).
   • Un objet com.adobe.idp.services.holders.FormsResultHolder vide qui contiendra les résultats de cette opération.

   La méthode renderPDFForm remplit 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. Ecrire le flux de données du formulaire dans le navigateur Web client

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

Voir également

Rendu de Forms sur le client

Appel de AEM Forms à l’aide du codage Base64