Acrobat Reader DC エクステンション

Acrobat Reader DC エクステンションを使用すると、PDF ドキュメントの使用権限を操作できます。使用権限は、Acrobat で使用できる機能に適用されますが、Acrobat Reader の機能には適用されません。Acrobat Reader DC エクステンションによって制御される機能には、ドキュメントにコメントを追加する、フォームに情報を入力する、ドキュメントを保存する、などがあります。使用権限が追加された PDF ドキュメントは、「使用権限を付与されたドキュメント」と呼ばれます。使用権限を付与された PDF ドキュメントを Adobe Reader で開いたユーザーは、そのドキュメントで有効になっている操作を実行できます。

PDF ドキュメントに加えて、PDF フォームの使用権限も「Acrobat Reader DC エクステンション」操作から変更できます。

重要: Workspace で使用する静的 PDF フォームに対して Acrobat Reader DC エクステンションから使用権限を追加する場合、「Take Offline」をクリックしてフォームを保存します。この手順により、使用権限が保存されます。Adobe Reader の「Save」ボタンをクリックすると、ユーザーの使用権限が使用不可になります。

Acrobat Reader DC エクステンションサービスの使用に関する詳細は、『 AEM forms サービスリファレンス 』を参照してください。

「Apply Usage Rights」操作

PDF ドキュメントに使用権限を適用します。「Apply Usage Rights」操作を行う前に、Acrobat Reader DC エクステンションの秘密鍵証明書をインポートし、設定します。(『 AEM forms 管理ヘルプ 』の「Acrobat Reader DC エクステンションで秘密鍵証明書を使用するための設定」を参照)。

Workspace で使用する PDF フォームに使用権限を適用する場合は、Form Bridge ライブラリも挿入します。次に示す順序で手順を実行します。

  1. 例えば、 「renderPDFForm」操作 (Form サービス)を使用して PDF を作成します。

  2. 「Inject Form Bridge」操作 (Form Augmenter サービス)を使用して Form Bridge ライブラリを追加します。

  3. 使用権限を適用します。

    使用権限の適用後に Form Bridge ライブラリを挿入した場合、使用権限は無効になります。1 つのドキュメントに対して暗号化、認証方法、および使用権限の適用を組み合わせて使用する場合は、次に示す順序で行う必要があります。これらのサービスの呼び出しは、短時間のうちに行う必要があります。

  4. 暗号化します( Encryption サービスまたは Rights Management サービスの Protect Document 操作 操作)。

  5. 認証を行います( シグネチャ サービス)。

  6. 使用権限を適用します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

PDF ドキュメント、秘密鍵証明書エイリアス、および PDF ドキュメントに適用する使用権限を指定するプロパティ。

Input PDF Document

使用権限を適用する PDF ドキュメントを表す 文書 値。

リテラル値を指定する場合は、省略記号ボタン をクリックして、Select Asset ダイアログボックスを開きます( Select Asset について を参照)。

秘密鍵証明書エイリアス

使用権限が付与された秘密鍵証明書のエイリアスを表す string 値。

Credential Alias リストからリテラル値を指定する場合、Trust Store 内の秘密鍵証明書の識別子を選択します。

使用権限オプションを適用

(オプション)PDF ドキュメントに適用する使用権限を表す ReaderExtensionsOptionSpec 値。

リテラル値を使用する場合は、PDF ドキュメントに次のいずれかの使用権限を適用できます。

基本フォームに記入:
PDF ドキュメントの「基本フォームに記入」機能を許可する場合に選択します。

フォームデータの読み込みおよび書き出し:
フォームデータの読み込みおよび書き出しを許可する場合に選択します。

Web ブラウザー以外で送信:
電子メールまたはオフラインでフォームデータを送信することを許可する場合に選択します。

データベースと Web サービスの接続性:
データベースへのアクセスや PDF ドキュメント内に定義された Web サービスの呼び出しを許可する場合に選択します。

フォームフィールドを追加、削除、および変更:
PDF ドキュメントで、既存の記入されているフォームフィールドを編集することを許可する場合に選択します。

テンプレートからページを作成:
PDF ドキュメントの既存のテンプレートから生成した新しいページを追加することを許可する場合に選択します。

2D バーコードのデコード:
PDF ドキュメントでの二次元バーコード(2D)のデコードを許可する場合に選択します。

電子署名:
PDF ドキュメントにデジタル署名を追加することを許可する場合に選択します。

コメント:
PDF ドキュメントのオフラインでのコメントを許可する場合に選択します。

オンラインコメント:
PDF ドキュメントのオンラインでのコメントを許可する場合に選択します。

埋め込まれた添付ファイル:
PDF ドキュメントに添付ファイルを追加することを許可する場合に選択します。

Count Credential Usage:
使用権限を有効にするために秘密鍵証明書を使用する回数を作成する場合には Yes を選択します。Acrobat Reader DC エクステンションの Web アプリケーションに回数が表示されます。

Reader メッセージ:
メッセージを入力すると、Adobe Reader 内でテキストで表示され、PDF ドキュメントに使用権限があることがユーザーに通知されます。

Output プロパティ

使用権限のある PDF ドキュメントを指定するプロパティ。

PDF ドキュメントの出力

(オプション)適用した使用権限のある PDF ドキュメントを格納する位置。データタイプは 文書 です。

Exceptions

この操作では、 ReaderExtensionsException 例外をスローすることがあります。

「Get Document Usage Rights」操作

PDF ドキュメントに適用する使用権限の情報を取得します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

使用権限情報を取得する PDF ドキュメントを指定するプロパティ。

Input PDF

使用権限情報を取得した PDF ドキュメントを示す 文書 値。

Output プロパティ

使用権限情報の保存先を指定するプロパティ。

Document Usage Rights

(オプション)指定した PDF ドキュメントの使用権限情報を格納する位置。データタイプは GetUsageRightsResult です。

Exceptions

この操作では、 ReaderExtensionsException 例外をスローすることがあります。

「Get Credential Usage Rights」操作

ドキュメントに適用する使用権限を含む、指定した秘密鍵証明書の情報を取得します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

使用権限情報を取得するための秘密鍵証明書を指定するプロパティ。

秘密鍵証明書エイリアス

使用権限情報を取得するための秘密鍵証明書を指定する string 値。

Credential Alias リストからリテラル値を指定する場合、Trust Store 内の秘密鍵証明書の識別子を選択します。

Output プロパティ

使用権限情報の保存先を指定するプロパティ。

Credential Usage Rights

(オプション)指定した秘密鍵証明書の使用権限情報を格納する位置。データタイプは GetUsageRightsResult です。

Exceptions

この操作では、 ReaderExtensionsException 例外をスローすることがあります。

「Remove Usage Rights」操作

指定した PDF ドキュメントの使用権限を削除します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

使用権限を付与された PDF ドキュメントを指定するプロパティ。

Input PDF Document

使用権限を削除する PDF ドキュメントを示す 文書 値。

リテラル値を指定する場合は、省略記号ボタンをクリックして、Select Asset ダイアログボックスを開きます( Select Asset について を参照)。

Output プロパティ

使用権限のない PDF ドキュメントを指定するプロパティ。

PDF ドキュメントの出力

(オプション)使用権限のない PDF ドキュメントを格納する位置。データタイプは 文書 です。

Exceptions

この操作では、 ReaderExtensionsException 例外をスローすることがあります。

Acrobat Reader DC エクステンションの例外

Acrobat Reader DC エクステンションサービスでは、例外イベントをスローするために次の例外が提供されます。

ReaderExtensionsException

PDF ドキュメントに対する使用権限の追加または削除の実行時にエラーが発生した場合にスローされます。