Boxコネクタ > Boxの接続 > Boxへの接続
  

Boxへの接続

Boxに接続するようにBoxの接続プロパティを設定してみましょう。

始める前に

開始する前に、BoxアカウントのOAuthを設定する必要があります。
OAuthを設定する場合は、redirect_URIパラメータを指定します。Boxは、Box接続の認証URLで渡されたredirect_uriパラメータが、アプリケーション用に設定されたリダイレクトURIと一致することを確認します。
Box接続を設定する場合は、接続でアクセストークンを自動生成するか、手動でトークンを生成するかを選択することができます。トークン生成プロセスを自分で処理する場合は、BoxでOAuthの設定時に、アクセストークンと、認証タイプ、クライアントID、クライアントシークレットを手動で生成することができます。
BoxにアクセスするためのOAuthの設定方法の詳細については、Boxのマニュアルを参照してください。
次のビデオでは、Box接続の設定時にOAuthアクセストークンを自動生成する方法について説明します。
https://infa.media/3pNnFpL

接続の詳細

次の表に、基本接続プロパティを示します。
プロパティ
説明
接続名
接続の名前。
各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -,
最大長は255文字です。
説明
接続の説明。最大長は4000文字です。
タイプ
ボックス
ランタイム環境
タスクを実行するランタイム環境の名前。
Secure Agent、ホステッドエージェント、またはサーバーレスランタイム環境を選択します。
ホステッドエージェントは、詳細モードのマッピングには適用されません。
アクセストークンタイプ
エンドポイントサーバー内のリソースへのアクセスを認証および承認するためのアクセストークン。
次のオプションから選択できます。
  • - 自動生成。[トークンの取得]をクリックすると、Boxは接続でアクセストークンを自動生成します。
  • - 手動。BoxアカウントからOAuthの詳細を取得し、接続に詳細を手動で入力します。
デフォルトは[自動生成]です。

アクセストークンの自動生成

デフォルトでは、接続が自動生成されるように選択されています。
次の表に、Boxからアクセストークンを自動生成するために必要なプロパティとアクション、およびその説明を示します。
プロパティ
説明
OAuthアクセストークン
Boxによって生成されるアクセストークン。
[トークンの取得]をクリックすると、アクセストークンがBoxによって生成され、このフィールドが自動的に入力されます。
詳細については、OAuthアクセストークンの生成を参照してください。視覚的なプレゼンテーションについては、Generating the access token videoを確認してください。

手動でのアクセストークンの生成

OAuthプロパティを手動で入力するには、[アクセストークンタイプ][手動]を選択し、必要なプロパティを入力します。
次の表に、Boxに手動で接続する必要があるOAuthプロパティとその説明を示します。
プロパティ
説明
アクセストークン
手動で生成したOAuthアクセストークンの値をBoxに入力します。
クライアントID
Boxでアプリケーション登録プロセス中にクライアントに発行されるクライアント識別子。
クライアントシークレット
Boxでアプリケーション登録プロセス中にクライアントに発行されるクライアントシークレットキー。
認証タイプ
Boxに接続する認証タイプ。
文字列refresh_tokenを入力します。
更新トークン
リフレッシュトークンの値を入力します。
アクセストークンの有効期限が切れた場合は、リフレッシュトークンを使用して新しいアクセストークンを生成できます。
注: 手動アクセストークンタイプを使用しており、更新トークンの有効期限が切れた場合は、接続プロパティを再入力する必要があります。

詳細設定

次の表に、詳細接続のプロパティを示します。
プロパティ
説明
URI要求パラメータ
Box内のファイルまたはフォルダを検索するためのパラメータ。
検索文字列は以下の書式で指定します。
query=search_string;content_types=<name|description|file_content|comments|tags;limit=<number>;offset=<number>
例えば、「generate」という語を含むオブジェクトを検索するには、query=generate;content_types=name;limit=0;offset=0という文字列を入力します。
ワイルドカード文字を使用し、語句または複数のクエリ文字列を二重引用符で囲むことで、検索条件を絞り込むことができます。
詳細については、「URI要求パラメータ」を参照してください。
ソースファイルのパス
このプロパティは、Box接続には適用されません。
ターゲットファイルのパス
オプション。BoxからオブジェクトをダウンロードできるSecure Agentマシン上のディレクトリ。
ファイルまたはフォルダを特定のディレクトリにダウンロードするためのパスを入力します。
デフォルトでは、Secure AgentマシンのルートディレクトリにすべてのBoxオブジェクトがダウンロードされます。
応答フォルダのパス
このプロパティは、Box接続には適用されません。
[BoxファイルIDまたはBoxフォルダID]
データの読み取りまたは書き込み先となる、Box内のファイルまたはフォルダのファイルIDまたはフォルダID。
ファイルIDまたはフォルダIDは、ファイルまたはフォルダのBox URLから取得することができます。
例えば、Boxの[レポート]フォルダのURLはhttps://app.box.com/folder/50016834230です
URLの50016834230は、レポートのフォルダIDです。
注: この値は、BoxでCSVファイルの読み取りまたは書き込みを行うときに上書きすることができます。