使用策略保護文檔 protecting-documents-with-policies

包含專案檔案。

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

建立Document Security用戶端API物件。

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

設定策略的屬性。

• 建立 Policy 對象，方法是調用 InfomodelObjectFactory 對象的靜態 createPolicy 方法。 此方法會傳回 Policy 物件。
• 調用 Policy 物件 setName 方法，並傳遞指定策略名稱的字串值。
• 調用 Policy 物件 setDescription 方法，並傳遞指定策略說明的字串值。
• 通過調用 Policy 物件 setPolicySetName 方法，並傳遞指定策略集名稱的字串值。 (您可以指定 null ，而此參數值會導致將原則新增至 我的政策 策略集。)
• 調用 InfomodelObjectFactory 對象的靜態 createValidityPeriod 方法。 此方法會傳回 ValidityPeriod 物件。
• 通過調用 ValidityPeriod 物件 setRelativeExpirationDays 方法，並傳遞指定天數的整數值。
• 調用 Policy 物件 setValidityPeriod 方法和傳遞 ValidityPeriod 物件。

建立策略項。

• 通過調用 InfomodelObjectFactory 對象的靜態 createPolicyEntry 方法。 此方法會傳回 PolicyEntry 物件。
• 叫用 InfomodelObjectFactory 對象的靜態 createPermission 方法。 傳遞屬於的靜態資料成員 Permission 代表權限的介面。 此方法會傳回 Permission 物件。 例如，要添加允許用戶從受策略保護的PDF文檔中複製資料的權限，請傳遞 Permission.COPY. （對要新增的每個權限重複此步驟）。
• 調用 PolicyEntry 物件 addPermission 方法和傳遞 Permission 物件。 (對每個 Permission 物件)。
• 通過調用 InfomodelObjectFactory 對象的靜態 createSpecialPrincipal 方法。 傳遞屬於 InfomodelObjectFactory 表示主體的對象。 此方法會傳回 Principal 物件。 例如，要將文檔的發佈者添加為主體，請傳遞 InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
• 調用 PolicyEntry 物件 setPrincipal方法和傳遞 Principal 物件。
• 調用 Policy 物件 addPolicyEntry 方法和傳遞 PolicyEntry 物件。

註冊策略。

• 建立 PolicyManager 對象，方法是調用 DocumentSecurityClient 物件 getPolicyManager 方法。

• 通過調用 PolicyManager 物件 registerPolicy 方法並傳遞下列值：

  • 此 Policy 表示要註冊的策略的對象。

• 表示策略所屬策略集的字串值。

如果您在連線設定中使用AEM Forms管理員帳戶來建立 DocumentSecurityClient 對象，然後在調用策略集時指定策略集名稱 registerPolicy 方法。 如果您傳入 null 策略集的值，策略將在管理員中建立 我的政策 策略集。

如果在連接設定中使用Document Security用戶，則可以調用超載 registerPolicy 僅接受策略的方法。 也就是說，您不需要指定策略集名稱。 但是，策略將添加到名為 我的政策. 如果不想將新策略添加到此策略集，請在調用 registerPolicy 方法。

包含專案檔案。

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

建立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 物件，方法是取得 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.

設定策略的屬性。

• 建立 PolicySpec 物件，使用其建構子。
• 為 PolicySpec 物件 name 資料成員。
• 為 PolicySpec 物件 description 資料成員。
• 將字串值分配給 PolicySpec 物件 policySetName 資料成員。 必須指定現有策略集名稱。 (您可以指定 null ，而此參數值會導致將原則新增至 我的政策.)
• 通過為 PolicySpec 物件 offlineLeasePeriod 資料成員。
• 設定 PolicySpec 物件 policyXml 資料成員，其字串值表示PDRL XML資料。 要執行此任務，請建立.NET StreamReader 物件，使用其建構子。 將表示策略的PDRL XML檔案的位置傳遞到 StreamReader 建構子。 接下來，叫用 StreamReader 物件 ReadLine 方法，並將傳回值指派給字串變數。 重複 StreamReader 物件，直到 ReadLine 方法傳回null。 將字串變數指派給 PolicySpec 物件 policyXml 資料成員。

建立策略項。

使用Document Security Web服務API建立策略時，不需要建立策略項。 策略項在PDRL文檔中定義。

註冊策略。

通過調用 DocumentSecurityServiceClient 物件 registerPolicy 方法並傳遞下列值：

• 此 PolicySpec 表示要註冊的策略的對象。
• 表示策略所屬策略集的字串值。 您可以指定 null 會導致將原則新增至 MyPolices 策略集。

如果您在連線設定中使用AEM Forms管理員帳戶來建立 DocumentSecurityClient 對象，請在調用策略集時指定策略集名稱 registerPolicy 方法。

如果在連接設定中使用Document SecurityDocument Security用戶，則可以調用超載 registerPolicy 僅接受策略的方法。 也就是說，您不需要指定策略集名稱。 但是，策略將添加到名為 我的政策. 如果不想將新策略添加到此策略集，請在調用 registerPolicy 方法。

包含專案檔案。

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

建立Document Security用戶端API物件。

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

檢索現有策略。

• 建立 PolicyManager 對象，方法是調用 RightsManagementClient 物件 getPolicyManager 方法。

• 建立 Policy 表示要通過調用 PolicyManager 物件 getPolicy 方法並傳遞下列值」

  • 表示策略所屬的策略集名稱的字串值。 您可以指定 null 會導致 MyPolicies 正在使用的策略集。
  • 表示策略名稱的字串值。

設定策略的屬性。

更改策略的屬性以滿足您的業務需求。 例如，要更改策略的離線租用期，請調用 Policy 物件 setOfflineLeasePeriod 方法。

更新策略。

調用以更新策略 PolicyManager 物件 updatePolicy 方法。 傳遞 Policy 表示要更新的策略的對象。

包含專案檔案。

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

建立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.

檢索現有策略。

建立 PolicySpec 表示要通過調用 RightsManagementServiceClient 物件 getPolicy 方法並傳遞下列值：

• 一個字串值，它指定策略所屬的策略集名稱。 您可以指定 null 會導致 MyPolicies 正在使用的策略集。
• 指定策略名稱的字串值。

設定策略的屬性。

更改策略的屬性以滿足您的業務需求。

更新策略。

叫用 RightsManagementServiceClient 物件 updatePolicyFromSDK 方法和傳遞 PolicySpec 表示要更新的策略的對象。

包含專案檔案。

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

建立Document Security用戶端API物件。

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

刪除策略。

• 建立 PolicyManager 對象，方法是調用 RightsManagementClient 物件 getPolicyManager 方法。

• 叫用 PolicyManager 物件 deletePolicy 方法並傳遞下列值：

  • 一個字串值，它指定策略所屬的策略集名稱。 您可以指定 null 會導致 MyPolicies 正在使用的策略集。
  • 一個字串值，它指定要刪除的策略的名稱。

包含專案檔案。

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

建立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.

刪除策略。

叫用 RightsManagementServiceClient 物件 deletePolicy 方法並傳遞下列值：

• 一個字串值，它指定策略所屬的策略集名稱。 您可以指定 null 會導致 MyPolicies 正在使用的策略集。
• 一個字串值，它指定要刪除的策略的名稱。

包含專案檔案。

在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 方法)。

包含專案檔案。

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

建立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 方法，並傳遞位元組陣列。

包含專案檔案。

在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 方法)。

包含專案檔案。

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

建立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 物件。

包含項目檔案

在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.

包含項目檔案

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

建立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.

包含專案檔案。

在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 方法，並傳遞已撤銷檔案的授權識別碼值。

包含專案檔案。

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

建立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 方法)。

包含專案檔案。

在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 方法。

包含專案檔案。

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

建立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 欄位。

包含專案檔案。

包括客戶端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用戶端API物件。

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

建立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 表示要註冊的水印的對象。

包含專案檔案。

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

建立Document Security用戶端API物件。

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

檢索要修改的水印。

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

設定浮水印屬性。

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

更新浮水印。

• 通過調用 WatermarkManager 物件 updateWatermark 方法並傳遞 Watermark 已修改其屬性的對象。

包含專案檔案。

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

建立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 表示要修改的水印的對象。

包含項目檔案

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

建立Rights Management用戶端API物件

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

指定要搜尋的事件

• 建立 EventManager 對象，方法是調用 DocumentSecurityClient 物件 getEventManager 方法。 此方法會傳回 EventManager 物件。
• 建立 EventSearchFilter 對象，方法是調用其建構子。
• 叫用 EventSearchFilter 物件 setEventCode 傳遞屬於靜態資料成員的方法 EventManager 代表要搜尋的事件的類別。 例如，要搜索策略建立事件，請傳遞 EventManager.POLICY_CREATE_EVENT.

搜尋事件

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

包含項目檔案

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

建立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 資料成員。 下表列出您可指派給此屬性的數值：

搜尋事件

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

包含專案檔案。

在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 方法)。

包含專案檔案。

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

建立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 方法，並傳遞位元組陣列。

包含項目檔案

在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 方法)。

包含項目檔案

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

建立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 物件。