Convertir des fichiers Postscript en documents PDF converting-postscript-to-pdf-documents
À propos du service Distiller about-the-distiller-service
Le service Distiller® permet de convertir 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.
Convertir des fichiers PostScript en documents PDF converting-postscript-to-pdf-documents-inner
Cette rubrique décrit l’utilisation de l’API du service Distiller (Java et service web) pour convertir par programmation des fichiers PostScript (PS), Encapsulated PostScript (EPS) et PRN en documents PDF.
Résumé des étapes summary-of-steps
Pour convertir l’un des types pris en charge en document PDF, procédez comme suit :
- Incluez les fichiers de projet.
- Créez un client de service Distiller.
- Récupérez le fichier à convertir.
- Appelez l’opération de création de PDF.
- Enregistrez le formulaire 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éer 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érer le 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
Une fois que vous avez 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.
Enregistrer le document PDF
Vous pouvez enregistrer le document PDF en tant que fichier PDF.
Voir également
Convertir un fichier PostScript en fichier PDF à l’aide de l’API Java
Convertir un fichier PostScript en fichier PDF à l’aide de l’API de service web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Didacticiels de mise en route de l’API Output Service
Convertir un fichier PostScript en fichier PDF à l’aide de l’API Java convert-a-postscript-file-to-pdf-using-the-java-api
Pour convertir un fichier PostScript en document PDF à l’aide de l’API du service Distiller (Java), procédez comme suit :
-
Incluez les fichiers de projet.
Incluez les fichiers JAR du client, tels que adobe-distiller-client.jar, dans le chemin d’accès aux classes de votre projet Java.
-
Créez un client de service Distiller.
- Créez un objet
ServiceClientFactoryqui contient des propriétés de connexion. - Créez un objet
DistillerServiceClienten utilisant son constructeur et en transmettant l’objetServiceClientFactory.
- Créez un objet
-
Récupérez le fichier à convertir.
- Créez un objet
java.io.FileInputStreamqui représente le fichier à convertir en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du fichier. - Créez un objet
com.adobe.idp.Documenten utilisant son constructeur et en transmettant l’objetjava.io.FileInputStream.
- Créez un objet
-
Appelez l’opération de création de PDF.
Appelez la méthode
createPDFde l’objetDistillerServiceClientet transmettez les valeurs suivantes :- Un objet
com.adobe.idp.Documentreprésentant le fichier PS, EPS ou PRN à convertir. - Un objet
java.lang.Stringcontenant le nom du fichier à convertir. - Un objet
java.lang.Stringcontenant le nom des paramètres Adobe PDF à utiliser. - Un objet
java.lang.Stringcontenant le nom des paramètres de sécurité à utiliser. - Un objet
com.adobe.idp.Documentfacultatif contenant les paramètres à appliquer lors de la génération du document PDF. - Un objet
com.adobe.idp.Documentfacultatif contenant des informations de métadonnées à appliquer au document PDF.
La méthode
createPDFrenvoie un objetCreatePDFResultcontenant 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. - Un objet
-
Enregistrez le formulaire PDF.
Pour obtenir le document PDF nouvellement créé, procédez comme suit :
- Appelez la méthode
getCreatedDocumentde l’objetCreatePDFResult. Cette fonction renvoie un objetcom.adobe.idp.Document. - Appelez la méthode
copyToFilede l’objetcom.adobe.idp.Documentpour extraire le document PDF.
De même, pour obtenir le document journal, procédez comme suit.
- Appelez la méthode
getLogDocumentde l’objetCreatePDFResult. Celle-ci renvoie un objetcom.adobe.idp.Document. - Appelez la méthode
copyToFilede l’objetcom.adobe.idp.Documentpour extraire le document de journal.
- Appelez la méthode
Voir également
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Convertir un fichier PostScript en fichier PDF à l’aide de l’API de service web converting-a-postscript-file-to-pdf-using-the-web-service-api
Pour convertir un fichier PostScript en document PDF à l’aide de l’API Distiller Service (service web), procédez comme suit :
-
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/DistillerService?WSDL&lc_version=9.0.1.note note NOTE Remplacez localhostpar l’adresse IP du serveur hébergeant AEM Forms. -
Créez un client de service Distiller.
-
Créez un objet
DistillerServiceClienten utilisant son constructeur par défaut. -
Créez un objet
DistillerServiceClient.Endpoint.Addressen utilisant le constructeurSystem.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemplehttp://localhost:8080/soap/services/DistillerService?blob=mtom). Il n’est pas nécessaire d’utiliser l’attributlc_version. Cet attribut est utilisé lorsque vous créez une référence de service. Toutefois, spécifiez?blob=mtompour utiliser MTOM. -
Créez un objet
System.ServiceModel.BasicHttpBindingen obtenant la valeur du champDistillerServiceClient.Endpoint.Binding. Convertissez la valeur de retour enBasicHttpBinding. -
Définissez le champ
MessageEncodingde l’objetSystem.ServiceModel.BasicHttpBindingsurWSMessageEncoding.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.Basicau champBasicHttpBindingSecurity.Transport.ClientCredentialType. - Attribuez la valeur constante
BasicHttpSecurityMode.TransportCredentialOnlyau champBasicHttpBindingSecurity.Security.Mode.
- Attribuez le nom d’utilisateur AEM forms au champ
-
-
Récupérez le fichier à convertir.
- Créez un objet
BLOBen utilisant son constructeur. Cet objetBLOBsert à stocker le fichier à convertir en document PDF. - Créez un objet
System.IO.FileStreamen appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier et son mode d’ouverture. - 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éLengthde l’objetSystem.IO.FileStream. - Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode
Readde l’objetSystem.IO.FileStreamet en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire. - Renseignez l’objet
BLOBen attribuant sa propriétéMTOMle contenu du tableau d’octets.
- Créez un objet
-
Appelez l’opération de création de PDF.
Appelez la méthode
CreatePDF2de l’objetDistillerServiceServiceet transmettez les valeurs requises suivantes :- Un objet
BLOBreprésentant le fichier PS à convertir. - Une chaîne contenant le chemin d’accès au fichier à convertir.
- Un objet de chaîne contenant les paramètres Adobe PDF à utiliser (par exemple,
Standard). - Un objet de chaîne contenant les paramètres de sécurité à utiliser (par exemple,
No Security). - Un objet
BLOBfacultatif contenant les paramètres à appliquer lors de la génération du document PDF. - Un objet
BLOBfacultatif contenant des informations de métadonnées à appliquer au document PDF. - Un paramètre de sortie
BLOButilisé pour stocker le document PDF. - Un paramètre de sortie
BLOButilisé pour stocker le journal.
- Un objet
-
Enregistrez le formulaire PDF.
- Créez un objet
System.IO.FileStreamen appelant son constructeur. Transmettez une valeur de chaîne représentant l’emplacement du fichier du document PDF signé et son mode d’ouverture. - Créez un tableau d’octets qui stocke le contenu de l’objet
BLOBqui a été renvoyé par la méthodeCreatePDF2(paramètre de sortie). Renseignez le tableau d’octets en obtenant la valeur du membre de donnéesMTOMde l’objetBLOB. - Créez un objet
System.IO.BinaryWriteren utilisant son constructeur et en transmettant l’objetSystem.IO.FileStream. - Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode
Writede l’objetSystem.IO.BinaryWriteret en transmettant le tableau d’octets.
- Créez un objet
Voir également
Appeler AEM Forms en utilisant MTOM
Appel d’AEM Forms à l’aide de SwaRef