Arbeiten mit XMP Utilities

Beispiele und Beispiele in diesem Dokument gelten nur für die AEM Forms on JEE-Umgebung.

Über den 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 Dokumentmetadaten.

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 mit dem XMP Utilities-Dienst ausführen:

HINWEIS

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

Importieren von Metadaten in PDF-Dokumente

Sie können die Java- und Webdienst-APIs XMP Utilities-Dienstprogramme 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 sich im Dialogfeld Dokumenteigenschaften des Dokuments befinden, 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 Sie können ein Objekt vom Typ XMPUtilityMetadata verwenden. (Siehe AEM Forms API Reference.)

HINWEIS

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

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

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

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um XMP Metadaten in ein PDF-Dokument zu importieren:

  1. Projektdateien einschließen.
  2. Erstellen Sie einen XMPUtilityService-Client.
  3. Rufen Sie den Importvorgang für XMP Metadaten auf.

Projektdateien einschließen

Fügen 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 XMPUtilityService-Clients

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

Aufrufen des Importvorgangs XMP Metadaten

Nachdem Sie den Dienst-Client 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 XMP Metadaten mit der Java-API

Importieren XMP Metadaten mithilfe der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Importieren XMP Metadaten mithilfe der Java-API

Importieren Sie XMP Metadaten mithilfe der XMP Utilities-API (Java):

  1. Projektdateien einschließen

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

    HINWEIS

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

  2. Erstellen eines XMPUtilityService-Clients

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

  3. Aufrufen des Importvorgangs XMP Metadaten

    Um die XMP-Metadaten zu ändern, rufen Sie entweder die importMetadata-Methode oder die importXMP-Methode des XMPUtilityServiceClient-Objekts 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 darstellt, die die zu importierenden Metadaten enthält.

    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 XMP Metadaten mithilfe der Webdienst-API

Führen Sie die folgenden Aufgaben aus, um XMP Metadaten mithilfe der XMP Utilities-Webdienst-API programmgesteuert zu importieren:

  1. Projektdateien einschließen

  2. Erstellen eines XMPUtilityService-Clients

    Erstellen Sie ein XMPUtilityServiceService-Objekt mithilfe Ihres Proxy-Klassenkonstruktors.

  3. Aufrufen des Importvorgangs XMP Metadaten

    Um die XMP-Metadaten zu ändern, rufen Sie entweder die importMetadata-Methode oder die importXMP-Methode des XMPUtilityServiceService-Objekts 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 darstellt, die die zu importierenden Metadaten enthält.

    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 die Base64-Kodierung verwendet

Exportieren von Metadaten aus PDF-Dokumenten

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

HINWEIS

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

Zusammenfassung der Schritte

So exportieren Sie XMP Metadaten aus einem PDF-Dokument:

  1. Projektdateien einschließen.
  2. Erstellen Sie einen XMPUtilityService-Client.
  3. Rufen Sie den Export von XMP-Metadaten auf.

Projektdateien einschließen

Fügen 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 XMPUtilityService-Clients

Bevor Sie einen XMP Utilities-Vorgang programmgesteuert ausführen können, müssen Sie einen XMPUtilityService-Client erstellen. Mit der Java-API wird dies erreicht, indem ein XMPUtilityServiceClient -Objekt erstellt wird. Mit der Webdienst-API wird dies mithilfe eines XMPUtilityServiceService -Objekts erreicht.

Aufrufen des Exportvorgangs XMP Metadaten

Nachdem Sie den Dienst-Client erstellt haben, können Sie einen der XMP Metadaten-Exportvorgänge aufrufen, mit denen die XMP-Metadaten geprüft oder auf der Festplatte gespeichert werden können.

Siehe auch

Importieren XMP Metadaten mit der Java-API

Importieren XMP Metadaten mithilfe der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Exportieren XMP Metadaten mithilfe der Java-API

Exportieren Sie XMP Metadaten mithilfe der XMP Utilities API (Java):

  1. Projektdateien einschließen

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

    HINWEIS

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

  2. Erstellen eines XMPUtilityService-Clients

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

  3. Aufrufen des Importvorgangs XMP Metadaten

    Um die XMP-Metadaten zu überprüfen, rufen Sie die exportMetadata -Methode des Objekts auf und übergeben Sie ein com.adobe.idp.Document -Objekt, das die PDF-Datei darstellt. XMPUtilityServiceClient 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 exportXMP -Methode des Objekts auf und übergeben Sie ein com.adobe.idp.Document -Objekt, das die PDF-Datei darstellt. XMPUtilityServiceClient 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 XMP Metadaten mithilfe der Webdienst-API

Exportieren Sie XMP Metadaten mithilfe 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. Erstellen eines XMPUtilityService-Clients

    Erstellen Sie ein XMPUtilityServiceService-Objekt mithilfe Ihres Proxy-Klassenkonstruktors.

  3. Aufrufen des Importvorgangs XMP Metadaten

    Um die XMP-Metadaten zu überprüfen, rufen Sie die exportMetadata -Methode des Objekts auf und übergeben Sie ein BLOB -Objekt, das die PDF-Datei darstellt. XMPUtilityServiceClient 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 exportXMP -Methode des Objekts auf und übergeben Sie ein BLOB -Objekt, das die PDF-Datei darstellt. XMPUtilityServiceClient 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 die Base64-Kodierung verwendet

Auf dieser Seite