XMP Utilities サービスについて
PDFドキュメントには、メタデータが含まれます。メタデータは、ドキュメントの内容と区別されるドキュメントに関する情報(テキストやグラフィックなど)です。 Adobe拡張メタデータプラットフォーム (XMP) は、ドキュメントのメタデータを処理するための規格です。
XMP Utilities サービスは、XMPメタデータを取得してPDFドキュメントから保存し、XMPメタデータをPDFドキュメントに読み込むことができます。
XMP Utilities サービスを使用して、次のタスクを実行できます。
XMP Utilities サービスについて詳しくは、 AEM Formsのサービスリファレンス.
XMP Utilities Java および Web サービス API を使用して、XMPメタデータをプログラムでPDFドキュメントに読み込むことができます。 メタデータは、ドキュメントの作成者やPDFに関連するキーワードなど、キーワードドキュメントに関する情報を提供します。 メタデータは、次の図に示すように、ドキュメントのドキュメントのプロパティダイアログに配置できます。
プログラムによってメタデータをPDFドキュメントに読み込むには、メタデータ値を指定する既存の XML ドキュメントを使用するか、型のオブジェクトを使用します XMPUtilityMetadata
. ( AEM Forms API リファレンス.)
この節では、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ドキュメントに読み込むには、次の手順を実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、プロキシファイルを必ず含めてください。
XMPUtilityService クライアントを作成します
XMP Utilities の操作をプログラムで実行する前に、XMPUtilityService クライアントを作成する必要があります。 Java API を使用すると、これは XMPUtilityServiceClient
オブジェクト。 Web サービス API では、これは XMPUtilityServiceService
オブジェクト。
「XMP metadata import」操作を呼び出す
サービスクライアントを作成したら、XMPのメタデータの読み込み操作の 1 つを呼び出して、XMPのメタデータを指定したPDFドキュメントに読み込むことができます。
関連トピック
Web サービス API を使用したXMPメタデータの読み込み
XMP Utilities API(Java) を使用してXMPメタデータを読み込みます。
プロジェクトファイルを含める
Java プロジェクトのクラスパスに、adobe-pdfutility-client.jar などのクライアント JAR ファイルを含めます。
adobe-pdfutility-client.jar ファイルには、XMP Utilities サービスをプログラムで呼び出すことを可能にするクラスが含まれています。
XMPUtilityService クライアントを作成します
の作成 XMPUtilityServiceClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
接続プロパティを含むオブジェクト。
「XMP metadata import」操作を呼び出す
XMPメタデータを変更するには、 XMPUtilityServiceClient
オブジェクトの importMetadata
メソッドまたはその importXMP
メソッド。
次の importMetadata
メソッドで、次の値を渡します。
com.adobe.idp.Document
オブジェクトファイルを表すPDF。XMPUtilityMetadata
読み込むメタデータを含むオブジェクト。次の importXMP
メソッドで、次の値を渡します。
com.adobe.idp.Document
オブジェクトファイルを表すPDF。com.adobe.idp.Document
読み込むメタデータが含まれる XML ファイルを表すオブジェクト。どちらの場合も、返される値は com.adobe.idp.Document
新しく読み込まれたメタPDFを含むメタデータファイルを表すオブジェクト。 このオブジェクトをディスクに保存できます。
関連トピック
XMP Utilities Web サービス API を使用してプログラムでXMPメタデータを読み込むには、次のタスクを実行します。
プロジェクトファイルを含める
XMPUtilityService クライアントを作成します
の作成 XMPUtilityServiceService
オブジェクトを指定します。
「XMP metadata import」操作を呼び出す
XMPメタデータを変更するには、 XMPUtilityServiceService
オブジェクトの importMetadata
メソッドまたはその importXMP
メソッド。
次の importMetadata
メソッドで、次の値を渡します。
BLOB
オブジェクトファイルを表すPDF。XMPUtilityMetadata
読み込むメタデータを含むオブジェクト。次の importXMP
メソッドで、次の値を渡します。
BLOB
オブジェクトファイルを表すPDF。BLOB
読み込むメタデータが含まれる XML ファイルを表すオブジェクト。どちらの場合も、返される値は BLOB
新しく読み込まれたメタPDFを含むメタデータファイルを表すオブジェクト。 このオブジェクトをディスクに保存できます。
関連トピック
Base64 エンコーディングを使用したAEM Formsの呼び出し
Base64 エンコーディングを使用する.NET クライアントアセンブリの作成
XMP Utilities Java および Web サービス API を使用して、プログラムによってPDFドキュメントからXMPメタデータを取得し、保存することができます。
XMP Utilities サービスについて詳しくは、 AEM Formsのサービスリファレンス.
XMPドキュメントからPDFメタデータを書き出すには、次の手順に従います。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、プロキシファイルを必ず含めてください。
XMPUtilityService クライアントを作成します
XMP Utilities の操作をプログラムで実行する前に、XMPUtilityService クライアントを作成する必要があります。 Java AP を使用すると、これは XMPUtilityServiceClient
オブジェクト。 Web サービス API では、これを XMPUtilityServiceService
オブジェクト。
「XMP metadata export」操作を呼び出します。
サービスクライアントを作成したら、XMPのメタデータの書き出し操作の 1 つを呼び出すことができます。これは、XMPのメタデータを調べたり、ディスクに保存したりするために使用できます。
関連トピック
Web サービス API を使用したXMPメタデータの読み込み
XMP Utilities API(Java) を使用してXMPメタデータを書き出します。
プロジェクトファイルを含める
Java プロジェクトのクラスパスに、adobe-pdfutility-client.jar などのクライアント JAR ファイルを含めます。
adobe-pdfutility-client.jar ファイルには、XMP Utility サービスをプログラムで呼び出すことを可能にするクラスが含まれています。
XMPUtilityService クライアントを作成します
の作成 XMPUtilityServiceClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
接続プロパティを含むオブジェクト。
「XMP metadata import」操作を呼び出す
XMPメタデータを検査するには、 XMPUtilityServiceClient
オブジェクトの exportMetadata
メソッドを使用して com.adobe.idp.Document
オブジェクトファイルを表すPDF。 メソッドは、 XMPUtilityMetadata
取得したメタデータを含むオブジェクト。
XMPメタデータを取得して保存するには、 XMPUtilityServiceClient
オブジェクトの exportXMP
メソッドを使用して com.adobe.idp.Document
オブジェクトファイルを表すPDF。 このメソッドは、 com.adobe.idp.Document
取得したメタデータを含むオブジェクト。このオブジェクトは、XML ファイルとしてディスクに保存できます。
関連トピック
XMP Utilities API(Web サービス)を使用してXMPメタデータを書き出します。
プロジェクトファイルを含める
XMPUtilityService クライアントを作成します
の作成 XMPUtilityServiceService
オブジェクトを指定します。
「XMP metadata import」操作を呼び出す
XMPメタデータを検査するには、 XMPUtilityServiceClient
オブジェクトの exportMetadata
メソッドを使用して BLOB
オブジェクトファイルを表すPDF。 メソッドは、 XMPUtilityMetadata
取得したメタデータを含むオブジェクト。
XMPメタデータを取得して保存するには、 XMPUtilityServiceClient
オブジェクトの exportXMP
メソッドを使用して BLOB
オブジェクトファイルを表すPDF。 このメソッドは、 BLOB
取得したメタデータを含むオブジェクト。このオブジェクトは、XML ファイルとしてディスクに保存できます。
関連トピック