Search

条件エディタの使用

Version 25.3.9469

条件エディタの使用

条件マッピングエディタでは、宛先ノードに条件を追加して、その条件がtrue の場合にのみ出力ドキュメントに要素を含めることができます。条件エディタを使用すると、ソースの値に基づいて宛先ノードの値を設定することもできます。個々のルールやルールのグループを追加し、条件が満たされた場合にマッピングが実行するアクションを指定することで、複雑な条件を構築できます。

エディタを開くには、宛先ドキュメント内のノードにマウスを移動し、フィルタfilterアイコンをクリックします。

条件に名前を付け、ルールを追加またはグループを追加をクリックします。

ルールを作成するときは、ドロップダウンを使用して選択します。以下から選択できます：

  • 入力XML
    • 値：評価対象のXPath にある値
    • データ型：値のデータ型（文字列、数値、日時）
  • メッセージヘッダー
    • 値：評価対象のメッセージヘッダーの値。
    • データ型：値のデータ型（文字列、数値、日時）
    • 出現回数：ドキュメント内でXPath が出現する回数
    • インデックス：評価中のForeach ループの現在の反復回数を表すインデックス
  • 変数
    • 値：評価対象の変数の値。
    • データ型：値のデータ型（文字列、数値、日時）

条件にXPath を選択すると、エディタにドキュメントのツリー表示が現れるので、次の画像のように必要なXPath を簡単に見つけることができます。

ルールやグループは並べ替えが可能です。ハンドルhandleをクリックし、オブジェクトを新しい位置にドラッグします。

条件の定義が完了したら、演算子の右側にあるテキストボックスに、条件が満たされた場合に実行される動作を指定します。

以下からステータスを選択します：

  • Success
  • Warning
  • Error

通知を送信にチェックを入れ、宛先と件名フィールドを入力して、条件のステータスに関するE メールを送信します。

Note：アラートを設定をクリックして新しいブラウザタブを開き、設定ページのアラートタブでE メール設定を設定できます。これらの設定が正しく行われていない場合、E メール通知は送信されません。

最後に、テキストボックスのElse セクションを使用して、条件が満たされない場合に実行する動作を指定します。

Else, Set Action to ドロップダウンから、以下のいずれかを選択します：

  • マッピングから完全に要素を除外する
  • 値をマップで値をマッピングする
  • 異なる値を割り当てるで別の値を割り当てる（条件保存後に式またはカスタムスクリプトとして定義されます）

ステータスおよび通知オプションは、上部のセクションと同様に機能します。

条件を保存すると、マッピングエディタに表示され、マッピング内の他のリーフノードと同じように動作します。ソース側から要素をドラッグ＆ドロップしたり、式やカスタムスクリプトを記述したりすることも可能です。

条件付きロジックは、先読み構文を使用して実現することもできます。親要素は、親要素内の値にコンテキストを提供する子要素によって修飾されることがよくあります。このような場合、不要な値を除外するために複数の条件を作成するよりも、先読み構文を使用する方が簡単な場合があります。先読み構文の使い方について、詳しくはLookahead を参照してください。

スクリプトモード

右上隅のスクリプトモード トグルをオンにすることで、ArcScript 構文を使用してカスタム条件を指定できます。

マッピング条件のスクリプトモード

スクリプトモードをON にしたら、ウィンドウにカスタム条件を記述し、上記と同じようにページの右側で以下の操作を行います：

  • メッセージのステータスを設定する
  • 通知を送信する
  • マッピングに Else 条件を追加し、条件が満たされない場合にマッピングから要素を除外する

Notes：

  • エディタは、入力中に条件を検証します。無効な条件というメッセージが表示された場合は、構文に何らかの問題があるため解決が必要です。
  • デザイナでレンダリングできないArcScript 条件を作成した場合、デザイナモードに戻ると、Arc はデザイナモードでこの設定をレンダリングできないという警告が表示されます。デザイナモードに切り替えると、既存の設定の変更はすべて失われます。

カスタム条件エディタの一般的な使用法の1つは、ソースドキュメントの2つの動的な値を比較することです（1つの動的な値を静的な値と比較するのではなく）。

例えば、次のカスタム条件を使用すると、ソースXML 内の2つの値が等しいかどうかを確認できます：

'[xpath(element1)]' == '[xpath(data/element2)]'

Note：上の例にある一重引用符は必須です。

次の例のように、ArcScript フォーマッタを使用して、カスタム条件でブール論理を実行することもできます：

[xpath(element1) | equals([xpath(data/element2])])]

この構文では、一重引用符は必要ないことにご注意ください。

ArcScript のすべてのフォーマッタの詳細については、フォーマッタを参照してください。