カテゴリー内の他の記事

Box for kintone

本プラグインは2015年9月のアップデート以前にkintone製品内からインストールが可能であったBoxプラグインとほぼ同等のものです。
(機能の変更はありません。一部デザインの変更をしています。)

Index

注意事項

  • サンプルプラグインは、その動作を保証するものではありません。
  • サンプルプラグインの技術的なサポート等は行っていません。
  • 本プラグイン内では、一部の処理にDOM操作を含んでいます。アップデートの影響をうける可能性がある実装となっており、参考にする際はご注意ください。
  • kintoneプラグインはスタンダードコースでのみご利用いただけます。ライトコースではご利用いただけませんのでご注意ください。

概要

Box Inc. の提供するサービス「Box」を利用している方向けのプラグインです。 Box の詳細はこちら
kintone のアプリにこのプラグインを追加すると、フォームに Box のフォルダが表示されるようになります。

box_demo.png

表示された Box のフォルダーにファイルをドラッグアンドドロップして、ファイルを保存できます。
保存したファイルに対しては、kintone のフォームから Box と同様の操作(閲覧、編集、削除やコメントなど)が可能です。
ファイルは、レコードごとにフォルダーを分けて保存されます。

※スマートフォンでは、ファイルの閲覧や操作ができません。
※レコードを削除しても、Box で作成されたフォルダーや保存されたファイルは残ります。

プラグインを利用する

STEP1:フォームを設定する

アプリのフォームを設定します。次の2つのフィールドを配置します。

  • フォルダー名にするフィールド
    ファイルを保存するフォルダー(Box 側のフォルダー)の名前にするフィールドを配置します。
    「文字列(1行)」フィールドを使用する必要があります。また、配置したフィールドは、値の重複を禁止する設定にする必要があります。
  • Box のフォルダーを表示するフィールド
    Box のフォルダーを表示する位置にフィールドを配置します。次の種類のフィールドを使用できます。
    ・文字列(1行)
    ・リンク ※入力値の種類は「Web サイトのアドレス」に設定する必要があります。

ほかのフィールドの配置は任意です。

box_form-setting.png

STEP2: アプリにプラグインを追加する

アプリに Box for kintone プラグインを追加します。プラグインの追加方法は、kintone ヘルプを参照してください。

プラグインを追加する

STEP3: プラグインを設定する

STEP2 で追加したプラグインに、必要な設定を行います。

1. アプリ管理画面の「詳細設定」>「プラグイン」を開き、Box for kintone プラグインの歯車マークをクリックします。

box_plugin-list.png

2. 各項目を指定します。

  • Box 親フォルダ ID
    ファイルを保存する Box のフォルダーの ID を指定します。指定したフィールドの直下に、レコードごとにフォルダーを分けてファイルが保存されます。
    フォルダーの ID は、フォルダーの URL の以下の部分です。
    https://app.box.com/files/0/f/(フォルダーのID)/(フォルダー名)
    または https://app.box.com/folder/(フォルダーのID)
  • kintone キーフィールド
    ファイルを保存するフォルダーの名前にするフィールドを選択します。
  • Box 共有リンクの格納先
    Box のフォルダーが表示されるフィールドを選択します。
  • Box 共有リンクのアクセス権
    ファイルを保存するフォルダーの公開タイプを設定します。
    • Collaborators (People in this folder): フォルダーに招待したユーザーがアクセスできます。
    • Company (People in your company): 同じ企業メールアドレスを持つユーザー、およびフォルダに「collaborator」の権限を持つユーザーがアクセスできます。
    • Open (Anyone with the link): Boxにログインしているかどうかに関わらず、誰でもアクセスできます。「Company」または「Open」を選んだ場合、ファイルのダウンロードに「collaborator」の権限を必要とするかどうかを選択できます。
      各タイプの詳細は、boxのヘルプ(英語)を参照してください。

box_plugin-setting.png

3. [保存]をクリックします。

4. 「アプリの設定」画面で[設定完了]をクリックすると、プラグインの設定がアプリに反映されます。

box_appUpdate.png

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

5.1 アプリのレコード登録画面を開きます。Box へのログインを要求されます。

5.2 Box にログインします。 kintone による Box へのアクセスを許可するかどうかが確認されます。

5.3 kintone による Box へのアクセスを許可します。アクセスを許可したら、Box for kintone プラグインの設定は完了です。

サンプルプラグイン

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

SAMPLE_boxPlugin_v1.6.2.zip

更新履歴

2015/09/04 v1.5 を公開しました

2017/08/07 v1.6 を公開しました。以下の点を更新しております。

  • スタイルシートを「51-current-default.css」から「51-modern-default.css」に変更しました。
  • その他軽微な修正を行いました。

2018/02/26 v1.6.1 を公開しました。以下の点を更新しております。

  • eventオブジェクトのreturn漏れを修正しました。

2019/04/05 v1.6.2 を公開しました。以下の点を更新しております。

  • フォームのBox内容表示欄のサイズを調整しました。
  • イベントハンドラー登録の非同期エラーに対応しました。

記事に関するフィードバック

記事のコメント欄は記事に対するフィードバックをする場となっております。
右の記事フィードバックのためのガイドを参照してコメントしてください。
記事のリンク切れなど、気になる点がある場合も、こちらのフォームからフィードバックいただけますと幸いです。

Avatar
cybozu Development team

tama様

お世話になっております。
cybozu developer network事務局です。

説明不足で申し訳ありません。

フォルダIDはURLに含まれているのでそこで確認することにします。
https://app.box.com/folder/xxxxxxxxxx のxxxxxxxxxxの部分がファルダIDです。
BoxのUIによって、https://app.box.com/files/0/f/xxxxxxxxxx の場合があります。

cybozu Development teamにより編集されました
Avatar
tama

現状、「SAMPLE_boxPlugin_v1.6.2.zip」をダウンロードして使っています

申し訳ありませんが、下記のURLをどのように参照するのかがよくわからない状況です

>フォルダIDはURLに含まれているのでそこで確認することにします。
>https://app.box.com/folder/xxxxxxxxxx のxxxxxxxxxxの部分がファルダIDです。

 

Avatar
cybozu Development team

tama様

お世話になっております。
cybozu developer network事務局です。

 

kintoneからフォルダのURLをどのように参照しているかという質問でしょうか。

(認識が間違ったら申し訳ありません。)

※URLは、自分のBoxにログインして、kintoneで指定したいフォルダを開き、ブラウザのアドレス欄に表示しているものです。

 

kintone上での指定方法:

1.プラグインの設定画面でBox側の親フォルダのIDを指定し、他の項目も指定した後、設定を保存します。

2.レコード登録の際、Boxへのログインが要求されます(自分のBox環境にログインしていると同等です)。

  そこで、1にて指定したフォルダを探しにいくというイメージです

cybozu Development teamにより編集されました
Avatar
tama

説明が不足していて申し訳ありません

現状、boxの契約は行っていません

こちらのページにあるzipファイルを使っている状況ですが、この場合はboxは使えないという事になるのでしょうか?

自分のboxにログインしてというくだりが良くわかないので教えていただきたいです

Avatar
cybozu Development team

tama様

お世話になっております。
cybozu developer network事務局です。

概要に記載しているように、当プラグインはBox Inc. の提供するサービス「Box」を利用している方向けのプラグインです。
ですので、Boxのアカウントを持っていることは前提です。
お試しだけでしたら、個人向けのアカウントでも大丈夫です。

また、仕様以外の技術的な質問はcybozu developer コミュニティをご活用ください。

Avatar
tama

boxの個人向けのアカウント作成して、無事に設定を行うことができました

ありがとうございます

サインインしてコメントを残してください。