Retrieves data from the Salesforce customer relationship platform using Salesforce Object Query Language (SOQL) queries.
How does it work?
SalesforCeconnector使用Salesforce Lightning Platform REST API执行SOQL SELECT语句。每个返回的记录都是FME中的一个功能。
Refer to theSalesforce’s SOQL SELECT Syntaxdocumentation for information on how to build a valid SOQL SELECT statement.
SalesforceConnector authenticates with Salesforce using OAuth 2.0.
Configuration
输入端口
Input
This transformer accepts any feature.
Output Ports
Output
This transformer outputs a new feature for each record returned by the SOQL SELECT Statement.
TheAttributes to Expose参数可用于公开SOQL SELECT语句返回的字段。此外，以下属性始终暴露：
Attribute |
Description |
|---|---|
| salesforce_instance_url | 使用Salesforce实例的完全限定URL。 |
| salesforce_record_url | The URL that uniquely identifies the Record that this feature represents. It can be appended to salesforce_instance_url to obtain a fully-qualified URL. |
| salesforce_record_type | 此功能代表的记录类型。通常，这是从SOQL SELECT语句的部分右侧的右侧的值。 |
<被拒绝>
outp特性,导致手术失败ut through this port. Anfme_rejection_codeattribute, having the valueERROR_DURING_PROCESSING, will be added, along with a more descriptivefme_rejection_messageattribute which contains more specific details as to the reason for the failure.
不te:If a feature comes in to the SalesforceConnector already having a value forfme_rejection_code, this value will be removed.
拒绝功能处理：can be set to either terminate the translation or continue running when it encounters a rejected feature. This setting is available both as a defaultFME optionand as aworkspace parameter.
Parameters
Connection
| Salesforce Account | Performing operations against a Salesforce account requires the use of OAuth 2.0 authentication using a Web Connection. To create a Salesforce connection, click the 'Salesforce Account' drop-down box and select 'Add Web Connection...'. The connection can then be managed via Tools -> FME Options... -> Web Connections. |
要求
HDFS Path
| SOQL SELECT Statement | The Salesforce Object Query Language SELECT statement to send to Salesforce to retrieve records. Example: SELECT Name FROM Account |
| 包括已删除的记录 | If this parameter is set toYes, the QueryAll endpoint is used in order to include all deleted and archived records. |
Advanced
Attributes to Expose |
A list of attributes to expose on output features. These attributes should correspond to the fields specified by the SOQL SELECT Statement. |
API Version |
The Salesforce API Version to use for the request, for example,“41.0”. The available Record types and fields may change between API Versions. The default is to use the latest available version. It is an error to specify an API Version that is unrecognized by the Salesforce instance. |
Editing Transformer Parameters
使用一组菜单选项，可以通过引用工作区中的其他元素来分配变压器参数。一些变压器也可提供更高级的功能，例如高级编辑器和算术编辑器。要访问这些选项的菜单，请单击
除适用的参数旁边。有关更多信息，请参阅Transformer Parameter Menu Options.
定义值
There are several ways to define a value for use in a Transformer. The simplest is to simply type in a value or string, which can include functions of various types such as attribute references, math and string functions, and workspace parameters. There are a number of tools and shortcuts that can assist in constructing values, generally available from the drop-down context menu adjacent to the value field.
How to Set Parameter Values
Using the Text Editor
The Text Editor provides a convenient way to construct text strings (including regular expressions) from various data sources, such as attributes, parameters, and constants, where the result is used directly inside a parameter.
Using the Arithmetic Editor
The Arithmetic Editor provides a convenient way to construct math expressions from various data sources, such as attributes, parameters, and feature functions, where the result is used directly inside a parameter.
Conditional Values
Set values depending on one or more test conditions that either pass or fail.
Parameter Condition Definition Dialog
Content
Expressions and strings can include a number of functions, characters, parameters, and more - whether entered directly in a parameter or constructed using one of the editors.
Content Types
| These functions manipulate and format strings. | |
| A set of control characters is available in the Text Editor. | |
| Math functions are available in both editors. | |
| These operators are available in the Arithmetic Editor. | |
| These return primarily feature-specific values. | |
| 可以使用FME和工作区的参数。 | |
| Working with User Parameters | Create your own editable parameters. |
Reference
Processing Behavior |
|
Feature Holding |
不 |
| Dependencies | Salesforce account |
| FME Licensing Level | FME Base Edition and above |
| Aliases | |
| History | 发布FME 2018.0. |
| Categories |
FME Community
The FME Community is the place for demos, how-tos, articles, FAQs, and more. Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.
Search forall results about the SalesforceConnectoron the FME Community.