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