Box for kintone

本プラグインは2015年9月のアップデート以前にkintone製品内からインストールが可能であったBoxプラグインとほぼ同等のものです。
(機能の変更はありません。一部デザインの変更をしています。)

Index

• 注意事項
• 概要
• プラグインを利用する
• サンプルプラグイン
• 利用している OSS のライセンス情報

注意事項

• サンプルプラグインは、その動作を保証するものではありません。
• サンプルプラグインの技術的なサポート等は行っていません。
• このプラグインでは、一部の処理に DOM 操作を含んでおり、アップデートの影響を受ける可能性があります。
  プラグイン開発の参考にする際にはご注意ください。
• このプラグインでは、API ドキュメントで公開していない API を利用しています。
  非公開 API を利用したプラグインの開発および販売はしないでください。
• kintone プラグインは、スタンダードコースでのみ利用できます。

概要

Box Inc. の提供するサービス「Box」を利用している方向けのプラグインです。　Box の詳細はこちら
kintone のアプリにこのプラグインを追加すると、フォームに Box のフォルダが表示されるようになります。

表示された Box のフォルダーにファイルをドラッグアンドドロップして、ファイルを保存できます。
保存したファイルに対しては、kintone のフォームから Box と同様の操作（閲覧、編集、削除やコメントなど）が可能です。
ファイルは、レコードごとにフォルダーを分けて保存されます。

※スマートフォンでは、ファイルの閲覧や操作ができません。
※レコードを削除しても、Box で作成されたフォルダーや保存されたファイルは残ります。

プラグインを利用する

STEP1:フォームを設定する

アプリのフォームを設定します。次の2つのフィールドを配置します。

• フォルダー名にするフィールド
  ファイルを保存するフォルダー（Box 側のフォルダー）の名前にするフィールドを配置します。
  「文字列（1行）」フィールドを使用する必要があります。また、配置したフィールドは、値の重複を禁止する設定にする必要があります。
• Box のフォルダーを表示するフィールド
  Box のフォルダーを表示する位置にフィールドを配置します。次の種類のフィールドを使用できます。
  ・文字列（1行）
  ・リンク　※入力値の種類は「Web サイトのアドレス」に設定する必要があります。

ほかのフィールドの配置は任意です。

STEP2: アプリにプラグインを追加する

アプリに Box for kintone プラグインを追加します。プラグインの追加方法は、kintone ヘルプを参照してください。

プラグインを追加する

STEP3: プラグインを設定する

STEP2 で追加したプラグインに、必要な設定を行います。

1. アプリ管理画面の「詳細設定」＞「プラグイン」を開き、Box for kintone プラグインの歯車マークをクリックします。

2. 各項目を指定します。

• Box 親フォルダ ID
  ファイルを保存する Box のフォルダーの ID を指定します。指定したフィールドの直下に、レコードごとにフォルダーを分けてファイルが保存されます。
  フォルダーの ID は、フォルダーの URL の以下の部分です。
  https://app.box.com/files/0/f/（フォルダーのID）/（フォルダー名）
  または　https://app.box.com/folder/（フォルダーのID）
• kintone キーフィールド
  ファイルを保存するフォルダーの名前にするフィールドを選択します。
• Box 共有リンクの格納先
  Box のフォルダーが表示されるフィールドを選択します。
• Box 共有リンクのアクセス権
  ファイルを保存するフォルダーの公開タイプを設定します。
  • Collaborators (People in this folder)： フォルダーに招待したユーザーがアクセスできます。
  • Company (People in your company)： 同じ企業メールアドレスを持つユーザー、およびフォルダに「collaborator」の権限を持つユーザーがアクセスできます。
  • Open (Anyone with the link)： Boxにログインしているかどうかに関わらず、誰でもアクセスできます。「Company」または「Open」を選んだ場合、ファイルのダウンロードに「collaborator」の権限を必要とするかどうかを選択できます。
    各タイプの詳細は、boxのヘルプ（英語）を参照してください。

3. [保存]をクリックします。

4. 「アプリの設定」画面で[設定完了]をクリックすると、プラグインの設定がアプリに反映されます。

5. kintone による Box へのアクセスを許可します。

5.1 アプリのレコード登録画面を開きます。Box へのログインを要求されます。

5.2 Box にログインします。 kintone による Box へのアクセスを許可するかどうかが確認されます。

5.3 kintone による Box へのアクセスを許可します。アクセスを許可したら、Box for kintone プラグインの設定は完了です。

サンプルプラグイン

プラグイン開発のためのサンプルであり、サポート対象外であることをご理解の上、ダウンロードしてください。

SAMPLE_boxPlugin_v1.6.2.zip

更新履歴

2015/09/04 v1.5 を公開しました

2017/08/07 v1.6 を公開しました。以下の点を更新しております。

• スタイルシートを「51-current-default.css」から「51-modern-default.css」に変更しました。
• その他軽微な修正を行いました。

2018/02/26 v1.6.1 を公開しました。以下の点を更新しております。

• eventオブジェクトのreturn漏れを修正しました。

2019/04/05 v1.6.2 を公開しました。以下の点を更新しております。

• フォームのBox内容表示欄のサイズを調整しました。
• イベントハンドラー登録の非同期エラーに対応しました。

利用している OSS のライセンス情報

このプラグインで利用している OSS のライセンスは次のとおりです。

• jQuery - MIT License
• JsRender - MIT License
• 51-modern-default - MIT License