Transmission de Documents au service Forms

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

Le service AEM Forms effectue le rendu de PDF forms interactifs sur les périphériques clients, généralement les navigateurs Web, afin de recueillir des informations auprès des utilisateurs. Un formulaire PDF interactif est basé sur une conception de formulaire généralement enregistrée sous la forme d’un fichier XDP et créée dans Designer. Depuis AEM Forms, vous pouvez transmettre un objet com.adobe.idp.Document contenant la conception de formulaire au service Forms. Le service Forms effectue ensuite le rendu de la conception de formulaire située dans l’objet com.adobe.idp.Document.

L'avantage de transmettre un objet com.adobe.idp.Document au service Forms réside dans le fait que d'autres opérations de service renvoient une instance com.adobe.idp.Document. En d’autres termes, vous pouvez obtenir une instance com.adobe.idp.Document à partir d’une autre opération de service et la générer. Supposons, par exemple, qu’un fichier XDP soit stocké dans un noeud Content Services (obsolète) nommé /Company Home/Form Designs, comme illustré ci-dessous.

Vous pouvez récupérer par programmation le fichier Loan.xdp de Content Services (obsolète) (obsolète) et transmettre le fichier XDP au service Forms dans un objet com.adobe.idp.Document.

Résumé des étapes

Pour transmettre un document obtenu à partir de Content Services (obsolète) (obsolète) au service Forms, effectuez les tâches suivantes :

1. Incluez des fichiers de projet.
2. Créez un Forms et un objet API Client Document Management.
3. Récupérez la conception de formulaire auprès de Content Services (obsolète).
4. Générer le formulaire PDF interactif
5. Exécutez une action avec le flux de données du formulaire.

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, incluez les fichiers proxy.

Création d’un Forms et d’un objet API Client Document Management

Avant de pouvoir exécuter par programmation une opération d’API de service Forms, créez un objet API Client Forms. En outre, dans la mesure où ce processus récupère un fichier XDP de Content Services (obsolète), créez un objet API de gestion de Document.

Récupération de la conception de formulaire à partir de Content Services (obsolète)

Récupérez le fichier XDP à partir de Content Services (obsolète) à l’aide de l’API Java ou de service Web. Le fichier XDP est renvoyé dans une instance com.adobe.idp.Document (ou une instance BLOB si vous utilisez des services Web). Vous pouvez ensuite transmettre l’instance com.adobe.idp.Document au service Forms.

Génération d’un formulaire PDF interactif

Pour générer un formulaire interactif, transmettez l’instance com.adobe.idp.Document qui a été renvoyée de Content Services (obsolète) au service Forms.

Exécution d’une action avec le flux de données de formulaire

Selon le type d’application cliente, vous pouvez écrire le formulaire dans un navigateur Web client ou l’enregistrer dans un fichier PDF. En règle générale, une application Web écrit le formulaire dans un navigateur Web. Cependant, une application de bureau enregistre généralement le formulaire au format PDF.

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

Transmettre des documents au service Forms à l’aide de l’API Java

Transmettez un document obtenu à partir de Content Services (obsolète) à l’aide du service Forms et de l’API Content Services (obsolète) (Java) :

1. Inclure les fichiers de projet

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

2. Création d’un Forms et d’un objet API Client Document Management

   • Créez un objet ServiceClientFactory qui contient des propriétés de connexion. (Voir Réglage des propriétés de la connexion.)
   • Créez un objet FormsServiceClient en utilisant son constructeur et en transmettant l'objet ServiceClientFactory.
   • Créez un objet DocumentManagementServiceClientImpl en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

3. Récupération de la conception de formulaire à partir de Content Services (obsolète)

   Appelez la méthode retrieveContent de l’objet DocumentManagementServiceClientImpl et transmettez les valeurs suivantes :

   • Valeur de chaîne qui spécifie la banque où le contenu est ajouté. Le magasin par défaut est SpacesStore. Cette valeur est un paramètre obligatoire.
   • Valeur de chaîne qui spécifie le chemin d’accès complet au contenu à récupérer (par exemple, /Company Home/Form Designs/Loan.xdp). Cette valeur est un paramètre obligatoire.
   • Valeur de chaîne qui spécifie la version. Cette valeur est un paramètre facultatif et vous pouvez transmettre une chaîne vide. Dans ce cas, la dernière version est récupérée.

   La méthode retrieveContent renvoie un objet CRCResult contenant le fichier XDP. Obtenez une instance com.adobe.idp.Document en appelant la méthode CRCResult de l'objet getDocument.

4. Génération d’un formulaire PDF interactif

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

   • Objet com.adobe.idp.Document contenant la conception de formulaire récupérée auprès de Content Services (obsolète).
   • 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. Cette valeur est un paramètre facultatif et vous pouvez spécifier null si vous ne souhaitez pas spécifier d’options d’exécution.
   • Objet URLSpec contenant des valeurs URI. Cette valeur est un paramètre facultatif et vous pouvez spécifier null.
   • Objet java.util.HashMap qui stocke les pièces jointes. Cette valeur est 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. Exécution d’une action avec le flux de données de formulaire

   • 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. Transmettez 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) : Transmission de documents au service Forms à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

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

Transmettre des documents au service Forms à l’aide de l’API de service Web

Transmettez un document obtenu à partir de Content Services (obsolète) à l’aide du service Forms et de l’API Content Services (obsolète) (service Web) :

1. Inclure les fichiers de projet

   Créez un projet Microsoft .NET qui utilise MTOM. Dans la mesure où cette application cliente appelle deux services AEM Forms, créez deux références de service. Utilisez la définition WSDL suivante pour la référence de service associée au service Forms : http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

   Utilisez la définition WSDL suivante pour la référence de service associée au service Document Management : http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

   Le type de données BLOB étant commun aux deux références de service, qualifiez pleinement le type de données BLOB lors de son utilisation. Dans le début rapide du service Web correspondant, toutes les instances BLOB sont pleinement qualifiées.

   REMARQUE

   Remplacez localhostpar l’adresse IP du serveur hébergeant AEM Forms.

2. Création d’un Forms et d’un objet API Client Document Management

   • Créez un objet FormsServiceClient en utilisant son constructeur par défaut.

   • Créez un objet FormsServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/FormsService?WSDL). Vous n'avez pas besoin d'utiliser l'attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

   • Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ FormsServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

   • Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

   • Activez l’authentification HTTP de base en exécutant les tâches suivantes :

     • Attribuez le nom d’utilisateur AEM forms au champ FormsServiceClient.ClientCredentials.UserName.UserName.
     • Attribuez la valeur de mot de passe correspondante au champ FormsServiceClient.ClientCredentials.UserName.Password.
     • Affectez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

   REMARQUE

   Répétez ces étapes pour le client de service DocumentManagementServiceClient.

3. Récupération de la conception de formulaire à partir de Content Services (obsolète)

   Récupérez le contenu en appelant la méthode retrieveContent de l’objet DocumentManagementServiceClient et en transmettant les valeurs suivantes :

   • Valeur de chaîne qui spécifie la banque où le contenu est ajouté. Le magasin par défaut est SpacesStore. Cette valeur est un paramètre obligatoire.
   • Valeur de chaîne qui spécifie le chemin d’accès complet au contenu à récupérer (par exemple, /Company Home/Form Designs/Loan.xdp). Cette valeur est un paramètre obligatoire.
   • Valeur de chaîne qui spécifie la version. Cette valeur est un paramètre facultatif et vous pouvez transmettre une chaîne vide. Dans ce cas, la dernière version est récupérée.
   • Paramètre de sortie de chaîne qui stocke la valeur du lien de navigation.
   • Paramètre de sortie BLOB qui stocke le contenu. Vous pouvez utiliser ce paramètre de sortie pour récupérer le contenu.
   • Un paramètre de sortie ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType qui stocke les attributs de contenu.
   • Un paramètre de sortie CRCResult. Au lieu d’utiliser cet objet, vous pouvez utiliser le paramètre de sortie BLOB pour obtenir le contenu.

4. Génération d’un formulaire PDF interactif

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

   • Objet BLOB contenant la conception de formulaire récupérée auprès de Content Services (obsolète).
   • Objet BLOB contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner de données, transmettez un objet BLOB vide.
   • Objet PDFFormRenderSpec qui stocke les options d’exécution. Cette valeur est un paramètre facultatif et vous pouvez spécifier null si vous ne souhaitez pas spécifier d’options d’exécution.
   • Objet URLSpec contenant des valeurs URI. Cette valeur est un paramètre facultatif et vous pouvez spécifier null.
   • Objet Map qui stocke les pièces jointes. Cette valeur est un paramètre facultatif et vous pouvez spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.
   • Paramètre de sortie long utilisé pour stocker le nombre de pages.
   • Paramètre de sortie de chaîne utilisé pour stocker la valeur du paramètre régional.
   • Paramètre de sortie FormsResult utilisé pour stocker le formulaire PDF interactif .

   La méthode renderPDFForm2 renvoie un objet FormsResult contenant le formulaire PDF interactif.

5. Exécution d’une action avec le flux de données de formulaire

   • Créez un objet BLOB contenant des données de formulaire en obtenant la valeur du champ FormsResult de l’objet outputContent.
   • Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur de chaîne qui représente l’emplacement du fichier du document PDF interactif et le mode d’ouverture du fichier.
   • Créez un tableau d’octets qui stocke le contenu de l’objet BLOB récupéré à partir de l’objet FormsResult. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
   • Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l'objet System.IO.FileStream.
   • Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Appel de AEM Forms à l’aide de MTOM