使用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客戶端元件

本頁內容