Arbeiten mit XMP Utilities

Informationen zum XMP Utilities-Dienst

PDF-Dokumente enthalten Metadaten, d. h. Informationen über das Dokument, die sich vom Inhalt des Dokuments unterscheiden, z. B. Text und Grafiken. Adobe Extensible Metadata Platform (XMP) ist ein Standard für die Verarbeitung von Dokument-Metadaten.

Der XMP Utilities-Dienst kann XMP-Metadaten aus PDF-Dokumenten abrufen und speichern und XMP-Metadaten in PDF-Dokumente importieren.

Sie können diese Aufgaben mithilfe des XMP Utilities-Dienstes ausführen:

Hinweis

For more information about the XMP Utilities service, see Services Reference for AEM Forms.

Importieren von Metadaten in PDF-Dokumente

Sie können die Java- und Webdienst-APIs von XMP Utilities verwenden, um XMP-Metadaten programmgesteuert in ein PDF-Dokument zu importieren. Metadaten enthalten Informationen zu einem PDF-Dokument, z. B. den Autor des Dokuments und Schlüsselwörter zum Dokument. Metadaten können Sie im Dialogfeld "Dokument-Eigenschaften"des Dokuments finden, wie in der folgenden Abbildung dargestellt.

ww_ww_metadatadialog

Um Metadaten programmgesteuert in ein PDF-Dokument zu importieren, können Sie ein vorhandenes XML-Dokument verwenden, das die Metadatenwerte angibt, oder ein Objekt vom Typ verwenden XMPUtilityMetadata. (Siehe API-Referenz zu AEM Forms.)

Hinweis

In diesem Abschnitt wird die Verwendung eines XML-Dokuments zum Importieren von Metadaten in ein PDF-Dokument erläutert.

Der folgende XML-Code enthält Metadatenwerte, die der vorherigen Abbildung entsprechen. Beachten Sie beispielsweise die fett gedruckten Elemente, die Suchbegriffe angeben.

 <?xpacket begin="?" id="W5M0MpCehiHzreSzNTczkc9d"?>
 <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 4.2-jc015 52.349034, 2008 Jun 20 00:30:39-PDT (debug)">
       <rdf:RDF xmlns:rdf="https://www.w3.org/1999/02/22-rdf-syntax-ns#">
          <rdf:Description rdf:about=""
                xmlns:xmp="https://ns.adobe.com/xap/1.0/">
             <xmp:MetadataDate>2008-10-22T10:52:21-04:00</xmp:MetadataDate>
             <xmp:CreatorTool>AEM Forms</xmp:CreatorTool>
             <xmp:ModifyDate>2008-10-22T10:52:21-04:00</xmp:ModifyDate>
             <xmp:CreateDate>2008-02-13T11:00:18-05:00</xmp:CreateDate>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:pdf="https://ns.adobe.com/pdf/1.3/">
             <pdf:Producer>AEM Forms</pdf:Producer>
             <pdf:Keywords>keyword1, keyword2, keyword3,keyword4</pdf:Keywords>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:xmpMM="https://ns.adobe.com/xap/1.0/mm/">
             <xmpMM:DocumentID>uuid:1cce1f84-331e-4d8d-8538-15441c271dd7</xmpMM:DocumentID>
             <xmpMM:InstanceID>uuid:cdda0ca6-7c91-4771-9dc9-796c8fe59350</xmpMM:InstanceID>
          </rdf:Description>
          <rdf:Description rdf:about=""
                >
             <dc:format>application/pdf</dc:format>
             <dc:description>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Adobe Designer Sample</rdf:li>
                </rdf:Alt>
             </dc:description>
             <dc:title>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Grant Application</rdf:li>
                </rdf:Alt>
             </dc:title>
             <dc:creator>
                <rdf:Seq>
                   <rdf:li>Tony Blue</rdf:li>
                </rdf:Seq>
             </dc:creator>
             <dc:subject>
                <rdf:Bag>
                   <rdf:li>keyword1</rdf:li>
                   <rdf:li>keyword2</rdf:li>
                   <rdf:li>keyword3</rdf:li>
                   <rdf:li>keyword4</rdf:li>
                </rdf:Bag>
             </dc:subject>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:desc="https://ns.adobe.com/xfa/promoted-desc/">
             <desc:version rdf:parseType="Resource">
                <rdf:value>1.0</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:version>
             <desc:contact rdf:parseType="Resource">
                <rdf:value>Adobe Systems Incorporated</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:contact>
          </rdf:Description>
       </rdf:RDF>
 </x:xmpmeta>
Hinweis

For more information about the XMP Utilities service, see Services Reference for AEM Forms.

Zusammenfassung der Schritte

So importieren Sie XMP-Metadaten in ein PDF-Dokument:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen XMPUtilityService-Client.
  3. Rufen Sie den XMP-Metadaten-Importvorgang auf.

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.

XMPUtilityService-Client erstellen

Bevor Sie einen XMP Utilities-Vorgang programmgesteuert durchführen können, müssen Sie einen XMPUtilityService-Client erstellen. Mit der Java-API wird dies durch Erstellen eines XMPUtilityServiceClient Objekts erreicht. Mit der Webdienst-API wird dies durch Verwendung eines XMPUtilityServiceService Objekts erreicht.

XMP-Metadaten-Importvorgang aufrufen

Nachdem Sie den Dienstclient erstellt haben, können Sie einen der XMP-Metadaten-Importvorgänge aufrufen, um die XMP-Metadaten in das angegebene PDF-Dokument zu importieren.

Siehe auch

Importieren von XMP-Metadaten mit der Java-API

Importieren von XMP-Metadaten mit der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Importieren von XMP-Metadaten mit der Java-API

Importieren von XMP-Metadaten mit der XMP Utilities API (Java):

  1. Projektdateien einschließen

    Schließen Sie Client-JAR-Dateien wie "adobe-pdfutility-client.jar"im Klassenpfad Ihres Java-Projekts ein.

    Hinweis

    Die Datei "adobe-pdfutility-client.jar"enthält Klassen, mit denen Sie den XMP Utilities-Dienst programmgesteuert aufrufen können.

  2. XMPUtilityService-Client erstellen

    Erstellen Sie ein XMPUtilityServiceClient Objekt, indem Sie dessen Konstruktor verwenden und ein ServiceClientFactory Objekt übergeben, das Verbindungseigenschaften enthält.

  3. XMP-Metadaten-Importvorgang aufrufen

    Um die XMP-Metadaten zu ändern, rufen Sie entweder die XMPUtilityServiceClient Methode des importMetadata Objekts oder seine importXMP Methode auf.

    Wenn Sie die importMetadata Methode verwenden, geben Sie die folgenden Werte ein:

    • Ein com.adobe.idp.Document Objekt, das die PDF-Datei darstellt.
    • Ein XMPUtilityMetadata Objekt, das die zu importierenden Metadaten enthält.

    Wenn Sie die importXMP Methode verwenden, geben Sie die folgenden Werte ein:

    • Ein com.adobe.idp.Document Objekt, das die PDF-Datei darstellt.
    • Ein com.adobe.idp.Document Objekt, das eine XML-Datei mit den zu importierenden Metadaten darstellt.

    In beiden Fällen ist der zurückgegebene Wert ein com.adobe.idp.Document Objekt, das die PDF-Datei mit den neu importierten Metadaten darstellt. Sie können dieses Objekt dann auf der Festplatte speichern.

Siehe auch

Importieren von Metadaten in PDF-Dokumente

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Importieren von XMP-Metadaten mit der Webdienst-API

So importieren Sie XMP-Metadaten programmgesteuert mit der XMP Utilities-Webdienst-API:

  1. Projektdateien einschließen

  2. XMPUtilityService-Client erstellen

    Erstellen Sie ein XMPUtilityServiceService Objekt mithilfe des Proxyklassenkonstruktors.

  3. XMP-Metadaten-Importvorgang aufrufen

    Um die XMP-Metadaten zu ändern, rufen Sie entweder die XMPUtilityServiceService Methode des importMetadata Objekts oder seine importXMP Methode auf.

    Wenn Sie die importMetadata Methode verwenden, geben Sie die folgenden Werte ein:

    • Ein BLOB Objekt, das die PDF-Datei darstellt.
    • Ein XMPUtilityMetadata Objekt, das die zu importierenden Metadaten enthält.

    Wenn Sie die importXMP Methode verwenden, geben Sie die folgenden Werte ein:

    • Ein BLOB Objekt, das die PDF-Datei darstellt.
    • Ein BLOB Objekt, das eine XML-Datei mit den zu importierenden Metadaten darstellt.

    In beiden Fällen ist der zurückgegebene Wert ein BLOB Objekt, das die PDF-Datei mit den neu importierten Metadaten darstellt. Sie können dieses Objekt dann auf der Festplatte speichern.

Siehe auch

Importieren von Metadaten in PDF-Dokumente

Aufrufen von AEM Forms mit der Base64-Kodierung

Erstellen einer .NET-Client-Assembly, die Base64-Kodierung verwendet

Exportieren von Metadaten aus PDF-Dokumenten

Sie können die Java- und Webdienst-APIs von XMP Utilities verwenden, um XMP-Metadaten programmgesteuert aus einem PDF-Dokument abzurufen und zu speichern.

Hinweis

For more information about the XMP Utilities service, see Services Reference for AEM Forms.

Zusammenfassung der Schritte

So exportieren Sie XMP-Metadaten aus einem PDF-Dokument:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen XMPUtilityService-Client.
  3. Rufen Sie den XMP-Metadaten-Exportvorgang auf.

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.

XMPUtilityService-Client erstellen

Bevor Sie einen XMP Utilities-Vorgang programmgesteuert durchführen können, müssen Sie einen XMPUtilityService-Client erstellen. Mit dem Java-API wird dies durch Erstellen eines XMPUtilityServiceClient Objekts erreicht. Mit der Webdienst-API wird dies mithilfe eines XMPUtilityServiceService Objekts erreicht.

XMP-Metadaten-Exportvorgang aufrufen

Nachdem Sie den Dienstclient erstellt haben, können Sie einen der XMP-Metadaten-Exportvorgänge aufrufen, die zum Überprüfen der XMP-Metadaten oder zum Speichern auf der Festplatte verwendet werden können.

Siehe auch

Importieren von XMP-Metadaten mit der Java-API

Importieren von XMP-Metadaten mit der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

XMP-Metadaten mit der Java-API exportieren

Exportieren Sie XMP-Metadaten mit der XMP Utilities API (Java):

  1. Projektdateien einschließen

    Schließen Sie Client-JAR-Dateien wie "adobe-pdfutility-client.jar"im Klassenpfad Ihres Java-Projekts ein.

    Hinweis

    Die Datei "adobe-pdfutility-client.jar"enthält Klassen, mit denen Sie den XMP-Dienstprogrammdienst programmgesteuert aufrufen können.

  2. XMPUtilityService-Client erstellen

    Erstellen Sie ein XMPUtilityServiceClient Objekt, indem Sie dessen Konstruktor verwenden und ein ServiceClientFactory Objekt übergeben, das Verbindungseigenschaften enthält.

  3. XMP-Metadaten-Importvorgang aufrufen

    Um die XMP-Metadaten zu überprüfen, rufen Sie die XMPUtilityServiceClient Methode des exportMetadata Objekts auf und übergeben Sie ein com.adobe.idp.Document Objekt, das die PDF-Datei darstellt. Die Methode gibt ein XMPUtilityMetadata Objekt zurück, das die abgerufenen Metadaten enthält.

    Um die XMP-Metadaten abzurufen und zu speichern, rufen Sie die XMPUtilityServiceClient Methode des exportXMP Objekts auf und übergeben Sie ein com.adobe.idp.Document Objekt, das die PDF-Datei darstellt. Die Methode gibt ein com.adobe.idp.Document Objekt zurück, das die abgerufenen Metadaten enthält, die Sie anschließend als XML-Datei auf der Festplatte speichern können.

Siehe auch

Exportieren von Metadaten aus PDF-Dokumenten

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Exportieren von XMP-Metadaten mit der Webdienst-API

Exportieren Sie XMP-Metadaten mit der XMP Utilities API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die WSDL-Datei des XMP Utilities-Dienstes verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. XMPUtilityService-Client erstellen

    Erstellen Sie ein XMPUtilityServiceService Objekt mithilfe des Proxyklassenkonstruktors.

  3. XMP-Metadaten-Importvorgang aufrufen

    Um die XMP-Metadaten zu überprüfen, rufen Sie die XMPUtilityServiceClient Methode des exportMetadata Objekts auf und übergeben Sie ein BLOB Objekt, das die PDF-Datei darstellt. Die Methode gibt ein XMPUtilityMetadata Objekt zurück, das die abgerufenen Metadaten enthält.

    Um die XMP-Metadaten abzurufen und zu speichern, rufen Sie die XMPUtilityServiceClient Methode des exportXMP Objekts auf und übergeben Sie ein BLOB Objekt, das die PDF-Datei darstellt. Die Methode gibt ein BLOB Objekt zurück, das die abgerufenen Metadaten enthält, die Sie anschließend als XML-Datei auf der Festplatte speichern können.

Siehe auch

Exportieren von Metadaten aus PDF-Dokumenten

Aufrufen von AEM Forms mit der Base64-Kodierung

Erstellen einer .NET-Client-Assembly, die Base64-Kodierung verwendet

Auf dieser Seite