JobAutoでCSVを読み込み行ごとに繰り返し処理する方法

「CSV読み込み&行処理」アクションの概要

JobAutoでCSVファイルを読み込み、 CSV内のデータを行ごとに繰り返し処理する方法について説明します。

「CSV読み込み&行処理」アクションでは、 CSVの各列をJobAutoの変数へ格納しながら、 各行に対して処理を繰り返すことができます。

読み込むファイルの文字コード、 1行目を列名として使用するか、 区切り文字や囲い文字などを設定できます。

また、 CSVのどの列をどのJobAuto変数へ格納するかを 「列名と変数の対比表」で設定できます。

関連するアクションとの違い: CSVの列を変数へ取り込み、行ごとに処理を実行する場合は、この「CSV読み込み&行処理」を使用します。 ファイルの内容を読み込んで1つの変数へ格納したい場合は、 「ファイル読み込み」アクションをご確認ください。 CSVの列の並び替えや不要な列・行の除外を行う場合は、 「CSVの再フォーマット」アクションをご確認ください。


「CSV読み込み&行処理」アクションの作成方法(動画)


「CSV読み込み&行処理」アクションの設定項目

アクション設定画面の設定項目についての説明は以下の通りです。

1.基本設定

1-1.ファイル

読み込むCSVファイルのパスを設定します。ファイルパスには変数やシステム値を使用できます。システム値の説明はこちら。

1-2.文字コード

ファイルの文字コードを設定します。設定した文字コードでファイルを読み込めなかった場合は、エラーとなります。

1-3.1行目を列名とする

CSVの1行目を列名(ヘッダー)として使用し、繰り返し処理の対象から除外する場合はチェックを入れます。作成済みのアクションでこの設定を変更した場合は、「列名と変数の対比表」を再作成してください。

1-4.区切り文字

区切り文字を設定します。

1-5.囲い文字

CSV内の値を囲っている文字を設定します。

1-6.列名と変数の対比表

CSVから取得したデータを列ごとに変数へ格納します。どの列をどの変数へ格納するかをここで定義します。

EZZ列まで繰り返し処理の対象として設定できます。

・+

定義を追加します。

列名を変数に新規作成する
・列名

列を設定します。

・変数名

格納先の変数を設定します。

・ー

定義を削除します。

・列名を変数に登録する

「1行目を列名とする」にチェックを入れている場合、CSVの列名を変数名として登録します。
「対比表を再作成しますか?」というダイアログは表示されません。

列名と変数の対比表作成
・グループ名

列名を新しい変数グループ内に作成します。新しく作成する変数グループ名を設定します。

・変数の識別子

変数を固有に識別するための文字を設定します。


2.高度な設定

2-1.列が存在しない場合はエラーとする

読み込んだCSVファイルに列名と変数の対比表で設定した列がない場合に、エラーとする場合はチェックを入れます。


3.エラー発生時の対応

3-1.エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3.エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。


CSVを1行ずつ繰り返し処理する場合

CSVファイル内のデータを1行ずつ読み込み、 各行に対して同じ処理を行いたい場合は、 「CSV読み込み&行処理」アクションを使用します。

CSVの各列の値は、 「列名と変数の対比表」で設定したJobAutoの変数へ格納されます。

繰り返し処理の中では、 これらの変数を使用して後続のアクションを実行できます。

CSVの1行目をヘッダーとして使用する場合

CSVの1行目に項目名が設定されている場合は、 「1行目を列名とする」にチェックを入れます。

チェックを入れると、 CSVの1行目を列名として使用し、 1行目は繰り返し処理の対象から外れます。

作成済みのアクションで 「1行目を列名とする」の設定を変更した場合は、 「列名と変数の対比表」の設定も確認してください。

CSVの文字コードを指定する場合

「文字コード」で、 読み込むCSVファイルの文字コードを設定します。

設定した文字コードでCSVファイルを読み込めなかった場合は、 エラーとなります。

CSVを読み込めない場合や文字コードに関するエラーが発生する場合は、 実際のCSVファイルの文字コードと、 JobAutoに設定した文字コードが一致しているか確認します。

CSVの区切り文字・囲い文字を指定する場合

CSVの形式に合わせて、 「区切り文字」と「囲い文字」を設定します。

「区切り文字」には、 データの各項目を区切る文字を設定します。

「囲い文字」には、 CSV内の値を囲っている記号を設定します。

CSVの列をJobAutoの変数へ格納する場合

「列名と変数の対比表」では、 CSVのどの列をどのJobAuto変数へ格納するかを設定します。

CSVから取得した値を後続処理で使用する場合は、 必要な列と格納先の変数を対応付けます。

「1行目を列名とする」にチェックを入れている場合は、 CSVの列名を変数名として登録することもできます。

CSVに必要な列が存在しない場合をエラーにする

高度な設定の「列が存在しない場合はエラーとする」に チェックを入れると、 「列名と変数の対比表」で設定した列が 読み込んだCSVファイルに存在しない場合にエラーとなります。

想定した列を持つCSVだけを処理したい場合は、 この設定を確認します。

「CSV読み込み&行処理」と「ファイル読み込み」の違い

アクション用途
CSV読み込み&行処理CSVの各列を変数へ格納しながら、 CSVのデータを行ごとに繰り返し処理する場合に使用します。
ファイル読み込み指定したファイルの内容を読み込み、 その内容を変数へ格納する場合に使用します。

CSVを行ごとに処理したい場合は 「CSV読み込み&行処理」、 ファイルの内容を読み込んで変数へ格納したい場合は 「ファイル読み込み」を使用します。

CSVの読み込みが想定どおり動かない場合の確認順序

  1. 「ファイル」で、 読み込むCSVファイルが正しく指定されているか確認します。
  2. 「文字コード」が、 実際のCSVファイルの文字コードと合っているか確認します。
  3. CSVの1行目がヘッダーの場合は、 「1行目を列名とする」の設定を確認します。
  4. 「区切り文字」と「囲い文字」が、 読み込むCSVの形式に合っているか確認します。
  5. 「列名と変数の対比表」で、 CSVの列とJobAutoの変数が正しく対応付けられているか確認します。
  6. CSVに存在しない列を設定している場合は、 高度な設定の 「列が存在しない場合はエラーとする」も確認します。

関連するファイル操作・FAQ

1件のコメント

  1. […] 関連する操作との違い: CSVの列の並び替えや不要列の除外、行の絞り込みを行って別のCSVとして保存する場合は、この「CSVの再フォーマット」アクションを使用します。 CSVを読み込み、各列の値を変数へ格納しながら行ごとにロボットの処理を実行する場合は、 「CSV読み込み&行処理」アクションをご確認ください。 […]

    返信

コメントを残す

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください。