Déterminer la compatibilité des documents avec le format PDF/A determining-whether-documents-are-pdf-a-compliant
Vous pouvez déterminer si un document PDF est compatible avec le format PDF/A à l’aide du service Assembler. Un document PDF/A existe en tant que format d’archivage, prévu pour la conservation sur le long terme du contenu d’un document. Les polices sont incorporées dans le document et le fichier est dé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.
La spécification PDF/A-1 se compose de deux niveaux de conformité, à savoir A et B. La principale différence entre les deux niveaux est 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é, la spécification 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).
Dans le cadre de cette discussion, supposons que le document DDX suivant soit utilisé.
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<DocumentInformation source="Loan.pdf" result="Loan_result.xml">
<PDFAValidation compliance="PDF/A-1b" resultLevel="Detailed" ignoreUnusedResources="true" allowCertificationSignatures="true" />
</DocumentInformation>
</DDX>
Dans ce document DDX, l’élément DocumentInformation
indique au service Assembler de renvoyer des informations sur le document du PDF d’entrée. Dans l’élément DocumentInformation
, l’élément PDFAValidation
demande au service Assembler d’indiquer si le document PDF d’entrée est compatible ou non avec le format PDF/A.
Le service Assembler renvoie des informations spécifiant si le document PDF d’entrée est compatible ou non avec le format PDF/A, dans un document XML contenant un élément PDFAConformance
. Si le document PDF d’entrée est compatible avec le format PDF/A, la valeur de l’attribut isCompliant
de l’élément PDFAConformance
est true
. Si le document PDF n’est pas compatible avec le format PDF/A, la valeur de l’attribut isCompliant
de l’élément PDFAConformance
est false
.
DocumentInformation
, le service Assembler renvoie des données XML au lieu d’un document PDF. En d’autres termes, le service Assembler n’assemble ni ne désassemble un document PDF ; il renvoie des informations sur le document PDF d’entrée dans un document XML.Résumé des étapes summary-of-steps
Pour déterminer si un document PDF est compatible avec le format PDF/A, procédez comme suit :
- Incluez les fichiers de projet.
- Créez un client Assembler PDF.
- Référencez un document DX existant.
- 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.
- Enregistrez le document XML renvoyé.
Incluez 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-assembler-client.jar
- adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
- jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)
Si AEM Forms est déployé sur un serveur d’applications J2EE pris en charge et différent de JBoss, vous devez remplacer les fichiers adobe-utilities.jar et jbossall-client.jar par des fichiers JAR spécifiques au serveur d’applications J2EE sur lequel AEM Forms est déployé. Pour plus d’informations sur l’emplacement de ces fichiers, consultez la section Inclure des fichiers de bibliothèque Java AEM Forms.
Créer un client Assembler PDF
Avant de pouvoir effectuer une opération Assembler de manière programmée, vous devez créer un client de service Assembler.
Référencer un document DDX existant
Un document DDX doit être référencé pour effectuer une opération de service Assembler. Pour déterminer si un document PDF d’entrée est compatible avec le format PDF/A, assurez-vous que le document DDX contient l’élément PDFAValidation
dans un élément DocumentInformation
. L’élément PDFAValidation
indique au service Assembler de renvoyer un document XML spécifiant si le document PDF d’entrée est compatible ou non avec le format PDF/A.
Référencer un document PDF utilisé pour déterminer la compatibilité avec le format PDF/A
Un document PDF doit être référencé et transmis au service Assembler pour déterminer si le document PDF est compatible ou non avec le format PDF/A.
Définir des options de temps d’exécution
Vous pouvez définir des options d’exécution qui contrôlent le comportement du service Assembler lorsqu’il effectue une tâche. Par exemple, vous pouvez définir une option qui indique au service Assembler de continuer à traiter une tâche même en cas d’erreur. Pour plus d’informations sur les options d’exécution que vous pouvez définir, voir la référence de classe AssemblerOptionSpec
dans Référence de l’API AEM Forms.
Récupérer des informations sur un document PDF
Après avoir créé le client de service Assembler, référencé le document DDX, référencé un document PDF interactif et défini les options d’exécution, vous pouvez appeler l’opération invokeDDX
. Étant donné que le document DDX contient l’élément DocumentInformation
, le service Assembler renvoie des données XML au lieu d’un document PDF.
Enregistrer un document XML renvoyé
Le document XML renvoyé par le service Assembler indique si le document PDF d’entrée est compatible ou non avec le format PDF/A. Par exemple, si le document PDF d’entrée n’est pas compatible avec le format PDF/A, le service Assembler renvoie un document XML contenant l’élément suivant :
<PDFAConformance isCompliant="false" compliance="PDF/A-1b" resultLevel="Detailed" ignoreUnusedResources="true" allowCertificationSignatures="true">
Enregistrez le document XML en tant que fichier XML afin de pouvoir ouvrir le fichier et visualiser les résultats.
Voir également
Déterminer si un document est compatible avec le format PDF/A à l’aide de l’API Java
Déterminer si un document est compatible avec le format PDF/A à l’aide de l’API de service web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Déterminer si un document est compatible avec le format PDF/A à l’aide de l’API Java determine-whether-a-document-is-pdf-a-compliant-using-the-java-api
Déterminez si un document PDF est compatible avec le format PDF/A à l’aide de l’API du service Assembler (Java) :
-
Incluez les fichiers de projet.
Incluez les fichiers JAR clients, tels que adobe-assembler-client.jar, dans le chemin d’accès aux classes de votre projet Java.
-
Créez un client Assembler PDF.
- Créez un objet
ServiceClientFactory
qui contient des propriétés de connexion. - Créez un objet
AssemblerServiceClient
en utilisant son constructeur et en transmettant l’objetServiceClientFactory
.
- Créez un objet
-
Référencez un document DX existant.
- Créez un objet
java.io.FileInputStream
représentant le document DDX en utilisant son constructeur et en transmettant une valeur de chaîne qui indique l’emplacement du fichier DDX. Pour déterminer si le document PDF est compatible avec le format PDF/A, assurez-vous que le document DDX contient l’élémentPDFAValidation
contenu dans un élémentDocumentInformation
. - Créez un objet
com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objetjava.io.FileInputStream
.
- Créez un objet
-
Référencez un document PDF servant à déterminer la conformité PDF/A.
-
Créez un objet
java.io.FileInputStream
en utilisant son constructeur et en transmettant l’emplacement d’un document PDF servant à déterminer la conformité PDF/A. -
Créez un objet
com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objetjava.io.FileInputStream
contenant le document PDF. -
Créez un objet
java.util.Map
servant à stocker le document PDF d’entrée en utilisant un constructeurHashMap
. -
Ajoutez une entrée à l’objet
java.util.Map
en appelant la méthodeput
correspondante et en transmettant les arguments suivants :- Une valeur de chaîne qui représente le nom de la clé. Cette valeur doit correspondre à la valeur de l’élément source spécifié dans le document DDX. Par exemple, la valeur de l’élément source situé dans le document DDX introduit dans cette section est Loan.pdf.
- Objet
com.adobe.idp.Document
contenant le document PDF d’entrée.
-
-
Définissez les options d’exécution.
- Créez un objet
AssemblerOptionSpec
qui stocke les options d’exécution en utilisant son constructeur. - Définissez les options d’exécution pour répondre à vos exigences professionnelles en appelant une méthode appartenant à l’objet
AssemblerOptionSpec
. Par exemple, pour demander au service Assembler de poursuivre le traitement d’une tâche en cas d’erreur, appelez la méthodesetFailOnError
de l’objetAssemblerOptionSpec
et transmettezfalse
.
- Créez un objet
-
Récupérez les informations sur le document PDF.
Appelez la méthode
invokeDDX
de l’objetAssemblerServiceClient
et transmettez les valeurs requises suivantes :- Objet
com.adobe.idp.Document
représentant le document DDX à utiliser - Objet
java.util.Map
qui contient le fichier PDF d’entrée servant à déterminer la conformité PDF/A - Objet
com.adobe.livecycle.assembler.client.AssemblerOptionSpec
qui spécifie les options d’exécution
La méthode
invokeDDX
renvoie un objetcom.adobe.livecycle.assembler.client.AssemblerResult
qui contient des données XML spécifiant si le document PDF d’entrée est conforme à la norme PDF/A. - Objet
-
Enregistrez le document XML renvoyé.
Pour obtenir des données XML qui spécifient si le document PDF d’entrée est un document PDF/A, effectuez les actions suivantes :
- Appelez la méthode
getDocuments
de l’objetAssemblerResult
. Cette méthode renvoie un objetjava.util.Map
. - Effectuez une itération dans l’objet
java.util.Map
jusqu’à ce que vous trouviez l’objetcom.adobe.idp.Document
cible. - Appelez la méthode
copyToFile
de l’objetcom.adobe.idp.Document
pour extraire le document XML. Veillez à enregistrer les données XML en tant que fichier XML.
- Appelez la méthode
Voir également
Démarrage rapide (mode SOAP) : détermination de la conformité PDF/A d’un document à l’aide de l’API Java (mode SOAP)
Détermination de la conformité PDF/A d’un document à l’aide de l’API du service web determine-whether-a-document-is-pdf-a-compliant-using-the-web-service-api
Déterminez si un document PDF est conforme PDF/A à l’aide de l’API Assembler Service (service web) :
-
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/AssemblerService?WSDL&lc_version=9.0.1
.note note NOTE Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms. -
Créez un client Assembler PDF.
-
Créez un objet
AssemblerServiceClient
en utilisant son constructeur par défaut. -
Créez un objet
AssemblerServiceClient.Endpoint.Address
en utilisant le constructeurSystem.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple,http://localhost:8080/soap/services/AssemblerService?blob=mtom
). Vous n’avez pas besoin d’utiliser l’attributlc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.) -
Créez un objet
System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champAssemblerServiceClient.Endpoint.Binding
. Convertissez la valeur de retour enBasicHttpBinding
. -
Définissez le champ
MessageEncoding
de l’objetSystem.ServiceModel.BasicHttpBinding
surWSMessageEncoding.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
AssemblerServiceClient.ClientCredentials.UserName.UserName
. - Attribuez la valeur de mot de passe correspondante au champ
AssemblerServiceClient.ClientCredentials.UserName.Password
. - Attribuez la valeur constante
HttpClientCredentialType.Basic
au champBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Attribuez la valeur constante
BasicHttpSecurityMode.TransportCredentialOnly
au champBasicHttpBindingSecurity.Security.Mode
.
- Attribuez le nom d’utilisateur AEM forms au champ
-
-
Référencez un document DX existant.
- Créez un objet
BLOB
en utilisant son constructeur. L’objetBLOB
sert à stocker le document DDX. - 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 fichier du document DDX 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’objetSystem.IO.FileStream
. - Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode
Read
de l’objetSystem.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 son champMTOM
au contenu du tableau d’octets.
- Créez un objet
-
Référencez un document PDF servant à déterminer la conformité PDF/A.
- Créez un objet
BLOB
en utilisant son constructeur. L’objetBLOB
sert à stocker le document PDF d’entrée. - 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 fichier du document PDF d’entrée 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éLength
de l’objetSystem.IO.FileStream
. - Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode
Read
de l’objetSystem.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 le contenu du tableau d’octets à sa propriétéMTOM
. - Créez un objet
MyMapOf_xsd_string_To_xsd_anyType
. Cet objet de collection est utilisé pour stocker le document PDF. - Créez un objet
MyMapOf_xsd_string_To_xsd_anyType_Item
. - Affectez une valeur de chaîne qui représente le nom de la clé au champ
key
de l’objetMyMapOf_xsd_string_To_xsd_anyType_Item
. Cette valeur doit correspondre à celle de l’élément source PDF spécifié dans le document DDX. - Affectez l’objet
BLOB
qui stocke le document PDF au champvalue
de l’objetMyMapOf_xsd_string_To_xsd_anyType_Item
. - Ajoutez l’objet
MyMapOf_xsd_string_To_xsd_anyType_Item
à l’objetMyMapOf_xsd_string_To_xsd_anyType
. Appelez la méthodeAdd
de l’objetMyMapOf_xsd_string_To_xsd_anyType
et transmettez l’objetMyMapOf_xsd_string_To_xsd_anyType
.
- Créez un objet
-
Définissez les options d’exécution.
- Créez un objet
AssemblerOptionSpec
qui stocke les options d’exécution en utilisant son constructeur. - Définissez les options d’exécution pour répondre à vos exigences professionnelles en attribuant une valeur à un membre de données qui appartient à l’objet
AssemblerOptionSpec
. Par exemple, pour demander au service Assembler de continuer à traiter une tâche en cas d’erreur, affectezfalse
aux données membresfailOnError
de l’objetAssemblerOptionSpec
.
- Créez un objet
-
Récupérez les informations sur le document PDF.
Appelez la méthode
invoke
de l’objetAssemblerServiceService
et transmettez les valeurs suivantes :- Un objet
BLOB
qui représente le document DDX. - L’objet
MyMapOf_xsd_string_To_xsd_anyType
qui contient le document PDF d’entrée. Ses clés doivent correspondre aux noms des fichiers source PDF et ses valeurs doivent être celles de l’objetBLOB
qui correspond au fichier PDF d’entrée. - Un objet
AssemblerOptionSpec
qui spécifie les options d’exécution.
La méthode
invoke
renvoie un objetAssemblerResult
qui contient des données XML spécifiant si le document PDF d’entrée est un document PDF/A. - Un objet
-
Enregistrez le document XML renvoyé.
Pour obtenir des données XML qui spécifient si le document PDF d’entrée est un document PDF/A, effectuez les actions suivantes :
- Accédez au champ
documents
de l’objetAssemblerResult
, qui est un objetMap
contenant les données XML qui spécifient si le document PDF d’entrée est un document PDF/A. - Effectuez une itération par le biais de l’objet
Map
pour obtenir chaque document généré. Convertissez ensuite la valeur de ce membre de tableau enBLOB
. - Extrayez les données binaires qui représentent les données XML en accédant au champ
MTOM
de leur objetBLOB
. Ce champ stocke un tableau d’octets que vous pouvez écrire en tant que fichier XML.
- Accédez au champ
Voir également
Appeler AEM Forms en utilisant MTOM