Box for kintone
概要
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/
フォルダー ID
/(フォルダー名) - https://app.box.com/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 内容表示欄のサイズを調整しました。
- イベントハンドラー登録の非同期エラーに対応しました。
このプラグインは、2015 年 9 月のアップデート以前に kintone 製品からインストール可能だった Box プラグインと同じ機能を提供しています。
当時のデザインは一部変更しています。
利用している OSS のライセンス情報
このプラグインで利用している OSS のライセンスは次のとおりです。