Avgöra om dokument är PDF/A-kompatibla determining-whether-documents-are-pdf-a-compliant
Du kan avgöra om ett PDF-dokument är PDF/A-kompatibelt med hjälp av Assembler-tjänsten. Ett PDF/A-dokument finns som ett arkiveringsformat som är avsett för långtidsarkivering av dokumentets innehåll. Teckensnitten bäddas in i dokumentet och filen är okomprimerad. Därför är ett PDF/A-dokument vanligtvis större än ett PDF-standarddokument. Ett PDF/A-dokument innehåller inte heller ljud- och videoinnehåll.
Specifikationen PDF/A-1 består av två överensstämmelsenivåer, nämligen A och B. Den största skillnaden mellan de två nivåerna är stödet för logisk struktur (hjälpmedel), som inte krävs för överensstämmelsenivå B. Oavsett överensstämmelsenivå anger PDF/A-1 att alla teckensnitt är inbäddade i det genererade PDF/A-dokumentet. För närvarande stöds endast PDF/A-1b vid validering (och konvertering).
Anta att följande DDX-dokument används för den här diskussionen.
<?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>
I det här DDX-dokumentet instruerar elementet DocumentInformation
Assembler-tjänsten att returnera information om indatadokumentet för PDF. I elementet DocumentInformation
instruerar elementet PDFAValidation
Assembler-tjänsten att ange om indatadokumentet är PDF/A-kompatibelt eller inte.
Assembler-tjänsten returnerar information som anger om indatadokumentet PDF är PDF/A-kompatibelt i ett XML-dokument som innehåller ett PDFAConformance
-element. Om indatadokumentet är PDF/A-kompatibelt är värdet för PDFAConformance
-elementets isCompliant
-attribut true
. Om PDF-dokumentet inte är PDF/A-kompatibelt är värdet för PDFAConformance
-elementets isCompliant
-attribut false
.
DocumentInformation
-element returnerar Assembler-tjänsten XML-data i stället för ett PDF-dokument. Det innebär att Assembler-tjänsten inte sammanställer eller demonterar ett PDF-dokument, utan returnerar information om indatadokumentet i PDF i ett XML-dokument.Sammanfattning av steg summary-of-steps
Så här avgör du om ett PDF-dokument är PDF/A-kompatibelt:
- Inkludera projektfiler.
- Skapa en PDF Assembler-klient.
- Referera till ett befintligt DDX-dokument.
- Referera till ett PDF-dokument som används för att fastställa kompatibiliteten mellan PDF och A.
- Ange körningsalternativ.
- Hämta information om PDF-dokumentet.
- Spara det returnerade XML-dokumentet.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.
Följande JAR-filer måste läggas till i projektets klasssökväg:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-assembler-client.jar
- adobe-utilities.jar (krävs om AEM Forms används i JBoss)
- jbossall-client.jar (krävs om AEM Forms används i JBoss)
Om AEM Forms körs på en annan J2EE-programserver än JBoss måste du ersätta filerna adobe-utilities.jar och jbossall-client.jar med JAR-filer som är specifika för J2EE-programservern som AEM Forms är distribuerad på. Mer information om platsen för alla AEM Forms JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.
Skapa en PDF Assembler-klient
Innan du programmässigt kan utföra en Assembler-åtgärd måste du skapa en Assembler-tjänstklient.
Referera till ett befintligt DDX-dokument
Det måste finnas referenser till ett DDX-dokument för att en Assembler-tjänståtgärd ska kunna utföras. Om du vill avgöra om ett indatadokument är PDF/A-kompatibelt kontrollerar du att DDX-dokumentet innehåller elementet PDFAValidation
i ett DocumentInformation
-element. Elementet PDFAValidation
instruerar Assembler-tjänsten att returnera ett XML-dokument som anger om det inmatade PDF-dokumentet är PDF/A-kompatibelt.
Referera till ett PDF-dokument som används för att fastställa kompatibiliteten PDF/A
Ett PDF-dokument måste refereras och skickas till Assembler-tjänsten för att avgöra om PDF-dokumentet är PDF/A-kompatibelt.
Ange körningsalternativ
Du kan ställa in körningsalternativ som styr beteendet för Assembler-tjänsten när den utför ett jobb. Du kan till exempel ange ett alternativ som instruerar Assembler-tjänsten att fortsätta bearbeta ett jobb om ett fel uppstår. Mer information om de körningsalternativ du kan ange finns i klassreferensen AssemblerOptionSpec
i AEM Forms API Reference.
Hämta information om PDF-dokumentet
När du har skapat Assembler-tjänstklienten, refererat till DDX-dokumentet, refererat till ett interaktivt PDF-dokument och angett körningsalternativ, kan du anropa åtgärden invokeDDX
. Eftersom DDX-dokumentet innehåller elementet DocumentInformation
returnerar Assembler-tjänsten XML-data i stället för ett PDF-dokument.
Spara det returnerade XML-dokumentet
Det XML-dokument som Assembler-tjänsten returnerar anger om det inmatade PDF-dokumentet är PDF/A-kompatibelt. Om indatadokumentet PDF inte är PDF/A-kompatibelt returnerar Assembler-tjänsten ett XML-dokument som innehåller följande element:
<PDFAConformance isCompliant="false" compliance="PDF/A-1b" resultLevel="Detailed" ignoreUnusedResources="true" allowCertificationSignatures="true">
Spara XML-dokumentet som en XML-fil så att du kan öppna filen och visa resultatet.
Se även
Kontrollera om ett dokument är PDF/A-kompatibelt med Java API
Kontrollera om ett dokument är PDF/A-kompatibelt med webbtjänstens API
Kontrollera om ett dokument är PDF/A-kompatibelt med Java API determine-whether-a-document-is-pdf-a-compliant-using-the-java-api
Kontrollera om ett PDF-dokument är PDF/A-kompatibelt med hjälp av Assembler Service API (Java):
-
Inkludera projektfiler.
Inkludera JAR-klientfiler, som adobe-assembler-client.jar, i Java-projektets klassökväg.
-
Skapa en PDF Assembler-klient.
- Skapa ett
ServiceClientFactory
-objekt som innehåller anslutningsegenskaper. - Skapa ett
AssemblerServiceClient
-objekt med hjälp av dess konstruktor och skickaServiceClientFactory
-objektet.
- Skapa ett
-
Referera till ett befintligt DDX-dokument.
- Skapa ett
java.io.FileInputStream
-objekt som representerar DDX-dokumentet med hjälp av dess konstruktor och skicka ett strängvärde som anger platsen för DDX-filen. Om du vill avgöra om PDF-dokumentet är PDF/A-kompatibelt kontrollerar du att DDX-dokumentet innehåller elementetPDFAValidation
som finns i ettDocumentInformation
-element. - Skapa ett
com.adobe.idp.Document
-objekt med hjälp av dess konstruktor och skickajava.io.FileInputStream
-objektet.
- Skapa ett
-
Referera till ett PDF-dokument som används för att fastställa kompatibiliteten mellan PDF och A.
-
Skapa ett
java.io.FileInputStream
-objekt med hjälp av dess konstruktor och skicka platsen för ett PDF-dokument som används för att fastställa kompatibiliteten PDF/A. -
Skapa ett
com.adobe.idp.Document
-objekt med hjälp av dess konstruktor och skicka detjava.io.FileInputStream
-objekt som innehåller PDF-dokumentet. -
Skapa ett
java.util.Map
-objekt som används för att lagra indatadokumentet i PDF med hjälp av enHashMap
-konstruktor. -
Lägg till en post i objektet
java.util.Map
genom att anropa dessput
-metod och skicka följande argument:- Ett strängvärde som representerar nyckelnamnet. Detta värde måste matcha värdet för källelementet som anges i DDX-dokumentet. Värdet för källelementet i DDX-dokumentet som introducerades i det här avsnittet är till exempel Loan.pdf.
- Ett
com.adobe.idp.Document
-objekt som innehåller indatadokumentet i PDF.
-
-
Ange körningsalternativ.
- Skapa ett
AssemblerOptionSpec
-objekt som lagrar körningsalternativ med hjälp av dess konstruktor. - Ange körningsalternativ som uppfyller dina affärskrav genom att anropa en metod som tillhör objektet
AssemblerOptionSpec
. Om du till exempel vill instruera Assembler-tjänsten att fortsätta bearbeta ett jobb när ett fel inträffar, anropar duAssemblerOptionSpec
-objektetssetFailOnError
-metod och skickarfalse
.
- Skapa ett
-
Hämta information om PDF-dokumentet.
Anropa
AssemblerServiceClient
-objektetsinvokeDDX
-metod och skicka följande obligatoriska värden:- Ett
com.adobe.idp.Document
-objekt som representerar det DX-dokument som ska användas - Ett
java.util.Map
-objekt som innehåller indatafilen PDF som används för att fastställa kompatibiliteten PDF/A - Ett
com.adobe.livecycle.assembler.client.AssemblerOptionSpec
-objekt som anger körningsalternativen
Metoden
invokeDDX
returnerar ettcom.adobe.livecycle.assembler.client.AssemblerResult
-objekt som innehåller XML-data som anger om indatadokumentet för PDF är PDF/A-kompatibelt. - Ett
-
Spara det returnerade XML-dokumentet.
Gör så här för att hämta XML-data som anger om indata-PDF-dokumentet är ett PDF/A-dokument:
- Anropa metoden
getDocuments
för objektetAssemblerResult
. Detta returnerar ettjava.util.Map
-objekt. - Upprepa genom objektet
java.util.Map
tills du hittar det resulterandecom.adobe.idp.Document
-objektet. - Anropa
com.adobe.idp.Document
-objektetscopyToFile
-metod för att extrahera XML-dokumentet. Se till att du sparar XML-data som en XML-fil.
- Anropa metoden
Se även
Snabbstart (SOAP läge): Avgör om ett dokument är PDF/A-kompatibelt med Java API(SOAP)
Kontrollera om ett dokument är PDF/A-kompatibelt med webbtjänstens API determine-whether-a-document-is-pdf-a-compliant-using-the-web-service-api
Kontrollera om ett PDF-dokument är PDF/A-kompatibelt med Assembler Service API (webbtjänst):
-
Inkludera projektfiler.
Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition:
http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1
.note note NOTE Ersätt localhost
med IP-adressen för servern som är värd för AEM Forms. -
Skapa en PDF Assembler-klient.
-
Skapa ett
AssemblerServiceClient
-objekt med hjälp av dess standardkonstruktor. -
Skapa ett
AssemblerServiceClient.Endpoint.Address
-objekt med konstruktornSystem.ServiceModel.EndpointAddress
. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempelhttp://localhost:8080/soap/services/AssemblerService?blob=mtom
). Du behöver inte använda attributetlc_version
. Detta attribut används när du skapar en tjänstreferens.) -
Skapa ett
System.ServiceModel.BasicHttpBinding
-objekt genom att hämta värdet för fältetAssemblerServiceClient.Endpoint.Binding
. Skicka returvärdet tillBasicHttpBinding
. -
Ställ in
System.ServiceModel.BasicHttpBinding
-objektetsMessageEncoding
-fält tillWSMessageEncoding.Mtom
. Detta värde garanterar att MTOM används. -
Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
- Tilldela användarnamnet för AEM formulär till fältet
AssemblerServiceClient.ClientCredentials.UserName.UserName
. - Tilldela motsvarande lösenordsvärde till fältet
AssemblerServiceClient.ClientCredentials.UserName.Password
. - Tilldela konstantvärdet
HttpClientCredentialType.Basic
till fältetBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Tilldela konstantvärdet
BasicHttpSecurityMode.TransportCredentialOnly
till fältetBasicHttpBindingSecurity.Security.Mode
.
- Tilldela användarnamnet för AEM formulär till fältet
-
-
Referera till ett befintligt DDX-dokument.
- Skapa ett
BLOB
-objekt med hjälp av dess konstruktor. ObjektetBLOB
används för att lagra DDX-dokumentet. - Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för DDX-dokumentet och läget som filen ska öppnas i. - Skapa en bytearray som lagrar innehållet i objektet
System.IO.FileStream
. Du kan bestämma storleken på bytearrayen genom att hämtaSystem.IO.FileStream
-objektetsLength
-egenskap. - Fyll i bytearrayen med strömdata genom att anropa
System.IO.FileStream
-objektetsRead
-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas. - Fyll
BLOB
-objektet genom att tilldela dessMTOM
-fält med innehållet i bytearrayen.
- Skapa ett
-
Referera till ett PDF-dokument som används för att fastställa kompatibiliteten mellan PDF och A.
- Skapa ett
BLOB
-objekt med hjälp av dess konstruktor. ObjektetBLOB
används för att lagra indatadokumentet i PDF. - Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för indata-PDF-dokumentet och läget som filen ska öppnas i. - Skapa en bytearray som lagrar innehållet i objektet
System.IO.FileStream
. Du kan bestämma storleken på bytearrayen genom att hämtaSystem.IO.FileStream
-objektetsLength
-egenskap. - Fyll i bytearrayen med strömdata genom att anropa
System.IO.FileStream
-objektetsRead
-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas. - Fyll objektet
BLOB
genom att tilldela dessMTOM
-egenskap med innehållet i bytearrayen. - Skapa ett
MyMapOf_xsd_string_To_xsd_anyType
-objekt. Det här samlingsobjektet används för att lagra dokumentet PDF. - Skapa ett
MyMapOf_xsd_string_To_xsd_anyType_Item
-objekt. - Tilldela ett strängvärde som representerar nyckelnamnet till
MyMapOf_xsd_string_To_xsd_anyType_Item
-objektetskey
-fält. Detta värde måste matcha värdet för källelementet PDF som anges i DDX-dokumentet. - Tilldela det
BLOB
-objekt som lagrar PDF-dokumentet tillMyMapOf_xsd_string_To_xsd_anyType_Item
-objektetsvalue
-fält. - Lägg till objektet
MyMapOf_xsd_string_To_xsd_anyType_Item
i objektetMyMapOf_xsd_string_To_xsd_anyType
. AnropaMyMapOf_xsd_string_To_xsd_anyType
-objektetsAdd
-metod och skickaMyMapOf_xsd_string_To_xsd_anyType
-objektet.
- Skapa ett
-
Ange körningsalternativ.
- Skapa ett
AssemblerOptionSpec
-objekt som lagrar körningsalternativ med hjälp av dess konstruktor. - Ange körningsalternativ för att uppfylla dina affärskrav genom att tilldela ett värde till en datamedlem som tillhör objektet
AssemblerOptionSpec
. Om du till exempel vill instruera Assembler-tjänsten att fortsätta bearbeta ett jobb när ett fel inträffar tilldelar dufalse
tillAssemblerOptionSpec
-objektetsfailOnError
-datamedlem.
- Skapa ett
-
Hämta information om PDF-dokumentet.
Anropa
AssemblerServiceService
-objektetsinvoke
-metod och skicka följande värden:- Ett
BLOB
-objekt som representerar DDX-dokumentet. - Objektet
MyMapOf_xsd_string_To_xsd_anyType
som innehåller indatadokumentet PDF. Dess nycklar måste matcha namnen på källfilerna i PDF och dess värden måste vara detBLOB
-objekt som motsvarar indatafilen i PDF. - Ett
AssemblerOptionSpec
-objekt som anger körningsalternativ.
Metoden
invoke
returnerar ettAssemblerResult
-objekt som innehåller XML-data som anger om PDF-indatadokumentet är ett PDF/A-dokument. - Ett
-
Spara det returnerade XML-dokumentet.
Gör så här för att hämta XML-data som anger om indata-PDF-dokumentet är ett PDF/A-dokument:
- Åtkomst till
AssemblerResult
-objektetsdocuments
-fält, som är ettMap
-objekt som innehåller XML-data som anger om indata-PDF-dokumentet är ett PDF/A-dokument. - Iterera genom objektet
Map
för att få fram varje resulterande dokument. Sedan konverterar du matrismedlemmens värde tillBLOB
. - Extrahera de binära data som representerar XML-data genom att komma åt objektets
MTOM
-fältBLOB
. I det här fältet lagras en array med byte som du kan skriva till som en XML-fil.
- Åtkomst till
Se även