XMPユーティリティの操作

このドキュメントのサンプルと例は、JEE環境上のAEM Formsに対してのみ提供されています。

XMP Utilitiesサービスについて

PDFドキュメントにはメタデータが含まれます。メタデータは、ドキュメントに関する情報で、テキストやグラフィックなどのドキュメントのコンテンツと区別されます。 Adobe拡張メタデータプラットフォーム(XMP)は、ドキュメントのメタデータを処理するための標準です。

XMP Utilitiesサービスは、PDFドキュメントからXMPメタデータを取得して保存し、XMPメタデータをPDFドキュメントに読み込むことができます。

XMP Utilitiesサービスを使用して、次のタスクを実行できます。

メモ

XMP Utilitiesサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

PDFドキュメントへのメタデータの読み込み

XMP UtilitiesのJavaおよびWebサービスAPIを使用して、XMPメタデータをPDFドキュメントにプログラム的に読み込むことができます。 メタデータは、ドキュメントの作成者やドキュメントに関連するキーワードなど、PDFドキュメントに関する情報を提供します。 メタデータは、次の図に示すように、ドキュメントのドキュメントプロパティダイアログにあります。

ww_ww_metadatadialog

プログラムによってメタデータをPDFドキュメントに読み込むには、メタデータ値を指定する既存のXMLドキュメントを使用するか、XMPUtilityMetadata型のオブジェクトを使用します。 (「AEM FormsAPIリファレンス」を参照)。

メモ

この節では、XMLドキュメントを使用してメタデータをPDFドキュメントに読み込む方法について説明します。

次のXMLコードには、前の図に対応するメタデータ値が含まれています。 例えば、太字の項目でキーワードを指定しています。

 <?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>
メモ

XMP Utilitiesサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

手順の概要

XMPメタデータをPDFドキュメントに読み込むには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. XMPUtilityServiceクライアントを作成します。
  3. XMPメタデータの読み込み操作を呼び出します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めてください。

XMPUtilityServiceクライアントの作成

プログラムによってXMP Utilities操作を実行する前に、XMPUtilityServiceクライアントを作成する必要があります。 Java APIを使用すると、XMPUtilityServiceClientオブジェクトを作成することで実現できます。 WebサービスAPIでは、XMPUtilityServiceServiceオブジェクトを使用して実行します。

XMPメタデータの読み込み操作を呼び出します

サービスクライアントの作成後、XMPメタデータの読み込み操作の1つを呼び出して、指定したPDFドキュメントにXMPメタデータを読み込むことができます。

関連トピック

Java APIを使用したXMPメタデータの読み込み

WebサービスAPIを使用したXMPメタデータの読み込み

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用したXMPメタデータの読み込み

XMP Utilities API(Java)を使用してXMPメタデータを読み込みます。

  1. プロジェクトファイルを含める

    Javaプロジェクトのクラスパスに、adobe-pdfutility-client.jarなどのクライアントJARファイルを含めます。

    メモ

    adobe-pdfutility-client.jarファイルには、XMP Utilitiesサービスをプログラム的に呼び出すことを可能にするクラスが含まれています。

  2. XMPUtilityServiceクライアントの作成

    コンストラクターを使用し、接続プロパティを含むServiceClientFactoryオブジェクトを渡して、XMPUtilityServiceClientオブジェクトを作成します。

  3. XMPメタデータの読み込み操作を呼び出します

    XMPメタデータを変更するには、XMPUtilityServiceClientオブジェクトのimportMetadataメソッドまたはimportXMPメソッドを呼び出します。

    importMetadataメソッドを使用する場合は、次の値を渡します。

    • PDFファイルを表すcom.adobe.idp.Documentオブジェクトです。
    • 読み込むメタデータを含むXMPUtilityMetadataオブジェクト。

    importXMPメソッドを使用する場合は、次の値を渡します。

    • PDFファイルを表すcom.adobe.idp.Documentオブジェクトです。
    • 読み込むメタデータを含むXMLファイルを表すcom.adobe.idp.Documentオブジェクト。

    いずれの場合も、返される値は、新しく読み込まれたメタデータが含まれたPDFファイルを表すcom.adobe.idp.Documentオブジェクトです。 その後、このオブジェクトをディスクに保存できます。

関連トピック

PDFドキュメントへのメタデータの読み込み

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

WebサービスAPIを使用したXMPメタデータの読み込み

XMP Utilities WebサービスAPIを使用してXMPメタデータをプログラムで読み込むには、次のタスクを実行します。

  1. プロジェクトファイルを含める

  2. XMPUtilityServiceクライアントの作成

    プロキシクラスのコンストラクターを使用してXMPUtilityServiceServiceオブジェクトを作成します。

  3. XMPメタデータの読み込み操作を呼び出します

    XMPメタデータを変更するには、XMPUtilityServiceServiceオブジェクトのimportMetadataメソッドまたはimportXMPメソッドを呼び出します。

    importMetadataメソッドを使用する場合は、次の値を渡します。

    • PDFファイルを表すBLOBオブジェクトです。
    • 読み込むメタデータを含むXMPUtilityMetadataオブジェクト。

    importXMPメソッドを使用する場合は、次の値を渡します。

    • PDFファイルを表すBLOBオブジェクトです。
    • 読み込むメタデータを含むXMLファイルを表すBLOBオブジェクト。

    いずれの場合も、返される値は、新しく読み込まれたメタデータが含まれたPDFファイルを表すBLOBオブジェクトです。 その後、このオブジェクトをディスクに保存できます。

関連トピック

PDFドキュメントへのメタデータの読み込み

Base64エンコーディングを使用したAEM Formsの呼び出し

Base64エンコーディングを使用する.NETクライアントアセンブリの作成

PDFドキュメントからのメタデータの書き出し

XMP UtilitiesのJavaおよびWebサービスAPIを使用して、PDFドキュメントからXMPメタデータをプログラム的に取得し、保存できます。

メモ

XMP Utilitiesサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

手順の概要

PDFドキュメントからXMPメタデータを書き出すには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. XMPUtilityServiceクライアントを作成します。
  3. XMPメタデータ書き出し操作を呼び出します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めてください。

XMPUtilityServiceクライアントの作成

プログラムによってXMP Utilities操作を実行する前に、XMPUtilityServiceクライアントを作成する必要があります。 Java APでは、XMPUtilityServiceClientオブジェクトを作成することで実現します。 WebサービスAPIでは、これはXMPUtilityServiceServiceオブジェクトを使用して実行されます。

XMPメタデータ書き出し操作の呼び出し

サービスクライアントを作成したら、XMPメタデータの書き出し操作の1つを呼び出します。この操作は、XMPメタデータを検査したり、ディスクに保存したりするのに使用できます。

関連トピック

Java APIを使用したXMPメタデータの読み込み

WebサービスAPIを使用したXMPメタデータの読み込み

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用したXMPメタデータの書き出し

XMP Utilities API(Java)を使用してXMPメタデータを書き出します。

  1. プロジェクトファイルを含める

    Javaプロジェクトのクラスパスに、adobe-pdfutility-client.jarなどのクライアントJARファイルを含めます。

    メモ

    adobe-pdfutility-client.jarファイルには、XMP Utilityサービスをプログラム的に呼び出すことを可能にするクラスが含まれています。

  2. XMPUtilityServiceクライアントの作成

    コンストラクターを使用し、接続プロパティを含むServiceClientFactoryオブジェクトを渡して、XMPUtilityServiceClientオブジェクトを作成します。

  3. XMPメタデータの読み込み操作を呼び出します

    XMPメタデータを検査するには、XMPUtilityServiceClientオブジェクトのexportMetadataメソッドを呼び出し、PDFファイルを表すcom.adobe.idp.Documentオブジェクトを渡します。 このメソッドは、取得したメタデータを含むXMPUtilityMetadataオブジェクトを返します。

    XMPメタデータを取得して保存するには、XMPUtilityServiceClientオブジェクトのexportXMPメソッドを呼び出し、PDFファイルを表すcom.adobe.idp.Documentオブジェクトを渡します。 このメソッドは、取得したメタデータを含むcom.adobe.idp.Documentオブジェクトを返します。このオブジェクトは、XMLファイルとしてディスクに保存できます。

関連トピック

PDFドキュメントからのメタデータの書き出し

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

WebサービスAPIを使用したXMPメタデータの書き出し

XMP Utilities API(Webサービス)を使用してXMPメタデータを書き出します。

  1. プロジェクトファイルを含める

    • XMP UtilitiesサービスのWSDLファイルを使用するMicrosoft .NETクライアントアセンブリを作成します。
    • Microsoft .NETクライアントアセンブリを参照します。
  2. XMPUtilityServiceクライアントの作成

    プロキシクラスのコンストラクターを使用してXMPUtilityServiceServiceオブジェクトを作成します。

  3. XMPメタデータの読み込み操作を呼び出します

    XMPメタデータを検査するには、XMPUtilityServiceClientオブジェクトのexportMetadataメソッドを呼び出し、PDFファイルを表すBLOBオブジェクトを渡します。 このメソッドは、取得したメタデータを含むXMPUtilityMetadataオブジェクトを返します。

    XMPメタデータを取得して保存するには、XMPUtilityServiceClientオブジェクトのexportXMPメソッドを呼び出し、PDFファイルを表すBLOBオブジェクトを渡します。 このメソッドは、取得したメタデータを含むBLOBオブジェクトを返します。このオブジェクトは、XMLファイルとしてディスクに保存できます。

関連トピック

PDFドキュメントからのメタデータの書き出し

Base64エンコーディングを使用したAEM Formsの呼び出し

Base64エンコーディングを使用する.NETクライアントアセンブリの作成

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now