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