从头开始创建事件驱动的流

在事件驱动流程中,您要确定一个或多个目标应用程序中可能发生的事件和可执行的操作。 发生事件时将触发流。

准备工作

  • 要创建事件驱动的流,您必须有权访问集群中的 App Connect Designer 实例。
  • 如果您正在使用 App Connect Designer 12.0.3.0-r1 或更早的实例,并且您的管理员已启用本地和云管理连接器的使用,则您还必须能够访问托管云管理连接器的 App Connect on IBM® Cloud 实例。
  • 如果您知道要与哪些应用程序交互,请打开 App Connect Designer 目录,并为连接器创建账户,这些连接器将用于处理源应用程序中的事件并对目标应用程序执行操作。 (还可以在创建流时创建帐户。) 更多信息,请参阅连接账户

关于此任务

创建事件驱动的流涉及以下步骤:
  1. 指定哪个应用程序应获取将触发流程的事件。
  2. 添加应该对一个或多个目标应用程序执行的操作。 (可选) 将工具箱实用程序添加到流中,以便专门处理来自这些应用程序的输入或输出数据。

请注意以下考虑事项:

  • 最多可以向流添加 10 个操作。
  • 操作按画布上显示的顺序执行。
  • 如果其中一个操作失败,则不会执行后面的操作,但之前的操作不会被逆转。

过程

要创建事件驱动的流,请完成以下步骤:

  1. App Connect Designer UI 中,单击 “仪表板” 图标打开 App Connect Designer 仪表板(如果当前未显示) 仪表板图标
  2. App Connect Designer 面板,单击新建 > 事件驱动流程打开流程编辑器。
  3. 输入用于标识流用途的名称。
    指定流名称

    随着流程的进行,App Connect 将自动保存您的更改。 如果您在任何阶段离开流,流会保存为草稿流,您可以在其他时间完成此流。

  4. 将事件节点添加到流。 您可以选择从源应用程序接收流式事件,轮询应用程序以获取事件,或者配置来自应用程序的事件的调度。 流编辑器中仅显示受支持的事件节点。 要查看事件驱动的流支持哪些事件节点,请参阅 用于触发事件驱动的流的受支持事件连接器
    注意: 事件只支持本地账户,因此添加事件节点时,只能选择本地账户。
    • 要从源应用程序流式传输事件,请单击从 Applications 选项卡中选择应用程序。 然后点击需要流式传输事件的对象和事件类型。 例如,如果您希望在 Salesforce 中创建联系人时向 App Connect 发送事件通知、单击以选择 Salesforce ,然后单击 联系人 新联系人

      还要确保在 帐户 列表中选择正确的帐户。

      为流式事件选择应用程序和事件类型

      事件节点将添加到流中。

      流式事件的事件节点
    • 要轮询源应用程序以获取新对象或更新的对象,请单击从 Applications 选项卡中选择应用程序,然后单击 配置更多事件。 在 选择要配置的事件面板中,单击要监控的对象并单击事件类型。 例如,如果要在 Salesforce 中每次创建新账户时触发流程,请单击 Salesforce > 配置更多事件 ,然后单击账户新账户
      为轮询的事件选择应用程序和事件类型

      事件节点将添加到流中。 确保在 帐户 列表中选择正确的帐户,然后在显示的字段中配置轮询时间间隔。 有关完成这些字段的信息,请参阅 配置轮询事件以触发流

      轮询事件的事件节点

    • 要将流程配置为定期或在特定日期和时间运行,请单击 Toolbox 选项卡,然后单击 Scheduler
      从 "工具箱" 选项卡中选择调度程序

      调度程序节点将添加到流中。 定义流的调度,如 配置流以在调度时间运行中所述。

      在此示例中,定义了调度以在首次启动时触发流,然后每小时触发一次流。

      已配置的调度程序节点
  5. 要向流程中添加第一个操作,请单击 (+) 然后选择应用程序和所需操作。 还要确保选择了正确的账户,App Connect 将使用该账户连接到目标应用程序。 如果没有已连接的账户,可以按照连接账户中的说明创建一个。
    注意: 如果您的 App Connect Designer 实例已配置为使用交换服务器来处理可调用流、IBM App Connect EnterpriseIBM Integration Bus 中调用运行中的可调用流节点。 如果在实例中启用了此功能,导航窗格中将包含一个可调用流程图标 可调用流图标 。 您还必须按照配置调用流和可调用流之间的连接中的描述,配置安全连接。

    在此示例中,从 Applications 选项卡中选择了一个 Salesforce 操作来检索线索。

    选择要添加到流的 Salesforce 操作
  6. 使用要传递到目标应用程序的值填充操作的字段。 必需输入的类型取决于操作,必须填写必需字段才能启动流。 您可以纯文本形式指定静态数据,也可以通过在流中添加来自先前节点的映射来指定动态数据。 您还可以应用函数 (或 JSONata 表达式) 来变换数据,或者使用其他内置机制来定义定制值。
    • 要手动将文本,映射和 JSONata 表达式输入到字段中,或者要定义您自己的定制值,请参阅 配置操作
    • 要使用建议的智能映射自动填充操作的字段,请使用 "映射辅助" 功能,如 使用 AI 支持的建议简化数据映射和数据转换中所述。 (要应用智能映射,必须在 App Connect Designer 实例中启用映射辅助。)

    在下面的示例中,Salesforce 检索线索 操作用于检索上次触发流程时 Salesforce 创建的新线索的详细信息。 要对此进行定义,请单击 添加条件,然后从头两个字段中选择 Created dateis greater than 。 然后单击最右边的字段,单击插入映射图标 插入映射图标 打开可用映射列表,然后选择 Previous event time 映射,该映射描述了触发上一个计划表的时间。 (可选) 配置要检索的最大项数以及错误条件。

    操作的填充字段
    提示:完成操作的字段后,您可以使用自动生成或自定义的示例数据来试用操作并验证其效果。 该操作将在您连接的目标应用程序上执行,因此如果您想尝试该操作,请确保使用非生产账户。 有关详细信息,请参阅 使用示例数据测试非运行流程
  7. 可选:如有需要,可添加对选定应用程序执行的其他操作。
  8. 可选: 使用一个或多个受支持的工具箱实用程序来提供专用处理。 例如,可以添加 If 节点以提供条件处理,或者添加 For each 节点以处理检索到的项。 有关更多信息,请参阅 向流添加特殊处理 (工具箱实用程序)

    在此示例中, For each 节点用于循环检索到的 Salesforce 记录并在 Insightly 中创建相应的商机记录。 单击 (+),转到 Toolbox 选项卡,然后单击 For each 以选择要处理的项目集合和处理选项。

    对于每个节点设置

    接下来,单击每个节点内的加号 (+) ,然后从应用程序选项卡中单击 Insightly > Leads > Create leads插入映射图标 插入映射图标 可用来在各个字段中填充代表 Salesforce 节点处理输出的映射。 不过,该设计器实例已启用映射辅助功能(以 15 suggestions View suggestions 表示),并可生成智能映射,用于集体填充字段。

    Mapping Assist 生成的智能映射建议

    单击 查看建议 可切换到内联预览模式,将建议映射的预览插入到匹配字段中。 检查预览映射以验证它们是否适合您的要求,然后单击 应用 15 项建议以填充字段。

    使用智能建议填充的字段
  9. 可选: 在配置了所有流的节点之后,请使用自动生成的或定制的样本数据来 试用 该流,然后再将其启动以验证其行为。 流程中配置的操作将在您连接的目标应用程序上执行,因此如果您想试用流程,请确保使用非生产账户。 有关更多信息,请参阅 使用样本数据测试未运行的流
  10. 确保流中的任何节点中都没有验证错误。
    有关验证流中的节点并解决错误的更多信息,请参阅 验证流是否已准备好运行
  11. 要保存并启动流程,请打开横幅上的选项菜单 [⋮],然后单击 启动流程。 然后,单击 Dashboard 退出流程。 您的流程将在仪表板中显示为一个磁贴,状态为 Running,并正在监听您配置的事件。
    提示:要从流程编辑器保存但不启动流程,请单击 仪表板。 您的流程在仪表板中显示为 Stopped,并可通过磁贴上的选项菜单手动启动。 如果未完成流程,则流程会显示在仪表板中,标签为 Incomplete
    仪表板中的流磁贴

后续操作

通过完成触发流的事件活动来测试正在运行的流的行为。 然后验证您是否可以在目标应用程序中看到期望的结果。 有关详细信息,请参阅测试运行中的事件驱动流程

在流程的选项菜单中,可以启动、停止、 导出或删除流程,如果群集中有自动化资产实例,还可以选择将其作为资产与其他用户共享。 在流运行时,您还可以打开该流以查看配置,但如果要对其进行编辑,那么必须停止该流。

流菜单选项
如果要在生产系统中运行流程,必须在 App Connect Dashboard 运行时环境中将其部署为集成服务器:
  1. App Connect Designer 创建环境中充分测试流程后,将流程导出为打包集成的代理存档 (BAR) 文件。
  2. 将 BAR 文件上传到 App Connect Dashboard 实例,然后将文件部署到集成服务器,以便在生产系统中运行集成。

    有关更多信息,请参阅将 IBM App Connect Designer 流程和 API 部署到集成服务器