工作流串联动作

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

低代码依赖模块

<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和EipModule.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	提示信息

界面设计器配置

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

常见问题

普通用户在设计器保存时提示无权限

首先确保该角色有界面设计器权限，然后在“管理中心→角色与权限→系统权限→界面设计器”中点击“收集权限项”

集成串联动作一对多字段映射失败

界面设计器配置响应参数，无报错信息，响应参数也配置正确。

确定接口返回信息正确时，检查响应参数是否设置为数组格式。