> For the complete documentation index, see [llms.txt](https://manuals.i-reporter.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuals.i-reporter.jp/output-the-data/external-systems-integration/preset-for-box.md).

# Boxに連携する場合の事前設定

## **自動ファイル出力設定**

本機能は、i-Reporterの 「自動ファイル出力機能」 で出力したファイルを Box へ連携する機能です。\
あらかじめ、i-Repos Managerで 「自動ファイル出力機能」 の設定がONになっている必要があります。

{% hint style="info" %}
詳細は、 「[自動ファイル出力設定](https://manuals.i-reporter.jp/output-the-data/data-output/auto-fileoutputsetting.md)」のページをご参照ください。
{% endhint %}

## **Box側での事前設定**

i-ReporterとBoxが連携するには、Boxで以下の事前設定が必要です。

1. Boxで連携用のアプリを作成します。
2. アプリを承認します。\
   ※承認できるのはBoxの管理者アカウントです。
3. アプリの設定

Boxとi-Reporter間は認証にサーバー認証(クライアント資格情報許可)を使用し、サービスアカウントで連携します。

<div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/YdElVCUc5yHS2fI68dUh/image.png" alt="" width="375"><figcaption></figcaption></figure></div>

### **マイアプリの作成**

Boxで連携用のアプリを作成します。

【手順】

1. Webブラウザで Boxにログインし、「開発者コンソール」にアクセスします。

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/HvsMFtYN2uGpNCQbVjjI/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

2. 「マイアプリ」で「アプリの新規作成」を選択します。

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/NPFJZNvKOBv5bSvvJkFN/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

3. アプリタイプは「カスタムアプリ」を選択します。

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/j6nYAKIYhgbLZ3HXl0PA/image.png" alt=""><figcaption></figcaption></figure></div>

4. 作成するアプリの内容を設定します。\
   「認証方法」は「サーバー認証(クライアント資格情報許可)」を選択します。\
   「アプリ名」には任意の名称を入力します。\
   「アプリの作成」をクリックするとマイアプリにアプリが作成されます。

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/YfnGPAexyJqwL4FCMiYG/image.png" alt=""><figcaption></figcaption></figure></div>

### **書き込み可否設定の変更**

i-Reporterからboxに、フォルダ・ファイルを作成できるように設定します。

【手順】

1. 作成したアプリの「構成」タブを選択します。\
   「Boxに格納されているすべてのファイルとフォルダへの書き込み」にチェックを入れ、「変更を保存」をクリックします。

<div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/8Jv5W762EhiJnhmDumDf/image.png" alt=""><figcaption></figcaption></figure></div>

### **アプリの承認**

作成したアプリを承認します。

{% hint style="warning" %}
この操作はboxの管理者で行ってください。
{% endhint %}

1. 作成したアプリの「承認」タブを選択します。\
   「確認して送信」をクリックします。

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/2W3x0NBSlidcJVvZvHZO/image.png" alt=""><figcaption></figcaption></figure></div>

2. 次の画面で「送信」をクリックすると、boxの管理者アカウントに登録されているメールアドレスにメールが送信されます。

   管理者はメールの内容に従って承認します。

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>設定者がbox管理者でない場合は、box管理者へ作業を依頼してください。</p></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/ZTYzXOvylmpb65oT0Zzx/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/WO0BkHdnDTNcPaAaWXDw/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

   <br>

3. 承認が完了すると、サービスアカウントが作成されます。

   <div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/H52BfL6CuQlzXTIqpVWh/image.png" alt=""><figcaption></figcaption></figure></div>

### **アプリの設定**

【手順】

1. i-Repo Managerの「Box連携設定」に登録する、クライアントシークレットを作成します。\
   作成したアプリの「構成」タブを選択します。\
   「クライアントシークレットを取得」をクリックします。

   <figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/isVz1ccZiR0JRPEAsIK7/image.png" alt=""><figcaption></figcaption></figure>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>【注意事項】</p><p>2段階認証が有効になっている環境の場合は、別途認証コードが必要です。<br>詳しくはBoxサポートへご確認ください。</p></div>

2. i-Repo Managerの「Box連携設定」に登録する３つの情報を控えます。\
   必要な情報は下記です。

   * クライアントID（Client ID）
   * クライアントシークレット（Client Secret）
   * Enterprise ID

   「クライアントID」 と 「クライアントシークレット」 は、「構成」タブより確認・コピーできます。\
   「Enterprise ID」 は、「一般設定」タブより確認・コピーできます。

   <figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/CxjHBuIhHsi4dQnmgxei/image.png" alt=""><figcaption></figcaption></figure>

3. ファイルを連携するのはサービスアカウントです。\
   アップロードしたいフォルダーに、アービスアカウントのメールアドレスを共有設定に追加します。\
   \
   作成したアプリの「一般設定」タブで、「サービスアカウントのメールアドレス」を確認します。\
   \
   Boxのサイトで、アップロードしたいフォルダを選択し「共有」をクリックします。\
   \
   「ユーザーを招待」に「サービスアカウントのメールアドレス」を入力し、「編集者として招待」を選択して「送信」をクリックします。

   <figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/oQqaIvHTkIpwreYD90DT/image.png" alt=""><figcaption></figcaption></figure>

## **i-Repo Managerでのbox連携設定**

i-Repo Manager上部メニューの「システム管理」 ＞ 「外部システム連携設定」 ＞ 「Box連携設定」にて、「Box側での設定 ＞[アプリの設定](#apurino-1)」 で控えた下記３つの設定値を入力します。

* クライアントID（Client ID）
* クライアントシークレット（Client Secret）
* Enterprise ID

【手順】

1. i-Repo Manager上部メニューの「システム管理」 ＞ 「外部システム連携設定」 ＞ 「Box連携設定」 ＞ 「Box連携設定」画面にて、画面右上の 「編集」ボタンをクリックします。
2. 「▼Box認証設定」に、「ClientID」、「Client Secret」、「Enterprise ID」をそれぞれ入力します。
3. 「登録」ボタンをクリックします。\
   連携設定が行われると、「▼連携情報」欄に「アプリ名」と「サービスアカウントのアドレス」が表示されます。

<div align="left"><figure><img src="https://content.gitbook.com/content/JOsI6lvNedHZoaBw5Ppf/blobs/zSelNErO1d0BGVkMEZ45/image.png" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
事前設定完了後は、帳票定義ごとのアップロード先フォルダーの設定を行います。

「[帳票定義ごとのアップロード先フォルダーの設定（Googleドライブ、Box、BIM360DOCS共通）](https://manuals.i-reporter.jp/output-the-data/external-systems-integration/folder-settings.md)」 をご参照ください。
{% endhint %}
