Konvertieren von Word-Dokumenten in PDF-Dokumente

In diesem Abschnitt wird beschrieben, wie Sie mit der Generate PDF-API ein Microsoft Word-Dokument programmgesteuert in ein PDF-Dokument konvertieren können.

HINWEIS
Weitere Informationen zu weiteren Dateiformaten finden Sie unter Hinzufügen der Unterstützung für weitere native Dateiformate.
HINWEIS
Weitere Informationen zum Generate PDF-Service finden Sie in der Service-Referenz für AEM Forms.

Zusammenfassung der Schritte

So konvertieren Sie ein Microsoft Word-Dokument in ein PDF-Dokument:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Generate PDF-Client.
  3. Rufen Sie die in ein PDF-Dokument zu konvertierende Datei ab.
  4. Konvertieren Sie die Datei in ein PDF-Dokument.
  5. Rufen Sie die Ergebnisse ab.

Projektdateien einschließen

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm 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 Generate PDF-Clients

Bevor Sie programmgesteuert einen Vorgang „Generate PDF“ durchführen können, müssen Sie einen Generate PDF-Service-Client erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein GeneratePdfServiceClient-Objekt. Wenn Sie die Web-Service-API verwenden, erstellen Sie ein GeneratePDFServiceService-Objekt.

Rufen Sie die in ein PDF-Dokument zu konvertierende Datei ab.

Rufen Sie das in ein PDF-Dokument zu konvertierende Microsoft Word-Dokument ab.

Konvertieren der Datei in ein PDF-Dokument

Nachdem Sie den Generate PDF-Service-Client erstellt haben, können Sie die createPDF2-Methode aufrufen. Diese Methode benötigt Informationen über das zu konvertierende Dokument, einschließlich der Dateierweiterung.

Abrufen der Ergebnisse

Nachdem die Datei in ein PDF-Dokument konvertiert worden ist, können Sie die Ergebnisse abrufen. Nachdem Sie beispielsweise eine Word-Datei in ein PDF-Dokument konvertiert haben, können Sie das PDF-Dokument abrufen und speichern.

Siehe auch

Konvertieren von Word-Dokumenten in PDF-Dokumente mithilfe der Java-API

Konvertieren von Word-Dokumenten in PDF-Dokumente mithilfe der Web-Service-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Generieren der PDF-Service-API – Schnellstarts

Konvertieren von Word-Dokumenten in PDF-Dokumente mithilfe der Java-API

Konvertieren Sie ein Microsoft Word-Dokument mithilfe der Generate PDF- API (Java) in ein PDF-Dokument:

  1. Schließen Sie Projektdateien ein.

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

  2. Erstellen Sie einen Generate PDF-Client.

    • Erstellen Sie ein ServiceClientFactory-Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein GeneratePdfServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
  3. Rufen Sie die in ein PDF-Dokument zu konvertierende Datei ab.

    • Erstellen Sie ein java.io.FileInputStream-Objekt, das die zu konvertierende Word-Datei repräsentiert, mithilfe seines Konstruktors. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort angibt.
    • Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream-Objekt übergeben.
  4. Konvertieren Sie die Datei in ein PDF-Dokument.

    Konvertieren Sie die Datei in ein PDF-Dokument, indem Sie die Methode createPDF2 des GeneratePdfServiceClient-Objekts aufrufen und die folgenden Werte übergeben:

    • Ein com.adobe.idp.Document-Objekt, das die zu konvertierende Datei darstellt.
    • Ein java.lang.String-Objekt, das die Dateierweiterung enthält.
    • Ein java.lang.String-Objekt, das die Dateitypeinstellungen enthält, die bei der Konvertierung verwendet werden sollen. Dateitypeinstellungen ermöglichen Konvertierungseinstellungen für verschiedene Dateitypen, wie etwa .doc oder .xls.
    • Ein java.lang.String-Objekt, das den Namen der zu verwendenden PDF-Einstellungen enthält. Beispielsweise können Sie Standard angeben.
    • 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 Metadaten enthält, die für das PDF-Dokument übernommen werden sollen.

    Die createPDF2-Methode gibt ein CreatePDFResult-Objekt zurück, das das neue PDF-Dokument und Protokollinformationen enthält. Die Protokolldatei enthält in der Regel Fehler- oder Warnmeldungen, die durch die Konvertierungsanfrage generiert wurden.

  5. Rufen Sie die Ergebnisse ab.

    So erhalten Sie das PDF-Dokument:

    • Rufen Sie die Methode getCreatedDocument des CreatePDFResult-Objekts auf, was ein com.adobe.idp.Document-Objekt zurückgibt.
    • Rufen Sie die Methode copyToFile des com.adobe.idp.Document-Objekts auf, um das PDF-Dokument aus dem im vorherigen Schritt erstellten Objekt zu extrahieren.

    Wenn Sie die Methode createPDF2 verwendet haben, um das Protokolldokument zu erhalten (gilt nicht für HTML-Konversionen), führen Sie die folgenden Aktionen durch:

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

Konvertieren von Word-Dokumenten in PDF-Dokumente mithilfe der Web-Service-API

So konvertieren Sie ein Microsoft Word-Dokument mithilfe der Generate PDF-API (Web-Service) in ein PDF-Dokument:

  1. 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/GeneratePDFService?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 Generate PDF-Client.

    • Erstellen Sie ein GeneratePDFServiceClient-Objekt unter Verwendung seines standardmäßigen Konstruktors.

    • Erstellen Sie mithilfe des System.ServiceModel.EndpointAddress-Konstruktors ein GeneratePDFServiceClient.Endpoint.Address-Objekt. Übergeben Sie einen Zeichenfolgenwert, der dem AEM Forms-Service die WSDL angibt (z. B. http://localhost:8080/soap/services/GeneratePDFService?blob=mtom.). Sie müssen das lc_version-Attribut nicht verwenden. Geben Sie jedoch ?blob=mtom an.

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

    • Stellen Sie das Feld MessageEncoding des Objekts System.ServiceModel.BasicHttpBinding auf WSMessageEncoding.Mtom ein. 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 GeneratePDFServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
      • Weisen Sie dem Feld GeneratePDFServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.
      • Weisen Sie den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly dem Feld BasicHttpBindingSecurity.Security.Mode zu.
  3. Rufen Sie die in ein PDF-Dokument zu konvertierende Datei ab.

    • Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird verwendet, um die Datei zu speichern, die Sie in ein PDF-Dokument konvertieren möchten.
    • Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort der zu konvertierenden Datei und den Modus zum Öffnen der Datei darstellt.
    • Erstellen Sie ein Byte-Array, das den Inhalt des System.IO.FileStream-Objekts speichert. Sie können die Größe des Byte-Arrays ermitteln, indem Sie die Eigenschaft Length des Objekts System.IO.FileStream abrufen.
    • Füllen Sie das Byte-Array mit Stream-Daten auf, indem Sie die Methode Read des System.IO.FileStream-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
    • Befüllen Sie das BLOB-Objekt, indem Sie seiner MTOM-Eigenschaft den Inhalt des Byte-Arrays zuweisen.
  4. Konvertieren Sie die Datei in ein PDF-Dokument.

    Konvertieren Sie die Datei in ein PDF-Dokument, indem Sie die Methode CreatePDF2 des GeneratePDFServiceService-Objekts aufrufen und die folgenden Werte übergeben:

    • Ein BLOB-Objekt, das die zu konvertierende Datei darstellt.
    • Eine Zeichenfolge, die die Dateierweiterung enthält.
    • Ein java.lang.String-Objekt, das die Dateitypeinstellungen enthält, die bei der Konvertierung verwendet werden sollen. Dateitypeinstellungen ermöglichen Konvertierungseinstellungen für verschiedene Dateitypen, wie etwa .doc oder .xls.
    • Ein Zeichenfolgenobjekt, das die zu verwendenden PDF-Einstellungen enthält. Sie können Folgendes angeben Standard.
    • Ein Zeichenfolgenobjekt, das die zu verwendenden Sicherheitseinstellungen enthält. Sie können Folgendes angeben 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.
    • Einen Ausgabeparameter vom Typ BLOB, der durch die CreatePDF2-Methode befüllt wird. Die CreatePDF2-Methode befüllt dieses Objekt mit dem konvertierten Dokument. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
    • Einen Ausgabeparameter vom Typ BLOB, der durch die CreatePDF2-Methode befüllt wird. Die CreatePDF2-Methode befüllt dieses Objekt mit dem Protokolldokument. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
  5. Rufen Sie die Ergebnisse ab.

    • Rufen Sie das konvertierte PDF-Dokument ab, indem Sie das Feld MTOM des BLOB-Objekts einem Byte-Array zuweisen. Das Byte-Array stellt das konvertierte PDF-Dokument dar. Stellen Sie sicher, dass Sie das BLOB-Objekt verwenden, das als Ausgabeparameter für die createPDF2-Methode dient.
    • Erstellen Sie ein System.IO.FileStream-Objekt durch Aufrufen des Konstruktors und Übergeben eines Zeichenfolgenwerts, der den Dateispeicherort des konvertierten PDF-Dokuments darstellt.
    • 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 Methode Write des System.IO.BinaryWriter-Objekts aufrufen und das Byte-Array übergeben.

Konvertieren von HTML-Dokumenten in PDF-Dokumente

In diesem Abschnitt wird beschrieben, wie Sie mit Generate PDF-API HTML-Dokumente programmgesteuert in PDF-Dokumente konvertieren können.

HINWEIS
Weitere Informationen zum Generate PDF-Dienst finden Sie in der Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Führen Sie die folgenden Schritte aus, um ein HTML-Dokument in ein PDF-Dokument zu konvertieren:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Generate PDF-Client.
  3. Rufen Sie den HTML-Inhalt ab, der in ein PDF-Dokument konvertiert werden soll.
  4. Konvertieren Sie den HTML-Inhalt in ein PDF-Dokument.
  5. Rufen Sie die Ergebnisse ab.

Projektdateien einschließen

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm 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 Generate PDF Client

Bevor Sie programmgesteuert einen Generate PDF-Vorgang durchführen können, müssen Sie einen Generate PDF-Dienstclient erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein GeneratePdfServiceClient-Objekt. Wenn Sie die Webdienst-API verwenden, erstellen Sie einen GeneratePDFServiceService.

Abrufen des HTML-Inhalts zum Konvertieren in ein PDF-Dokument

Verweisen Sie auf HTML-Inhalte, die Sie in ein PDF-Dokument konvertieren möchten. Sie können auf HTML-Inhalte wie eine HTML-Datei oder HTML-Inhalte verweisen, die über eine URL zugänglich sind.

Konvertieren des HTML-Inhalts in ein PDF-Dokument

Nachdem Sie den Dienst-Client erstellt haben, können Sie den entsprechenden PDF-Erstellungsvorgang aufrufen. Dieser Vorgang benötigt Informationen über das zu konvertierende Dokument, einschließlich des Pfads zum Zieldokument.

Ergebnisse abrufen

Nachdem der HTML-Inhalt in ein PDF-Dokument konvertiert wurde, können Sie die Ergebnisse abrufen und das PDF-Dokument speichern.

Siehe auch

Konvertieren von HTML-Inhalten in ein PDF-Dokument mithilfe der Java-API

Konvertieren von HTML-Inhalten in ein PDF-Dokument mithilfe der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Generate PDF Service-API Schnellstarts

Konvertieren von HTML-Inhalten in ein PDF-Dokument mithilfe der Java-API

Konvertieren Sie ein HTML-Dokument mithilfe der Generate PDF-API (Java) in ein PDF-Dokument:

  1. Schließen Sie Projektdateien ein.

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

  2. Erstellen Sie einen Generate PDF-Client.

    Erstellen Sie ein GeneratePdfServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. Rufen Sie den HTML-Inhalt ab, der in ein PDF-Dokument konvertiert werden soll.

    Rufen Sie HTML-Inhalte ab, indem Sie eine Zeichenfolgenvariable erstellen und eine URL zuweisen, die auf HTML-Inhalte verweist.

  4. Konvertieren Sie den HTML-Inhalt in ein PDF-Dokument.

    Rufen Sie die Methode htmlToPDF2 des GeneratePdfServiceClient-Objekts auf und übergeben Sie die folgenden Werte:

    • Ein java.lang.String-Objekt, das die URL der zu konvertierenden HTML-Datei enthält.
    • Ein java.lang.String-Objekt, das die Dateitypeinstellungen enthält, die bei der Konvertierung verwendet werden sollen. Dateitypeinstellungen können Spider-Level enthalten.
    • 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. Wenn diese Informationen nicht angegeben werden, werden die Einstellungen automatisch anhand der drei vorangehenden Parameter ausgewählt.
    • Ein optionales com.adobe.idp.Document-Objekt, das Metadateninformationen enthält, die auf das PDF-Dokument angewendet werden sollen.
  5. Rufen Sie die Ergebnisse ab.

    Die htmlToPDF2-Methode gibt ein HtmlToPdfResult-Objekt zurück, das das neue generierte PDF-Dokument enthält. Führen Sie die folgenden Schritte aus, um das neu erstellte PDF-Dokument abzurufen:

    • Rufen Sie die Methode getCreatedDocument des HtmlToPdfResult-Objekts auf. Dadurch wird ein com.adobe.idp.Document-Objekt zurückgegeben.
    • Rufen Sie die Methode copyToFile des com.adobe.idp.Document-Objekts auf, um das PDF-Dokument aus dem im vorherigen Schritt erstellten Objekt zu extrahieren.

Konvertieren von HTML-Inhalten in ein PDF-Dokument mithilfe der Webdienst-API

So konvertieren Sie HTML-Inhalte mithilfe der Generate PDF-API (Webservice) in ein PDF-Dokument:

  1. 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/GeneratePDFService?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 Generate PDF-Client.

    • Erstellen Sie ein GeneratePDFServiceClient-Objekt unter Verwendung seines standardmäßigen Konstruktors.

    • Erstellen Sie mithilfe des System.ServiceModel.EndpointAddress-Konstruktors ein GeneratePDFServiceClient.Endpoint.Address-Objekt. Übergeben Sie einen Zeichenfolgenwert, der dem AEM Forms-Service die WSDL angibt (z. B. http://localhost:8080/soap/services/GeneratePDFService?blob=mtom.). Sie müssen das lc_version-Attribut nicht verwenden. Geben Sie jedoch ?blob=mtom an.

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

    • Stellen Sie das Feld MessageEncoding des Objekts System.ServiceModel.BasicHttpBinding auf WSMessageEncoding.Mtom ein. 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 GeneratePDFServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
      • Weisen Sie dem Feld GeneratePDFServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den konstanten Wert BasicHttpSecurityMode.TransportCredentialOnly zu.
  3. Rufen Sie den HTML-Inhalt ab, der in ein PDF-Dokument konvertiert werden soll.

    Rufen Sie HTML-Inhalte ab, indem Sie eine Zeichenfolgenvariable erstellen und eine URL zuweisen, die auf HTML-Inhalte verweist.

  4. Konvertieren Sie den HTML-Inhalt in ein PDF-Dokument.

    Konvertieren Sie den HTML-Inhalt in ein PDF-Dokument, indem Sie die Methode HtmlToPDF2 des GeneratePDFServiceService-Objekts aufrufen und die folgenden Werte übergeben:

    • Eine Zeichenfolge, die den zu konvertierenden HTML-Inhalt enthält.
    • Ein java.lang.String-Objekt, das die Dateitypeinstellungen enthält, die bei der Konvertierung verwendet werden sollen.
    • Ein Zeichenfolgenobjekt, das die zu verwendenden Sicherheitseinstellungen enthält.
    • Ein optionales BLOB-Objekt, das Einstellungen enthält, die beim Erzeugen des PDF-Dokuments angewendet werden sollen.
    • Ein optionales BLOB-Objekt, das Metadateninformationen enthält, die auf das PDF-Dokument angewendet werden sollen.
    • Einen Ausgabeparameter vom Typ BLOB, der durch die CreatePDF2-Methode befüllt wird. Die CreatePDF2-Methode befüllt dieses Objekt mit dem konvertierten Dokument. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
  5. Rufen Sie die Ergebnisse ab.

    • Rufen Sie das konvertierte PDF-Dokument ab, indem Sie das Feld MTOM des BLOB-Objekts einem Byte-Array zuweisen. Das Byte-Array stellt das konvertierte PDF-Dokument dar. Stellen Sie sicher, dass Sie das BLOB-Objekt verwenden, das als Ausgabeparameter für die HtmlToPDF2-Methode dient.
    • Erstellen Sie ein System.IO.FileStream-Objekt durch Aufrufen des Konstruktors und Übergeben eines Zeichenfolgenwerts, der den Dateispeicherort des konvertierten PDF-Dokuments darstellt.
    • 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 Methode Write des System.IO.BinaryWriter-Objekts aufrufen und das Byte-Array übergeben.

Konvertieren von PDF-Dokumenten in Nicht-Bildformate

In diesem Abschnitt wird beschrieben, wie Sie mit der Generate PDF-Java-API und der Webservice-API ein PDF-Dokument programmgesteuert in eine RTF-Datei konvertieren können. Dies ist ein Beispiel für ein Nicht-Bildformat. Andere Nicht-Bildformate sind HTML, Text, DOC und EPS. Stellen Sie beim Konvertieren eines PDF-Dokuments in RTF sicher, dass das PDF-Dokument keine Formularelemente wie eine Senden-Schaltfläche enthält. Formularelemente werden nicht konvertiert.

HINWEIS
Weitere Informationen zum Generate PDF-Service finden Sie in der Service-Referenz für AEM Forms.

Zusammenfassung der Schritte

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

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Generate PDF-Client.
  3. Rufen Sie das zu konvertierende PDF-Dokument ab.
  4. Konvertieren Sie das PDF-Dokument.
  5. Speichern Sie die konvertierte Datei.

Einschließen von Projektdateien

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm 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 Generate PDF Client

Bevor Sie programmgesteuert einen Generate PDF-Vorgang durchführen können, müssen Sie einen Generate PDF-Dienstclient erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein GeneratePdfServiceClient-Objekt. Wenn Sie die Webservice-API verwenden, erstellen Sie ein GeneratePDFServiceService-Objekt.

Abrufen des zu konvertierenden PDF-Dokuments

Rufen Sie das PDF-Dokument ab, das in ein Nicht-Bildformat konvertiert werden soll.

Konvertieren des PDF-Dokuments

Nachdem Sie den Service-Client erstellt haben, können Sie den PDF-Exportvorgang aufrufen. Dieser Vorgang benötigt Informationen über das zu konvertierende Dokument, einschließlich des Pfads zum Zieldokument.

Speichern der konvertierten Datei

Speichern Sie die konvertierte Datei. Wenn Sie beispielsweise ein PDF-Dokument in eine RTF-Datei konvertieren, speichern Sie das konvertierte Dokument in eine RTF-Datei.

Siehe auch

Konvertieren eines PDF-Dokuments in eine RTF-Datei mithilfe der Java-API

Konvertieren eines PDF-Dokuments in eine RTF-Datei mithilfe der Webservice-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Generate PDF Service-API Schnellstarts

Konvertieren eines PDF-Dokuments in eine RTF-Datei mithilfe der Java-API

So konvertieren Sie ein PDF-Dokument mithilfe der Generate PDF-API (Java) in eine RTF-Datei:

  1. Schließen Sie Projektdateien ein.

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

  2. Erstellen Sie einen Generate PDF-Client.

    Erstellen Sie ein GeneratePdfServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. Rufen Sie das zu konvertierende PDF-Dokument ab.

    • Erstellen Sie ein java.io.FileInputStream-Objekt, das das zu konvertierende PDF-Dokument darstellt, indem Sie seinen Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream-Objekt übergeben.
  4. Konvertieren Sie das PDF-Dokument.

    Rufen Sie die Methode exportPDF2 des GeneratePdfServiceClient-Objekts auf und übergeben Sie die folgenden Werte:

    • Ein com.adobe.idp.Document-Objekt, das die zu konvertierende PDF-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 Adobe PDF-Einstellungen enthält.
    • Ein ConvertPDFFormatType-Objekt, das den Zieldateityp für die Konvertierung angibt.
    • Ein optionales com.adobe.idp.Document-Objekt, das Einstellungen enthält, die beim Erzeugen des PDF-Dokuments angewendet werden sollen.

    Die Methode exportPDF2 gibt ein ExportPDFResult-Objekt zurück, das die konvertierte Datei enthält.

  5. Konvertieren Sie das PDF-Dokument.

    Um die neu erstellte Datei abzurufen, führen Sie die folgenden Schritte aus:

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

Konvertieren eines PDF-Dokuments in eine RTF-Datei mithilfe der Webservice-API

Konvertieren Sie ein PDF-Dokument mithilfe der Generate PDF API (Webservice) in eine RTF-Datei:

  1. 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/GeneratePDFService?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 Generate PDF-Client.

    • Erstellen Sie ein GeneratePDFServiceClient-Objekt, indem Sie seinen Standardkonstruktor verwenden.

    • Erstellen Sie mithilfe des System.ServiceModel.EndpointAddress-Konstruktors ein GeneratePDFServiceClient.Endpoint.Address-Objekt. Übergeben Sie einen Zeichenfolgenwert, der dem AEM Forms-Service die WSDL angibt (z. B. http://localhost:8080/soap/services/GeneratePDFService?blob=mtom.). Sie müssen das lc_version-Attribut nicht verwenden. Geben Sie jedoch ?blob=mtom an.

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

    • Stellen Sie das Feld MessageEncoding des Objekts System.ServiceModel.BasicHttpBinding auf WSMessageEncoding.Mtom ein. 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 GeneratePDFServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
      • Weisen Sie dem Feld GeneratePDFServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.
      • Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den konstanten Wert BasicHttpSecurityMode.TransportCredentialOnly zu.
  3. Rufen Sie das zu konvertierende PDF-Dokument ab.

    • Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern eines konvertierten PDF-Dokuments verwendet.
    • Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Byte-Array, das den Inhalt des System.IO.FileStream-Objekts speichert. Sie können die Größe des Byte-Arrays ermitteln, indem Sie die Eigenschaft Length des Objekts System.IO.FileStream abrufen.
    • Füllen Sie das Byte-Array mit Stream-Daten auf, indem Sie die Methode Read des System.IO.FileStream-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
    • Füllen Sie das Objekt BLOB, indem Sie seiner MTOM-Eigenschaft den Inhalt des Byte-Arrays zuweisen.
  4. Konvertieren Sie das PDF-Dokument.

    Rufen Sie die Methode ExportPDF2 des GeneratePDFServiceServiceWse-Objekts auf und übergeben Sie die folgenden Werte:

    • Ein BLOB-Objekt, das die zu konvertierende PDF-Datei repräsentiert.
    • Eine Zeichenfolge, die den Pfadnamen der zu konvertierenden Datei enthält.
    • Ein java.lang.String-Objekt, das den Dateispeicherort angibt.
    • Ein Zeichenfolgenobjekt, das für die Konvertierung den Typ der Zieldatei angibt. Geben Sie RTF.
    • Ein optionales BLOB-Objekt, das Einstellungen enthält, die beim Generieren des PDF-Dokuments angewendet werden sollen.
    • Einen Ausgabeparameter vom Typ BLOB, der durch die ExportPDF2-Methode befüllt wird. Die ExportPDF2-Methode befüllt dieses Objekt mit dem konvertierten Dokument. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
  5. Speichern Sie die konvertierte Datei.

    • Rufen Sie das konvertierte PDF-Dokument ab, indem Sie das Feld MTOM des BLOB-Objekts einem Byte-Array zuweisen. Das Byte-Array repräsentiert das konvertierte RTF-Dokument. Stellen Sie sicher, dass Sie das BLOB-Objekt verwenden, das bei der ExportPDF2-Methode als Ausgabeparameter dient.
    • Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgewert, der den Speicherort der RTF-Datei repräsentiert.
    • 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 RTF-Datei, indem Sie die Methode Write des System.IO.BinaryWriter-Objekts aufrufen und das Byte-Array übergeben.