Look Up Context Variable アサーション

Look Up Context Variable アサーションは、コンテキスト変数の値を動的に調べ、その値を別のコンテキスト変数に格納するために使用されます。表現を指定します。その表現には、1 つ以上のコンテキスト変数と静的テキストを含めることができます。実行時に、その表現が解決され、その値は別のコンテキスト変数に配置されます。その変数はポリシーで使用できます。
gateway90
Look Up Context Variable
アサーションは、コンテキスト変数の値を動的に調べ、その値を別のコンテキスト変数に格納するために使用されます。表現を指定します。その表現には、1 つ以上のコンテキスト変数と静的テキストを含めることができます。実行時に、その表現が解決され、その値は別のコンテキスト変数に配置されます。その変数はポリシーで使用できます。
例:
以下の変数と値について検討します。
  • foo =
    bar
  • ingredient =
    chocolate
  • chocolate.bar =
    goodness
Look Up Context Variable アサーションで、以下の表現を入力します。
${
ingredient
}.${
foo
}
デフォルトのプレフィックス
lookup
はそのまま使用します。
上記の表現は
chocolate.bar
になり、その変数がアサーションによって検索される変数になります。変数 chocolate.bar には値「goodness」が含まれているため、これの値がアサーションの変数
lookup.output
に配置されます。その後、ポリシー内の他の場所で ${
lookup
.
output
} を参照して、その値「goodness」を取得できます。
このアサーションによって作成されるコンテキスト変数
Look Up Context Variable アサーションでは、以下のコンテキスト変数が設定されます。
デフォルトの <
prefix
> は「lookup」で、アサーション プロパティで変更できます。
変数
説明
<
prefix
>.
found
表現が見つかった場合は true、それ以外は false に設定されます。
<
prefix
>.
multivalued
表現で見つかった値が複数値の場合は true に設定されます。値が複数値ではない場合または表現が見つからなかった場合は false に設定されます。
<
prefix
>.
output
表現の値が設定されます。この変数に入力される値の詳細については、このトピックの概要での例を参照してください。
アサーションの使用
  1. 以下のいずれかを実行します。
    • アサーションをポリシー作成ウィンドウに追加するには、「アサーションの追加」を参照してください。
    • 既存のアサーションの設定を変更するには、下記の手順 2 に進みます。
  2. このアサーションを追加する場合は、[
    Look Up Context Variable Properties
    ]ダイアログ ボックスが自動的に表示されます。アサーションを変更する場合は、ポリシー ウィンドウで[
    <
    target
    >: Look Up Context Variable
    ]を右クリックして[
    Look Up Context Variable Properties
    ]を選択するか、ポリシー ウィンドウでアサーションをダブルクリックします。このアサーションのプロパティが表示されます。 
  3. 以下のようにプロパティを設定します。
    設定
    説明
    Expression
    評価するソース コンテキスト変数を指定します。複数の変数を入力できますが、以下の制限事項に注意してください。
    • ネストしているコンテキスト変数はサポートされていません(例: ${
      foo
      .${
      bar
      }})。
    • すべての変数は同じレベルである必要があります(例: ${
      foo
      }.${
      bar
      })。
    複数値コンテキスト変数を参照する場合、インデックスを使用して単一値を抽出できます。詳細については、「展開時のインデックス オプション」を参照してください。
    Fail if not found
    このチェック ボックスをオンにすると、[Expression]内で使用している変数が存在しない場合にアサーションが失敗します。これがデフォルトの設定です。
    このチェック ボックスをオフにすると、変数が見つからない場合にアサーションは失敗しません。
    Target Data Type
    返されるターゲット値のデータ タイプ(
    String
    Date/Time
    X.509 Certificate
    XML Element
    Message
    のいずれか)を選択します。
    Target Variable Prefix
    このアサーションによって作成されるコンテキスト変数に追加するプレフィックスを入力します。このプレフィックスは、一意性を確保し、このアサーションのインスタンスがポリシー内に複数存在する場合に変数が互いに上書きされることを防ぎます。
    デフォルトの変数プレフィックスは lookup です。
    表示される検証メッセージの説明については、「コンテキスト変数の検証」を参照してください。
  4. 完了したら、[
    OK
    ]をクリックします。