關於XMP實用程式服務
PDF檔案包含中繼資料,此為與檔案內容(例如文字和圖形)區隔的檔案資訊。 Adobe Extensible Metadata Platform(XMP)是處理檔案中繼資料的標準。
XMP公用程式服務可從PDF檔案擷取和儲存XMP中繼資料,並將XMP中繼資料匯入PDF檔案。
您可以使用XMP Utilities服務完成下列工作:
如需XMP公用程式服務的詳細資訊,請參閱AEM Forms的服務參考。
您可以使用XMP公用程式Java和web service API,以程式設計方式將XMP中繼資料匯入PDF檔案。 中繼資料提供有關PDF檔案的資訊,例如檔案的作者和與檔案相關的關鍵字。 中繼資料可位於檔案的「檔案屬性」對話方塊中,如下圖所示。
若要以程式設計方式將中繼資料匯入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檔案,請執行下列步驟:
包含專案檔案
將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用web services,請確定您包含proxy檔案。
建立XMPUtilityService客戶端
您必須先建立XMPutilityService用戶端,才能以程式設計方式執行XMP公用程式作業。 使用Java API,您可建立XMPUtilityServiceClient
物件來完成此作業。 使用web service API,這是使用XMPUtilityServiceService
物件來完成的。
叫用XMP中繼資料匯入作業
建立服務用戶端後,您可以叫用其中一個XMP中繼資料匯入作業,將XMP中繼資料匯入指定的PDF檔案。
另請參閱
使用XMP公用程式API(Java)匯入XMP中繼資料:
包含專案檔案
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-pdfutility-client.jar。
adobe-pdfutility-client.jar檔案包含可讓您以程式設計方式叫用XMP公用程式服務的類別。
建立XMPUtilityService客戶端
使用其建構子並傳遞包含連接屬性的ServiceClientFactory
對象,建立XMPUtilityServiceClient
對象。
叫用XMP中繼資料匯入作業
若要修改XMP中繼資料,請叫用XMPUtilityServiceClient
物件的importMetadata
方法或其importXMP
方法。
如果您使用importMetadata
方法,請傳入下列值:
com.adobe.idp.Document
物件。XMPUtilityMetadata
物件,包含要匯入的中繼資料。如果您使用importXMP
方法,請傳入下列值:
com.adobe.idp.Document
物件。com.adobe.idp.Document
物件,代表包含要匯入之中繼資料的XML檔案。無論何種情況,傳回的值都是com.adobe.idp.Document
物件,代表包含新匯入中繼資料的PDF檔案。 然後,可以將此對象保存到磁碟。
另請參閱
若要使用XMP公用程式網站服務API以程式設計方式匯入XMP中繼資料,請執行下列工作:
包含專案檔案
建立XMPUtilityService客戶端
使用proxy類別建構函式建立XMPUtilityServiceService
物件。
叫用XMP中繼資料匯入作業
若要修改XMP中繼資料,請叫用XMPUtilityServiceService
物件的importMetadata
方法或其importXMP
方法。
如果您使用importMetadata
方法,請傳入下列值:
BLOB
物件。XMPUtilityMetadata
物件,包含要匯入的中繼資料。如果您使用importXMP
方法,請傳入下列值:
BLOB
物件。BLOB
物件,代表包含要匯入之中繼資料的XML檔案。無論何種情況,傳回的值都是BLOB
物件,代表包含新匯入中繼資料的PDF檔案。 然後,可以將此對象保存到磁碟。
另請參閱
您可以使用XMP公用程式Java和web service API,以程式設計方式從PDF檔案擷取和儲存XMP中繼資料。
如需XMP公用程式服務的詳細資訊,請參閱AEM Forms的服務參考。
若要從PDF檔案匯出XMP中繼資料,請執行下列步驟:
包含專案檔案
將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用web services,請確定您包含proxy檔案。
建立XMPUtilityService客戶端
您必須先建立XMPutilityService用戶端,才能以程式設計方式執行XMP公用程式作業。 使用Java AP,如果通過建立XMPUtilityServiceClient
對象來完成此操作。 使用web service API,這是使用XMPUtilityServiceService
物件來完成的。
叫用XMP中繼資料匯出作業
建立服務用戶端後,您可以叫用其中一個XMP中繼資料匯出作業,此作業可用來檢查XMP中繼資料或將它儲存至磁碟。
另請參閱
使用XMP公用程式API(Java)匯出XMP中繼資料:
包含專案檔案
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-pdfutility-client.jar。
adobe-pdfutility-client.jar檔案包含可讓您以程式設計方式叫用XMP公用程式服務的類別。
建立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 service)匯出XMP中繼資料:
包含專案檔案
建立XMPUtilityService客戶端
使用proxy類別建構函式建立XMPUtilityServiceService
物件。
叫用XMP中繼資料匯入作業
若要檢查XMP中繼資料,請叫用XMPUtilityServiceClient
物件的exportMetadata
方法,並傳入代表PDF檔案的BLOB
物件。 該方法返回包含檢索到的元資料的XMPUtilityMetadata
對象。
若要擷取並儲存XMP中繼資料,請叫用XMPUtilityServiceClient
物件的exportXMP
方法,並傳入代表PDF檔案的BLOB
物件。 該方法返回包含檢索到的元資料的BLOB
對象,您隨後可將其另存為XML檔案。
另請參閱