Konvertieren von Postscript in PDF-Dokumente

Über den Distiller-Dienst

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.

HINWEIS

Weitere Informationen zum Distiller-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Konvertieren von PostScript in PDF-Dokumente

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.

HINWEIS

Weitere Informationen zum Distiller-Dienst finden Sie unter Dienstreferenz für AEM Forms.

HINWEIS

Um PostScript-Dateien in PDF-Dokumente zu konvertieren, muss einer der folgenden Schritte auf dem Server installiert sein, der als Host für AEM Forms dient: Redistributable Package für Acrobat 9 oder Microsoft Visual C++ 2005.

Zusammenfassung der Schritte

Führen Sie die folgenden Schritte aus, um einen der unterstützten Typen in ein PDF-Dokument zu konvertieren:

  1. Projektdateien einschließen.
  2. Erstellen Sie einen Distiller-Dienstclient.
  3. Rufen Sie die zu konvertierende Datei ab.
  4. Rufen Sie den PDF-Erstellungsvorgang auf.
  5. Speichern Sie das PDF-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 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

Sie müssen die Datei abrufen, 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 Dienst-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.

PDF-Dokument speichern

Sie können das PDF-Dokument als PDF-Datei speichern.

Siehe auch

Konvertieren einer PostScript-Datei in PDF mithilfe der Java-API

Konvertieren einer PostScript-Datei in 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 PDF mithilfe der Java-API

Konvertieren einer PostScript-Datei in ein PDF-Dokument mithilfe der Distiller Service API (Java):

  1. Projektdateien einschließen.

    Schließen Sie Client-JAR-Dateien wie adobe-tiller-client.jar in den Klassenpfad Ihres Java-Projekts ein.

  2. Erstellen Sie einen Distiller-Dienstclient.

    • Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DistillerServiceClient -Objekt, indem Sie dessen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Rufen Sie die zu konvertierende Datei ab.

    • Erstellen Sie ein java.io.FileInputStream -Objekt, das die zu konvertierende Datei mithilfe des zugehörigen Konstruktors darstellt und einen string -Wert übergibt, der den Speicherort der Datei angibt.
    • Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream-Objekt übergeben.
  4. Rufen Sie den PDF-Erstellungsvorgang auf.

    Rufen Sie die createPDF -Methode des Objekts DistillerServiceClient 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 beim Generieren des PDF-Dokuments angewendet werden sollen
    • Ein optionales com.adobe.idp.Document -Objekt, das Metadateninformationen enthält, die auf das PDF-Dokument angewendet werden sollen

    Die createPDF-Methode gibt ein CreatePDFResult-Objekt zurück, das das neue PDF-Dokument und eine eventuell generierte Protokolldatei enthält. Die Protokolldatei enthält in der Regel Fehler- oder Warnmeldungen, die von der Konvertierungsanforderung generiert werden.

  5. Speichern Sie das PDF-Dokument.

    Um das neu erstellte PDF-Dokument abzurufen, führen Sie die folgenden Schritte aus:

    • Rufen Sie die getCreatedDocument -Methode des Objekts CreatePDFResult auf. Dadurch wird ein com.adobe.idp.Document -Objekt zurückgegeben.
    • Rufen Sie die copyToFile-Methode des Objekts com.adobe.idp.Document auf, um das PDF-Dokument zu extrahieren.

    Um das Protokolldokument abzurufen, führen Sie die folgenden Schritte aus.

    • Rufen Sie die getLogDocument -Methode des Objekts CreatePDFResult auf. Dadurch wird ein com.adobe.idp.Document -Objekt zurückgegeben.
    • Rufen Sie die copyToFile -Methode des Objekts com.adobe.idp.Document auf, um das Protokolldokument zu extrahieren.

Siehe auch

Zusammenfassung der Schritte

Schnellstart (SOAP-Modus): Konvertieren einer PostScript-Datei in ein PDF-Dokument mithilfe der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Konvertieren einer PostScript-Datei in PDF mithilfe der Webdienst-API

Konvertieren einer PostScript-Datei in ein PDF-Dokument mithilfe der Distiller Service API (Webdienst):

  1. Projektdateien einschließen.

    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.

    HINWEIS

    Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.

  2. Erstellen Sie einen Distiller-Dienstclient.

    • Erstellen Sie ein DistillerServiceClient -Objekt mithilfe des Standardkonstruktors.

    • Erstellen Sie ein DistillerServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/DistillerService?blob=mtom). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen. Geben Sie jedoch ?blob=mtom an, um MTOM zu verwenden.

    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DistillerServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.

    • Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. Dieser Wert stellt sicher, dass MTOM verwendet wird.

    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:

      • Weisen Sie dem Feld DistillerServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
      • Weisen Sie dem Feld DistillerServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
  3. Rufen Sie die zu konvertierende Datei ab.

    • Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Dieses BLOB-Objekt wird zum Speichern der Datei verwendet, 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 Dateispeicherort und den Modus zum Öffnen der Datei darstellt.
    • Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length -Eigenschaft des Objekts System.IO.FileStream abrufen.
    • Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
    • Füllen Sie das BLOB-Objekt, indem Sie dessen MTOM-Eigenschaft dem Inhalt des Byte-Arrays zuweisen.
  4. Rufen Sie den PDF-Erstellungsvorgang auf.

    Rufen Sie die CreatePDF2 -Methode des Objekts DistillerServiceService 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 string -Objekt, 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 Security)
    • 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
  5. Speichern Sie das PDF-Dokument.

    • Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen string -Wert, 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 der CreatePDF2 -Methode (dem Ausgabeparameter) zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB -Datenelements des Objekts MTOM abrufen.
    • Erstellen Sie ein System.IO.BinaryWriter -Objekt, indem Sie seinen Konstruktor aufrufen und das System.IO.FileStream -Objekt übergeben.
    • Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Write -Methode des Objekts System.IO.BinaryWriter aufrufen und das Byte-Array übergeben.

Siehe auch

Zusammenfassung der Schritte

AEM Forms mithilfe von MTOM aufrufen

Aufrufen von AEM Forms mithilfe von SwaRef

Auf dieser Seite