Salesforce 连接器

Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.
Salesforce API 身份验证遵循 OAuth 2.0 标准。以下过程概述了如何生成刷新令牌，然后任何 Tulip 应用程序都将使用刷新 令牌检索成功连接到 Salesforce 所需的访问令牌。

1. 在 Salesforce 中创建一个连接应用程序。为此，请导航到 Salesforce 的 "设置 "空间。然后，导航至平台工具 >> 应用程序 >> 连接的应用程序 >> 管理连接的应用程序。
2. 创建一个新的连接应用程序。b. 选择启用 OAuth 设置，并输入回调 URL 作为https://login.salesforce.com/services/oauth2/success 。
3. 完成后，单击 "管理消费者详细信息"查看 "消费者密钥 "和 "消费者秘密"。稍后将使用这些信息。
4. 现在在 Tulip 中打开连接器功能**[设置] 获取 Auth 代码 URL**。复制并粘贴上述步骤 3 中生成的 "消费者密钥"，作为查询参数client_id。
5. "运行 "连接器函数。
6. 观察连接器 "输出 "生成的 URL。将该 URL 粘贴到浏览器窗口中。
7. 完成出现的验证提示，成功授权 Tulip 与 Salesforce 实例交互。
8. 如果成功，浏览器会重定向到一个新页面，上面写着 "远程访问应用程序授权"。授权代码可以在该页面的 URL 中找到。 例如，在 URLhttps://login.salesforce.com/services/oauth2/success?code=asdf1234中，授权代码为asdf1234。
9. 保存此授权码。请注意，代码必须以两个等号结束：==。 如果代码以%3D%3D 结束，请删除这些字符并替换为==。
10. 导航到**[设置] 获取刷新令牌**郁金香连接器功能。在 "查询参数 "中，粘贴上面收集的所有信息：
    • grant_type= 授权代码
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= 上文步骤 3 中的消费者密钥
    • client_secret= 上述步骤 3 中的用户密钥
    • code=上述步骤 9 中的授权代码
11. 运行此连接器，并保存响应中显示的refresh_token。
12. 最后，导航到**[Auth] 获取访问令牌**连接器函数。填写以下查询参数：
    • grant_type= 授权代码
    • client_id= 上述步骤 3 中的消费者密钥
    • client_secret= 上述步骤 3 中的用户密钥
    • refresh_token=上述步骤 10 中的刷新令牌
13. 运行连接器。请注意，响应包括一个access_token，它被映射为输出。保存连接器以保存刷新令牌

一旦该函数能够生成访问令牌，设置就完成了！现在，只要步骤 2 中配置的超时设置允许，该access_token就可以在任何后续 Connector 函数中使用。

郁金香连接细节

要使连接器与 Salesforce 接口，请在连接器的连接详细信息下输入 Salesforce 实例的子域作为 "默认子域"。 例如，如果 Salesforce 实例位于 sample.my.salesforce.com，则默认子域应为sample.my。

请注意，此处的所有连接器功能都是为与 Salesforce REST API v46.0 配合使用而构建的。

连接器功能

连接器主要有两种类型：对象类型连接器和查询类型连接器。请注意，这两种连接器都需要访问令牌，因此在使用前请确保在应用程序中运行**[Auth] Get Access Token**！通常建议在应用程序或进程启动时生成一个新的访问令牌，并将其保存到应用程序变量中以便以后使用。

对象类型连接器

• 返回相关对象的所有字段。
• 使用端点./services/data/v46.0/sobjects/<Object Name>/<Object ID>
• 示例连接器**[机会] 获取所有字段**

查询类型连接器

• 仅返回查询中指定的字段。
• 可返回链接信息（如与机会相关的账户名称）或汇总信息（如记录计数）。
• 使用端点./services/data/v46.0/query
• 要求使用 SOQL 编写查询（此处的文档{target=_blank}）。
• 示例连接器**[订单] 获取所有状态订单**

包含的连接器函数

本软件包包含以下连接器函数，旨在介绍通过 Salesforce API 可以实现的功能：* [Setup] Get Auth Code URL & [Setup] Get Refresh Token *仅用于首次设置。更多信息请参阅上文。* [Auth] Get Access Token *用于生成访问令牌，该令牌必须包含在所有后续连接器函数中： * 获取所有字段 *返回所查询机会的所有字段。需要访问令牌和机会 ID。 * 更改阶段 *将指定机会的阶段更新为指定值： * 获取所有状态订单 *返回指定状态的所有订单列表。 * 计算状态订单数 *返回指定状态的所有订单数。 * 从 ID 获取订单号 * 从指定的订单 ID 返回订单号。

要修改这些函数以满足您的需要，请注意以下建议：1.要修改对象类型连接器函数，只需更改 URL 中指示的对象。2. 要修改查询型连接器功能，必须在查询中进行所有更改。这可以在查询参数中找到，关键字为q。提示：使用函数 LIMIT(number_of_responses) 限制查询的回复数

找到要找的内容了吗？

您还可以前往community.tulip.co发布您的问题，或查看其他人是否遇到过类似问题！