# Box連携

Alli は、Box 連携を介してBox環境に登録されているファイルやフォルダをインポートし、\
プロジェクトのナレッジベースとして活用することが可能です。\
組織内ですでに使用されているBoxのファイルを自動的にインデックスし、フォルダ構造を保持したまま反映して管理することができるため、より簡単にドキュメントを管理することが可能です。\
このガイドでは、Box プラットフォーム側のアプリの設定から Alli ダッシュボードの連動までの全体的な手順を段階的に案内します。以下の手順で設定を完了すると、社内で使用しているBoxコンテンツをAlliで簡単に活用できるようになります。

## Box  Developer Consoleでの設定

### Box Developer Consoleでアプリを作成する

1. Boxの[Developer console](https://app.box.com/developers/console)にアクセスします。
2. 新規のPlatformアプリを作成します。アプリタイプは\[カスタムアプリ]を指定してください。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FB76qZUOSR41AEpOHb8Bv%2Fimage.png?alt=media&#x26;token=777a4a2d-4019-434a-be7a-7263b77cc864" alt=""><figcaption></figcaption></figure>
3. アプリ名、目的を入力し、認証方法は、\[サーバー認証(クライアント資格情報許可)]を指定してください。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FgON00tdXtaTbApUwtl09%2Fimage.png?alt=media&#x26;token=71ff5f42-cc3c-449e-9235-9039f4094fba" alt="" width="305"><figcaption></figcaption></figure>
4. 構成タブに移動して各種設定を行います。\
   アプリアクセスレベルは\[アプリ + Enterpriseアクセス]として指定します。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2F8VbLcbE8mwoz6baUyMFA%2Fimage.png?alt=media&#x26;token=6939bf10-b3fe-4051-936e-26240cc19c7d" alt=""><figcaption></figcaption></figure>
5. アプリケーションスコープは\[Boxに格納されているすべてのファイルとフォルダへの書き込む]オプションにチェックします。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2F5oFDjZlB856SJ10nkm13%2Fimage.png?alt=media&#x26;token=264003c2-a638-44e1-9b44-654fe5d65e52" alt=""><figcaption></figcaption></figure>
6. 高度な機能で、\[as-userヘッダーを使用してAPIコールを行う]オプションと\[ユーザーアクセストークンを生成する]オプションを有効にします。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2F4CiJJ5fFjSCD63ntl3sR%2Fimage.png?alt=media&#x26;token=03f45588-dddc-4282-b6bc-982c7196fbe0" alt=""><figcaption></figcaption></figure>
7. 変更内容を保存します。

### Box Developer Consoleでアプリを承認する

（Box内で管理者権限を持つアカウントで行ってください）

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FAoYZs1afbcQFtPpDNMdr%2Fimage.png?alt=media&#x26;token=b19f3069-410a-42fd-ac37-faa43e79e7ed" alt=""><figcaption><p>接続するアプリのステータスが"有効"かつ承認ステータスが"承認済み"ある必要があります。</p></figcaption></figure>

1. Boxの[Developer console](https://app.box.com/developers/console)にアクセスします。
2. マイPlatformアプリ > 作成した連携用アプリを選択 > "承認"タブ 作成されたアプリを承認します。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FJAQwdLzpU3Mp2dtbXzxr%2Fimage.png?alt=media&#x26;token=70edfb25-768c-44db-86f8-93971aa27586" alt=""><figcaption></figcaption></figure>
3. アプリの承認タブで、\[確認して送信]ボタンをクリックします。\
   このボタンをクリックして、承認リクエストを送信し、アプリを承認してください。

### 連携情報の確認

1. Boxの[Developer console](https://app.box.com/developers/console)に移動し、該当するアプリを選択 > 一般設定 でユーザーIDを取得します。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FLVBr3cUuV24dU8PQDUgC%2Fimage.png?alt=media&#x26;token=ce8d0926-4446-4fdb-92d5-cb76ab77e911" alt=""><figcaption></figcaption></figure>
2. その後、コンポーネントからクライアントIDとクライアントシークレットを取得します。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FkRXqkPrxyOlHhqEfhVe0%2Fimage.png?alt=media&#x26;token=55579426-64b8-4ce6-875c-77052a26b3cb" alt=""><figcaption></figcaption></figure>

## Alli ダッシュボード側での連携設定

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FXdAefYSB3QQLwcNBKMgy%2Fimage.png?alt=media&#x26;token=feda9923-31c9-4d31-9bea-83ee75320357" alt=""><figcaption></figcaption></figure>

1. Alliダッシュボードに移動し、ナレッジベース > ソース設定 タブで"Box"を選択し、\
   Boxから取得した以下の3つの値をそれぞれ対応する箇所に入力し、接続ボタンをクリックします。\
   ・Client ID　→　Boxの"クライアントID"\
   ・Client Secret　→　Boxの"クライアントシークレット"\
   ・ユーザーID　→　Boxの"ユーザーID"<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FcYFCRb3b1vli1Dce2AI4%2Fimage.png?alt=media&#x26;token=9bbd247c-5ea5-41b5-ac18-0576765f3681" alt=""><figcaption></figcaption></figure>
2. 成功すれば連携設定は以上で完了です。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FhOBgFrfZSbOMlPa2sbrt%2Fimage.png?alt=media&#x26;token=16b39d47-692a-447b-9cb5-00f1b52d799a" alt=""><figcaption></figcaption></figure>
3. ドキュメントメニューに「Box.com」というフォルダが作成され、ドキュメントが連携されていることを確認してください。

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FVwTMrjryGRPM2mRFBBfk%2Fimage.png?alt=media&#x26;token=f66ad249-325b-46a2-a252-4e2da01c0958" alt=""><figcaption></figcaption></figure>

   連携時には、Box内のフォルダ構造がそのまま反映され、Alliダッシュボードにドキュメントが構成され、連携したBoxアカウントが持つ権限範囲内でのみドキュメントが連動されます。&#x20;

⚠️<mark style="color:red;">**注意事項**</mark>\
　連携されたドキュメントの変更はBox側の変更に基づいて自動的に反映されます。\
　ドキュメントのアップロード/移動/ファイル名の編集、フォルダの作成/移動/フォルダ名の編集\
　などの修正は必ずBox内でのみで行い、\
　Alliのダッシュボード上では、ハッシュタグの付与以外のドキュメントの編集を\
　しないようにしてください。

## Boxの連携とドキュメントのインデックス付与

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FJFWcW65j9rcxu1yHv0wp%2Fimage.png?alt=media&#x26;token=7c42341b-9532-4096-93cd-73d608d21620" alt=""><figcaption></figcaption></figure>

連携が完了すると、ドキュメントのインデックス付与は、自動インデクシングオプションの設定内容にに応じて、次のように操作されます。

#### **🔄自動インデクシングがONの場合**

* 毎日**プロジェクトタイムゾーン基準**の午前0時にBoxに保存されたドキュメントが**Alliダッシュボードに自動的に連動されます**。
* 個別の手動操作なしで最新のドキュメントが自動的に反映されます。

#### **⏸自動インデクシングがOFFの場合**

* ドキュメントの同期は**自動的に行われません。**
* 連携が必要な場合は、**\[今すぐ実行]ボタンをクリックして手動でバッチジョブを実行する**必要があります。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FB3lVb63vxMqUQ6sFGwp9%2Fimage.png?alt=media&#x26;token=1427319a-4d19-49f4-b9fa-276b021ebc37" alt=""><figcaption></figcaption></figure>