Créer des flux de sortie de document

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet client Output.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Référencez une source de données XML.

• Créez un objet java.io.FileInputStream qui représente la source de données XML utilisée pour remplir le document PDF en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du fichier XML.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur. Transmettez l’objet java.io.FileInputStream.

Définissez les options d’exécution du PDF.

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option URI du fichier en appelant la méthode setFileURI de l’objet PDFOutputOptionsSpec. Transmettez une valeur string qui spécifie l’emplacement du fichier PDF généré par le service Output. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.

Définissez les options d’exécution de rendu.

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Mettez en cache la conception de formulaire pour améliorer les performances du service Output en appelant la méthode setCacheEnabled de l’objet RenderOptionsSpec et en transmettant true.

NOTE

Vous ne pouvez pas définir la version du document PDF à l’aide de la méthode setPdfVersion de l’objet RenderOptionsSpec si le document d’entrée est un formulaire Acrobat (un formulaire créé dans Acrobat) ou un document XFA signé ou certifié. Le document PDF de sortie conserve la version originale du PDF. De même, vous ne pouvez pas définir l’option Adobe PDF balisée en appelant la méthode setTaggedPDF* de l’objet RenderOptionsSpec si le document d’entrée est un formulaire Acrobat ou un document XFA signé ou certifié. *

NOTE

Vous ne pouvez pas définir l’option de PDF linéarisé à l’aide de la méthode setLinearizedPDF de l’objet RenderOptionsSpec si le document PDF d’entrée est certifié ou signé numériquement. (Voir Signature numérique de documents PDF.)

Générez un document PDF.

Créez un document PDF en appelant la méthode generatePDFOutput de l’objet OutputClient et en transmettant les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet com.adobe.idp.Document contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.

La méthode generatePDFOutput renvoie un objet OutputResult contenant les résultats de l’authentification.

NOTE

Lors de la génération d’un document PDF en appelant la méthode generatePDFOutput, sachez que vous ne pouvez pas fusionner des données avec un formulaire PDF XFA signé ou certifié. (Voir Signature numérique et certification de documents.)

NOTE

La méthode getRecordLevelMetaDataList de l’objet OutputResult renvoie null.

NOTE

Vous pouvez également créer un document PDF en appelant la méthode generatePDFOutput2 de l’objet OutputClient. (Voir Transmettre des documents situés dans Content Services (obsolète) vers le service Output.)

Récupérer les résultats de l’opération.

• Récupération d’un objet com.adobe.idp.Document qui représente le statut de l’opération generatePDFOutput en appelant la méthode getStatusDoc de l’objet OutputResult. Cette méthode renvoie des données XML de statut qui spécifient si l’opération a réussi.
• Créez un objet java.io.File contenant les résultats de l’opération. Assurez-vous que l’extension du nom du fichier est .xml.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu d’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document qui a été renvoyé par la méthode getStatusDoc).

Bien que le service Output écrive le document PDF à l’emplacement spécifié par l’argument transmis à la méthode setFileURI de l’objet PDFOutputOptionsSpec, vous pouvez récupérer le document PDF/A par programmation en appelant la méthode getGeneratedDoc de l’objet OutputResult.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

Remplacer localhost* avec l’adresse IP du serveur hébergeant AEM Forms. *

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Attribuez le nom d’utilisateur AEM forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ OutputServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Référencez une source de données XML.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker les données XML qui seront fusionnées avec le document PDF.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du fichier XML contenant les données de formulaire.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Définir les options d’exécution du PDF

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option URI du fichier en attribuant une valeur de chaîne qui spécifie l’emplacement du fichier PDF généré par le service Output au membre de données fileURI de l’objet PDFOutputOptionsSpec. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.

Définissez les options d’exécution de rendu.

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Mettez en cache la conception de formulaire pour améliorer les performances du service Output en affectant la valeur true au membre de données cacheEnabled de l’objet RenderOptionsSpec.

NOTE

Vous ne pouvez pas définir la version du document PDF à l’aide de la méthode setPdfVersion de l’objet RenderOptionsSpec si le document d’entrée est un formulaire Acrobat (un formulaire créé dans Acrobat) ou un document XFA signé ou certifié. Le document PDF de sortie conserve la version PDF de départ. De même, vous ne pouvez pas définir l’option Adobe PDF balisée en appelant la méthode setTaggedPDF* de l’objet RenderOptionsSpec si le document d’entrée est un formulaire Acrobat ou un document XFA signé ou certifié.*

NOTE

Vous ne pouvez pas définir l’option PDF linéarisé à l’aide du membre linearizedPDF de l’objet RenderOptionsSpec si le document PDF d’entrée est certifié ou signé numériquement. (Voir Signature numérique de documents PDF.)

Générez un document PDF.

Créez un document PDF en appelant la méthode generatePDFOutput de l’objet OutputServiceService et en transmettant les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet BLOB contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.
• Objet BLOB qui est renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).
• Objet BLOB renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec les données de résultat. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).
• Objet OutputResult contenant les résultats de l’opération. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).

NOTE

Lorsque vous générez un document PDF en appelant la méthode generatePDFOutput, sachez que vous ne pouvez pas fusionner des données avec un formulaire PDF XFA signé ou certifié. (Voir Signer et certifier numériquement des documents.)

NOTE

Vous pouvez également créer un document PDF en appelant la méthode generatePDFOutput2 de l’objet OutputClient. (Voir Transmettre des documents situés dans Content Services (obsolète) vers le service Output.)

Récupérer les résultats de l’opération.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant un emplacement de fichier XML contenant les données de résultat. Assurez-vous que l’extension du nom du fichier est .xml.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB qui a été rempli de données de résultat par la méthode generatePDFOutput de l’objet OutputServiceService (le huitième paramètre). Renseignez le tableau d’octets en obtenant la valeur de field MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Ecrivez le contenu du tableau d’octets dans le fichier XML en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Voir également

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet client Output.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Référencez une source de données XML.

• Créez un objet java.io.FileInputStream qui représente la source de données XML utilisée pour remplir le document PDF/A en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du fichier XML.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Définissez les options d’exécution PDF/A.

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option URI du fichier en appelant la méthode setFileURI de l’objet PDFOutputOptionsSpec. Transmettez une valeur string qui spécifie l’emplacement du fichier PDF généré par le service Output. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.

Définissez les options d’exécution de rendu.

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Définissez la valeur PDFAConformance en appelant la méthode setPDFAConformance de l’objet RenderOptionsSpec et en transmettant la valeur d’énumération PDFAConformance qui spécifie le niveau de conformité. Par exemple, pour spécifier le niveau de conformité A, transmettez PDFAConformance.A.
• Définissez la valeur PDFARevisionNumber en appelant la méthode setPDFARevisionNumber de l’objet RenderOptionsSpec et en transmettant PDFARevisionNumber.Revision_1.

NOTE

La version PDF d’un document PDF/A est 1.4, quelle que soit la valeur que vous spécifiez pour la méthode setPdfVersionde l’objetRenderOptionsSpec.

Générez un document PDF/A.

Créez un document PDF/A en appelant la méthode generatePDFOutput de l’objet OutputClient et en transmettant les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF/A, spécifiez TransformationFormat.PDFA.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet com.adobe.idp.Document contenant la source de données XML où se trouvent les données à fusionner avec la conception de formulaire.

La méthode generatePDFOutput renvoie un objet OutputResult contenant les résultats de l’authentification.

NOTE

La méthode getRecordLevelMetaDataList de l’objet OutputResult renvoie null*. *

NOTE

Vous pouvez également créer un document PDF/A en appelant la méthode generatePDFOutput 2 de l’objet OutputClient. (Voir Transmettre des documents situés dans Content Services (obsolète) vers Output Service.)

Récupérer les résultats de l’opération.

• Créez un objet com.adobe.idp.Document qui représente l’état de la méthode generatePDFOutput en appelant la méthode getStatusDoc de l’objet OutputResult.
• Créez un objet java.io.File qui contient les résultats de l’opération. Assurez-vous que l’extension du nom du fichier est .xml.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document qui a été renvoyé par la méthode getStatusDoc).

NOTE

Bien que le service Output écrive le document PDF/A à l’emplacement spécifié par l’argument transmis à la variable PDFOutputOptionsSpec de setFileURI , vous pouvez récupérer le document PDF/A par programmation en appelant la méthode OutputResult de getGeneratedDoc* method.*

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

Remplacer localhost* avec l’adresse IP du serveur hébergeant AEM Forms. *

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Attribuez le nom d’utilisateur AEM forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ OutputServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Référencez une source de données XML.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker les données qui seront fusionnées avec le document PDF/A.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF à chiffrer et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Définissez les options d’exécution du PDF/A.

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option URI du fichier en attribuant une valeur string qui spécifie l’emplacement du fichier PDF généré par le service Output au membre de données fileURI de l’objet PDFOutputOptionsSpec. L’option URI du fichier est relative au serveur d’applications J2EE hébergeant AEM Forms, et non à l’ordinateur client.

Définissez les options d’exécution de rendu.

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Définissez la valeur PDFAConformance en attribuant une valeur d’énumération PDFAConformance au membre de données PDFAConformance de l’objet RenderOptionsSpec. Par exemple, pour spécifier le niveau de conformité A, affectez PDFAConformance.A à ce membre de données.
• Définissez la valeur PDFARevisionNumber en attribuant une valeur d’énumération PDFARevisionNumber au membre de données PDFARevisionNumber de l’objet RenderOptionsSpec. Affectez PDFARevisionNumber.Revision_1 à ce membre de données.

NOTE

La version PDF d’un document PDF/A est 1.4, quelle que soit la valeur que vous indiquez.

Générez un document PDF/A.

Créez un document PDF en appelant la méthode generatePDFOutput de l’objet OutputServiceService et en transmettant les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDFA.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet BLOB contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.
• Objet BLOB qui est renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
• Objet BLOB renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec les données de résultat. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
• Objet OutputResult contenant les résultats de l’opération. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)

NOTE

Vous pouvez également créer un document PDF/A en appelant la méthode generatePDFOutput 2 de l’objet OutputClient. (Voir Transmettre des documents situés dans Content Services (obsolète) vers Output Service.)

Récupérer les résultats de l’opération.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant un emplacement de fichier XML contenant les données de résultat. Assurez-vous que l’extension du nom du fichier est .xml.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB qui a été renseigné avec les données de résultat de la méthode generatePDFOutput de l’objet OutputServiceService. Renseignez le tableau d’octets en obtenant la valeur du champ MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans le fichier XML en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet d’API Output et Document Management Client.

• 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 OutputClient 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.

Récupérez la conception de formulaire auprès de Content Services (obsolète).

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

• Valeur string qui spécifie le magasin où le contenu est ajouté. Le magasin par défaut est SpacesStore. Cette valeur est un paramètre obligatoire.
• Valeur string qui spécifie le chemin d’accès complet du contenu à récupérer (par exemple /Company Home/Form Designs/Loan.xdp). Cette valeur est un paramètre obligatoire.
• Valeur string 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. Récupérez une instance com.adobe.idp.Document en appelant la méthode getDocument de l’objet CRCResult.

Générez le formulaire PDF non interactif.

Appelez la méthode generatePDFOutput2 de l’objet OutputClient et transmettez les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez le TransformationFormat.PDF.
• Valeur string qui spécifie la racine de contenu où se trouvent les ressources supplémentaires telles que les images.
• Objet com.adobe.idp.Document représentant la conception de formulaire (utilisez l’instance renvoyée par la méthode getDocument de l’objet CRCResult).
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet com.adobe.idp.Document contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.

La méthode generatePDFOutput2 renvoie un objet OutputResult contenant les résultats de l’authentification.

Exécutez une action avec le flux de données de formulaire.

• Récupérez un objet com.adobe.idp.Document qui représente le formulaire non interactif en appelant la méthode getGeneratedDoc de l’objet OutputResult.
• Créez un objet java.io.File contenant les résultats de l’opération. Assurez-vous que l’extension de nom de fichier est .pdf.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document qui a été renvoyé par la méthode getGeneratedDoc).

Incluez les fichiers de 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 Output : http://localhost:8080/soap/services/OutputService?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.

NOTE

Remplacer localhost* avec l’adresse IP du serveur hébergeant AEM Forms. *

Créez un objet d’API Output et Document Management Client.

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

• Créez un objet OutputServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur de chaîne qui spécifie le WSDL au service Forms (par exemple, http://localhost:8080/soap/services/OutputService?blob=mtom). Il n’est pas nécessaire 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 OutputServiceClient.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 :

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

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

NOTE

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

Récupérez la conception de formulaire auprès de Content Services (obsolète).

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

• Valeur string qui spécifie le magasin où le contenu est ajouté. Le magasin par défaut est SpacesStore. Cette valeur est un paramètre obligatoire.
• Valeur string qui spécifie le chemin d’accès complet du contenu à récupérer (par exemple /Company Home/Form Designs/Loan.xdp). Cette valeur est un paramètre obligatoire.
• Valeur string 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 string qui stocke la valeur du lien de navigation.
• Paramètre de sortie BLOB stockant le contenu. Vous pouvez utiliser ce paramètre de sortie pour récupérer le contenu.
• Paramètre de sortie ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType stockant les attributs de contenu.
• Paramètre de sortie CRCResult. Au lieu d’utiliser cet objet, vous pouvez utiliser le paramètre de sortie BLOB pour récupérer le contenu.

Générez le formulaire PDF non interactif.

Appelez la méthode generatePDFOutput2 de l’objet OutputServiceClient et transmettez les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez le TransformationFormat.PDF.
• Valeur string qui spécifie la racine de contenu où se trouvent les ressources supplémentaires telles que les images.
• Objet BLOB représentant la conception de formulaire (utilisez l’instance BLOB renvoyée par Content Services (obsolète)).
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet BLOB contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.
• Objet BLOB de sortie qui est renseigné par la méthode generatePDFOutput2. La méthode generatePDFOutput2 renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).
• Un objet OutputResult de sortie contenant les résultats de l’opération. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).

La méthode generatePDFOutput2 renvoie un objet BLOB contenant le formulaire PDF non interactif.

Exécutez une action avec le flux de données de formulaire.

• Créez un objet 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.
• Créez un tableau d’octets qui stocke le contenu de l’objet BLOB récupéré à partir de la méthode generatePDFOutput2. 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 utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-repository-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet d’API Output et Document Management Client.

• 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 OutputClient 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.

Récupérez la conception de formulaire à partir du référentiel AEM Forms.

Appelez la méthode readResourceContent de l’objet ResourceRepositoryClient et transmettez une valeur string qui spécifie l’emplacement URI au fichier XDP. Par exemple, /Applications/FormsApplication/1.0/FormsFolder/Loan.xdp. Cette valeur n’est pas obligatoire. Cette méthode renvoie une instance com.adobe.idp.Document qui représente le fichier XDP.

Générez le formulaire PDF non interactif.

Appelez la méthode generatePDFOutput2 de l’objet OutputClient et transmettez les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string qui spécifie la racine de contenu où se trouvent les ressources supplémentaires telles que les images. Par exemple, repository:///Applications/FormsApplication/1.0/FormsFolder/.
• Objet com.adobe.idp.Document représentant la conception de formulaire (utilisez l’instance renvoyée par la méthode readResourceContent de l’objet ResourceRepositoryClient).
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet com.adobe.idp.Document contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.

La méthode generatePDFOutput2 renvoie un objet OutputResult contenant les résultats de l’authentification.

Exécutez une action avec le flux de données de formulaire.

• Récupérez un objet com.adobe.idp.Document qui représente le formulaire non interactif en appelant la méthode getGeneratedDoc de l’objet OutputResult.
• Créez un objet java.io.File contenant les résultats de l’opération. Assurez-vous que l’extension de nom de fichier est .pdf.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document qui a été renvoyé par la méthode getGeneratedDoc).

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet client Output et Assembler.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
• Créez un objet AssemblerServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Utilisez le service Assembler pour générer la conception de formulaire.

Appelez la méthode invokeDDX de l’objet AssemblerServiceClient et transmettez les valeurs requises suivantes :

• Objet com.adobe.idp.Document représentant le document DDX à utiliser.
• Objet java.util.Map contenant les fichiers XDP d’entrée.
• Objet com.adobe.livecycle.assembler.client.AssemblerOptionSpec spécifiant les options d’exécution, y compris la police par défaut et le niveau de journalisation de la tâche.

La méthode invokeDDX renvoie un objet com.adobe.livecycle.assembler.client.AssemblerResult contenant le document XDP assemblé. Pour récupérer le document XDP assemblé, effectuez les actions suivantes :

• Appelez la méthode getDocuments de l’objet AssemblerResult. Cette méthode renvoie un objet java.util.Map.
• Effectuez une itération à l’aide de l’objet java.util.Map jusqu’à ce que vous trouviez l’objet com.adobe.idp.Document résultant.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour extraire le document XDP assemblé.

Utilisez le service Output pour générer le document PDF.

Appelez la méthode generatePDFOutput2 de l’objet OutputClient et transmettez les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string qui spécifie la racine de contenu où se trouvent les ressources supplémentaires, telles que les images.
• Objet com.adobe.idp.Document représentant la conception de formulaire (utilisez l’instance renvoyée par le service Assembler).
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet com.adobe.idp.Document contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.

La méthode generatePDFOutput2 renvoie un objet OutputResult contenant les résultats de l’authentification.

Enregistrez le document PDF au format PDF.

• Récupérez un objet com.adobe.idp.Document qui représente le document PDF en appelant la méthode getGeneratedDoc de l’objet OutputResult.
• Créez un objet java.io.File contenant les résultats de l’opération. Assurez-vous que l’extension de nom de fichier est .pdf.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier. (Assurez-vous d’utiliser l’objet com.adobe.idp.Document renvoyé par la méthode getGeneratedDoc).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Utilisez la définition WSDL suivante pour la référence de service associée au service Output :

 http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

Utilisez la définition WSDL suivante pour la référence de service associée au service Assembler :

 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

Parce que le type de données BLOB est commun aux deux références de service, qualifiez 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.

NOTE

Remplacer localhost* avec l’adresse IP du serveur hébergeant AEM Forms. *

Créez un objet client Output et Assembler.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Affectez le nom d’utilisateur AEM Forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Affectez la valeur de mot de passe correspondante au champ OutputServiceClient.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.

NOTE

Répétez ces étapes pour le AssemblerServiceClient* objet. *

Utilisez le service Assembler pour générer la conception de formulaire.

Appelez la méthode invokeDDX de l’objet AssemblerServiceClient et transmettez les valeurs suivantes :

• Objet BLOB représentant le document DDX.
• Objet MyMapOf_xsd_string_To_xsd_anyType contenant les fichiers requis.
• Objet AssemblerOptionSpec qui spécifie les options d’exécution.

La méthode invokeDDX renvoie un objet AssemblerResult contenant les résultats de la tâche et les exceptions survenues. Pour obtenir le document XDP nouvellement créé, effectuez les actions suivantes :

• Accédez au champ documents de l’objet AssemblerResult, qui est un objet Map contenant les documents PDF générés.
• Effectuez une itération à l’aide de l’objet Map pour récupérer la conception de formulaire assemblée. Transformez la value de ce membre de tableau en un BLOB. Transmettez l’instance BLOB au service Output.

Utilisez le service Output pour générer le document PDF.

Appelez la méthode generatePDFOutput2 de l’objet OutputServiceClient et transmettez les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string qui spécifie la racine de contenu où se trouvent les ressources supplémentaires, telles que les images.
• Objet BLOB représentant la conception de formulaire (utilisez l’instance BLOB renvoyée par le service Assembler).
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet BLOB contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.
• Objet BLOB de sortie renseigné par la méthode generatePDFOutput2. La méthode generatePDFOutput2 renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).
• Un objet OutputResult de sortie contenant les résultats de l’opération. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).

La méthode generatePDFOutput2 renvoie un objet BLOB contenant le formulaire PDF non interactif.

Enregistrez le document PDF au format PDF.

• Créez un objet 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.
• Créez un tableau d’octets qui stocke le contenu de l’objet BLOB récupéré à partir de la méthode generatePDFOutput2. 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 utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels que adobe-output-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet client Output.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Référencez une source de données XML.

• Créez un objet java.io.FileInputStream qui représente la source de données XML utilisée pour renseigner le document en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du fichier XML.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Définissez les options d’exécution d’impression requises pour l’impression dans un fichier.

• Créez un objet PrintedOutputOptionsSpec en utilisant son constructeur.
• Spécifiez le fichier en appelant la méthode setFileURI de l’objet PrintedOutputOptionsSpec et en transmettant une valeur de chaîne qui représente le nom et l’emplacement du fichier. Par exemple, si vous souhaitez que le service Output s’imprime dans un fichier PostScript nommé* MortgageForm.ps* situé dans C:\Adobe, spécifiez C:\Adobe\MortgageForm.ps.
• Spécifiez le nombre de copies à imprimer en appelant la méthode setCopies de lʼobjet PrintedOutputOptionsSpec et en transmettant une valeur sous forme dʼentier qui représente le nombre de copies.

Imprimer le flux d’impression dans un fichier.

Imprimez dans un fichier en appelant la méthode generatePrintedOutput de lʼobjet OutputClient et en transmettant les valeurs suivantes :

• Une valeur d’énumération PrintFormat qui spécifie le format du flux d’impression à créer. Par exemple, pour créer un flux d’impression PostScript, transmettez PrintFormat.PostScript.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie l’emplacement des fichiers associés, tels que les fichiers image.
• Une valeur de chaîne qui spécifie l’emplacement du fichier XDC à utiliser (vous pouvez transmettre null si vous avez spécifié le fichier XDC à utiliser à l’aide de lʼobjet PrintedOutputOptionsSpec).
• Lʼobjet PrintedOutputOptionsSpec contenant les options d’exécution requises pour l’impression dans un fichier.
• Lʼobjet com.adobe.idp.Document contenant la source de données XML qui contient les données de formulaire.

La méthode generatePrintedOutput renvoie un objet OutputResult contenant les résultats de l’opération.

NOTE

La méthode getRecordLevelMetaDataList de l’objet OutputResult renvoie null*. *

Récupérer les résultats de l’opération.

• Créez un objet com.adobe.idp.Document qui représente le statut de la méthode generatePrintedOutput en appelant la méthode getStatusDoc de lʼobjet OutputResult (lʼobjet OutputResult a été renvoyé par la méthode generatePrintedOutput).
• Créez un objet java.io.File qui contiendra les résultats de l’opération. Assurez-vous que l’extension de fichier est XML.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document qui a été renvoyé par la méthode getStatusDoc).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

Remplacer localhost* avec l’adresse IP du serveur hébergeant AEM Forms. *

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Attribuez le nom d’utilisateur AEM forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ OutputServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Référencez une source de données XML.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker des données de formulaire.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du fichier XML contenant les données de formulaire.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à sa propriété binaryData le contenu du tableau d’octets.

Définissez les options d’exécution d’impression requises pour l’impression dans un fichier.

• Créez un objet PrintedOutputOptionsSpec en utilisant son constructeur.
• Spécifiez le fichier en attribuant une valeur de chaîne représentant l’emplacement et le nom du fichier au membre de données fileURI de l’objet PrintedOutputOptionsSpec. Par exemple, si vous souhaitez que le service Output imprime un fichier PostScript appelé MortgageForm.ps situé dans C:\Adobe, indiquez C:\Adobe\MortgageForm.ps.
• Indiquez le nombre de copies à imprimer en attribuant une valeur entière représentant le nombre de copies aux membres des données copies de l’objet PrintedOutputOptionsSpec.

Imprimer le flux d’impression dans un fichier.

Imprimez dans un fichier en appelant la méthode generatePrintedOutput de lʼobjet OutputServiceService et en transmettant les valeurs suivantes :

• Une valeur d’énumération PrintFormat qui spécifie le format du flux d’impression à créer. Par exemple, pour créer un flux d’impression PostScript, transmettez PrintFormat.PostScript.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie l’emplacement des fichiers associés, tels que les fichiers image.
• Une valeur de chaîne qui spécifie l’emplacement du fichier XDC à utiliser (vous pouvez transmettre null si vous avez spécifié le fichier XDC à utiliser à l’aide de l’objet PrintedOutputOptionsSpec).
• Objet PrintedOutputOptionsSpec qui contient les options d’exécution de l’impression requises pour imprimer un fichier.
• Objet BLOB qui contient la source de données XML contenant les données du formulaire.
• Un objet BLOB est renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
• Objet BLOB renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec les données de résultat. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
• Objet OutputResult contenant les résultats de l’opération. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)

Récupérer les résultats de l’opération.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne qui représente un emplacement de fichier XML contenant les données de résultat. Assurez-vous que l’extension de fichier est XML.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB ayant été renseigné avec les données de résultat par la méthode generatePDFOutput de l’objet OutputServiceService (le huitième paramètre). 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 utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans le fichier XML en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels que adobe-output-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créer un objet client de sortie

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Référencer une source de données XML

• Créez un objet java.io.FileInputStream qui représente la source de données XML utilisée pour remplir le document en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du fichier XML.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Définir les options d’exécution de l’impression

Créez un objet PrintedOutputOptionsSpec qui représente les options d’exécution d’impression. Par exemple, vous pouvez spécifier le nombre de copies à imprimer en appelant la méthode setCopies de l’objet PrintedOutputOptionsSpec.

NOTE

Vous ne pouvez pas définir la valeur de pagination en utilisant la méthode setPagination de l’objet PrintedOutputOptionsSpec si vous générez un flux d’impression ZPL. De même, vous ne pouvez pas définir les options suivantes pour un flux d’impression ZPL : OutputJog, PageOffset et Staple. Le setPagination* n’est pas valide pour la génération PostScript. Il est valide uniquement pour la génération PCL. *

Récupérer un document à imprimer

• Récupérez un document à imprimer en appelant la méthode generatePrintedOutput de l’objet OutputClient et en transmettant les valeurs suivantes :

  • Valeur d’énumération PrintFormat spécifiant le flux d’impression. Par exemple, pour créer un flux d’impression PostScript, transmettez PrintFormat.PostScript.
  • Valeur string spécifiant le nom de la nouvelle conception de formulaire.
  • Valeur de chaîne qui spécifie l’emplacement des fichiers collatéraux associés, tels que les fichiers image.
  • Valeur de chaîne qui spécifie l’emplacement du fichier XDC à utiliser.
  • Objet PrintedOutputOptionsSpec contenant les options d’exécution requises pour être imprimé dans un fichier.
  • Objet com.adobe.idp.Document représentant la source de données XML qui contient les données de formulaire à fusionner avec la conception de formulaire.

  Cette méthode renvoie un objet OutputResult contenant les résultats de l’opération.

• Créez un objet com.adobe.idp.Document à envoyer à l’imprimante en appelant la méthode getGeneratedDoc de l’objet OutputResult. Cette méthode renvoie un objet com.adobe.idp.Document.

Envoyer le flux d’impression vers une imprimante réseau

Envoyez le flux d’impression à une imprimante réseau en appelant la méthode sendToPrinter de l’objet OutputClient et en transmettant les valeurs suivantes :

• Objet com.adobe.idp.Document représentant le flux d’impression à envoyer à l’imprimante.
• Une valeur d’énumération PrinterProtocol spécifiant le protocole d’imprimante à utiliser. Par exemple, pour spécifier le protocole SharedPrinter, transmettez PrinterProtocol.SharedPrinter.
• Valeur de chaîne spécifiant le nom du serveur d’impression. En supposant, par exemple, que le nom du serveur d’impression soit PrintServer1, transmettez \\\PrintSever1.
• Valeur de chaîne qui spécifie le nom de l’imprimante. Par exemple, en supposant que le nom de l’imprimante soit Printer1, transmettez \\\PrintSever1\Printer1.

NOTE

La méthode sendToPrinter a été ajoutée à l’API AEM Forms dans la version 8.2.1.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

Remplacer localhost* avec l’adresse IP du serveur hébergeant AEM Forms. *

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Attribuez le nom d’utilisateur AEM forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ OutputServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Référencez une source de données XML.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker des données de formulaire.
• Créez un objet System.IO.FileStream en utilisant son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement du fichier XML contenant les données de formulaire.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Déterminez la longueur du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant son champ MTOM au contenu du tableau d’octets.

Définissez les options d’exécution de l’impression.

Créez un objet PrintedOutputOptionsSpec en utilisant son constructeur. Par exemple, vous pouvez spécifier le nombre de copies à imprimer en attribuant une valeur entière qui représente le nombre de copies au membre de données copies de l’objet PrintedOutputOptionsSpec.

NOTE

Vous ne pouvez pas définir la valeur de pagination à l’aide du membre de données pagination de l’objet PrintedOutputOptionsSpec si vous générez un flux d’impression ZPL. De même, vous ne pouvez pas définir les options suivantes pour un flux d’impression ZPL : OutputJog, PageOffset et Staple. Le pagination* Le membre de données n’est pas valide pour la génération PostScript. Il est valide uniquement pour la génération PCL. *

Récupérez un document à imprimer.

• Récupérez un document à imprimer en appelant la méthode generatePrintedOutput de l’objet OutputServiceService et en transmettant les valeurs suivantes :

  • Valeur d’énumération PrintFormat spécifiant le flux d’impression. Par exemple, pour créer un flux d’impression PostScript, transmettez PrintFormat.PostScript.
  • Valeur string spécifiant le nom de la nouvelle conception de formulaire.
  • Valeur de chaîne qui spécifie l’emplacement des fichiers collatéraux associés, tels que les fichiers image.
  • Valeur de chaîne qui spécifie l’emplacement du fichier XDC à utiliser.
  • L’objet PrintedOutputOptionsSpec contenant les options d’exécution de l’impression utilisées lors de l’envoi d’un flux d’impression vers une imprimante réseau.
  • L’objet BLOB contenant la source de données XML contenant les données de formulaire.
  • Un objet BLOB est renseigné par la méthode generatePrintedOutput. La méthode generatePrintedOutput renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
  • Objet BLOB renseigné par la méthode generatePrintedOutput. La méthode generatePrintedOutput renseigne cet objet avec les données de résultat. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
  • Objet OutputResult contenant les résultats de l’opération. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)

• Créez un objet BLOB à envoyer à l’imprimante en obtenant la valeur de la méthode generatedDoc de l’objet OutputResult. Cette méthode renvoie un objet BLOB qui contient des données PostScript renvoyées par la méthode generatePrintedOutput.

Envoyez le flux d’impression à une imprimante réseau.

Envoyez le flux d’impression à une imprimante réseau en appelant la méthode sendToPrinter de l’objet OutputClient et en transmettant les valeurs suivantes :

• Objet BLOB représentant le flux d’impression à envoyer à l’imprimante.
• Une valeur d’énumération PrinterProtocol spécifiant le protocole d’imprimante à utiliser. Par exemple, pour spécifier le protocole SharedPrinter, transmettez PrinterProtocol.SharedPrinter.
• Valeur bool spécifiant s’il faut utiliser la valeur du paramètre précédent. Transmettez la valeur true. (Cette valeur de paramètre est requise pour l’appel de service web uniquement.)
• Valeur de chaîne spécifiant le nom du serveur d’impression. Par exemple, en supposant que le nom du serveur d’impression soit PrintServer1, transmettez \\\PrintSever1.
• Valeur de chaîne qui spécifie le nom de l’imprimante. Par exemple, en supposant que le nom de l’imprimante soit Printer1, transmettez \\\PrintSever1\Printer1.

NOTE

La méthode sendToPrinter a été ajoutée à l’API AEM Forms dans la version 8.2.1.

Inclure les fichiers de projet

Incluez les fichiers JAR du client, tels que adobe-output-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créer un objet client de sortie

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Référencer une source de données XML

• Créez un objet java.io.FileInputStream qui représente la source de données XML contenant plusieurs enregistrements en utilisant son constructeur et en transmettant une valeur de chaîne qui indique l’emplacement du fichier XML.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Définir les options d’exécution du PDF

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option Many Files en appelant la méthode setGenerateManyFiles de lʼobjet PDFOutputOptionsSpec. Par exemple, transmettez la valeur true pour demander au service Output de créer un fichier PDF distinct pour chaque enregistrement de la source de données XML. (Si vous transmettez false, le service Output génère un document PDF unique contenant tous les enregistrements).
• Définissez l’option File URI en appelant la méthode setFileUri de lʼobjet PDFOutputOptionsSpec et en transmettant une valeur de chaîne qui spécifie l’emplacement des fichiers générés par le service Output. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.
• Définissez l’option Record Name en appelant la méthode setRecordName de lʼobjet OutputOptionsSpec et en transmettant une valeur de chaîne qui spécifie le nom de l’élément XML dans la source de données qui sépare les enregistrements de données. (Consultez l’exemple de source de données XML présenté plus haut dans cette section. Le nom de l’élément XML qui sépare les enregistrements de données est LoanRecord).

Définir des options d’exécution de rendu

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Mettez en cache la conception de formulaire pour améliorer les performances du service Output en appelant la méthode setCacheEnabled de lʼobjet RenderOptionsSpec et en transmettant une valeur Boolean de true.

Générer plusieurs fichiers PDF

Générez plusieurs fichiers PDF en appelant la méthode generatePDFOutput de lʼobjet OutputClient et en transmettant les valeurs suivantes :

• Une valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet com.adobe.idp.Document contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.

La méthode generatePDFOutput renvoie un objet OutputResult contenant les résultats de l’opération.

Récupérer les résultats de l’opération

• Créez un objet java.io.File qui représente un fichier XML qui contiendra les résultats de la méthode generatePDFOutput. Assurez-vous que l’extension du nom du fichier est .xml.
• Appelez la méthode copyToFile de lʼobjet com.adobe.idp.Document pour copier le contenu de lʼobjet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser lʼobjet com.adobe.idp.Document renvoyé par la méthode applyUsageRights).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

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

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Attribuez le nom d’utilisateur AEM forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ OutputServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Référencez une source de données XML.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker des données de formulaire contenant plusieurs enregistrements.
• Créez un objet System.IO.FileStream en utilisant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier XML qui contient plusieurs enregistrements.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Définissez les options d’exécution du PDF.

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option Fichiers multiples en attribuant une valeur booléenne au membre de données generateManyFiles de l’objet OutputOptionsSpec. Par exemple, affectez la valeur true à ce membre de données pour demander au service Output de créer un fichier PDF distinct pour chaque enregistrement de la source de données XML. (Si vous affectez false à ce membre de données, le service Output génère un seul PDF contenant tous les enregistrements.)
• Définissez l’option URI du fichier en attribuant une valeur string qui spécifie l’emplacement du ou des fichiers générés par le service Output au membre de données fileURI de l’objet OutputOptionsSpec. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.
• Définissez l’option de nom d’enregistrement en attribuant une valeur string qui spécifie le nom de l’élément XML dans la source de données qui sépare les enregistrements de données au membre de données recordName de l’objet OutputOptionsSpec.
• Définissez l’option Copies en attribuant une valeur entière qui spécifie le nombre de copies générées par le service Output au membre de données copies de l’objet OutputOptionsSpec.

Définissez les options d’exécution de rendu.

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Mettez en cache la conception de formulaire pour améliorer les performances du service Output en affectant la valeur true au membre de données cacheEnabled de l’objet RenderOptionsSpec.

Générez plusieurs fichiers PDF.

Créez plusieurs fichiers PDF en appelant la méthode generatePDFOutput de l’objet OutputServiceService et en transmettant les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet BLOB contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.
• Objet BLOB renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec des métadonnées générées qui décrivent le document.
• Objet BLOB renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec les données de résultat.
• Objet OutputResult contenant les résultats de l’opération.

Récupérer les résultats de l’opération

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente un emplacement de fichier XML contenant les données de résultat. Assurez-vous que l’extension du nom du fichier est .xml.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB qui a été renseigné avec les données de résultat de la méthode generatePDFOutput de l’objet OutputServiceService (le huitième paramètre). Renseignez le tableau d’octets en obtenant la valeur du membre de données binaryData de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans le fichier XML en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet client Output.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Référencez une source de données XML.

• Créez un objet java.io.FileInputStream qui représente la source de données XML utilisée pour remplir le document PDF en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du fichier XML.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Définissez des règles de recherche.

• Créez un objet Rule en utilisant son constructeur.
• Définissez un modèle de texte en appelant la méthode setPattern de l’objet Rule et en transmettant une valeur de chaîne qui indique un modèle de texte.
• Définissez la conception de formulaire correspondante en appelant la méthode setForm de l’objet Rule. Transmettez une valeur de chaîne spécifiant le nom de la nouvelle conception de formulaire.

NOTE

Pour chaque modèle de texte à définir, répétez les trois sous-étapes précédentes.

• Créez un objet java.util.List en utilisant un constructeur java.util.ArrayList.
• Pour chaque objet Rule que vous avez créé, appelez la méthode add de l’objet java.util.List et transmettez l’objet Rule.

Définissez les options d’exécution du PDF.

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Indiquez le nom et l’emplacement du fichier PDF généré par le service Output en appelant la méthode setFileURI de l’objet PDFOutputOptionsSpec. Transmettez une valeur de chaîne qui spécifie l’emplacement du fichier PDF. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.
• Définissez les règles que vous avez définies en appelant la méthode setRules de l’objet PDFOutputOptionsSpec. Transmettez l’objet java.util.List contenant les objets Rule.
• Définissez le nombre d’octets à analyser pour les modèles de texte définis en appelant la méthode setLookAhead de l’objet PDFOutputOptionsSpec. Transmettez une valeur entière qui représente le nombre d’octets.

Définissez les options d’exécution de rendu.

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Mettez en cache la conception de formulaire afin d’améliorer les performances du service Output en appelant setCacheEnabled de l’objet RenderOptionsSpec et en transmettant true.

Générez un document PDF.

Générez un document PDF basé sur plusieurs conceptions de formulaire en appelant la méthode generatePDFOutput de l’objet OutputClient et en transmettant les valeurs suivantes :

• Une valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Une valeur de chaîne spécifiant le nom de la conception de formulaire par défaut. En d’autres termes, la conception de formulaire utilisée si aucun modèle de texte n’est localisé.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouvent les conceptions de formulaire.
• Un objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Un objet RenderOptionsSpec contenant les options d’exécution de rendu.
• L’objet com.adobe.idp.Document contenant les données de formulaire recherchées par le service Output pour les modèles de texte définis.

La méthode generatePDFOutput renvoie un objet OutputResult contenant les résultats de l’opération.

Récupérer les résultats de l’opération.

• Créez un objet com.adobe.idp.Document qui représente l’état de la méthode generatePDFOutput en appelant la méthode getStatusDoc de l’objet OutputResult.
• Créez un objet java.io.File qui contiendra les résultats de l’opération. Assurez-vous que l’extension de fichier est .xml.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document renvoyé par la méthode getStatusDoc ).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

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

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

  • Attribuez le nom d’utilisateur AEM forms au champ OutputServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ OutputServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Référencez une source de données XML.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker les données qui seront fusionnées avec le document PDF.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF à chiffrer et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Définissez des règles de recherche.

• Créez un objet Rule en utilisant son constructeur.
• Définissez un modèle de texte en attribuant une valeur string qui spécifie un modèle de texte pour le membre de données pattern de l’objet Rule.
• Définissez la conception de formulaire correspondante en attribuant une valeur string qui spécifie la conception de formulaire pour le membre de données form de l’objet Rule.

NOTE

Pour chaque modèle de texte à définir, répétez les trois sous-étapes précédentes.

• Créez un objet MyArrayOf_xsd_anyType qui stocke les règles.
• Affectez chaque objet Rule à un élément du tableau MyArrayOf_xsd_anyType. Appelez la méthode Add de l’objet MyArrayOf_xsd_anyType pour chaque objet Rule.

Définir les options d’exécution du PDF

• Créez un objet PDFOutputOptionsSpec en utilisant son constructeur.
• Définissez l’option URI du fichier en attribuant une valeur string qui spécifie l’emplacement du fichier PDF généré par le service Output pour le membre de données fileURI de l’objet PDFOutputOptionsSpec. L’option URI du fichier concerne le serveur d’applications J2EE hébergeant AEM Forms, et non l’ordinateur client.
• Définissez l’option Copies en attribuant une valeur entière qui spécifie le nombre de copies générées par le service Output pour le membre de données copies de l’objet PDFOutputOptionsSpec.
• Définissez les règles que vous avez définies en attribuant l’objet MyArrayOf_xsd_anyType qui stocke les règles pour le membre de données rules de l’objet PDFOutputOptionsSpec.
• Définissez le nombre d’octets à analyser pour les modèles de texte définis en attribuant une valeur entière qui représente le nombre d’octets à analyser pour la méthode de données lookAhead de l’objet PDFOutputOptionsSpec.

Définir des options d’exécution de rendu

• Créez un objet RenderOptionsSpec en utilisant son constructeur.
• Mettez en cache la conception de formulaire afin d’améliorer les performances du service Output en affectant la valeur true au membre de données cacheEnabled de l’objet RenderOptionsSpec.

NOTE

Vous ne pouvez pas définir la version du document PDF à l’aide du membre de données pdfVersion de l’objet RenderOptionsSpec si le document d’entrée est un formulaire Acrobat. Le document PDF de sortie conserve la version PDF du formulaire Acrobat. De même, vous ne pouvez pas définir l’option de PDF balisé à l’aide de la méthode taggedPDF de l’objet RenderOptionsSpec si le document d’entrée est un formulaire Acrobat.

NOTE

Vous ne pouvez pas définir l’option de PDF linéarisé à l’aide du membre de données linearizedPDF de l’objet RenderOptionsSpec si le document PDF d’entrée est certifié ou signé numériquement. Pour plus d’informations, voir Signature numérique de documents PDF.

Générer un document PDF

Créez un document PDF en appelant la méthode generatePDFOutput de l’objet OutputServiceService et en transmettant les valeurs suivantes :

• Valeur d’énumération TransformationFormat. Pour générer un document PDF, spécifiez TransformationFormat.PDF.
• Valeur string spécifiant le nom de la nouvelle conception de formulaire.
• Une valeur de chaîne qui spécifie la racine de contenu où se trouve la conception de formulaire.
• Objet PDFOutputOptionsSpec contenant les options d’exécution du PDF.
• Objet RenderOptionsSpec contenant les options d’exécution de rendu.
• Objet BLOB contenant la source de données XML contenant les données à fusionner avec la conception de formulaire.
• Objet BLOB qui est renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec des métadonnées générées qui décrivent le document. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).
• Objet BLOB renseigné par la méthode generatePDFOutput. La méthode generatePDFOutput renseigne cet objet avec les données de résultat. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).
• Objet OutputResult contenant les résultats de l’opération. (Cette valeur de paramètre est requise uniquement pour l’appel du service web).

NOTE

Lors de la génération d’un document PDF en appelant la méthode generatePDFOutput, sachez que vous ne pouvez pas fusionner des données avec un formulaire PDF XFA signé, certifié ou contenant des droits d’utilisation. Pour plus d’informations sur les droits d’utilisation, voir Appliquer des droits d’utilisation aux documents PDF.

Récupérer les résultats de l’opération

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne qui représente un emplacement de fichier XML contenant les données de résultat. Assurez-vous que l’extension de fichier est XML.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB ayant été renseigné avec les données de résultat par la méthode generatePDFOutput de l’objet OutputServiceService (le huitième paramètre). 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 utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans le fichier XML en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes du projet Java.

Créez un objet client Output.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet OutputClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez un document PDF interactif.

• Créez un objet java.io.FileInputStream qui représente le document PDF interactif à transformer à l’aide de son constructeur et en transmettant une valeur string spécifiant l’emplacement du fichier PDF interactif.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Transformez le document PDF.

Transformez le document PDF interactif en document PDF non interactif en appelant la méthode transformPDF de l’objet OutputServiceService et en transmettant les valeurs suivantes :

• Objet com.adobe.idp.Document contenant le document PDF interactif.
• Valeur d’énumération TransformationFormat. Pour générer un document PDF non interactif, spécifiez TransformationFormat.PDF.
• Valeur d’énumération PDFARevisionNumber qui spécifie le numéro de révision. Comme ce paramètre est destiné à un document PDF/A, vous pouvez indiquer null.
• Valeur string qui représente le numéro de modification et l’année séparés par deux points. Comme ce paramètre est destiné à un document PDF/A, vous pouvez indiquer null.
• Valeur d’énumération PDFAConformance qui représente le niveau de conformité du PDF/A. Comme ce paramètre est destiné à un document PDF/A, vous pouvez indiquer null.

La méthode transformPDF renvoie un objet com.adobe.idp.Document contenant un document PDF non interactif.

Enregistrez le document PDF non interactif en tant que fichier PDF.

• Créez un objet java.io.File et assurez-vous que l’extension du fichier est .pdf.
• Appelez la méthode copyToFile de l’objet Document pour copier le contenu de l’objet Document dans le fichier (assurez-vous d’utiliser l’objet Document qui a été renvoyé par la méthode transformPDF).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

NOTE

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

Créez un objet client Output.

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

• Créez un objet OutputServiceClient.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/OutputService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ OutputServiceClient.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 :

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

Récupérez un document PDF interactif.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document PDF interactif.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF interactif.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à sa propriété MTOM le contenu du tableau d’octets.

Transformez le document PDF.

Transformez le document PDF interactif en document PDF non interactif en appelant la méthode transformPDF de l’objet OutputClient et en transmettant des valeurs suivantes :

• Objet BLOB contenant le document PDF interactif.
• Valeur d’énumération TransformationFormat. Pour générer un document PDF non interactif, spécifiez TransformationFormat.PDF.
• Valeur d’énumération PDFARevisionNumber qui spécifie le numéro de révision.
• Valeur booléenne qui spécifie si la valeur d’énumération PDFARevisionNumber est utilisée. Comme ce paramètre est destiné à un document PDF/A, vous pouvez indiquer false.
• Valeur string qui représente le numéro de modification et l’année séparés par deux points. Comme ce paramètre est destiné à un document PDF/A, vous pouvez indiquer null.
• Valeur d’énumération PDFAConformance qui représente le niveau de conformité du PDF/A.
• Valeur booléenne qui spécifie si la valeur d’énumération PDFAConformance est utilisée. Comme ce paramètre est destiné à un document PDF/A, vous pouvez indiquer false.

La méthode transformPDF renvoie un objet BLOB contenant un document PDF non interactif.

Enregistrez le document PDF non interactif en tant que fichier PDF.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF non interactif.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB qui a été renvoyé par la méthode transformPDF. 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 utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.