Dynamics 365中的Client API form context (formContext)

适用于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对象，它们允许你通过编程方式操作数据和用户界面元素。

Dynamics 365中的Client API form context (formContext)-LMLPHP

data对象

data对象用于访问entity数据，提供了管理form、business process flow控件中数据的方法。包含以下对象：

它也提供了一个用于访问未绑定entity的控件的属性集。详见文章的稍后部分的 formContext对象模型中的集合。

更多信息：formContext.data

UI对象

提供在UI中检索信息的方法，除了from或grid的某些子组件外，它还包含以下对象：

更多信息：formContext.ui

formContext对象模型中的集合

下面的表格描述了Xrm对象模型中的集合。关于通常的集合的可用方法的信息，参看Collections (Client API reference).。

氢氦