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_v5.0.1

プラグインの設定

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/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 にログインしているかどうかにかかわらず、誰でもアクセスできます。
    「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 内容表示欄のサイズを調整しました。
    • イベントハンドラー登録の非同期エラーに対応しました。
  • 2024 年 1 月 12 日 v5.0.1 を公開
    • プラグインの homepage_url を修正しました。
information

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

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

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