SalesforceSOQL和SOSL参考手册_SalesforceObjectQueryLanguage资源-CSDN文库

salesforce

需积分: 5 96 浏览量 2024-05-25 16:01:09 上传评论收藏 1.58MB PDF 举报

资源推荐

资源详情

资源评论

SOQL and SOSL Reference

Version 61.0, Summer ’24

Last updated: May 17, 2024

CONTENTS

Chapter 1: Introduction to SOQL and SOSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 2: Salesforce Object Query Language (SOQL) . . . . . . . . . . . . . . . . . . . . . . . . . 3

Typographical Conventions in This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Quoted String Escape Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Reserved Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Alias Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

SOQL SELECT Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

SELECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

TYPEOF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

USING SCOPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

WHERE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

WITH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

GROUP BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

HAVING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

ORDER BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

LIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

OFFSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

FOR VIEW and FOR REFERENCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

FOR UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

SOQL SELECT Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

SOQL SELECT Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Aggregate Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

convertCurrency() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

convertTimezone() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

FORMAT () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

GROUPING(fieldName) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

toLabel() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Relationship Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Understanding Relationship Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Using Relationship Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Understanding Relationship Names, Custom Objects, and Custom Fields . . . . . . . . . . . 66

Understanding Query Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

null Values in Lookup Relationships and Outer Joins . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Identifying Parent and Child Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Understanding Relationship Fields and Polymorphic Fields . . . . . . . . . . . . . . . . . . . . . 72

Understanding Relationship Query Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Using Relationship Queries with History Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Using Relationship Queries with Data Category Selection Objects . . . . . . . . . . . . . . . . . 78

Using Relationship Queries with the Partner WSDL . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Change the Batch Size in Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

SOQL Limits on Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

SOQL with Big Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Syndication Feed SOQL and Mapping Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Location-Based SOQL Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Chapter 3: Salesforce Object Search Language (SOSL) . . . . . . . . . . . . . . . . . . . . . . . . 90

Typographical Conventions in This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

SOSL Limits on Search Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

SOSL Limits on External Object Search Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

SOSL Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Example Text Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

convertCurrency() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

FIND {SearchQuery} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

FORMAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

IN SearchGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

LIMIT n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

OFFSET n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

ORDER BY Clause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

RETURNING FieldSpec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

toLabel(fields) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Update an Article’s Keyword Tracking with SOSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Update an Article’s Viewstat with SOSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

USING Listview= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

WHERE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

WITH DATA CATEGORY DataCategorySpec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

WITH DivisionFilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

WITH HIGHLIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

WITH METADATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

WITH NETWORK NetworkIdSpec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

WITH PricebookId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

WITH SNIPPET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

WITH SPELL_CORRECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Contents

CHAPTER 1 Introduction to SOQL and SOSL

If you’ve built a custom UI for Salesforce, you can use the Salesforce Object Query Language (SOQL) and

Salesforce Object Search Language (SOSL) APIs to search your organization’s Salesforce data.

This guide explains when to use SOQL and SOSL and outlines the syntax, clauses, limits, and performance

considerations for both languages. It is intended for developers and assumes knowledge and experience

working with APIs to interact with data.

Deciding Which to Use

A SOQL query is the equivalent of a SELECT SQL statement and searches the org database. SOSL is a

programmatic way of performing a text-based search against the search index.

Whether you use SOQL or SOSL depends on whether you know which objects or fields you want to

search, plus other considerations.

Use SOQL when you know which objects the data resides in, and you want to:

•

Retrieve data from a single object or from multiple objects that are related to one another.

•

Count the number of records that meet specified criteria.

•

Sort results as part of the query.

•

Retrieve data from number, date, or checkbox fields.

Use SOSL when you don’t know which object or field the data resides in, and you want to:

•

Retrieve data for a specific term that you know exists within a field. Because SOSL can tokenize

multiple terms within a field and build a search index from this, SOSL searches are faster and can

return more relevant results.

•

Retrieve multiple objects and fields efficiently where the objects might or might not be related to

one another.

•

Retrieve data for a particular division in an organization using the divisions feature.

•

Retrieve data that’s in Chinese, Japanese, Korean, or Thai. Morphological tokenization for CJKT terms

helps ensure accurate results.

Note: SOSL doesn’t support big objects.

Performance Considerations

To increase the efficiency of queries and searches, keep in mind:

•

Both SOQL WHERE filters and SOSL search queries can specify text you should look for. When a

given search can use either language, SOSL is generally faster than SOQL if the search expression

uses a CONTAINS term.

•

SOSL can tokenize multiple terms within a field (for example, multiple words separated by spaces)

and builds a search index off this. If you’re searching for a specific distinct term that you know exists

within a field, you might find SOSL is faster than SOQL for these searches. For example, you might

剩余127页未读，继续阅读

评论收藏

内容反馈

weixin_30777913

粉丝: 297
资源: 78

Salesforce SOQL和SOSL参考手册

最新资源

Salesforce SOQL和SOSL参考手册

salesforce soql sosl技术文档

Salesforce对象和语言参考手册

Salesforce SOQL

salesforce使用手册.pdf

[Salesforce] Salesforce CRM 权威管理手册 第2版 英文版

salesforce crm中文手册

一个轻量级的，基于Java的，摆动驱动的SalesForce SOQL编辑器Cirrostratus-开源

salesforce公式参考手册.pdf

SalesForce.com Explorer

Salesforce 电力_销售流程操作手册_中文版.xlsx

[Salesforce] Salesforce CRM 权威管理手册 第1版 (英文版)

Salesforce入门手册.pdf

jsforce:用于JavaScript应用程序的Salesforce API库（在Node.js和Web浏览器上）

node-red-salesforce:具有预安装的Salesforce节点的Heroku的Node-RED实例

salesforce使用手册

Salesforce Assistant-crx插件

Salesforce入门手册.zip

Salesforce Data Loader Guide

Salesforce

epson L4158 L4168 废墨收集垫清零软件

店铺图片抓手，一款完全免费的下载店铺商品图片的工具

电子面单转换器软件，单号转换抖音面单，物流同步工具

免费版WPS2019

自媒体+小红书+实操经验

基于遗传算法的simulink/PID参数整定(s函数）

餐饮餐厅饭店小票模板1

小狐狸CHATGPT智能问答AI创作系统v1.6.4 PHP源码

bartender2022标签条码编辑软件

全国最全水系shp 矢量

最新资源

[Salesforce] Salesforce CRM 权威管理手册第2版英文版

[Salesforce] Salesforce CRM 权威管理手册第1版 (英文版)