我在 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 字符串。
这是添加快速搜索过滤器的代码块(整个方法的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 UI 是如何处理这个问题的,但我的问题是如何动态地对查找/视图应用快速搜索过滤,以正确过滤相关实体的主要名称属性?
[编辑澄清]
快速搜索(或快速查找)是 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 中的更改(添加/删除实体、添加/删除/更新视图)需要更新代码以匹配。