撰寫子格的指令碼

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

您可以設定事件處理常式，在子格載入資料時執行指令碼。 這提供方法來變更所選的檢視表以及取得格線中顯示之資料的參照。

重要

CRM Online 2015 更新 1 和 CRM 2016 (內部部署) 已經引進此功能。

本主題內容

子格 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 365 表單的程式碼
在用戶端上擴充 Microsoft Dynamics 365

Microsoft Dynamics 365

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