WebSphere Cast Iron Connector Development Kit (CDK) 是一个框架或工具,让您能够开发和部署插件连接器。CDK 使用 Cast Iron Studio 的现有功能来开发插件连接器。您可以在几个星期内轻松地开发一个插件连接器,因为每个活动实施都是基于业务流程的,且无需编码。
基本上,有两种类型的活动:Outbound 和 Starter。一个 Outbound(出站)活动接受输入,进行处理,并提供一 个输出。另一方面,Starter(启动者)活动侦听一个外部事件或定期轮询一个外部源,并最终提供一个输出。CDK 仅支持出站活动的开发。在 Cast Iron V6.3 中,引入了对 Starter 活动的开发支持,以对外部源的轮询为基础。这使得插件连接器开发人员可以使用 CDK 为其插件连接器无缝地构建 Starter 活动。
开发工作完全基于向导,并涉及业务流程的构建,CDK 会由业务流程显示为活动。本文主要介绍如何使用 CDK 开发一个具有 Starter 活动的插件连接器。本文还涵盖部署插件连接器并在 Cast Iron Studio 中对其进行本地测试的步骤。
目标
您将了解:
开发插件连接器之前的设计考虑因素。 如何实施插件连接器。 如何部署和测试插件连接器。
先决条件
您应该熟悉 IBM®WebSphere Cast Iron Studio、Cast Iron CDK 工具包,以及 Starter 和 Outbound 活动等概念。您也需要熟悉使用基于 SaaS 的应用程序(如 Salesforce.com®)所提供的 Web 服务和 REST API。
系统要求
您需要以下产品和资产来配置和部署该模块:
IBM WebSphere Cast Iron Studio V6.3.0.1 或更高版本 要求 WSDL 和 REST URL 与 SaaS 应用程序进行交互
设计插件连接器
CDK 最适合于为 SaaS 应用程序开发插件连接器,它显示 Web 服务和 REST API。因为每个活动实施都对应一个业务流程,所以您可以设计自己的自定义实施,使用现有的 Web 服务和 HTTP 连接器来分别调用 Web 服务和 REST API。在开始插件连接器的开发之前,您必须探讨以下内容:
了解 SaaS 应用程序的功能和用途。 与 SaaS 应用程序(即 Web 服务或 REST API)进行通信的方法。使用 SoapUI 和 Poster 等外部工具分别探索相同的内容。 根据业务需求,需要作为插件连接器的一部分开发的活动列表。
本文说明开发一个具有 Starter 活动的 Salesforce.com 插件连接器的步骤。在开始 SFDCPoller插件连接器的开发之前,请执行以下操作:
探索 Salesforce.com 及其在当前市场中的用法。您可以使用 Web 服务和 REST API 访问 Salesforce.com。 本文使用为执行业务活动而显示的 Web 服务。Salesforce.com 提供多个 WSDL,每一个
都有不同的用途。在本文中,使用 partner.wsdl进行连接器开发。 基于对 partner.wsdl支持的操作和集成要求的分析,可以设计活动。本文说明使用 partner.wsdl中提供的查询和更新操作,开发具有 PollCreatedAccounts活动的连接器的步骤。
实施 PollCreatedAccounts Starter 活动
PollCreatedAccounts 活动定期轮询 Salesforce.com,查找自上一轮询周期以来生成的 Account 对象。在本文中,PollCreatedAccounts 活动被设计为显示 Account 对象的 AccountID、AccountName、BillingAddress 和 Phone 字段,作为每个轮询周期的输出。在探索 partner.wsdl后,可以了解,对于从 Salesforce.com 轮询创建的帐户没有直接操作。然而,您能够灵活地使用各种操作,并开发定制的实施来完成同样的工作。
在活动的自定义实施过程中,需要将一个新的自定义字段 Pollable添加到 Salesforce.com 中的 Account 对象。此字段表示 Account 是否已经被轮询。在 Salesforce.com 中创建帐户时,默认将 Pollable的值设置为 True。在该场景中,您将要开发一个 Starter 活动来轮询所创建的 Accounts,其 Pollable字段的值是 True。在活动实施的过程中,当轮询和处理 Account 时,需要将该字段的值设置为 False。因此,在每一个轮询周期中,都将会从 Salesforce.com 轮询未处理的新 Account 对象。
备注:设计和实施只是演示 CDK 的灵活性的一个示例,这有利于插件连接器活动的自定义实施。
使用 CDK Wizard 开发具有 Starter 活动的 SFDCPoller
打开 Cast Iron Studio v6.3,如果有任何已打开的项目,请关闭项目。 转到 File > New > Create New Connector Project,如图 1 所示。
图 1. 打开 New Connector Project Wizard
单击 Browse,指定保存连接器项目的位置。输入 SFDCPoller作为连接器项目的名称,并单击 OK启动 CDK Wizard。
Connector Wizard 选项卡打开,如图 2 所示。
图 2. Connector Wizard – 连接器信息
指定以下连接器详细信息: 在 Name字段中,指定 SFDCPoller作为连接器的名称。 在 Description字段中,输入一个简短的描述。 在 Version字段中,保留版本号为 1.0.0,因为它是连接器的第一个版本。 添加在探索阶段中已经从 Salesforce.com 下载的 partner.wsdl。要添加 WSDL 文件,单击 Browse并选中由 Salesforce.com 提供的 partner.wsdl文件。
然后单击 OK。 单击 Next。显示 Add Connection Fields 页面。