Transmettre des documents au service Forms passing-documents-to-the-formsservice

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

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

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 :

• 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 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 :

• Un objet com.adobe.idp.Document contenant la conception du formulaire récupéré à partir de Content Services (obsolète).
• Un objet com.adobe.idp.Document qui contient les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données, transmettez un objet com.adobe.idp.Document.
• Un objet 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.
• Un objet URLSpec qui contient des valeurs URI. Cette valeur est un paramètre facultatif. Vous pouvez spécifier null.
• Un objet 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

• Créez un objet com.adobe.idp.Document en appelant la méthode getOutputContent de l’objet FormsResult.
• Accédez au type de contenu de l’objet com.adobe.idp.Document en appelant sa méthode getContentType.
• Définissez le type de contenu de l’objet javax.servlet.http.HttpServletResponse en appelant sa méthode setContentType et en transmettant le type de contenu de l’objet com.adobe.idp.Document.
• Créez un objet javax.servlet.ServletOutputStream utilisé pour écrire le flux de données de formulaire dans le navigateur web client en appelant la méthode getOutputStream de l’objet javax.servlet.http.HttpServletResponse.
• Créez un objet java.io.InputStream en appelant la méthode getInputStream de l’objet com.adobe.idp.Document.
• Créez un tableau d’octets et renseignez-le avec le flux de données du formulaire en appelant la méthode read de l’objet InputStream. Transmettez le tableau d’octets comme argument.
• Appelez la méthode 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.

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.

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 :

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

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

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 :

• 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.
• Un paramètre de sortie CRCResult. Au lieu d’utiliser cet objet, vous pouvez utiliser le paramètre de sortie BLOB pour obtenir le contenu.

Effectuer le rendu d’un formulaire PDF interactif

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

• Un objet BLOB contenant la conception du formulaire récupéré à partir de Content Services (obsolète).
• Un objet BLOB qui contient les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données, transmettez un objet BLOB.
• Un objet 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.
• Un objet URLSpec qui contient des valeurs URI. Cette valeur est un paramètre facultatif. Vous pouvez spécifier null.
• Un objet 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.
• Un paramètre de sortie long qui est utilisé pour stocker le nombre de pages.
• Un paramètre de sortie de chaîne qui est utilisé pour stocker la valeur des paramètres régionaux.
• Un paramètre de sortie 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

• Créez un objet BLOB qui contient des données de formulaire en obtenant la valeur du champ outputContent de l’objet FormsResult.
• 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é dans l’objet FormsResult. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en 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.