使用権限の割り当て assigning-usage-rights

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

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

Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。

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

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

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

適用する使用権限を指定します。

• コンストラクターを使用して、使用権限を表す UsageRights オブジェクトを作成します。
• 適用する使用権限ごとに、UsageRights オブジェクトに属する対応するメソッドを呼び出します。例えば、enableFormFillIn 使用権限を追加するには、UsageRights オブジェクトの enableFormFillIn メソッドを呼び出して、true を渡します。（適用する各使用権限に対して、この手順を繰り返します）。

使用権限を PDF ドキュメントに適用します。

• コンストラクタを使用して ReaderExtensionsOptionSpec オブジェクトを作成します。このオブジェクトには、Acrobat Reader DC エクステンションサービスで必要な実行時オプションが含まれています。このコンストラクターを呼び出す場合は、次の値を指定する必要があります。

  • ドキュメントに適用する使用権限を含む UsageRights オブジェクト。
  • Adobe Reader 7.x で権限が付与された PDF ドキュメントを開く際にユーザーに表示されるメッセージを指定する文字列値。このメッセージは、Adobe Reader 8.0 では表示されません。

• 使用権限を PDF ドキュメントに適用するには、ReaderExtensionsServiceClient オブジェクトの applyUsageRights メソッドを呼び出して、次の値を渡してください。

  • 使用権限が適用される PDF ドキュメントを含む com.adobe.idp.Document オブジェクトです。
  • 使用権限を適用できる証明書のエイリアスを指定する文字列値です。
  • 対応するパスワード値を指定する文字列値です。（現在、このパラメーターは無視されます。null を渡すことができます。）

• 実行時オプションを含む ReaderExtensionsOptionSpec オブジェクトです。

applyUsageRights メソッドは、権限が付与された PDF ドキュメントを含む com.adobe.idp.Document オブジェクト返します。

権限が付与された PDF ドキュメントを保存します。

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

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

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

Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。

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

• System.ServiceModel.EndpointAddress コンストラクタを使用して ReaderExtensionsServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例：http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom。必ず ?blob=mtom を指定します）。

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

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

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

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

適用する使用権限を指定します。

• コンストラクタを使用して、使用権限を表す UsageRights オブジェクトを作成します。
• 適用する使用権限ごとに、UsageRights オブジェクトに属し、対応するデータメンバーに値 true を割り当てます。例えば、enableFormFillIn 使用権限を追加するには、true を UsageRights オブジェクトの enableFormFillIn データメンバーに割り当てます。（適用する各使用権限に対して、この手順を繰り返します）。

使用権限を PDF ドキュメントに適用します。

• コンストラクタを使用して ReaderExtensionsOptionSpec オブジェクトを作成します。このオブジェクトには、Acrobat Reader DC Extensions サービスで必要な実行時オプションが含まれています。

• UsageRights オブジェクトを ReaderExtensionsOptionSpec オブジェクトの usageRights データメンバーに割り当てます。

• Adobe Reader で権限を付与された PDF ドキュメントを開く際に、ユーザーに表示されるメッセージを指定する文字列値を ReaderExtensionsOptionSpec オブジェクトの message データメンバーに割り当てます。

• 使用権限を PDF ドキュメントに適用するには、ReaderExtensionsServiceClient オブジェクトの applyUsageRights メソッドを呼び出して、次の値を渡します。

  • 使用権限が適用される PDF ドキュメントを含む BLOB オブジェクトです。
  • 使用権限を適用できる証明書のエイリアスを指定する文字列値です。
  • 対応するパスワード値を指定する文字列値です。（現在、このパラメーターは無視されます。null を渡すことができます。）

• 実行時オプションを含む ReaderExtensionsOptionSpec オブジェクトです。

applyUsageRights メソッドは、権限が付与された PDF ドキュメントを含む BLOB オブジェクト返します。

権限が付与された PDF ドキュメントを保存します。

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

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

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

Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。

ReaderExtensionsServiceClient オブジェクトを作成するには、それ自身のコンストラクタを使用し、接続プロパティを含む ServiceClientFactory オブジェクトを渡します。

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

• java.io.FileInputStream オブジェクト（権限を付与された PDF ドキュメントを表す）を作成するには、それ自身のコンストラクタを使用し、PDFドキュメントの場所を指定する文字列値を渡します。
• com.adobe.idp.Document オブジェクトを作成するには、それ自身のコンストラクタを使用し、java.io.FileInputStream オブジェクトを渡します。

使用権限を PDF ドキュメントから削除します。

ReaderExtensionsServiceClient オブジェクトの removeUsageRights メソッドを呼び出し、権限が付与された PDF ドキュメントを含む com.adobe.idp.Document オブジェクトを渡すことによって、使用権限を PDF ドキュメントから削除します。このメソッドは、使用権限のない PDF ドキュメントを含む com.adobe.idp.Document オブジェクトを返します。

使用権限を PDF ドキュメントに適用します。

• java.io.File オブジェクトを作成し、ファイル拡張子が .pdf であることを確認します。
• Document オブジェクトの copyToFile メソッドを呼び出して、 Document オブジェクトのコンテンツをファイルにコピーします。この際に必ず、removeUsageRights メソッドが返した Document オブジェクトを使ってください。

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

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

Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。

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

• System.ServiceModel.EndpointAddress コンストラクタを使用して ReaderExtensionsServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例：http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom。必ず ?blob=mtom を指定します）。

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

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

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

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

使用権限を PDF ドキュメントから削除します。

ReaderExtensionsServiceClient オブジェクトの removeUsageRights メソッドを呼び出し、権限が付与された PDF ドキュメントを含む BLOB オブジェクトを渡すことによって、使用権限を PDF ドキュメントから削除します。このメソッドは、使用権限のない PDF ドキュメントを含む BLOB オブジェクトを返します。

使用権限を PDF ドキュメントに適用します。

• System.IO.FileStream オブジェクトを作成するには、コンストラクタを呼び出し、PDF ファイルの場所を表す文字列値を渡します。
• removeUsageRights メソッドで返された BLOB オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列を生成します。
• System.IO.BinaryWriter オブジェクトを作成するには、コンストラクタを呼び出して、System.IO.FileStream オブジェクトを渡します。

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

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

Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。

ReaderExtensionsServiceClient オブジェクトを作成するには、それ自身のコンストラクタを使用し、接続プロパティを含む ServiceClientFactory オブジェクトを渡します。

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

• 権限が付与された PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成するには、それ自身のコンストラクタを使用し、権限が付与された PDF ドキュメントの場所を指定する文字列値を渡します。
• com.adobe.idp.Document オブジェクトを作成するには、それ自身のコンストラクタを使用し、java.io.FileInputStream オブジェクトを渡します。

使用権限を PDF ドキュメントから削除します。

• ReaderExtensionsServiceClient オブジェクトの getDocumentUsageRights メソッドを呼び出し、使用権限を付与された PDF ドキュメントを含む com.adobe.idp.Document オブジェクトを渡すことによって、PDF ドキュメントに使用権限を適用するために使用される、秘密鍵証明書に関する情報を取得します。このメソッドは、秘密鍵証明書情報を含む GetUsageRightsResult オブジェクトを返します。
• GetUsageRightsResult オブジェクトの getNotAfter メソッドを呼び出して、秘密鍵証明書が有効でなくなった日付を取得します。このメソッドは、 java.util.Date 秘密鍵証明書が有効でなくなる日付を表すオブジェクトを返します。
• GetUsageRightsResult オブジェクトの getMessage メソッドを呼び出して、権限を付与された PDF ドキュメントが開かれたときに、Adobe Reader に表示されるメッセージを取得します。このメソッドは、メッセージを表す文字列値を返します。

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

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

Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。

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

• System.ServiceModel.EndpointAddress コンストラクターを使用して ReaderExtensionsServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例：http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom。必ず ?blob=mtom を指定します）。

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

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

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

  • ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を ReaderExtensionsServiceClient.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 ドキュメントから削除します。

• ReaderExtensionsServiceClient オブジェクトの getDocumentUsageRights メソッドを呼び出し、権限付き PDF ドキュメントを含む com.adobe.idp.Document オブジェクトを渡すことによって、使用権限を PDF ドキュメントに適用するのに使用する資格情報を取得します。このメソッドは、資格情報を含む GetUsageRightsResult オブジェクトを返します。
• GetUsageRightsResult オブジェクトの notAfter データメンバーの値を取得して、資格情報の有効期限日を取得します。このデータメンバーのデータタイプは System.DateTime です。
• GetUsageRightsResultオブジェクトのmessageデータメンバーの値を取得して、Adobe Reader で権限付き PDF ドキュメントを開いたときに表示されるメッセージを取得します。このデータメンバーのデータタイプは文字列です。
• GetUsageRightsResultオブジェクトのuseCountデータメンバーの値を取得して、資格情報が使用された回数を取得します。このデータメンバーのデータタイプは整数です。