Tips

Box for kintone

目次

概要

Box Inc. の提供するサービス Box (External link) で管理しているファイルを kintone のレコードで操作できるプラグインです。

注意事項

  • サンプルプラグインに関するお問い合わせは、API サポート窓口へのお問い合わせの対象外です。
  • kintone プラグインは、スタンダードコースでのみ利用できます。
  • このプラグインでは、一部の処理に DOM 操作を含んでおり、アップデートの影響を受ける可能性があります。
  • このプラグインでは、API ドキュメントで公開していない API を利用しています。
    非公開 API を利用したプラグインの開発および販売はしないでください。

制限事項

  • モバイル用のブラウザーおよび kintone モバイルでは、Box のファイルの表示やファイル操作はできません。

プラグインの機能

Box で管理しているファイルを kintone のレコードで確認できます。
Box のフォルダー構造に合わせて、レコードを管理します。

kintone のレコード上では、Box に対する次の操作ができます。

  • フォルダーを新規作成できます。
  • レコードに表示された Box 画面へファイルをドラッグアンドドロップすると、Box にファイルを追加できます。
  • 追加したファイルに対し、閲覧／編集／削除／コメント追加ができます。

kintone からレコードを削除しても、Box で作成されたフォルダーや保存されたファイルは削除されません。

プラグインのパッケージング

Box for kintone プラグインのソースコードは、公開していません。

パッケージングしたサンプル

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

SAMPLE_boxPlugin_v1.6.2.zip

プラグインの設定

STEP1：プラグインの読み込み

kintone システム管理画面で、パッケージングしたファイル（zip ファイル）を読み込みます。
ファイルからプラグインを読み込む (External link)

STEP2：アプリの追加

  1. アプリを追加します。

  2. 次のフィールドを配置します。

    フィールド フィールドの種類 備考
    kintone キーフィールド 文字列（1行） Box のフォルダー名を入力するフィールド
    「値の重複を禁止する」を設定してください。
    Box 共有リンクの格納先フィールド 文字列（1行）またはリンク Box の共有リンクが設定されるフィールド
    リンクフィールドを使用する場合は、入力値の種類を「Web サイトのアドレス」に設定してください。

STEP3：プラグインの追加と設定

  1. アプリの設定画面を開き、プラグインを追加します。
    アプリにプラグインを追加する (External link)

  2. プラグインの設定画面を開き、項目を設定します。

    項目名 必須 説明
    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 にログインしているかどうかにかかわらず、誰でもアクセスできます。
    「Company」または「Open」の場合、ファイルのダウンロードに「Collaborator」の権限を必要とするかどうかを選択できます。

  3. 【保存】をクリックします。

  4. 「アプリの設定」画面で、【設定完了】をクリックします。

STEP3：動作確認

  1. レコード追加画面を開きます。

  2. Box にログインします。

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

  4. 「フォルダー名」に、「Box 親フォルダー ID」以下にある Box のフォルダー名を入力し、レコードを追加します。

  5. レコードの詳細画面で、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 内容表示欄のサイズを調整しました。
    • イベントハンドラー登録の非同期エラーに対応しました。
information

このプラグインは、2015 年 9 月のアップデート以前に kintone 製品からインストール可能だった Box プラグインと同じ機能を提供しています。
当時のデザインは一部変更しています。

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

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