客户端 API 表单上下文

客户端 API 窗体上下文（formContext）提供对窗体或窗体上的项的引用，例如快速视图控件或可编辑网格中的行，而当前代码将对其执行。

之前，你使用了全局 Xrm.Page 对象来表示窗体或窗体上的项。 在 最新版本中， Xrm.Page 对象已 弃用。 请改用传入执行上下文对象的 getFormContext 方法返回对相应窗体或窗体上的项的引用。

使用 formContext 对象而不是 Xrm.Page 对象

可以轻松地转换使用 Xrm.Page 来使用新 formContext 对象的现有代码。 例如，请考虑使用以下使用 Xrm.Page 对象的脚本：

function displayName()
{
   var firstName = Xrm.Page.getAttribute("firstname").getValue();
   var lastName = Xrm.Page.getAttribute("lastname").getValue();
   console.log(firstName + " " + lastName);
}

下面是使用传入的执行上下文检索 formContext 对象的更新脚本，而不是使用静态 Xrm.Page 对象：

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 对象以编程方式操作模型驱动应用程序中的数据和用户界面元素。

数据对象

提供用于处理表单数据的属性和方法，包括表格数据和业务流程控制中的数据。 包含以下对象：

它还提供了一个属性集合，以访问不依赖表的控件。 请参阅本文后面的 formContext 对象模型部分中的 Collections 。

详细信息： formContext.data

ui 对象

除了表单或网格的多个子组件集合外，还提供检索有关用户界面的信息的方法。 包含以下对象：

详细信息： formContext.ui

formContext 对象模型中的集合

下表介绍了 Xrm 对象模型中的集合。 有关一般集合可用的方法的信息，请参阅集合（客户端 API 参考）。

相关文章

getFormContext 方法
getGlobalContext 方法
getAttribute 方法
getControl 方法
执行上下文方法