ポリシーを使用したドキュメントの保護 protecting-documents-with-policies

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して ServiceClientFactory オブジェクトを渡すことによって、DocumentSecurityClient オブジェクトを作成します。

ポリシーの属性を設定します。

• InfomodelObjectFactory オブジェクトの静的 createPolicy メソッドを呼び出して Policy オブジェクトを作成します。このメソッドは、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 オブジェクトを渡して、ポリシーエントリをポリシーに追加します。

ポリシーを登録します。

• DocumentSecurityClient オブジェクトの getPolicyManager メソッドを呼び出して、PolicyManager オブジェクトを作成します。

• 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 Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して DocumentSecurityServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して DocumentSecurityServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を RightsManagementServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をBasicHttpBindingSecurity.Security.Mode フィールドに割り当てます。

ポリシーの属性を設定します。

• コンストラクターを使用して PolicySpec オブジェクトを作成します。
• PolicySpec オブジェクトの name データメンバーに文字列値を割り当てて、ポリシーの名前を設定します。
• PolicySpec オブジェクトの description データメンバーに文字列値を割り当てて、ポリシーの説明を設定します。
• PolicySpec オブジェクトの policySetName データメンバーに文字列値を割り当てて、ポリシーが属するポリシーセットを指定します。既存のポリシーセット名を指定します（このパラメーター値に null を指定すると、このポリシーは​ マイポリシー ​に追加されます。）
• PolicySpec オブジェクトの offlineLeasePeriod データメンバーに整数値を割り当てて、ポリシーのオフラインリース期間を設定します。
• PDRL XML データを表す文字列値を使用して PolicySpec オブジェクトの policyXml データメンバーを設定します。このタスクを実行するには、コンストラクターを使用して .NET StreamReader オブジェクトを作成します。ポリシーを表す PDRL XML ファイルの場所を StreamReader コンストラクターに渡します。次に、StreamReader オブジェクトの ReadLine メソッドを呼び出し、戻り値を文字列変数に割り当てます。ReadLine メソッドが null を返すまで StreamReader オブジェクトを反復します。文字列変数を PolicySpec オブジェクトの policyXml データメンバーに割り当てます。

ポリシーエントリを作成します。

Document Security web サービス API を使用してポリシーを作成する場合は、ポリシーエントリを作成する必要はありません。ポリシーエントリは、PDRL ドキュメントで定義されます。

ポリシーを登録します。

DocumentSecurityServiceClient オブジェクトの registerPolicy メソッドを呼び出して、次の値を渡すことにより、ポリシーを登録します。

• 登録するポリシーを表す PolicySpec オブジェクト。
• ポリシーが属するポリシーセットを表す文字列値。null 値を指定すると、このポリシーは​ マイポリシー に追加されることになります。

接続設定で AEM Forms 管理者アカウントを使用して DocumentSecurityClient オブジェクトを作成する場合は、registerPolicy メソッドを呼び出す際にポリシーセット名を指定します。

接続設定内で Document Security ユーザーを使用する場合は、ポリシーのみを受け入れる過負荷の registerPolicy メソッドを呼び出すことができます。つまり、ポリシーセット名を指定する必要はありません。ただし、ポリシーは​ マイポリシー ​という名前のポリシーセットに追加されます。このポリシーセットに新しいポリシーを追加しない場合は、registerPolicy メソッドを呼び出す際にポリシーセット名を指定します。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

既存のポリシーを取得します。

• RightsManagementClient オブジェクトの getPolicyManager メソッドを呼び出して、PolicyManager オブジェクトを作成します。

• 更新するポリシーを表す 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 Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して RightsManagementServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を RightsManagementServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

既存のポリシーを取得します。

RightsManagementServiceClient オブジェクトの getPolicy メソッドを呼び出し、次の値を渡すことにより、変更するポリシーを表す PolicySpec オブジェクトを作成します。

• ポリシーが属するポリシーセット名を指定する文字列値。null を指定すると、MyPolicies ポリシーセットが使用されます。
• ポリシーの名前を指定する文字列値。

ポリシーの属性を設定します。

ビジネス要件に合わせてポリシーの属性を変更します。

ポリシーを更新します。

RightsManagementServiceClient オブジェクトの updatePolicyFromSDK メソッドを呼び出し、更新するポリシーを表す PolicySpec オブジェクトを渡すことにより、ポリシーを更新します。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

ポリシーを削除します。

• RightsManagementClient オブジェクトの getPolicyManager メソッドを呼び出して、PolicyManager オブジェクトを作成します。

• PolicyManager オブジェクトの deletePolicy メソッドを呼び出し、次の値を渡すことにより、ポリシーを削除します。

  • ポリシーが属するポリシーセット名を指定する文字列値。null を指定すると、MyPolicies ポリシーセットが使用されます。
  • 削除するポリシーの名前を指定する文字列値。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して RightsManagementServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を RightsManagementServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

ポリシーを削除します。

RightsManagementServiceClient オブジェクトの deletePolicy メソッドを呼び出し次の値を渡すことにより、ポリシーを削除します。

• ポリシーが属するポリシーセット名を指定する文字列値。null を指定すると、MyPolicies ポリシーセットが使用されます。
• 削除するポリシーの名前を指定する文字列値。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

PDF ドキュメントを取得します。

• コンストラクターを使用して PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

PDF ドキュメントに既存のポリシーを適用します。

• RightsManagementClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。

• DocumentManager オブジェクトの protectDocument メソッドを呼び出し、次の値を渡すことによって、PDF ドキュメントにポリシーを適用します。

  • このポリシーが適用される PDF ドキュメントが格納される com.adobe.idp.Document オブジェクト。
  • ドキュメントの名前を指定する文字列値。
  • ポリシーが属しているポリシーセットの名前を表す文字列値。null 値を使用すると、現在使用中の MyPolicies ポリシーセットが指定されます。
  • ポリシー名を指定する文字列値。
  • ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表す文字列値。このパラメーターの値はオプションであり、null にすることができます（このパラメーターが null の場合、次のパラメーターの値も null にする必要があります）。
  • ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表す文字列値。このパラメーター値はオプションで、null にできます（このパラメーターを null にする場合、前のパラメーター値は null である必要があります）。
  • MS Office テンプレートの選択に使用されるロケールを表す com.adobe.livecycle.rightsmanagement.Locale です。このパラメーター値はオプションで、PDF ドキュメントには使用されません。 PDF ドキュメントを保護するには、null を指定します。

  protectDocument メソッドは、ポリシーで保護された PDF ドキュメントが格納される RMSecureDocumentResult オブジェクト。

PDF ドキュメントを保存します。

• RMSecureDocumentResult オブジェクトの getProtectedDoc メソッドを呼び出して、ポリシーで保護された PDF ドキュメントを取得します。このメソッドは com.adobe.idp.Document オブジェクトを返します。
• java.io.File オブジェクトを作成し、ファイル拡張子が PDF であることを確認します。
• com.adobe.idp.Document オブジェクトの copyToFile メソッドを呼び出して、Document オブジェクトの内容をファイルにコピーします（getProtectedDoc メソッドが返した Document オブジェクトを使用してください）。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して RightsManagementServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を Forms サービスに渡します（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を RightsManagementServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

PDF ドキュメントを取得します。

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、ポリシーが適用される PDF ドキュメントを格納するために使用されます。
• コンストラクターを呼び出し、PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡して、System.IO.FileStream オブジェクトを作成します。
• System.IO.FileStream オブジェクトのコンテンツを保存するバイト配列を作成します。 System.IO.FileStream オブジェクトの Length プロパティを取得して、バイト配列のサイズを決定します。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。
• MTOM フィールドを割り当てて、BLOB オブジェクトにバイト配列の内容を入力します。

PDF ドキュメントに既存のポリシーを適用します。

RightsManagementServiceClient オブジェクトの protectDocument メソッドを呼び出して、次の値を渡すことにより、PDF ドキュメントにポリシーを適用します。

• このポリシーが適用される PDF ドキュメントが格納される BLOB オブジェクト。
• ドキュメントの名前を指定する文字列値。
• ポリシーが属しているポリシーセットの名前を表す文字列値。null 値を使用すると、現在使用中の MyPolicies ポリシーセットが指定されます。
• ポリシー名を指定する文字列値。
• ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表す文字列値。このパラメーター値はオプションであり、null にすることができます（このパラメーターが null の場合、次のパラメーター値は null でなければなりません）。
• ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表す文字列値。このパラメーター値はオプションであり、null にすることができます（このパラメーターが null の場合、前のパラメーター値は null でなければなりません）。
• ロケール値を指定する RMLocale 値（例えば RMLocale.en）。
• ポリシー識別子の値を格納するために使用される文字列出力パラメーター。
• ポリシーで保護された識別子の値を保存するために使用される文字列出力パラメーター。
• MIME タイプを保存するために使用される文字列出力パラメーター（例： application/pdf）。

protectDocument メソッドは、 ポリシーで保護された PDF ドキュメントを含む BLOB オブジェクトを返します。

PDF ドキュメントを保存します。

• コンストラクターを呼び出し、ポリシーで保護された PDF ドキュメントのファイルの場所を表す文字列値を渡すことで System.IO.FileStream オブジェクトを作成します。
• protectDocument メソッドで返された BLOB オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

ポリシーで保護された PDF ドキュメントを取得します。

• コンストラクターを使用し、PDF ドキュメントの場所を指定する文字列値を渡して、ポリシーで保護された PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

PDF ドキュメントからポリシーを削除します。

• DocumentSecurityClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。
• DocumentManager オブジェクトの removeSecurity メソッドを呼び出し、ポリシーで保護された PDF ドキュメントが格納された com.adobe.idp.Document オブジェクトを渡すことにより、PDF ドキュメントからポリシーを削除します。このメソッドは、保護されていない PDF ドキュメントが格納された com.adobe.idp.Document オブジェクトを返します。

保護されていない PDF ドキュメントを保存します。

• java.io.File オブジェクトを作成し、ファイル拡張子が PDF であることを確認します。
• Document オブジェクトの copyToFile メソッドを呼び出して、Document オブジェクトの内容をファイルにコピーします（removeSecurity メソッドが返した Document オブジェクトを使用してください）。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して DocumentSecurityServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して DocumentSecurityServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• DocumentSecurityServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DocumentSecurityServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DocumentSecurityServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

ポリシーで保護された PDF ドキュメントを取得します。

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、ポリシーの削除対象となる、ポリシーで保護された PDF ドキュメントを格納するために使用されます。
• コンストラクターを呼び出し、PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡して、System.IO.FileStream オブジェクトを作成します。
• System.IO.FileStream オブジェクトのコンテンツを保存するバイト配列を作成します。 バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。
• MTOM フィールドを割り当てて、BLOB オブジェクトにバイト配列の内容を入力します。

PDF ドキュメントからポリシーを削除します。

PDF ドキュメントからポリシーを削除するには、DocumentSecurityServiceClient オブジェクトの removePolicySecurity メソッドを呼び出し、ポリシーで保護された PDF ドキュメントを含む BLOB オブジェクトを渡します。このメソッドは、保護されていない PDF ドキュメントが格納された BLOB オブジェクトを返します。

保護されていない PDF ドキュメントを保存します。

• System.IO.FileStream オブジェクトを作成するには、そのコンストラクターを呼び出し、保護されていない PDF ドキュメントのファイルの場所を表す文字列の値を渡します。
• removePolicySecurity メソッドによって返された BLOB オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM フィールドの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。

プロジェクトファイルを含める

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトの作成

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

ポリシーで保護された PDF ドキュメントの取得

• コンストラクターを使用して、PDF ドキュメントの場所を指定する文字列値を渡すことで、ポリシーで保護された PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

ポリシーで保護されたドキュメントの取り消し

• DocumentSecurityClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。

• DocumentManager オブジェクトの getLicenseId メソッドを呼び出して、ポリシーで保護されたドキュメントのライセンス識別子の値を取得します。ポリシーで保護されたドキュメントを表す com.adobe.idp.Document オブジェクトを渡します。このメソッドは、ライセンス識別子の値を表す文字列値を返します。

• DocumentSecurityClient オブジェクトの getLicenseManager メソッドを呼び出して、LicenseManager オブジェクトを作成します。

• LicenseManager オブジェクトの revokeLicense メソッドを呼び出し、次の値を渡すことによって、ポリシーで保護されたドキュメントを失効させます。

  • ポリシーで保護されたドキュメントのライセンス識別子の値を指定する文字列値（DocumentManager オブジェクトの getLicenseId メソッドの戻り値を指定します）。
  • ドキュメントを取り消す理由を指定する License インターフェイスの静的データメンバーです。例えば、License.DOCUMENT_REVISED を指定できます。
  • 改訂済みドキュメントの場所を指定する java.net.URL 値です。 ユーザーを別の URL にリダイレクトしないようにする場合は、null を渡します。

プロジェクトファイルを含める

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトの作成

• デフォルトのコンストラクターを使用して DocumentSecurityServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して DocumentSecurityServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• DocumentSecurityServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DocumentSecurityServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DocumentSecurityServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

ポリシーで保護された PDF ドキュメントの取得

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、失効したポリシーで保護された PDF ドキュメントを格納するために使用されます。
• コンストラクターを呼び出し、失効させるポリシーで保護された PDF ドキュメントのファイルの場所と、ファイルを開くモードを表す文字列値を渡すことにより、System.IO.FileStream オブジェクトを作成します。
• System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。
• MTOM フィールドを割り当てて、BLOB オブジェクトにバイト配列の内容を入力します。

ポリシーで保護されたドキュメントを失効させる

• DocumentSecurityServiceClient オブジェクトの getLicenseID メソッドを呼び出して、ポリシーで保護されたドキュメントを表す BLOB オブジェクトを渡して、ポリシーで保護されたドキュメントのライセンス識別子の値を取得します。このメソッドは、ライセンス識別子を表す文字列値を返します。

• DocumentSecurityServiceClient オブジェクトの revokeLicense メソッドを呼び出して、次の値を渡すことにより、ポリシーで保護されたドキュメントを失効させます。

  • ポリシーで保護されたドキュメントのライセンス識別子の値を指定する文字列値（DocumentSecurityServiceService オブジェクトの getLicenseId メソッドの戻り値を指定します）。
  • ドキュメントを失効させる理由を指定する Reason enum の静的データメンバー。例えば、Reason.DOCUMENT_REVISED を指定できます。
  • 改訂されたドキュメントの URL の場所を指定する string 値。ユーザーを別の URL にリダイレクトしたくない場合、null を渡すことができます。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

失効した PDF ドキュメントのライセンス識別子を取得します。

• コンストラクターを使用し、PDF ドキュメントの場所を指定する文字列値を渡すことによって、失効した PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
• DocumentSecurityClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。
• DocumentManager オブジェクトの getLicenseId メソッドを呼び出し、失効したドキュメントを表す com.adobe.idp.Document オブジェクトを渡すことによって、失効したドキュメントのライセンス識別子の値を取得します。このメソッドは、ライセンス識別子を表す文字列値を返します。

失効した PDF ドキュメントへのアクセス権を回復します。

• DocumentSecurityClient オブジェクトの getLicenseManager メソッドを呼び出して、LicenseManager オブジェクトを作成します。
• LicenseManager オブジェクトの unrevokeLicense メソッドを呼び出し、失効したドキュメントのライセンス識別子の値を渡すことによって、失効した PDF ドキュメントへのアクセス権限を復元します。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して DocumentSecurityServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して DocumentSecurityServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• DocumentSecurityServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DocumentSecurityServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DocumentSecurityServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly を BasicHttpBindingSecurity.Security.Mode フィールドに割り当てます。

失効した PDF ドキュメントのライセンス識別子を取得します。

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、アクセス権が回復された失効済み PDF ドキュメントを格納するために使用されます。
• コンストラクターを呼び出し、失効した PDF ドキュメントファイルの場所とファイルを開くモードを表す文字列値を渡すことによって、System.IO.FileStream オブジェクトを作成します。
• System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。
• MTOM フィールドを割り当てて、BLOB オブジェクトにバイト配列の内容を入力します。

失効した PDF ドキュメントへのアクセス権を回復します。

• DocumentSecurityServiceClient オブジェクトの getLicenseID メソッドを呼び出し、失効したドキュメントを表す BLOB オブジェクトを渡すことによって、失効したドキュメントのライセンス識別子の値を取得します。このメソッドは、ライセンス識別子を表す文字列値を返します。
• DocumentSecurityServiceClient オブジェクトの unrevokeLicense メソッドを呼び出して、失効した PDF ドキュメントのライセンス識別子の値を指定する文字列値を渡すことにより、失効した PDF ドキュメントへのアクセスを回復します（DocumentSecurityServiceClient オブジェクトの getLicenseId メソッドの値を渡します）。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。これらのファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。（接続プロパティの設定を参照。）
• コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

検査するポリシーで保護されたドキュメントを取得します。

• コンストラクタを使用して、ポリシーで保護された PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

ドキュメントを検査します。

• RightsManagementClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。
• LicenseManager の inspectDocument メソッドを呼び出して、ポリシーで保護されたドキュメントを検査します。ポリシーで保護された PDF ドキュメントを含む com.adobe.idp.Document オブジェクトを渡します。このメソッドは、ポリシーで保護されたドキュメントに関する情報を含む RMInspectResult オブジェクトを返します。

ポリシーで保護されたドキュメントに関する情報を取得します。

ポリシーで保護されたドキュメントに関する情報を取得するには、RMInspectResult オブジェクトに属する適切なメソッドを呼び出します。例えば、ポリシー名を取得するには、RMInspectResult オブジェクトの getPolicyName メソッドを呼び出します。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して RightsManagementServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を 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 メソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。
• MTOM フィールドにバイト配列の内容を割り当てて、BLOB オブジェクトに入力します。

ドキュメントを検査します。

RightsManagementServiceClient オブジェクトの inspectDocument メソッドを呼び出して、ポリシーで保護されたドキュメントを検査します。ポリシーで保護された PDF ドキュメントを含む BLOB オブジェクトを渡します。このメソッドは、ポリシーで保護されたドキュメントに関する情報を含む RMInspectResult オブジェクトを返します。

ポリシーで保護されたドキュメントに関する情報を取得します。

ポリシーで保護されたドキュメントに関する情報を取得するには、RMInspectResult オブジェクトに属する適切なフィールドの値を取得します。例えば、ポリシー名を取得するには、RMInspectResult オブジェクトの policyName フィールドの値を取得します。

プロジェクトファイルを含めます。

adobe-rightsmanagement-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

透かし属性を設定

• InfomodelObjectFactory オブジェクトの静的 createWatermark メソッドを呼び出して Watermark オブジェクトを作成します。このメソッドは、Watermark オブジェクトを返します。
• Watermark オブジェクトの setName メソッドを呼び出し、ポリシー名を指定する文字列値を渡すことにより、透かしの名前属性を設定します。
• Watermark オブジェクトの setBackground メソッドを呼び出して true を渡すことにより、透かしの背景属性を設定します。この属性を設定すると、透かしがドキュメントの背景に表示されます。
• Watermark オブジェクトの setCustomText メソッドを呼び出し、透かしのテキストを表す文字列値を渡すことにより、透かしのカスタムテキスト属性を設定します。
• Watermark オブジェクトの setOpacity メソッドを呼び出し、不透明度を指定する整数値を渡すことにより、透かしの不透明度属性を設定します。100 の値は透かしが完全に不透明であることを示し、0 の値は透かしが完全に透明であることを示します。

透かしを登録します。

• RightsManagementClient オブジェクトの getWatermarkManager メソッドを呼び出して、WatermarkManager オブジェクトを作成します。このメソッドは、WatermarkManager オブジェクトを返します。
• WatermarkManager オブジェクトの registerWatermark メソッドを呼び出し、透かしを表す Watermark オブジェクトを渡すことによって、透かしを登録します。このメソッドは、透かしの識別値を表す文字列値を返します。

Document Security Client API オブジェクトを作成します。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して RightsManagementServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を RightsManagementServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

透かしの属性を設定します。

• WatermarkSpec コンストラクターを呼び出して WatermarkSpec オブジェクトを作成します。
• WatermarkSpec オブジェクトの name データメンバーに文字列値を割り当てて、透かしの名前を設定します。
• WatermarkSpec オブジェクトの id データメンバーに文字列値を割り当てて、透かしの 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 オブジェクトを渡して、透かしを登録します。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

変更する透かしを取得します。

DocumentSecurityClient オブジェクトの getWatermarkManager メソッドを呼び出して、WatermarkManager オブジェクトを作成し、透かしの名前を指定する文字列値を渡します。このメソッドは、変更する透かしを表す 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 Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して DocumentSecurityServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/DocumentSecurityService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• DocumentSecurityServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DocumentSecurityServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を 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 オブジェクトを渡して、透かしを更新します。

プロジェクトファイルを含める

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Rights Management クライアント API オブジェクトの作成

コンストラクターを使用し、接続プロパティが格納される ServiceClientFactory オブジェクトを渡すことにより、DocumentSecurityClient オブジェクトを作成します。

検索するイベントの指定

• EventManager オブジェクトの getEventManager メソッドを呼び出して DocumentSecurityClient オブジェクトを作成します。このメソッドは 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 オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して DocumentSecurityServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• DocumentSecurityServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DocumentSecurityServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DocumentSecurityServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

検索するイベントの指定

• コンストラクターを使用して EventSpec オブジェクトを作成します。
• イベントが発生した期間の開始時点を指定するには、EventSpec オブジェクトの firstTime.date データメンバーに、イベントが発生した日付範囲の開始日を表す DataTime インスタンスを設定します。
• EventSpec オブジェクトの firstTime.dateSpecified データメンバーに 値 true を割り当てます。
• イベントが発生した期間の終了時点を指定するには、EventSpec オブジェクトの lastTime.date データメンバーに、イベントが発生した日付範囲の終了日を表す DataTime インスタンスを設定します。
• EventSpec オブジェクトの lastTime.dateSpecified データメンバーに値 true を割り当てます。
• EventSpec オブジェクトの eventCode データメンバーに文字列値を割り当て、検索するイベントを設定します。次の表に、このプロパティに割り当てることができる数値を示します。

イベントの検索

DocumentSecurityServiceClient オブジェクトの searchForEvents メソッドを呼び出し、検索対象のイベントと検索の最大件数を表す EventSpec オブジェクトを渡して、イベントを検索します。このメソッドは、MyArrayOf_xsd_anyType のコレクション（個々の要素はそれぞれ 1 つの AuditSpec インスタンスに相当します）を返します。AuditSpec インスタンスを使用して、発生した時刻など、イベントに関する情報を取得できます。AuditSpec インスタンスには、この情報を指定する timestamp データメンバーが含まれます。

プロジェクトファイルを含めます。

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトを作成します。

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

Word ドキュメントを取得します。

• コンストラクターを使用して Word ドキュメントの場所を指定する文字列値を渡すことによって、Word ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

Word ドキュメントに既存のポリシーを適用します。

• DocumentSecurityClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。

• DocumentManager オブジェクトの protectDocument メソッドを呼び出し、次の値を渡して、Word ドキュメントにポリシーを適用します。

  • ポリシーを適用する Word ドキュメントが含まれる com.adobe.idp.Document オブジェクト。
  • ドキュメントの名前を指定する文字列値。
  • ポリシーが属しているポリシーセットの名前を表す文字列値。null 値を使用すると、現在使用中の MyPolicies ポリシーセットが指定されます。
  • ポリシー名を指定する文字列値。
  • ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表す文字列値。このパラメーターの値はオプションであり、null にすることができます（このパラメーターが null の場合、次のパラメーターの値も null にする必要があります）。
  • ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表す文字列値。このパラメーター値はオプションであり、 null にすることができます（このパラメーターが null の場合、前のパラメーター値も null である必要があります）。
  • MS Office テンプレートの選択に使用されるロケールを表す com.adobe.livecycle.rightsmanagement.Locale。このパラメーター値はオプションであり、null を指定できます。

  protectDocument メソッドは、ポリシーで保護された Word ドキュメントを含む RMSecureDocumentResult オブジェクトを返します。

Word ドキュメントを保存します。

• RMSecureDocumentResult オブジェクトの getProtectedDoc メソッドを呼び出して、ポリシーで保護された Word ドキュメントを取得します。このメソッドは com.adobe.idp.Document オブジェクトを返します。
• java.io.File オブジェクトを作成し、ファイル拡張子が DOC であることを確認します。
• com.adobe.idp.Document オブジェクトの copyToFile メソッドを呼び出して、Document オブジェクトの内容をファイルにコピーします（getProtectedDoc メソッドによって返された Document オブジェクトを使用してください）。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトを作成します。

• デフォルトのコンストラクターを使用して DocumentSecurityServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して DocumentSecurityServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/DocumentSecurityService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• DocumentSecurityServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DocumentSecurityServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DocumentSecurityServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly を BasicHttpBindingSecurity.Security.Mode フィールドに割り当てます。

Word ドキュメントを取得します。

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、ポリシーが適用される Word ドキュメントを格納するために使用されます。
• コンストラクターを呼び出し、Word ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡すことにより、System.IO.FileStream オブジェクトを作成します。
• System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStream オブジェクトの Length プロパティを取得して、バイト配列のサイズを決定します。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。
• MTOM フィールドにバイト配列の内容を割り当てて、BLOB オブジェクトにデータを入力します。

Word ドキュメントに既存のポリシーを適用します。

DocumentSecurityServiceClient オブジェクトの protectDocument メソッドを呼び出し、次の値を渡して、Word ドキュメントにポリシーを適用します。

• ポリシーを適用する Word ドキュメントが含まれる BLOB オブジェクト。
• ドキュメントの名前を指定する文字列値。
• ポリシーが属しているポリシーセットの名前を表す文字列値。null 値を使用すると、現在使用中の MyPolicies ポリシーセットが指定されます。
• ポリシー名を指定する文字列値。
• ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表す文字列値。このパラメーター値はオプションであり、null にすることができます（このパラメーターが null の場合、次のパラメーター値は null でなければなりません）。
• ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表す文字列値。このパラメーター値はオプションであり、null にすることができます（このパラメーターが null の場合、前のパラメーター値は null でなければなりません）。
• ロケール値を指定する RMLocale 値（例えば RMLocale.en）。
• ポリシー識別子の値を格納するために使用される文字列出力パラメーター。
• ポリシーで保護された識別子の値を保存するために使用される文字列出力パラメーター。
• MIME タイプを格納するのに使用する文字列出力パラメーター（例えば、application/doc）。

protectDocument メソッドは、ポリシーで保護された Word ドキュメントを含む BLOB オブジェクトを返します。

Word ドキュメントを保存します。

• コンストラクターを呼び出し、ポリシーで保護された Word ドキュメントファイルの場所を表す 文字列値を渡すことにより、System.IO.FileStream オブジェクトを作成します。
• protectDocument メソッドによって返された BLOB オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出し、バイト配列を渡して、バイト配列の内容を Word ファイルに書き込みます。

プロジェクトファイルを含める

クライアント JAR ファイル(adobe-rightsmanagement-client.jar など)を Java プロジェクトのクラスパスに含めます。

Document Security Client API オブジェクトの作成

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

ポリシーで保護された Word ドキュメントの取得

• コンストラクターを使用して、Word ドキュメントの場所を指定する文字列値を渡すことにより、ポリシーで保護された Word ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。
• コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

Word ドキュメントからポリシーを削除する

• RightsManagementClient オブジェクトの getDocumentManager メソッドを呼び出して、DocumentManager オブジェクトを作成します。
• DocumentManager オブジェクトの removeSecurity メソッドを呼び出し、ポリシーで保護された Word ドキュメントを含む com.adobe.idp.Document オブジェクトを渡して、Word ドキュメントからポリシーを削除します。このメソッドは、セキュリティで保護されていない Word ドキュメントを含む com.adobe.idp.Document オブジェクトを返します。

保護されていない Word ドキュメントを保存する

• java.io.File オブジェクトを作成し、ファイル拡張子が DOC であることを確認します。
• Document オブジェクトの copyToFile メソッドを呼び出して、Document オブジェクトの内容をファイルにコピーします（removeSecurity メソッドによって返された Document オブジェクトを使用してください）。

プロジェクトファイルを含める

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 を使用するようにします。

Document Security Client API オブジェクトの作成

• デフォルトのコンストラクターを使用して RightsManagementServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクターを使用して RightsManagementServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例えば、http://localhost:8080/soap/services/RightsManagementService?WSDL） 。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• RightsManagementServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • RightsManagementServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を RightsManagementServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。

• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

ポリシーで保護された Word ドキュメントの取得

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、ポリシーの削除対象となる、ポリシーで保護された Word ドキュメントを保存するために使用されます。
• コンストラクターを呼び出し、Word ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡して System.IO.FileStream オブジェクトを作成します。
• System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。
• MTOM フィールドを割り当てて BLOB オブジェクトにバイト配列の内容を入力します。

Word ドキュメントからポリシーを削除する

RightsManagementServiceClient オブジェクトの removePolicySecurity メソッドを呼び出し、ポリシーで保護された Word ドキュメントを含む BLOB オブジェクトを渡して、Word ドキュメントからポリシーを削除します。このメソッドは、セキュリティで保護されていない Word ドキュメントを含む BLOB オブジェクトを返します。

保護されていない Word ドキュメントを保存する

• コンストラクターを呼び出し、保護されていない Word ドキュメントを含むファイルの場所を表す文字列値を渡すことにより、System.IO.FileStream オブジェクトを作成します。
• removePolicySecurity メソッドで返された BLOB オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM フィールドの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。