（非推奨）Guides Utilities

注意： 2012 年 3 月 10 日から、アドビでは Adobe® Livecycle® ES のガイド機能を非推奨とします。ガイド機能は、アップグレード目的でのみ使用でき、今後 2 回のメジャーリリースの後で製品から削除されます。

ガイドを作成すると、一部のリソース（ガイドの定義など）がガイドに埋め込まれます。また、リソースは、ローカルまたは LiveCycle サーバーに保存されているアプリケーションアセットへの参照として存在する場合もあります。ガイドにデータは含まれません。また、送信場所および入力の値は、すべての外部環境に適していません。

ほとんどの場合、デフォルトのガイドレンダリングサービスは、Workspace や他の外部環境に使用するガイドを準備するために適しています（Services ビューでは、このデフォルトサービスは Guides (system)/Processes/Render Guide - 2.0 です）。Guide Utilities サービスを使用すると、ガイドをレンダリングするための独自のプロセスを、必要に応じて作成できます。

Guide Utilities の操作を使用すると、ガイドレンダリングに関する次のタスクをプロセスに追加できます。

  • データをガイドの設定に使用できるかどうかを決定する

  • ガイドデータを埋め込むか、リンクに変換する

  • 参照されるコンテンツを、外部からアクセス可能な URL に変換します。

  • HTML ドキュメントまたは他のラッパーの中の値を置き換えるか、外部からアクセス可能な URL に変換します。

  • 送信場所を設定します。

  • 入力値を指定する

  • 参照されるコンテンツを表すパラメーターを作成する

  • 別の設定を使用できる場合、別の設定を指定する

これらの操作の使用方法については、LiveCycle アプリケーションフォルダーにデフォルトで収録されている Guides (system) のプロセスを参照してください。Generate Guide プロセスで使用されているシーケンス、ルーティングおよびプロパティは、独自のプロセスをデザインするのに役立ちます。

Generate Guide プロセスをローカルで確認するには：

  1. File／Get Applications を選択します。

  2. Get Applications ダイアログボックスの「Guides (system)」で「Guides (system)2.0」を選択して「OK」をクリックします。

  3. アプリケーションビューで、「Guides (system)/Guides (system)2.0」の下の「Processes」を展開します。

  4. 「Generate Guide」をダブルクリックすると、プロセスエディターに表示されます。

    Guides Utilities サービスの設定

    ほとんどの場合は、Guide Utilities サービスのデフォルト値で十分です。ただし、必要に応じて以下の値を変更できます。(「サービス設定の編集」を参照)。

    publicPaths（非推奨）

    このオプションは非推奨になりました。LiveCycle 10 ではこのオプションは使用しません。

    クライアントの権限に関係なく、クライアントが常にアクセスできるパスをカンマで区切ったリストです。これらのパスは、常にアプリケーションフォルダーへのパスであり、接頭辞 repository: が必要です。

    デフォルトの値は次のとおりです。

    repository:/Applications/Guides (system)/1.0/Runtime/dino bundle.swf, 
repository:/Applications/Guides (system)/1.0/Runtime/workspace_interface.swf, 
repository:/Applications/Guides (system)/1.0/Runtime/dccontainer_bundle.swf, 
repository:/Applications/Guides (system)/1.0/Runtime/dccontainer_bundle-debug.swf, 
repository:/Applications/Guides (system)/1.0/Runtime/default-bundles.xml
    注意： デフォルト値にはスペースや改行は含まれません。

    pathInfoExpiryInSeconds

    クライアントからのパス情報の要求が失効するまでの時間の長さです。デフォルトは 1 です。

    collateralExpiryInSeconds

    クライアントからのコラテラルの要求が失効するまでの時間の長さです。デフォルトは 315576000 です。

    mismatchExpiryInSeconds

    eTag（エンティティタグ）が一致しない場合に、クライアントからのコラテラルの要求が失効するまでの時間の長さです（eTag は HTTP 応答ヘッダーです）。デフォルトは 1 です。

    guideContent

    ガイド Web アプリケーションのコンテキストルートです。ガイド Web アプリケーションを使用して設定された値に一致します。デフォルト値は /guides/ です。

    secureRandomAlgorithm

    キーと識別子を生成するときに使用するアルゴリズムです。この値は、SecureRandom Java クラスの getInstance メソッドに渡されます。デフォルトは SHA1PRNG です。

    idBytes

    キー識別子に使用するランダムバイトの数です。デフォルトは 6 です。

    macAlgorithm

    コラテラル URL の検証に使用する MAC（message authentication code）アルゴリズムです。このメソッドは、Mac クラスの getInstance メソッドに渡されます。デフォルトは HmacSHA1 です。

    macRefreshIntervalInMinutes

    キーがアクティブである時間の長さです。キーがアクティブになってこの時間が経過すると、新しいキーが生成されます。新しいキーがアクティブキーになります。以前のアクティブキーは、10% の更新間隔で保持されます。この動作によって、古いキーを使用して生成された URL はキーが切り替わっても引き続き機能します。デフォルトは 144000 です。

    （非推奨）「Retrieve HTML data from Guide render」操作

    レンダリングされたガイドからデータを抽出します。

    Input プロパティ

    データが埋め込まれた HTML ドキュメントを指定するためのプロパティです。

    HTML Document

    データが埋め込まれた HTML ドキュメントを表す document 値。

    Output プロパティ

    抽出されたデータを指定するためのプロパティです。

    Extracted data

    HTML ドキュメントから抽出されたデータを指定する document 値。

    （非推奨）「Document Is Null」操作

    ガイドに表示するデータがあるかどうかを検査します。

    この操作と条件付きルーティングを使用すると、データを必要に応じて検出して処理することができます。例えば、データが存在する場合は、そのデータに対応するパラメーターを作成してデータを埋め込む操作にプロセスをルーティングします（（非推奨）「Update Source Parameter」操作および（非推奨）「Embed Content」操作を参照）。

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

    Input プロパティ

    検査するデータを指定するためのプロパティです。

    Document

    検査するデータを指定する document 値。

    Output プロパティ

    入力データが空（ヌルまたは 0 バイト）かどうかの検査の結果を指定するためのプロパティです。

    Result

    入力ドキュメントが空かどうかを示す boolean 値。

    変数を指定する場合は、Result リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Embed Content」操作

    指定されたコンテンツをガイドに埋め込みます。例えば、ガイドへの表示に使用されるコンテンツを埋め込むことができます。

    埋め込むコンテンツを指定するには、Update Source Parameter 操作を使用して、コンテンツを表すパラメーターを作成します（（非推奨）「Update Source Parameter」操作を参照）。

    代わりに、コンテンツへの参照を作成することもできます（（非推奨）「Link Content」操作を参照）。

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

    Input プロパティ

    ガイドおよびガイドに埋め込むコンテンツを指定するためのプロパティです。

    Guide to Embed Content Into

    コンテンツを埋め込むガイドを指定する document 値。

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

    Content to Embed

    埋め込まれるコンテンツを指定する document 値。

    例えば、ガイドへの表示に使用されるデータを埋め込むには、そのデータを表す変数を指定します。

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

    Name of Content

    埋め込まれるコンテンツの名前を指定する string 値。

    リテラル値を指定する場合は、コンテンツの名前を入力します。

    Output プロパティ

    コンテンツが埋め込まれたドキュメントを指定するためのプロパティです。

    Resultant Guide

    （オプション）コンテンツが埋め込まれたガイドを示す document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Link Content」操作

    外部コンテンツへの参照をガイド内に作成します。例えば、ガイドでの表示に使用されるデータへのリンクを作成できます。

    このコンテンツを指定するには、コンテンツを表すパラメーターを、Update Source Parameter 操作を使用して作成します（（非推奨）「Update Source Parameter」操作を参照）。

    代わりに、コンテンツをガイドに埋め込むこともできます（（非推奨）「Embed Content」操作を参照）。

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

    Input プロパティ

    ガイドと、参照されるコンテンツの場所および名前を指定するためのプロパティです。

    Guide to Reference Content From

    外部リンクを作成するガイドを指定する document 値。

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

    Content to Reference

    string 型の値。コンテンツの場所を指定します。

    リテラル値を指定する場合は、コンテンツの場所を入力します。

    Name of Content

    コンテンツの名前を指定する string 値。

    リテラル値を指定する場合は、コンテンツの名前を入力します。

    Output プロパティ

    リンクを追加するドキュメントを指定するためのプロパティです。

    Resultant Guide

    （オプション）コンテンツを外部リンクに変換済みのガイドを示す document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Resolve Guide」操作

    ガイドを作成し、その中で参照されるコンテンツを外部からアクセス可能な URL に変換します。

    この操作は、ガイドをレンダリングのために読み込むときに使用します。例えば、ガイドレンダリングプロセスの最初のステップとして Resolve Guide を使用します。

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

    Input プロパティ

    解決するガイドを指定するためのプロパティです。

    Guide to Resolve

    解決するガイドの場所を指定する string 値。

    LiveCycle アプリケーションフォルダーとファイル名拡張子 .guide も含めて、フルパスを指定します。パスの例は、/Applications/MyApplication/1.0/NewGuide1.guide です。

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

    Output プロパティ

    リソースがすべて外部パスに解決済みのガイドを指定するためのプロパティです。

    Resultant Guide

    （オプション）解決後のガイドを指定する document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Resolve Text」操作

    指定されたテキストドキュメント内の変数を、指定された値またはリンクで置き換えます。

    テキストドキュメントの例としては、ユーザーが Web ブラウザを使用してガイドにアクセスするための HTML ページがあります。HTML テンプレートで使用されるコンテンツを指定するには、ページコンテンツを表す変数にガイドをマッピングします。

    変数は、 ${ と } で囲まれます。例えば、${varString} は変数 varString を表します。Resolve Text を実行すると、変数のそれぞれについて、その変数名に等しいキーが変数マップ内で検索されます。キーが見つかった場合は、対応する値が代入されます。キーが見つからない場合は、その変数名は LiveCycle アプリケーションフォルダーへの参照を表すと見なされます。変数の内容を取得するための外部 URL が代入されます。

    Resolve Text 操作では、プラス記号（+）またはマイナス記号（-）で開始する変数名は扱いが特殊です。Flex テクノロジを使用して作成された HTML ページでは、多くの場合、SWF ファイルを参照するときに .swf 拡張子を省く必要があります。変数名の先頭に -（マイナス記号）がある場合は、接尾辞が削除されます。変数の最初の文字がマイナス記号（-）でなければならない場合は、変数の先頭にプラス記号（+）を付けます。

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

    Input プロパティ

    テキストドキュメントとその文字セット、およびドキュメント変数に代入する値を指定するためのプロパティです。

    Text-based Document to Resolve

    解決するドキュメントの場所を指定する string 値。

    LiveCycle アプリケーションフォルダーとファイル名拡張子 .html も含めて、フルパスを指定します。パスの例は /Applications/MyApplication/1.0/MyHTMLwrapper.html です。

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

    Character Set

    ドキュメントの文字セットを指定する string 値。

    リテラル値を指定する場合は、文字セットの名前を入力します。

    Additional Variables to Substitute

    （オプション）ドキュメント内の変数を置き換える値を指定する map 値。

    Output プロパティ

    変数が解決されたテキストドキュメントを指定するためのプロパティです。

    Resultant Text-based Document

    （オプション）解決されたテキストベースドキュメントを指定する document 値。

    変数を指定する場合は、Resultant Text-based Document リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Update Sink Parameter」操作

    ガイドの送信場所を指定するパラメーターを更新または追加します。

    例えば、ガイド内の最初の Sink 要素のパラメーター targetUrl を、Workspace 送信 URL に設定します。

    同じ名前のパラメーターが存在する場合は、そのパラメーターが新しい値で更新されます。パラメーターが存在しない場合は、指定した名前と値の新しいパラメーターがパラメーターリストの末尾に追加されます。

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

    Input プロパティ

    更新するガイドと sink パラメーター、およびパラメーター値を指定するためのプロパティです。

    Guide to Update

    更新するガイドを指定する document 値。

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

    Sink ID

    （オプション）更新する sink 要素の識別子を指定する string 値。値を指定しない場合は、最初の sink エントリが更新されます。

    ほとんどの場合は、1 つのガイドに sink エントリは 1 つだけであり、このプロパティは必要ありません。

    リテラル値を指定する場合は、sink 要素の識別子を指定します。

    Parameter Name

    更新するパラメーターの名前を指定する string 値。

    リテラル値を指定する場合は、パラメーターの名前を入力します。

    Parameter Value

    パラメーターの値を指定する string 値。

    リテラル値を指定する場合は、パラメーターの値を入力します。

    Output プロパティ

    sink パラメーターが更新または追加されたガイドを指定するためのプロパティです。

    Resultant Guide

    （オプション）更新されたガイドを指定する document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Update Input Values」操作

    ガイド内の入力値を更新します。

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

    Input プロパティ

    ガイドと更新する入力、および入力から削除する接頭辞を指定するためのプロパティです。

    Guide to Update

    更新するガイドを指定する document 値。

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

    Inputs to Update

    更新する入力とその新しい値を指定する map 値。

    Prefix to Remove from Input Values

    （オプション）個々の inputValues キーから削除する接頭辞を指定する string 値。この接頭辞は、データ準備プロセスにおいてガイドに関連する値を区別するためのものです。この操作では、更新するパラメーターをキーを使用して特定する前に、接頭辞が削除されます。

    リテラル値を指定する場合は、接頭辞を入力します。

    Output プロパティ

    入力値が更新されたガイドを指定するためのプロパティです。

    Resultant Guide

    （オプション）更新されたガイドを指定する document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Update Source Parameter」操作

    ソースへのパラメーターを更新または追加します。例えば、ガイドに表示するデータを表すパラメーターを追加します。このパラメーターを使用すると、プロセスによってコンテンツを制御することができます。

    同じ名前のパラメーターが存在する場合は、そのパラメーターが新しい値で更新されます。パラメーターが存在しない場合は、指定された名前と値のパラメーターがパラメーターリストの末尾に追加されます。

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

    Input プロパティ

    ガイドと、更新または追加するソースパラメーターおよびパラメーター値を指定するためのプロパティです。

    Guide to Update

    更新するガイドを指定する document 値。

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

    Source ID

    （オプション）更新するソース要素の識別子を指定する string 値。値を指定しない場合は、最初のソースエントリが更新されます。

    最初のソースエントリはプライマリデータソースです。したがって、プライマリデータソースを更新する場合は Source ID の指定は不要です。

    リテラル値を指定する場合は、ソース要素の識別子を入力します。

    Parameter Name

    更新するパラメーターの名前を指定する string 値。

    リテラル値を指定する場合は、パラメーターの名前を入力します。

    Parameter Value

    パラメーターの値を指定する string 値。

    リテラル値を指定する場合は、パラメーターの値を入力します。

    Output プロパティ

    ソースパラメーターが更新または追加されたガイドを指定するためのプロパティです。

    Resultant Guide

    （オプション）更新されたガイドを指定する document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Update Selected Variation」操作

    ガイドに使用するバリエーションを指定します。ガイド内に、variations という名前の特別な選択リストがあり、使用できるバリエーションはここに登録されています。

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

    Input プロパティ

    ガイドおよび更新するバリエーションを指定するためのプロパティです。

    Guide to Update

    更新するガイドを指定する document 値。

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

    Variation to Select

    バリエーションを指定する string 値。

    リテラル値を指定する場合は、バリエーションの名前を入力します。

    Output プロパティ

    指定されたバリエーションに合わせて設定されたガイドを指定するためのプロパティです。

    Resultant Guide

    （オプション）更新されたガイドを指定する document 値。

    変数を指定する場合は、Resultant Guide リストから変数を選択します。プラス記号ボタン をクリックすると、変数を作成するための Variable ダイアログボックスが表示されます（変数の作成を参照）。

    （非推奨）「Get Guide Version」操作

    ガイドの作成に使用された Workbench のバージョンを取得します。

    Input プロパティ

    ガイドの作成に使用された Workbench のバージョンを指定するためのプロパティです。

    Guide

    ガイドファイルへのリポジトリパスを指定する document 値。一般的なリポジトリパスは、例えば /Applications/<MyApplication>/1.0/<MyGuide.guide> です。

    Output プロパティ

    ガイドの作成に使用された Workbench のバージョンを指定するためのプロパティです。

    Major Version

    バージョンが 9.1.2.3 の場合は 9 が返され、バージョンが存在しない場合は 0 が返される int 値。

    Minor Version

    バージョンが 9.1.2.3 の場合は 1 が返され、バージョンが存在しない場合は 0 が返される int 値。

    Release Version

    バージョンが 9.1.2.3 の場合は 2 が返され、バージョンが存在しない場合は 0 が返される int 値。

    Mini Version

    バージョンが 9.1.2.3 の場合は 3 が返され、バージョンが存在しない場合は 0 が返される int 値。

    （非推奨）「Invoke the generate Guide process」操作

    ガイド生成プロセスを起動します。

    Input プロパティ

    ガイドの作成に使用された Workbench のバージョンを指定するためのプロパティです。

    Process Version

    使用するガイド生成プロセスのバージョンを指定する string 値。

    Guide data

    document 型の値。ガイドの初期データを保持します。データ構造は、そのガイドが基づいているデータモデルの構造に対応します。

    Guide path

    string 型の値。リポジトリ内のガイドの場所を指定します。

    Guide runtime

    string 型の値。ガイドランタイムへのリポジトリパスを指定します。デフォルトは dccontainer_bundle.swf です。署名済み RSL（Runtime Shared Library）を利用するには、dccontainer_bundle-rsl.swf を使用してください。ガイドダウンロードのエクスペリエンスを最適化するには、/<MyApplication>/1.0/<MyRuntime>.swf のような構造を使用してください。

    Input key prefix

    string 型の値。入力値から取り除くプレフィックスを指定します。

    Input map

    string 型の値。入力値から取り除くプレフィックスを指定します。

    Target URL

    string 型の値。送信された XML データを処理するサーブレットの場所を指定します。

    Variation

    string 型の値。プロセス内のステップで使用される、ガイドのビューを指定します。

    XFA Server Calcs

    boolean 型の値。XDP フォームに基づくガイドに対してサーバー計算が実行されるかどうかを示します。

    Output プロパティ

    Guide html wrapper

    document 型の値。ガイドを表示する HTML 出力が格納されます。