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

    var firstName = formContext.getAttribute("firstname").getValue(); 
    var lastName = formContext.getAttribute("lastname").getValue();
    console.log(firstName + " " + lastName);
}

（译注：省略了原文中有关过时的Xrm.Page对象的部分）

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