Konvertieren von PostScript in PDF-Dokumente converting-postscript-to-pdf-documents
Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.
Über den Distiller-Dienst about-the-distiller-service
Der Distiller®-Dienst konvertiert PostScript®-, Encapsulated PostScript (EPS)- und PRN-Dateien in kompakte, zuverlässige und sicherere PDF-Dateien über ein Netzwerk. Der Distiller-Dienst dient häufig zum Konvertieren großen Mengen gedruckter Dokumente in elektronische Dokumente, z. B. Rechnungen und Belege. Das Konvertieren von Dokumenten in PDF ermöglicht Unternehmen auch, ihren Kunden eine Papier- und eine elektronische Version eines Dokuments zu senden.
Konvertieren von PostScript in PDF-Dokumente converting-postscript-to-pdf-documents-inner
Hier wird beschrieben, wie Sie mit der Distiller Service API (Java- und Webdienst) PostScript- (PS), Encapsulated PostScript- (EPS) und PRN-Dateien programmgesteuert in PDF-Dokumente konvertieren können.
Zusammenfassung der Schritte summary-of-steps
Führen Sie die folgenden Schritte aus, um einen der unterstützten Typen in ein PDF-Dokument zu konvertieren:
- Schließen Sie Projektdateien ein.
- Erstellen Sie einen Distiller-Dienstclient.
- Rufen Sie die zu konvertierende Datei ab.
- Rufen Sie den PDF-Erstellungsvorgang auf.
- Speichern Sie das PDF-Dokument.
Projektdateien einbeziehen
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.
Erstellen eines Distiller-Dienstclients
Bevor Sie einen Distiller-Dienstvorgang programmgesteuert ausführen können, müssen Sie einen Distiller-Dienstclient erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein DistillerServiceClient
-Objekt. Wenn Sie die Webdienst-API verwenden, erstellen Sie ein DistillerServiceService
-Objekt.
Zu konvertierende Datei abrufen
Rufen Sie die Datei ab, die Sie konvertieren möchten. Um beispielsweise eine PS-Datei in ein PDF-Dokument zu konvertieren, müssen Sie die PS-Datei abrufen.
Aufrufen des PDF-Erstellungsvorgangs
Nachdem Sie den Service-Client erstellt haben, können Sie den PDF-Erstellungsvorgang aufrufen. Dieser Vorgang benötigt Informationen zum zu konvertierenden Dokument, einschließlich des Pfads zum Zieldokument.
Speichern Sie das PDF-Dokument
Sie können das PDF-Dokument als PDF-Datei speichern.
Siehe auch
Konvertieren einer PostScript-Datei in eine PDF mithilfe der Java-API
Konvertieren einer PostScript-Datei in eine PDF mithilfe der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Konvertieren einer PostScript-Datei in eine PDF mithilfe der Java-API convert-a-postscript-file-to-pdf-using-the-java-api
Konvertieren Sie eine PostScript-Datei mithilfe der Distiller Service API (Java) in ein PDF-Dokument:
-
Schließen Sie Projektdateien ein.
Nehmen Sie Client-JAR-Dateien, wie z. B. adobe-distiller-client.jar, in den Klassenpfad Ihres Java-Projekts auf.
-
Erstellen Sie einen Distiller-Dienstclient.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
DistillerServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Rufen Sie die zu konvertierende Datei ab.
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die zu konvertierende Datei mithilfe ihres Konstruktors darstellt und einen Zeichenfolgenwert übergibt, der den Speicherort der Datei angibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Rufen Sie den PDF-Erstellungsvorgang auf.
Rufen Sie die Methode
DistillerServiceClient
des ObjektscreatePDF
auf und übergeben Sie die folgenden Werte:- Das
com.adobe.idp.Document
-Objekt, das die zu konvertierende PS-, EPS- oder PRN-Datei darstellt - Ein
java.lang.String
-Objekt, das den Namen der zu konvertierenden Datei enthält - Ein
java.lang.String
-Objekt, das den Namen der zu verwendenden Adobe PDF-Einstellungen enthält - Ein
java.lang.String
-Objekt, das den Namen der zu verwendenden Sicherheitseinstellungen enthält - Ein optionales
com.adobe.idp.Document
Objekt, das Einstellungen enthält, die bei der Erstellung des PDF-Dokuments angewendet werden sollen - Ein optionales
com.adobe.idp.Document
-Objekt, das Metadaten enthält, die auf das PDF-Dokument angewendet werden sollen.
Die
createPDF
-Methode gibt einCreatePDFResult
-Objekt zurück, das das neue PDF-Dokument und eine eventuell erzeugte Protokolldatei enthält. Die Protokolldatei enthält in der Regel Fehler- oder Warnmeldungen, die durch den Konvertierungsauftrag erzeugt werden. - Das
-
Speichern Sie das PDF-Dokument.
Führen Sie die folgenden Schritte aus, um das neu erstellte PDF-Dokument abzurufen:
- Rufen Sie die
CreatePDFResult
-ObjektgetCreatedDocument
-Methode auf. Dadurch wird eincom.adobe.idp.Document
-Objekt zurückgegeben. - Rufen Sie die
com.adobe.idp.Document
Methode des ObjektscopyToFile
auf, um das PDF-Dokument zu extrahieren.
Um das Protokolldokument abzurufen, führen Sie die folgenden Schritte aus.
- Rufen Sie die
CreatePDFResult
Methode desgetLogDocument
Objekts auf. Dadurch wird eincom.adobe.idp.Document
-Objekt zurückgegeben. - Um das Protokolldokument zu entnehmen, rufen Sie die
copyToFile
Methode descom.adobe.idp.Document
-Objekts auf.
- Rufen Sie die
Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Konvertieren einer PostScript-Datei in eine PDF mithilfe der Webdienst-API converting-a-postscript-file-to-pdf-using-the-web-service-api
Konvertieren Sie eine PostScript-Datei in ein PDF-Dokument, indem Sie die Distiller Service API (Webservice) verwenden:
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen Sie localhost
durch die IP-Adresse des Servers, der AEM Forms hostet. -
Erstellen Sie einen Distiller-Dienstclient.
-
Erstellen Sie ein
DistillerServiceClient
-Objekt, indem Sie seinen Standardkonstruktor verwenden. -
Erstellen Sie ein
DistillerServiceClient.Endpoint.Address
-Objekt, indem Sie den KonstruktorSystem.ServiceModel.EndpointAddress
verwenden. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/DistillerService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desDistillerServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
DistillerServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
DistillerServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie den konstanten Wert
BasicHttpSecurityMode.TransportCredentialOnly
dem FeldBasicHttpBindingSecurity.Security.Mode
zu.
- Weisen Sie dem Feld
-
-
Rufen Sie die zu konvertierende Datei ab.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DiesesBLOB
-Objekt wird verwendet, um die Datei zu speichern, die in ein PDF-Dokument konvertiert werden soll. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen String-Wert übergeben, der den Speicherort der Datei und den Modus, in dem die Datei geöffnet werden soll, darstellt. - Erstellen Sie ein Byte-Array, das den Inhalt des
System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die
Read
-Methode desSystem.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben. - Füllen Sie das
BLOB
-Objekt, indem Sie seineMTOM
-Eigenschaft mit dem Inhalt des Byte-Arrays belegen.
- Erstellen Sie ein Objekt
-
Rufen Sie den PDF-Erstellungsvorgang auf.
Rufen Sie die Methode
DistillerServiceService
des ObjektsCreatePDF2
auf und übergeben Sie die folgenden erforderlichen Werte:- Das
BLOB
-Objekt, das die zu konvertierende PS-Datei darstellt - Eine Zeichenfolge, die den Pfadnamen der zu konvertierenden Datei enthält
- Ein Zeichenfolgenobjekt, das die zu verwendenden Adobe PDF-Einstellungen enthält (z. B.
Standard
) - Ein string -Objekt, das die zu verwendenden Sicherheitseinstellungen enthält (z. B.
No Securit
y) - Ein optionales
BLOB
-Objekt, das Einstellungen enthält, die beim Generieren des PDF-Dokuments angewendet werden sollen - Ein optionales
BLOB
-Objekt, das Metadateninformationen enthält, die auf das PDF-Dokument angewendet werden sollen - Ein
BLOB
-Ausgabeparameter, der zum Speichern des PDF-Dokuments verwendet wird - Ein
BLOB
-Ausgabeparameter, der zum Speichern des Protokolls verwendet wird
- Das
-
Speichern Sie das PDF-Dokument.
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort des signierten PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll. - Erstellen Sie ein Byte-Array, das den Inhalt des
BLOB
-Objekts speichert, das von derCreatePDF2
-Methode zurückgegeben wurde (der Ausgabeparameter). Füllen Sie das Byte-Array, indem Sie den Wert desBLOB
-Datenelements des ObjektsMTOM
abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Methode
Write
desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef