这节我们来学习Dynamic CRM脚本编程中的onsave事件。因为Dynamics CRM是基于实体的系统,所以日常的开发点主要都专注于实体的开发,通常都会涉及到如下场景:1)验证实体上某一属性的值是否合法;2)通过实体的某一个属性或多个属性来计算出实体中的另一个属性值;3)控制实体上的某一属性是否开放或是否按某一策略进行开放或关闭。
这节中要介绍的onsave事件大多用在上面介绍的场景1,2,3,。接下来我们尝试着在“客户”实体上简单的实现一个onsave事件:在客户实体保存时判断“客户”实体中的“主要电话”属性是否合法。具体操作如下图。注:本节的介绍的知识建立在上一节《Dynamics CRM 编程系列(2):JS脚本编程之onload事件》。
图 3-1 打开“客户”实体下的某一条记录
图 3-2 进入“客户”实体的“窗体”界面,获取属性“主要实体”的名称
图3-3
图 3-4 编程Onsave事件需要使用的脚本
图 3-5
图 3-6
图 3-7
图 3-8
CheckPhoneNumber的代码为:
function CheckPhoneNumber() { var rgx=/^\d{11}$/; var phoneNumberAttribute=Xrm.Page.getControl("telephone1").getAttribute().getValue(); if(phoneNumberAttribute.match(rgx)==null) { alert("主要电话填写错误,请重新填写."); event.returnValue=false; } }
小结:实体的Onload事件和Onsave事件是Dynamics CRM 脚本编程的重点,在日常的开发工作中会有很多开发工作会在这里进行。CheckPhoneNumber代码中涉及的脚本“Xrm.Page.getControl("telephone1").getAttribute().getValue()”是Dynamics CRM提供的API,这段代码的的功能是:获取实体属性名称为“telephone1”的值。在后续的章节中我会详细讨论这套API。