使用XMP實用程式

關於XMP公用程式服務

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

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

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

注意

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

將元資料導入PDF文檔

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

ww_ww_metadatadialog

要以寫程式方式將元資料導入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公用程式服務的詳細資訊,請參閱AEM Forms的服務參考

步驟的摘要

要將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. 包含項目檔案

  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中繼資料。

注意

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

步驟的摘要

要從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客戶端程式集

本頁內容