★アクションの説明、概要
JobAutoで指定したフォルダ内にある ファイルの数をカウントする方法について説明します。
「ファイルのカウント」アクションでは、 指定したフォルダ内にあるファイルやフォルダの数を取得し、 カウントした結果をJobAutoの変数へ格納できます。
ファイル名に含まれる文字による絞り込みや、 サブフォルダ・隠しファイルを対象に含める設定もできます。
また、 カウント対象を 「ファイルとフォルダ」「ファイルのみ」「フォルダのみ」から 選択できます。
★アクションの作成方法
★アクションの設定画面について
アクション設定画面の設定項目について説明します。
１．基本設定
１－１．ファイルをカウントするフォルダ
カウント対象が格納されているフォルダを指定します。フォルダパスには変数やシステム値を使用できます。システム値の説明はこちら。
１－２．ファイル名に含む文字
ファイル名に指定した文字を含むファイルをカウント対象にする場合に設定します。変数を使用できます。正規表現の「.*」を使った設定もできます。
１－３．ファイル名に含まない文字
ファイル名に指定した文字を含むファイルを、カウント対象から除外する場合に設定します。変数を使用できます。
１－４．サブフォルダも含める
指定したフォルダ配下のサブフォルダ内もカウント対象に含めるか設定します。
・含める
カウント対象に含めます。
・含めない
カウント対象に含めません。
１－５．カウント対象
カウントする対象の種類を設定します。
・ファイルとフォルダ
ファイルとフォルダの両方をカウントします。
・ファイルのみ
ファイルのみをカウントします。
・フォルダのみ
フォルダのみをカウントします。
１－６．隠しファイルも含める
隠しファイルもカウント対象に含めるか設定します。
・含める
カウント対象に含めます。
・含めない
カウント対象に含めません。
１－７．ファイル数の格納先
カウントした結果を格納する変数を設定します。
２．高度な設定
２－１．アクション有効
このアクションを無効にする場合は、チェックを外します。
３．エラー発生時の対応
３－１．エラー時の処理
エラーが発生したときの設定を行います。詳細はこちらをご確認ください。
３－２．基点となる条件分岐
エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。
３－３．エラー時にログ出力
エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。
フォルダ内のファイル数を取得する場合
指定したフォルダ内にファイルが何件あるか取得したい場合は、 「ファイルのカウント」アクションを使用します。
「ファイルをカウントするフォルダ」に 対象となるフォルダを設定し、 「カウント対象」で「ファイルのみ」を選択します。
カウントした結果は、 「ファイル数の格納先」で指定した JobAutoの変数へ格納されます。
ファイル名でカウント対象を絞り込む場合
「ファイル名に含む文字」を設定すると、 指定した文字をファイル名に含むファイルだけを カウント対象にできます。
「ファイル名に含まない文字」を設定すると、 指定した文字をもとに カウント対象からファイルを除外できます。
これらの設定にはJobAutoの変数を使用できます。
「ファイル名に含む文字」では、 正規表現の「.*」を使った設定もできます。
サブフォルダ内もカウントする場合
指定したフォルダの下にある サブフォルダ内もカウント対象にする場合は、 「サブフォルダも含める」で「含める」を選択します。
対象フォルダ直下だけをカウントする場合は、 「含めない」を選択します。
ファイルだけ・フォルダだけをカウントする場合
「カウント対象」では、 何をカウントするかを選択できます。
| 設定 | カウント対象 |
|---|---|
| ファイルとフォルダ | ファイルとフォルダの両方をカウントします。 |
| ファイルのみ | ファイルだけをカウントします。 |
| フォルダのみ | フォルダだけをカウントします。 |
隠しファイルもカウントする場合
隠しファイルもカウント対象にする場合は、 「隠しファイルも含める」で「含める」を選択します。
隠しファイルを対象にしない場合は、 「含めない」を選択します。
カウントしたファイル数を変数へ格納する
「ファイル数の格納先」には、 カウントした結果を保存するJobAutoの変数を設定します。
格納したファイル数は、 後続の条件分岐や処理で使用できます。
「ファイルのカウント」と「ファイルの繰り返し処理」の違い
| アクション | 用途 |
|---|---|
| ファイルのカウント | 指定した条件に一致する ファイルやフォルダの件数を取得する場合に使用します。 |
| ファイルの繰り返し処理 | フォルダ内のファイルを1つずつ取得して、 それぞれに対して同じ処理を行う場合に使用します。 |
件数だけを取得したい場合は 「ファイルのカウント」、 ファイルを1つずつ処理したい場合は 「ファイルの繰り返し処理」を使用します。
ファイル数が想定どおりにならない場合の確認順序
- 「ファイルをカウントするフォルダ」に、 対象となるフォルダが正しく指定されているか確認します。
- 変数やシステム値を使用している場合は、 実行時のフォルダパスを確認します。
- 「ファイル名に含む文字」と 「ファイル名に含まない文字」によって、 対象ファイルが除外されていないか確認します。
- サブフォルダ内も対象にする場合は、 「サブフォルダも含める」の設定を確認します。
- 「カウント対象」が 「ファイルとフォルダ」「ファイルのみ」「フォルダのみ」の 目的に合った設定になっているか確認します。
- 隠しファイルも対象にする場合は、 「隠しファイルも含める」の設定を確認します。
- 「ファイル数の格納先」に、 カウント結果を保存する変数が正しく設定されているか確認します。