Über den DocConverter-Service
Der DocConverter-Service kann PDF-Dokumente in PDA/A-Dokumente konvertieren. Sie können mit diesem Service folgende Aufgaben ausführen:
Weitere Informationen zum DocConverter-Service finden Sie in der Service-Referenz für AEM Forms.
Sie können den DocConverter-Service verwenden, um ein PDF-Dokument in ein PDF/A-Dokument zu konvertieren. Da PDF/A ein Archivierungsformat für die langfristige Beibehaltung des Dokumentinhalts ist, werden alle Schriftarten eingebettet und die Datei nicht komprimiert. PDF/A-Dokumente sind daher in der Regel größer als normale PDF-Dokumente. Außerdem enthalten PDF/A-Dokumente keine Audio- und Videoinhalte. Bevor Sie ein PDF-Dokument in ein PDF/A-Dokument konvertieren, stellen Sie sicher, dass das PDF-Dokument kein PDF/A-Dokument ist.
Die PDF/A-1-Spezifikation besteht aus den Konformitätsstufen A und B. Der Hauptunterschied zwischen den beiden besteht in Bezug auf die Unterstützung der logischen Struktur (Barrierefreiheit), die für Konformitätsstufe B nicht erforderlich ist. Unabhängig von der Konformitätsstufe bestimmt PDF/A-1, dass alle Schriftarten in das generierte PDF/A-Dokument eingebettet sind. Derzeit wird bei der Gültigkeitsprüfung (und Konvertierung) nur PDF/A-1b unterstützt.
PDF/A ist zwar der Standard für die Archivierung von PDF-Dokumenten, es ist jedoch nicht erforderlich, dass PDF/A zur Archivierung verwendet wird, wenn ein standardmäßiges PDF-Dokument den Anforderungen Ihrer Firma entspricht. Der PDF/A-Standard dient der Erstellung einer PDF-Datei, die für die langfristige Archivierung und Dokumentenerhaltung bestimmt ist.
Weitere Informationen zum DocConverter-Service finden Sie in der Service-Referenz für AEM Forms.
Führen Sie die folgenden Scjritte aus, um ein PDF-Dokument in ein PDF/A-Dokument zu konvertieren:
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
Weitere Informationen über den Speicherort dieser JAR-Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen eines DocConvert-Clients
Bevor Sie einen DocConverter-Vorgang programmgesteuert ausführen können, müssen Sie einen DocConverter-Client erstellen. Erstellen Sie ein DocConverterServiceClient
-Objekt, wenn Sie die Java-API verwenden. Wenn Sie die DocConverter-Webservice-API verwenden, erstellen Sie ein DocConverterServiceService
-Objekt.
Referenzieren eines PDF-Dokuments zur Konvertierung in ein PDF/A-Dokument
Rufen Sie das PDF-Dokument ab, welches in ein PDF/A-Dokument konvertiert werden soll. Wenn Sie versuchen, ein PDF-Dokument, z. B. ein Acrobat-Formular, in ein PDF/A-Dokument zu konvertieren, wird eine Ausnahme ausgelöst.
Festlegen von Tracking-Informationen
Sie können eine Laufzeitoption festlegen, die bestimmt, wie viele Informationen während des Konvertierungsprozesses nachverfolgt werden. Das heißt, Sie können neun verschiedene Ebenen festlegen, die angeben, wie viele Informationen der DocConverter-Service nachverfolgt, wenn ein PDF-Dokument in ein PDF/A-Dokument konvertiert wird.
Konvertieren des Dokuments
Nachdem Sie den DocConverter-Service-Client erstellt haben, referenzieren Sie das zu konvertierende PDF-Dokument und legen die Laufzeitoption fest, die angibt, wie viele Informationen nachverfolgt werden. Dann konvertieren Sie das PDF-Dokument in ein PDF/A-Dokument.
Speichern des PDF/A-Dokuments
Sie können das PDF/A-Dokument als PDF-Datei speichern.
Siehe auch
Konvertieren von Dokumenten in PDF/A-Dokumente mithilfe der Java-API
Konvertieren von Dokumenten in PDF/A-Dokumente mithilfe der Webservice-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Programmatische Bestimmung der PDF/A-Konformität
Konvertieren Sie ein PDF-Dokument mithilfe der Java-API in ein PDF/A-Dokument:
Projektdateien einschließen
Fügen Sie Client-JAR-Dateien wie „adobe-livecycle-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines DocConvert-Clients
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält.DocConverterServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Referenzieren eines PDF-Dokuments zur Konvertierung in ein PDF/A-Dokument
java.io.FileInputStream
-Objekt, das das zu konvertierende PDF-Dokument mithilfe des Konstruktors darstellt und einen Zeichenfolgenwert übergibt, der den Speicherort der PDF-Datei angibt.com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream
-Objekt übergeben.Festlegen von Tracking-Informationen
PDFAConversionOptionSpec
, indem Sie den Konstruktor verwenden.setLogLevel
des PDFAConversionOptionSpec
-Objekt verwenden und einen Zeichenfolgenwert übergeben, der die Tracking-Ebene angibt. Beispielsweise können Sie den Wert FINE
übergeben. Weitere Informationen zu den verschiedenen Werten finden Sie unter der Beschreibung der setLogLevel
-Methode in der AEM Forms API-Referenz.Dokument konvertieren
Konvertieren Sie das PDF-Dokument in ein PDF/A-Dokument, indem Sie die toPDFA
-Methode des DocConverterServiceClient
-Objekts aufrufen und die folgenden Werte übergeben:
com.adobe.idp.Document
-Objekt, in dem das zu konvertierende PDF-Dokument enthalten istPDFAConversionOptionSpec
-Objekt, in dem Tracking-Daten enthalten sindDie toPDFA
-Methode gibt ein PDFAConversionResult
-Objekt zurück, in dem das PDF/A-Dokument enthalten ist.
PDF/A-Dokument speichern
getPDFA
-Methode des PDFAConversionResult
-Objekts aufrufen. Diese Methode gibt ein com.adobe.idp.Document
-Objekt zurück, welches das PDF/A-Dokument darstellt.java.io.File
-Objekt, das die PDF/A-Datei darstellt. Stellen Sie sicher, dass die Dateinamenerweiterung .pdf lautet.copyToFile
-Methode des com.adobe.idp.Document
-Objekts aufrunfen und das java.io.File
-Objekt übergeben.Siehe auch
Kurzanleitung (SOAP-Modus): Konvertieren eines Dokuments in ein PDF/A-Dokument mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Konvertieren eines PDF-Dokuments in ein PDF/A-Dokument anhand der DocConverter-API (Webervice):
Projektdateien einschließen
Erstellen eines DocConvert-Clients
DocConverterServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen.Credentials
Datenelement des DocConverterServiceService
-Elements auf einen System.Net.NetworkCredential
-Wert, der den Benutzernamen und das Passwort enthät.Referenzieren eines PDF-Dokuments zur Konvertierung in ein PDF/A-Dokument
BLOB
, indem Sie den Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern des PDF-Dokuments verwendet, das in ein PDF/A-Dokument konvertiert wird.System.IO.FileStream
-Objekt durch Aufrufen des Konstruktors und Übergeben eines Zeichenfolgenwerts, der den Dateispeicherort des PDF-Dokuments und den Modus zum Öffnen der Datei enthält.System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length
-Eigenschaft des System.IO.FileStream
-Objekts abrufen.Read
-Methode des System.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.BLOB
-Objekt, indem Sie die Inhalte des Byte-Arrays seiner binaryData
-Eigenschaft zuweisen.Festlegen von Tracking-Informationen
PDFAConversionOptionSpec
, indem Sie den Konstruktor verwenden.logLevel
-Datenelement des PDFAConversionOptionSpec
-Objekts einen Wert zuweisen, welcher der Ebene der Nachverfolgung entspricht. Weisen Sie diesem Datenelement beispielsweise den Wert FINE
.Dokument konvertieren
Konvertieren Sie das PDF-Dokument in ein PDF/A-Dokument, indem Sie die toPDFA
-Methode des DocConverterServiceService
-Objekts aufrufen und die folgenden Werte übergeben:
BLOB
-Objekt, in dem das zu konvertierende PDF-Dokument enthalten istPDFAConversionOptionSpec
-Objekt, in dem Tracking-Daten enthalten sindDie toPDFA
-Methode gibt ein PDFAConversionResult
-Objekt zurück, in dem das PDF/A-Dokument enthalten ist.
PDF/A-Dokument speichern
BLOB
-Objekt, in dem das PDF/A-Dokument gespeichert wird, indem Sie den Wert des PDFADocument
-Datenelements des PDFAConversionResult
-Objekts abrufen.BLOB
-Objekts gespeichert wird, das bei der Anwendung des PDFAConversionResult
-Objekts zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des binaryData
-Datenelements des BLOB
-Objekts abrufen.System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF/A-Dokuments angibt.System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor verwenden und das System.IO.FileStream
-Objekt übergeben.Write
des System.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Erstellen einer .NET-Client-Zusammenführung, die Base64-Kodierung verwendet
Mit dem DocConverter-Service können Sie ermitteln, ob ein PDF-Dokument PDF/A-kompatibel ist. Informationen zu PDF/A-Dokumenten und zum Konvertieren eines PDF-Dokuments in ein PDF/A-Dokument finden Sie unter Konvertieren von Dokumenten in PDF/A-Dokumente.
Weitere Informationen zum DocConverter-Service finden Sie in der Service-Referenz für AEM Forms.
Um die Kompatibilität mit dem PDF/A-Format zu ermitteln, führen Sie die folgenden Schritte aus:
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
Weitere Informationen über den Speicherort dieser JAR-Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen eines DocConvert-Clients
Bevor Sie einen DocConverter-Vorgang programmgesteuert ausführen können, müssen Sie einen DocConverter-Client erstellen. Erstellen Sie ein DocConverterServiceClient
-Objekt, wenn Sie die Java-API verwenden. Wenn Sie die Web-Service-API für DocConverter verwenden, erstellen Sie ein DocConverterServiceService
-Objekt.
Referenzieren eines PDF-Dokuments zur Bestimmung der PDF/A-Konformität
Ein PDF-Dokument muss referenziert und an den DocConverter-Dienst übergeben werden, um festzustellen, ob das PDF-Dokument PDF/A-kompatibel ist.
Festlegen von Laufzeitoptionen
Sie können eine Laufzeitoption festlegen, die bestimmt, wie viele Informationen während des Konvertierungsprozesses nachverfolgt werden. Das heißt, Sie können neun verschiedene Stufen festlegen, die angeben, wie viele Informationen der DocConverter-Service beim Konvertieren eines PDF-Dokuments in ein PDF/A-Dokument nachverfolgt.
Abrufen von Informationen zum PDF-Dokument
Nachdem Sie den Client für den DocConverter-Service erstellt, das PDF-Dokument referenziert und die Laufzeitoptionen eingestellt haben, können Sie ermitteln, ob das PDF-Dokument ein PDF/A-konformes Dokument ist.
Siehe auch
Ermitteln der PDF/A-Konformität mithilfe der Java-API
Ermitteln der PDF/A-Konformität mithilfe der Web-Service-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Bestimmen Sie mithilfe der Java-API die Konformität mit PDF/A:
Projektdateien einschließen
Fügen Sie Client-JAR-Dateien wie „adobe-livecycle-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines DocConvert-Clients
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält.DocConverterServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Referenzieren eines PDF-Dokuments zur Ermittlung der PDF/A-Konformität
java.io.FileInputStream
-Objekt, das das zu konvertierende PDF-Dokument darstellt und übergeben Sie einen Zeichenfolgenwert, der den Speicherort der PDF-Datei angibt.com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream
-Objekt übergeben.Festlegen von Laufzeitoptionen
PDFAValidationOptionSpec
, indem Sie den Konstruktor verwenden.setCompliance
des PDFAValidationOptionSpec
-Objekts aufrufen und PDFAValidationOptionSpec.Compliance.PDFA_1B
übergeben.setLogLevel
des PDFAValidationOptionSpec
-Objekts aufrufen und einen Zeichenfolgenwert übergeben, der die Tracking-Stufe angibt. Beispielsweise können Sie den Wert FINE
übergeben. Weitere Informationen zu den verschiedenen Werten finden Sie unter „Methode setLogLevel
“ in der AEM Forms API-Referenz.Abrufen von Informationen zum PDF-Dokument
Ermitteln Sie die PDF/A-Konformität, indem Sie die Methode DocConverterServiceClient
des Objekts isPDFA
aufrufen und die folgenden Werte übergeben:
com.adobe.idp.Document
-Objekt, das das PDF-Dokument enthält.PDFAValidationOptionSpec
-Objekt, das Laufzeitoptionen angibt.Die Methode isPDFA
gibt ein PDFAValidationResult
-Objekt zurück, das die Ergebnisse dieses Vorgangs enthält.
Siehe auch
Kurzanleitung (SOAP-Modus): Bestimmen der PDF/A-Kompatibilität mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Ermitteln der PDF/A-Konformität mithilfe der Web-Service-API:
Projektdateien einschließen
Erstellen eines DocConvert-Clients
DocConverterServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen.DocConverterServiceService
des Credentials
-Objekts auf einen System.Net.NetworkCredential
-Wert, der den Benutzernamen und den Passwortwert angibt.Referenzieren eines PDF-Dokuments zur Ermittlung der PDF/A-Konformität
BLOB
, indem Sie den Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern des PDF-Dokuments verwendet, das in ein PDF/A-Dokument konvertiert wird.System.IO.FileStream
-Objekt durch Aufrufen des Konstruktors und Übergeben eines Zeichenfolgenwerts, der den Dateispeicherort des PDF-Dokuments und den Modus zum Öffnen der Datei enthält.System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length
-Eigenschaft des System.IO.FileStream
-Objekts abrufen.Read
-Methode des System.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.BLOB
-Objekt, indem Sie dessen binaryData
-Eigenschaft den Inhalt des Byte-Arrays zuweisen.Festlegen von Laufzeitoptionen
PDFAValidationOptionSpec
, indem Sie den Konstruktor verwenden.compliance
des PDFAValidationOptionSpec
-Objekts den Wert PDFAConversionOptionSpec_Compliance.PDFA_1B
zuweisen.resultLevel
des PDFAValidationOptionSpec
-Objekts den Wert PDFAValidationOptionSpec_ResultLevel.DETAILED
zuweisen.Abrufen von Informationen zum PDF-Dokument
Ermitteln Sie die PDF/A-Konformität, indem Sie die Methode DocConverterServiceService
des Objekts isPDFA
aufrufen und die folgenden Werte übergeben:
BLOB
-Objekt, das das PDF-Dokument enthält.PDFAValidationOptionSpec
-Objekt, das Laufzeitoptionen enthält.Die Methode isPDFA
gibt ein PDFAValidationResult
-Objekt zurück, das die Ergebnisse dieses Vorgangs enthält.
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Erstellen einer .NET-Client-Zusammenführung, die Base64-Kodierung verwendet