MS CRM 2011 剖析Ribbon与背后的Jscript

超、凢脫俗 2021-11-22 10:44 235阅读 0赞

原创地址：[http://www.cnblogs.com/jfzhu/archive/2012/09/27/2706356.html][http_www.cnblogs.com_jfzhu_archive_2012_09_27_2706356.html]

转载请注明出处

在[上一篇文章][Link 1]里，我给大家介绍了如何向ribbon按钮传递参数，在这篇文章中，我和大家在一起深度剖析一下ribbon的定义文件以及后边的Jscript。

我们还以Connect按钮为例，看看Connect To Another和Connect To Me是怎样工作的。

![201209271717497078.png][]

在sdk\\resources\\exportedribbonxml文件夹中找到accountribbon.xml这个文件打开。我们先来找Connect To Another这个子选项的定义：

Command定义如下：

这个Command调用的是\_static/\_common/scripts/RibbonActions.js文件中Mscrm.RibbonActions.addConnectionFromForm这个函数，有几个参数比如FirstPrimaryItemId，PrimaryEntityTypeCode看起来也应该很眼熟，我们在上一篇文章中刚刚讲到。接下来要做的就是打开RibbonActions.js这个文件来看一下。有两种方法：（1）可以在CRM服务器上找到这个文件；（2）如果你用的是CRM Online，你就没有办法登陆到服务器了，介绍大家使用一个IE自带的工具F12 Developer Tools。

打开account的表单，然后按F12，就启动了Developer Tools。

[![image][]][image 1]

选择Script标签，然后在红色的标记里选择JS文件。因为这个文件是一个紧缩版的，难以阅读，所以将文件内容复制粘贴到Visual Studio中来进行搜索。

[![image][image 2]][image_image 2]

我把Mscrm.RibbonActions.addConnectionFromForm这个函数复制出来，放在这里：

Mscrm.RibbonActions.addConnectionFromForm = function (objectId, objectTypeCode, primaryControl, connectToMe) { 
        var $v_0 = String.format("pId={0}&pType={1}", CrmEncodeDecode.CrmNameValueEncode(objectId), CrmEncodeDecode.CrmNameValueEncode(objectTypeCode.toString())); 
        if (connectToMe) 
            $v_0 = String.format("{0}&connectToMe=true", $v_0); 
        openObj(Mscrm.EntityTypeCode.Connection, "", $v_0, null, Mscrm.NavigationMode.NavigationModeNewWindow, null) 
    };

就是这一小段代码完成了Connect按钮的功能。神秘的面纱被一点点揭开了。从这段代码中可以看到CRM系统中有一些自定义的JS函数，我们来一一看一下：

（1） String.format: 如果你懂 C\#的话，这个函数就不需要我介绍了，它就是用来格式化字符串的函数。因为在JS并不支持这个函数，所以有很多人都写过自己的JS版的String.format函数。现在CRM为我们写好了，为我们省了很多力气，感谢微软。举一个小例子，来看怎么用。

alert(String.format("Hello Mr.{0}", "Zhu")); 
    // Hello Mr.Zhu

（2） CrmEncodeDecode.CrmNameValueEncode：如果你要将一个字符串作为参数放在一个URL里，这个字符串是不能包含一些特殊字符的，比如空格，感叹号，所以字符串要进行编码。下面举一个小例子，可以看到空格的编码为20%，!的编码为21%。

alert(CrmEncodeDecode.CrmNameValueEncode("Good Morning!")); 
    //Good%20Morning%21

（3）openObj: 这个函数是用来打开一个新的表单的。你也可以自己试一试。

CRM中有无数的按钮，上面用了一个例子来教给大家如何发现ribbon和JS的工作原理。如果你感兴趣，你也可以研究一下其他的按钮。相信这个方法对大家日后的开发是有所帮助的。

转载于:https://www.cnblogs.com/jfzhu/archive/2012/09/27/2706356.html

[http_www.cnblogs.com_jfzhu_archive_2012_09_27_2706356.html]: http://www.cnblogs.com/jfzhu/archive/2012/09/27/2706356.html
[Link 1]: http://www.cnblogs.com/jfzhu/archive/2012/09/27/2706005.html
[201209271717497078.png]: /images/20211122/c8b4afaa119a482ab895b59590c01334.png
[image]: /images/20211122/cf700c2639004847b90dee26bd0298c3.png
[image 1]: http://images.cnblogs.com/cnblogs_com/jfzhu/201209/20120927221047657.png
[image 2]: https://images.cnblogs.com/cnblogs_com/jfzhu/201209/201209272211046900.png
[image_image 2]: /images/20211122/61a882b89b974bee805ed170346564e7.png