使用策略保護文檔

撤消對文檔的訪問

使用Java API將策略應用於PDF文檔

使用Document Security API(Java)將策略應用於PDF文檔：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 RightsManagementClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索PDF文檔。
- 建立 java.io.FileInputStream 使用其建構子表示PDF文檔的對象。傳遞指定PDF文檔位置的字串值。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
將現有策略應用於PDF文檔。
- 建立 DocumentManager 對象，方法是調用 RightsManagementClient 物件 getDocumentManager 方法。
- 通過調用 DocumentManager 物件 protectDocument 方法並傳遞下列值：
  - 此 com.adobe.idp.Document 包含應用策略的PDF文檔的對象。
  - 指定文檔名稱的字串值。
  - 一個字串值，它指定策略所屬的策略集的名稱。您可以指定 null 產生 MyPolicies 正在使用的策略集。
  - 指定策略名稱的字串值。
  - 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為可選值，可為null（如果此參數為null，則下一個參數值必須為null）。
  - 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為選用值，可以是 null (如果此參數為null，則上一個參數值必須為 null)。
  - A com.adobe.livecycle.rightsmanagement.Locale 表示用於選擇MS Office模板的區域設定。此參數值為可選值，不用於PDF文檔。要保護PDF文檔，請指定 null.
  此 protectDocument 方法傳回 RMSecureDocumentResult 包含受策略保護的PDF文檔的對象。
保存PDF文檔。
- 叫用 RMSecureDocumentResult 物件 getProtectedDoc 獲取受策略保護的PDF文檔的方法。此方法會傳回 com.adobe.idp.Document 物件。
- 建立 java.io.File 物件，並確定副檔名為PDF。
- 叫用 com.adobe.idp.Document 物件 copyToFile 複製內容的方法 Document 物件(請確定您使用 Document 由傳回的物件 getProtectedDoc 方法)。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（EJB模式）:使用Java API將原則套用至PDF檔案」
"快速入門（SOAP模式）:使用Java API將原則套用至PDF檔案」

另請參閱

使用Web服務API將策略應用到PDF文檔

使用Document Security API（web服務）將策略應用於PDF文檔：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 RightsManagementServiceClient 物件，使用其預設建構函式。
- 建立 RightsManagementServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 RightsManagementServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 RightsManagementServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索PDF文檔。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存應用策略的PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。透過取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法。傳遞位元組陣列、起始位置和資料流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
將現有策略應用於PDF文檔。

通過調用 RightsManagementServiceClient 物件 protectDocument 方法並傳遞下列值：
- 此 BLOB 包含應用策略的PDF文檔的對象。
- 指定文檔名稱的字串值。
- 一個字串值，它指定策略所屬的策略集的名稱。您可以指定 null 產生 MyPolicies 正在使用的策略集。
- 指定策略名稱的字串值。
- 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為選用值，且可為null(如果此參數為null，則下一個參數值必須為 null)。
- 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為選用值，且可為null(如果此參數為null，則上一個參數值必須為 null)。
- A RMLocale 指定地區設定值的值(例如 RMLocale.en)。
- 用於儲存策略標識符值的字串輸出參數。
- 用於儲存受策略保護的標識符值的字串輸出參數。
- 用於儲存mime類型的字串輸出參數(例如， application/pdf)。
此 protectDocument 方法傳回 BLOB 包含受策略保護的PDF文檔的對象。
保存PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示受策略保護的PDF文檔的檔案位置。
- 建立位元組陣列，用於儲存 BLOB 由傳回的物件 protectDocument 方法。取得 BLOB 物件 MTOM 資料成員。
- 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
- 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API將策略應用到PDF文檔」
「快速入門(SwaRef):使用Web服務API將策略應用到PDF文檔。

從PDF文檔中刪除策略

可以從受策略保護的文檔中刪除策略，以便從文檔中刪除安全性。也就是說，如果您不再希望該文檔受策略保護。如果要使用較新的策略更新受策略保護的文檔，則不刪除該策略並添加更新的策略，切換該策略會更加有效。

注意

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

步驟摘要

要從受策略保護的PDF文檔中刪除策略，請執行以下步驟：

包含項目檔案
建立Document Security用戶端API物件。
檢索受策略保護的PDF文檔。
從PDF文檔中刪除策略。
保存不安全的PDF文檔。

包含項目檔案

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

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，請建立Document Security服務客戶端對象。

檢索受策略保護的PDF文檔

可以檢索受策略保護的PDF文檔以刪除策略。如果嘗試從未受策略保護的PDF文檔中刪除策略，將導致異常。

從PDF文檔中刪除策略

如果在連接設定中指定了管理員，則可以從受策略保護的PDF文檔中刪除策略。否則，用於保護文檔的策略必須包含 SWITCH_POLICY 權限，以便從PDF文檔中刪除策略。此外，在AEM Forms連線設定中指定的使用者也必須擁有該權限。否則，會擲回例外。

保存不安全的PDF文檔

在Document Security服務從PDF文檔中刪除策略後，您可以將不安全的PDF文檔另存為PDF檔案。

另請參閱

使用Java API從PDF文檔中刪除策略

使用Document Security API(Java)從受策略保護的PDF文檔中刪除策略：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 DocumentSecurityClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索受策略保護的PDF文檔。
- 建立 java.io.FileInputStream 表示受策略保護的PDF文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定PDF文檔的位置。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
從PDF文檔中刪除策略。
- 建立 DocumentManager 對象，方法是調用 DocumentSecurityClient 物件 getDocumentManager 方法。
- 通過調用 DocumentManager 物件 removeSecurity 方法和傳遞 com.adobe.idp.Document 包含受策略保護的PDF文檔的對象。此方法會傳回 com.adobe.idp.Document 包含不安全PDF文檔的對象。
保存不安全的PDF文檔。
- 建立 java.io.File 物件，並確定副檔名為PDF。
- 叫用 Document 物件 copyToFile 複製內容的方法 Document 物件(請確定您使用 Document 由傳回的物件 removeSecurity 方法)。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API從PDF文檔中刪除策略」

使用Web服務API刪除策略

使用文檔安全API（Web服務）從受策略保護的PDF文檔中刪除策略：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 DocumentSecurityServiceClient 物件，使用其預設建構函式。
- 建立 DocumentSecurityServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 DocumentSecurityServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索受策略保護的PDF文檔。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存從中刪除策略的受策略保護的PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
從PDF文檔中刪除策略。

通過調用 DocumentSecurityServiceClient 物件 removePolicySecurity 方法和傳遞 BLOB 包含受策略保護的PDF文檔的對象。此方法會傳回 BLOB 包含不安全PDF文檔的對象。
保存不安全的PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示不安全PDF文檔的檔案位置。
- 建立位元組陣列，用於儲存 BLOB 由傳回的物件 removePolicySecurity 方法。取得 BLOB 物件 MTOM 欄位。
- 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API從PDF文檔中刪除策略「
「快速入門(SwaRef):使用Web服務API從PDF文檔中刪除策略」

另請參閱

撤消對文檔的訪問

您可以撤消對受策略保護的PDF文檔的訪問，導致用戶無法訪問該文檔的所有副本。當使用者嘗試開啟撤銷的PDF檔案時，系統會將他們重新導向至指定的URL，以便檢視修訂的檔案。必須以程式設計方式指定使用者重新導向的URL。當您撤銷對文檔的訪問權時，此更改將在用戶下次通過聯機開啟受策略保護的文檔與文檔安全服務同步時生效。

撤銷對文檔的訪問權的能力提供了額外的安全性。例如，假設文檔有較新版本，並且您不再希望任何人查看過期版本。在這種情況下，可以撤銷對舊文檔的訪問，除非恢復訪問，否則任何人都無法查看該文檔。

注意

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

步驟摘要

要撤銷受策略保護的文檔，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索受策略保護的PDF文檔。
撤消受策略保護的文檔。

包含項目檔案

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

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，必須建立Document Security服務客戶端對象。

檢索受策略保護的PDF文檔

必須檢索受策略保護的PDF文檔才能撤銷它。不能撤消已撤銷或不是受策略保護的文檔。

如果您知道受策略保護文檔的許可證標識符值，則不需要檢索受策略保護的PDF文檔。但是，在大多數情況下，您需要檢索PDF文檔才能獲得許可證標識符值。

撤消受策略保護的文檔

要撤銷受策略保護的文檔，請指定受策略保護文檔的許可證標識符。此外，您還可以指定當用戶嘗試開啟撤消的文檔時可以查看的文檔的URL。也就是說，假設已過時的檔案被撤銷。當用戶嘗試開啟已撤銷的文檔時，他們將看到更新的文檔，而不是已撤銷的文檔。

注意

如果嘗試撤消已撤消的文檔，則會引發異常。

另請參閱

恢復對已撤銷文檔的訪問

使用Java API撤銷對文檔的訪問

使用Document Security API(Java)撤銷對受策略保護的PDF文檔的訪問：

包含項目檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 DocumentSecurityClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索受策略保護的PDF文檔
- 建立 java.io.FileInputStream 表示受策略保護的PDF文檔的對象，方法是使用其建構子並傳遞指定PDF文檔位置的字串值。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
撤消受策略保護的文檔
- 建立 DocumentManager 對象，方法是調用 DocumentSecurityClient 物件 getDocumentManager 方法。
- 通過調用 DocumentManager 物件 getLicenseId 方法。傳遞 com.adobe.idp.Document 表示受策略保護文檔的對象。此方法會傳回代表授權識別碼值的字串值。
- 建立 LicenseManager 對象，方法是調用 DocumentSecurityClient 物件 getLicenseManager 方法。
- 通過調用 LicenseManager 物件 revokeLicense 方法並傳遞下列值：
  - 一個字串值，它指定受策略保護文檔的許可證標識符值(指定 DocumentManager 物件 getLicenseId 方法)。
  - 的靜態資料成員 License 指定撤消文檔的原因的介面。例如，您可以指定 License.DOCUMENT_REVISED.
  - A java.net.URL 指定修訂文檔所在位置的值。如果您不想將使用者重新導向至其他URL，則可以傳遞 null.

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API撤銷文檔」

使用Web服務API撤銷對文檔的訪問

使用Document Security API（Web服務）撤消對受策略保護的PDF文檔的訪問：

包含項目檔案

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件
- 建立 DocumentSecurityServiceClient 物件，使用其預設建構函式。
- 建立 DocumentSecurityServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 DocumentSecurityServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索受策略保護的PDF文檔
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存被撤銷的受策略保護的PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示要撤銷的策略保護PDF文檔的檔案位置以及開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
撤消受策略保護的文檔
- 通過調用 DocumentSecurityServiceClient 物件 getLicenseID 方法和傳遞 BLOB 表示受策略保護文檔的對象。此方法會傳回代表授權識別碼的字串值。
- 通過調用 DocumentSecurityServiceClient 物件 revokeLicense 方法並傳遞下列值：
  - 一個字串值，它指定受策略保護文檔的許可證標識符值(指定 DocumentSecurityServiceService 物件 getLicenseId 方法)。
  - 的靜態資料成員 Reason 指定撤消文檔的原因的枚舉。例如，您可以指定 Reason.DOCUMENT_REVISED.
  - A string 指定修訂文檔所在的URL位置的值。如果您不想將使用者重新導向至其他URL，則可以傳遞 null.

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API撤消文檔」
「快速入門(SwaRef):使用Web服務API撤消文檔」

另請參閱

從Word文檔中刪除策略

恢復對已撤銷文檔的訪問

您可以恢復對已撤銷PDF文檔的訪問權，從而使用戶可以訪問已撤銷文檔的所有副本。當用戶開啟被撤消的恢復文檔時，用戶可以查看該文檔。

注意

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

步驟摘要

要恢復對已撤銷PDF文檔的訪問，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索已撤銷PDF文檔的許可證標識符。
恢復對已撤銷PDF文檔的訪問。

包含項目檔案

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

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，必須建立Document Security服務客戶端對象。如果您使用Java API，請建立 DocumentSecurityClient 物件。如果您使用Document Security Web服務API，請建立 DocumentSecurityServiceService 物件。

檢索已撤銷的PDF文檔的許可證標識符

您必須檢索已撤銷PDF文檔的許可證標識符，才能恢復已撤銷的PDF文檔。獲取許可證標識符值後，可以恢復已撤銷的文檔。如果嘗試恢復未撤銷的文檔，將導致異常。

恢復對已撤銷PDF文檔的訪問

要恢復對已撤銷PDF文檔的訪問，必須指定已撤銷文檔的許可證標識符。如果嘗試恢復未撤銷的PDF文檔的訪問權，將導致異常。

另請參閱

撤消對文檔的訪問

使用Java API恢復對撤銷文檔的訪問

使用文檔安全API(Java)恢復對已撤銷文檔的訪問：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 DocumentSecurityClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索已撤銷PDF文檔的許可證標識符。
- 建立 java.io.FileInputStream 表示已撤銷PDF文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定PDF文檔的位置。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
- 建立 DocumentManager 對象，方法是調用 DocumentSecurityClient 物件 getDocumentManager 方法。
- 通過調用 DocumentManager 物件 getLicenseId 方法和傳遞 com.adobe.idp.Document 表示已撤銷文檔的對象。此方法會傳回代表授權識別碼的字串值。
恢復對已撤銷PDF文檔的訪問。
- 建立 LicenseManager 對象，方法是調用 DocumentSecurityClient 物件 getLicenseManager 方法。
- 通過調用 LicenseManager 物件 unrevokeLicense 方法，並傳遞已撤銷檔案的授權識別碼值。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Web服務API恢復對已撤銷文檔的訪問」

使用Web服務API恢復對已撤銷文檔的訪問

使用文檔安全API（Web服務）恢復對已撤銷文檔的訪問：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 DocumentSecurityServiceClient 物件，使用其預設建構函式。
- 建立 DocumentSecurityServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 DocumentSecurityServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索已撤銷PDF文檔的許可證標識符。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存撤消的PDF文檔，該文檔將恢復訪問。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示已撤銷PDF文檔的檔案位置以及開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
恢復對已撤銷PDF文檔的訪問。
- 通過調用 DocumentSecurityServiceClient 物件 getLicenseID 方法和傳遞 BLOB 表示已撤銷文檔的對象。此方法會傳回代表授權識別碼的字串值。
- 通過調用 DocumentSecurityServiceClient 物件 unrevokeLicense 方法，並傳遞字串值，該字串值指定已撤銷PDF文檔的許可標識符值(傳遞 DocumentSecurityServiceClient 物件 getLicenseId 方法)。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API恢復對已撤銷文檔的訪問」
「快速入門(SwaRef):使用Web服務API恢復對已撤銷文檔的訪問」

另請參閱

檢查受策略保護的PDF文檔

您可以使用Document Security Service API（Java和Web服務）來檢查受原則保護的PDF檔案。檢查受策略保護的PDF文檔時，返回有關受策略保護的PDF文檔的資訊。例如，您可以確定用於保護文檔的策略以及保護文檔的日期。

如果您的LiveCycle版本為8.x或更早版本，則無法執行此任務。 AEM Forms中新增了檢查受原則保護檔案的支援。如果嘗試使用LiveCycle8.x（或更早版本）檢查受策略保護的文檔，則會引發異常。

注意

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

步驟摘要

要檢查受策略保護的PDF文檔，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索要檢查的受策略保護的文檔。
獲取有關受策略保護文檔的資訊。

包含項目檔案

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

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，請建立Document Security服務客戶端對象。如果您使用Java API，請建立 RightsManagementClient 物件。如果您使用Document Security Web服務API，請建立 RightsManagementServiceService 物件。

檢索受策略保護的文檔以檢查

要檢查受策略保護的文檔，請檢索它。如果嘗試檢查未通過策略進行保護或被撤銷的文檔，則會引發異常。

Inspect檔案

檢索受策略保護的文檔後，可以檢查它。

獲取有關受策略保護文檔的資訊

檢查受策略保護的PDF文檔後，可以獲取有關該文檔的資訊。例如，您可以確定用於保護文檔的策略。

如果您使用屬於「我的策略」的策略保護文檔，然後調用 RMInspectResult.getPolicysetName 或 RMInspectResult.getPolicysetId，則會傳回null。

如果使用包含在策略集（「我的策略」除外）中的策略保護文檔，則 RMInspectResult.getPolicysetName 和 RMInspectResult.getPolicysetId 傳回有效的字串。

另請參閱

Inspect使用Java API的受策略保護的PDF文檔

Inspect是受原則保護的PDF檔案，使用檔案安全性服務API(Java):

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。如需這些檔案的位置資訊，請參閱包含AEM Forms Java程式庫檔案.
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。 (請參閱設定連接屬性.)
- 建立 RightsManagementClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索要檢查的受策略保護的文檔。
- 建立 java.io.FileInputStream 使用其建構子表示受策略保護的PDF文檔的對象。傳遞指定PDF文檔位置的字串值。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
Inspect檔案。
- 建立 DocumentManager 對象，方法是調用 RightsManagementClient 物件 getDocumentManager 方法。
- Inspect通過調用 LicenseManager 物件 inspectDocument 方法。傳遞 com.adobe.idp.Document 包含受策略保護的PDF文檔的對象。此方法會傳回 RMInspectResult 包含有關受策略保護文檔的資訊的對象。
獲取有關受策略保護文檔的資訊。

要獲取有關受策略保護文檔的資訊，請調用相應的方法 RMInspectResult 物件。例如，要檢索策略名稱，請調用 RMInspectResult 物件 getPolicyName 方法。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API檢查受策略保護的PDF文檔」

Inspect使用Web服務API的受策略保護的PDF文檔

Inspect是受政策保護的PDF檔案，使用檔案安全服務API（web服務）:

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 RightsManagementServiceClient 物件，使用其預設建構函式。
- 建立 RightsManagementServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 RightsManagementServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 RightsManagementServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索要檢查的受策略保護的文檔。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存要檢查的PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子。傳遞一個字串值，該字串值表示PDF文檔的檔案位置，以及在中開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法。傳遞位元組陣列、起始位置和資料流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
Inspect檔案。

Inspect通過調用 RightsManagementServiceClient 物件 inspectDocument 方法。傳遞 BLOB 包含受策略保護的PDF文檔的對象。此方法會傳回 RMInspectResult 包含有關受策略保護文檔的資訊的對象。
獲取有關受策略保護文檔的資訊。

要獲取有關受策略保護文檔的資訊，請獲取屬於的相應欄位的值 RMInspectResult 物件。例如，要檢索策略名稱，請獲取 RMInspectResult 物件 policyName 欄位。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API檢查受策略保護的PDF文檔」
「快速入門(SwaRef):使用Web服務API檢查受策略保護的PDF文檔」

另請參閱

建立水印

水印通過唯一地識別文檔和控製版權侵權來幫助確保文檔的安全。例如，您可以建立並放置一個水印，該水印在文檔的所有頁面上聲明「機密」。建立浮水印後，您可以將其納入策略。也就是說，可以使用新建立的水印來設定策略的水印屬性。將包含水印的策略應用到文檔後，該水印將出現在受策略保護的文檔中。

注意

只有具有Document Security管理權限的用戶才能建立水印。也就是說，在定義建立Document Security服務客戶端對象所需的連接設定時，必須指定這樣的用戶。

注意

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

步驟摘要

要建立水印，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
設定水印屬性。
向Document Security服務註冊水印。

包含項目檔案

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

建立Document Security用戶端API物件

設定水印屬性

要建立新水印，必須設定水印屬性。必須始終定義name屬性。除了name屬性之外，您至少必須設定以下屬性之一：

自訂文字
DateIncluded
UserIdIncluded
UserNameIncluded

下表列出使用網站服務建立浮水印時所需的索引鍵和值組。

金鑰名稱	說明	值
`WaterBackCmd:IS_USERNAME_ENABLED`	指定開啟文檔的用戶的用戶名是否屬於水印的一部分。	True或False
`WaterBackCmd:IS_USERID_ENABLED`	指定開啟文檔的用戶的標識是否屬於水印的一部分。	True或False
`WaterBackCmd:IS_CURRENTDATE_ENABLED`	指定當前日期是否是水印的一部分。	True或False
`WaterBackCmd:IS_CUSTOMTEXT_ENABLED`	如果此值為true，則必須使用 `WaterBackCmd:SRCTEXT`.	True或False
`WaterBackCmd:OPACITY`	指定水印的不透明度。如果未指定，則預設值為0.5。	介於0.0和1.0之間的值。
`WaterBackCmd:ROTATION`	指定水印的旋轉。預設值為0度。	介於0到359之間的值。
`WaterBackCmd:SCALE`	若已指定此值，則 `WaterBackCmd:IS_SIZE_ENABLED` 必須存在，且值必須為true。如果未指定此屬性，則預設行為適合頁面。	大於0.0且小於或等於1.0的值。
`WaterBackCmd:HORIZ_ALIGN`	指定水印的水準對齊方式。預設值為中心。	左、中或右
`WaterBackCmd:VERT_ALIGN`	指定水印的垂直對齊方式。預設值為中心。	頂部、中間或底部
`WaterBackCmd:IS_USE_BACKGROUND`	指定水印是否為背景。預設值為false。	True或False
`WaterBackCmd:IS_SIZE_ENABLED`	如果指定自訂比例，則為true。如果此值為true，則還必須指定SCALE。如果此值為false，則預設值適合頁面大小。	True或False
`WaterBackCmd:SRCTEXT`	指定浮水印的自定義文本。如果此值存在，則 `WaterBackCmd:IS_CUSTOMTEXT_ENABLED` 也必須存在且設為true。	True或False

所有水印都必須定義以下屬性之一：

WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED

所有其他屬性均為選用。

註冊水印

必須先向Document Security服務註冊新水印，才能使用。註冊水印後，可以在策略中使用它。

另請參閱

使用Java API建立水印

使用Document Security API(Java)建立浮水印：

包含專案檔案。

包括客戶端JAR檔案，如 adobe-rightsmanagement-client.jar，位於Java專案的類別路徑中。
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 RightsManagementClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
設定浮水印屬性
- 建立 Watermark 對象，方法是調用 InfomodelObjectFactory 對象的靜態 createWatermark 方法。此方法會傳回 Watermark 物件。
- 通過調用 Watermark 物件 setName 方法，並傳遞指定策略名稱的字串值。
- 調用 Watermark 物件 setBackground 方法與傳遞 true. 通過設定此屬性，水印將出現在文檔的背景中。
- 調用 Watermark 物件 setCustomText 方法，並傳遞代表浮水印文字的字串值。
- 調用 Watermark 物件 setOpacity 方法，並傳遞指定不透明度級別的整數值。值100表示水印完全不透明，值0表示水印完全透明。
註冊水印。
- 建立 WatermarkManager 對象，方法是調用 RightsManagementClient 物件 getWatermarkManager 方法。此方法會傳回 WatermarkManager 物件。
- 通過調用 WatermarkManager 物件 registerWatermark 方法和傳遞 Watermark 表示要註冊的水印的對象。此方法會傳回一個字串值，代表浮水印的識別值。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API建立浮水印"

使用Web服務API建立水印

使用Document Security API（web服務）建立浮水印：

建立Document Security用戶端API物件。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 RightsManagementServiceClient 物件，使用其預設建構函式。
- 建立 RightsManagementServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 RightsManagementServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 RightsManagementServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
設定浮水印屬性。
- 建立 WatermarkSpec 對象，方法是調用 WatermarkSpec 建構子。
- 通過為 WatermarkSpec 物件 name 資料成員。
- 設定浮水印的 id 屬性，將字串值指派給 WatermarkSpec 物件 id 資料成員。
- 對於要設定的每個水印屬性，建立一個單獨的 MyMapOf_xsd_string_To_xsd_anyType_Item 物件。
- 為 MyMapOf_xsd_string_To_xsd_anyType_Item 物件 key 資料成員(例如， WaterBackCmd:OPACITY).
- 將值指派給 MyMapOf_xsd_string_To_xsd_anyType_Item 物件 value 資料成員(例如， .25)。
- 建立 MyArrayOf_xsd_anyType 物件。針對每個 MyMapOf_xsd_string_To_xsd_anyType_Item 對象，調用 MyArrayOf_xsd_anyType 物件 Add 方法。傳遞 MyMapOf_xsd_string_To_xsd_anyType_Item 物件。
- 指派 MyArrayOf_xsd_anyType 物件 WatermarkSpec 物件 values 資料成員。
註冊水印。

通過調用 RightsManagementServiceClient 物件 registerWatermark 方法和傳遞 WatermarkSpec 表示要註冊的水印的對象。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用網站服務API建立浮水印」
「快速入門(SwaRef):使用網站服務API建立浮水印」

另請參閱

修改水印

您可以使用Document Security Java API或Web服務API修改現有水印。要對現有水印進行更改，可以檢索水印，修改其屬性，然後在伺服器上更新它。例如，假設您檢索水印並修改其不透明度屬性。在更改生效之前，必須更新水印。

當您修改水印時，此更改將影響應用了水印的將來文檔。即，包含水印的現有PDF文檔不受影響。

注意

只有具有Document Security管理權限的用戶才能修改水印。也就是說，在定義建立Document Security服務客戶端對象所需的連接設定時，必須指定這樣的用戶。

注意

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

步驟摘要

要修改水印，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索要修改的水印。
設定水印屬性。
更新浮水印。

包含項目檔案

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

建立Document Security用戶端API物件

檢索要修改的水印

要修改水印，必須檢索現有水印。可以通過指定水印的名稱或通過指定水印的標識符值來檢索水印。

設定水印屬性

要修改現有水印，請更改一個或多個水印屬性的值。當使用Web服務以寫程式方式更新水印時，必須設定最初設定的所有屬性，即使值未更改。例如，假設已設定以下水印屬性： WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY，和 WaterBackCmd:SRCTEXT. 雖然您唯一要修改的屬性是 WaterBackCmd:OPACITY，您必須將其他值設為正常。

注意

使用Java API修改浮水印時，不需要指定所有屬性。設定要修改的水印屬性。

注意

有關水印屬性名稱的資訊，請參見建立水印.

更新浮水印

修改水印的屬性後，必須更新水印。

另請參閱

建立水印

使用Java API修改水印

使用Document Security API(Java)修改浮水印：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 DocumentSecurityClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索要修改的水印。

建立 WatermarkManager 對象，方法是調用 DocumentSecurityClient 物件 getWatermarkManager 方法，並傳遞指定水印名稱的字串值。此方法會傳回 Watermark 表示要修改的水印的對象。
設定浮水印屬性。

調用 Watermark 物件 setOpacity 方法，並傳遞指定不透明度級別的整數值。值100表示水印完全不透明，值0表示水印完全透明。

注意

此示例僅修改不透明度屬性。
更新浮水印。
- 通過調用 WatermarkManager 物件 updateWatermark 方法並傳遞 Watermark 已修改其屬性的對象。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱快速入門（SOAP模式）:使用Java API部分修改水印。

使用Web服務API修改水印

使用Document Security API（web服務）修改浮水印：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 DocumentSecurityServiceClient 物件，使用其預設建構函式。
- 建立 RightsManagementServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 DocumentSecurityServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索要修改的水印。

通過調用 DocumentSecurityServiceClient 物件 getWatermarkByName 方法。傳遞指定浮水印名稱的字串值。此方法會傳回 WatermarkSpec 表示要修改的水印的對象。
設定浮水印屬性。
- 對於要更新的每個水印屬性，建立單獨的 MyMapOf_xsd_string_To_xsd_anyType_Item 物件。
- 為 MyMapOf_xsd_string_To_xsd_anyType_Item 物件 key 資料成員(例如， WaterBackCmd:OPACITY).
- 將值指派給 MyMapOf_xsd_string_To_xsd_anyType_Item 物件 value 資料成員(例如， .50)。
- 建立 MyArrayOf_xsd_anyType 物件。針對每個 MyMapOf_xsd_string_To_xsd_anyType_Item 對象，調用 MyArrayOf_xsd_anyType 物件 Add 方法。傳遞 MyMapOf_xsd_string_To_xsd_anyType_Item 物件。
- 指派 MyArrayOf_xsd_anyType 物件 WatermarkSpec 物件 values 資料成員。
更新浮水印。

通過調用 DocumentSecurityServiceClient 物件 updateWatermark 方法和傳遞 WatermarkSpec 表示要修改的水印的對象。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API修改水印"

搜尋事件

Rights Management服務會在發生特定操作時跟蹤這些操作，例如將策略應用到文檔、開啟受策略保護的文檔以及撤消對文檔的訪問。必須為Rights Management服務啟用事件審核，否則不會追蹤事件。

事件分為下列其中一類：

管理員事件是與管理員相關的操作，如建立新的管理員帳戶。
文檔事件是與文檔相關的操作，如關閉受策略保護的文檔。
策略事件是與策略相關的操作，如建立新策略。
服務事件是與Rights Management服務相關的操作，如與用戶目錄同步。

您可以使用Rights ManagementJava API或網站服務API來搜尋指定的事件。通過搜索事件，您可以執行任務，例如建立某些事件的日誌檔案。

注意

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

步驟摘要

要搜索Rights Management事件，請執行以下步驟：

包含專案檔案。
建立Rights Management用戶端API物件。
指定要搜尋的事件。
搜尋事件。

包含項目檔案

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

建立Rights Management用戶端API物件

在以寫程式方式執行Rights Management服務操作之前，必須建立Rights Management服務客戶端對象。如果您使用Java API，請建立 DocumentSecurityClient 物件。如果您使用Rights Management網站服務API，請建立 DocumentSecurityServiceService 物件。

指定要搜尋的事件

必須指定要搜索的事件。例如，可以搜索策略建立事件，該事件在建立新策略時發生。

搜尋事件

指定要搜尋的事件後，您可以使用Rights ManagementJava API或Rights Management網站服務API來搜尋事件。

另請參閱

使用Java API搜尋事件

使用Rights ManagementAPI(Java)搜尋事件：

包含項目檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Rights Management用戶端API物件

建立 DocumentSecurityClient 對象，使用其建構子並傳遞 ServiceClientFactory 包含連接屬性的對象。
指定要搜尋的事件
- 建立 EventManager 對象，方法是調用 DocumentSecurityClient 物件 getEventManager 方法。此方法會傳回 EventManager 物件。
- 建立 EventSearchFilter 對象，方法是調用其建構子。
- 叫用 EventSearchFilter 物件 setEventCode 傳遞屬於靜態資料成員的方法 EventManager 代表要搜尋的事件的類別。例如，要搜索策略建立事件，請傳遞 EventManager.POLICY_CREATE_EVENT.
注意

您可以叫用 EventSearchFilter 物件方法。例如，叫用 setUserName 方法來指定與事件相關聯的使用者。
搜尋事件

叫用 EventManager 物件 searchForEvents 方法和傳遞 EventSearchFilter 定義事件搜尋准則的物件。此方法會傳回陣列 Event 對象。

程式碼範例

如需使用Rights Management服務的程式碼範例，請參閱下列快速入門：

"快速入門(SOAP):使用Java API搜尋事件」

使用網站服務API搜尋事件

使用Rights ManagementAPI（網站服務）搜尋事件：

包含項目檔案

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Rights Management用戶端API物件
- 建立 DocumentSecurityServiceClient 物件，使用其預設建構函式。
- 建立 DocumentSecurityServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 DocumentSecurityServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

指定要搜尋的事件

建立 EventSpec 物件，使用其建構子。
透過設定 EventSpec 物件 firstTime.date 資料成員 DataTime 代表事件發生日期範圍開始的例項。
指派值 true 到 EventSpec 物件 firstTime.dateSpecified 資料成員。
透過設定 EventSpec 物件 lastTime.date 資料成員 DataTime 代表事件發生日期範圍結尾的例項。
指派值 true 到 EventSpec 物件 lastTime.dateSpecified 資料成員。
將字串值指派給 EventSpec 物件 eventCode 資料成員。下表列出您可指派給此屬性的數值：

事件類型	值
`ALL_EVENTS`	999
`USER_CHANGE_PASSWORD_EVENT`	1000
`USER_REGISTER_EVENT`	1001
`USER_PREREGISTER_EVENT`	1002
`USER_ACTIVATE_EVENT`	1003
`USER_DEACTIVATE_EVENT`	1004
`USER_AUTHENTICATE_EVENT`	1005
`USER_AUTHENTICATE_DENY_EVENT`	1006
`USER_ACCOUNT_LOCK_EVENT`	1007
`USER_DELETE_EVENT`	1008
`USER_UPDATE_PROFILE_EVENT`	1009
`DOCUMENT_VIEW_EVENT`	2000
`DOCUMENT_PRINT_LOW_EVENT`	2001
`DOCUMENT_PRINT_HIGH_EVENT`	2002
`DOCUMENT_SIGN_EVENT`	2003
`DOCUMENT_ADD_ANNOTATION_EVENT`	2004
`DOCUMENT_FORM_FILL_EVENT`	2005
`DOCUMENT_CLOSE_EVENT`	2006
`DOCUMENT_MODIFY_EVENT`	2007
`DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT`	2008
`DOCUMENT_SWITCH_POLICY_EVENT`	2009
`DOCUMENT_REVOKE_EVENT`	2010
`$1`	2011
`DOCUMENT_SECURE_EVENT`	2012
`DOCUMENT_UNKNOWN_CLIENT_EVENT`	2013
`DOCUMENT_CHANGE_REVOKE_URL_EVENT`	2014
`POLICY_CHANGE_EVENT`	3000
`POLICY_ENABLE_EVENT`	3001
`POLICY_DISABLE_EVENT`	3002
`POLICY_CREATE_EVENT`	3003
`POLICY_DELETE_EVENT`	3004
`POLICY_CHANGE_OWNER_EVENT`	3005
`SERVER_CLIENT_SYNC_EVENT`	4000
`SERVER_SYNC_DIR_INFO_EVENT`	4001
`SERVER_SYNC_DIR_COMPLETE_EVENT`	4002
`SERVER_VERSION_MISMATCH_EVENT`	4003
`SERVER_CONFIG_CHANGE_EVENT`	4004
`SERVER_ENABLE_OFFLINE_ACCESS_EVENT`	4005
`ADMIN_ADD_EVENT`	5000
`ADMIN_DELETE_EVENT`	5001
`ADMIN_EDIT_EVENT`	5002
`ADMIN_ACTIVATE_EVENT`	5003
`ADMIN_DEACTIVATE_EVENT`	5004
`ERROR_DIRECTORY_SERVICE_EVENT`	6000
`CREATED_POLICYSET_EVENT`	7000
`DELETED_POLICYSET_EVENT`	7001
`MODIFIED_POLICYSET_EVENT`	7002

搜尋事件

叫用 DocumentSecurityServiceClient 物件 searchForEvents 方法和傳遞 EventSpec 代表要搜尋的事件和結果數上限的物件。此方法會傳回 MyArrayOf_xsd_anyType 其中每個元素都是 AuditSpec 例項。使用 AuditSpec 例項，您可以取得事件的相關資訊，例如發生的時間。此 AuditSpec 例項包含 timestamp 指定此資訊的資料成員。

程式碼範例

如需使用Rights Management服務的程式碼範例，請參閱下列快速入門：

「快速入門(MTOM):使用Web服務API搜索事件」
「快速入門(SwaRef):使用Web服務API搜索事件」

另請參閱

對Word文檔應用策略

除PDF文檔外，權限管理服務還支援其他文檔格式，如Microsoft Word文檔（DOC檔案）和其他Micosoft Office檔案格式。例如，您可以將策略應用於Word文檔以保護它。通過將策略應用於Word文檔，可以限制對文檔的訪問。如果文檔已使用策略進行了保護，則無法將策略應用到文檔。

在分發受策略保護的Word文檔後，可以監視其使用情況。也就是說，您可以看到檔案的使用方式，以及使用者。例如，您可以找出有人何時開啟檔案。

注意

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

步驟摘要

要將策略應用於Word文檔，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索應用策略的Word文檔。
將現有策略應用於Word文檔。
保存受策略保護的Word文檔。

包含項目檔案

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

建立Document Security Client API對象

在以寫程式方式執行Document Security服務操作之前，必須建立Document Security服務客戶端對象。

檢索Word文檔

必須檢索Word文檔才能應用策略。將策略應用到Word文檔後，在使用該文檔時，用戶將受到限制。例如，如果策略不允許離線時開啟文檔，則用戶必須聯機才能開啟文檔。

將現有策略應用於Word文檔

要將策略應用於Word文檔，必須引用現有策略並指定該策略所屬的策略集。設定連接屬性的用戶必須具有對指定策略的訪問權限。否則會發生例外。

保存Word文檔

在Document Security服務將策略應用於Word文檔後，可以將受策略保護的Word文檔另存為DOC檔案。

另請參閱

撤消對文檔的訪問

使用Java API將策略應用到Word文檔

使用Document Security API(Java)將策略應用到Word文檔：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 DocumentSecurityClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索Word文檔。
- 建立 java.io.FileInputStream 使用其建構子並傳遞指定Word文檔位置的字串值來表示Word文檔的對象。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
將現有策略應用於Word文檔。
- 建立 DocumentManager 對象，方法是調用 DocumentSecurityClient 物件 getDocumentManager 方法。
- 通過調用 DocumentManager 物件 protectDocument 方法並傳遞下列值：
  - 此 com.adobe.idp.Document 包含策略應用到的Word文檔的對象。
  - 指定文檔名稱的字串值。
  - 一個字串值，它指定策略所屬的策略集的名稱。您可以指定 null 產生 MyPolicies 正在使用的策略集。
  - 指定策略名稱的字串值。
  - 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為可選值，可為null（如果此參數為null，則下一個參數值必須為null）。
  - 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為選用值，可以是 null (如果此參數為 null，則上一個參數值必須是 null)。
  - A com.adobe.livecycle.rightsmanagement.Locale 表示用於選擇MS Office模板的區域設定。此參數值為選用值，您可以指定 null.
  此 protectDocument 方法傳回 RMSecureDocumentResult 包含受策略保護的Word文檔的對象。
保存Word文檔。
- 叫用 RMSecureDocumentResult 物件 getProtectedDoc 獲取受策略保護的Word文檔的方法。此方法會傳回 com.adobe.idp.Document 物件。
- 建立 java.io.File 對象，並確保檔案副檔名為DOC。
- 叫用 com.adobe.idp.Document 物件 copyToFile 複製內容的方法 Document 物件(請確定您使用 Document 由傳回的物件 getProtectedDoc 方法)。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API將策略應用到Word文檔」

使用Web服務API將策略應用到Word文檔

使用Document Security API（web服務）將策略應用到Word文檔：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 建立 DocumentSecurityServiceClient 物件，使用其預設建構函式。
- 建立 DocumentSecurityServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 DocumentSecurityServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索Word文檔。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存應用策略的Word文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示Word文檔的檔案位置以及開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。透過取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法。傳遞位元組陣列、起始位置和資料流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
將現有策略應用於Word文檔。

通過調用 DocumentSecurityServiceClient 物件 protectDocument 方法並傳遞下列值：
- 此 BLOB 包含策略應用到的Word文檔的對象。
- 指定文檔名稱的字串值。
- 一個字串值，它指定策略所屬的策略集的名稱。您可以指定 null 產生 MyPolicies 正在使用的策略集。
- 指定策略名稱的字串值。
- 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為選用值，且可為null(如果此參數為null，則下一個參數值必須為 null)。
- 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為選用值，且可為null(如果此參數為null，則上一個參數值必須為 null)。
- A RMLocale 指定地區設定值的值(例如 RMLocale.en)。
- 用於儲存策略標識符值的字串輸出參數。
- 用於儲存受策略保護的標識符值的字串輸出參數。
- 用於儲存mime類型的字串輸出參數(例如， application/doc)。
此 protectDocument 方法傳回 BLOB 包含受策略保護的Word文檔的對象。
保存Word文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示受策略保護的Word文檔的檔案位置。
- 建立位元組陣列，用於儲存 BLOB 由傳回的物件 protectDocument 方法。取得 BLOB 物件 MTOM 資料成員。
- 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
- 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API將策略應用到Word文檔「

從Word文檔中刪除策略

可以從受策略保護的Word文檔中刪除策略，以便從文檔中刪除安全性。也就是說，如果您不再希望該文檔受策略保護。如果要使用較新的策略更新受策略保護的Word文檔，則切換該策略比刪除該策略和添加更新的策略更有效。

注意

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

步驟摘要

要從受策略保護的Word文檔中刪除策略，請執行以下步驟：

包含項目檔案
建立Document Security用戶端API物件。
檢索受策略保護的Word文檔。
從Word文檔中刪除策略。
保存不安全的Word文檔。

包含項目檔案

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

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，請建立Document Security服務客戶端對象。

檢索受策略保護的Word文檔

必須檢索受策略保護的Word文檔才能刪除策略。如果嘗試從未受策略保護的Word文檔中刪除策略，將導致異常。

從Word文檔中刪除策略

如果在連接設定中指定了管理員，則可以從受策略保護的Word文檔中刪除策略。否則，用於保護文檔的策略必須包含 SWITCH_POLICY 從Word文檔中刪除策略的權限。此外，在AEM Forms連線設定中指定的使用者也必須擁有該權限。否則，會擲回例外。

保存不安全的Word文檔

在Document Security服務從Word文檔中刪除策略後，可以將不安全的Word文檔另存為DOC檔案。

另請參閱

對Word文檔應用策略

使用Java API從Word文檔中刪除策略

使用Document Security API(Java)從受策略保護的Word文檔中刪除策略：

包含項目檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 RightsManagementClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
檢索受策略保護的Word文檔
- 建立 java.io.FileInputStream 表示受策略保護的Word文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定Word文檔的位置。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
從Word文檔中刪除策略
- 建立 DocumentManager 對象，方法是調用 RightsManagementClient 物件 getDocumentManager 方法。
- 通過調用 DocumentManager 物件 removeSecurity 方法和傳遞 com.adobe.idp.Document 包含受策略保護的Word文檔的對象。此方法會傳回 com.adobe.idp.Document 包含不安全Word文檔的對象。
保存不安全的Word文檔
- 建立 java.io.File 對象，並確保檔案副檔名為DOC。
- 叫用 Document 物件 copyToFile 複製內容的方法 Document 物件(請確定您使用 Document 由傳回的物件 removeSecurity 方法)。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API從Word文檔中刪除策略「

使用Web服務API從Word文檔中刪除策略

使用Document Security API（Web服務）從受策略保護的Word文檔中刪除策略：

包含項目檔案

建立使用MTOM的Microsoft .NET專案。確保使用以下WSDL定義： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件
- 建立 RightsManagementServiceClient 物件，使用其預設建構函式。
- 建立 RightsManagementServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL.) 您不需要使用 lc_version 屬性。建立服務參考時會使用此屬性。)
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 RightsManagementServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 RightsManagementServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
- 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
檢索受策略保護的Word文檔
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存從中刪除策略的受策略保護的Word文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示Word文檔的檔案位置以及開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
從Word文檔中刪除策略

調用 RightsManagementServiceClient 物件 removePolicySecurity 方法和傳遞 BLOB 包含受策略保護的Word文檔的對象。此方法會傳回 BLOB 包含不安全Word文檔的對象。
保存不安全的Word文檔
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示不安全Word文檔的檔案位置。
- 建立位元組陣列，用於儲存 BLOB 由傳回的物件 removePolicySecurity 方法。取得 BLOB 物件 MTOM 欄位。
- 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API從Word文檔中刪除策略」

另請參閱