流程设计器介绍

变更记录

1 简介

1.1 功能介绍

集成服务云流程设计主要包含流程属性设置和流程图绘制两部分，其中流程属性主要包括流程基本信息、流程变量信息和流程依赖资源引入功能，流程图主要包括开始节点、中间节点以及节点间转移流程设计功能。

功能列表：流程属性、流程图、启用/禁用/发布、导出图片/导出全图、操作帮助等。

1.2 应用场景

用于流程编辑，调用流程内部元素，并通过配置界面完成流程设计。

1.3 系统路径

【集成管理】→【服务流程】→【流程设计】→【服务流程】

1.4 字段/按钮说明

字段说明

按钮说明

2 主要操作

2.1 流程属性

• 基本信息

首先填写服务流程编码、名称、分类等基本信息。

启动方式：包括人工启动、定时启动、事件触发、消息启动4种类型，分别对应4个开始节点。

• 人工启动的流程如果有“输入变量”，则点击“立即执行”按钮，需要填写参数值；

• 定时启动的流程不允许有“输入变量”，可以立即执行；

• 事件触发/消息启动的流程不允许有“输入变量”，立即执行时需要提供启动节点期望的数据。

日志级别控制流程执行过程中日志输出的多少，其中：

• “错误”级别仅输出导致流程中断的错误日志；

• “警告”级别可输出流程错误转移时的异常日志；

• “信息”级别输出最多的日志，主要是流程变量的变化情况。

在生产环境不建议启用“信息”级别，此选项会严重影响执行性能

自动保存时间间隔：用于控制保存服务流程当前状态的时间间隔，默认为5秒,小于5秒以5秒计算。

服务流程用于大规模数据集成时，可适当加大时间间隔，避免频繁保存流程，导致数据库压力过大。

最大记录日志数：超过最大限制时（默认500条），虽流程继续执行，但不记录后续的日志，即日志不再保存到数据库中。

• 依赖资源
  

依赖资源可以选择数据源、集成方案、启动方案、值转换规则、集成对象、自定义函数、外部系统API、自定义API、消息订阅主题、消息发布主题、自定义函数、苍穹微服务、服务流程等集成云已有服务，并作为流程元素的组件引用进来。

依赖资源用于声明流程运行过程中需要访问的外部资源；在流程中，各节点通过这些资源与被集成的系统进行交互（例如：获取数据、执行SQL、执行单据操作等）。

• 流程变量
  

流程变量用于保存流程运行期间需要暂存的数据，方便在前后节点间传递数据（即：将前面节点获取或修改过的数据作为后面节点的参数）。

流程变量作为流程内部执行的运行参数，需要提前定义，把外部资源赋值给流程变量才能够在流程中运行，这是很重要的概念。

目前可以设置两类：简单值和集成对象。其中“控制参数”包括“是否多值”、“输入参数”、“输出参数”等。

2.2 开始节点

• 人工启动

使用“人工启动”节点，需要将流程启动方式设置为“人工启动”。流程通过“立即执行”或“API调用”的方式来启动执行。

• 定时启动

使用“定时启动”节点，需要将流程启动方式设置为“定时启动”。该节点支持修改标题、设置开始和介绍时间、调度任务的执行计划和执行作业的用户，如果执行作业的用户为空，则取当前用户。

• 事件触发
  

使用“事件触发”节点，需要将流程启动方式设置为“事件触发”，通过监听源集成对象的操作来触发启动流程。

• 消息启动

使用“消息启动”节点，需要将流程的启动方式设置为“消息启动”，通过消息订阅主题中的消息内容更新来触发流程。该流程不支持立即执行。

2.3 数据集成

• 数据集成方案

使用“数据集成-集成方案类型”节点，可以“同步执行”对应的数据集成方案，此类型适合用作数据转换和同步，且无日志记录的场景。

配置项：“方案类型”选择集成方案，选择具体的数据集成方案，“过滤条件”为非必填项，“结果输出”为非必填项。

• 启动方案

使用“数据集成-启动方案类型”节点，可以“异步执行”对应的数据集成方案，此类型适合于做大批量的数据集成，有完整的日志记录的场景。

配置项：“方案类型”选择启动方案，选择具体的启动方案，“过滤条件”为非必填项，“结果输出”为非必填项。

2.4 数据获取

使用“数据获取”节点，调用集成对象（实体、数据表、视图、查询类API）进行取数，然后暂存到流程赋值变量中。

配置项：集成对象（下拉列表），赋值变量（下拉列表），过滤条件（分录），排序字段（分录），取数字段（分录）。

新增开关【结果行以map形式展示】，此开关默认关闭：

对于取数集成对象为“数据表”和“视图”类型时，可以通过此开关将赋值变量的结果由“Datarow”转为“map”形式进行展示。即当此开关开启时，赋值变量的结果行是“map对象”形式，可进行对其进行“读取”和“修改”操作；当此开关关闭时，赋值变量的结果行为“可读”模式，且不可修改。

2.5 字段映射

使用“字段映射”节点，可以将源对象变量和目标对象变量的字段进行映射，类似数据集成方案的“字段映射”。

配置项：源对象变量（下拉列表），目标对象变量（下拉列表），字段映射（分录）。

安全模式：默认打开。字段映射节点执行时会先将目标变量设置为null再进行字段映射，减少由于变量在循环中使用带来的误用风险。如果需要从多个数据映射节点组装映射数据，可以把安全模式关闭。

2.6 数据加载

使用“数据加载”节点，可以调用集成对象（实体、数据表、服务类API）完成目标系统数据的“保存”或“删除”操作。

注：

1、当“目标数据分批大小”设置大于1的值时，采用批处理模式（仅支持表或实体），代理用户不能引用目标数据的变量值。

2、目标数据操作可以通过json和变量传入操作参数。

2.7 数据对比

使用“数据对比”节点，可以调用集成管理功能中的“数据对比方案”，也可以将对比结果输出到任务消息中。通过该节点获取源单与目标单的数据差异并存储至流程变量中，方便在后续节点中使用，例如进行选择性补偿、对存在差异的单据进行特定操作。

注意：必须选择带有方案参数的数据对比方案，从而限定源单数据过滤的范围。

• 基本信息：标题（节点标题）、对比方案（仅支持选择带有方案参数的数据对比方案，用于过滤源单数据范围）。

• 参数过滤：自动读取所选数据对比方案中的方案参数，支持输入常量或表达式对源单数据进行范围过滤。

• 结果输出：将对比详情中的源单数据赋值给配置变量，同时将结果日志输出至任务消息中。

2.8 API调用

“API调用”节点支持将服务流程中引用的“苍穹微服务”、“自定义API”、“外部系统API”和“自定义函数”这四种类型的依赖资源，作为当前流程的一部分运行。

• 基本信息：标题（节点标题）、类型（包含苍穹微服务、自定义API、外部系统API和自定义函数）、函数&API（选择对应类型的依赖资源）、调用者（集成云API调用者编码，当选择的API需要授权时此项必填）。

• 输入：根据所选依赖资源（函数或API）的输入列表自动带出，需补充常量或流程变量进行值映射，以便将常量或流程变量的值赋给输入参数。

• 输出：根据所选依赖资源（函数或API）的输出列表自动带出，需补充流程变量进行值映射，以便将函数&API的输出结果赋值给流程变量。

2.9 节点块

“节点块”节点支持将服务流程中需要多次重复执行的多个操作节点打包，作为当前流程的一部分进行运行。

点击“节点块”将打开一个新的流程编辑器，其基本内容与流程编辑器相同，但节点块内不支持进行“补偿转移”，在流程运行时无单独的运行实例，并且运行过程中或完毕后不支持在主流程中执行“忽略”、“撤销”操作。

2.10 子流程

“子流程”支持在服务流程中引用已有的服务流程，将其作为流程中的一个节点来运行。

创建子流程节点：

1、在服务流程的流程属性中引入其他服务流程作为“依赖资源”。

2、创建“子流程”节点，选中刚才引入的服务流程，自动带出子流程的输入输出参数。

注：子流程执行需遵循以下原则：

1、子流程“执行”或“失败”时，则子流程节点处于“等待”状态；

2、子流程处于“等待”时，不会阻塞父流程其他分支运行；

3、子流程“撤销”则父流程“撤销”，父流程“撤销”则子流程“撤销”。

2.11 脚本

“脚本”节点用于执行自定义脚本。

注：在脚本中可以通过别名访问流程资源和通过变量名访问流程变量，数据源支持别名.属性获取连接信息。

使用场景示例 - 通过脚本节点调用服务流程：

1、在流程属性-依赖资源中，定义需要用到的其他服务流程作为依赖资源

2、根据上述依赖资源中服务流程的变量，依次填写流程变量，用于后续脚本调用

3、在脚本中按照如下格式：”依赖资源别名(变量名,变量名);“。例如，依赖资源的别名为HD3C，用到A和B两个变量，则在脚本中通过该别名调用该资源：HD3C(A,B) 即可。

注意：

a、仅支持异步调用其他服务流程；

b、目前仅支持调用启动方式为“人工启动”的服务流程；

c、不推荐多层级调用，调用流程中嵌套调用的其他流程不支持导出；

d、由于执行的是异步调用，被调用流程输出的结果变量，也可以在其流程实例中进行查看