Conversion de Postscript en documents PDF

Les exemples et les exemples de ce document sont réservés à l’environnement AEM Forms on JEE.

À propos du service Distiller

Le service Distiller® convertit les fichiers PostScript®, Encapsulated PostScript (EPS) et PRN en fichiers PDF compacts, fiables et plus sécurisés sur un réseau. Ce service est généralement utilisé pour convertir en documents électroniques d’importants volumes de documents papier, tels que des factures et des déclarations. La conversion de documents en PDF permet également aux entreprises d’envoyer à leurs clients un document à la fois dans sa version papier et dans sa version électronique.

Conversion de documents PostScript en documents PDF

Cette rubrique décrit l’utilisation de l’API Distiller Service (Java et service Web) pour convertir par programmation des fichiers PostScript (PS), Encapsulated PostScript (EPS) et PRN en documents PDF.

Résumé des étapes

Pour convertir l’un des types pris en charge en document PDF, procédez comme suit :

1. Inclure les fichiers de projet.
2. Créez un client de service Distiller.
3. Récupérez le fichier à convertir.
4. Appeler l’opération de création de PDF.
5. Enregistrez le document PDF.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un client de service Distiller

Avant de pouvoir effectuer par programmation une opération de service Distiller, vous devez créer un client de service Distiller. Si vous utilisez l’API Java, créez un objet DistillerServiceClient . Si vous utilisez l’API de service Web, créez un objet DistillerServiceService .

Récupération du fichier à convertir

Vous devez récupérer le fichier que vous souhaitez convertir. Par exemple, pour convertir un fichier PS en document PDF, vous devez récupérer le fichier PS.

Appeler l’opération de création de PDF

Après avoir créé le client de service, vous pouvez appeler l’opération de création de PDF. Cette opération nécessite des informations sur le document à convertir, y compris le chemin d’accès au document cible.

Enregistrement du document PDF

Vous pouvez enregistrer le document PDF au format PDF.

Voir également

Convertir un fichier PostScript en PDF à l’aide de l’API Java

Conversion d’un fichier PostScript au format PDF à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

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

Démarrages rapides de l’API Output Service

Convertir un fichier PostScript en PDF à l’aide de l’API Java

Convertissez un fichier PostScript en document PDF à l’aide de l’API Distiller Service (Java) :

1. Inclure les fichiers de projet.

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

2. Créez un client de service Distiller.

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

3. Récupérez le fichier à convertir.

   • Créez un objet java.io.FileInputStream qui représente le fichier à convertir en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du fichier.
   • Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

4. Appeler l’opération de création de PDF.

   Appelez la méthode createPDF de l’objet DistillerServiceClient et transmettez les valeurs suivantes :

   • Objet com.adobe.idp.Document représentant le fichier PS, EPS ou PRN à convertir
   • Objet java.lang.String contenant le nom du fichier à convertir
   • Objet java.lang.String contenant le nom des paramètres Adobe PDF à utiliser
   • Objet java.lang.String contenant le nom des paramètres de sécurité à utiliser
   • Objet com.adobe.idp.Document facultatif contenant les paramètres à appliquer lors de la génération du document PDF
   • Objet com.adobe.idp.Document facultatif contenant des informations de métadonnées à appliquer au document PDF

   La méthode createPDF renvoie un objet CreatePDFResult contenant le nouveau document PDF et un fichier journal pouvant être généré. Le fichier journal contient généralement des messages d’erreur ou d’avertissement générés par la requête de conversion.

5. Enregistrez le document PDF.

   Pour obtenir le document PDF nouvellement créé, effectuez les actions suivantes :

   • Appelez la méthode getCreatedDocument de l’objet CreatePDFResult. Cela renvoie un objet com.adobe.idp.Document.
   • Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour extraire le document PDF.

   De même, pour obtenir le document journal, effectuez les actions suivantes.

   • Appelez la méthode getLogDocument de l’objet CreatePDFResult. Cela renvoie un objet com.adobe.idp.Document.
   • Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour extraire le document journal.

Voir également

Résumé des étapes

Démarrage rapide (mode SOAP) : Conversion d’un fichier PostScript en document PDF à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

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

Conversion d’un fichier PostScript au format PDF à l’aide de l’API de service Web

Convertissez un fichier PostScript en document PDF à l’aide de l’API Distiller Service (service Web) :

1. Inclure les fichiers de projet.

   Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1.

   REMARQUE

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

2. Créez un client de service Distiller.

   • Créez un objet DistillerServiceClient à l’aide de son constructeur par défaut.

   • Créez un objet DistillerServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/DistillerService?blob=mtom). 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. Toutefois, spécifiez ?blob=mtom pour utiliser MTOM.

   • Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DistillerServiceClient.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 DistillerServiceClient.ClientCredentials.UserName.UserName.
     • Attribuez la valeur de mot de passe correspondante au champ DistillerServiceClient.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.

3. Récupérez le fichier à convertir.

   • Créez un objet BLOB en utilisant son constructeur. Cet objet BLOB est utilisé pour stocker le fichier à convertir en 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 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é System.IO.FileStream de l’objet Length.
   • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read 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 avec le contenu du tableau d’octets.

4. Appeler l’opération de création de PDF.

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

   • Objet BLOB représentant le fichier PS à convertir
   • Chaîne contenant le chemin d’accès au fichier à convertir
   • Objet string contenant les paramètres Adobe PDF à utiliser (par exemple, Standard)
   • Objet string contenant les paramètres de sécurité à utiliser (par exemple, No Security)
   • Objet BLOB facultatif contenant les paramètres à appliquer lors de la génération du document PDF
   • Objet BLOB facultatif contenant des informations de métadonnées à appliquer au document PDF
   • Un paramètre de sortie BLOB utilisé pour stocker le document PDF
   • Un paramètre de sortie BLOB utilisé pour stocker le journal

5. Enregistrez le document PDF.

   • Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.
   • Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode CreatePDF2 (le paramètre de sortie). Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
   • Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
   • Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Résumé des étapes

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef