Les exemples et les échantillons de ce document sont réservés à l’environnement AEM Forms sur JEE.
Le service AEM Forms effectue le rendu de PDF forms interactifs sur les appareils clients, généralement des navigateurs Web, afin de collecter des informations auprès des utilisateurs. Un formulaire PDF interactif est basé sur une conception de formulaire généralement enregistrée sous forme de fichier XDP et créée dans Designer. À partir d’AEM Forms, vous pouvez transmettre au service Forms un objet com.adobe.idp.Document
qui contient la conception du formulaire. Le service Forms effectue ensuite le rendu de la conception du formulaire située dans l’objet com.adobe.idp.Document
.
L’avantage de transmettre un objet com.adobe.idp.Document
au service Forms est que les autres opérations du 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 en effectuer le rendu. Par exemple, supposons qu’un fichier XDP soit stocké dans un nœud de Content Services (obsolète) appelé /Company Home/Form Designs
, comme illustré ci-dessous.
Vous pouvez récupérer Loan.xdp par programmation à partir de Content Services (obsolète) (obsolète) et transmettre le fichier XDP au service Forms dans un objet com.adobe.idp.Document
.
Pour plus d’informations sur le service Forms, consultez Références des services pour AEM Forms.
Pour transmettre un document obtenu à partir de Content Services (obsolète) au service Forms, effectuez les tâches suivantes :
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éer un objet API Client Forms et un objet API Client Document Management
Avant d’effectuer par programmation une opération d’API de service Forms, créez un objet API client Forms. En outre, comme ce workflow récupère un fichier XDP de Content Services (obsolète), créez un objet API Document Management.
Récupérer 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.
Effectuer le rendu d’un formulaire PDF interactif
Pour effectuer le rendu d’un formulaire interactif, transmettez l’instance com.adobe.idp.Document
renvoyée par Content Services (obsolète) au service Forms.
Vous pouvez transmettre au service Forms un com.adobe.idp.Document
qui contient la conception du formulaire. Deux nouvelles méthodes appelées renderPDFForm2
et renderHTMLForm2
acceptent un objet com.adobe.idp.Document
qui contient une conception de formulaire.
Exécuter une action avec le flux de données du formulaire
Selon le type d’application client, vous pouvez écrire le formulaire dans le navigateur Web du client ou l’enregistrer comme fichier PDF. En règle générale, une application Web écrit le formulaire dans le navigateur Web. Cependant, une application de bureau enregistre généralement le formulaire sous forme de fichier PDF.
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
Transmettez un document obtenu à partir de Content Services (obsolète) à l’aide du service Forms et de l’API Content Services (obsolète) (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR du client, tels que adobe-forms-client.jar et adobe-contentservices-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Créer un objet API Client Forms et un objet API Client Document Management
ServiceClientFactory
qui contient des propriétés de connexion. (Voir Réglage des propriétés de la connexion.)FormsServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.DocumentManagementServiceClientImpl
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérer la conception du formulaire à partir de Content Services (obsolète)
Appelez la méthode retrieveContent
de l’objet DocumentManagementServiceClientImpl
et transmettez les valeurs suivantes :
SpacesStore
. Cette valeur est un paramètre obligatoire./Company Home/Form Designs/Loan.xdp
). Cette valeur est un paramètre obligatoire.La méthode retrieveContent
renvoie un objet CRCResult
qui contient le fichier XDP. Obtenez une instance com.adobe.idp.Document
en appelant la méthode getDocument
de l’objet CRCResult
.
Effectuer le rendu d’un formulaire PDF interactif
Appelez la méthode renderPDFForm2
de l’objet FormsServiceClient
et transmettez les valeurs suivantes :
com.adobe.idp.Document
contenant la conception du formulaire récupéré dans Content Services (obsolète).com.adobe.idp.Document
contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données, transmettez un objet com.adobe.idp.Document
.PDFFormRenderSpec
qui stocke les options d’exécution. Cette valeur est un paramètre facultatif. Vous pouvez indiquer null
si vous ne souhaitez pas spécifier d’options d’exécution.URLSpec
qui contient des valeurs URI. Cette valeur est un paramètre facultatif. Vous pouvez spécifier null
.java.util.HashMap
qui stocke les pièces jointes. Cette valeur est un paramètre facultatif. Vous pouvez spécifier null
si vous ne souhaitez pas joindre de fichiers au formulaire.La méthode renderPDFForm
renvoie un objet FormsResult
qui contient un flux de données de formulaire qui doit être écrit dans le navigateur Web du client.
Effectuer une action avec le flux de données du formulaire
com.adobe.idp.Document
en appelant la méthode getOutputContent
de l’objet FormsResult
.com.adobe.idp.Document
en appelant sa méthode getContentType
.javax.servlet.http.HttpServletResponse
en appelant sa méthode setContentType
et en transmettant le type de contenu de l’objet com.adobe.idp.Document
.javax.servlet.ServletOutputStream
utilisé pour écrire le flux de données de formulaire dans le navigateur web client en appelant la méthode getOutputStream
de l’objet javax.servlet.http.HttpServletResponse
.java.io.InputStream
en appelant la méthode getInputStream
de l’objet com.adobe.idp.Document
.read
de l’objet InputStream
. Transmettez le tableau d’octets comme argument.write
de l’objet javax.servlet.ServletOutputStream
pour envoyer le flux de données du formulaire au navigateur Web du client. Transmettez le tableau d’octets à la méthode write
.Voir également
Démarrage rapide (mode SOAP) : transmettre des documents au service Forms à 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
Transmettez un document obtenu à partir de Content Services (obsolète) en utilisant le service Forms et de l’API (service Web) de Content Services (obsolète) :
Inclure les fichiers du projet
Créez un projet Microsoft .NET qui utilise MTOM. Étant donné que 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
.
Étant donné que le type de données BLOB
est commun aux deux références de service, il qualifie entièrement le type de données BLOB
lors de son utilisation. Dans le démarrage rapide du service web correspondant, toutes les instances BLOB
sont entièrement qualifiées.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créer un objet API Client Forms et 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 effectuant les tâches suivantes :
FormsServiceClient.ClientCredentials.UserName.UserName
.FormsServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Répétez ces étapes pour le client de service DocumentManagementServiceClient
.
Récupérer la conception du 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 :
SpacesStore
. Cette valeur est un paramètre obligatoire./Company Home/Form Designs/Loan.xdp
). Cette valeur est un paramètre obligatoire.BLOB
stockant le contenu. Vous pouvez utiliser ce paramètre de sortie pour récupérer le contenu.ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType
stockant les attributs de contenu.CRCResult
. Au lieu d’utiliser cet objet, vous pouvez utiliser le paramètre de sortie BLOB
pour obtenir le contenu.Effectuer le rendu d’un formulaire PDF interactif
Appelez la méthode renderPDFForm2
de l’objet FormsServiceClient
et transmettez les valeurs suivantes :
BLOB
contenant la conception du formulaire récupéré dans Content Services (obsolète).BLOB
contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données, transmettez un objet BLOB
.PDFFormRenderSpec
qui stocke les options d’exécution. Cette valeur est un paramètre facultatif. Vous pouvez indiquer null
si vous ne souhaitez pas spécifier d’options d’exécution.URLSpec
qui contient des valeurs URI. Cette valeur est un paramètre facultatif. Vous pouvez spécifier null
.Map
qui stocke les pièces jointes. Cette valeur est un paramètre facultatif. Vous pouvez spécifier null
si vous ne souhaitez pas joindre de fichiers au formulaire.FormsResult
qui est utilisé pour stocker le formulaire PDF interactif .
.La méthode renderPDFForm2
renvoie un objet FormsResult
qui contient le formulaire PDF interactif.
Effectuer une action avec le flux de données du formulaire
BLOB
qui contient des données de formulaire en obtenant la valeur du champ outputContent
de l’objet FormsResult
.System.IO.FileStream
en utilisant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier du document PDF interactif et le mode d’ouverture du fichier.BLOB
récupéré dans l’objet FormsResult
. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM
de l’objet BLOB
.System.IO.BinaryWriter
en utilisant son constructeur et en transmettant l’objet System.IO.FileStream
.Write
de l’objet System.IO.BinaryWriter
et en transmettant le tableau d’octets.Voir également
Appeler AEM Forms en utilisant MTOM