★アクションの説明、概要
JobAutoでファイルの内容を読み込み、 変数へ格納する方法について説明します。
「ファイル読み込み」アクションでは、 読み込むファイルと文字コードを指定して、 ファイルの内容をJobAutoの変数へ格納できます。
読み込むファイルには、 JobAutoの変数やシステム値を使用できます。
また、 BOMが付いているUTF-8形式のファイルを読み込む場合は、 文字コードに「utf-8-sig」を指定できます。
★アクションの作成方法
★アクションの設定画面について
アクション設定画面の設定項目について説明します。
１．基本設定
１－１．ファイル
読み込むファイルのパスを指定します。ファイルパスには変数やシステム値を使用できます。システム値の説明はこちら。
１－２．文字コード
読み込むファイルの文字コードを設定します。
読み込むファイルの先頭にBOMが含まれている場合があります。BOM付きUTF-8形式のファイルを読み込む場合は、文字コードに「utf-8-sig」を指定してください。
１－３．ファイルの中身を格納する先
読み込んだファイルの内容を格納する変数を設定します。
２．高度な設定
２－１．文字コード変換失敗を無視する
ファイルを読み込む際に文字コードの変換に失敗しても、エラーとせず処理を続ける場合はチェックを入れます。文字コードの変換失敗をエラーとして扱う場合は、チェックを外します。
２－２．アクション有効
このアクションを無効にする場合は、チェックを外します。
３．エラー発生時の対応
３－１．エラー時の処理
エラーが発生したときの設定を行います。詳細はこちらをご確認ください。
３－２．基点となる条件分岐
エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。
３－３．エラー時にログ出力
エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。
ファイルの内容を読み込んで変数へ格納する場合
テキストファイルなどの内容をJobAutoへ読み込みたい場合は、 「ファイル読み込み」アクションを使用します。
「ファイル」に読み込むファイルを指定し、 「ファイルの中身を格納する先」に 読み込んだ内容を保存するJobAutoの変数を設定します。
変数を使って読み込むファイルを指定する場合
読み込むファイルには、 JobAutoの変数を使用できます。
前の処理で取得したファイルパスを変数へ格納しておけば、 その変数を使用して読み込むファイルを指定できます。
また、システム値を使用して ファイルを指定することもできます。
ファイル読み込み時の文字コードを指定する
「文字コード」で、 読み込むファイルの文字コードを設定します。
ファイルを正常に読み込めない場合や 文字コードに関するエラーが発生する場合は、 実際のファイルの文字コードと JobAutoに設定した文字コードが合っているか確認します。
BOM付きUTF-8ファイルを読み込む場合
読み込むファイルによっては、 BOMと呼ばれる人の目には見えない情報が ファイルの先頭に含まれている場合があります。
BOMが含まれているUTF-8形式のファイルを読み込む場合は、 文字コードに「utf-8-sig」を指定します。
文字コード変換に失敗した場合
高度な設定には 「文字コード変換失敗を無視する」があります。
文字コードの変換に失敗した場合に エラーとして扱う場合は、 この設定のチェックを外します。
「ファイル読み込み」と「CSV読み込み＆行処理」の違い
| アクション | 用途 |
|---|---|
| ファイル読み込み | 指定したファイルの内容を読み込み、 内容を変数へ格納する場合に使用します。 |
| CSV読み込み＆行処理 | CSVの各列を変数へ格納しながら、 CSVデータを行ごとに繰り返し処理する場合に使用します。 |
ファイルの内容を読み込んで変数へ格納したい場合は 「ファイル読み込み」、 CSVのデータを1行ずつ処理したい場合は 「CSV読み込み＆行処理」を使用します。
「ファイル読み込み」と「ファイル書き込み」の違い
| アクション | 用途 |
|---|---|
| ファイル読み込み | ファイルに保存されている内容を JobAutoの変数へ取り込む場合に使用します。 |
| ファイル書き込み | JobAutoで扱っている値を ファイルへ保存する場合に使用します。 |
ファイルを読み込めない場合の確認順序
- 「ファイル」に、 読み込むファイルが正しく指定されているか確認します。
- 変数やシステム値を使用している場合は、 実行時のファイルパスを確認します。
- 「文字コード」が、 実際のファイルの文字コードと合っているか確認します。
- BOM付きUTF-8形式のファイルの場合は、 文字コードに「utf-8-sig」が設定されているか確認します。
- 「ファイルの中身を格納する先」に、 読み込んだ内容を保存する変数が正しく設定されているか確認します。
- 文字コード変換に関するエラーが発生する場合は、 高度な設定の 「文字コード変換失敗を無視する」を確認します。
- 高度な設定の「アクション有効」に チェックが入っているか確認します。
[…] ・ファイル読み込みアクションにおいて、BOMを削除するため、文字コードにutf-8-sigを追加こちらをご覧ください […]