XPathString - XPathによる値の取得

入力のXMLからXPathを使用して値を取得します。

■ストリーム情報

入力フォーマットXML
接続数1
出力フォーマットXML
説明 入力ストリームをそのまま出力します。

■コンポーネントプロパティ

名前プロパティ型マッピング説明
XPathcategory入力&出力 値を取得するためのXPath式を記述します。XPath式は、XPath式エディタを使ってXMLのツリーからの選択により自動生成したXPathをプロパティに指定することができます。詳細については下記トピック「XPath式エディタ」を参照してください。また、XPath式は自動的にストリーム変数になります。本コンポーネントの後に連結したマッパーで、ストリーム変数として見えるようになっています。ストリーム変数については、「はじめに」-「詳細なトピック」-「フローの構成要素」-「変数」-「ストリーム変数」を参照してください。
フィールド名
マッパーで参照するためのフィールド名
XPath式
XPath式
式の中ではフロー変数などの各種変数が使用できます。
名前空間は入力のXMLストリームの名前空間定義によって解決されます。
データ型
出力する値のデータ型。
XPath式の返り値は文字列で取得されます。
その文字列が指定のデータ型に変換できない場合はエラーになります。

■トランザクション処理

コミット何もしません。
ロールバック何もしません。

■エラー処理

タイプパラメーターエラー処理フロー
へのストリーム
エラー
コード
説明
汎用 なし コンポーネントの入力ストリーム なし XPath式が不正な場合
なし XPath式の返り値が指定のデータ型に変換できない場合

■変数の使用

XPath式の中ではフロー変数とシステム変数が使用できます。
(外部変数セットは使用することができません。)

フロー変数$flow.<フロー変数名>
システム変数$system.<システム変数名>(英語名)

■XPath式エディタ

XPath式エディタはプロパティ値にXPathを指定する場合にその入力をサポートするためのエディタです。ツリーからノードを選択してそこまでのXPathをプロパティに設定することができます。
XPathを指定するフィールドの右にある「...」をクリックすると起動します。

ツリー

ツリーにはXPathの対象となるストリームのフィールド定義が表示されます。例えば、XPathNodesetコンポーネントでは入力ストリームがXPathの対象となり、そのフィールド定義が表示されます。コンポーネントの入力側にリンクが繋がっていない場合、入力ストリームにフィールド定義がされていない場合は初期状態では何も表示されません。

「サンプル参照」ボタン

任意のXMLを読み込み、その構造をツリーに表示させることができます。また、ツリーで選択したノードの値(属性値または要素内容)が値タブに表示され、それを条件式の指定に利用することができます。

  1. 「サンプル参照」ボタンをクリックして表示される「開く」ダイアログボックスから読み込むXMLを選択します。
  2. XMLの構造が解析されてツリーに表示されます。

「サンプルをxfpに保存する」チェックボックス

サンプル参照からXMLを読み込んでいる場合、「サンプルをxfpに保存する」チェックボックスをオンにすると、読み込んだXMLがxfpファイル(プロジェクトファイル)に保存され、次回にxfpファイルを開いた場合同じXMLを参照することができます。チェックボックスがオフの場合、読み込んだXMLはエディタを保存されません。次回に使用したい場合は再度「サンプル参照」ボタンから読み込みます。

注意:サンプルXMLはコンポーネントの実行に必要な情報ではありません。ファイルサイズの大きなXMLを保存するとxfpファイル(プロジェクトファイル)のファイルサイズが大きくなり、保存やコンパイルにかかる時間も増えるため開発やテストの段階のみ保存するようにしてください。

XPathの設定

ツリーでノードを選択すると、そのXPathが「選択パス」欄に表示されます。「選択パスをXPathにコピー」のボタンを押すとそのパスが「XPath」欄にコピーされます。 「XPath」欄は編集可能なテキストフィールドで、複雑なXPathを指定する場合はそこに直接記述することができます。

変数を条件式に設定する

フロー変数やローカル変数などコンポーネントで使用可能な変数は変数タブにリストされています。
ツリーで選択したパスがXPathの一部を構成する場合は「選択パスへの条件とする」ボタンで変数との比較をXPathに追加することができます。

XPath/School/Class/Student
選択パス/School/Class/@name
変数$flow.var1
条件追加後のXPath/School/Class[@name=$flow.var1]/Student

選択パス「/School/Class/@name」はXPathで指定されている「/School/Class/Student」の上位に存在するので、条件式として設定することができます。 選択パスが「/School/Class/Teacher/@name」のようにXPathとは別のパスを指している場合は「選択パスへの条件とする」ボタンは無効となります。

値を条件式に設定する

サンプルXMLを参照している場合は選択パスに実際に設定されている値が値タブにリストされています。 ツリーでの選択パスがXPathの一部を構成する場合は「選択パスへの条件とする」ボタンで値との比較をXPathに追加することができます。

XPath/School/Class/Student
選択パス/School/Class/@name
1組
条件追加後のXPath/School/Class[@name="1組"]/Student

条件追加が可能なルールは変数の場合と同じです。