適用於Dynamics 365 for Customer Engagement apps 9.x版本。

本文是一篇翻譯，原文來源是微軟官方文件。

本文連結：https://www.cnblogs.com/hhelibeb/p/11042391.html 

概述

Client API form context (formContext)提供了對當前程式碼執行的上下文中的form或對form上的item的引用，比如，一個quick view控制元件或者一個可編輯grid中的行。

在早期版本，全域性的Xrm.Page物件用於代表form或form中的item。在9.0版本中，Xrm.Page物件過時了，你應該使用被傳入的上下文物件的getFormContext方法獲取相應的from的引用。

注意：formContext物件允許你建立通用的事件處理器，根據呼叫位置來對form或可編輯grid進行操作。詳見getFormContext (Client API reference)。從ribbon action的Javascript函式中獲取formContext和從scripting中獲取它的方式是不同的。更多資訊：Form and grid context in ribbon actions.

使用formContext物件

以下是一段使用formContext物件的JS程式碼，通過傳入的執行上下文（executionContext）獲取formContext物件，

function displayName(executionContext)
{
    var formContext = executionContext.getFormContext(); // get formContext

    // use formContext instead of Xrm.Page  
    var firstName = formContext.getAttribute("firstname").getValue(); 
    var lastName = formContext.getAttribute("lastname").getValue();
    console.log(firstName + " " + lastName);
}

formContext 物件模型

使用formContext物件下的data和ui物件，它們允許你通過程式設計方式操作資料和使用者介面元素。

data物件

data物件用於訪問entity資料，提供了管理form、business process flow控制元件中資料的方法。包含以下物件：

它也提供了一個用於訪問未繫結entity的控制元件的屬性集。詳見文章的稍後部分的 formContext物件模型中的集合。

更多資訊：formContext.data

UI物件

提供在UI中檢索資訊的方法，除了from或grid的某些子元件外，它還包含以下物件：

更多資訊：formContext.ui

formContext物件模型中的集合

下面的表格描述了Xrm物件模型中的集合。關於通常的集合的可用方法的資訊，參看Collections (Client API reference).。

相關主題

getFormContext method

getGlobalContext method

Execution context methods

&n