使用PDF/A檔案

關於DocConverter服務

DocConverter服務可將PDF文檔轉換為PDA/A文檔。 您可以使用此服務來完成下列工作:

注意

有關DocConverter服務的詳細資訊,請參見 AEM Forms服務參考.

將文檔轉換為PDF/A文檔

可以使用DocConverter服務將PDF文檔轉換為PDF/文檔。 由於PDF/A是用於長期保存文檔內容的存檔格式,因此所有字型都被嵌入並且檔案被解壓縮。 因此,PDF/A文檔通常比標準PDF文檔大。 此外,PDF/檔案不包含音訊和視訊內容。 將PDF文檔轉換為PDF/A文檔之前,請確保PDF文檔不是PDF/A文檔。

PDF/A-1規範由兩個符合級別組成,即A和B。這兩個級別之間的主要區別在於邏輯結構(可訪問性)支援,這對於符合級別B不是必需的。無論符合級別如何,PDF/A-1都規定所有字型都嵌入在生成的PDF/A文檔中。 目前驗證(和轉換)僅支援PDF/A-1b。

雖然PDF/A是歸檔PDF文檔的標準,但如果標準PDF文檔滿足您公司的要求,則使用PDF/A進行歸檔並非強制性的。 PDF/A標準的目的是建立一個PDF檔案,用於滿足長期歸檔和文檔保存需求。

注意

有關DocConverter服務的詳細資訊,請參見 AEM Forms服務參考.

步驟摘要

要將PDF文檔轉換為PDF/A文檔,請執行以下步驟:

  1. 包含專案檔案。
  2. 建立DocConvert客戶端
  3. 參考PDF文檔以轉換為PDF/A文檔。
  4. 設定追蹤資訊。
  5. 轉換文檔。
  6. 儲存PDF/檔案。

包含項目檔案

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

必須將以下JAR檔案添加到項目的類路徑中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar(若AEM Forms部署在JBoss Application Server上則為必要)
  • jbossall-client.jar(若AEM Forms部署在JBoss Application Server上則為必要)

有關這些JAR檔案的位置的資訊,請參見 包含AEM Forms Java程式庫檔案.

建立DocConvert客戶端

在以寫程式方式執行DocConverter操作之前,必須建立DocConverter客戶端。 如果您使用Java API,請建立 DocConverterServiceClient 物件。 如果您使用DocConverter Web服務API,請建立 DocConverterServiceService 物件。

參考PDF文檔以轉換為PDF/文檔

檢索PDF文檔以轉換為PDF/A文檔。 如果嘗試將PDF文檔(如Acrobat表單)轉換為PDF/A文檔,將導致異常。

設定追蹤資訊

您可以設定執行階段選項,以決定在轉換過程中要追蹤多少資訊。 也就是說,可以設定9個不同的級別,以指定DocConverter服務將PDF文檔轉換為PDF/A文檔時跟蹤的資訊量。

轉換文檔

建立DocConverter服務客戶端後,請參考要轉換的PDF文檔並設定指定跟蹤多少資訊的運行時選項,可以將PDF文檔轉換為PDF/A文檔。

儲存PDF/檔案

您可以將PDF/檔案儲存為PDF檔案。

另請參閱

使用Java API將檔案轉換為PDF/A檔案

使用Web服務API將文檔轉換為PDF/A文檔

包含AEM Forms Java程式庫檔案

設定連接屬性

以程式設計方式決定PDF/符合性

使用Java API將檔案轉換為PDF/A檔案

使用Java API將PDF檔案轉換為PDF/A檔案:

  1. 包含項目檔案

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

  2. 建立DocConvert客戶端

    • 建立 ServiceClientFactory 包含連接屬性的對象。
    • 建立 DocConverterServiceClient 對象,使用其建構子並傳遞 ServiceClientFactory 物件。
  3. 參考PDF文檔以轉換為PDF/文檔

    • 建立 java.io.FileInputStream 表示要轉換的PDF文檔的對象,方法是使用其建構子並傳遞指定PDF檔案位置的字串值。
    • 建立 com.adobe.idp.Document 對象,使用其建構子並傳遞 java.io.FileInputStream 物件。
  4. 設定追蹤資訊

    • 建立 PDFAConversionOptionSpec 物件,使用其建構子。
    • 叫用 PDFAConversionOptionSpec 物件 setLogLevel 方法,並傳遞指定追蹤層級的字串值。 例如,傳遞值 FINE. 如需不同值的相關資訊,請參閱 setLogLevel 方法(在 AEM Forms API參考.
  5. 轉換文檔

    調用以下命令將PDF文檔轉換為PDF/A文檔 DocConverterServiceClient 物件 toPDFA 方法並傳遞下列值:

    • com.adobe.idp.Document 包含要轉換的PDF文檔的對象
    • PDFAConversionOptionSpec 指定跟蹤資訊的對象

    toPDFA 方法傳回 PDFAConversionResult 包含PDF/A文檔的對象。

  6. 儲存PDF/檔案

    • 叫用 PDFAConversionResult 物件 getPDFA 方法。 此方法會傳回 com.adobe.idp.Document 表示PDF/A文檔的對象。
    • 建立 java.io.File 代表PDF/A檔案的物件。 請確定副檔名為.pdf。
    • 叫用PDF/A資料,將檔案填入 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File 物件。

另請參閱

使用PDF/A檔案

快速入門(SOAP模式):使用Java API將檔案轉換為PDF/檔案

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Web服務API將文檔轉換為PDF/A文檔

使用DocConverter API(Web服務)將PDF文檔轉換為PDF/A文檔:

  1. 包含項目檔案

    • 建立會使用DocConverter WSDL的Microsoft .NET客戶端程式集。
    • 參考Microsoft .NET客戶端程式集。
  2. 建立DocConvert客戶端

    • 使用Microsoft .NET客戶端程式集,建立 DocConverterServiceService 對象,方法是調用其預設建構子。
    • 設定 DocConverterServiceService 物件 Credentials 具有 System.Net.NetworkCredential 指定用戶名和密碼值的值。
  3. 參考PDF文檔以轉換為PDF/文檔

    • 建立 BLOB 物件,使用其建構子。 此 BLOB 對象用於儲存轉換為PDF/PDF文檔的文檔。
    • 建立 System.IO.FileStream 對象,方法是調用其建構子,並傳遞一個字串值,該字串值表示PDF文檔的檔案位置以及在中開啟檔案的模式。
    • 建立位元組陣列,用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
    • 叫用 System.IO.FileStream 物件 Read 方法,並傳遞位元組陣列、起始位置及流長度以讀取。
    • 填入 BLOB 對象,通過賦值 binaryData 屬性(包含位元組陣列的內容)。
  4. 設定追蹤資訊

    • 建立 PDFAConversionOptionSpec 物件,使用其建構子。
    • 指定值以將追蹤層級指定給 PDFAConversionOptionSpec 物件 logLevel 資料成員。 例如,指派值 FINE 到此資料成員。
  5. 轉換文檔

    調用以下命令將PDF文檔轉換為PDF/A文檔 DocConverterServiceService 物件 toPDFA 方法並傳遞下列值:

    • BLOB 包含要轉換的PDF文檔的對象
    • PDFAConversionOptionSpec 指定跟蹤資訊的對象

    toPDFA 方法傳回 PDFAConversionResult 包含PDF/A文檔的對象。

  6. 儲存PDF/檔案

    • 建立 BLOB 透過取得PDF的 PDFAConversionResult 物件 PDFADocument 資料成員。
    • 建立位元組陣列,用於儲存 BLOB 使用 PDFAConversionResult 物件。 取得 BLOB 物件 binaryData 資料成員。
    • 建立 System.IO.FileStream 物件,方法是叫用其建構函式並傳遞字串值,該字串值代表PDF/A檔案的檔案位置。
    • 建立 System.IO.BinaryWriter 對象,調用其建構子並傳遞 System.IO.FileStream 物件。
    • 調用 System.IO.BinaryWriter 物件 Write 方法,並傳遞位元組陣列。

另請參閱

使用PDF/A檔案

使用Base64編碼叫用AEM Forms

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

以程式設計方式決定PDF/符合性

可以使用DocConverter服務來確定PDF文檔是否符合PDF/A。 有關PDF/A文檔以及如何將PDF文檔轉換為PDF/A文檔的資訊,請參閱 將文檔轉換為PDF/A文檔.

注意

有關DocConverter服務的詳細資訊,請參見 AEM Forms服務參考.

步驟摘要

要確定PDF/符合性,請執行以下步驟:

  1. 包含專案檔案。
  2. 建立DocConvert客戶端
  3. 參考用於判斷PDF/符合性的PDF檔案。
  4. 設定運行時選項。
  5. 檢索有關PDF文檔的資訊。

包含項目檔案

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

必須將以下JAR檔案添加到項目的類路徑中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar(若AEM Forms部署在JBoss Application Server上則為必要)
  • jbossall-client.jar(若AEM Forms部署在JBoss Application Server上則為必要)

有關這些JAR檔案的位置的資訊,請參見 包含AEM Forms Java程式庫檔案.

建立DocConvert客戶端

在以寫程式方式執行DocConverter操作之前,必須建立DocConverter客戶端。 如果您使用Java API,請建立 DocConverterServiceClient 物件。 如果您使用DocConverter Web服務API,請建立 DocConverterServiceService 物件。

參考用於確定PDF/符合性的PDF檔案

必須引用PDF文檔並將其傳遞到DocConverter服務,以確定PDF文檔是否符合PDF/A。

設定運行時選項

您可以設定執行階段選項,以決定在轉換過程中要追蹤多少資訊。 也就是說,可以設定9個不同的級別,以指定DocConverter服務將PDF文檔轉換為PDF/A文檔時跟蹤的資訊量。

檢索有關PDF文檔的資訊

建立DocConverter服務客戶端、參考PDF文檔並設定運行時選項後,可以確定PDF文檔是否與PDF/A相容。

另請參閱

使用Java API判斷PDF/符合性

使用網站服務API判斷PDF/符合性

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Java API判斷PDF/符合性

使用Java API來判斷PDF/符合性:

  1. 包含項目檔案

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

  2. 建立DocConvert客戶端

    • 建立 ServiceClientFactory 包含連接屬性的對象。
    • 建立 DocConverterServiceClient 對象,使用其建構子並傳遞 ServiceClientFactory 物件。
  3. 參考用於確定PDF/符合性的PDF檔案

    • 建立 java.io.FileInputStream 表示要轉換的PDF文檔的對象,方法是使用其建構子並傳遞指定PDF檔案位置的字串值。
    • 建立 com.adobe.idp.Document 對象,使用其建構子並傳遞 java.io.FileInputStream 物件。
  4. 設定運行時選項

    • 建立 PDFAValidationOptionSpec 物件,使用其建構子。
    • 通過調用 PDFAValidationOptionSpec 物件 setCompliance 方法與傳遞 PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • 叫用 PDFAValidationOptionSpec 物件 setLogLevel 方法,並傳遞指定追蹤層級的字串值。 例如,傳遞值 FINE. 如需不同值的相關資訊,請參閱 setLogLevel 方法(在 AEM Forms API參考.
  5. 檢索有關PDF文檔的資訊

    叫用以判斷PDF/符合性 DocConverterServiceClient 物件 isPDFA 方法並傳遞下列值:

    • com.adobe.idp.Document 包含PDF文檔的對象。
    • PDFAValidationOptionSpec 指定運行時選項的對象。

    isPDFA 方法傳回 PDFAValidationResult 包含此操作結果的對象。

另請參閱

使用PDF/A檔案

快速入門(SOAP模式):使用Java API判斷PDF/符合性

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務API判斷PDF/符合性

使用網站服務API來判斷PDF/符合性:

  1. 包含項目檔案

    • 建立會使用DocConverter WSDL的Microsoft .NET客戶端程式集。
    • 參考Microsoft .NET客戶端程式集。
  2. 建立DocConvert客戶端

    • 使用Microsoft .NET客戶端程式集,建立 DocConverterServiceService 對象,方法是調用其預設建構子。
    • 設定 DocConverterServiceService 物件 Credentials 具有 System.Net.NetworkCredential 指定用戶名和密碼值的值。
  3. 參考用於確定PDF/符合性的PDF檔案

    • 建立 BLOB 物件,使用其建構子。 此 BLOB 對象用於儲存轉換為PDF/PDF文檔的文檔。
    • 建立 System.IO.FileStream 對象,方法是調用其建構子,並傳遞一個字串值,該字串值表示PDF文檔的檔案位置以及在中開啟檔案的模式。
    • 建立位元組陣列,用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
    • 叫用 System.IO.FileStream 物件 Read 方法,並傳遞位元組陣列、起始位置及流長度以讀取。
    • 填入 BLOB 對象,通過賦值 binaryData 屬性(包含位元組陣列的內容)。
  4. 設定運行時選項

    • 建立 PDFAValidationOptionSpec 物件,使用其建構子。
    • 通過分配 PDFAValidationOptionSpec 物件 compliance 具有值的資料成員 PDFAConversionOptionSpec_Compliance.PDFA_1B.
    • 指派 PDFAValidationOptionSpec 物件 resultLevel 具有值的資料成員 PDFAValidationOptionSpec_ResultLevel.DETAILED.
  5. 檢索有關PDF文檔的資訊

    叫用以判斷PDF/符合性 DocConverterServiceService 物件 isPDFA 方法並傳遞下列值:

    • BLOB 包含PDF文檔的對象。
    • PDFAValidationOptionSpec 包含運行時選項的對象。

    isPDFA 方法傳回 PDFAValidationResult 包含此操作結果的對象。

另請參閱

使用PDF/A檔案

使用Base64編碼叫用AEM Forms

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

本頁內容