Les exemples et exemples de ce document ne concernent que l’environnement AEM Forms on JEE.
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.
Pour plus d’informations sur le service Distiller, voir Guide de référence des services pour AEM Forms.
Cette rubrique décrit comment utiliser l’API Distiller Service (Java et service Web) pour convertir par programmation des fichiers PostScript (PS), Encapsulated PostScript (EPS) et PRN en documents PDF.
Pour plus d’informations sur le service Distiller, voir Guide de référence des services pour AEM Forms.
Pour convertir des fichiers PostScript en documents PDF, l’un des éléments suivants doit être installé sur le serveur hébergeant AEM Forms : Module redistribuable Acrobat 9 ou Microsoft Visual C++ 2005.
Pour convertir l’un des types pris en charge en document PDF, procédez comme suit :
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 exécuter une opération de service Distiller par programmation, 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 du service Web, créez un objet DistillerServiceService
.
Récupérer le fichier à convertir
Vous devez récupérer le fichier à 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 de cible.
Enregistrer le document PDF
Vous pouvez enregistrer le document PDF au format PDF.
Voir également
Conversion d’un fichier PostScript au format PDF à l’aide de l’API Java
Conversion d’un fichier PostScript en fichier PDF à l’aide de l’API du service Web
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API Output Service
Convertissez un fichier PostScript en document PDF à l’aide de l’API Distiller Service (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-distiller-client.jar, dans le chemin de classe de votre projet Java.
Créez un client de service Distiller.
ServiceClientFactory
qui contient des propriétés de connexion.DistillerServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Récupérez le fichier à convertir.
java.io.FileInputStream
qui représente le fichier à convertir en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l'emplacement du fichier.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Appelez l’opération de création de PDF.
Appelez la méthode createPDF
de l’objet DistillerServiceClient
et transmettez les valeurs suivantes :
com.adobe.idp.Document
représentant le fichier PS, EPS ou PRN à convertirjava.lang.String
contenant le nom du fichier à convertirjava.lang.String
contenant le nom des paramètres Adobe PDF à utiliserjava.lang.String
contenant le nom des paramètres de sécurité à utilisercom.adobe.idp.Document
facultatif contenant les paramètres à appliquer lors de la génération du document PDFcom.adobe.idp.Document
facultatif contenant des informations de métadonnées à appliquer au document PDFLa 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 demande de conversion.
Enregistrez le document PDF.
Pour obtenir le document PDF nouvellement créé, effectuez les opérations suivantes :
CreatePDFResult
de l’objet getCreatedDocument
. Cette opération renvoie un objet com.adobe.idp.Document
.com.adobe.idp.Document
de l’objet copyToFile
pour extraire le document PDF.De même, pour obtenir le document du journal, effectuez les actions suivantes.
CreatePDFResult
de l’objet getLogDocument
. Cette opération renvoie un objet com.adobe.idp.Document
.com.adobe.idp.Document
de l'objet copyToFile
pour extraire le document de journal.Voir également
Début rapide (mode SOAP) : Conversion d’un fichier PostScript en document PDF à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Convertissez un fichier PostScript en document PDF à l’aide de l’API Distiller Service (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client de service Distiller.
Créez un objet DistillerServiceClient
en utilisant son constructeur par défaut.
Créez un objet DistillerServiceClient.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/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. Cependant, 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 exécutant les tâches suivantes :
DistillerServiceClient.ClientCredentials.UserName.UserName
.DistillerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Récupérez le fichier à convertir.
BLOB
en utilisant son constructeur. Cet objet BLOB
est utilisé pour stocker le fichier à convertir en document PDF.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier et le mode d'ouverture du fichier.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
.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.BLOB
en attribuant sa propriété MTOM
au contenu du tableau d’octets.Appelez l’opération de création de PDF.
Appelez la méthode CreatePDF2
de l’objet DistillerServiceService
et transmettez les valeurs requises suivantes :
BLOB
représentant le fichier PS à convertirStandard
)No Securit
y)BLOB
facultatif contenant les paramètres à appliquer lors de la génération du document PDFBLOB
facultatif contenant des informations de métadonnées à appliquer au document PDFBLOB
utilisé pour stocker le document PDFBLOB
utilisé pour stocker le journalEnregistrez le document PDF.
System.IO.FileStream
en appelant son constructeur. Transmettez une valeur de chaîne qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.BLOB
renvoyé par la méthode CreatePDF2
(paramètre de sortie). Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM
de l’objet BLOB
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.System.IO.BinaryWriter
de l’objet Write
et en transmettant le tableau d’octets.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef