啟用版權的Forms

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

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

注意

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

注意

當您指定下列使用權限時，無法預先填入XML資料的表格：enableComments、enableCommentsOnline、enableEmbeddedFiles或enableDigitalSignatures。 (請參閱使用可流式版面預填Forms)。

注意

有關Forms服務的詳細資訊，請參閱AEM Forms服務參考。

步驟摘要

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

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

包含專案檔案

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

建立Forms用戶端API物件

在以寫程式方式執行Forms服務客戶端API操作之前，必須建立Forms服務客戶端。

設定使用權限運行時選項

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

轉譯啟用權限的表單

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

注意

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

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

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

另請參閱

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

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

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

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

包含專案檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-forms-client.jar。
建立Forms用戶端API物件
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory對象，建立FormsServiceClient對象。
設定使用權限運行時選項
- 使用其建構子建立ReaderExtensionSpec對象。
- 調用ReaderExtensionSpec物件的setReCredentialAlias方法以指定憑證的別名，並指定代表別名值的字串值。
- 通過調用屬於ReaderExtensionSpec對象的相應方法來設定每個使用權限。不過，您只能在您引用的憑證允許您進行設定時，設定正確的使用方式。也就是說，如果憑據不允許您設定，則不能設定正確的使用情形。例如。若要設定使用權，讓使用者可填寫表格欄位並儲存表格，請叫用ReaderExtensionSpec物件的setReFillIn方法並傳遞true。
注意

您不需要叫用ReaderExtensionSpec物件的setReCredentialPassword方法。 Forms服務不使用此方法。
轉譯啟用權限的表單

叫用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瀏覽器的表單資料流。
將表單資料串流寫入用戶端網頁瀏覽器
- 通過調用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 FormsJava庫檔案

設定連接屬性

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

使用FormsAPI(web service)來轉譯啟用權限的表格：

包含專案檔案
- 建立使用Forms服務WSDL的Java代理類。
- 將Java代理類包含到類路徑中。
建立Forms用戶端API物件

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

叫用FormsService物件的renderPDFFormWithUsageRights方法並傳遞下列值：
- 指定表單設計名稱的字串值，包括檔案副檔名。如果您參考屬於Forms應用程式的表單設計，請確定您指定完整路徑，例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
- BLOB物件，包含要與表單合併的資料。如果您不想將資料與表單合併，則必須傳遞以空XML資料來源為基礎的BLOB物件。不能傳遞BLOB對象為null;否則，會拋出異常。
- 儲存運行時選項的PDFFormRenderSpec對象。
- ReaderExtensionSpec物件，可儲存使用權限執行時間選項。
- URLSpec物件，包含Forms服務所需的URI值。
renderPDFFormWithUsageRights方法返回一個FormsResult對象，該對象包含必須寫入客戶端Web瀏覽器的表單資料流。
將表單資料串流寫入用戶端網頁瀏覽器
- 呼叫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方法。