使用XMP實用程式

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

關於XMP公用程式服務

PDF文檔包含元資料，元資料是與文檔內容（如文本和圖形）區分的文檔資訊。 Adobe可擴充中繼資料平台(XMP)是處理檔案中繼資料的標準。

XMP公用程式服務可從PDF檔案擷取和儲存XMP中繼資料，以及將XMP中繼資料匯入PDF檔案。

您可以使用XMP公用程式服務來完成下列工作：

• 將中繼資料匯入PDF檔案。 （請參閱將元資料匯入PDF檔案。）
• 從PDF檔案匯出中繼資料。 （請參閱從PDF文檔導出元資料。）

將元資料導入PDF文檔

您可以使用XMP公用程式Java和網頁服務API，以程式設計方式將XMP中繼資料匯入PDF檔案。 元資料提供有關PDF文檔的資訊，如文檔的作者和與文檔相關的關鍵字。 可以在文檔的「文檔屬性」對話框中找到元資料，如下圖所示。

要以寫程式方式將元資料導入PDF文檔，可以使用指定元資料值的現有XML文檔，或者可以使用類型XMPUtilityMetadata的對象。 (請參閱AEM Forms API參考。)

以下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元資料導入PDF文檔，請執行以下步驟：

1. 包含專案檔案。
2. 建立XMPUtilityService客戶端。
3. 叫用XMP中繼資料匯入操作。

包含項目檔案

在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。

建立XMPUtilityService客戶端

在以寫程式方式執行XMP實用程式操作之前，必須建立XMPUtilityService客戶端。 使用Java API，可建立XMPUtilityServiceClient物件來完成。 若使用Web服務API，則可使用XMPUtilityServiceService物件來完成。

叫用XMP中繼資料匯入作業

建立服務用戶端後，您可以叫用其中一個XMP中繼資料匯入作業，將XMP中繼資料匯入指定的PDF檔案。

另請參閱

使用Java API匯入XMP中繼資料

使用網站服務API匯入XMP中繼資料

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Java API匯入XMP中繼資料

使用XMP公用程式API(Java)匯入XMP中繼資料：

1. 包含項目檔案

   在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-pdfutility-client.jar。

   注意

   adobe-pdfutility-client.jar檔案包含可讓您以程式設計方式叫用XMP公用程式服務的類別。

2. 建立XMPUtilityService客戶端

   使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立XMPUtilityServiceClient物件。

3. 叫用XMP中繼資料匯入作業

   要修改XMP元資料，請調用XMPUtilityServiceClient對象的importMetadata方法或其importXMP方法。

   如果您使用importMetadata方法，請傳入下列值：

   • 代表PDF檔案的com.adobe.idp.Document物件。
   • XMPUtilityMetadata物件，包含要匯入的中繼資料。

   如果您使用importXMP方法，請傳入下列值：

   • 代表PDF檔案的com.adobe.idp.Document物件。
   • com.adobe.idp.Document物件，代表包含要匯入中繼資料的XML檔案。

   無論是哪種情況，傳回的值都是com.adobe.idp.Document物件，用新匯入的中繼資料代表PDF檔案。 然後，您可以將此對象保存到磁碟。

另請參閱

將中繼資料匯入PDF檔案

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Web服務API匯入XMP中繼資料

若要使用XMP公用程式網站服務API以程式設計方式匯入XMP中繼資料，請執行下列工作：

1. 包含項目檔案

   • 建立一個Microsoft .NET客戶端程式集，該程式集會使用XMP實用程式服務WSDL檔案。 (請參閱使用Base64編碼叫用AEM Forms。)
   • 參考Microsoft .NET客戶端程式集。 （請參閱建立使用Base64編碼的.NET客戶端程式集。）

2. 建立XMPUtilityService客戶端

   使用代理類建構子建立XMPUtilityServiceService對象。

3. 叫用XMP中繼資料匯入作業

   要修改XMP元資料，請調用XMPUtilityServiceService對象的importMetadata方法或其importXMP方法。

   如果您使用importMetadata方法，請傳入下列值：

   • 代表PDF檔案的BLOB物件。
   • XMPUtilityMetadata物件，包含要匯入的中繼資料。

   如果您使用importXMP方法，請傳入下列值：

   • 代表PDF檔案的BLOB物件。
   • BLOB物件，代表包含要匯入中繼資料的XML檔案。

   無論是哪種情況，傳回的值都是BLOB物件，用新匯入的中繼資料代表PDF檔案。 然後，您可以將此對象保存到磁碟。

另請參閱

將中繼資料匯入PDF檔案

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的.NET客戶端程式集

從PDF文檔導出元資料

您可以使用XMP公用程式Java和網頁服務API，以程式設計方式擷取和儲存PDF檔案中的XMP中繼資料。

步驟的摘要

要從PDF文檔導出XMP元資料，請執行以下步驟：

1. 包含專案檔案。
2. 建立XMPUtilityService客戶端。
3. 叫用XMP中繼資料匯出操作。

包含項目檔案

在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。

建立XMPUtilityService客戶端

在以寫程式方式執行XMP實用程式操作之前，必須建立XMPUtilityService客戶端。 使用Java AP時，若要完成此操作，需建立XMPUtilityServiceClient物件。 使用Web服務API，可使用XMPUtilityServiceService物件來完成。

叫用XMP中繼資料匯出作業

建立服務用戶端後，您可以叫用其中一個XMP中繼資料匯出作業，這可用來檢查XMP中繼資料或將其儲存至磁碟。

另請參閱

使用Java API匯入XMP中繼資料

使用網站服務API匯入XMP中繼資料

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Java API匯出XMP中繼資料

使用XMP公用程式API(Java)匯出XMP中繼資料：

1. 包含項目檔案

   在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-pdfutility-client.jar。

   注意

   adobe-pdfutility-client.jar檔案包含可讓您以程式設計方式叫用XMP公用程式服務的類別。

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程式庫檔案

設定連接屬性

使用網站服務API匯出XMP中繼資料

使用XMP公用程式API（網站服務）匯出XMP中繼資料：

1. 包含項目檔案

   • 建立一個Microsoft .NET客戶端程式集，該程式集會使用XMP實用程式服務WSDL檔案。
   • 參考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客戶端程式集