工作流串联动作

界面所属模块需要保证依赖模块列表依赖了“工作流”。

低代码依赖模块

<dependency>
    <groupId>pro.shushi.pamirs.workflow</groupId>
    <artifactId>pamirs-workflow-api</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.workflow</groupId>
    <artifactId>pamirs-workflow-core</artifactId>
</dependency>

低代码模块 dependencies 需要引用 WorkflowModule.MODULE_MODULE。

流程创建

流程串联动作仅支持模型触发。

界面设计器配置

在界面设计器的组件库 → 动作中找到“工作流”；仅能选择流程触发模型和当前主视图所属模型相同的流程；按钮点击后，流程触发。

说明

工作流及数据流程动作的触发需确保相关数据的存在，因此在创建页中，按钮将以禁用状态显示，防止在数据缺失时触发流程。

数据流程串联动作

界面所属模块需要保证依赖模块列表依赖了“工作流”和“集成接口”。

低代码依赖模块

<dependency>
    <groupId>pro.shushi.pamirs.workflow</groupId>
    <artifactId>pamirs-workflow-api</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.workflow</groupId>
    <artifactId>pamirs-workflow-core</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.core</groupId>
    <artifactId>pamirs-eip2-api</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.core</groupId>
    <artifactId>pamirs-eip2-core</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.core</groupId>
    <artifactId>pamirs-eip2-view</artifactId>
</dependency>

低代码模块 dependencies 需要引用 WorkflowModule.MODULE_MODULE。

界面设计器配置

数据流程触发的配置和使用方式同工作流串联动作。

集成连接器串联动作

准备工作

界面所属模块需要保证依赖模块列表依赖了“集成接口”。

低代码依赖模块

<dependency>
    <groupId>pro.shushi.pamirs.core</groupId>
    <artifactId>pamirs-eip2-api</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.core</groupId>
    <artifactId>pamirs-eip2-core</artifactId>
</dependency>
<dependency>
    <groupId>pro.shushi.pamirs.core</groupId>
    <artifactId>pamirs-eip2-view</artifactId>
</dependency>

低代码模块 dependencies 需要引用 EipModule.MODULE_MODULE

集成设计器接口配置

首先在集成设计器新增API

已配置Api“根据id查询用户”：

• 请求地址：/user/queryById/{id}

• 请求参数：

  参数名	参数位置	必填	参数类型	是否数组	字段长度	默认值	参数备注
  id	Path	是	Integer				用户id[1~43有值]

• 响应参数：

  参数名	参数类型	参数来源	是否数组	取值表达式	参数备注
  id	String	Body	否	data.id	主键
  name	String	Body	否	data.name	姓名
  age	String	Body	否	data.age	年龄
  country	String	Body	否	data.country	国家
  gender	String	Body	否	data.gender	性别

界面设计器

在界面设计器的组件库 → 动作中找到“集成连接器”。

动作按钮创建完成后，在属性中找到连接器配置，选择Api资源。

请求参数配置

选择API资源后，若该API需配置请求与响应参数，则相应的参数配置项将会呈现。如上图所示，因所选API含有Path类型的参数，故可进行Path参数的映射配置。此API并无Body或Query类型的参数，因此这些配置项将不会显示。

Path参数的具体配置如下：左侧列出了集成设计器为API创建的参数名称，而右侧对应的是当前模型中的字段，将赋值表达式设定为ID。该配置的含义是：在用户点击按钮之后，系统将调用配置的Api资源，并以当前视图中的ID参数值来映射Path参数，发起请求。

响应参数配置

同样地，左侧的参数名称是由集成设计器配置的响应参数，而右侧则为当前模型中的字段。当请求成功发送并接收响应后，这些响应参数将会按照配置的规则被填充到表单或详情页面中。

1. 发送请求前，若字段已填充数据，但在响应中未获取相应数据，则该字段将被置为空；比如在发送请求前，性别字段已有数据，而请求发送后，若接口返回的数据中未包含性别信息，则性别参数将会被置为空。
2. 多对一字段将依据接口返回的数据从数据库中进行查询（queryOne）。若未查询到相关信息，则仅回填那些在响应中有值的字段。

运行时页面

响应参数一对多/多对多配置

集成设计器的API配置如下所示：条件查询用户

• 请求地址：/user/query

• 请求参数：

  参数名	参数位置	必填	参数类型	是否数组	字段长度	默认值	参数备注
  country	Body	否	String	否			国家
  name	Body	否	String	否			用户姓名

• 响应参数：

  参数名	参数类型	参数来源	是否数组	取值表达式	参数备注
  data	OBJECT	Body	是	data	用户列表
  »name	String	Body	否	name	姓名
  »age	String	Body	否	age	年龄
  »gender	String	Body	否	gender	性别
  »country	String	Body	否	country	国家
  »id	Integer	Body	否	id	主键

界面设计器配置

场景如下：点击“同步员工”按钮后，将部门名称作为请求参数，响应信息填写至员工列表。

响应参数配置如下：

运行时页面

说明：关系字段的数据不会自动落库，一对多/多对多也不会通过查询数据库来填充其他参数。若需要保存数据，可重写模型的创建（create）等方法进行处理。

列表调用集成连接器

集成设计器的API配置如下所示：发送通知

• 请求地址：/api/v1/send/notify/email

• 请求参数：

  参数名	参数位置	必填	参数类型	是否数组	字段长度	默认值	参数备注
  name	Query	是	String	否			员工姓名

• 响应参数：

  参数名	参数类型	参数来源	是否数组	取值表达式	参数备注
  msg	String	Body	否	msg	提示信息

界面设计器配置

列表页支持集成连接器的串联动作，但不允许配置响应参数，并且仅支持单行动作。