MS CRM 2011中过滤化查询的实现方法

MS CRM 2011中过滤化查询的实现方法

    使用过滤化查询，可以实现根据表单上的其他信息作为搜索条件，限制Lookup查找框中的搜索结果数量的目的。

在讲解具体的实现方法之前，先设定一个应用场景：

    实体配置信息列表：

省份	New_province
		名称	New_name
城市	New_city
		名称	New_name
		省份	New_provinceId	关联省份N:1
Demo4FilterView	Demo4FilterView
		名称	New_name
		省份	New_provinceId	关联省份N:1
		城市	New_cityId	关联城市N:1

    录入数据

北京	东城
	西城
	海淀
上海	浦东
	静安
	卢湾
江苏	南京
	无锡
	苏州

    要完成的目标是，在Demo4FilterView表单中，如果省份选择了北京，那么城市Lookup字段的查找对话框中，只能够出现“东城”/“西城”/“海淀”，依此类推“上海”、“江苏”。

    MS CRM 4.0中，实现方式网上已经有不少的文章了，可以看星吧客的文章《MSCRM4 在过滤后的Lookup框中实现查找》，我就不再重复了。

    下面说一下在ms crm 2011中，如何实现这种过滤化视图。

    实现的方式有两种，一种是配置，一种是脚本编写。

    我们首先说一下配置的方式。

    打开表单编辑器，效果如下图所示

    点击“城市”字段 àRibbon工具条的“更改属性”按钮，系统弹出“字段属性”对话框。如下图所示。

    在对话框中，有一个部分，叫做“相关记录筛选”，在该部分，勾选“仅在以下情况下显示记录”。勾选之后，该checkbox下方的两个下拉框就变成可以选择的状态，此时，在上面的下拉框中选择“省份（Demo4FilterView）”，下方的下拉框中选择“省份（城市）”，如下图所示。

 

    此设置的意义在于，设定如果在Demo4FilterView表单中，设定了省份信息，那么城市信息就会按照省份——城市之间的关联关系进行数据筛选，而筛选结果将作为点击“城市”字段时Lookup查找对话框Grid中的结果。

    效果如下图所示。

    可见，如果省份字段设定的“北京”，那么城市字段的查找对话框记录就是北京下属的各个城市记录。而且，在查找对话框中还多出一个界面元素，名为“按相关的省份筛选”。

    除了上面说的这个方法，另一个就是编写代码来实现过滤化查询的效果。

    其基本的原理和MS CRM 4中的实现方式类似，都是在省份字段的OnChange事件中，根据省份字段的现有值，设定城市字段的过滤条件。在MS CRM 2011中，产品组专门为了过滤化查询添加了新的方法和属性，并不再使用MS CRM 4中的AdditionalParams以及lookupbrowse两个属性，而是使用addCustomView方法。    addCustomView方法的签名如下：

        function addCustomView(viewid,entityName,sName,sFetchXml,sLayoutXml,isDefault)

    其中，

• viewid，是提供的自定义视图的id值，意义不是很大，只要是一个Guid值就可以；
• entityName，是过滤化视图所查询的实体的名称；
• sName，是过滤化视图的名称；
• sFetchXml，是过滤化视图的查询条件；
• sLayoutXml，是过滤化视图的展现样式；
• isDefault，是设定过滤化视图是否是默认的视图；

    我当前的样例中，这些输入参数的设定如下：

• viewid，使用省份字段的主键值；
• entityName，因为是查询城市实体，所以值为”new_city”；
• sName，过滤化视图的名称，就叫做“过滤化视图”
• sFetchXml，查询的逻辑是处于活动状态的，而且省份字段值为给定省份的城市记录，使用高级查找，完成该查询条件的创建，如下图所示。

点击Ribbon工具条的“下载Fetch Xml”按钮，下载此fetchxml文件。该文件的内容如下所示

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">

<entity name="new_city">

<attribute name="new_cityid" />

<attribute name="new_name" />

<attribute name="createdon" />

<order attribute="new_name" descending="false" />

<filter type="and">

<condition attribute="statecode" operator="eq" value="0" />

<condition attribute="new_provinceid" operator="eq" value="{BD2078E7-4D3C-E011-A7FA-00155D00010A}" />

</filter>

</entity>

</fetch>

    注意红色粗体字标识的部分，该部分内容，需要修改，变成选定的省份记录的主键值，后面的Javascript代码中会看到。

    sLayoutXml，是查询结果的展现样式字段，我的做法是利用上面获取FetchXml的高级查找，点击Ribbon工具条的“编辑列”按钮，设定查找结果的输出样式信息，如下图所示。

    设定完成后，点击Ribbon工具条的“保存”按钮，将当前的高级查找保存为一个用户视图，我设定的该用户视图的名称为mytestfilterview_city。如下图所示

    而后，打开SQL server Management Studio，连接到CRM的数据库，输入查询语句

        select Name, fetchxml, layoutxml from userquery where Name = 'mytestfilterview_city'，如下图所示。

    如此，即获得了layoutxml信息了。

    在搞定了所有的输入参数信息后，编写的脚本如下所示。

function DoProvinceChanged()

{

var provinceValue = Xrm.Page.getAttribute("new_provinceid").getValue();

if (provinceValue != null)

{

var provinceId = provinceValue[0].id;

var entityName = "new_city";

var viewId = provinceId;

var viewName = "过滤化视图";

var fetchXml = "<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='false'><entity name='new_city'><attribute name='new_cityid' /><attribute name='new_name' /><attribute name='createdon' /><order attribute='new_name' descending='false' /><filter type='and'><condition attribute='statecode' operator='eq' value='0' /><condition attribute='new_provinceid' operator='eq' value='" + provinceId + "'/></filter></entity></fetch>";

var layOutXml = "<grid name='resultset' object='10004' jump='new_name' select='1' icon='1' preview='1'><row name='result' id='new_cityid'><cell name='new_name' width='300'/><cell name='ownerid' width='100'/><cell name='new_provinceid' width='100'/><cell name='statecode' width='100'/></row></grid>";

var cityControl = Xrm.Page.getControl("new_cityid");

cityControl.addCustomView(viewId, entityName, viewName, fetchXml, layOutXml, true);

}

}

    脚本的基本逻辑是：

• 首先判断省份字段是否有值，如果没有，就不做处理了；
• 获取省份字段的guid值，存放于变量provinceid中；
• 为输入参数viewid赋值，其值为provinceid；
• 设定输入参数entityName的值为“new_city”；
• 设定输入参数viewName的值为“过滤化视图”；
• 设定输入参数fetchXml的值，注意，红色粗体标识的部分，我已经将原有的value="{BD2078E7-4D3C-E011-A7FA-00155D00010A}"更改为value='" + provinceId + "'，这样，才实现了根据省份的不同，筛选出不同的城市记录；
• 设定输入参数layOutXml的值；
• 调用城市字段的addCustomView方法

    将该脚本作为web resources上传到crm服务器，设定省份字段的Onchange事件的处理函数为上面完成的函数DoProvinceChanged，保存，发布之后，效果出来了，如下图所示。