使用PDF/A檔案

關於DocConverter服務

DocConverter服務可以將PDF檔案轉換為PDA/A檔案。 您可以使用此服務完成這些工作：

注意

如需DocConverter服務的詳細資訊，請參閱 AEM Forms的服務參考.

將檔案轉換為PDF/A檔案

您可以使用DocConverter服務將PDF檔案轉換為PDF/A檔案。 由於PDF/A是用於長期儲存檔案內容的封存格式，因此所有字型都會嵌入，且檔案會解壓縮。 因此，PDF/A 文件通常比標準 PDF 文件大。此外，PDF/A 文件不包含音訊和視訊內容。將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/A檔案的PDF檔案。
  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/A檔案的PDF檔案

擷取PDF檔案以轉換為PDF/A檔案。 如果您嘗試將PDF檔案(例如Acrobat表單)轉換為PDF/A檔案，則會造成例外狀況。

設定追蹤資訊

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

轉換檔案

建立DocConverter服務使用者端後，參照要轉換的PDF檔案，並設定執行階段選項（指定要追蹤的資訊量），即可將PDF檔案轉換為PDF/A檔案。

儲存PDF/檔案

您可以將PDF/A檔案儲存為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/A檔案的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/檔案之物件。

  6. 儲存PDF/檔案

    • 透過叫用「 」擷取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/A檔案

包含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/A檔案的PDF檔案

    • 建立 BLOB 物件（使用其建構函式）。 此 BLOB 物件可用來儲存轉換成PDF/A檔案的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/檔案之物件。

  6. 儲存PDF/檔案

    • 建立 BLOB PDF物件，透過取得 PDFAConversionResult 物件的 PDFADocument 資料成員。
    • 建立位元組陣列，儲存 BLOB 使用傳回的物件 PDFAConversionResult 物件。 透過取得 BLOB 物件的 binaryData 資料成員。
    • 建立 System.IO.FileStream 物件，方法是叫用其建構函式，並傳遞代表PDF/A檔案檔案位置的字串值。
    • 建立 System.IO.BinaryWriter 物件，方法是叫用其建構函式並傳遞 System.IO.FileStream 物件。
    • PDF透過叫用 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/A相容性，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立DocConvert使用者端
  3. 參考用於判斷PDF/A合規性的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/A合規性的PDF檔案

必須參考PDF檔案並將其傳遞到DocConverter服務，才能確定PDF檔案是否符合PDF/A規範。

設定執行階段選項

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

擷取PDF檔案的相關資訊

建立DocConverter服務使用者端、參考PDF檔案並設定執行階段選項後，您可以判斷PDF檔案是否符合PDF/A規範。

另請參閱

使用Java API判斷PDF/A合規性

使用Web服務API判斷PDF/A合規性

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Java API判斷PDF/A合規性

使用Java API判斷PDF/A合規性：

  1. 包含專案檔案

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

  2. 建立DocConvert使用者端

    • 建立 ServiceClientFactory 包含連線屬性的物件。
    • 建立 DocConverterServiceClient 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件。

  3. 參考用於判斷PDF/A合規性的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/A合規性 DocConverterServiceClient 物件的 isPDFA 並傳遞下列值：

    • 此 com.adobe.idp.Document 包含PDF檔案的物件。
    • 此 PDFAValidationOptionSpec 指定執行階段選項的物件。

    此 isPDFA 方法傳回 PDFAValidationResult 包含此作業結果的物件。

另請參閱

使用PDF/A檔案

快速入門（SOAP模式）：使用Java API判斷PDF/A合規性

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API判斷PDF/A合規性

使用Web服務API判斷PDF/A合規性：

  1. 包含專案檔案

    • 建立使用DocConverter WSDL的Microsoft .NET使用者端元件。
    • 參考Microsoft .NET使用者端元件。

  2. 建立DocConvert使用者端

    • 使用Microsoft .NET使用者端元件，建立 DocConverterServiceService 物件，透過叫用其預設建構函式。
    • 設定 DocConverterServiceService 物件的 Credentials 具有的資料成員 System.Net.NetworkCredential 指定使用者名稱和密碼值的值。

  3. 參考用於判斷PDF/A合規性的PDF檔案

    • 建立 BLOB 物件（使用其建構函式）。 此 BLOB 物件可用來儲存轉換成PDF/A檔案的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/A合規性 DocConverterServiceService 物件的 isPDFA 並傳遞下列值：

    • 此 BLOB 包含PDF檔案的物件。
    • 此 PDFAValidationOptionSpec 包含執行階段選項的物件。

    此 isPDFA 方法傳回 PDFAValidationResult 包含此作業結果的物件。

另請參閱

使用PDF/A檔案

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的.NET使用者端元件

本頁內容