Box Downloadコンポーネントは、Boxからファイルをダウンロードすることができます。
次のようなことができます。

Boxの特定フォルダや特定ファイル名で保存したファイルを定期的にGravioで取得して処理する

・特定フォルダなどに日付付きのファイル名で置かれたCSVなどの売上データや処理ログをBoxからダウンロードしてGravioで処理
フォルダ名は複数階層のフォルダにも対応しています。

・モバイル端末で保存した音声データをoxにアップロードし、Gravioが定期的にそのファイルをダウンロードしてOpenAIAudioコンポーネントでテキスト化の処理
同様に画像ファイルも取得して、社内に送信することにも対応しています。

出力ペイロード 説明
cv.Payload 出力プロパティでペイロードが指定されている場合はダウンロードしたファイル。ファイル名が指定されている場合は前のコンポーネントの出力ペイロードをそのまま出力します。(パススルー)

コンポーネントプロパティ

プロパティー名 説明
出力 ペイロードまたはファイル
既存ファイルの上書き 「出力プロパティ」にファイルを指定しており、既存のファイルが存在する場合、「既存ファイルの上書き」がオフの時にはファイル名に番号が追加されます。例「xxx (1).txt」
指定方法 ファイルパスとファイル名を指定して検索、フォルダIDとファイル名を指定して検索、ファイルIDを指定して検索 *2
1番新しいものだけをダウンロード 検索の結果で複数のファイルが対象になる場合に一番新しいファイルをダウンロードするか、全てをダウンロードするか
取得対象 「指定方法プロパティ」にファイル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の設定例は こちら を参照してください

※2 「指定方法」プロパティの設定

「指定方法」プロパティで ”フォルダパスとファイル名を指定して検索”を選択した場合 :

「Boxフォルダパス」プロパティを指定しない場合はすべてのファイル(ルート)が対象になります。

「取得対象」プロパティに ”部分一致”を選択した場合でも「Boxフォルダパス」プロパティは部分一致の対象となりませんので、「Boxフォルダパス」プロパティで指定したフォルダ内のファイル名を部分一致で検索します。

「一番新しいものだけダウンロード」プロパティにチェックしている場合は、検索の結果で検索の結果で複数のファイルが対象になる場合も1番新しいファイルが1つだけダウンロードされます。チェックしていない場合は、すべてのファイルがダウンロードされます。

「Boxファイル名」プロパティを指定しない場合は、「Boxフォルダパス」プロパティで指定したフォルダ内のファイルが対象になります(サブフォルダを除く)。

「Boxファイル名」プロパティを指定した場合は「取得対象」プロパティの一致条件による検索条件にマッチしたファイルだけダウンロードされます。

「指定方法」プロパティで ”フォルダIDとファイル名を指定して検索”を選択した場合 :

「フォルダID」プロパティを指定しない場合はすべてのファイル(ルート)が対象になります。
フォルダIDはBox内でフォルダに割り当てられているユニークな番号です。

「Boxファイル名」プロパティを指定しない場合は、「フォルダID」プロパティで指定したフォルダ内のファイルが対象になります(サブフォルダを除く)。

「一番新しいものだけダウンロード」プロパティにチェックしている場合は、検索の結果で検索の結果で複数のファイルが対象になる場合も1番新しいファイルが1つだけダウンロードされます。チェックしていない場合は、すべてのファイルがダウンロードされます。

「Boxファイル名」プロパティを指定しない場合は、「Boxフォルダパス」プロパティで指定したフォルダ内のファイルが対象になります(サブフォルダを除く)。

「Boxファイル名」プロパティを指定した場合は「取得対象」プロパティの一致条件による検索条件にマッチしたファイルだけダウンロードされます。

「指定方法」プロパティで “ファイルIDを指定“を選択した場合:

「ファイルID」プロパティで指定したファイルIDはファイルに割り当てられているユニークな番号ですので、該当のファイルだけダウンロードされます。

コンポーネント変数

コンポーネント変数 説明
cv. FileID ファイルID
cv. ReadLength 読込データのバイト数
cv. Filename 「出力」プロパティがファイル名の場合、ダウンロードしたファイル名

OAuth2アクセストークンの取得方法

 
※2 OAuth2アクセストークンを取得するボタンを押すとOAuth 2.0 アクセストークンを取得 パネルが表示されます。ブラウザを開く ボタンを押してトークンを取得してください。トークンを取得すると 設定ボタンを押すとOAuth2アクセストークン プロパティに自動的に設定されます。


 
Gravio Studio for Windowsの場合も同様にブラウザを開く ボタンを押してトークンを取得しますが、エラー画面となります。この状態でURLをアドレスバーからコピーして、そのURLをパネルにペースとして取得ボタンを押してください。トークンが取得されますので 設定ボタンを押すとOAuth2アクセストークン プロパティに自動的に設定されます。
 

 
ブラウザを開くボタンを押すと自動的にブラウザで認証が行われます。必要がありましたらログイン処理など画面の指示に合わせて操作してください。
 
 

 
認証が完了すると「このページに到達できません」とエラーが表示されるので、この時にURLをアドレスバーからコピーしてください。
 
 

 
コピーしたURLをパネルにペーストして取得ボタンを押すとOAuth2アクセストークンが“取得済み“となります。設定ボタンを押してパネルを閉じます。

Need more help with this?
Join our slack community for help

お役に立ちましたか?

はい いいえ
お役に立ちましたか
理由をお聞かせください
フィードバックありがとうございました