内容


使用 App Connect Professional 触发一条从 Salesforce CRM 到 Google 电子表格的销售商机流

一种为企业构建 App Connect 与 API Connect 间的项目流的无代码方法

Comments

简介

当您公司的市场和销售团队收集商机时,他们需要在整个销售周期中确保联系信息和细节准确无误。首先,将销售商机信息输入他们的销售管理软件,比如 Salesforce CRM。当其他部门需要访问此数据来建立报告时,销售团队可通过手动方式将此数据添加到电子表格中。这种手动做法很耗时且容易发生人为错误,最终可能引起对商机的困惑,甚至导致团队丢失商机或公司丢失一笔销量。要自动化此过程,可以创建一个从 Salesforce CRM 到电子表格工具(比如 Google Sheets)的数据流。

本教程将演示如何使用 IBM® App Connect 和 IBM API Connect 产品构建这样一种端到端流。首先,在 App Connect Professional 中构建一个项目并在 API Connect 中将它发布为 REST API。然后,在 App Connect Personal 中构建一个流,以便触发一个从 Salesforce 到 Google Sheets 中的工作表的流。最后,测试项目。按照本教程中的步骤,可以将此方法应用于企业中的其他手动流程。

构建您的应用程序需要做的准备工作

要完成本教程中的步骤,需要:

销售商机用例

作为其销售团队的季度总结的一部分,销售经理 Matt 必须将其团队生成的商机(和必要的细节)整合到一个 Google 电子表格中。他和他的团队没有太多的 Salesforce CRM 经验,所以在新商机输入 Salesforce CRM 中时,他们对手动将每条记录添加到电子表格中的过程表示担忧。Matt 想要一个简单的解决方案,以便在新商机添加到 Salesforce 中的帐户时帮助他的团队自动向 Google 电子表格添加一个条目。

Matt 向集成开发人员 Rob 寻求帮助。Rob 使用了 App Connect Professional 和 API Connect,帮助 Matt 实现了销售商机从 Salesforce 到 Google Sheets 的流程自动化。他在 App Connect Professional 中开发了一个业务流程(流),以便在 Salesforce 中创建商机记录。然后 Rob 将该项目发布到 API Connect,以便将它公开为 API。在 API Connect 中发布的 API 被用在一个应用程序开发人员开发的应用程序中。通过使用此应用程序,Matt 能够利用移动或 Web 应用程序来提供每条商机的细节。该 API 在内部遍历输入 App Connect Professional 或 API Connect 中运行的业务流程中的细节,以便在 Salesforce 中创建一条记录。

Rob 还配置了 IBM App Connect Personal,以向 Google 电子表格添加一个包含相关细节的条目。

这个用例采用了以下 4 个步骤:

  1. 在 App Connect Professional Studio 中创建一个项目。触发此项目时,在 Salesforce 中创建一条商机。
  2. 将该项目发布到 API Connect,以便将它公开为 REST API。然后,将该 REST API 公开为移动或 Web 应用程序。公开此 API 后,用户能提供商机数据,比如联系人的姓名和公司名称。
  3. 在 App Connect Personal 中,创建一个流,使用 Salesforce 作为触发器,并使用一个 Google 工作表作为操作。在 Salesforce 中创建商机后,会向该工作表添加相应的条目。
  4. 使用该应用程序在 Salesforce 中输入商机的联系信息。将联系信息输入该应用程序后,该项目会从 API Connect 触发到 App Connect Professional,以便在 Salesforce 中创建商机。在此期间,在 App Connect Personal 中触发从 Salesforce 到 Google 工作表的流,以便在 Google 工作表中创建一个条目。
1

在 IBM App Connect Professional 中构建该项目

使用您的 IBMid 登录到 IBM App Connect Professional。然后,创建一个新项目并编辑它

App Connect Professional Studio 随后会打开,并显示该业务流程。下图显示了上一节中描述的本教程中的用例的业务流程。

App Connect Professional Studio 业务流程
App Connect Professional Studio 业务流程

HTTP Connector-Receive Request 活动收到请求数据,然后触发该流。收到的输入数据(JSON 格式)传递到 Read JSON 活动。READ JSON 活动的输出作为输入数据传递到 Salesforce 连接器的 Create Objects 活动。

下面的示例展示了发送的 Request JSON:

{
"objects": {
"Lead": {
 "LastName": "Andy",
"Company": "Andy Enterprises"
 }
}
}

响应 ID 和成功响应被作为 JSON 发送给 HTTP Connector 的 Write JSON 和 Send Response 活动的用户。将用户输入映射到商机对象的 Salesforce Create Objects 活动。

要确保业务流程有效,请单击 Orchestration → Validate。显示了 “Orchestration is valid” 消息。

然后在 Salesforce CRM 上创建一个商机,并将响应发送回 API。下面的示例展示了 Send Response 活动收到的响应 JSON:

{
"results": {
"result": {
"id": "00Q2800000aFGwqEAG",
"success": "true"
}
}
}

要设计创建端到端流的业务流程,请执行以下步骤:

  1. 在 HTTP Receive Request 活动的 Configuration 选项卡上,输入 Request JSON 和 Response JSON(图 2)。然后,单击 Generate Swagger用于生成 Swagger 的请求和响应 JSON
    用于生成 Swagger 的请求和响应 JSON
  2. 可选:单击 Download Swagger 查看输出,以供参考。 下载 Swagger
    下载 Swagger
2

将项目发布到 App Connect,并将它作为 REST API 推送到 API Connect

生成 Swagger 并确认业务流程流有效后,将该流作为 REST API 推送到 IBM API Connect:

  1. 单击 Save 将该项目保存到云。
  2. 启动业务流程。
  3. 在 Configuration details 下,单击 Push the Project to API Connect 链接。 Publish to API Connect 按钮
    Publish to API Connect 按钮
  4. 在 Push to API Connect 窗口中的 Authentication 下,为 User ID 和 Password 输入您的 IBMid 凭证。然后,单击 Load Organizations
  5. 对于 Organizations 选项,选择一个已定义的组织,然后单击 Push to APIM 将该业务流程推送到 API Connect。 Push to API Connect 窗口
    Push to API Connect 窗口
  6. 在 Please wait 窗口中,单击 OK发布 API
    发布 API
3

在 App Connect Personal 上开发一个流,以发起该流

在等待 API 发布到 API Connect 的过程中,可以在 IBM App Connect Personal 中创建一个流。在本教程中,将创建一个流,以便在 Salesforce 中创建商机时自动向 Google 工作表添加条目。有关这些步骤的演示,请观看这个视频

要在 App Connect Personal 中创建一个流,请执行以下步骤:

  1. 转到 IBM App Connect Personal 页面
  2. 如果您已注册为可以使用 App Connect Personal,请登录到 App Connect Personal Designer。单击 Log in,并使用您的 IBMid 进行登录。如果尚未注册,请单击 Sign up。登录后,可以看到 App Connect Personal Dashboard。 App Connect Personal,专注于真正重要的事务
    App Connect Personal,专注于真正重要的事务
  3. 在 App Connect Personal Dashboard 页面上,单击 Applications 选项卡。此时将会显示一个端点或企业应用程序列表。
  4. 选择您想使用的触发器和操作应用程序。在我们的用例中,触发器应用程序是 Salesforce CRM,操作应用程序是 Google Sheets。
    1. 单击 Salesforce 展开它,然后单击 Connect to Salesforce 连接到您的用户帐户。
    2. 在 Salesforce 登录页上,输入您的 Salesforce 帐户的用户名和密码。
    3. 在 Allow access 页面上,允许访问 IBM App Connect 来使用或修改您的 Salesforce 帐户数据。
    4. 在 App Connect Personal 中的 Applications 选项卡上,单击 Google Sheets 展开它,然后单击 Connect to Google Sheets
    5. 在 Google Sheets application 页面上,单击 Connect your Google Sheets accounts
    6. 在下一个 Google 页面上,输入您的用户名和密码来验证您的 Google 帐户。
    7. 允许访问 App Connect 来使用您的 Google Sheets 数据。
    从应用程序库选择端点
    从应用程序库选择端点

    您现在已定义了触发器和操作应用程序。

  5. 在 App Connect Personal 中创建一个流:
    1. 单击 Dashboard
    2. 单击 New 图标,然后单击 Create an event-driven flow
    3. 在页面左侧中央的加号 (+) 下,定义您启动该流的方式。首先,从应用程序列表,选择流的触发器,在本例中为 Salesforce。
      1. 展开 Salesforce
      2. 选择触发器对象,在本例中为 New Lead。该对象被添加到触发器 Salesforce。 将对象添加到触发器
        将对象添加到触发器
      3. 在 What do you want to add? 下的应用程序列表中,添加一个应用程序。在此示例中,展开 Google Sheets
      4. 选择操作。对于 Google Sheets,请单击 Create a Row
      5. 选择 SpreadsheetWorksheet。然后,选择 Google Sheets 帐户的工作表的行标题。输入必要的细节,以便从 Salesforce 字段映射它们。

        或者,可以单击 Auto Match Fields,自动将字段从 Salesforce 映射到 Google Sheets。此选项是从 Salesforce 到 Salesforce 的流所独有的,有助于映射相关字段,比如名字、姓氏、地址和电话号码。

      6. 单击某个字段,例如 Row (A)。然后单击 Insert a Reference。从 Salesforce 字段列表,选择一个或多个字段。然后,单击 Insert a Function,向这些字段添加函数来实现您需要的字段映射。
    应用 Salesforce 值作为操作输入
    应用 Salesforce 值作为操作输入
  6. 为该流输入一个名称,然后激活它。

有关更详细的步骤,请参阅 App Connect Personal Documentation 的教程部分

4

测试项目

测试您的 API 的流,确保它在 Salesforce 中创建了一条记录,同时针对所创建的销售商机记录向 Google 工作表添加了一个条目:

  1. 在 API Connect 中,单击 APIs 选项卡来查看已发布的 API。 APIs 选项卡显示了已发布的项目
    APIs 选项卡显示了已发布的项目
  2. 单击指向 API 页面的目标 API。 APIs 页面上的 Design、Source 和 Assemble 选项卡
    APIs 页面上的 Design、Source 和 Assemble 选项卡
  3. 在目标 API 的 Assemble 选项卡上,单击 Create assemblyAPI Connect 中的 Assemble 选项卡
    API Connect 中的 Assemble 选项卡
  4. 在 Policies 下,将 Invoke 策略从左侧导航窗格拖到右侧窗格。 拖放策略
    拖放策略
  5. 单击 Invoke policy。在右侧窗格中,输入目标 URL。在该 URL 下,输入您的用户名和密码(未显示),也就是您发布和运行该业务流程时所在的 App Connect Professional 云中的租户的 IBMid 凭证。 API 细节
    API 细节
  6. 单击 Search 字段旁边的实心箭头图标测试该流。 测试流
    测试流
  7. 选择现有目录。
  8. 在现有设置中创建一个产品,然后单击 Create and publish。单击 Next创建新产品
  9. 在 Test 面板中,从操作列表中选择您需要的操作。在此示例中,选择 post 操作。 Test 面板显示了操作列表
  10. 单击 GenerateGenerate 按钮
  11. 要验证已发布的 API,可单击 Invoke调用 API

您现在已看到输出,在本例中,输出表明已在 Salesforce 帐户中创建了该商机。

测试响应

您还可以看到在 App Connect Professional 云中接收请求的业务流程,可以看到该作业已成功完成。

App Connect Professional 中的业务流程及作业
App Connect Professional 中的业务流程及作业

现在还可以看到,从 App Connect Personal 向所选电子表格的 Google Sheets Sheet1 添加了一个条目。

包含添加的流条目的 Google Sheets
包含添加的流条目的 Google Sheets

结束语

在本教程中,了解了一种自动将 Salesforce 中创建的销售商机传输到 Google Sheets 中的电子表格的无代码方法,该方法使用了 App Connect Professional、App Connect Personal 和 API Connect。此方法要求在 App Connect Professional 中开发一个业务流程或项目,然后将它作为 API 部署到 API Connect,以便为 App Connect Personal 提供一个流触发器。熟悉 App Connect 中提供的触发器和目标应用程序后,可以考虑如何将本教程中的流程应用于您企业中的其他手动任务。

致谢

感谢 Ramya Rajendiran 和 Hariharan I. Subramanian 评审本教程并提供宝贵的反馈。


相关主题


评论

添加或订阅评论,请先登录注册

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Middleware, Cloud computing
ArticleID=1050442
ArticleTitle=使用 App Connect Professional 触发一条从 Salesforce CRM 到 Google 电子表格的销售商机流
publish-date=09272017