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
ServiceClientFactoryqui contient des propriétés de connexion. - Créez un objet
AssemblerServiceClienten 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.FileInputStreamrepré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émentPDFAValidationcontenu dans un élémentDocumentInformation. - Créez un objet
com.adobe.idp.Documenten 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.FileInputStreamen 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.Documenten utilisant son constructeur et en transmettant l’objetjava.io.FileInputStreamcontenant le document PDF. -
Créez un objet
java.util.Mapservant à stocker le document PDF d’entrée en utilisant un constructeurHashMap. -
Ajoutez une entrée à l’objet
java.util.Mapen appelant la méthodeputcorrespondante 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.Documentcontenant le document PDF d’entrée.
-
-
Définissez les options d’exécution.
- Créez un objet
AssemblerOptionSpecqui 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éthodesetFailOnErrorde l’objetAssemblerOptionSpecet transmettezfalse.
- Créez un objet
-
Récupérez les informations sur le document PDF.
Appelez la méthode
invokeDDXde l’objetAssemblerServiceClientet transmettez les valeurs requises suivantes :- Objet
com.adobe.idp.Documentreprésentant le document DDX à utiliser - Objet
java.util.Mapqui contient le fichier PDF d’entrée servant à déterminer la conformité PDF/A - Objet
com.adobe.livecycle.assembler.client.AssemblerOptionSpecqui spécifie les options d’exécution
La méthode
invokeDDXrenvoie un objetcom.adobe.livecycle.assembler.client.AssemblerResultqui 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
getDocumentsde l’objetAssemblerResult. Cette méthode renvoie un objetjava.util.Map. - Effectuez une itération dans l’objet
java.util.Mapjusqu’à ce que vous trouviez l’objetcom.adobe.idp.Documentcible. - Appelez la méthode
copyToFilede l’objetcom.adobe.idp.Documentpour 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 localhostpar l’adresse IP du serveur hébergeant AEM Forms. -
Créez un client Assembler PDF.
-
Créez un objet
AssemblerServiceClienten utilisant son constructeur par défaut. -
Créez un objet
AssemblerServiceClient.Endpoint.Addressen 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.BasicHttpBindingen obtenant la valeur du champAssemblerServiceClient.Endpoint.Binding. Convertissez la valeur de retour enBasicHttpBinding. -
Définissez le champ
MessageEncodingde l’objetSystem.ServiceModel.BasicHttpBindingsurWSMessageEncoding.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.Basicau champBasicHttpBindingSecurity.Transport.ClientCredentialType. - Attribuez la valeur constante
BasicHttpSecurityMode.TransportCredentialOnlyau champBasicHttpBindingSecurity.Security.Mode.
- Attribuez le nom d’utilisateur AEM forms au champ
-
-
Référencez un document DX existant.
- Créez un objet
BLOBen utilisant son constructeur. L’objetBLOBsert à stocker le document DDX. - Créez un objet
System.IO.FileStreamen 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éLengthde l’objetSystem.IO.FileStream. - Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode
Readde l’objetSystem.IO.FileStreamet en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire. - Renseignez l’objet
BLOBen affectant son champMTOMau 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
BLOBen utilisant son constructeur. L’objetBLOBsert à stocker le document PDF d’entrée. - Créez un objet
System.IO.FileStreamen 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éLengthde l’objetSystem.IO.FileStream. - Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode
Readde l’objetSystem.IO.FileStreamet en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire. - Renseignez l’objet
BLOBen 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
keyde 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
BLOBqui stocke le document PDF au champvaluede 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éthodeAddde l’objetMyMapOf_xsd_string_To_xsd_anyTypeet transmettez l’objetMyMapOf_xsd_string_To_xsd_anyType.
- Créez un objet
-
Définissez les options d’exécution.
- Créez un objet
AssemblerOptionSpecqui 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, affectezfalseaux données membresfailOnErrorde l’objetAssemblerOptionSpec.
- Créez un objet
-
Récupérez les informations sur le document PDF.
Appelez la méthode
invokede l’objetAssemblerServiceServiceet transmettez les valeurs suivantes :- Un objet
BLOBqui représente le document DDX. - L’objet
MyMapOf_xsd_string_To_xsd_anyTypequi 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’objetBLOBqui correspond au fichier PDF d’entrée. - Un objet
AssemblerOptionSpecqui spécifie les options d’exécution.
La méthode
invokerenvoie un objetAssemblerResultqui 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
documentsde l’objetAssemblerResult, qui est un objetMapcontenant 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
Mappour 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
MTOMde 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