c# - CRM FetchXml，如何动态添加与相关实体名称匹配的快速搜索过滤器？

Question

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

我获取所选实体/ View 的 FetchXML，然后获取所选实体的快速搜索 View 的 FetchXML，提取 isquickfindfields=1 的过滤器节点，将 {0} 替换为他们在搜索框中键入的内容，插入将修改后的节点放入选中 View 的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>

当我插入搜索文本并执行 View 时，我从 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 字符串与实体引用的主要名称属性相匹配。

这是添加快速搜索过滤器的代码块(整个方法的 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 用户界面如何处理这个问题，但我的问题是如何在查找/ View 上动态应用快速搜索过滤，以正确过滤相关实体的主要名称属性？

---

[编辑澄清]

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

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

动态地，我的意思是我的代码没有一堆预定义的 FetchXML 字符串；它没有针对特定实体、 View 或搜索要求进行编码；并且不需要每次添加或更改新实体或 View 时都对其进行修改。也许“动态”在这种情况下不是一个好词，但我不知道还能怎么调用它。实体/ View 不可知？

我不想要这样的代码:

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 中的更改(添加/删除实体、添加/删除/更新 View )需要更新代码以匹配。

Answer 1

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

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

因此，以获取帐户为例，我认为您需要编辑 xml，以便 id 属性附加 name，例如主要联系人 ID 名称。这是 FilteredView 中数据库列的名称，我相信它可以从 FetchXml 获得。 (如果这不起作用，请添加一个带有名称过滤器的 link-entity 并删除现有条件)。

所以你知道什么时候附加 name 我建议:

1. 检索快速查找 View 搜索条件。
2. 针对每个条件使用元数据服务搜索 CRM
3. 如果字段类型是 EntityReference，则使用适当的条件更新快速查找 View 搜索。