Microsoft Dynamics 365 新機能: 編集可能なグリッド: その 3

[アーティクル]
04/19/2017

みなさん、こんにちは。

前回に続き、Microsoft Dynamics 365 新機能から編集可能なグリッドについて紹介します。
本機能は、オンライン、および設置型ともに提供されています。

前回は本機能の概要を紹介しました。ご覧になっていない方は一読ください。

Microsoft Dynamics 365 新機能: 編集可能なグリッド: その 1 Microsoft Dynamics 365 新機能: 編集可能なグリッド: その 2

今回は、編集可能なグリッドのイベントにスクリプトを追加してどのような制御ができるか紹介します。

追加できるイベント

- OnRecordSelect イベント
- OnChange イベント
- OnSave イベント

OnRecordSelect イベント

単一の行 (レコード) が編集可能なグリッドで選択されている場合に発生します。
ユーザーが同じ行で異なるセルを選択している、または複数の行を選択している場合、このイベントは発生しません。

OnChange イベント

編集可能なグリッドのセルの値が変更されているとき、またはセルがフォーカスを失ったときに発生します。

OnSave イベント

更新された情報がサーバーにを送信される前、および次のいずれかが起こると発生します。

- 選択しているレコードが変更されているとき
- 編集可能なグリッドの保存ボタンをクリックしたとき
- 保留中の変更がある間に編集可能なグリッドから、ユーザーが並べ替え、フィルター、グループ化、改ページ、ナビゲーション操作を実行したとき

事前準備

各イベントにサンプルスクリプトを実装します。今回は各イベントがどのように呼ばれるかわかるようスクリプトを挿入します。

1. Dynamics 365 にログインします

2. [設定] > [カスタマイズ] > [システムのカスタマイズ] をクリックします。

3. Web リソースにスクリプトを登録します。

function Do_OnRecordSelect()
{
var selectedRows = Xrm.Page.getControl("crmGrid").getGrid().getSelectedRows();
var massage = "";
selectedRows.forEach(function (selectedRow, i) {
var entityname = selectedRow.getData().getEntity().getEntityName();
var name = selectedRow.getData().getEntity().getAttributes().getByName("name").getValue();
massage = massage + entityname + "、" + name + "\n";
});
Xrm.Utility.alertDialog(massage + "を選択しました",null);
return;
}

function Do_OnChange()
{
var selectedRows = Xrm.Page.getControl("crmGrid").getGrid().getSelectedRows();
var massage = "";
selectedRows.forEach(function (selectedRow, i) {
var entityname = selectedRow.getData().getEntity().getEntityName();
var name = selectedRow.getData().getEntity().getAttributes().getByName("name").getValue();
massage = massage + entityname + "、" + name + "\n";
});
Xrm.Utility.alertDialog(massage + "を変更しました",null);
return;
}

function Do_OnSave()
{
var selectedRows = Xrm.Page.getControl("crmGrid").getGrid().getSelectedRows();
var massage = "";
selectedRows.forEach(function (selectedRow, i) {
var entityname = selectedRow.getData().getEntity().getEntityName();
var name = selectedRow.getData().getEntity().getAttributes().getByName("name").getValue();
massage = massage + entityname + "、" + name + "\n";
});
Xrm.Utility.alertDialog(massage + "を保存しました",null);
return;
}