概要
Box Inc. の提供するサービス Box で管理しているファイルをkintoneのレコードで操作できるプラグインです。
注意事項
- サンプルプラグインに関するお問い合わせは、APIサポート窓口へのお問い合わせの対象外です。
- kintoneプラグインは、スタンダードコース以上で利用できます。
- このプラグインでは、一部の処理にDOM操作を含んでおり、アップデートの影響を受ける可能性があります。
- このプラグインでは、APIドキュメントで公開していないAPIを利用しています。
非公開APIを利用したプラグインの開発および販売はしないでください。
制限事項
- モバイル用のブラウザーおよびkintoneモバイルでは、Boxのファイルの表示やファイル操作はできません。
プラグインの機能
Boxで管理しているファイルをkintoneのレコードで確認できます。
Boxのフォルダー構造に合わせて、レコードを管理します。
kintoneのレコード上では、Boxに対する次の操作ができます。
- フォルダーを新規作成できます。
- レコードに表示されたBox画面へファイルをドラッグアンドドロップすると、Boxにファイルを追加できます。
- 追加したファイルに対し、閲覧/編集/削除/コメント追加ができます。
kintoneからレコードを削除しても、Boxで作成されたフォルダーや保存されたファイルは削除されません。
プラグインのパッケージング
Box for kintoneプラグインのソースコードは、公開していません。
パッケージングしたサンプル
このプラグインはプラグイン開発のためのサンプルで、サポート対象外です。
ご理解の上、ダウンロードしてください。
プラグインの設定
STEP1:プラグインの読み込み
kintoneシステム管理画面で、パッケージングしたファイル(zipファイル)を読み込みます。
ファイルからプラグインを読み込む
STEP2:アプリの追加
-
アプリを追加します。
-
次のフィールドを配置します。
フィールド フィールドの種類 備考 kintoneキーフィールド 文字列(1行) Boxのフォルダー名を入力するフィールド
「値の重複を禁止する」を設定してください。Box共有リンクの格納先フィールド 文字列(1行)またはリンク Boxの共有リンクが設定されるフィールド
リンクフィールドを使用する場合は、入力値の種類を「Webサイトのアドレス」に設定してください。
STEP3:プラグインの追加と設定
-
アプリの設定画面を開き、プラグインを追加します。
アプリにプラグインを追加する -
プラグインの設定画面を開き、項目を設定します。
項目名 必須 説明 Box親フォルダーID 必須 連携するBoxの親フォルダーID
指定したフォルダーの下に、フォルダーやファイルが保存されます。
フォルダーIDは、次のどちらかのBoxのURLで確認します。- https://app.box.com/files/0/f/
FOLDER_ID
/(フォルダー名) - https://app.box.com/folder/
FOLDER_ID
kintoneキーフィールド 必須 フォルダー名を入力するフィールド Box共有リンクの格納先 必須 BoxのフォルダーURLが入力されるフィールド Box共有リンクのアクセス権 必須 ファイルを保存するフォルダーの公開タイプ - Collaborators (People in this folder):フォルダーに招待したユーザーのみアクセスできます。
- Company (People in your company): 同じ企業メールアドレスをもつユーザーおよびフォルダーに「collaborator」の権限をもつユーザーがアクセスできます。
- Open (Anyone with the link): Boxにログインしているかどうかにかかわらず、誰でもアクセスできます。
- https://app.box.com/files/0/f/
-
【保存】をクリックします。
-
「アプリの設定」画面で、【設定完了】をクリックします。
STEP3:動作確認
-
レコード追加画面を開きます。
-
Boxにログインします。
-
kintoneによるBoxへのアクセスを許可します。
-
「フォルダー名」に、「Box親フォルダーID」以下にあるBoxのフォルダー名を入力し、レコードを追加します。
-
レコードの詳細画面で、Boxのフォルダー内のファイルが表示されていることを確認します。
更新履歴
- 2015年9月4日v1.5を公開
- 2017年8月7日v1.6を公開
- スタイルシートを「51-current-default.css」から「51-modern-default.css」に変更しました。
- その他軽微な修正を実施しました。
- 2018年2月26日v1.6.1を公開
- イベントオブジェクトのreturn漏れを修正しました。
- 2019年4月5日v1.6.2を公開
- フォームのBox内容表示欄のサイズを調整しました。
- イベントハンドラー登録の非同期エラーに対応しました。
- 2024年1月12日v5.0.1を公開
- プラグインのhomepage_urlを修正しました。
このプラグインは、2015年9月のアップデート以前にkintone製品からインストール可能だったBoxプラグインと同じ機能を提供しています。
当時のデザインは一部変更しています。
利用しているOSSのライセンス情報
このプラグインで利用しているOSSのライセンスは次のとおりです。
-
jQuery
- Author: jQuery Foundation, Inc.
- License: MIT License
-
JsRender
- Author: Boris Moore
- License: MIT License
-
51-modern-default
- Author: Cybozu, Inc.
- License: MIT License