権限付きフォームのレンダリング rendering-rights-enabled-forms

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

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

Forms Client API オブジェクトの作成

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

使用権限の実行時オプションを設定する

• コンストラクタを使用して ReaderExtensionSpec オブジェクトを作成します。
• ReaderExtensionSpec オブジェクトの setReCredentialAlias メソッドを呼び出して、資格情報のエイリアスを指定し、そのエイリアスの値を表す文字列値を指定します。
• ReaderExtensionSpec オブジェクトに属する対応するメソッドを呼び出して、各使用権限を設定します。ただし、使用権限を設定できるのは、参照する秘密鍵証明書でその権限が与えられている場合のみです。つまり、秘密鍵証明書で設定が許可されていない場合は、使用権限を設定できません。以下に例を示します。ユーザーがフォームのフィールドに入力して保存できる使用権を設定するには、ReaderExtensionSpec オブジェクトの setReFillIn メソッドを呼び出し、true を渡します。

権限設定されたフォームをレンダリングする

FormsServiceClient オブジェクトの renderPDFFormWithUsageRights メソッドを呼び出して、以下の値を渡します。

• フォームデザイン名を指定する文字列値で、ファイル名の拡張子も含まれます。Forms アプリケーションの一部であるフォームデザインを参照する場合は、必ず次のような完全なパスを指定してください。Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
• フォームに結合するデータを含む com.adobe.idp.Document オブジェクト。データを結合しない場合は、空の com.adobe.idp.Document オブジェクトを渡します。
• ランタイムオプションを格納する PDFFormRenderSpec オブジェクトです。
• 使用権限の実行時オプションを格納する ReaderExtensionSpec オブジェクトです。
• Forms サービスで必要な URI 値を格納する URLSpec オブジェクトです。

renderPDFFormWithUsageRights メソッドは、クライアントの web ブラウザーに書き込まれなければならないフォームデータストリームを含む FormsResult オブジェクトを返します。

フォームデータストリームをクライアント web ブラウザーに書き込む

• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、com.adobe.idp.Document オブジェクトを作成します。
• getContentType メソッドを呼び出して、com.adobe.idp.Document オブジェクトのコンテンツタイプを取得します。
• javax.servlet.http.HttpServletResponse オブジェクトの setContentType メソッドを呼び出してコンテンツタイプを設定し、com.adobe.idp.Document オブジェクトのコンテンツタイプを渡します。
• javax.servlet.http.HttpServletResponse オブジェクトの getOutputStream メソッドを呼び出して、javax.servlet.ServletOutputStream オブジェクトを作成します。このオブジェクトは、フォームデータストリームをクライアント web ブラウザーに書き込むために使用されます。
• com.adobe.idp.Document オブジェクトの getInputStream メソッドを呼び出すことによって、java.io.InputStream オブジェクトを作成します。
• InputStream オブジェクトの read メソッドを呼び出して、引数としてバイト配列を渡すことで、バイト配列を作成し、フォームデータストリームを入力します。
• javax.servlet.ServletOutputStream オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。バイト配列を write メソッドに渡します。

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

• Forms Service WSDL を使用する Java プロキシクラスを作成します。
• Java プロキシクラスをクラスパスに含めます。

Forms Client API オブジェクトの作成

FormsService オブジェクトを作成し、認証値を設定します。

使用権限の実行時オプションを設定する

• コンストラクタを使用して ReaderExtensionSpec オブジェクトを作成します。
• ReaderExtensionSpec オブジェクトの setReCredentialAlias メソッドを呼び出して、資格情報のエイリアスを指定し、そのエイリアスの値を表す文字列値を指定します。
• ReaderExtensionSpec オブジェクトに属する対応するメソッドを呼び出して、各使用権限を設定します。ただし、使用権限を設定できるのは、参照する秘密鍵証明書でその権限が与えられている場合のみです。つまり、秘密鍵証明書で設定が許可されていない場合は、使用権限を設定できません。ユーザーがフォームフィールドに入力し、フォームを保存できる使用権限を設定するには、ReaderExtensionSpec オブジェクトの setReFillIn メソッドを呼び出し、true を渡します。

権限設定されたフォームをレンダリングする

FormsService オブジェクトの renderPDFFormWithUsageRights メソッドを呼び出して、以下の値を渡します。

• フォームデザイン名を指定する文字列値で、ファイル名の拡張子も含まれます。Forms アプリケーションの一部であるフォームデザインを参照する場合は、必ず次のような完全なパスを指定してください。Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
• フォームで結合するデータを格納する BLOB オブジェクト。フォームでデータを結合しない場合は、空の XML データソースを基にした BLOB オブジェクトを渡す必要があります。null の BLOB オブジェクトを渡すことはできません。このようなオブジェクトを渡すと例外が発生します。
• ランタイムオプションを格納する PDFFormRenderSpec オブジェクト。
• 使用権限の実行時オプションを格納する ReaderExtensionSpec オブジェクトです。
• Forms サービスで必要な URI 値を格納する URLSpec オブジェクトです。

renderPDFFormWithUsageRights メソッドは、クライアントの web ブラウザーに書き込まれなければならないフォームデータストリームを含む FormsResult オブジェクトを返します。

フォームデータストリームをクライアント web ブラウザーに書き込む

• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、フォームデータを格納する BLOB オブジェクトを作成します。
• getContentType メソッドを呼び出して、BLOB オブジェクトのコンテンツタイプを取得します。
• javax.servlet.http.HttpServletResponse オブジェクトの setContentType メソッドを呼び出してコンテンツタイプを設定し、BLOB オブジェクトのコンテンツタイプを渡します。
• javax.servlet.http.HttpServletResponse オブジェクトの getOutputStream メソッドを呼び出して、クライアントの web ブラウザーにフォームデータストリームを書き込むために使用する javax.servlet.ServletOutputStream オブジェクトを作成します。
• BLOB オブジェクトの getBinaryData メソッドを呼び出し、バイト配列を作成して入力します。このタスクは、FormsResult オブジェクトのコンテンツをバイト配列に割り当てます。
• javax.servlet.http.HttpServletResponse オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。バイト配列を write メソッドに渡します。