はじめに
今回は、 2016年5月のアップデート で追加された、削除イベントのキャンセル機能の使いどころについて紹介したいと思います。
今までは削除イベントはキャンセルできなかったため、JavaScript で削除の制御をできませんでした。
この機能実装によって、たとえば「削除可の決済がおりていなければ削除できない」といったカスタマイズが可能になります。
おさらいしておきますと、削除イベントのキャンセル対応が入ったイベントは下記 2 つになります。
では、実際にサンプルコードを交えて試していきたいと思います。
アプリの準備
今回は削除キャンセルを試すために、アプリストアから「レンタル機器官理」アプリを追加し、次のフィールドを追加しました。
フィールドタイプ | フィールド名 | フィールドコード | 項目と順番 |
---|---|---|---|
チェックボックス | 削除承認 | delete_flag | 可 |
アプリを作成したら、レコードを 1 件登録しておきましょう。
サンプルコード
ではさっそく、試していきたいと思います。
今回のアップデートでは、以下 2 つのイベントに対して削除イベントをキャンセルできるようになっています。
app.record.detail.delete.submit
app.record.index.delete.submit
削除キャンセルできるパターンは、上記イベントハンドラー内で以下の 3 つの処理の場合のときに可能です。
return false
した場合event.error
にメッセージを代入して、return event
する。thenable
なオブジェクトを返す場合はresolve(false)
するか、event.error
をセットして、resolve(event)
する。
今回は、2 つめの event.error
にメッセージを代入して return event
をしてみます。
|
|
動作確認
ではサンプルコードを kintone に適用して、動きをみてみたいと思います。
「承認」フィールドにチェックを入れない状態で、レコード詳細画面から「削除」をしてみます。
画面にエラーメッセージが出て、削除がキャンセルされれば成功です。
逆に、「承認」フィールドにチェックを入れた状態で削除してみます。
レコードが削除されました。
おわりに
今回は Promise を使ったパターンを紹介しませんでしたが、たとえば「レコードを削除する時に関連したレコードを含めて消したい」といったケースも、エラーハンドリングがしやすくなると思います。
実際に活用してみてください。
この Tips は、2016 年 5 月版 kintone で動作を確認しています。