呈現已啟用權限的Forms

Forms服務可轉譯套用使用權限的表單。 使用權限屬於Acrobat預設提供但Adobe Reader未提供的功能，例如可向表單新增註解，或填寫表單欄位並儲存表單。 套用使用權限的Forms稱為已啟用權限的表單。 在Adobe Reader中開啟已啟用權限的表單的使用者可以執行針對該表單啟用的操作。

若要將使用權套用至表單，Acrobat Reader DC擴充功能服務必須是AEM表單安裝程式的一部分。 此外，您必須具備有效的憑證，以便將使用權套用至PDF檔案。 也就是說，您必須正確設定Acrobat Reader DC擴充功能服務，才能轉譯已啟用權限的表單。 (請參閱關於Acrobat Reader DC擴充功能服務。)

步驟的摘要

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

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

包含項目檔案

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

建立Forms用戶端API物件

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

設定使用權運行時間選項

您必須設定使用權限運行時選項，才能呈現已啟用權限的表單。 您還必須指定用於將使用權應用於表單的憑據的別名。 指定別名值後，您可以指定每個使用方式以套用至表單。

轉譯已啟用權限的表單

若要呈現已啟用權限的表單，您使用的應用程式邏輯與呈現沒有使用權限的表單相同。 唯一的差異是您必須確保應用程式邏輯中包含使用權限執行時間選項。

將表單資料流寫入客戶端Web瀏覽器

Forms服務轉譯已啟用權限的表單時，會傳回您必須寫入用戶端網頁瀏覽器的表單資料流。 寫入客戶端Web瀏覽器後，用戶將看到該表單。 在Adobe Reader中檢視已啟用權限的表單的使用者，可以執行針對該表單啟用的操作。

另請參閱

使用Java API呈現已啟用權限的表單

使用網站服務API呈現已啟用權限的表單

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

轉譯互動式PDF forms

建立可轉譯Forms的網頁應用程式

使用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. 將表單資料流寫入客戶端Web瀏覽器

   • 調用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方法，建立用於將表單資料流寫入客戶端Web瀏覽器的javax.servlet.ServletOutputStream對象。
   • 調用com.adobe.idp.Document對象的getInputStream方法，建立java.io.InputStream對象。
   • 叫用InputStream物件的read方法並將位元組陣列傳遞為引數，以填入表單資料流的位元組陣列。
   • 調用javax.servlet.ServletOutputStream對象的write方法，將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write方法。

另請參閱

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

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務API呈現已啟用權限的表單

使用Forms API（網站服務）轉譯已啟用權限的表單：

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對象；否則，會擲回例外。
   • 儲存運行時選項的PDFFormRenderSpec對象。
   • ReaderExtensionSpec物件，用於儲存使用權限執行時間選項。
   • URLSpec物件，包含Forms服務所需的URI值。

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

5. 將表單資料流寫入客戶端Web瀏覽器

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

另請參閱

呈現已啟用權限的Forms

使用Base64編碼叫用AEM Forms