使用権限の割り当て assigning-usage-rights
このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。
Acrobat Reader DC エクステンションサービスについて about-the-acrobat-reader-dc-extensions-service
Acrobat Reader DC エクステンションサービスを使用すると、Adobe Reader の機能を拡張することで、組織内でインタラクティブ PDF ドキュメントを簡単に共有できます。Acrobat Reader DC エクステンションサービスは、PDF 1.7 までのすべての PDF ドキュメントを完全にサポートします。Adobe Reader 7.0 以降で機能します。このサービスでは、PDF ドキュメントに使用権限を追加し、通常 Adobe Reader で PDF ドキュメントを開いたときに利用できない機能をアクティブにします。サードパーティユーザーは、権限を付与されたドキュメントを扱うためにソフトウェアまたはプラグインを追加する必要はありません。
Acrobat Reader DC エクステンションサービスを使用して、次のタスクを実行できます。
- 使用権限を PDF ドキュメントに適用します。詳しくは、PDF ドキュメントへの使用権限の適用を参照してください。
- 使用権限を PDF ドキュメントから削除します。詳しくは、PDF ドキュメントへの使用権限の削除を参照してください。
- 資格情報の詳細を取得します。詳しくは、資格情報の取得を参照してください。
PDF ドキュメントへの使用権限を適用 applying-usage-rights-to-pdf-documents
Acrobat Reader DC エクステンション Java クライアント API および web サービスを使用すると、PDF ドキュメントに使用権限を適用できます。使用権限は、Acrobat ではデフォルトで利用できるが Adobe Reader では利用できない機能(フォームにコメントを追加する機能や、フォームフィールドにデータを入力してフォームを保存する機能など)に関連しています。使用権限が与えられた PDF ドキュメントは、使用権限を付与されたドキュメントと呼ばれます。使用権限を付与されたドキュメントを Adobe Reader で開いたユーザーは、そのドキュメントで有効になっている操作を実行できます。
applyUsageRights
メソッド(Java API の一部)を使用して PDF ドキュメントに使用権限を適用する場合、ReaderExtensionsOptionSpec
オブジェクトの isModeFinal
パラメーターを false
に設定します。その結果、フォーム処理カウンターが更新されず、パフォーマンスが向上します。フォーム処理カウンターの更新を気にしなければ、isModeFinal
パラメータを false
に設定することをお勧めします。手順の概要 summary-of-steps
使用権限を PDF ドキュメントに適用するには、次の手順に従います。
- プロジェクトファイルを含めます。
- Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。
- PDF ドキュメントを取得します。
- 適用する使用権限を指定します。
- 使用権限を PDF ドキュメントに適用します。
- 権限が付与された PDF ドキュメントを保存します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めるようにします。
Acrobat Reader DC エクステンションのクライアントオブジェクトを作成
プログラムによって Acrobat Reader DC エクステンションサービスの操作を実行するには、Acrobat Reader DC エクステンションサービスのクライアントオブジェクトを作成する必要があります。Acrobat Reader DC エクステンション Java API を使用している場合は、ReaderExtensionsServiceClient
オブジェクトを作成します。Acrobat Reader DC エクステンション web サービス API を使用している場合は、ReaderExtensionsServiceService
オブジェクトを作成します。
PDF ドキュメントを取得
使用権限を適用するには、PDF ドキュメントを取得します。権限が付与された PDF ドキュメントには、使用権限ディクショナリが含まれています。Adobe Reader がそのようなディクショナリを含むドキュメントを開くと、そのドキュメントに対してのみディクショナリで指定された使用権限が有効になります。ドキュメントに使用権限ディクショナリが含まれていない場合、Acrobat Reader DC エクステンションサービスは使用権限ディクショナリを作成します。既にディクショナリが含まれている場合、Acrobat Reader DC エクステンションサービスは、指定した使用権限で既存の使用権限を上書きします。ディクショナリは、有効にする使用権限を指定します。ユーザーが Adobe Reader でドキュメントを開くと、ディクショナリで指定されている使用権限のみが許可されます。
適用する使用権限を指定
設定できる使用権限は、Adobe Systems Inc で購入した資格情報によって決まります。通常、資格情報は、インタラクティブフォームに関連する使用権限など、関連する使用権限のグループを設定する権限が付与されます。各資格情報は、一定数の権限が付与された PDF ドキュメントを作成する権限を付与します。評価資格情報を使用すると、無制限の数のドラフトドキュメントを作成する権限が付与されます。
PDF ドキュメントに使用権限を適用
PDF ドキュメントに使用権限を適用するには、使用権限の適用に使用している資格情報のエイリアスを参照します(通常、資格情報は AEM Forms のインストール時にインストールされます)。また、使用権限を適用する PDF ドキュメント を指定する必要があります。資格情報の設定に関する情報については、アプリケーションサーバーのインストールとデプロイのガイドを参照してください。
権限が付与された PDF ドキュメントを保存
Acrobat Reader DC エクステンションサービスが PDF ドキュメントに使用権限を適用したら、権限が付与された PDF ドキュメントを PDF ファイルとして保存できます。
関連トピック
Java API を使用して使用権限を適用 apply-usage-rights-using-the-java-api
Acrobat Reader DC エクステンション API(Java)を使用して、PDF ドキュメントに使用権限を適用します。
-
プロジェクトファイルを含める
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
オブジェクトを渡します。
- コンストラクターを使用し、PDF ドキュメントの場所を指定する文字列値を渡して、PDF ドキュメントを表す
-
適用する使用権限を指定します。
- コンストラクターを使用して、使用権限を表す
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
を渡すことができます。)
- 使用権限が適用される PDF ドキュメントを含む
-
実行時オプションを含む
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
オブジェクトを必ず使用してください)。
関連トピック
Web サービス API を使用して使用権限を適用 apply-usage-rights-using-the-web-service-api
Acrobat Reader DC Extensions API(web サービス)を使用することにより、PDF ドキュメントに使用権限を適用してください。
-
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
を使用するようにします。note note NOTE localhost
を AEM Forms をホストするサーバーの IP アドレスを置き換えます。 -
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
を渡すことができます。)
- 使用権限が適用される PDF ドキュメントを含む
-
実行時オプションを含む
ReaderExtensionsOptionSpec
オブジェクトです。
applyUsageRights
メソッドは、権限が付与された PDF ドキュメントを含むBLOB
オブジェクト返します。 -
-
権限が付与された PDF ドキュメントを保存します。
- コンストラクタを呼び出して
System.IO.FileStream
オブジェクトを作成します。権限が付与された PDF ドキュメントのファイルの場所を表す文字列値を渡します。 applyUsageRights
メソッドが返したBLOB
オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB
オブジェクトのMTOM
データメンバーの値を取得して、バイト配列を生成します。- コンストラクターを使用して
System.IO.BinaryWriter
オブジェクトを渡すことによって、System.IO.FileStream
オブジェクトを作成します。 System.IO.BinaryWriter
オブジェクトのWrite
メソッドを呼び出して、バイト配列を渡すことによって、バイト配列の内容を PDF ファイルに書き込みます。
- コンストラクタを呼び出して
関連トピック
PDF ドキュメントから使用権限を削除 removing-usage-rights-from-pdf-documents
権限を付与されたドキュメントから使用権限を削除できます。使用権限が有効な PDF ドキュメントから使用権限を削除することは、そのドキュメントに対して他の AEM Forms 操作を実行するためにも必要です。例えば、PDF ドキュメントに対する電子署名(または認証)は、使用権限を設定する前に実行する必要があります。したがって、権限を付与されたドキュメントに対して操作を行う場合、その PDF ドキュメントから使用権限を削除し、ドキュメントへのデジタル署名など、その他の操作を行った後にドキュメントに対して使用権限を再び適用してください。
手順の概要 summary_of_steps-1
権限を付与された PDF ドキュメントから使用権限を削除するには、次の手順に従います。
- プロジェクトファイルを含めます。
- Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。
- 権限付き PDF ドキュメントを取得します。
- 使用権限を PDF ドキュメントから削除します。
- PDF ドキュメントを保存します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めるようにします。
Acrobat Reader DC Extensions のクライアントオブジェクトを作成
Acrobat Reader DC エクステンションサービスの操作をプログラムで実行する前に、Acrobat Reader DC エクステンションサービスのクライアントオブジェクトを作成する必要があります。Java API を使用している場合は、ReaderExtensionsServiceClient
オブジェクトを作成してください。Acrobat Reader DC Extensions web サービス API を使用している場合は、ReaderExtensionsServiceService
オブジェクトを作成してください。
権限が付与された PDF ドキュメントを取得
使用権限を削除するために、権限を付与された PDF ドキュメントを取得します。
使用権限を PDF ドキュメントから削除
権限を付与された PDF ドキュメントを取得したら、使用権限を削除できます。使用権限を削除すると、PDF ドキュメントを Adobe Reader 内で表示する間、機能は追加されません。
PDF ドキュメントを保存
使用権限を含まない PDF ドキュメントは、PDF ファイルとして保存できます。PDF ドキュメントを PDF ファイルとして保存すると、Adobe Reader または Acrobat で表示できます。
関連トピック
Java API を使用して使用権限を削除する remove-usage-rights-using-the-java-api
Acrobat Reader DC Extensions API(Java)を使用して、権限を付与された 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
オブジェクトを使ってください。
関連トピック
Web サービス API を使用して使用権限を削除する remove-usage-rights-using-the-web-service-api
Acrobat Reader DC Extensions API(Web サービス)を使用して、権限を付与された PDF ドキュメントから使用権限を削除します。
-
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
を使用するようにします。note note NOTE localhost
を AEM Forms をホストするサーバーの IP アドレスを置き換えます。 -
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
オブジェクトを渡します。
関連トピック
資格情報の取得 retrieving-credential-information
権限付き PDF ドキュメントに使用権限を適用するために使用された資格情報に関する情報を取得できます。資格情報に関する情報を取得することで、資格情報が無効になった日付などの情報を取得できます。
手順の概要 summary_of_steps-2
使用権限を PDF ドキュメントに適用するために使用された資格情報に関する情報を取得するには、次の手順に従います。
- プロジェクトファイルを含めます。
- Acrobat Reader DC エクステンションのクライアントオブジェクトを作成します。
- 権限付き PDF ドキュメントを取得します。
- 資格情報に関する情報を取得します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めるようにします。
Acrobat Reader DC Extensions のクライアントオブジェクトを作成
Acrobat Reader DC エクステンションサービスの操作をプログラムで実行する前に、Acrobat Reader DC エクステンションサービスのクライアントオブジェクトを作成する必要があります。Java API を使用している場合は、ReaderExtensionsServiceClient
オブジェクトを作成してください。Acrobat Reader DC Extensions web サービス API を使用している場合は、ReaderExtensionsServiceService
オブジェクトを作成してください。
権限が付与された PDF ドキュメントを取得
資格に関する情報を取得するには、権限付き PDF ドキュメントを取得します。エイリアスを指定して、資格情報に関する情報を取得することもできます。ただし、使用権限を特定の権限付き PDF ドキュメントに適用するために使用された資格情報に関する情報を取得する場合は、ドキュメントを取得する必要があります。
資格情報に関する情報の取得
権限付き PDF ドキュメントを取得したら、使用権限を適用するために使用された資格情報に関する情報を取得できます。資格情報に関する次の情報を取得できます。
- 権限を持つ PDF ドキュメントを開く際に、Adobe Reader 内で表示されるメッセージです。
- 資格情報が無効になった後の日付です。
- 資格情報が無効になる前の日付です。
- この権限を持つ PDF ドキュメントに設定された使用権限です。
- 資格情報が使用された回数。
関連トピック
Java API を使用した資格情報情報の取得 retrieve-credential-information-using-the-java-api
Acrobat Reader DC Extensions API(Java)を使用して、資格情報情報を取得します。
-
プロジェクトファイルを含めます。
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 ドキュメントを表す
-
使用権限を PDF ドキュメントから削除します。
ReaderExtensionsServiceClient
オブジェクトのgetDocumentUsageRights
メソッドを呼び出し、使用権限を付与された PDF ドキュメントを含むcom.adobe.idp.Document
オブジェクトを渡すことによって、PDF ドキュメントに使用権限を適用するために使用される、資格情報に関する情報を取得します。このメソッドは、資格情報情報を含むGetUsageRightsResult
オブジェクトを返します。GetUsageRightsResult
オブジェクトのgetNotAfter
メソッドを呼び出して、資格情報が有効でなくなった日付を取得します。このメソッドは、java.util.Date
資格情報が有効でなくなる日付を表すオブジェクトを返します。GetUsageRightsResult
オブジェクトのgetMessage
メソッドを呼び出して、権限を付与された PDF ドキュメントが開かれたときに、Adobe Reader に表示されるメッセージを取得します。このメソッドは、メッセージを表す文字列値を返します。
関連トピック
Web サービス API を使用して資格情報に関する情報を取得 retrieve-credential-information-using-the-web-service-api
Acrobat Reader DC Extensions API(Web サービス)を使用して資格情報に関する情報を取得します。
-
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
を使用するようにします。note note NOTE localhost
を AEM Forms をホストするサーバーの IP アドレスを置き換えます。 -
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
データメンバーの値を取得して、資格情報が使用された回数を取得します。このデータメンバーのデータタイプは整数です。
関連トピック