説明
Box Downloadコンポーネントは、Boxからファイルをダウンロードすることができます。次のようなことができます。
Boxの特定フォルダや特定ファイル名で保存したファイルを定期的にGravioで取得して処理する
・特定フォルダなどに日付付きのファイル名で置かれたCSVなどの売上データや処理ログをBoxからダウンロードしてGravioで処理
フォルダ名は複数階層のフォルダにも対応しています。
・モバイル端末で保存した音声データをBoxにアップロードし、Gravioが定期的にそのファイルをダウンロードしてOpenAIAudioコンポーネントでテキスト化の処理
同様に画像ファイルも取得して、社内に送信することにも対応しています。
| 出力ペイロード | 説明 |
|---|---|
cv.Payload | 出力プロパティでペイロードが指定されている場合はダウンロードしたファイル。ファイル名が指定されている場合は前のコンポーネントの出力ペイロードをそのまま出力します。(パススルー) |
コンポーネントプロパティ
| プロパティー名 | 説明 |
|---|---|
| 出力 | ペイロードまたはファイル |
| 既存ファイルの上書き | 「出力プロパティ」にファイルを指定しており、既存のファイルが存在する場合、「既存ファイルの上書き」がオフの時にはファイル名に番号が追加されます。例「xxx (1).txt」 |
| 指定方法 | ファイルパスとファイル名を指定して検索、フォルダIDとファイル名を指定して検索、ファイルIDを指定して検索 ※2 |
| １番新しいものだけをダウンロード | 検索の結果で複数のファイルが対象になる場合に一番新しいファイルをダウンロードするか、全てをダウンロードするか |
| 取得対象 | 「指定方法プロパティ」にファイルID以外を指定している場合、完全一致、部分一致でBoxファイル名を指定 |
| Boxフォルダパス | 「指定方法プロパティ」にフォルダパスを指定している場合、ダウンロード対象のBoxフォルダパス |
| Boxファイル名 | 「指定方法プロパティ」にファイル名を指定している場合、ダウンロードするBoxファイル名 |
| ファイルID | 「指定方法プロパティ」にファイルIDを指定している場合、ダウンロードするファイルID |
| 今日追加・変更されたファイル | 実行時の当日に追加または更新されたファイルの指定 |
| この時間以降に変更されたファイルを取得 | ダウンロードの基準となる時刻で、指定した時刻以降に変更されたものをダウンロード |
| この時間以前に変更されたファイルを取得 | ダウンロードの基準となる時刻で、指定した時刻以前に変更されたものをダウンロード |
| タイムアウト | HTTPリクエストのレスポンスタイムアウト値 |
| タイムゾーン | 指定する時刻のタイムゾーン |
| OAuth2クライアント ID | BoxからAPI 2.0のClient IDを指定します ※1 |
| OAuth2クライアントシークレット | BoxからClient Secretを指定します ※1 |
| OAuth2リダイレクトURL | BoxからRedirect URLを指定します ※1 |
| OAuth2アクセストークン | トークンを取得ボタンを押して取得します。またトークンを更新ボタンを押して更新することもできます ※1 ※2 |
※1 BoxでのOAuth2の設定例は Box OAuth2 Setup を参照してください
OAuth2アクセストークンの取得方法は OAuth2 Access Token Setup を参照してください
※2 「指定方法」プロパティの設定
「指定方法」プロパティで "フォルダパスとファイル名を指定して検索"を選択した場合：
「Boxフォルダパス」プロパティを指定しない場合はすべてのファイル（ルート）が対象になります。
「取得対象」プロパティに "部分一致"を選択した場合でも「Boxフォルダパス」プロパティは部分一致の対象となりませんので、「Boxフォルダパス」プロパティで指定したフォルダ内のファイル名を部分一致で検索します。
「一番新しいものだけダウンロード」プロパティにチェックしている場合は、検索の結果で検索の結果で複数のファイルが対象になる場合も１番新しいファイルが１つだけダウンロードされます。チェックしていない場合は、すべてのファイルがダウンロードされます。
「Boxファイル名」プロパティを指定しない場合は、「Boxフォルダパス」プロパティで指定したフォルダ内のファイルが対象になります（サブフォルダを除く）。
「Boxファイル名」プロパティを指定した場合は「取得対象」プロパティの一致条件による検索条件にマッチしたファイルだけダウンロードされます。
「指定方法」プロパティで "フォルダIDとファイル名を指定して検索"を選択した場合：
「フォルダID」プロパティを指定しない場合はすべてのファイル（ルート）が対象になります。
フォルダIDはBox内でフォルダに割り当てられているユニークな番号です。
「Boxファイル名」プロパティを指定しない場合は、「フォルダID」プロパティで指定したフォルダ内のファイルが対象になります（サブフォルダを除く）。
「一番新しいものだけダウンロード」プロパティにチェックしている場合は、検索の結果で検索の結果で複数のファイルが対象になる場合も１番新しいファイルが１つだけダウンロードされます。チェックしていない場合は、すべてのファイルがダウンロードされます。
「Boxファイル名」プロパティを指定しない場合は、「Boxフォルダパス」プロパティで指定したフォルダ内のファイルが対象になります（サブフォルダを除く）。
「Boxファイル名」プロパティを指定した場合は「取得対象」プロパティの一致条件による検索条件にマッチしたファイルだけダウンロードされます。
「指定方法」プロパティで "ファイルIDを指定"を選択した場合：
「ファイルID」プロパティで指定したファイルIDはファイルに割り当てられているユニークな番号ですので、該当のファイルだけダウンロードされます。
コンポーネント変数
| コンポーネント変数 | 説明 |
|---|---|
| cv.FileID | ファイルID |
| cv.ReadLength | 読込データのバイト数 |
| cv.Filename | 「出力」プロパティがファイル名の場合、ダウンロードしたファイル名 |