À propos du service DocConverter
Le service DocConverter peut convertir des documents PDF en documents PDA/A. Vous pouvez accomplir les tâches suivantes à l’aide de ce service :
Pour plus d’informations sur le service DocConverter, voir Référence des services pour AEM Forms.
Vous pouvez utiliser le service DocConverter pour convertir un document PDF en document PDF/A. Le PDF/A étant un format d’archivage destiné à la conservation à long terme du contenu du document, toutes les polices sont incorporées et le fichier n’est pas compressé. Par conséquent, un document PDF/A est généralement plus volumineux qu’un document PDF standard. De plus, un document PDF/A ne contient aucune donnée audio et vidéo. Avant de convertir un document PDF en document PDF/A, assurez-vous que le document PDF n’est pas un document PDF/A.
La spécification PDF/A-1 se compose de deux niveaux de conformité, à savoir A et B. La principale différence entre les deux concerne la prise en charge de la structure logique (accessibilité), qui n’est pas requise pour le niveau de conformité B. Quel que soit le niveau de conformité, PDF/A-1 exige que toutes les polices soient incorporées dans le document PDF/A généré. Actuellement, seul le format PDF/A-1b est pris en charge dans la validation (et la conversion).
Bien que PDF/A soit le standard d’archivage des documents PDF, il n’est pas obligatoire que PDF/A soit utilisé pour l’archivage si un document PDF standard répond aux exigences de votre entreprise. Le but du standard PDF/A est d’établir un fichier PDF destiné à l’archivage à long terme et à la conservation des documents.
Pour plus d’informations sur le service DocConverter, voir Référence des services pour AEM Forms.
Pour convertir un document PDF en document PDF/A, 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.
Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :
Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclure des fichiers de bibliothèque Java AEM Forms.
Créer un client DocConvert
Avant d’effectuer une opération DocConverter par programmation, vous devez créer un client DocConverter. Si vous utilisez l’API Java, créez un objet DocConverterServiceClient
. Si vous utilisez l’API Web Service DocConverter, créez un objet DocConverterServiceService
.
Référencer un document PDF à convertir en document PDF/A
Récupérez un document PDF à convertir en document PDF/A. Si vous tentez de convertir un document PDF, tel qu’un formulaire Acrobat, en document PDF/A, une exception est générée.
Définir les informations de suivi
Vous pouvez définir une option d’exécution qui détermine la quantité d’informations suivies pendant le processus de conversion. En d’autres termes, vous pouvez définir neuf niveaux différents qui spécifient le niveau d’informations suivi par le service DocConverter lors de la conversion d’un document PDF en document PDF/A.
Convertir le document
Après avoir créé le client de service DocConverter, référencé le document PDF à convertir et défini l’option d’exécution qui spécifie le suivi des informations, vous pouvez convertir le document du PDF en document PDF/A.
Enregistrer le document PDF/A
Vous pouvez enregistrer le document PDF/A en tant que fichier PDF.
Voir également
Convertir des documents en documents PDF/A à l’aide de l’API Java
Convertir des documents en documents PDF/A à l’aide de l’API Web Service
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Déterminer la conformité PDF/A par programmation
Convertissez un document PDF en document PDF/A à l’aide de l’API Java :
Inclure les fichiers du projet
Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Créer un client DocConvert
ServiceClientFactory
qui contient des propriétés de connexion.DocConverterServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Référencer un document PDF à convertir en document PDF/A
java.io.FileInputStream
qui représente le document PDF à convertir en utilisant son constructeur et en transmettant une valeur string spécifiant l’emplacement du fichier PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Définir les informations de suivi
PDFAConversionOptionSpec
en utilisant son constructeur.setLogLevel
de l’objet PDFAConversionOptionSpec
et en transmettant une valeur string qui spécifie le niveau de suivi. Par exemple, transmettez la valeur FINE
. Pour plus d’informations sur les différentes valeurs, voir la méthode setLogLevel
dans Référence de l’API AEM Forms.Convertir le document
Convertissez le document PDF en document PDF/A en appelant la méthode toPDFA
de l’objet DocConverterServiceClient
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF à convertir.PDFAConversionOptionSpec
spécifiant les informations de suivi.La méthode toPDFA
renvoie un objet PDFAConversionResult
contenant le document PDF/A.
Enregistrer le document PDF/A
getPDFA
de l’objet PDFAConversionResult
. Cette méthode renvoie un objet com.adobe.idp.Document
qui représente le document PDF/A.java.io.File
qui représente le fichier PDF/A. Assurez-vous que l’extension de nom de fichier est .pdf.copyToFile
de l’objet com.adobe.idp.Document
et en transmettant l’objet java.io.File
.Voir également
Démarrage rapide (mode SOAP) : convertir un document en document PDF/A à 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
Convertissez un document PDF en document PDF/A à l’aide de l’API DocConverter (Web Service) :
Inclure les fichiers du projet
Créer un client DocConvert
DocConverterServiceService
en appelant son constructeur par défaut.Credentials
de l’objet DocConverterServiceService
avec une valeur System.Net.NetworkCredential
qui spécifie le nom d’utilisateur et le mot de passe.Référencer un document PDF à convertir en document PDF/A
BLOB
en utilisant son constructeur. L’objet BLOB
sert à stocker le document PDF converti en document PDF/A.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF 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é Length
de l’objet System.IO.FileStream
.Read
de l’objet System.IO.FileStream
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant à sa propriété binaryData
le contenu du tableau d’octets.Définir les informations de suivi
PDFAConversionOptionSpec
en utilisant son constructeur.logLevel
de l’objet PDFAConversionOptionSpec
. Par exemple, affectez la valeur FINE
à ce membre de données.Convertir le document
Convertissez le document PDF en document PDF/A en appelant la méthode toPDFA
de l’objet DocConverterServiceService
et en transmettant les valeurs suivantes :
BLOB
contenant le document PDF à convertir.PDFAConversionOptionSpec
spécifiant les informations de suivi.La méthode toPDFA
renvoie un objet PDFAConversionResult
contenant le document PDF/A.
Enregistrer le document PDF/A
BLOB
qui stocke le document PDF/A en obtenant la valeur du membre de données PDFADocument
de l’objet PDFAConversionResult
.BLOB
qui a été renvoyé à l’aide de l’objet PDFAConversionResult
. Renseignez le tableau d’octets en obtenant la valeur du membre de données binaryData
de l’objet BLOB
.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du document PDF/A.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l’objet System.IO.FileStream
.Write
de l’objet System.IO.BinaryWriter
et en transmettant le tableau d’octets.Voir également
Appeler AEM Forms en utilisant le codage Base64
Créer un assemblage client .NET utilisant le codage Base64
Vous pouvez utiliser le service DocConverter pour déterminer si un document PDF est conforme au format PDF/A. Pour plus d’informations à propos d’un document PDF/A et de la conversion d’un document PDF en document PDF/A, voir Convertir des documents en documents PDF/A.
Pour plus d’informations sur le service DocConverter, voir Référence des services pour AEM Forms.
Pour déterminer la conformité au format PDF/A, 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.
Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :
Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclure des fichiers de bibliothèque Java AEM Forms.
Créer un client DocConvert
Avant d’effectuer une opération DocConverter par programmation, vous devez créer un client DocConverter. Si vous utilisez l’API Java, créez un objet DocConverterServiceClient
. Si vous utilisez l’API Web Service DocConverter, créez un objet DocConverterServiceService
.
Référencer un document PDF utilisé pour déterminer la conformité au format PDF/A
Un document de PDF doit être référencé et transmis au service DocConverter pour déterminer si le document de PDF est compatible avec le PDF/A.
Définir des options d’exécution
Vous pouvez définir une option d’exécution qui détermine la quantité d’informations suivies pendant le processus de conversion. En d’autres termes, vous pouvez définir neuf niveaux différents qui spécifient la quantité d’informations suivie par le service DocConverter lors de la conversion d’un document PDF en document PDF/A.
Récupérer des informations à propos du document PDF
Après avoir créé le client de service DocConverter, référencé le document du PDF et défini les options d’exécution, vous pouvez déterminer si le document PDF est un document conforme au format PDF/A.
Voir également
Déterminer la conformité au format PDF/A à l’aide de l’API Java
Déterminer la conformité au format PDF/A à l’aide de l’API Web Service
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Déterminez la conformité au format PDF/A à l’aide de l’API Java :
Inclure les fichiers du projet
Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Créer un client DocConvert
ServiceClientFactory
qui contient des propriétés de connexion.DocConverterServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Référencer un document PDF utilisé pour déterminer la conformité au format PDF/A
java.io.FileInputStream
qui représente le document PDF à convertir en utilisant son constructeur et en transmettant une valeur de chaîne spécifiant l’emplacement du fichier PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Définir les options d’exécution
PDFAValidationOptionSpec
en utilisant son constructeur.setCompliance
de l’objet PDFAValidationOptionSpec
et en transmettant PDFAValidationOptionSpec.Compliance.PDFA_1B
.setLogLevel
de l’objet PDFAValidationOptionSpec
et en transmettant une valeur de chaîne qui spécifie le niveau de suivi. Par exemple, transmettez la valeur FINE
. Pour plus d’informations à propos des différentes valeurs, voir la méthode setLogLevel
dans Référence de l’API AEM Forms.Récupérer des informations sur le document PDF
Déterminez la conformité au format PDF/A en appelant la méthode isPDFA
de l’objet DocConverterServiceClient
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF.PDFAValidationOptionSpec
spécifiant les options d’exécution.La méthode isPDFA
renvoie un objet PDFAValidationResult
contenant les résultats de cette opération.
Voir également
Démarrage rapide (mode SOAP) : déterminer la conformité du PDF/A à 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
Déterminez la conformité au format PDF/A à l’aide de l’API Web Service :
Inclure les fichiers du projet
Créer un client DocConvert
DocConverterServiceService
en appelant son constructeur par défaut.Credentials
de l’objet DocConverterServiceService
avec une valeur System.Net.NetworkCredential
indiquant le nom d’utilisateur et le mot de passe.Référencer un document PDF utilisé pour déterminer la conformité au format PDF/A
BLOB
en utilisant son constructeur. L’objet BLOB
sert à stocker le document PDF converti en document PDF/A.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF 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é Length
de l’objet System.IO.FileStream
.Read
de l’objet System.IO.FileStream
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en attribuant à sa propriété binaryData
le contenu du tableau d’octets.Définir les options d’exécution
PDFAValidationOptionSpec
en utilisant son constructeur.compliance
de l’objet PDFAValidationOptionSpec
la valeur PDFAConversionOptionSpec_Compliance.PDFA_1B
.resultLevel
de l’objet PDFAValidationOptionSpec
la valeur PDFAValidationOptionSpec_ResultLevel.DETAILED
.Récupérer des informations sur le document PDF
Déterminez la conformité au format PDF/A en appelant la méthode isPDFA
de l’objet DocConverterServiceService
et en transmettant les valeurs suivantes :
BLOB
contenant le document PDF.PDFAValidationOptionSpec
contenant les options d’exécution.La méthode isPDFA
renvoie un objet PDFAValidationResult
contenant les résultats de cette opération.
Voir également