MS CRM 4中，添加营销列表成员查找列

    MS CRM4中，市场营销列表成员（其架构名称是listmember）是一个系统内部所使用的实体，没有被开放出来，在实体列表中是看不到该实体的。正好群里面有一个帖子，询问如何在营销列表中添加对联系人的“公司电话”的搜索。默认情况下，是对联系人名称或者客户名称进行搜索。

    下图是所有的市场营销列表成员

    在搜索框中输入“张三”，可以得到名字为“张三”的联系人记录，如下如所示

    而输入“123”这个查找条件，代表着我希望“公司电话”也作为查找列，可惜，结果不如所愿——没有匹配的记录结果，如下图所示。

    由此可见，系统只将“全名”字段作为查找列，需求来了，需要将联系人的“公司电话”也作为查找列，怎么办？我的解决方式就是Plugin，对“Execute”消息进行捕获，在plugin中编写代码进行处理。

    创建一个plugin，注册时，将消息设定为Execute，然后debug代码，得到IPluginExecutionContext类型的输入参数的值如下图所示。

    从上图可见，InputParameters有一个Key名称为“FetchXml”的元素值，其对应的Value是一个fetchxml字符串，内容如下：

<fetch distinct="false" mapping="logical">
    <entity name="contact">
        <attribute name="fullname" />
        <attribute name="address1_city" />
        <attribute name="telephone1" />
        <attribute name="contactid" />
        <filter type="and">
            <filter type="or">
                <condition attribute="fullname" operator="like" value="123%" />
            </filter>
        </filter>
        <order attribute="fullname" descending="false" />
        <link-entity name="listmember" to="contactid" from="entityid" link-type="inner" alias="listmember0">
            <filter type="and">
                <condition attribute="listid" operator="eq" value="{FDA0C303-D308-E011-90D0-00155D000107}" />
            </filter>
        </link-entity>
    </entity>
</fetch>

    OK，看到这个字符串，很明显，可以看到查询条件就是标记为红色那一行，大胆猜测一下，我添加一个条件，设定其attribute的值为“telephone1”，那么就可以将“公司电话”也作为查找列了。

    开始编码……，还是稍等一下吧。因为Execute方法并非就当前这一个地方使用了，例如，利用联系人Grid上的搜索框进行查找时，系统也是用Execute方法。所以，还需要在代码中使用各类条件进行判断以缩小范围，做到只有在营销列表成员中查找联系人时，才将联系人的“公司电话”列作为查找列，那么如何做到这一点呢，解决方法就在“link-entity"节点中。

    前文说了，listmember是一个内部使用的实体，所以，将link-entity节点下的属性”name”、“to”作为判断条件，以限定、缩小范围，从而满足只有在营销列表成员中查找联系人时，才将联系人的“公司电话”列作为查找列这一目标。

    基于以上，写出了代码

if (context.MessageName == "Execute")
{
    string fetchXml = (string)context.InputParameters["FetchXml"];
    XmlDocument doc = new XmlDocument();
    doc.LoadXml(fetchXml);
    XmlNodeList linkEntityNodeList = doc.GetElementsByTagName("link-entity");
    if (linkEntityNodeList !=null && linkEntityNodeList.Count > 0)
    {
        string nameAttrValue = linkEntityNodeList[0].Attributes["name"].Value;
        string toAttrValue = linkEntityNodeList[0].Attributes["to"].Value;
        if (nameAttrValue == "listmember" && toAttrValue == "contactid")
        {
            XmlNode filterNode = doc.SelectSingleNode("/fetch/entity/filter/filter");

            if (filterNode != null)
            {
                XmlNode existConditionNode = filterNode.FirstChild;

                XmlElement conditionNode = doc.CreateElement("condition");
                conditionNode.Attributes.Append(doc.CreateAttribute("attribute")).Value = "telephone1";
                conditionNode.Attributes.Append(doc.CreateAttribute("operator")).Value = "like";
                conditionNode.Attributes.Append(doc.CreateAttribute("value")).Value = existConditionNode == null ? "" : existConditionNode.Attributes["value"].Value;

                filterNode.AppendChild(conditionNode);
            }
        }
    }

    context.InputParameters["FetchXml"] = doc.OuterXml;
}

 

 

 

    编译、部署，测试，结果如下图所示

    输入电话号码，可以得到张三这条记录

    输入“张三”，也可以得到张三这条记录

 

    当然，测试没有进行彻底，不清楚是否对其他的部分造成什么影响。只能够算是指出来一个想法吧。