Dynamics CRM Online 2015 Update 1 SDK 新機能: フォームスクリプトのサブグリッドの制御 その 3
みなさん、こんにちは。
前回に引き続き Dynamics CRM Online 2015 Update 1 で提供される
フォームスクリプトのサブグリッド制御を紹介します。
前回記事からの続きとなりますので、まだご覧になっていない場合
以下のリンクよりご確認ください。
フォームスクリプトのサブグリッドの制御 その 1
フォームスクリプトのサブグリッドの制御 その 2
今回は ViewSelector オブジェクトを紹介します。
ViewSelector オブジェクト
ViewSelector オブジェクトは Grid オブジェクトより getViewSelector
関数で取得します。ViewSelector オブジェクトは以下の関数を持ちます。
- getCurrentVIew: 現在のビューを取得します。
- setCurrentView: ビューを設定します。
- isVisible: ビューセレクターが表示されているか確認できます。
早速試してみましょう。
isVisible と getCurrentView の利用
1. 以前の記事で作成した Web リソースを開きます。
2. 新しく以下の関数を追加します。
function viewSelectorSample()
{
// viewSelector の取得
var selector = Xrm.Page.getControl("Contacts").getViewSelector();
// ビューの表示状況を確認
if(selector.isVisible())
{
alert("ビューは選択可能です。");
}
else
{
alert("ビューは選択不可能です。");
}
// 現在のビューを確認
var current = selector.getCurrentView();
alert("エンティティタイプ: " + current.entityType + "\nビューの id: " + current.id + "\nビューの名前: " + current.name);
}
3. 保存して、Web リソースを公開します。
4. 取引先企業のフォームの OnLoad に設定します。尚、以前設定した
ものは削除してください。
5. 保存してカスタマイズを公開します。
動作確認
1. 任意の取引先企業レコードを開きます。以下のメッセージが
表示されます。
2. ビューの選択ができない状態になっているので、フォームの
カスタマイズより、取引先担当者サブグリッドのビュー選択を
可能に変更します。
3. カスタマイズを公開後、再度取引先企業レコードを開くと以下の
メッセージが出ます。
setCurrentView の利用
最後に異なるビューをサブグリッドに設定してみます。
1. 設定 | カスタマイズ | システムのカスタマイズより、エンティティ |
取引先担当者 | ビューを選択します。
2. サブグリッドに設定したい任意のビューを開きます。この記事では
「あなたがフォローする」を利用してみます。アドレスバーの
URL より id を抜き出します。
3. 先ほどの Web リソースに新しい関数を追加します。
function changeViewSample()
{
// 新しいビューの作成
var ContactsIFollow = {
entityType: 1039, // SavedQuery
id:"{3A282DA1-5D90-E011-95AE-00155D9CFA02}",
name: "あなたがフォローする 取引先担当者"
};
// ビューの設定
Xrm.Page.getControl("Contacts").getViewSelector().setCurrentView(ContactsIFollow);
}
4. 保存して Web リソースを公開します。
5. 取引先企業フォームのカスタマイズより、任意のフィールドの
OnChange イベントに作成した関数を設定します。この記事では
説明フィールドを利用しました。
6. 変更を保存してカスタマイズを公開します。
動作確認
1. 任意の取引先企業レコードを開きます。取引先担当者のサブグリッド
のビューが既定であることを確認します。
2. 説明列を変更します。取引先担当者のサブグリッドビューが更新
されたことを確認します。
まとめ
今回のリリースではサブグリッドの操作が非常に柔軟になりました。
これによりあるサブグリッドビューの OnLoad イベントを利用して
他のサブグリッドのビューを変更するなど、今までできなかった
事が出来るようになっています。是非お試しください！
- 中村 憲一郎