Dynamics CRM 2011 编程系列（3）：JS脚本编程之onsave事件

这节我们来学习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(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。