必要情報
| 項目名 | 入力条件 | 詳細 |
|---|---|---|
表示名 |
必須 |
タスクを識別するための名称を入力 |
接続情報 |
必須 |
接続情報画面で設定した、BOXへの接続情報を選択 |
| ユーザーID | 任意 | BoxのユーザーIDを指定 未指定時は、Boxアプリに紐づくサービスアカウントが使用されます OAuth認証時は入力不要です |
| ファイルとして再帰的に取り込む | 任意 | データをファイル形式で取り込みたい場合はチェック |
| フォーマット | 必須 | フォーマットを選択 (CSV、TSV、JSON Lines、Json Array) |
| エンコーディング | 必須 | 文字エンコーディングを選択 (UTF-8、Shift_JIS) |
| 参照方法指定 | 必須 | ファイル参照方法を選択 (ファイルパス、ファイルID) |
| ファイルパス/ファイルID/フォルダID | 必須 | 読み込み元の情報を指定 - ファイルパス: .csv や .jsonl などの拡張子まで含めて入力してください - ファイルID: 対象ファイルの個別IDを入力してください - フォルダID: 対象フォルダのIDを入力してください 「ファイルとして再帰的に取り込む」にチェックした場合のみ入力可能です |
| ファイル名をフィールドとして取り込む | 任意 | ファイル名をフィールドとして取り込む場合はチェック |
操作方法
ユーザーID(通常ユーザーの場合)
サービスアカウントを使用する場合はユーザーIDの入力は不要です
1.画面右上のアカウントアイコンより「アカウント設定」をクリック
2.画面下側の「アカウントの詳細」を確認
ファイルパス(通常ユーザーの場合)
ファイルパスは「すべてのファイル」直下のフォルダより指定してください。
画像を例にすると、「/sample/test.csv」が設定値となります。
間違いやすい例
✗ /すべてのファイル/sample/test.csv(/すべてのファイルが不要)
✗ /folder/sample/test.csv(/folderが不要)
✗ /folder/244819055092(URLよりパスをコピーしている) 等
フォルダパス(通常ユーザーの場合)
フォルダパスは「すべてのファイル」直下のフォルダより指定してください。
画像を例にすると、「/sample/sample2」が設定値となります。
ファイルパスではないため、ファイル名の指定をするとエラーとなります。
間違いやすい例
✗ /すべてのファイル/sample/sample2/test.csv(/すべてのファイルと/test.csvが不要)
✗ /folder/sample/sample2/test.csv(/folderと/test.csvが不要)
✗ /folder/244819055092(URLよりパスをコピーしている) 等
ファイルパス/フォルダパス(サービスアカウントの場合)
(例1)dir1/dir2/input.csv というファイルがあり、input.csv だけに権限を付与した場合、input.csvを取得するためのパスの設定は以下のようになります。
input.csv
(例2)dir1/dir2/input.csv で、dir2 に権限を付与した場合、input.csvを取得するためのパスの設定は以下のようになります。
dir2/input.csv
フォルダパスは通常ユーザーと同じく、ファイル名の指定は不要です。
上記のルールに従って、フォルダパスを入力してください。
関連する設定
よくあるエラー
- ファイル 〇〇〇 が見つかりませんでした。
「ファイルパス」に拡張子まで入力できているかご確認ください。 - フォルダ ID 0 にフォルダ "〇〇〇" が見つかりませんでした。
ファイルパスの先頭に入力した「〇〇〇」フォルダに、ユーザー(またはサービスアカウント)のアクセス権限があるかご確認ください。 - The API returned an error code [403 | xxxxxxxxxx] access_denied_insufficient_permissions - Access denied - insufficient permission
接続情報に使用しているアプリのスコープに「書き込み権限」があるかご確認ください。ソースBOXで使用する場合もダウンロードが発生するため書き込み権限が必須になります。