Informationen zum DocConverter-Dienst
Der DocConverter-Dienst kann PDF-Dokumente in PDA/A-Dokumente konvertieren. Sie können diese Aufgaben mit diesem Dienst ausführen:
Weitere Informationen zum DocConverter-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Mit dem DocConverter-Dienst können Sie ein PDF-Dokument in ein PDF/A-Dokument konvertieren. Da PDF/A ein Archivierungsformat für die langfristige Speicherung des Dokuments 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 zwei Stufen der Konformität, nämlich A und B. Der Hauptunterschied zwischen den beiden besteht in der Unterstützung der logischen Struktur (Zugänglichkeit), die für die Konformitätsstufe B nicht erforderlich ist. Unabhängig von der Konformitätsstufe schreibt PDF/A-1 vor, dass alle Schriftarten in das generierte PDF/A-Dokument eingebettet sind. Derzeit wird nur PDF/A-1b bei der Überprüfung (und Konvertierung) unterstützt.
PDF/A ist zwar der Standard für die Archivierung von PDF-Dokumenten, es ist jedoch nicht erforderlich, dass PDF/A für die Archivierung verwendet wird, wenn ein Standard-PDF-Dokument die Anforderungen Ihrer Firma erfüllt. Der PDF/A-Standard dient dazu, eine PDF-Datei zu erstellen, die für langfristige Archivierungs- und Dokument-Schutzbedürfnisse gedacht ist.
Weitere Informationen zum DocConverter-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
So konvertieren Sie ein PDF-Dokument in ein PDF/A-Dokument:
Projektdateien einschließen
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 Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen 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. Wenn Sie die Java-API verwenden, erstellen Sie ein DocConverterServiceClient
-Objekt. Wenn Sie die DocConverter-Webdienst-API verwenden, erstellen Sie ein DocConverterServiceService
-Objekt.
Referenzieren eines PDF-Dokuments zur Konvertierung in ein PDF/A-Dokument
Rufen Sie ein PDF-Dokument ab, das 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 Verfolgungsinformationen
Sie können eine Laufzeitoption festlegen, die bestimmt, wie viele Informationen während des Konvertierungsprozesses verfolgt werden. Das heißt, Sie können neun verschiedene Ebenen festlegen, die angeben, wie viele Informationen der DocConverter-Dienst verfolgt, wenn ein PDF-Dokument in ein PDF/A-Dokument konvertiert wird.
Dokument konvertieren
Nachdem Sie den DocConverter-Dienstclient erstellt haben, verweisen Sie auf das zu konvertierende PDF-Dokument und legen Sie die Laufzeitoption fest, die angibt, wie viele Informationen verfolgt werden, und Sie können das PDF-Dokument in ein PDF/A-Dokument konvertieren.
PDF/A-Dokument speichern
Sie können das PDF/A-Dokument als PDF-Datei speichern.
Siehe auch
Konvertieren von Dokumenten in PDF/A-Dokumente mit der Java-API
Konvertieren von Dokumenten in PDF/A-Dokumente mithilfe der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Programmgesteuertes Bestimmen der PDF/A-Kompatibilität
Konvertieren eines PDF-Dokuments in ein PDF/A-Dokument mithilfe der Java-API:
Projektdateien einschließen
Schließen Sie Client-JAR-Dateien wie "adobe-docconverter-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 Verfolgungsinformationen
PDFAConversionOptionSpec
, indem Sie den Konstruktor verwenden.PDFAConversionOptionSpec
-Methode des Objekts setLogLevel
aufrufen und einen Zeichenfolgenwert übergeben, der die Verfolgungsstufe angibt. Geben Sie beispielsweise den Wert FINE
an. Informationen zu den verschiedenen Werten finden Sie in 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, das das zu konvertierende PDF-Dokument enthältPDFAConversionOptionSpec
-Objekt, das Verfolgungsinformationen angibtDie toPDFA
-Methode gibt ein PDFAConversionResult
-Objekt zurück, das das PDF/A-Dokument enthält.
PDF/A-Dokument speichern
PDFAConversionResult
-Objektmethode getPDFA
aufrufen. Diese Methode gibt ein com.adobe.idp.Document
-Objekt zurück, das das PDF/A-Dokument darstellt.java.io.File
-Objekt, das die PDF/A-Datei darstellt. Stellen Sie sicher, dass die Dateinamenerweiterung .pdf lautet.com.adobe.idp.Document
-Methode des Objekts copyToFile
aufrufen und das java.io.File
-Objekt übergeben.Siehe auch
Quick Beginn (SOAP-Modus): Konvertieren eines Dokuments in ein PDF/A-Dokument mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Konvertieren Sie ein PDF-Dokument mithilfe der DocConverter-API (Webdienst) in ein PDF/A-Dokument:
Projektdateien einschließen
Erstellen eines DocConvert-Clients
DocConverterServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen.DocConverterServiceService
mit dem Wert Credentials
fest, der den Benutzernamen und den Kennwortwert angibt.System.Net.NetworkCredential
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, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus zum Öffnen der Datei darstellt.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.System.IO.FileStream
-Methode des Objekts aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben.Read
BLOB
-Objekt, indem Sie seine binaryData
-Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.Festlegen von Verfolgungsinformationen
PDFAConversionOptionSpec
, indem Sie den Konstruktor verwenden.logLevel
-Datenmember des Objekts PDFAConversionOptionSpec
einen Wert zuweisen, der die Verfolgungsstufe angibt. Weisen Sie diesem Datenmember beispielsweise den Wert FINE
zu.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, das das zu konvertierende PDF-Dokument enthältPDFAConversionOptionSpec
-Objekt, das Verfolgungsinformationen angibtDie toPDFA
-Methode gibt ein PDFAConversionResult
-Objekt zurück, das das PDF/A-Dokument enthält.
PDF/A-Dokument speichern
BLOB
-Objekt, das das PDF/A-Dokument speichert, indem Sie den Wert des PDFAConversionResult
-Datenelements des PDFADocument
-Objekts abrufen.BLOB
-Objekts speichert, das mit dem PDFAConversionResult
-Objekt zurückgegeben wurde. Füllen Sie das Bytearray, indem Sie den Wert des BLOB
-Datenelements des Objekts binaryData
abrufen.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF/A-Dokuments darstellt.System.IO.BinaryWriter
-Objekt, indem Sie den Konstruktor aufrufen und das System.IO.FileStream
-Objekt übergeben.System.IO.BinaryWriter
-Methode des Objekts aufrufen und das Bytearray übergeben.Write
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Erstellen einer .NET-Client-Assembly, die Base64-Kodierung verwendet
Mit dem DocConverter-Dienst können Sie ermitteln, ob ein PDF-Dokument PDF/A-kompatibel ist. Informationen zu einem PDF/A-Dokument 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-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
So bestimmen Sie die PDF/A-Kompatibilität:
Projektdateien einschließen
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 Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen 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. Wenn Sie die Java-API verwenden, erstellen Sie ein DocConverterServiceClient
-Objekt. Wenn Sie die DocConverter-Webdienst-API verwenden, erstellen Sie ein DocConverterServiceService
-Objekt.
Referenzieren eines PDF-Dokuments zur Bestimmung der PDF/A-Kompatibilitä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 verfolgt werden. Das heißt, Sie können neun verschiedene Ebenen festlegen, die angeben, wie viele Informationen der DocConverter-Dienst verfolgt, wenn ein PDF-Dokument in ein PDF/A-Dokument konvertiert wird.
Abrufen von Informationen zum PDF-Dokument
Nachdem Sie den DocConverter-Dienstclient erstellt, auf das PDF-Dokument verwiesen und die Laufzeitoptionen festgelegt haben, können Sie festlegen, ob das PDF-Dokument ein PDF/A-kompatibles Dokument ist.
Siehe auch
Bestimmen der PDF/A-Kompatibilität mithilfe der Java-API
Bestimmen der PDF/A-Kompatibilität mithilfe der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Bestimmen der PDF/A-Kompatibilität mithilfe der Java-API:
Projektdateien einschließen
Schließen Sie Client-JAR-Dateien wie "adobe-docconverter-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 Bestimmung der PDF/A-Kompatibilität
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 Laufzeitoptionen
PDFAValidationOptionSpec
, indem Sie den Konstruktor verwenden.PDFAValidationOptionSpec
-Methode des Objekts setCompliance
aufrufen und PDFAValidationOptionSpec.Compliance.PDFA_1B
übergeben.PDFAValidationOptionSpec
-Methode des Objekts setLogLevel
aufrufen und einen Zeichenfolgenwert übergeben, der die Verfolgungsstufe angibt. Geben Sie beispielsweise den Wert FINE
an. Informationen zu den verschiedenen Werten finden Sie in der setLogLevel
-Methode in der AEM Forms API-Referenz.Abrufen von Informationen zum PDF-Dokument
Bestimmen Sie die PDF/A-Kompatibilität, indem Sie die DocConverterServiceClient
-Methode 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 isPDFA
-Methode gibt ein PDFAValidationResult
-Objekt zurück, das die Ergebnisse dieses Vorgangs enthält.
Siehe auch
Quick Beginn (SOAP-Modus): Bestimmen der PDF/A-Kompatibilität mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Bestimmen der PDF/A-Kompatibilität mithilfe der Webdienst-API:
Projektdateien einschließen
Erstellen eines DocConvert-Clients
DocConverterServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen.DocConverterServiceService
mit dem Wert Credentials
fest, der den Benutzernamen und den Kennwortwert angibt.System.Net.NetworkCredential
Referenzieren eines PDF-Dokuments zur Bestimmung der PDF/A-Kompatibilitä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, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus zum Öffnen der Datei darstellt.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.System.IO.FileStream
-Methode des Objekts aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben.Read
BLOB
-Objekt, indem Sie seine binaryData
-Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.Festlegen von Laufzeitoptionen
PDFAValidationOptionSpec
, indem Sie den Konstruktor verwenden.PDFAValidationOptionSpec
-Objekt das compliance
-Datenelement mit dem Wert PDFAConversionOptionSpec_Compliance.PDFA_1B
zuweisen.PDFAValidationOptionSpec
-Objekt das resultLevel
-Datenelement mit dem Wert PDFAValidationOptionSpec_ResultLevel.DETAILED
zuweisen.Abrufen von Informationen zum PDF-Dokument
Bestimmen Sie die PDF/A-Kompatibilität, indem Sie die DocConverterServiceService
-Methode des Objekts isPDFA
aufrufen und die folgenden Werte übergeben:
BLOB
-Objekt, das das PDF-Dokument enthält.PDFAValidationOptionSpec
-Objekt, das Laufzeitoptionen enthält.Die isPDFA
-Methode 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-Assembly, die Base64-Kodierung verwendet