Documentation AEM 6.5 Guide de l’utilisateur

Utiliser des documents PDF/A

Dernière mise à jour : 5 décembre 2024

S'applique à :
Experience Manager 6.5

Rubriques :

Créé pour :

Développeur

À 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 :

Convertir des documents PDF en documents PDF/A. (Voir Convertir des documents en documents PDF/A.)
Déterminer si les documents PDF sont des documents PDF/A. (Voir Déterminer la conformité PDF/A par programmation.)

REMARQUE

Pour plus d’informations sur le service DocConverter, voir Référence des services pour AEM Forms.

Convertir des documents en documents PDF/A

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.

Les normes de conformité PDF/A prises en charge comprennent les suivantes : PDF/A-1a, 1b, 2a, 2b, 3a et 3b.

REMARQUE

Pour plus d’informations sur le service DocConverter, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour convertir un document PDF en document PDF/A, procédez comme suit :

Incluez les fichiers de projet.
Créer un client DocConvert
Référencez un document PDF à convertir en document PDF/A.
Définissez les informations de suivi.
Convertissez le document.
Enregistrez le document PDF/A.

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 :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-docconverter-client.jar
adobe-utilities.jar (obligatoire si AEM Forms est déployé sur JBoss Application Server)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss Application Server)

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

Convertir des documents en documents PDF/A à l’aide de l’API Java

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
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet DocConverterServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Référencer un document PDF à convertir en document PDF/A
- Créez un objet 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.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Définir les informations de suivi
- Créez un objet PDFAConversionOptionSpec en utilisant son constructeur.
- Définissez le niveau de suivi des informations en appelant la méthode 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 :
- Objet com.adobe.idp.Document contenant le document PDF à convertir.
- Objet 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
- Récupérez le document PDF/A en appelant la méthode getPDFA de l’objet PDFAConversionResult. Cette méthode renvoie un objet com.adobe.idp.Document qui représente le document PDF/A.
- Créez un objet java.io.File qui représente le fichier PDF/A. Assurez-vous que l’extension de nom de fichier est .pdf.
- Renseignez le fichier avec des données PDF/A en appelant la méthode copyToFile de l’objet com.adobe.idp.Document et en transmettant l’objet java.io.File.

Voir également

Utiliser des documents PDF/A

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

Convertir des documents en documents PDF/A à l’aide de l’API Web Service

Convertissez un document PDF en document PDF/A à l’aide de l’API DocConverter (Web Service) :

Inclure les fichiers du projet
- Créez un assemblage client Microsoft .NET qui utilise le fichier WSDL DocConverter.
- Référencez l’assemblage client Microsoft .NET.
Créer un client DocConvert
- À l’aide de l’assemblage client .NET Microsoft, créez un objet DocConverterServiceService en appelant son constructeur par défaut.
- Définissez le membre de données 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
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker le document PDF converti en document PDF/A.
- Créez un objet 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.
- 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é Length de l’objet System.IO.FileStream.
- Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode 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.
- Renseignez l’objet BLOB en affectant à sa propriété binaryData le contenu du tableau d’octets.
Définir les informations de suivi
- Créez un objet PDFAConversionOptionSpec en utilisant son constructeur.
- Définissez le niveau de suivi des informations en affectant une valeur qui spécifie le niveau de suivi au membre de données 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 :
- Objet BLOB contenant le document PDF à convertir.
- Objet 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
- Créez un objet BLOB qui stocke le document PDF/A en obtenant la valeur du membre de données PDFADocument de l’objet PDFAConversionResult.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du document PDF/A.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Voir également

Utiliser des documents PDF/A

Appeler AEM Forms en utilisant le codage Base64

Créer un assemblage client .NET utilisant le codage Base64

Déterminer la conformité PDF/A par programmation

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.

NOTE

Pour plus d’informations sur le service DocConverter, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour déterminer la conformité au format PDF/A, procédez comme suit :

Incluez les fichiers de projet.
Créer un client DocConvert
Référencez un document PDF servant à déterminer la conformité PDF/A.
Définissez les options d’exécution.
Récupérez les informations sur 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.

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-docconverter-client.jar
adobe-utilities.jar (obligatoire si AEM Forms est déployé sur JBoss Application Server)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss Application Server)

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 PDF doit être référencé et transmis au service DocConverter afin de déterminer si le document PDF est conforme au format 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éterminer la conformité au format PDF/A à l’aide de l’API Java

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
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet 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
- Créez un objet 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.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Définir les options d’exécution
- Créez un objet PDFAValidationOptionSpec en utilisant son constructeur.
- Définissez le niveau de conformité en appelant la méthode setCompliance de l’objet PDFAValidationOptionSpec et en transmettant PDFAValidationOptionSpec.Compliance.PDFA_1B.
- Définissez le niveau de suivi des informations en appelant la méthode 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 :
- Objet com.adobe.idp.Document contenant le document PDF.
- Objet 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

Utiliser des documents PDF/A

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éterminer la conformité au format PDF/A à l’aide de l’API Web Service

Déterminez la conformité au format PDF/A à l’aide de l’API Web Service :

Inclure les fichiers du projet
- Créez un assemblage client Microsoft .NET qui utilise le fichier WSDL DocConverter.
- Référencez l’assemblage client Microsoft .NET.
Créer un client DocConvert
- À l’aide de l’assemblage client .NET Microsoft, créez un objet DocConverterServiceService en appelant son constructeur par défaut.
- Définissez le membre de données 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
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker le document PDF converti en document PDF/A.
- Créez un objet 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.
- 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é Length de l’objet System.IO.FileStream.
- Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant à sa propriété binaryData le contenu du tableau d’octets.
Définir les options d’exécution
- Créez un objet PDFAValidationOptionSpec en utilisant son constructeur.
- Définissez le niveau de compatibilité en attribuant au membre de données compliance de l’objet PDFAValidationOptionSpec la valeur PDFAConversionOptionSpec_Compliance.PDFA_1B.
- Définissez le niveau de suivi des informations en attribuant au membre de données 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 :
- Objet BLOB contenant le document PDF.
- Objet 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

Utiliser des documents PDF/A

Appeler AEM Forms en utilisant le codage Base64

Créer un assemblage client .NET utilisant le codage Base64

recommendation-more-help