呈現啟用權限的表單

Forms服務可以呈現已套用使用權限的表單。 使用權限與Acrobat預設為Acrobat但Adobe Reader未提供的功能相關，例如在表格中新增註解或填寫表格欄位並儲存表格的功能。 具有套用使用權限的表單稱為啟用權限的表單。 在Adobe Reader中開啟具權限的表格的使用者，可以執行為該表格啟用的作業。

若要將使用權套用至表單，Acrobat Reader DC擴充功能服務必須是AEM表單安裝的一部分。 此外，您必須擁有有效的憑證，才能將使用權套用至PDF檔案。 也就是說，您必須先正確設定Acrobat Reader DC擴充功能服務，才能轉換具權限的表格。 （請參閱關於Acrobat Reader DC擴充功能服務）。

注意

若要轉換包含使用權限的表單，您必須使用XDP檔案做為輸入，而非PDF檔案。 如果您使用PDF檔案作為輸入，表單仍會轉譯；但是，它不是啟用權限的表格。

注意

當您指定下列使用權限時，無法預先填入XML資料的表格：enableComments、enableCommentsOnline、enableEmbeddedFiles或enableDigitalSignatures。 （請參閱使用可排程版面預填表單）。

注意

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

步驟摘要

要呈現啟用權限的表單，請執行以下任務：

  1. 包含專案檔案。
  2. 建立Forms用戶端API物件。
  3. 設定使用權限執行時期選項。
  4. 轉譯啟用權限的表單。
  5. 將啟用權限的表單寫入客戶端Web瀏覽器。

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

建立Forms用戶端API物件

您必須先建立Forms服務用戶端，才能以程式設計方式執行Forms服務用戶端API操作。

設定使用權限運行時選項

您必須設定使用權限執行時期選項，才能產生啟用權限的表單。 您還必須指定用於對表單應用使用權限的憑據別名。 指定別名值後，您可以直接指定每個用法以套用至表單。

轉譯啟用權限的表單

若要轉換具有權限的表格，請使用與轉換沒有使用權限的表格相同的應用程式邏輯。 唯一的區別是，您必須確保應用程式邏輯中包含使用權限執行時間選項。

注意

使用Forms web service API轉換具有權限的表格時，您無法將檔案附加至表格。

將表單資料串流寫入用戶端網頁瀏覽器

當Forms服務轉換具有權限的表單時，它會傳回必須寫入用戶端網頁瀏覽器的表單資料流。 一旦寫入到客戶端Web瀏覽器，用戶就可以看到表單。 在Adobe Reader中檢視已啟用權限的表格的使用者，可以執行為該表格啟用的作業。

另請參閱

使用Java API演算啟用權限的表單

使用web service API演算具權限的表格

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms Service API快速入門

轉換互動式PDF表單

建立轉譯表單的Web應用程式

使用Java API演算啟用權限的表格

使用Forms API(Java)來轉譯啟用權限的表格：

  1. 包含專案檔案

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

  2. 建立Forms用戶端API物件

    • 建立包含連接屬性的ServiceClientFactory對象。
    • 使用其建構子並傳遞ServiceClientFactory對象，建立FormsServiceClient對象。

  3. 設定使用權限運行時選項

    • 使用其建構子建立ReaderExtensionSpec對象。
    • 調用ReaderExtensionSpec物件的setReCredentialAlias方法以指定憑證的別名，並指定代表別名值的字串值。
    • 通過調用屬於ReaderExtensionSpec對象的相應方法來設定每個使用權限。 不過，您只能在您引用的憑證允許您進行設定時，設定正確的使用方式。 也就是說，如果憑據不允許您設定，則不能設定正確的使用情形。 例如。 若要設定使用權，讓使用者可填寫表格欄位並儲存表格，請叫用ReaderExtensionSpec物件的setReFillIn方法並傳遞true。
    注意

    您不需要叫用ReaderExtensionSpec物件的setReCredentialPassword方法。 Forms服務不會使用此方法。

  4. 轉譯啟用權限的表單

    叫用FormsServiceClient物件的renderPDFFormWithUsageRights方法並傳遞下列值：

    • 指定表單設計名稱的字串值，包括檔案副檔名。 如果您參考屬於Forms應用程式一部分的表單設計，請確定您指定完整路徑，例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
    • com.adobe.idp.Document物件，包含要與表單合併的資料。 如果您不想合併資料，請傳遞空白的com.adobe.idp.Document物件。
    • 儲存運行時選項的PDFFormRenderSpec對象。
    • ReaderExtensionSpec物件，可儲存使用權限執行時間選項。
    • URLSpec物件，包含Forms服務所需的URI值。

    renderPDFFormWithUsageRights方法返回一個FormsResult對象，該對象包含必須寫入客戶端Web瀏覽器的表單資料流。

  5. 將表單資料串流寫入用戶端網頁瀏覽器

    • 通過調用FormsResult對象「s getOutputContent」方法建立com.adobe.idp.Document對象。
    • 通過調用getContentType方法獲取com.adobe.idp.Document對象的內容類型。
    • 調用setContentType方法並傳遞com.adobe.idp.Document物件的內容類型，以設定javax.servlet.http.HttpServletResponse物件的內容類型。
    • 呼叫javax.servlet.http.HttpServletResponse物件的getOutputStream方法，建立javax.servlet.ServletOutputStream物件，用來將表單資料串流寫入用戶端Web瀏覽器。
    • 調用com.adobe.idp.Document物件的getInputStream方法，以建立java.io.InputStream物件。
    • 呼叫InputStream物件的read方法，並將位元組陣列傳入為引數，以填入表單資料流的位元組陣列。
    • 叫用javax.servlet.ServletOutputStream物件的write方法，將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write方法。

另請參閱

快速入門（SOAP模式）:使用Java API轉譯具權限的表格

包含AEM Forms Java程式庫檔案

設定連接屬性

使用web service API轉譯啟用權限的表單

使用Forms API(web service)來轉譯具有權限的表格：

  1. 包含專案檔案

    • 建立使用Forms服務WSDL的Java代理類。
    • 將Java代理類包含到類路徑中。

  2. 建立Forms用戶端API物件

    建立FormsService對象並設定驗證值。

  3. 設定使用權限運行時選項

    • 使用其建構子建立ReaderExtensionSpec對象。
    • 調用ReaderExtensionSpec物件的setReCredentialAlias方法以指定憑證的別名，並指定代表別名值的字串值。
    • 通過調用屬於ReaderExtensionSpec對象的相應方法來設定每個使用權限。 不過，您只能在您引用的憑證允許您進行設定時，設定正確的使用方式。 也就是說，如果憑據不允許您設定，則不能設定正確的使用情形。 若要設定使用權，讓使用者可填寫表格欄位並儲存表格，請叫用ReaderExtensionSpec物件的setReFillIn方法並傳遞true。

  4. 轉譯啟用權限的表單

    叫用FormsService物件的renderPDFFormWithUsageRights方法並傳遞下列值：

    • 指定表單設計名稱的字串值，包括檔案副檔名。 如果您參考屬於Forms應用程式一部分的表單設計，請確定您指定完整路徑，例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
    • BLOB物件，包含要與表單合併的資料。 如果您不想將資料與表單合併，則必須傳遞以空XML資料來源為基礎的BLOB物件。 不能傳遞BLOB對象為null;否則，會拋出異常。
    • 儲存運行時選項的PDFFormRenderSpec對象。
    • ReaderExtensionSpec物件，可儲存使用權限執行時間選項。
    • URLSpec物件，包含Forms服務所需的URI值。

    renderPDFFormWithUsageRights方法返回一個FormsResult對象，該對象包含必須寫入客戶端Web瀏覽器的表單資料流。

  5. 將表單資料串流寫入用戶端網頁瀏覽器

    • 呼叫FormsResult物件的getOutputContent方法，建立包含表單資料的BLOB物件。
    • 通過調用getContentType方法獲取BLOB對象的內容類型。
    • 調用setContentType方法並傳遞BLOB物件的內容類型，以設定javax.servlet.http.HttpServletResponse物件的內容類型。
    • 呼叫javax.servlet.http.HttpServletResponse物件的getOutputStream方法，建立javax.servlet.ServletOutputStream物件，用來將表單資料串流寫入用戶端Web瀏覽器。
    • 建立位元組陣列，並呼叫BLOB物件的getBinaryData方法以填入它。 此任務將FormsResult對象的內容分配給位元組陣列。
    • 叫用javax.servlet.http.HttpServletResponse物件的write方法，將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write方法。

另請參閱

轉換具權限的表單

使用Base64編碼叫用AEM Forms

本頁內容