| On this page | |
| Since | 17.5 |
このノードには入力が2本あります。 1番目の入力のワークアイテムに合致する2番目の入力のワークアイテムを検索します。 このノードは、位置(インデックス)または共有アトリビュート値でワークアイテムを合致させることができます。 その後、このノードがその合致したワークアイテムに対して出力するタスクを生成する際に、2番目の入力のワークアイテムのアトリビュートのリストを1番目の入力のワークアイテムにコピーします。 Exclude Unmatched Itemsを有効にすると、2番目の入力のワークアイテムに合致しなかった1番目の入力のワークアイテムが破棄されます。
他の方法としては、2番目の入力を指定せず、単にソースのワークアイテムを変更せずにそのまま通過させるという方法もあります。
パラメータ ¶
Required Cooked Inputs
入力ワークアイテムをこのノードで処理する前にクックする必要があるかどうかを決めます。 アトリビュートをコピーする前に、または、ワークアイテムを右側ブランチから左側ブランチにマッチさせる前に、入力を強制的にクックすることができます。
Never
ワークアイテムが明示的にクックされることはありませんが、このノードに到達する前にクックされる可能性があります。
Before Copying
アトリビュートをコピーする前に必ずワークアイテムがクックされます。 これは、入力のワークアイテムをクックする際に1つ以上の Attributes to Copy が作成される場合に役立ちます。
Before Matching
左右のブランチのワークアイテムをマッチさせる前に必ずワークアイテムがクックされます。 これは、入力のワークアイテムをクックする際に Match Name を使用して指定されたアトリビュートが追加される場合に役立ちます。
Copy Attributes from All Work Items
このトグルを有効にすると、2番目の入力のすべてのワークアイテムのアトリビュートが1番目の入力のそれぞれのワークアイテムにコピーされます。 ワークアイテムが絞られるため、Match Byの条件は使用されません。
Match By
index値(ほぼ位置による合致)またはアトリビュートのどちらで合致させるかどうか。
Match Name
Match By を“Attribute”に設定した時の、ワークアイテムのマッチングに使用するアトリビュートの名前(2番目の入力のワークアイテムは、このアトリビュートと同じ値を持つ1番目の入力のワークアイテムに合致します)。
Match Type
Match By を“Attribute”に設定した時の、ワークアイテムのマッチングに使用するアトリビュートのタイプ(Integer, Float, String)。
Excluded Unmatched Items
これを有効にすると、1番目の入力のワークアイテムの内、合致したワークアイテムのみが出力に渡されます。 2番目の入力のワークアイテムに合致しなかったワークアイテムは除外されます(これらのワークアイテムは2番目の入力から決して渡されません)。
Copy Operation
Determines how attribute values should be copied in the case that an existing attribute exists with the same name. Attributes will always be copied if there is no name conflict.
Keep Exisiting Value
The existing attribute’s value and type are preserved.
Overwrite value and Type
The existing attribute’s value is overwritten even if its type doesn’t match the source attribute.
Overwrite Value
The existing attribute’s value is overwritten only if its type matches the source attribure.
Append
The source value is appended to the end of the existing attribute.
Prepend
The source value is prepended to the beginning of the existing attribute.
Update
The source value is copied over top of the existing value in-place. If the attribute is an array, and the incoming source value is shorter than the original array, the remaining original values from the existing array are kept.
Attributes to Copy
2番目の入力のワークアイテムから1番目の入力のワークアイテムにコピーするアトリビュートを表現した名前/パターンをスペースで区切ったリスト。
デフォルトは*です(すべてのアトリビュートをコピーします)。
例えば、ここにfoo bar bazを設定すると、それら3つのアトリビュートのみがコピーされ、file_*を設定すると、file_で始まる名前のアトリビュートのみがコピーされます。
詳細は、アトリビュートのパターン構文のドキュメントを参照してください。
Copy Output Files
ソースアイテムからターゲットアイテムへコピーしたいファイル(あれば)を決めます。
None
ソースアイテムから何も出力ファイルはコピーされません。
Real Outputs Only
ディスク上に既に見つかった具体的な出力ファイルのみがソースアイテムからコピーされます。
Real and Expected Outputs
まだ解決されていないキャッシュパスを含むすべての出力ファイルがソースアイテムからコピーされます。
Examples ¶
CopyAttributes Example for Attribute Copy TOP node
このサンプルでは、あるワークアイテムのアトリビュートを他のワークアイテムにコピーする方法を説明しています。
| See also |
Attribute Create
Attribute Delete
