公式ミニプラグインをアレンジする

この記事は、「公式ミニプラグインを使ってみる」の続きです。

前回は、公式ミニプラグインをそのまま使って、ezbloxでどのようにkintoneの機能を拡張できるのかを体験しました。

ezbloxの基本的な使い方や、ミニプラグインの設定イメージは掴めたのではないでしょうか。

今回は一歩進んで、公式ミニプラグインをアレンジしてみます。

設定や構成を少し工夫することで、「そのまま使う」だけでは実現できない、自分たちの業務によりフィットした使い方が可能になります。

公式ミニプラグインをベースに、どこまで柔軟にカスタマイズできるのか。

ezbloxの“拡張の面白さ”を、実例を交えて見ていきましょう。

［現在日時入力］ミニプラグインのアレンジ

※「公式ミニプラグインを使ってみる」の続きです。

今回は、［現在日時入力］ミニプラグインで指定したフィールドを、手動では修正できないように非活性にするアレンジを行います。

１．［現在日時入力］ミニプラグインをアレンジします。

［メニュー］>［編集］をクリックしてください。

［同期を解除して編集しますか？］ という確認ダイアログが表示されます。

［編集する］をクリックしてください。

💡 公式ミニプラグインの同期解除について

［公式ミニプラグイン］を編集すると同期が解除されます。
以降は公式ミニプラグインのアップデートを反映することはできませんが、自由にカスタマイズできるようになります。

２．ミニプラグインを編集する画面が表示されます。

ミニプラグインは、ブロックの組み合わせでできているので、コードを書かなくてもかんたんに編集をすることができます。

３．左のブロックメニューから［kintone］>［イベントオブジェクト］>［フィールドの活性・非活性を切り替える］ブロックをクリックしてください。

４．［フィールドの活性・非活性を切り替える］ブロックを［メニュー位置にブロックを配置する］ブロックの上にドラッグして移動してください。

５．［fieldCode］ブロックを右クリックメニューから複製して、［フィールドの活性・非活性を切り替える］ブロックの［フィールドコード］項目にセットしてください。

６．［フィールドの活性・非活性を切り替える］ブロックの［活性］を［非活性］に変更してください。

７．［更新］をクリックして変更を保存してください。

保存時にコメントを求められますが、空欄で［更新する］をクリックしてください。

💡 ヒント

任意のコメントを入力することで、履歴を閲覧した時にどの時点でどういった変更をしたか、後から追いやすくなります。

８．［終了］をクリックしてください。ミニプラグイン編集画面を閉じて、設定画面に戻ります。

９．［変更を保存］後に、［kintoneへ配信］をクリックしてください。

［kintoneへ配信しました］のメッセージが表示されたら、設定完了です。

kintoneアプリを動かして、動作を確認しましょう。

編集したブロックの解説

１．イベントブロック

編集画面を表示した後に処理を実行します。

このブロックが、処理のスタート地点になります。

２．フィールドコードの取得

対象フィールドのフィールドを取得し、変数［fieldCode］ブロックに値をセットしています。

これにより、後続の処理で対象フィールドを指定できるようになります。

３．フィールドを非活性にする

2.で取得した［fieldCode］を使い、対象フィールドを非活性（編集不可）に設定します。

画面表示時に、自動で入力できない状態になります。

４．ボタンを配置して現在日時を入力

詳細画面メニューにボタンを配置します。

ボタンを押すと、現在の日時が対象フィールドに入力されます。

［タイムカード］アプリの動作確認

１．［現在日時入力］ミニプラグインを配信したkintoneのアプリを開きます。

［kintoneアプリを開く］をクリックしてください。

２．［タイムカード］アプリを開いたら、［レコードを追加する］アイコンをクリックしてください。

３．レコード追加画面で、［出勤日時］に初期値が入力されていることを確認して、［保存］をクリックしてください。

４．レコード詳細画面で、［レコードを編集する］アイコンをクリックしてください。

５．［退勤日時］フィールドが非活性になっており、手動で入力できないことを確認してください。

また、［現在日時を入力］をクリックすると、現在日時が入力できることを確認してください。

［現在日時入力］ミニプラグインをアレンジして、「自動で入力する」だけでなく、「手動では変更できない」という業務ルールまで表現できるようになりました。

このように、少しブロックを追加するだけで、

ミニプラグインは自分たちの業務に合わせて柔軟に進化させることができます。

まずは公式ミニプラグインをベースに、小さなアレンジから試してみてください。