Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

时间:2021-08-05 09:16:18

      这节我们来学习Dynamic CRM脚本编程中的onsave事件。因为Dynamics CRM是基于实体的系统,所以日常的开发点主要都专注于实体的开发,通常都会涉及到如下场景:1)验证实体上某一属性的值是否合法;2)通过实体的某一个属性或多个属性来计算出实体中的另一个属性值;3)控制实体上的某一属性是否开放或是否按某一策略进行开放或关闭。

      这节中要介绍的onsave事件大多用在上面介绍的场景1,2,3,。接下来我们尝试着在“客户”实体上简单的实现一个onsave事件:在客户实体保存时判断“客户”实体中的“主要电话”属性是否合法。具体操作如下图。注:本节的介绍的知识建立在上一节《Dynamics CRM 编程系列(2):JS脚本编程之onload事件》。

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-1  打开“客户”实体下的某一条记录

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-2 进入“客户”实体的“窗体”界面,获取属性“主要实体”的名称

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图3-3

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-4  编程Onsave事件需要使用的脚本

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-5

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-6

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-7

 

Dynamics CRM 2011 编程系列(3):JS脚本编程之onsave事件

图 3-8

 

 CheckPhoneNumber的代码为:

function CheckPhoneNumber(eContext)
{
var rgx=/^\d{11}$/;
var phoneNumberAttribute=Xrm.Page.getControl("telephone1").getAttribute().getValue();
if(phoneNumberAttribute.match(rgx)==null)
{
alert("主要电话填写错误,请重新填写.");
//event.returnValue=false; //unsupport
eContext.getEventArgus().preventDefault();
}

}


小结:实体的Onload事件和Onsave事件是Dynamics CRM 脚本编程的重点,在日常的开发工作中会有很多开发工作会在这里进行。CheckPhoneNumber代码中涉及的脚本“Xrm.Page.getControl("telephone1").getAttribute().getValue()”是Dynamics CRM提供的API,这段代码的的功能是:获取实体属性名称为“telephone1”的值。在后续的章节中我会详细讨论这套API。