Filter by Expression TOP node

上流のワークアイテムを条件付きでフィルタリングします。

On this page	パラメータ Examples
Since	17.5

このノードは、上流のワークアイテム毎にエクスプレッションを評価して、そのワークアイテムをフィルタリングするかどうかを決定します。 Operation パラメータを Keep Matched Items に設定することで、合致したワークアイテムが維持されるようにフィルターを反転させることもできます。

Filtering can either use a parameter expression (HScript or Python), or a regular expression. When using a parameter expression the expression result should be 0 to indicate that a work item failed to match against the filter, or 1 to indicate that it did match. When using regex you can choose to match the regex against the input work items' output files, an attribute value on each work item, or a custom string.

パラメータ ¶

Generate When

このノードがワークアイテムを生成するタイミングを決めます。このノードがどの生成モードを必須にしているのか、もしくは、ワークアイテムを動的に生成させる必要があるのかどうか分からないのであれば、通常では、これを“Automatic”のままに設定してください。

All Upstream Items are Generated

このノードは、すべての入力ノードが自身のワークアイテムを生成した時にワークアイテムを生成します。

All Upstream Items are Cooked

このノードは、すべての入力ノードが自身のワークアイテムをクックした時にワークアイテムを生成します。

Each Upstream Item is Cooked

このノードは、入力ノード内のワークアイテムがクックされる度にワークアイテムを生成します。

Automatic

入力ノードの生成モードに基づいて生成モードが選択されます。入力ノードのどれかがその入力のクック時にワークアイテムが生成されている場合、このノードには Each Upstream Item is Cooked が設定されます。そうでない場合、 All Upstream Items are Generated が設定されます。

Operation

このノードが Filter Expression に合致したワークアイテムを削除するのか、または、そのフィルターに合致したワークアイテムを維持するのかを決めます。

Include Output Files

有効にすると、コピーされたワークアイテムには、上流のワークアイテムの出力ファイルが含まれるようになります。

Filter Type

Determines whether the filter is a parameter expression or a regex.

Filter Expression

Filter Type が Parameter Expression に設定されている時、このパラメータは、上流のワークアイテム毎に適用されるエクスプレッションを決定します。その結果が1/trueの場合は、指定した Operation が実行されます。デフォルトでは、その上流のワークアイテムがフィルタリングされます。それ以外の場合は、このノードによってそのワークアイテムがコピーされます。

Extra Expressions

Filter Type が Parameter Expression に設定されている時、 Filter Expression にさらに追加するフィルターエクスプレッションの数を指定します。これらのフィルターエクスプレッションは、上から下に評価されます。つまり、exprがベースの Filter Expression パラメータで、expr#が Extra Expressions の各エントリーとすると、(((expr AND expr1) OR expr2) AND expr3)です。

Expression

Extra Expressions マルチパラメータ内のエントリー毎に、前のエクスプレッション結果(s)にエクスプレッション結果を合わせるのに使用するブール演算(AND, OR)と追加フィルターエクスプレッションを指定します。

Regular Expression

When Filter Type is set to Regular Expression, this parameter specifies the regex to use when filtering work items.

Match Against

When Filter Type is set to Regular Expression, this parameter determines what the Regular Expression should be match with when filtering.

Attribute Name

When Match Against is set to Attribute Value, this parameter determines the name of the work item attribute to match against the Regular Expression.

Custom String

When Match Against is set to Custom Value, this parameter can be set to a value or expression using work item attributes to compare against the Regular Expression string.

Examples ¶

FilterStringAttrib Example for Filter by Expression TOP node

このサンプルでは、Filter by Expression TOPノードでstrcmp HScriptエクスプレッションを使用する方法を説明しています。

FilterWorkItems Example for Filter by Expression TOP node

このサンプルでは、もっと処理やデバッグをしたいワークアイテムを選び出せるように上流ワークアイテムをフィルタリングする方法を説明しています。