MS CRM 2011 剖析Form与Dialog的URL

 

原创地址：http://www.cnblogs.com/jfzhu/archive/2012/10/12/2721888.html

转载请注明出处

 

Microsoft Dynamics CRM本质上只是一个ASP.Net程序，当然它是一个很厉害的，高手们开发出来的程序。基本上每一个窗口或者对话框都有固定的URL，这些窗口或对话框的特性也是由URL中的query string来决定。也就是说，如果你知道了某个窗口或对话框的URL是什么，你就可以在扩展CRM时，用JScript来打开这个窗口或对话框了。

 

下面举一个简单的例子来看如何获得一个窗口的URL，以及这个URL能给我们什么信息。打开一个客户：

你可以点击上面的复制链接来获取URL，你也可以Ctrl + N，然后从地址栏复制URL。

复制出来的URL为：

http://yourserver/yourorganization/main.aspx?etc=1&extraqs=formid%3d0d6c2857-e8ca-435a-a830-a335ab2139fb&id=%7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d&pagetype=entityrecord

从这个URL我们可以得到的信息为etc(entity type code)为1，也就是客户的object type code值为1。我们现在打开的这个表单的Form ID为0d6c2857-e8ca-435a-a830-a335ab2139fb。该客户的ID为7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d。如果你要打开一个联系人的窗口，你只需要知道这个联系人的ID，联系人的object type code，以及要用哪一个Form打开（Form ID）。其实在SDK中有一个章节已经把这个部分讲的很明白了，大家可以参见SDK中“Open Forms, Views, and Dialogs with a URL”这一章节。

 

对于一个窗口或者表单（Form），我们已经知道如何查看它的URL了，但如果是一个对话框（Dialog），我们如何查看它的URL呢？比如点击客户上的Parent Company查找按钮，就可以弹出一个对话框来。通常在这个对话框中，你是看不到URL的。

我在之前的文章向大家介绍过使用F12 Developer Tools来对CRM进行剖析，这一文章中，我再向大家介绍另一个利器，来帮助我们获得对话框的URL，它就是Fiddler。当然Fiddler绝不只是用来获取URL的，它的功能非常强大，有兴趣的同学可以参看http://www.fiddler2.com/fiddler2/。首先启动Fiddler。

然后点击Parent Company查找按钮，Fiddler可以显示出你访问过的URL是什么。

选择带有lookup的那一行记录，复制URL，复制结果为：

http://yourserver/yourorganization/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=1&DefaultViewId=%7bA9AF0AB8-861D-4CFA-92A5-C6281FED7FAB%7d&DisableQuickFind=0&DisableViewPicker=0&LookupStyle=single&ShowNewButton=1&ShowPropButton=1&browse=0&currentid=%7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d&objecttypes=1
857-e8ca-435a-a830-a335ab2139fb&id=%7b8650EB9D-AAC5-E111-AD1C-00155DA83B2B%7d&pagetype=entityrecord

 

由于上面的URL是被encode过的，所以不是很容易读，我推荐大家再使用一个URL Decoder/Encoder的网站来帮助你对URL解码。

解码后的URL为：

http://yourserver/yourorganization/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=1&DefaultViewId={A9AF0AB8-861D-4CFA-92A5-C6281FED7FAB}&DisableQuickFind=0&DisableViewPicker=0&LookupStyle=single&ShowNewButton=1&ShowPropButton=1&browse=0&currentid={8650EB9D-AAC5-E111-AD1C-00155DA83B2B}&objecttypes=1
857-e8ca-435a-a830-a335ab2139fb&id={8650EB9D-AAC5-E111-AD1C-00155DA83B2B}&pagetype=entityrecord

 

我们来看URL里的参数：

（1）objecttypes：这个参数后边的数值表示可以查找的entity type code，这里的１表示是客户，如果我们还想查找联系人，可以将这里改为objecttypes=1,２。 （2）DefaultType：默认的查找entity

（3）DefaultViewId： 对默认entity的默认View

（4）DisableQuickFind： 对应Search栏

（5）DisableViewPicker： 不允许改变View

（6） LookupStyle：决定是多选(multi)还是单选(single)

（7） ShowNewButton：显示New按钮

（8）ShowPropButton：显示Properties按钮

（9）browse：决定lookfor, view, search整个这些是否存在，1为不存在

我们来构建一个URL，实现以下功能：

（1）objecttypes：可查找类型为客户、联系人（entity type code 1, 2） （2）DefaultType：默认的查找entity为联系人

（3）DefaultViewId： 不使用这个参数，可以让系统决定使用哪个view

（4）DisableQuickFind： 不disable

（5）DisableViewPicker： disable

（6） LookupStyle：单选

（7） ShowNewButton：不显示

（8）ShowPropButton：不显示

（9）browse：0

构建好的URL应为：

http://yourserver/yourorganization/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=2&DisableQuickFind=0&DisableViewPicker=1&LookupStyle=single&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2

将这个URL直接复制到IE中打开，看到结果为：

在JS中，如何利用这个URL来打开对话框呢？我们可以使用window.showModalDialog这个方法。举一个例子，我们为一个联系人选择parent customer。

在JS中，使用以下代码：

var url = Xrm.Page.context.prependOrgName("/_controls/lookup/lookupinfo.aspx?"
+ "AllowFilterOff=0&DefaultType=2&DisableQuickFind=0&DisableViewPicker=1" 
+ "&LookupStyle=single&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2");
var result = window.showModalDialog(url);
if (result != null) {
    var value = new Array();
    value[0] = new Object();
    value[0].id = result.items[0].id;
    value[0].name = result.items[0].name;
    value[0].entityType = result.items[0].type == 1 ? "account" : "contact";
    Xrm.Page.getAttribute("parentcustomerid").setValue(value);
}

再进阶一下，看一个多选的例子。我们要写一封email，我们要选择收件人：

我们可以使用以下的URL及JScript：

/_controls/lookup/lookupinfo.aspx?AllowFilterOff=0&DefaultType=1&DisableQuickFind=0&DisableViewPicker=1&LookupStyle=multi&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2

注意参数中的值是multi，不是multiple。

var url = Xrm.Page.context.prependOrgName("/_controls/lookup/lookupinfo.aspx?"
+ "AllowFilterOff=0&DefaultType=1&DisableQuickFind=0&DisableViewPicker=1"
+ "&LookupStyle=multi&ShowNewButton=0&ShowPropButton=0&browse=0&objecttypes=1,2");
var result = window.showModalDialog(url);
if (result != null) {
    var value = new Array();
    for (var i = 0; i < result.items.length; i++) {
        value[i] = new Object();
        value[i].id = result.items[i].id;
        value[i].name = result.items[i].name;
        value[i].entityType = result.items[i].type == 1 ? "account" : "contact";
    }
    Xrm.Page.getAttribute("to").setValue(value);
}