A propos du service Convert PDF
Le service Convert PDF convertit les documents PDF en PostScript et en plusieurs formats d’image (JPEG, JPEG 2000, PNG et TIFF). La conversion d’un document PDF en PostScript est utile pour les impressions sans assistance reposant sur un serveur exécutées sur n’importe quelle imprimante PostScript. La conversion d’un document PDF en fichier TIFF comportant plusieurs pages est pratique lors de l’archivage de documents dans des systèmes de gestion de contenu qui ne prennent pas en charge les documents PDF.
Vous pouvez exécuter ces tâches à l’aide du service Convert PDF :
Pour plus d’informations sur le service Convert PDF, voir Guide de référence des services pour AEM Forms.
Cette rubrique décrit comment utiliser l’API du service Convert PDF (Java et service Web) pour convertir par programmation des documents PDF en fichiers PostScript. Le document PDF converti en fichier PostScript doit être un document PDF non interactif. En d’autres termes, si vous tentez de convertir un document PDF interactif en fichier PostScript, une exception est générée.
Pour plus d’informations sur le service Convert PDF, voir Guide de référence des services pour AEM Forms.
Pour convertir un document PDF en fichier PostScript, 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éer un client Convert PDF
Avant de pouvoir exécuter par programmation une opération de service Convert PDF, vous devez créer un client de service Convert PDF. Si vous utilisez l’API Java, créez un objet ConvertPdfServiceClient
. Si vous utilisez l’API du service Web, créez un objet ConvertPDFServiceService
.
Cette section utilise la fonctionnalité de service Web introduite dans AEM Forms. Pour accéder à de nouvelles fonctionnalités, vous devez construire votre objet proxy à l'aide de l'attribut lc_version
. (Voir "Accès à de nouvelles fonctionnalités à l’aide de services Web" dans Appel d’AEM Forms à l’aide de services Web.)
Référence au document PDF à convertir en fichier PostScript
Référencez le document PDF que vous souhaitez convertir en fichier PostScript. Comme indiqué précédemment dans cette rubrique, le document PDF doit être un document PDF non interactif. Si vous tentez de convertir un document PDF interactif en fichier PostScript, une exception est générée.
Définition des options d’exécution de conversion
Lors de la conversion d’un document PDF en fichier PostScript, vous pouvez définir des options d’exécution qui spécifient le type PostScript créé. Par exemple, vous pouvez définir un fichier PostScript de niveau 3.
En règle générale, le fichier PostScript généré reflète la taille du document PDF d’entrée. Si vous sélectionnez l’option ShrinkToFit
(qui réduit la sortie du fichier PostScript pour l’adapter à la page), vous ne verrez aucune différence entre le document PDF d’entrée et le fichier PostScript généré. L’option ShrinkToFit
n’est appliquée que si vous choisissez d’imprimer sur une taille de page inférieure à celle du document PDF d’entrée. Pour sélectionner un format de page plus petit, définissez l'option PageSize
. En outre, il est recommandé de définir l’option RotateAndCenter
sur true
pour obtenir la sortie PostScript correcte.
De même, si vous sélectionnez l’option ExpandToFit
(qui développe la sortie du fichier PostScript pour l’adapter à la page), elle ne prend effet que si vous choisissez d’imprimer sur une taille de page supérieure à celle du document PDF d’entrée. Pour sélectionner un format de page plus grand, définissez l'option PageSize
. En outre, il est recommandé de définir l’option RotateAndCenter
sur true
pour obtenir la sortie PostScript correcte.
Pour plus d'informations sur les valeurs d'exécution que vous pouvez définir, consultez la référence de classe ToPSOptionsSpec
dans AEM Forms API Reference.
Conversion du document PDF en fichier PostScript
Après avoir créé le client de service et défini les options d’exécution, vous pouvez appeler l’opération de conversion PostScript. Cette opération nécessite des informations sur le document à convertir, y compris le niveau PostScript recommandé pour le document de cible.
Enregistrement du fichier PostScript
Après avoir converti le document PDF en PostScript, vous pouvez enregistrer la sortie dans un fichier PostScript.
Voir également
Conversion d’un document PDF en PS à l’aide de l’API Java
Conversion d’un document PDF en PS à 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 du service Conversion PDF
Convertir un document PDF en PostScript à l’aide de l’API de service Convert PDF (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-convertpdf-client.jar, dans le chemin de classe de votre projet Java.
Créez un client Convert PDF.
ServiceClientFactory
qui contient des propriétés de connexion.ConvertPdfServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Référencez le document PDF à convertir en fichier PostScript.
java.io.FileInputStream
à l’aide de son constructeur et transmettez une valeur de chaîne indiquant l’emplacement du document PDF à convertir.com.adobe.idp.Document
qui stocke le document PDF à l’aide du constructeur com.adobe.idp.Document
. Transmettez l’objet java.io.FileInputStream
contenant le document PDF.Définissez les options d’exécution de conversion.
ToPSOptionsSpec
en appelant son constructeur.ToPSOptionsSpec
. Par exemple, pour définir le niveau PostScript qui est créé, appelez la méthode ToPSOptionsSpec
de l’objet setPsLevel
et transmettez une valeur de énumération PSLevel
qui spécifie le niveau PostScript. Pour plus d’informations sur toutes les valeurs d’exécution que vous pouvez définir, voir la référence de classe ToPSOptionsSpec
dans AEM Forms API Reference.Convertissez le document PDF en fichier PostScript.
Appelez la méthode ConvertPdfServiceClient
de l'objet toPS2
et transmettez les valeurs suivantes :
com.adobe.idp.Document
représentant le document PDF à convertir en fichier PostScript.ToPSOptionsSpec
qui spécifie les options d’exécution PostScript.La méthode toPS2
renvoie un objet Document
contenant le nouveau document PostScript.
Enregistrez le fichier PostScript.
java.io.File
et assurez-vous que l’extension de nom de fichier est .ps.Document
de l'objet copyToFile
pour copier le contenu de l'objet Document
dans le fichier (veillez à utiliser l'objet Document
renvoyé par la méthode toPS2
).Voir également
Début rapide (mode SOAP) : Conversion d’un document PDF en PostScript à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Conversion d’un document PDF en PostScript à l’aide de l’API de service Convert PDF (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/ConvertPDFService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client Convert PDF.
Créez un objet ConvertPdfServiceClient
en utilisant son constructeur par défaut.
Créez un objet ConvertPdfServiceClient.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/ConvertPDFService?blob=mtom
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Spécifiez toutefois ?blob=mtom
.
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ ConvertPdfServiceClient.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 :
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
.ConvertPdfServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Référencez le document PDF à convertir en fichier PostScript.
BLOB
en utilisant son constructeur. L’objet BLOB
permet de stocker un document PDF converti en fichier PostScript.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF à convertir 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 son champ MTOM
au contenu du tableau d’octets.Définissez les options d’exécution de conversion.
ToPSOptionsSpec
en appelant son constructeur.ToPSOptionsSpec
. Par exemple, pour définir le niveau PostScript créé, affectez une valeur de énumération PSLevel
au membre de données psLevel
de l’objet ToPSOptionsSpec
.Convertissez le document PDF en fichier PostScript.
Appelez la méthode toPS2
de l’objet GeneratePDFServiceService
et transmettez les valeurs suivantes :
BLOB
représentant le document PDF à convertir en fichier PostScriptToPSOptionsSpec
qui spécifie les options d’exécutionUne fois la conversion terminée, extrayez les données binaires qui représentent le document PostScript en accédant à la propriété BLOB
MTOM
de l’objet <a1/>. Cette opération renvoie un tableau d’octets que vous pouvez écrire dans un fichier PostScript.
Enregistrez le fichier PostScript.
System.IO.FileStream
en appelant son constructeur. Transmettez une valeur de chaîne qui représente l’emplacement du fichier PS.BLOB
renvoyé par la méthode encryptPDFUsingPassword
. Renseignez le tableau d’octets en obtenant la valeur du champ BLOB
de l’objet MTOM
.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
Vous pouvez utiliser le service Convert PDF pour convertir par programmation des documents PDF aux formats d’image, notamment JPEG, JPEG 2000, TIFF et PNG. En convertissant un document PDF en fichier image, vous pouvez utiliser le document PDF en fichier image. Par exemple, vous pouvez placer l’image dans un système de gestion de contenu d’entreprise pour enregistrement.
Lors de la conversion d’un document PDF en image, le service Convert PDF crée une image distincte pour chaque page du document. En d’autres termes, si le document compte 20 pages, le service Convert PDF crée 20 fichiers image. Lors de la conversion d’un document PDF en format d’image, vous pouvez créer des images individuelles pour chaque page du document PDF ou un seul fichier d’image pour l’ensemble du document PDF.
Pour plus d’informations sur le service Convert PDF, voir Guide de référence des services pour AEM Forms.
Pour convertir un document PDF en l’un des types pris en charge, 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éer un client Convert PDF
Avant de pouvoir exécuter par programmation une opération de service Convert PDF, vous devez créer un client de service Convert PDF. Si vous utilisez l’API Java, créez un objet ConvertPdfServiceClient
. Si vous utilisez l’API du service Web, créez un objet ConvertPDFServiceService
.
Récupération du document PDF à convertir
Vous devez récupérer le document PDF à convertir en image. Vous ne pouvez pas convertir un document PDF interactif en image. Si vous tentez de le faire, une exception est levée. Pour convertir un document PDF interactif en fichier image, vous devez aplatir le document PDF avant de le convertir. (Voir Aplatissement des Documents PDF.)
Définition des options d’exécution
Vous devez définir des options d’exécution telles que le format d’image et les valeurs de résolution. Pour plus d’informations sur les valeurs d’exécution, voir la référence de classe ToImageOptionsSpec
dans Référence de l’API AEM Forms.
Convertir le PDF en image
Après avoir créé le client de service et défini les options d’exécution, vous pouvez convertir le document PDF en image. Un objet de collection contenant les images est renvoyé.
Récupération des fichiers image d’une collection
Vous pouvez récupérer des fichiers image à partir d’un objet de collection renvoyé par le service Convert PDF. Chaque élément de la collection est une instance com.adobe.idp.Document
(ou une instance BLOB
si vous utilisez des services Web) que vous pouvez enregistrer en tant que fichier image, tel qu’un fichier JPG.
Le format du fichier image dépend de l’option d’exécution ImageConvertFormat
. En d’autres termes, si vous définissez l’option d’exécution ImageConvertFormat
sur ImageConvertFormat.JPEG
, vous pouvez enregistrer des fichiers d’image au format JPG.
Voir également
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service Conversion PDF
Conversion d’un document PDF en format d’image à l’aide de l’API du service Convert PDF (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-convertpdf-client.jar, dans le chemin de classe de votre projet Java.
Créez un client Convert PDF.
ServiceClientFactory
qui contient des propriétés de connexion.ConvertPdfServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez le document PDF à convertir.
java.io.FileInputStream
représentant le document PDF à convertir à l’aide de son constructeur et transmettez une valeur de chaîne indiquant l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Définissez les options d’exécution.
ToImageOptionsSpec
en utilisant son constructeur.setImageConvertFormat
et en transmettant une valeur d’énumération ImageConvertFormat
qui spécifie le type de format.La définition de la valeur de énumération ImageConvertFormat
est obligatoire.
Convertissez le fichier PDF en image.
Appelez la méthode toImage2
de l’objet ConvertPdfServiceClient
et transmettez les valeurs suivantes :
com.adobe.idp.Document
représentant le fichier PDF à convertir.com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec
contenant les différentes préférences concernant le format d'image de la cible.La méthode toImage2
renvoie un objet java.util.List
contenant des images. Chaque élément de la collection est une instance com.adobe.idp.Document
.
Récupérez les fichiers image d’une collection.
Effectuez une itération sur l’objet java.util.List
pour déterminer si des images sont présentes. Chaque élément est une instance com.adobe.idp.Document
. Enregistrez l’image en appelant la méthode copyToFile
de l’objet com.adobe.idp.Document
et en transmettant un objet java.io.File
.
Voir également
Début rapide (mode SOAP) : Conversion d’un document PDF en fichiers JPEG à l’aide de l’API Java
Conversion d’un document PDF en format d’image à l’aide de l’API de service Convert PDF (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/ConvertPDFService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client PDF de conversion.
Créez un objet ConvertPdfServiceClient
en utilisant son constructeur par défaut.
Créez un objet ConvertPdfServiceClient.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/ConvertPDFService?blob=mtom
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Spécifiez toutefois ?blob=mtom
.
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ ConvertPdfServiceClient.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 :
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
.ConvertPdfServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Récupérez le document PDF à convertir.
BLOB
en utilisant son constructeur. Cet objet BLOB
est utilisé pour stocker le formulaire PDF.System.IO.FileStream
en appelant son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement du formulaire PDF et le mode d’ouverture du fichier.System.IO.FileStream
. Déterminez 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
. Passez le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Définissez les options d’exécution.
ToImageOptionsSpec
en utilisant son constructeur.setImageConvertFormat
et en transmettant une valeur de énumération ImageConvertFormat
qui spécifie le type de format.La définition de la valeur de énumération ImageConvertFormat
est obligatoire.
Convertissez le fichier PDF en image.
Appelez la méthode toImage2
de l’objet ConvertPDFServiceService
et transmettez les valeurs suivantes :
BLOB
représentant le fichier à convertirToImageOptionsSpec
contenant les différentes préférences concernant le format d'image de la cibleLa méthode toImage2
renvoie un objet MyArrayOfBLOB
contenant les fichiers image nouvellement créés.
Récupérez les fichiers image d’une collection.
MyArrayOfBLOB
en obtenant la valeur de son champ Count
. Chaque élément est un objet BLOB
qui contient l’image.MyArrayOfBLOB
et enregistrez chaque fichier image.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef