tBoxGetの標準プロパティ

[Use existing connection] (既存の接続を使用)

定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。

[Connection/Client Key] (接続/クライアントキー)

Boxにより要求されるクライアントキーを入力してBox APIにアクセスします。クライアントキーとクライアントシークレットを取得するには、https://developers.box.com/でアカウントを作成し、使用するBoxアカウントの下にBoxアプリを作成する必要があります。クライアントキーとクライアントシークレットは、アカウントアプリケーションの設定から取得できます。

[Connection/Client Secret] (接続/クライアントシークレット)

Boxにより要求されるクライアントシークレットを入力してBox APIにアクセスします。クライアントキーとクライアントシークレットを取得するには、https://developers.box.com/でアカウントを作成し、使用するBoxアカウントの下にBoxアプリを作成する必要があります。クライアントキーとクライアントシークレットは、アカウントアプリケーションの設定から取得できます。

[Connection/Access Token] (接続/アクセストークン)

Boxにより要求されるアクセストークンを入力してBoxアカウントにアクセスして操作します。アクセストークンと更新トークンを取得する方法は、https://developers.box.com/からアクセスできるBoxのドキュメンテーションをご確認ください。

[Connection/Refresh Token] (接続/更新トークン)

Boxにより要求される更新トークンを入力してアクセストークンを自動的に更新します。アクセストークンと更新トークンを取得する方法は、https://developers.box.com/からアクセスできるBoxのドキュメンテーションをご確認ください。

[Connection/Use HTTP proxy] (接続/使用HTTPプロキシ)

プロキシを使用している場合は、このチェックボックスをオンにして、表示される各フィールドにそのプロキシのホストとポートの情報を入力します。

Path (パス)

ダウンロードするファイルを指すBoxのパスを入力します。

[Save as file] (ファイルとして保存)

このチェックボックスをオンにして[Save To] (保存先)フィールドを表示し、ダウンロードしたファイルを保管するローカルディレクトリーを参照または入力します。既存のファイルがあれば置き換えられます。

[Schema] (スキーマ)と[Edit schema] (スキーマを編集)

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

このコンポーネントのスキーマは読み取り専用で、fileNameおよびcontentという名前の2つのカラムがあります。

[Save as file] (ファイルとして保存)チェックボックスをオンにすると[Schema] (スキーマ)フィールドは利用できません。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。

グローバル変数

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

FILE_NAME: 処理されているファイルの名前。これはFlow変数で、文字列を返します。

INPUT_STREAM: 取得されているファイルのコンテンツ。これはFlow変数で、InputStreamを返します。

Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。

変数の詳細は、コンテキストと変数を使用をご覧ください。

使用ルール

このコンポーネントは、単独で、または[Iterate] (反復処理)リンクや、OnSubjobOKなどのトリガーリンクを介して、他のコンポーネントと共に使えます。