指派使用許可權

最後更新： 2024年7月14日
  • 適用對象：
  • Experience Manager 6.5
  • 主題：

建立對象：

  • 開發人員

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

關於Acrobat Reader DC擴充功能服務

Acrobat Reader DC擴充功能服務可擴充Adobe Reader的功能，讓您的組織輕鬆共用互動式PDF檔案。 Acrobat Reader DC擴充功能服務完全支援任何PDF檔案，最高支援(包括PDF1.7)。它適用於Adobe Reader 7.0和更新版本。 此服務會將使用許可權新增至PDF檔案，並啟動使用Adobe Reader開啟PDF檔案時通常無法使用的功能。 協力廠商使用者不需要其他軟體或外掛程式即可使用啟用許可權的檔案。

您可以使用Acrobat Reader DC擴充功能服務完成這些工作：

注意
如需Acrobat Reader DC擴充功能服務的詳細資訊，請參閱AEM Forms服務參考。

將使用許可權套用至PDF檔案

您可以使用Acrobat Reader DC擴充功能Java使用者端API和Web服務，將使用許可權套用至PDF檔案。 使用許可權與Acrobat中預設提供的功能有關，但不適用於Adobe Reader，例如新增註解至表單或填寫表單欄位及儲存表單的功能。 已套用使用許可權的PDF檔案稱為許可權啟用檔案。 在Adobe Reader中開啟許可權啟用檔案的使用者可執行針對該特定檔案啟用的操作。

注意
使用applyUsageRights方法（屬於Java API的一部分）將使用許可權套用至PDF檔案時，您可以將ReaderExtensionsOptionSpec物件的isModeFinal引數設定為false。 這會導致Forms Processed計數器未更新且效能提高。 如果您不介意更新已處理的表單計數器，建議您將isModeFinal引數設為false。
注意
如需Acrobat Reader DC擴充功能服務的詳細資訊，請參閱AEM Forms服務參考。

步驟摘要

若要將使用許可權套用至PDF檔案，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立Acrobat Reader DC擴充功能使用者端物件。
  3. 擷取PDF檔案。
  4. 指定要套用的使用許可權。
  5. 套用使用許可權至PDF檔案。
  6. 儲存啟用許可權的PDF檔案。

包含專案檔

將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

建立Acrobat Reader DC擴充功能使用者端物件

若要以程式設計方式執行Acrobat Reader DC擴充功能服務作業，您必須建立Acrobat Reader DC擴充功能服務使用者端物件。 如果您使用Acrobat Reader DC擴充功能Java API，請建立ReaderExtensionsServiceClient物件。 如果您使用Acrobat Reader DC擴充功能Web服務API，請建立ReaderExtensionsServiceService物件。

擷取PDF檔案

擷取PDF檔案以套用使用許可權。 啟用許可權的PDF檔案包含使用許可權字典。 當Adobe Reader開啟包含這類字典的檔案時，它只會啟用字典中為該檔案指定的使用許可權。 如果檔案不含使用許可權字典，Acrobat Reader DC擴充功能服務會建立一個。 如果其中已包含字典，Acrobat Reader DC擴充功能服務會以您指定的使用許可權覆寫現有的使用許可權。 字典會指定已啟用哪些使用許可權。 當使用者在Adobe Reader中開啟檔案時，僅允許字典中指定的使用許可權。

指定要套用的使用許可權

您可以設定的使用許可權取決於您從Adobe Systems Incorporated購買的認證。 憑證通常會提供許可權來設定一組相關的使用許可權，例如與互動式表單相關的使用許可權。 每個認證都提供建立特定數量已啟用許可權的PDF檔案的權利。 評估認證可讓您建立不限數量的草稿檔案。

注意
如果您嘗試指派認證不允許的使用許可權，則會造成例外狀況。

套用使用許可權至PDF檔案

若要將使用許可權套用至PDF檔案，您可以參考您用來套用使用許可權的認證別名(認證通常會在安裝AEM Forms期間安裝)。 您也必須指定套用使用許可權的PDF檔案。 如需有關設定認證的資訊，請參閱應用程式伺服器的安裝和部署指南。

儲存啟用許可權的PDF檔案

Acrobat Reader DC擴充功能服務將使用許可權套用至PDF檔案後，您就可以將許可權啟用的PDF檔案儲存為PDF檔案。

另請參閱

使用Java API套用使用許可權

使用網站服務API套用使用許可權

包含AEM Forms Java程式庫檔案

設定連線屬性

Acrobat Reader DC擴充功能服務API快速入門

使用Java API套用使用許可權

使用Acrobat Reader DC擴充功能API (Java)將使用許可權套用至PDF檔案：

  1. 包含專案檔案

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

  2. 建立Acrobat Reader DC擴充功能使用者端物件。

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

  3. 擷取PDF檔案。

    • 使用它的建構函式並傳遞指定PDF檔案位置的字串值，建立代表PDF檔案的java.io.FileInputStream物件。
    • 使用它的建構函式並傳遞java.io.FileInputStream物件來建立com.adobe.idp.Document物件。

  4. 指定要套用的使用許可權。

    • 使用建構函式建立代表使用許可權的UsageRights物件。
    • 針對要套用的每個使用許可權，叫用屬於UsageRights物件的對應方法。 例如，若要新增enableFormFillIn使用許可權，請叫用UsageRights物件的enableFormFillIn方法並傳遞true。 （針對要套用的每個使用許可權，重複此步驟）。

  5. 套用使用許可權至PDF檔案。

    • 使用物件的建構函式建立ReaderExtensionsOptionSpec物件。 此物件包含Acrobat Reader DC擴充功能服務所需的執行階段選項。 叫用此建構函式時，您必須指定下列值：

      • 包含要套用至檔案之使用許可權的UsageRights物件。
      • 字串值，指定在Adobe Reader 7.x中開啟許可權啟用PDF檔案時，使用者看到的訊息。Adobe Reader 8.0中未顯示此訊息。

    • 透過叫用ReaderExtensionsServiceClient物件的applyUsageRights方法並傳遞下列值，將使用許可權套用至PDF檔案：

      • 包含套用使用許可權之PDF檔案的com.adobe.idp.Document物件。
      • 字串值，指定可讓您套用使用許可權的認證別名。
      • 字串值，指定對應的密碼值。 (目前會忽略此引數。 您可以傳遞null。)

    • 包含執行階段選項的ReaderExtensionsOptionSpec物件。

    applyUsageRights方法傳回包含已啟用許可權的PDF檔案的com.adobe.idp.Document物件。

  6. 儲存啟用許可權的PDF檔案。

    • 建立java.io.File物件，並確定副檔名為.pdf。
    • 叫用com.adobe.idp.Document物件的copyToFile方法，將com.adobe.idp.Document物件的內容複製到檔案（請確定您使用的是applyUsageRights方法傳回的com.adobe.idp.Document物件）。

另請參閱

將使用許可權套用至PDF檔案

快速入門(SOAP模式)：使用Java API套用使用許可權

包含AEM Forms Java程式庫檔案

設定連線屬性