将 Salesforce 与 IBM App Connect Enterprise 配合使用

Salesforce 是一个工作管理和项目跟踪应用程序，用于提供项目，任务，对话和仪表板，使团队能够在线协作和跟踪进度。 IBM® App Connect Enterprise 提供 Salesforce Input 和 Salesforce Request 节点，可用于与 Salesforce 应用程序进行交互。

准备工作

必须安装 IBM App Connect Enterprise 12.0.6.0 或更高版本才能使用此功能部件。

观看以下视频，其中演示了如何在 IBM App Connect Enterprise 中使用 Salesforce 输入节点：在 IBM App Connect Enterprise 12.0.6 中使用 Salesforce 输入节点。

关于此任务

IBM App Connect Enterprise 通过 Windows ， AIX和 Linux® 系统上可用的 Salesforce Input 和 Salesforce Request 节点与 Salesforce 同步通信。

使用 Salesforce 输入节点可监视 Salesforce 以获取新对象，例如新帐户，营销活动，联系人，商机和订单。有关使用 Salesforce 输入节点与 Salesforce 资源交互的更多信息，请参阅 Salesforce 输入节点。

使用 Salesforce 请求节点连接到 Salesforce ，并执行诸如创建，检索，更新和删除 Salesforce 对象 (例如帐户，附件，营销活动，案例，联系人，事件，商机，商机和订单) 之类的操作。有关详细信息，请参阅 Salesforce 请求节点。

要使用 App Connect Enterprise，您的 Salesforce 版本必须启用 API 访问。如果您想创建一个免费的 Salesforce 帐户，以便使用 App Connect Enterprise 进行测试，您可以创建并使用启用了 API 访问的 Developer 帐户。 Salesforce 试用帐户未启用 API ，并且无法用于 App Connect Enterprise。

对于可以使用同一 Salesforce 帐户并发进行的 Salesforce 请求数有限制。如果达到此限制，那么 Salesforce将拒绝使用同一 Salesforce 帐户的任何其他请求，并发生错误，指示您已超出组织对 Salesforce 帐户的并发用户限制。

Salesforce 针对贵组织的每个用户限制为 5 个已连接的应用程序。对已连接的应用程序进行第五次核准后，将撤销最旧的核准。在 App Connect 服务的实例中，避免在 App Connect 目录中的所有 Salesforce 应用程序中创建超过 5 个帐户。其他 Salesforce 连接的应用程序 (例如，用户代理流程) 也可能减少最多 5 个帐户。有关详细信息，请参阅 Manage OAuth-Enabled Connected Apps Access to Your Data 中的 Salesforce 文档。

以下步骤说明如何连接到 Salesforce 帐户，以及如何使用连接器发现来配置 Salesforce Request 节点。通过创建包含 Salesforce 输入节点的流并通过连接器发现对其进行配置，您可以遵循相同的过程来配置 Salesforce 输入节点，以监视 Salesforce 的新对象。

过程

在 IBM App Connect Enterprise Toolkit中，创建包含 Salesforce Request 节点的流。
在流中选择 Salesforce Request 节点以在编辑器中显示节点属性。
在基本选项卡上，单击启动连接器发现。
此时会显示一个面板，您可以在其中指定要在连接器发现期间使用的策略项目名称和保险库文件详细信息。
指定要在连接器发现期间使用的策略项目和保险库文件的详细信息：
1. 在策略项目字段中，指定用于存储连接器发现期间创建的策略的策略项目。
  也可以通过单击新建并指定新策略项目的名称来创建新的策略项目。然后单击完成。
2. 指定要在连接器发现期间使用的保险库文件。缺省情况下，连接器发现期间使用的凭证存储在外部目录保险库中，这是可供任何集成服务器使用的 App Connect Enterprise 保险库文件。或者，您可以将凭证存储在集成服务器保险库文件中，该保险库文件是在集成服务器的工作目录中创建的，并且只能由该特定集成服务器使用。
  要指定用于存储凭证的保险库文件，请完成下列其中一个主题的 使用连接器发现向导 部分中的步骤:
  - 配置外部目录保管库
  - 配置集成服务器保险库
3. 在保险库密钥字段中，输入用于访问保险库中存储的凭证的保险库密钥。保险库密钥的长度必须至少为 8 个字符。
4. 可选: 缺省情况下，指定的保险库文件位置和保险库文件密钥将另存为 Toolkit 中的首选项，以便在您启动 "连接器发现" 时预设这些值。如果您不希望保存这些首选项，请取消选中保存在保险库文件首选项中。
单击启动发现以启动 Salesforce 连接器的 "连接器发现" 向导。
此时将显示 " 连接器发现 " 窗口。如果现有 Salesforce 连接 (帐户) 可用，那么将显示这些连接的列表。如果没有现有连接，那么 Salesforce 连接器的状态显示为 Not connected。
- 如果一个或多个 Salesforce 连接 (帐户) 可用，请完成以下步骤:
  1. 通过单击连接（帐户）来选择要使用的连接（帐户）。
  2. 单击所需的对象类型，然后选择要对该对象执行的操作。例如，要检索联系人详细信息，请单击联系人，然后单击检索联系人。
- 如果没有现有连接（帐户），请完成以下步骤：
  1. 单击所需的对象类型，然后选择要对该对象执行的操作。例如，要从 Salesforce检索联系人详细信息，请单击联系人，然后单击检索联系人。
  2. 单击连接以创建新连接。
  3. 通过从下拉列表中单击下列其中一个选项，选择要用于连接到 Salesforce的授权方法 :
    1. 提供用户名，密码和客户机凭证 (OAUTH 2.0 PASSWORD)
    2. 提供凭证以供 App Connect 使用 (BASIC OAUTH)
  4. 请单击继续。
  5. 将显示一个窗口，根据您在上一步中选择的授权方法 (OAUTH 2.0 PASSWORD 或 BASIC OAUTH) ，在该窗口中输入帐户的连接详细信息:
    - 如果选择了 OAUTH 2.0 PASSWORD 认证，请输入以下详细信息:
      - 登录 URL ： Salesforce 实例的 URL ，格式为 https://login.salesforce.com
      - 用户名: Salesforce 帐户的用户名
      - 密码: Salesforce 帐户的密码，后缀为 Salesforce 安全性令牌
      - 客户机标识: 在 Salesforce 中为 App Connect 创建已连接应用程序时生成的使用者密钥
      - 客户机密钥: 在 Salesforce 中为 App Connect 创建已连接应用程序时生成的使用者密钥
    - 如果选择了 BASIC OAUTH 认证，请输入以下详细信息:
      - 定制 URL：
        
        对于生产实例，将该字段留空或输入 <instance>.salesforce.com
        
        对于沙箱，请输入 test.salesforce.com 或 <instance>.salesforce.com.
        
        对于子域:
        
        输入 <subdomain>.my.salesforce.com 以用于生产
        
        针对沙箱输入 <subdomain>--<sandboxname>.<instance>.my.salesforce.com
        
        输入 <subdomain>-dev-ed.my.salesforce.com for Developer Edition
      - 客户机标识: 在 Salesforce 中为 App Connect 创建已连接应用程序时生成的使用者密钥
      - 客户机密钥: 在 Salesforce 中为 App Connect 创建已连接应用程序时生成的使用者密钥
      - 访问令牌: 从应用程序客户机标识和客户机密钥生成的访问令牌
      - 刷新令牌: 从应用程序客户机标识和客户机密钥生成的刷新令牌
  6. 单击连接。
    凭证保存在保管库中，其他连接详细信息保存在 Salesforce 策略中。
    
    有关连接到 Salesforce 的更多信息、请参阅如何使用 IBM App Connect 和 Salesforce 文档中的 IBM App Connect Enterprise as a Service 。
在向导中设置必需的连接器属性。
您可以通过单击添加条件，然后选择要过滤的属性来添加用于检索数据的条件。例如，要检索具有特定姓氏的联系人，请单击添加条件，然后单击姓氏，然后输入所需值。您还可以设置一些属性，这些属性指定要检索的最大记录数以及在超过该限制时要执行的操作。
在“连接器发现”向导中指定完属性后，单击保存。您在向导中设置的属性值将返回到 IBM App Connect Enterprise Toolkit中的 Salesforce Request 节点。
在完成发现并保存属性值后，通过单击窗口右上角的 X 来退出"连接器发现"向导。
返回以编辑 IBM App Connect Enterprise Toolkit中的 Salesforce Request 节点。
现在，在 "连接器发现" 向导 (在步骤 6中) 中设置的连接器属性将显示在 Salesforce 请求节点中。

基本选项卡显示您在向导中设置的操作和对象属性的值。例如，如果您在向导中选择了联系人 > 检索联系人，节点的基本选项卡上将显示以下属性：
- 操作 - RETRIEVEALL
- 对象 - Contact
操作和对象属性的值将以只读格式显示。如果要更改这些值，您可以通过再次单击启动连接器发现并在“连接器发现”向导中设置新值来执行此操作。您可以通过单击属性旁边的编辑按钮来修改其他属性 (如果已设置)。

模式基本名称属性指定模式文件的基本名称，这些文件描述从 Salesforce 连接器发送和接收的请求和响应消息的格式。第一次对节点运行发现时，将自动设置模式基本名称，该名称基于当前流名称和节点名。如果在首次运行发现之前手动设置此属性，那么将使用您设置的值。如果在发现后重命名模式，那么必须编辑此属性，以使其与项目中重命名的模式所使用的模式基本名称相匹配。如果在发现后更改此属性，那么必须重命名模式名称以匹配或再次运行发现。

根据发现期间选择的操作， "连接器发现" 向导将生成请求模式和响应模式，或者仅生成响应模式。仅当所选操作和对象需要请求消息时，才会生成请求模式。生成的请求模式用于验证请求消息。如果操作为 RETRIEVE 或 DELETE，那么连接器仅返回响应模式。

生成的模式文件将添加到项目中，并且可供映射节点用于变换输入或输出数据。模式的完整文件名派生自模式基本名称，后缀为 response.schema.json 或 request.schema.json。您可以通过单击打开请求模式或打开响应模式来打开模式。
检查 Salesforce Request 节点上的属性设置是否正确，然后保存消息流。
在 Salesforce 请求节点的连接选项卡上，策略属性显示策略的名称，该策略包含要用于连接的安全身份的详细信息。策略的类型为 Salesforce。
可选: 在连接选项卡上设置超时属性，以指定节点等待 Salesforce 处理操作的时间 (以秒计)。缺省值为 60 秒。
Salesforce 请求节点的过滤器选项卡包含用于控制消息流选择数据的方式的属性。这些属性的初始值取自 "连接器发现" 向导中为 Salesforce 连接器设置的属性值 (如步骤 6中所述)。如果您随后返回到 "连接器发现" 向导并更改任何属性的值 (例如，通过添加新条件) ，那么这些更新将反映在节点上设置的属性中。

过滤器选项属性控制执行 Salesforce 请求节点时要对哪些对象进行操作。过滤器限制属性控制要检索的最大项数以及超出限制时要执行的操作。

您可以通过单击要在 " 过滤器选项 " 部分中修改的值旁边的编辑，并通过更改在过滤器限制部分中设置的属性值来修改值。

属性值可以是文本值，也可以是 ESQL 或 XPATH 表达式，在执行时从传递到 Salesforce Request 节点的消息内容解析这些表达式。
在请求选项卡上，设置数据位置属性以指定入局消息树中包含要在 Salesforce中创建的对象数据的位置。此数据构成从 Salesforce Request 节点发送到 Salesforce 系统的请求。
在结果选项卡上，设置输出数据位置属性以指定输出消息树中将包含在 Salesforce中创建的记录数据的位置。
缺省情况下，将根据连接器发现期间生成的请求模式验证请求消息。您可以通过使用 Salesforce 请求节点的验证属性来关闭请求验证或更改验证设置。
保存消息流。