「renderPDFForm」操作

指定されたフォームを取得し、フォームデータをマージして、Adobe Reader などのクライアントアプリケーション用に PDF フォームに変換します。この操作を使用するのは、アプリケーションに保存され、プロセスで document 値として使用されるフォームデザインまたはフォームデータを使用する場合です。

renderPDFForm(非推奨)操作の代わりにこの操作を使用することの利点は、次のとおりです。

  • すべてのアセットが単一のアプリケーションに含まれるため、アプリケーションの移植性が最大化されます。

  • フォームデザインは document 変数を使用して評価できるため、フォームプロセスデザインが簡略化されます。

    例えば、アプリケーションで直接レンダリングする代わりに、アプリケーションの一部としてパッケージ化される PDF フォームをレンダリングする必要があります。PDF フォームを表示するユーザーは、Acrobat でデジタル署名する必要があります。PDF フォームにはセキュリティ機能とユーザーがフォームにデジタル署名する機能が埋め込まれています。renderPDFForm 操作を使用して、アプリケーションからインタラクティブな PDF フォームにフォームデザインをレンダリングします。PDF フォームでは、ユーザーが自動化されたプロセスの一部としてフォームに署名して送信できます。

    注意: renderPDFForm 操作は、document 変数を作成してフォームデザインまたはフォームデータを保存することができない場合にのみ使用します。ネットワーク上、ローカルファイルシステム、または HTTP ロケーションで動的に参照されるフォームデザインまたはフォームデータのドキュメント変数を作成することはできません。

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

Input プロパティ

PDF フォームをレンダリングするときにフォームデザイン、フォームデータ、およびオプションを指定するためのプロパティ。

Form

レンダリングするアプリケーション内のフォームデザインを指定する document 値。

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

Form Data

レンダリング中にフォームとマージするデータを表す document 値。XML 形式で提供されるフォームデータは、deserialize 関数を使用してデシリアライズする必要があります。(LiveCycle Workbench 9.5 ヘルプdeserialize を参照)。

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

Template Options プロパティ

フォームデザインの設定オプションを指定するためのプロパティ。

Content Root URI

URI または絶対参照を指定する string 値。これによって、イメージなどのフォームデザインで使用される相対アセットを取得するためのリポジトリ内のフォルダーが指定されます。例えば、フォームデザインが ../myImage.gif のようにイメージを相対的に参照する場合、myImage.gif は repository:// に配置する必要があります。デフォルト値は repository:// で、これはリポジトリのルートレベルをポイントします。

URI または絶対参照に次のソースを使用できます。

  • Repository:リポジトリには LiveCycle サーバーにアップロードするアセットが含まれます。値 repository:/// はリポジトリのルートを参照します。最初の 2 つのスラッシュはプロトコル(repository://)の一部であり、3 番目のスラッシュはリポジトリのルートを表します。

  • Directory in the file system of the LiveCycle server:C:¥[foldername] のように、LiveCycle サーバー上の場所を指定できます。アプリケーションの移植性を確保したい場合、サーバー上の場所を使用することはお勧めしません。

  • Network directory:¥¥[folder name] のように、ネットワーク上の場所を指定できます。

  • Web location that is accessible by using HTTP:Web サーバーにファイルをアップロードした後、http://[server name]:[port number]/[folder name] のように、URL を使用して場所を指定できます。

    リテラル値を指定する場合、URI または絶対参照を指定する値を入力します。

Locale

HTML フォームがレンダリングされるときに、Web ブラウザーなどのクライアントアプリケーションに検証メッセージを送信するために使用される言語を指定する string 値。

リテラル値を指定する場合、リストから言語を選択するか、または次のいずれかの値を選択します。

Use Server Default:

(デフォルト)LiveCycle サーバー上で設定されているロケール設定を使用します。ロケール設定は、管理コンソールを使用して設定されます(Forms 管理ヘルプを参照)。

Use Custom Value:

リスト内にないロケールを使用します。この値を選択した後、リストの横にあるボックスで、使用するロケールのロケール ID を入力します。サポートされるロケールコードのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html を参照してください。

Character Set

出力バイトストリームをエンコードするために使用される文字セットを指定する string 値。

リテラル値を指定する場合、リストから文字セットを選択するか、または次のいずれかの値を選択します。

Use Server Default:

(デフォルト)LiveCycle サーバー上で設定されている文字セット設定を使用します。文字セット設定は、管理コンソールを使用して設定されます(Forms 管理ヘルプを参照)。

Use Custom Value:

リスト内にない文字を使用します。この値を選択した後、リストの横にあるボックスで、使用するエンコーディングの正規の名前(Java.nio API)を入力します。文字セットのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html を参照してください。

PDF Options プロパティ

レンダリングされた PDF フォームの設定パラメーターを指定するためのプロパティ。

Acrobat Version

レンダリングされた PDF フォームを開くために必要な Acrobat と Adobe Reader の最小バージョンを指定する AcrobatVersion 値。

リテラル値を指定する場合、次のいずれかの値を選択します。

Use Form Template Default:

(デフォルト)フォームデザインの「Target Version」設定によって、Acrobat または Adobe Reader の最小バージョンが決まりました。さらに、フォームデザインによって PDF のバージョンが決まります。

Acrobat and Adobe Reader 6 or later:

Acrobat 6 または Adobe Reader 6 以降で PDF フォームを開くことができます。

Acrobat and Adobe Reader 7.0 or later:

Acrobat 7 以降または Adobe Reader 7 以降で PDF フォームを開くことができます。

Acrobat and Adobe Reader 7.0.5 or later:

Acrobat 7.0.5 以降または Adobe Reader 7.0.5 以降で PDF フォームを開くことができます。

Acrobat and Adobe Reader 8 or later:

Acrobat 8 以降または Adobe Reader 8 以降で PDF フォームを開くことができます。

Acrobat and Adobe Reader 8.1 or later:

Acrobat 8.1 以降または Adobe Reader 8.1 以降で PDF フォームを開くことができます。

Acrobat and Adobe Reader 9 or later:

Acrobat 9 以降または Adobe Reader 9 以降で PDF フォームを開くことができます。

Accessible (Tagged) PDF

タグ付き Adobe PDF フォームを作成するかどうかを指定する boolean 値。タグ付き PDF フォームにより、ページコンテンツを抽出し、他の目的のために再利用することがサポートされる標準構造タイプと属性のセットが定義されます。このプロパティは、次のタイプの操作を実行するツールによる使用を前提としています。

  • 他のアプリケーションに貼り付けるためのテキストおよびグラフィックの単純な抽出。

  • 元のレイアウトを想定するのではなく、ページを別のサイズに合わせるためのテキストおよび関連づけられたグラフィックの自動再フロー。

  • 検索、インデックス作成、スペルチェックなどの目的のためのテキスト処理。

  • ドキュメント構造と基本スタイル情報を保持したまま、他の一般的なファイル形式(HTML、XML、RTF など)に変換。

  • コンテンツをスクリーンリーダーソフトウェアからアクセス可能にする。

    リテラル値を指定する場合、デフォルトでは「Accessible (Tagged) PDF」チェックボックスが選択されます。このチェックボックスを選択すると、アクセス可能な PDF フォームがレンダリングされます。アクセス可能な PDF フォームをレンダリングしない場合、このチェックボックスの選択を解除します。

Linearized PDF

線形化された PDF フォームをレンダリングするかどうかを指定する boolean 値。線形化された PDF フォームは、ネットワーク環境で増分アクセスをサポートするように編成されます。線形化された PDF フォームは Web アプリケーションでの使用に最適です。非線形化 PDF フォームは Web アプリケーション以外での使用に最適です。例えば、線形化された PDF は、PDF ドキュメント全体がダウンロードされる前に、Web ブラウザーで表示できます。

リテラル値を指定する場合、デフォルトでは「Create PDF For Quicker Display In A Browser」チェックボックスが選択されます。このチェックボックスを選択すると、線形化された PDF フォームがレンダリングされます。非線形化 PDF フォームを生成する場合、このチェックボックスの選択を解除します。

Render Options プロパティ

PDF フォームのレンダリングオプションを設定するためのプロパティ。

Cache Form On Server

サーバー上でフォームデザインがキャッシュされるかどうかを指定する boolean 値。サーバー上のフォームのキャッシュによって、サーバー上でレンダリングされるフォームのパフォーマンスが向上します。フォームデザインに埋め込まれる処理命令。「Form Rendering Cache Enabled」オプションでは、キャッシュの実行方法が決定されます。管理コンソールの「フォームレンダリングキャッシュが有効です」オプションの設定について詳しくは、「Forms の設定」を参照してください。

リテラル値を指定する場合、デフォルトでは「Better Performance For Templates That Don’t Change Often」チェックボックスが選択されます。このチェックボックスを選択すると、サーバーでフォームデザインにキャッシュがレンダリングされます。フォームのキャッシュが不要な場合は、このチェックボックスの選択を解除します。

Client Cache

クライアント上でレンダリングされた PDF フォームがキャッシュされるかどうかを指定する boolean 値。

リテラル値を指定する場合、デフォルトでは「Cache Form In Web Browser Cache」チェックボックスが選択解除されます。クライアント上でレンダリングされた PDF フォームをキャッシュする場合、このチェックボックスを選択します。キャッシュが不要な場合は、このチェックボックスの選択を解除します。

Generate Server Appearance

PDF フォームの外観がサーバー上で生成されるかどうかを指定する boolean 値。外観にはフィールドのレイアウトや PDF フォームのグラフィカルな要素が含まれます。サーバー上で外観を生成する場合、フォームはサーバー上でレンダリングされ、データにマージされます。レンダリングされた PDF を後続の操作で使用する場合の外観を生成します。例えば、サーバー上のレンダリングされた PDF フォームにデジタル署名を適用する必要がある場合、デジタル署名を適用する前に、サーバー上で外観を生成します。サーバー上で外観が生成されない場合、クライアント上で PDF フォームがレンダリングされるときに Acrobat または Adobe Reader で生成されます。これによって、適用されたデジタル署名が無効になります。

リテラル値を指定する場合、デフォルトでは「Generate Appearances On Server」の選択が解除されます。サーバー上で外観を生成する場合、このチェックボックスを選択します。Acrobat または Adobe Reader で PDF フォームがレンダリングされるときに外観を生成するには、このチェックボックスの選択を解除します。

Stand Alone Rendition

状態情報なしでフォームをレンダリングできるかどうかを指定する boolean 値。状態情報は、送信のためにユーザーによるサーバーとのやりとりが必要なインタラクティブなフォームのレンダリングに使用されます。状態情報付きで PDF フォームをレンダリングする場合、JavaScript と一緒にレンダリングされます。オフラインでフォームを使用できるようになります。

リテラル値を指定する場合、デフォルトでは「Render Without State Information」チェックボックスが選択されます。

  • このチェックボックスを選択すると、状態情報および埋め込み JavaScript 付きで PDF フォームがレンダリングされます。JavaScript コードは、サーバーとやりとりすることなくクライアント上で実行されます。また、フォームはオフラインで使用できます。

  • このチェックボックスの選択を解除すると、状態情報および埋め込み JavaScript なしで PDF フォームがレンダリングされます。Forms サービスでは、サーバー側で計算が実行された後にフォームがレンダリングされ、結果がレンダリングされたフォームに結果が表示されます。Forms サービスとのやりとりが要求されるため、フォームをオフラインにすることはできません。

Render At Client

クライアント側のレンダリング機能を使用して PDF のコンテンツの配信を有効にするかどうかを指定する RenderAtClient 値。クライアント側のレンダリングにより、Forms サービスのパフォーマンスが向上します。レンダリングは Acrobat 7 以降および Adobe Reader 7 以降のユーザーのみに対して実行されます。このプロパティは PDF、PDFForm、または PDFMerge での変換のみに適用されます。

リテラル値を指定する場合、次のいずれかの値を選択します。

Use Server Default
(デフォルト)サーバーで「Render At」設定バージョンを使用して、Forms サービスによってレンダリングされた PDF フォームを開きます。レンダリング位置設定は、管理コンソールで設定されます(Forms 管理ヘルプを参照)。

Use Form Template Default
Forms サービスでは、フォームデザインの設定に基づいてフォームのレンダリングが決定されます。

Yes
動的 PDF フォームが生成され、Acrobat でレンダリングが発生します。レンダリングは Acrobat 7.0 以降でのみ実行されます。

No
静的 PDF フォームが生成されます。クライアントではレンダリングが実行されません。

Target URL

クライアントアプリケーションからデータを受信する Web サービスまたは Java サーブレットへの URL を表す string 値。Web サービスまたは Java サーブレットは、ユーザーがフォームを送信するときにデータを受信します。このオプションで値を設定すると、フォームデザインでターゲット URL がこのプロパティで指定された値に設定されます。このオプションが絶対 URL ではない場合、「Application Web Root」オプションの値と組み合わせて、絶対 URL が構成されます。

Workspace の場合、http://[server name]:[port]/workspace-server/submit の値を入力します。ここで、[server name] は LiveCycle が展開されるサーバー名で、[port] はアプリケーションサーバーがクライアントソフトウェアへの HTTP アクセスを提供するために使用するポートです。サポートされるアプリケーションサーバーのデフォルトのポートは、以下のとおりです。

  • JBoss:8080

  • WebLogic:7001

  • WebSphere:9080

    リテラル値を指定する場合、URI を指定する値を入力します。

Additional Options プロパティ

Forms サービスから追加のレンダリングオプションを使用するためのプロパティ。

XCI URI

レンダリングに使用する XCI ファイルの URI 位置を設定する string 値。ルートが指定されていない場合、このファイルは LiveCycle EAR ファイルが展開される場所にあると想定されます。例えば、JBoss の自動インストールで、[Install folder]/jboss/server/lc_turnkey/svcdata/XMLFormService フォルダー内のデフォルト XCI ファイルを参照できます。[Install folder] は LiveCycle がインストールされる場所です。カスタム XCI ファイルの作成について詳しくは、Designer ヘルプを参照してください。

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

Form Model Processing

フォームに埋め込まれるスクリプトが実行される場所を指定する FormModel 値。

リテラル値を使用する場合、次のいずれかの値を選択します。

Use Form Template Default:

(デフォルト)Forms サービスではフォームデザインをチェックして、クライアントまたはサーバーのどちらでレンダリングするかが決定されます。

Client Side:

フォームがクライアントでレンダリングされます。サーバーで実行するスクリプトを使用しません。この値が選択される場合、サーバーで実行するスクリプトによって LiveCycle サーバーで警告が生成されます。

dt

フォームがサーバーでレンダリングされます。

dt

フォームがサーバーとクライアントの両方でレンダリングされます。

Attachments

PDF フォームと一緒にレンダリングされる添付ファイルを指定する map 値の document 値。リテラル値は使用できません。

Output プロパティ

レンダリングされた PDF フォームを保存するためのプロパティ。

Rendered Form

レンダリングされた PDF フォームを保存するためのプロセスデータモデル内の場所。データタイプは document です。

その他の Outputプロパティ

レンダリングされた PDF フォームおよびフォームのレンダリングの結果を保存するための追加のプロパティ。

Page Count

PDF フォームのページ数を保存するためのプロセスデータモデル内の場所。データタイプは long です。

Locale

レンダリングされた PDF フォームのロケールコードを保存するプロセスデータモデル内の場所。データタイプは string です。

Forms Result

すべての出力結果を組み合わせられた複雑な値で保存するためのプロセスデータモデル内の場所。データタイプは FormsResult です。

Exceptions

この操作によって、PDF フォームのレンダリング中にエラーが発生した場合に RenderFormException 例外がスローされます。