撰寫子格的指令碼

 

發行︰ 2016年11月

適用於： Dynamics CRM 2015

使用新的事件和物件，在 Microsoft Dynamics CRM Online 2015 更新 1 可以透過表單的子格控制項執行更多功能。

重要

如果是 Microsoft Dynamics CRM Online 組織，只有在組織已更新至 Dynamics CRM Online 2015 更新 1 時，才能使用此功能。 這項功能不適用於 Dynamics CRM (內部部署)。

本主題內容

子格 OnLoad 事件

子格物件模型

子格 OnLoad 事件

子格會從表單非同步載入，因此無法可靠地存取表單 OnLoad 事件中子格內的資料。 不過，您可以設定子格 OnLoad 事件的事件處理常式。 此事件將在每次資料格中的資料重新整理時發生，包括使用者排序資料格的欄時。

沒有使用者介面可用來新增此事件的新事件處理常式，因此，若要這麼做，您必須使用其他事件中的程式碼，通常是表單 OnLoad 事件，以使用 GridControl.addOnLoad 方法。 若要移除此事件的事件處理常式，請使用 GridControl.removeOnLoad 方法。

子格物件模型

下圖顯示可從表單中子格存取的物件。

在此內容中，子格控制項稱為 GridControl。 做為 Xrm.Page.ui 控制項，除了 refresh 方法之外，子格還具有所有控制項可使用的所有方法。

GridControl 是傳遞至命令列或功能區動作或規則的同一個物件，會在選取 SelectedControl 參數時使用可用的 <CrmParameter> (RibbonDiffXml)。

透過 ViewSelector 變更檢視表

當子格設定為顯示檢視表選取器時，您可以取得或設定目前檢視表。 使用 GridControl.getViewSelector 方法存取檢視表選取器，然後使用 ViewSelector.getCurrentViewgetCurrentView 和 ViewSelector.setCurrentView 方法透過查詢物件取得或設定目前檢視表。

從資料格取得資料

使用 GridControl.getGrid 方法存取資料格。 使用 Grid.getRows 方法或 Grid.getSelectedRows 方法取得 GridRow 物件的集合。 接著您可以將 GridRow.getData、GridRowData.getEntity 和 GridEntity.getEntityReference 方法鏈結在一起，存取資料列中每一筆記錄的參考。

另請參閱

Grid 物件和方法 (用戶端參考)
集合 (用戶端參考)
撰寫 Microsoft Dynamics CRM 2015 表單的程式碼
撰寫用戶端應用程式擴充功能

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權