CRM FetchXml,如何动态添加与相关实体名称匹配的quicksearch过滤器?

时间:2013-03-13 15:41:43

标签: c# dynamics-crm-2011 fetchxml

我在CRM之外有一个网页,允许用户执行CRM查找。我需要使用快速搜索来实现对查找结果的过滤,就像在普通的CRM UI中一样。

我获取所选实体/视图的FetchXML,然后为所选实体的快速搜索视图获取FetchXML,提取过滤器节点,其中isquickfindfields = 1,将{0}替换为他们在搜索框中键入的内容,插入将节点修改为所选视图的FetchXML,然后执行它。

我遇到的问题是某些快速搜索过滤器针对相关实体的id字段,但匹配需要违反该实体的主要名称属性。

例如,这里是对帐户实体的快速搜索:

<fetch version="1.0" output-format="xml-platform" mapping="logical">
<entity name="account">
    <attribute name="name" />
    <attribute name="primarycontactid" />
    <attribute name="address1_city" />
    <attribute name="telephone1" />
    <attribute name="emailaddress1" />
    <order attribute="name" descending="false" />
    <filter type="and">
        <condition attribute="statecode" operator="eq" value="0" />
    </filter>
    <filter type="or" isquickfindfields="1">
        <condition attribute="primarycontactid" operator="like" value="{0}" />
        <condition attribute="telephone1" operator="like" value="{0}" />
        <condition attribute="emailaddress1" operator="like" value="{0}" />
        <condition attribute="accountnumber" operator="like" value="{0}" />
        <condition attribute="name" operator="like" value="{0}" />
    </filter>
    <attribute name="accountid" />
</entity>

当我插入搜索文本并执行视图时,我从RetrieveMultiple中收到此错误:

An exception System.FormatException was thrown while trying to convert input value '%acme%' to attribute 'account.primarycontactid'. Expected type of attribute value: System.Guid. Exception raised: Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

如果我使用普通的CRM界面,对帐户进行查找并在快速搜索框中输入联系人姓名,则搜索按预期工作(列出主要联系人姓名是我输入的帐户)。因此,我假设当CRM查询数据库时,它会“智能地”匹配实体引用的主要名称属性中的非Guid字符串。

以下是添加quicksearch过滤器的代码块(整个方法的pastebin):

if (string.IsNullOrWhiteSpace(searchString) == false)
{
    var quickSearch = CRMCache.SavedQueries.FirstOrDefault(q => q.ReturnedTypeCode == view.ReturnedTypeCode && q.QueryType == SavedQueryQueryType.QuickFindSearch);
    if (quickSearch != null)
    {
        var quickSearchXml = XElement.Parse(quickSearch.FetchXml);
        var quickSearchFilter = quickSearchXml.XPathSelectElement("//filter[@isquickfindfields=1]");
        foreach (var condition in quickSearchFilter.Elements("condition"))
        {
            condition.SetAttributeValue("value", string.Format(condition.Attribute("value").Value, "%" + searchString + "%"));
        }

        viewEntityNode.Add(quickSearchFilter);
    }
}

虽然我很好奇普通CRM用户界面如何处理这个问题,但我的问题是如何在查找/视图上动态应用快速搜索过滤,以便正确过滤相关实体的主要名称属性?


[编辑说明]

快速搜索(或快速查找)是CRM中的一种视图类型。它定义了当用户在快速搜索框中输入文本或过滤查找时搜索的属性。所有实体都有快速搜索视图,实体只能有一个。

匹配相关实体名称的要求来自快速搜索视图。并非所有这些都包含实体引用的过滤器,但是当它发生时,我需要匹配名称而不是guid。由于普通的CRM UI正确地将搜索字符串应用于相关实体的名称,即使快速搜索视图的FetchXML具有针对id的过滤器,我也认为CRM在内部处理了该案例。显然,情况并非如此(我得到的错误表明了这一点)。所以我需要检测这种情况并做一些不同的事情,我想动态地这样做。

动态地,我的意思是我的代码没有一堆预定义的FetchXML字符串;它不是针对特定实体,视图或搜索要求编码的;并且每次添加或更改新实体或视图时都不需要修改它。也许“动态”在这种情况下不是一个好词,但我不知道还有什么可以称之为。实体/视图无关的?

我不想要这样的代码:

SearchResults ExecuteView(string entityLogicalName, string searchString)
{
    switch(entityLogicalName)
    {
        case "account":
            return searchAccounts(searchString);

        ... all other enties ...

        default:
            throw new Exception("Unknown entity type: " + entityLogicalName);
    }
}


SearchResults searchAccounts(searchString)
{
    var fetchXml = string.Format(@"
<fetch>
      <entity name=""account"">
        <link-entity name=""contact"" from=""contactid"" to=""primarycontactid"">
            <attribute name=""name"" alias=""name"" />
            <filter type=""and"">
                <condition attribute=""name"" operator=""like"" value=""%{0}%"" />
            </filter>
        </link-entity>
      </entity>
</fetch>", searchString);

    return executeSearch(fetchXml);
}

因为CRM中的更改(添加/删除实体,添加/删除/更新视图)需要更新代码才能匹配。

3 个答案:

答案 0 :(得分:2)

我不知道CRM如何使用字符串来搜索guid,但我怀疑它会执行一些预处理或一些可能无法使用的后端内容。 (我想如果你真的想知道你可以尝试反编译CRM。但这可能需要一段时间)。

作为替代方案,我建议您进一步操作FetchXml的处理阶段,如果您在元数据服务的帮助下执行此操作,您应该能够在没有任何硬编码的情况下离开。

因此,以帐户提取为例,我相信您需要修改xml,以便id属性附加name,例如primarycontactidname。这是FilteredView中数据库列的名称,我相信它可以从FetchXml中获得。 (如果不起作用,请添加link-entity,并为名称添加过滤器并删除现有条件。

所以你知道何时追加name我会建议:

  1. 检索快速查找视图搜索条件。
  2. 对于每种情况,请使用元数据服务来搜索CRM
  3. 如果字段类型为EntityReference,则使用适当的条件更新快速查找视图搜索。

答案 1 :(得分:2)

我投了詹姆斯的回答,因为我确实认为这是你问题的正确答案。但是,总体而言,更好的解决方案可能是为您希望从网页中搜索的每个实体创建一个特殊的系统视图。使用命名约定,以便您的网页知道要查找的系统视图。在“系统视图”中,在条件字段中指定{0},然后像往常一样在代码中替换它。这样,您可以创建所需的任何复杂FetchXML,而无需查询元数据服务的开销。对于奖励积分,请禁用此新系统视图,使其在CRM用户界面中不可见。

- 以下评论后的补充:

快速查找实际上并不“过滤查找/视图”。在CRM UI的“快速查找”框中键入查询时,它不会过滤当前视图 - 使用“快速查找”视图显示结果(请参阅“查看”下拉列表)。正如您所见,此视图使用特殊的FetchXML - 它使用“isquickfindfields”属性。此属性必须是CRM UI的标志,以便在提交查询之前预处理此FetchXML并更新节点以更正这些关系字段的FetchXML。

如果您打算在此备用用户界面中显示所有系统视图,但允许所有系统视图通过类似于“快速查找”搜索框的内容进行过滤,那么您所说的内容与CRM用户界面不同一点都不:)

如果您正在讨论在此备用UI中仅使用相同的“快速查找”视图参数,那么我的建议仍然是在CRM中创建一个模拟“快速查找”视图的隐藏系统视图。此视图后面的FetchXML将是“正常”,您将能够插入搜索文本而无需调用元数据服务。

答案 2 :(得分:0)

我希望我理解你的问题。 primarycontactid不是一个guid,代表一个记录,在这种情况下,一个联系人。除非你的用户知道搜索这个字段的每个记录的guid是没有意义的。但是你想在联系人里面搜索所以你必须做一个链接(相当于在sql中加入),请看这里如何使用FetchXml和链接实体的例子:

现在您要做的一个例子:

<fetch>
      <entity name="account">
        <link-entity name="contact" from="contactid" to="primarycontactid">
            <attribute name="name" alias="name" />
            <filter ... />
        </link-entity>
      </entity>
</fetch>

动态执行C#中的FetchXML:

string fetchrequest = string.Format(
@"<fetch mapping='logical' aggregate='true'>
    <entity name='queueitem'>
        <attribute name='queueitemid' alias='c' aggregate='count'/>
        <filter type='and'>
            <condition attribute='objecttypecode' operator='ne' value='4406'/>
            <condition attribute='queueid' operator='eq' value='{0}'/>
        </filter>
    </entity>
</fetch>", queueid.ToString());

string fetchresult = crmservice.Fetch(fetchrequest);
XmlDocument document = new XmlDocument();
document.LoadXml(fetchresult);
Console.Writeline("numero de elementos:" + document.SelectSingleNode("//resultset/result/c").InnerText));