常用图元
# 1 常用图元
在逻辑流中，内置了一系列数据库操作、流程发起、消息发送的常用图元，以便用户能够根据不同的业务需求进行实现。支持可视化拖拽配置，满足数据全生命周期管理。
# 1.2 图元功能目录
# 1.2.1 新增数据
创建新数据记录的原子操作单元，支持结构化数据写入
示例一：在教务系统中创建学生档案，需同步写入基础信息至数据库
新增数据图元适用于新增单条或多条数据，配置参数说明如下：
配置参数说明：
显示名称： 图元在画布上的展示名称
目标实体： 数据写入的SDO对象模型
数据来源： 输入数据实体对象（支持单条或多条数据，多条数据使用数组或List集合）
来源类型： 数据对象结构类型
赋值： 新增赋值行，为待保存实体内字段赋值，右值点击图标V打开选择值弹窗
返回值：新增数据操作的返回值
1.参数定义
创建一个实体类型的逻辑流后，系统自动创建输入参数datasourceName、entityName、models与返回值out属性。
2.新增图元配置
在新增图元属性设置弹窗中，目标实体选择低开中创建的持久化实体学生，数据来源选择逻辑流输入参数新增实体数组models，来源类型自动选择为commonj.sdo.DataObject；返回值中输入逻辑流返回值out。
注意：新增数据图元中如使用赋值操作，需要对目标实体的所有字段进行赋值，未赋值的字段默认为null。
3.执行调试
执行当前逻辑流，参数models输入待保存学生数据信息，点击执行即可查看到保存成功后返回的数据对象信息。
# 1.2.2 更新数据
动态修改已有数据内容的操作组件
示例二：批量修改学生信息状态字段值
更新数据图元适用于动态修改单条或多条数据，配置参数说明如下：
配置参数说明：
显示名称： 图元在画布上的展示名称
目标实体： 待修改数据的SDO对象模型
数据来源： 待修改数据实体对象（支持单条或多条数据，多条数据使用数组或List集合）
来源类型： 待修改数据对象结构类型
匹配条件：添加匹配条件以便获取到需要修改的数据，支持设置且与或的分组条件添加，左值为待修改的目标实体内字段，操作可选择=、>、<、>=、<=等匹配操作符；右值可选择常量、变量、表单式或数据来源实体内字段值。
赋值： 更新数据赋值行，左值为待修改的目标实体内字段赋值，操作可选择增加、设置与减少；右值点击图标V打开选择值弹窗（增加或减少操作即是将左右值相加或相减更新到对应的数据表字段中）
源数据未匹配时： 源数据未匹配到数据库表中数据时的执行策略；
新增：将未匹配的数据做新增数据操作，并返回新增的数据；
新增赋值：为待新增的数据字段进行赋值操作；
忽略：将未匹配的数据不做任何处理，并返回未匹配的数据；
返回值：源数据未匹配时策略的返回值
1.参数定义
创建一个实体类型的逻辑流后，添加输入参数students数组，数据类型为liujie.demoData.liujieStudentEntity,用于接收待修改的学生实体数据,添加返回值out属性，数据类型为commonj.sdo.DataObject。
2.更新数据图元配置
在更新图元属性设置弹窗中，目标实体选择低开中创建的持久化实体学生，数据来源选择逻辑流输入参数待修改实体数组students；
来源类型自动选择为liujie.demoData.liujieStudentEntity；
匹配条件添加且条件，左值设置为目标实体主键字段id,操作设置为=,右值设置为数据来源实体中的主键字段id；
赋值行中设置左值为目标实体的状态字段，操作为设置，右值为常量stop；
源数据未匹配时策略设置为忽略；
返回值中输入逻辑流返回值out。
3.执行调试
执行当前逻辑流，参数students输入待更新学生数据信息，点击执行即可查看到更新成功后返回的未匹配的学生数据信息；查看学生信息视图，状态字段已被更新为stop。
# 1.2.3 查询数据
数据检索专用组件，支持多条件过滤、排序、分页设置
示例三：分页查询stop状态下的学生信息
新增数据图元适用于新增单条或多条数据，配置参数说明如下：
配置参数说明：
显示名称： 图元在画布上的展示名称
目标实体： 数据写入的SDO对象模型
数据来源： 输入数据实体对象（支持单条或多条数据，多条数据使用数组或List集合）
来源类型： 数据对象结构类型
匹配条件： 查询数据的匹配条件
排序：查询结果的排序设置
分页：查询结果的分页设置
返回值：查询数据操作的返回值
1.参数定义
创建一个实体类型的逻辑流后，选择查询模版，系统自动创建输入参数datasourceName、entityName、condition,cascadeDeep,pageIndex,pageSize与返回值out属性。
2.新增图元配置
在新增图元属性设置弹窗中，目标实体选择低开中创建的持久化实体学生，数据来源与来源类型不做设置；匹配条件设置左值为学生实体中的状态字段，操作为等于，右值为常量stop；开启启用分页开关，分页参数使用输入参数pageIndex与pageSize传值，返回值中输入逻辑流返回值out。
3.执行调试
执行当前逻辑流，参数pageIndex与pageSize中输入分页数据，点击执行即可查看到查询成功后返回的数据对象信息。
# 1.2.4 删除数据
数据清除操作模块，动态条件匹配数据并删除
示例四：根据主键删除学生信息
删除数据图元适用于删除单条或多条数据，配置参数说明如下：
配置参数说明：
显示名称： 图元在画布上的展示名称
目标实体： 删除数据的SDO对象模型
数据来源： 输入数据实体对象（支持单条或多条数据，多条数据使用数组或List集合）
来源类型： 数据对象结构类型
匹配条件： 查询待删除数据的匹配条件
返回值：删除数据操作的返回值（返回已删除数据数量）
1.参数定义
创建一个实体类型的逻辑流后，输入参数students数组,参数类型为实体liujie.demoData.liujieStudentEntity,与返回值out，类型为int。
2.删除图元配置
在删除图元属性设置弹窗中，目标实体选择低开中创建的持久化实体学生，数据来源选择逻辑流入参，来源类型自动设置为学生实体；匹配条件设置左值为学生实体中的主键id字段，操作为等于，右值设置为数据来源实体中的主键字段id；返回值中输入逻辑流返回值out。
3.执行调试
执行当前逻辑流，，输入参数students中输入待删除学生实体数据，点击执行即可查看到删除成功后返回的已删除数据数量。
# 1.2.5 发起流程
根据业务数据发起流程，支持发起人自定义设置与定时发起策略。
示例五：发起学生信息录入审批流程
发起流程图元配置参数说明如下：
配置参数说明：
显示名称： 图元在画布上的展示名称
流程定义： 选择要发起的流程定义
数据来源： 输入数据实体对象
来源类型： 数据对象结构类型
发起人： 流程发起人，可选择当前登录用户、指定用户或数据来源中的实体字段值
发起策略：直接发起与定时发起；定时发起可选择固定时间与指定数据来源的实体字段值
返回值：流程发起后的返回值，返回任务Id与流程表单实体数据
1.参数定义
创建一个实体类型的逻辑流后，输入参数student,参数类型为实体liujie.demoData.liujieStudentEntity,与返回值out，类型为List。
2.发起流程图元配置
在发起流程图元属性设置弹窗中，流程定义选择低开中创建的学生信息审批流程，数据来源选择逻辑流入参，来源类型自动设置为学生实体；发起人设置为当前用户；发起策略设置为直接发起，返回值中输入逻辑流返回值out。
3.执行调试
执行当前逻辑流，输入参数student中输入学生实体数据，点击执行即可查看到流程发起成功后返回的学生实体数据；AFCenter平台切换到流程中心已办任务菜单，即可查看到刚刚发起的流程。
# 1.2.6 发送消息
快速发送消息到指定目标，支持多种发送类型与发送目标方式。
示例五：发起站内信、邮件、短信消息到指定目标
发送消息图元配置参数说明如下：
配置参数说明：
显示名称： 图元在画布上的展示名称
数据来源： 输入数据实体对象
来源类型： 数据对象结构类型
发送类型： 消息发送类型，可选邮件、短信、站内信
标题：发送站内信或邮件的标题内容
发送内容： 发送站内信或邮件的发送内容（支持el表达式）
模板code：连接器短信消息配置中的短信模版code
模版变量：短信模版变量值，匹配数据来源的实体字段值
发送目标：发送目标可选人员、机构、平台角色、应用角色、复合
发送方式：可选择指定用户或数据来源中的实体字段值
发送策略：直接发起与定时发起；定时发起可选择固定时间与指定数据来源的实体字段值
返回值：流程发起后的返回值，返回流程表单实体数据
1.参数定义
创建一个实体类型的逻辑流后，输入参数student,参数类型为实体liujie.demoData.liujieStudentEntity,与返回值out，类型为List。
2.发送消息图元配置
短信发送：
在发送消息图元属性设置弹窗中，数据来源选择逻辑流入参，来源类型自动设置为学生实体；发送类型选择短信，模板code填写平台连接器中配置的短信服务模板code，模版变量选择数据来源实体中的编码字段code，发送目标选择人员，发送方式指定，选择人员，直接发送，返回值中输入逻辑流返回值out。
邮件发送：
在发送消息图元属性设置弹窗中，其他配置同上；发送类型选择邮件，录入待发送邮件的标题，输入发送内容您有一条学生姓名为${name}的审批信息待查看，el表达式${name}默认从数据来源中的实体字段中匹配取值，返回值中输入逻辑流返回值out。
站内信发送：
在发送消息图元属性设置弹窗中，其他配置同上；发送类型选择站内信，录入待发送邮件的标题以及发送内容即可，返回值中输入逻辑流返回值out。
3.执行调试
执行当前逻辑流，输入参数student中输入学生实体数据，点击执行即可查看到消息发起成功后返回的学生实体数据。
