使用XMP實用程式

關於XMP實用程式服務

PDF檔案包含中繼資料，此為與檔案內容（例如文字和圖形）區隔的檔案資訊。 Adobe Extensible Metadata Platform(XMP)是處理檔案中繼資料的標準。

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

您可以使用XMP Utilities服務完成下列工作：

注意

如需XMP公用程式服務的詳細資訊，請參閱AEM Forms的服務參考。

將中繼資料匯入PDF檔案

您可以使用XMP公用程式Java和web service API，以程式設計方式將XMP中繼資料匯入PDF檔案。 中繼資料提供有關PDF檔案的資訊，例如檔案的作者和與檔案相關的關鍵字。 中繼資料可位於檔案的「檔案屬性」對話方塊中，如下圖所示。

ww_ww_metadatadialog

若要以程式設計方式將中繼資料匯入PDF檔案，您可以使用指定中繼資料值的現有XML檔案，或使用類型XMPUtilityMetadata的物件。 （請參閱AEM Forms API Reference）。

注意

本節討論如何使用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公用程式服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟摘要

若要將XMP中繼資料匯入PDF檔案，請執行下列步驟：

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

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

建立XMPUtilityService客戶端

您必須先建立XMPutilityService用戶端，才能以程式設計方式執行XMP公用程式作業。 使用Java API，您可建立XMPUtilityServiceClient物件來完成此作業。 使用web service API，這是使用XMPUtilityServiceService物件來完成的。

叫用XMP中繼資料匯入作業

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

另請參閱

使用Java API匯入XMP中繼資料

使用web service 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 service API匯入XMP中繼資料

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

  1. 包含專案檔案

  2. 建立XMPUtilityService客戶端

    使用proxy類別建構函式建立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和web service API，以程式設計方式從PDF檔案擷取和儲存XMP中繼資料。

注意

如需XMP公用程式服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟摘要

若要從PDF檔案匯出XMP中繼資料，請執行下列步驟：

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

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

建立XMPUtilityService客戶端

您必須先建立XMPutilityService用戶端，才能以程式設計方式執行XMP公用程式作業。 使用Java AP，如果通過建立XMPUtilityServiceClient對象來完成此操作。 使用web service API，這是使用XMPUtilityServiceService物件來完成的。

叫用XMP中繼資料匯出作業

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

另請參閱

使用Java API匯入XMP中繼資料

使用web service 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程式庫檔案

設定連接屬性

使用web service API匯出XMP中繼資料

使用XMP Utilities API(web service)匯出XMP中繼資料：

  1. 包含專案檔案

    • 建立一個使用XMP實用程式服務WSDL檔案的Microsoft .NET客戶端元件。
    • 參考Microsoft .NET客戶端元件。

  2. 建立XMPUtilityService客戶端

    使用proxy類別建構函式建立XMPUtilityServiceService物件。

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

    若要檢查XMP中繼資料，請叫用XMPUtilityServiceClient物件的exportMetadata方法，並傳入代表PDF檔案的BLOB物件。 該方法返回包含檢索到的元資料的XMPUtilityMetadata對象。

    若要擷取並儲存XMP中繼資料，請叫用XMPUtilityServiceClient物件的exportXMP方法，並傳入代表PDF檔案的BLOB物件。 該方法返回包含檢索到的元資料的BLOB對象，您隨後可將其另存為XML檔案。

另請參閱

從PDF檔案匯出中繼資料

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的。NET客戶端元件

本頁內容