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のライセンスは次のとおりです。