このノードは、入力のCSVファイル内の行毎にワークアイテムを生成します(といっても、 Limit Rows パラメータで行数を制限することができます)。 これは、指定した特定の列のデータを抽出してワークアイテムのアトリビュートにコピーしたり、すべての列を自動的にコピーすることができます。

これは、ユーザが扱いたいワークのリストを指定することができるので便利です。

これと反対のノード(ワークアイテムのアトリビュートをCSVファイルに書き出す)がCSV Outputノードです。

デフォルトでは、このノードに入力ファイルが存在すれば、入力の行毎にワークアイテムが生成されます。 しかし、このノードは何もデータを抽出しません 。 どのようにCSVデータを準備すべきか決定し、そこから抽出したい列を指定する必要があります。

1. CSVデータの取得先を指定します 。以下のどれかで指定します:

   • 入力のワークアイテムのResult DataにCSVファイルが存在する場合は、 Upstream Output Files を選択してください。

     例えば、File Patternノードを使ってファイルのリストを取得した場合、そのFile Patternノードの後にWait for Allノードを追加し、そのWait for Allノードをこのノードに接続してください。 File Patternノードで*.csvファイルにのみ一致するようにさせた場合、そのFile PatternノードのResult Data Tagパラメータをfile/csvに設定します。 最後に、CSV Inputノードの Upstream Output Files を選択します。

   • 静的に 1個の CSVファイルを読み込みたい場合、 Custom File Path を選択して、その静的なCSVファイルのパスを File Path に設定します。

2. 抽出する内容を選択します 。以下のどれかを選択します:

   • それぞれの列からデータを抽出したい場合は、 Columns to Extract マルチパラメータを使って、抽出したい列と使用したいアトリビュート名を指定します。CSVファイルにヘッダ行が含まれている場合は、 Has Header Row を有効にすることで、その行をデータとして使用せずに 無視 することができます。

   • すべての列を抽出したい場合は、 Extract All を有効にします。CSVファイルにヘッダ行が含まれている場合は、 Has Header Row を有効にすることで、そのヘッダ行を 使用 してアトリビュートの名前を付けます。CSVファイルにヘッダ行が含まれていない場合は、このノードはcolumn_0, column_1といったようにアトリビュートの名前を付けます。

   Extract All を使用すると、すべての値が 文字列 として抽出されます。CSVファイル内の数値を適切なタイプで抽出したい場合は、手動で列を抽出してください。

3. ノードでワークアイテムを生成したら、そのアトリビュートをチェックしてみてください。

• 入力ファイルが複数存在する場合(上流のワークアイテムのResult Dataに複数のパスが存在する場合)、このノードは、各ファイルの行毎に別々のワークアイテムを生成します(といっても、 Limit Rows パラメータで行数を制限することができます)。

• レンダーファーム上でネットワークをクックできるようにするには、必ず入力のCSVファイルを共有ネットワークファイルシステムに配置してください。