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能给我们什么信息。打开一个客户:

image

你可以点击上面的复制链接来获取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的。

image

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

image

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

image

选择带有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解码。

image

解码后的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,这里的1表示是客户,如果我们还想查找联系人,可以将这里改为objecttypes=1,2。 (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为不存在

image

我们来构建一个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中打开,看到结果为:

image

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

image

在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,我们要选择收件人:

image

我们可以使用以下的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);
}


 

 

posted on 2012-10-12 20:43 JF Zhu 阅读(...) 评论(...) 编辑 收藏

导航

公告

统计