入力のXMLからXPathで部分木を取得して出力します。
入力 | フォーマット | XML |
---|---|---|
接続数 | 1 | |
出力 | フォーマット | XML |
名前 | プロパティ型 | マッピング | 説明 |
---|---|---|---|
XPath式 | xpath | 入力&出力 |
部分木を取得するためのXPath式を記述します。
式の中ではフロー変数などの各種変数が使用できます。 名前空間は入力のXMLストリームの名前空間定義によって解決されます。 XPath式 は、XPath式エディタを使ってXMLのツリーからの選択により自動生成したXPathをプロパティに指定することができます。詳細については下記トピック「XPath式エディタ」を参照してください。 |
XPath式の結果が複数の要素となった場合、それぞれがループで出力されます。
<Corp name="Inforteria"> <Section>営業部</Section> <Section>開発部</Section> </Corp> |
上のような入力XMLに「/Corp/Section」という式を適用した場合、
<Section>営業部</Section> |
<Section>開発部</Section> |
という2つのXMLがループで出力されます。
コミット | 何もしません。 |
---|---|
ロールバック | 何もしません。 |
タイプ | パラメーター | エラー処理フロー
へのストリーム | エラー
コード | 説明 |
---|---|---|---|---|
汎用 | なし | コンポーネントの入力ストリーム | なし | XPath式が不正な場合 |
なし | XPath式の返り値が要素以外だった場合 |
XPath式の中ではフロー変数とシステム変数が使用できます。
(外部変数セットは使用することができません。)
フロー変数 | $flow.<フロー変数名> |
---|---|
システム変数 | $system.<システム変数名>(英語名) |
出力のXMLの文書要素には入力のXMLにおいてその要素で有効だった名前空間宣言がコピーされます。
XPath式エディタはプロパティ値にXPathを指定する場合にその入力をサポートするためのエディタです。ツリーからノードを選択してそこまでのXPathをプロパティに設定することができます。
XPathを指定するフィールドの右にある「...」をクリックすると起動します。
ツリーにはXPathの対象となるストリームのフィールド定義が表示されます。例えば、XPathNodesetコンポーネントでは入力ストリームがXPathの対象となり、そのフィールド定義が表示されます。コンポーネントの入力側にリンクが繋がっていない場合、入力ストリームにフィールド定義がされていない場合は初期状態では何も表示されません。
任意のXMLを読み込み、その構造をツリーに表示させることができます。また、ツリーで選択したノードの値(属性値または要素内容)が値タブに表示され、それを条件式の指定に利用することができます。
サンプル参照からXMLを読み込んでいる場合、「サンプルをxfpに保存する」チェックボックスをオンにすると、読み込んだXMLがxfpファイル(プロジェクトファイル)に保存され、次回にxfpファイルを開いた場合同じXMLを参照することができます。チェックボックスがオフの場合、読み込んだXMLはエディタを保存されません。次回に使用したい場合は再度「サンプル参照」ボタンから読み込みます。
注意:サンプルXMLはコンポーネントの実行に必要な情報ではありません。ファイルサイズの大きなXMLを保存するとxfpファイル(プロジェクトファイル)のファイルサイズが大きくなり、保存やコンパイルにかかる時間も増えるため開発やテストの段階のみ保存するようにしてください。
ツリーでノードを選択すると、その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 |
条件追加が可能なルールは変数の場合と同じです。