必要情報
| 項目名 | 入力条件 | 詳細 |
|---|---|---|
表示名 |
必須 |
タスクを識別するための名称を入力 |
接続情報 |
必須 |
接続情報画面で設定した、BOXへの接続情報を選択 |
| ユーザーID | 任意 |
jwt_auth で特定ユーザーの権限で操作する場合のみ入力※ oauth やサービスアカウント権限で操作する場合は空欄 |
| ファイルとして再帰的に取り込む | 任意 | データをファイル形式で取り込みたい場合はチェック |
| フォーマット | 必須 | フォーマットを選択 (CSV、TSV、JSON Lines、Json Array) |
| エンコーディング | 必須 | 文字エンコーディングを選択 (UTF-8、Shift_JIS) |
| 参照方法指定 | 必須 | ファイル参照方法を選択 (ファイルパス、ファイルID) |
| ファイルパス/ファイルID | 必須 | 読み込み元の情報を指定 - ファイルパス: .csv や .jsonl などの拡張子まで含めて入力 - ファイルID: 対象ファイルの個別IDを入力 |
| ファイル名をフィールドとして取り込む | 任意 | ファイル名をフィールドとして取り込む場合はチェック |
ファイルとして再帰的に取り込むをチェックした場合
項目名 |
入力条件 |
詳細 |
|---|---|---|
| 参照方法指定 | 必須 | ファイル参照方法を選択 (パス、フォルダID) |
| パス/フォルダID | 必須 | 読み込み元の情報を指定 - パス:対象フォルダパスを入力 - フォルダID: 対象フォルダのIDを入力 |
操作方法
ユーザーID(アカウントID)の確認方法
jwt_auth 利用時に特定ユーザーの権限でアクセスする場合のみ確認します。
- Boxにログインし、画面右上のアカウントアイコンより「アカウント設定」をクリック
- 画面下部の「アカウントの詳細」にあるを「アカウントID」(数字)確認
パス(対象の場所)の指定ルール
取り込み方法(単一ファイルか/フォルダ一括か)と、接続方式によって指定方法が異なります。
| 取り込み方法 | 項目名 |
|
jwt_auth (ユーザーID未指定時) |
|---|---|---|---|
| 📄 単一ファイル (「再帰的取り込み」未チェック) |
ファイルパス | /sample/test.csv ※「すべてのファイル」以下のパス (※下記画像①を参照) |
dir2/input.csv ※共有フォルダからのパス |
| 📁 フォルダごと一括 (「再帰的取り込み」チェックあり) |
パス | /sample/sample2 ※末尾にファイル名は含めない (※下記画像②を参照) |
dir2 ※末尾にファイル名は含めない |
【画像①】 oauth / ユーザーID指定時のファイルパス指定例 |
【画像②】oauth / ユーザーID指定時のフォルダパス指定例 |
💡 間違いやすいポイント
-
パスの先頭に
すべてのファイルやfolderと入力する必要はありません。 -
ブラウザのURLからコピペしないでください(例:
https://.../folder/123456のようなIDを含むパスはエラーになります)。 - フォルダごと取り込む場合、パスの末尾にファイル名を書くとエラーになります。
関連する設定
よくあるエラーと対処法
-
ファイル 〇〇〇 が見つかりませんでした。
- 原因:パスに入力ミスがあるか、拡張子が含まれていません。
-
対処法:「ファイルパス」に
.csvや.jsonlなどの拡張子まで入力できているかご確認ください。
-
フォルダ ID 0 にフォルダ "〇〇〇" が見つかりませんでした。
- 原因: 指定したフォルダへのアクセス権限がないか、パスの指定方法が間違っています。
- 対処法: パスの先頭フォルダに対して、連携しているアカウント(ユーザーまたはサービスアカウント)にアクセス権限が付与されているかご確認ください。
-
The API returned an error code [403 | xxxxxxxxxx] access_denied_insufficient_permissions - Access denied - insufficient permission
- 原因: Boxアプリの接続スコープ(権限)に「書き込み権限」がありません。
-
対処法:ソースBOXの設定であってもデータダウンロード時に一時処理が発生するため「書き込み権限」が必要です。Box接続情報のアプリ設定でスコープをご確認ください