Salesforce系列（五）：Salesforce Apex基础SOSL查询和数据添加！

Salesforce系列（五）：Salesforce Apex基础SOSL查询和数据添加！

---

前言

今天博主将为大家分享:Salesforce系列（五）：Salesforce Apex基础SOSL查询和数据添加！！不喜勿喷，如有异议欢迎讨论！

再看这篇文章前博主郑重推荐大家前往阅读我的VsCode安装汉化等系列文章，点这里跳转：VsCode系列（一）：下载安装及汉化 以及 Salesforce系列（一）：使用Visual Studio Code进行开发！

Salesforce对象搜索语言（SOSL）是一种Salesforce搜索语言，用于在记录中执行文本搜索。使用SOSL在Salesforce中跨多个标准和自定义对象记录搜索字段。 SOSL类似于Apache Lucene。
向Apex添加SOSL查询非常简单 – 您可以直接在您的Apex代码中嵌入SOSL查询。当SOSL嵌入在Apex中时，它被称为在线SOSL。

这是SOSL查询的一个例子，该查询搜索具有任何字段“CYJ”的客户和联系人。

List<List<SObject>> searchList = [FIND 'CYJ' IN ALL FIELDS RETURNING Account(Name),Contact(FirstName,LastName)];

---

SOQL与SOSL的差异与相似性

与SOQL一样，SOSL允许您搜索组织的记录以获取特定信息。与一次只能查询一个标准或自定义对象的SOQL不同，单个SOSL查询可以搜索所有对象。

另一个区别是SOSL匹配基于单词匹配的字段，而默认情况下SOQL执行完全匹配（当不使用通配符时）。例如，在SOSL中搜索“Digital”会返回字段值为“Digital”或“The Digital Company”的记录，但SOQL只返回字段值为“Digital”的记录。

SOQL和SOSL是两种不同语法的独立语言。每种语言都有一个独特的用例：

使用SOQL检索单个对象的记录。
使用SOSL跨多个对象搜索字段。 SOSL查询可以搜索对象上的大多数文本字段。

我们来试试，进入工作台点击设置齿轮按钮（如果还没注册推荐阅读博主的：Salesforce系列（0）：Salesforce注册开发者账号！），进入开发者控制台（Developer Console）。窗体开启后点击Debug，将要运行的代码复制进去（从“调试”菜单中打开“执行匿名”窗口。），勾选“open log”------点击“Execute”执行这段代码，想要显示运行后和我的截图一样，就勾选Debug only，和Filter过滤并显示调试内容。

// 添加客户和相关联系人
Account acct = new Account(
    Name='SFDC Computing',
    Phone='(415)555-1212',
    NumberOfEmployees=50,
    BillingCity='San Francisco');
insert acct;

// 一旦插入客户，sObject将填充一个ID。
// 获取这个ID
ID acctID = acct.ID;

// 添加一个联系人到这个客户。
Contact con = new Contact(
    FirstName='Carol',
    LastName='Ruiz',
    Phone='(415)555-1212',
    Department='Wingo',
    AccountId=acctID);
insert con;

// 添加没有联系人的客户
Account acct2 = new Account(
    Name='The SFDC Query Man',
    Phone='(310)555-1213',
    NumberOfEmployees=50,
    BillingCity='Los Angeles',
    Description='Expert in wing technologies.');
insert acct2;

---

使用查询编辑器（Query Editor）

开发者控制台提供查询编辑器控制台，使您可以运行SOSL查询和查看结果。查询编辑器提供了一种快速检查数据库的方法。在将它们添加到您的Apex代码之前，测试您的SOSL查询是一个好方法。当您使用查询编辑器时，您只需提供没有围绕它的Apex代码的SOSL语句。

让我们尝试运行以下SOSL示例：

1. 在开发者控制台中，点击 Query Editor 标签。
2. 将以下内容复制并粘贴到查询编辑器下的第一个框中，然后单击 Execute.

FIND {Wingo} IN ALL FIELDS RETURNING Account(Name),Contact(FirstName,LastName,Department)

您组织中符合标准的所有客户和联系人记录都将显示在“查询结果”部分中作为包含字段的行。结果按每个对象（客户或联系人）的选项卡进行分组。 SOSL查询返回具有与Wingo匹配的字段的记录。根据我们的样本数据，只有联系人具有Wingo值的字段，因此此联系人将被返回。

注意：

查询编辑器和API中的搜索查询必须用大括号（{Wingo}）括起来。相反，在Apex中，搜索查询包含在单引号（’Wingo’）内。

---

基本的SOSL语法

SOSL允许您指定以下搜索条件：

- 文本表达（单个单词或短语）来搜索
- 要搜索的字段的范围
- 要检索的对象和字段的列表
- 在源对象中选择行的条件

这是一个基本的SOSL查询语法：

FIND 'SearchQuery' [IN SearchGroup] [RETURNING ObjectsAndFields]

*SearchQuery是要搜索的文本（单个单词或短语）。搜索项可以与逻辑运算符（AND，OR）和括号组合。此外，搜索字词可以包含通配符（*，？）。 通配符在搜索项的中间或末尾匹配零个或多个字符。这个？通配符只匹配搜索项中间或末尾的一个字符。

文本搜索不区分大小写。例如，搜索客户，客户或CUSTOMER都会返回相同的结果。

SearchGroup是可选的。这是搜索领域的范围。如果未指定，则默认搜索范围是所有字段。 SearchGroup可以采取以下值之一。

ALL FIELDS
NAME FIELDS
EMAIL FIELDS
PHONE FIELDS
SIDEBAR FIELDS

ObjectsAndFields是可选的。它是在搜索结果中返回的信息 – 一个或多个sObjects的列表，并且在每个sObject中，包含一个或多个字段的列表，并带有可筛选的值。如果未指定，则搜索结果包含找到的所有对象的ID。

---

单词和短语

SearchQuery包含两种类型的文本：

Single Word— 单个单词，如test或hello。 SearchQuery中的单词由空格，标点符号和从字母到数字的变化（反之亦然）分隔。单词总是不区分大小写的。

Phrase— 由双引号包围的单词和空格的集合，如“约翰史密斯”。多个单词可以与逻辑和分组操作符组合在一起，形成一个更复杂的查询。

---

SOSL Apex示例

此示例显示如何在Apex中运行SOSL查询。这个SOSL查询通过使用OR逻辑运算符来组合两个搜索项 – 它在任何字段中搜索Wingo或SFDC。此示例返回所有示例客户，因为它们每个都有一个包含其中一个单词的字段。 SOSL搜索结果以列表形式返回。每个列表包含返回记录的数组。在这种情况下，列表有两个元素。在索引0处，列表包含客户数组。在索引1处，列表包含联系人数组。

在开发者控制台的“执行匿名”窗口中执行此代码段。接下来，检查调试日志以验证是否返回所有记录。

List<List<sObject>> searchList = [FIND 'Wingo OR SFDC' IN ALL FIELDS 
                   RETURNING Account(Name),Contact(FirstName,LastName,Department)];
Account[] searchAccounts = (Account[])searchList[0];
Contact[] searchContacts = (Contact[])searchList[1];

System.debug('Found the following accounts.');
for (Account a : searchAccounts) {
    System.debug(a.Name);
}

System.debug('Found the following contacts.');
for (Contact c : searchContacts) {
    System.debug(c.LastName + ', ' + c.FirstName);
}

• 您可以筛选，重新排序和限制SOSL查询的返回结果。因为SOSL查询可以返回多个sObjects，所以这些过滤器应用在RETURNING子句中的每个sObject中。

• 您可以通过在对象的WHERE子句中添加条件来过滤SOSL结果。例如，这只会导致其行业服装被退回的客户：退货客户（名称，行业）行业=’服装’）

• 同样，通过为一个对象添加ORDER BY来支持一个sObject的排序结果。例如，这会导致返回的客户按名称字段排序：RETURNING客户（名称，行业ORDER BY名称）。

• 返回记录的数量可以限制为记录的一个子集。此示例将返回的客户限制为10个：RETURNING Account（Name，Industry LIMIT 10）

---

到这里:Salesforce系列（五）：Salesforce Apex基础SOSL查询和数据添加！分享完毕了，快去试试吧！

---

最后

• 更多参考精彩博文请看这里：《陈永佳的博客》

• 喜欢博主的小伙伴可以加个关注、点个赞哦，持续更新嘿嘿！

---