概要
Dropbox, Inc.の提供するサービス「Dropbox」を利用している方向けのプラグイン第二弾です。
kintoneアプリにこのプラグインを追加すると、フォルダ名用に指定したフィールドに入力された名前と同じ名前のフォルダ内ファイルを検索しkintoneにリンクを保存することができます。保存されたリンクはレコード詳細画面で、標準パーツのようにファイルを表現します。
レコード詳細画面
レコード詳細画面のリンク押下後の遷移先(Dropbox)
Dropbox for kintone 2.0を利用する
STEP1:フォームを設定する
アプリのフォームを設定します。次の3つのフィールドを配置します。
- フォルダ名用フィールド
ログインしているユーザーの、Dropboxルートフォルダ直下のフォルダ名を検索しにいくためのフィールドです。「文字列(1行)」フィールドを使用する必要があります。 - ファイルリスト表示用スペース
Dropboxの指定したフォルダ直下のファイルを表示するフィールドです。
スペースを使用します。この時、要素IDを付けます。 - ファイルリスト保存用フィールド
Dropboxから取得したファイルのリンクを保存するためのフィールドです。
「文字列（複数行）」フィールドを使用する必要があります。
ほかのフィールドの配置は任意です。
STEP2:アプリにプラグインを追加する
アプリにDropbox for kintone プラグインを追加します。
- 本ページ下部よりプラグインファイルをダウンロードします。
- kintone 環境にプラグインファイルを読み込んでインストールします。詳細はkintoneヘルプをご参照ください。 kintoneにプラグインファイルをインストールする
- アプリにDropbox for kintone プラグインを追加します。プラグインの追加方法は、kintoneヘルプを参照してください。 アプリにプラグインを追加する。
STEP3:プラグインを設定する
STEP2で追加したプラグインに、必要な設定を行います。
1. アプリ管理画面の「詳細設定」＞「プラグイン」を開き、Dropbox for kintone2 プラグインの歯車マークをクリックします。
2. 各項目を設定します。
- フォルダ名用フィールド
Dropboxルート直下のフォルダ検索をするためのフィールドをここで選択します。 - ファイルリスト表示用スペース
DropBox内に保存されたファイルを表示するスペースを選択します。 - ファイルリスト保存用フィールド
ここで選択したフィールドは、非表示となります。 - ダウンロードリンク
チェックを入れると保存されるリンクがダウンロードリンクになります。
3. [保存]をクリックします。
4.「アプリの設定」画面で[設定完了]をクリックすると、プラグインの設定がアプリに反映されます。
STEP4:プラグインを利用する
1.Dropboxにて、ルート直下にフォルダを作成しファイルを保存します。
2.kintoneのプラグインを適用したアプリでレコード一覧画面上部の「Dropbox Login」ボタンを押します。Dropboxのログイン画面に遷移するので、ログイン情報を入力しログインします。
3.kintoneのプラグインを適用したアプリでレコードを保存します。この時、1で作成したフォルダ名と同じ文字列をフォルダ名用フィールドに指定したフィールドに保存します。
4.レコードを保存します。
5.レコード詳細画面に表示された、「Update」ボタンを押します。
6.フォルダ内のファイルが表示できれば正しくプラグインが適用できたことが確認できます。
※レコードを削除しても、Dropboxで作成されたファイルは残ります。
サンプルプラグイン
パッケージングしたサンプル
dropbox
更新履歴
2016/01/13 v1.0 を公開しました。
2016/01/20 v1.1 を公開しました。以下の点を更新しております。
- ゲストスペース内アプリで動作しない不具合を改修しました。
- その他軽微な変更を加えました。
2017/08/07 v1.2 を公開しました。以下の点を更新しております。
- フォルダ名が空の状態でレコード保存できない不具合を改修しました。
- その他軽微な変更を加えました。
サンプル制限事項
- 画像のサムネイル表示には対応していません。
- 運用の途中で設定を「ダウンロードリンク」にした場合、過去に保存したリンクを再度更新する必要があります。
その他
- レコード一覧画面で、ファイルリスト保存用フィールドを配置することは推奨しません。
Toshimichi Konnoさん
こちら本日不具合を確認し修正致しました。 本文添付のプラグインファイルを再度ダウンロードしお試しください！
一度ドロップボックスのIDを入力すると、他のIDは使えなくなりますか。
hwcさん
>一度ドロップボックスのIDを入力すると、他のIDは使えなくなりますか。
本来使えるものとなります。
(下記修正しました)
すみません。
一度ログインするとほかのアカウントでログインできないかどうか？ということでしたら、この認証情報はクライアントのブラウザに依存するので、端末を変えれば問題ありません。
現在、開発中のレコード編集画面にて、項目の非活性制御を行なっていましたが、
こちらのプラグインを適用後から非活性制御が効かなくなりました。
以下の編集イベントのドキュメントに
https://developer.cybozu.io/hc/ja/articles/202166270#step5
"ハンドラーが record オブジェクトのフィールドの disabled に true/falseを代入して event オブジェクトを return した場合は、そのフィールドは編集不可／可になります。"
と記載がありますが、本プラグインの編集イベントハンドラ(app.record.edit.show)の最終行に
return event は実装されていないようです。
本プラグインを適用しない場合、項目が非活性になり、
また、開発者ツールで本プラグインの編集イベントないのeventオブジェクトを確認したところ、
対象カラムのdisabledの値にtrueが設定されていることが確認できたため、
非活性の制御が効かなくなったのは上記が原因のような気がしています。
編集イベントハンドラでeventオブジェクトをreturnしない(できない)理由はありますでしょうか？
もし、return eventを実装しない(できない)理由があれば、本プラグインを適用した状態で、
編集画面の非活性制御ができる方法等、ご教示いただきたいです。
ご確認のほど、お願いいたします。
koki 様
いつもお世話になっております。 developer network事務局です。
ご指摘いただいた部分について、こちらでも確認いたしました。
今後の改修での参考にさせていただきます。ありがとうございます。
なお、複数カスタマイズ、プラグインによる動作は保証しておりません。
そのため、本プラグインは単体で動作することは確認しておりますが、その他のカスタマイズと併用した際の動作は確認しておりません。
よろしくお願いいたします。
いつもお世話になっております。
こちらのプラグインを試したところ、
Dropbox上のルートフォルダ直下以外のフォルダは検索できません。
とあるのですが、フォルダ名を「/」で区切ったところ、
ルートフォルダ直下より下のサブフォルダの検索も可能なようです。
※「（ルートフォルダ）/aaa/test」の場合、フォルダ名に「aaa/test」で検索が可能
こちらは、仕様・想定通りの動きでしょうか。
もし、想定外の動きである場合、Dropboxのアップデート等で
今後、検索ができなくなる可能性があるということでしょうか。
小野間明子様
いつもお世話になっております。cybozu developer network事務局です。
ご指摘いただいた動作については想定通りの動きです。
そのため、以下の文言を記事から削除いたしました。
> Dropbox上のルートフォルダ直下以外のフォルダは検索できません。
ご指摘いただきありがとうございました。
> Dropboxのアップデート等で今後、検索ができなくなる可能性があるということでしょうか。
この点については、developer network内に掲載しているサンプルプラグインに関しましては、 動作保証のないサンプルという位置づけになっております。
こちらをご理解していただいた上でのご利用をお願いいたします。
cybozu developer network事務局 御中
お忙しい中、ご回答いただきありがとうございました。
取り急ぎ、御礼まで。
Dropbox for kintone 2.2を使用しているのですが、昨日よりDropboxフォルダ内ファイルリストに登録されているPDFファイルのリンクをクリックすると、DoropBoxのサイト（https://www.dropbox.com/h）にリンクされてしまいます。
DropBox側でなにかしらのアップデートがあったことによる現象でしょうか？
koichi kimura様
ご連絡をありがとうございます。当方の環境でも現象を再現しました。
7/11のDropBox APIの変更 https://github.com/dropbox/dropbox-api-spec/commit/0e697d79d684fd800448405ecfc5a50fcb5a125f
にて、ファイルのメタデータに新しいプロパティが追加されたことによるものと推測しております。
サンプルプラグインのため、ベストエフォートでの対応となりますが、お時間を頂戴できますでしょうか。
よろしくお願いいたします。
ご確認いただきましてありがとうございます。
承知しました。お忙しい中ありがとうございます。
koichi kimura様
一部のファイルタイプでリダイレクトされてしまう件、
Dropbox側で修正があったことが確認できました。当方の環境でも問題が解消していることを確認できましたので、
お手数ですがそちらでもご確認をお願いできますでしょうか。
こちらでも解消していることが確認できました。
ご連絡いただきましてありがとうございます。