com.actionsoft.sdk.local.api

接口 BOAPI

public interface BOAPI

BO操作接口。BO（Business Object）。如创建、读取BO表记录、BO附件字段的增删查。如果API调用的上下文已提供UserContext、 ProcessInstance实例对象，使用对应参数的方法可减少构建实例对象的不必要开销,如果调用create或update给大文本赋值，内容需要用

包起来：如 bo.set("dawenben","

内径

")

方法概要

限定符和类型	方法和说明
void	copyFileTo(java.lang.String sourceBoId, java.lang.String sourceFieldName, java.lang.String targetBoId, java.lang.String targetBOName, java.lang.String targetFieldName, java.lang.String targetProcessInstId, java.lang.String targetTaskInstId) 将指定的源附件字段的全部文件复制到目标附件字段
void	copyFileTo(java.lang.String sourceBoId, java.lang.String sourceFieldName, java.lang.String targetBoId, java.lang.String targetBOName, java.lang.String targetFieldName, java.lang.String targetProcessInstId, java.lang.String targetTaskInstId, boolean keepCreateUser) 将指定的源附件字段的全部文件复制到目标附件字段
void	copyFileTo(java.lang.String sourceBoId, java.lang.String sourceFieldName, java.lang.String sourceRepositoryName, java.lang.String targetBoId, java.lang.String targetBOName, java.lang.String targetFieldName, java.lang.String targetRepositoryName, java.lang.String targetProcessInstId, java.lang.String targetTaskInstId) 将指定的源附件字段的全部文件复制到目标附件字段
int	create(java.lang.String boName, BO recordData, ProcessInstance processInst, UserContext userContext) 为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。
int	create(java.lang.String boName, BO recordData, ProcessInstance processInst, UserContext userContext, java.sql.Connection conn) 为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。
int	create(java.lang.String boName, BO recordData, java.lang.String bindId, java.lang.String uid) 为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。
int	create(java.lang.String boName, BO recordData, java.lang.String bindId, java.lang.String uid, java.sql.Connection conn) 为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。
int[]	create(java.lang.String boName, java.util.List<BO> recordDatas, ProcessInstance processInst, UserContext userContext) （批量）为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。
int[]	create(java.lang.String boName, java.util.List<BO> recordDatas, ProcessInstance processInst, UserContext userContext, java.sql.Connection conn) （批量）为指定的BO表新增记录，该API适用于流程实例驱动或DW仅存储实例驱动的数据记录。
int[]	create(java.lang.String boName, java.util.List<BO> recordDatas, java.lang.String bindId, java.lang.String uid) （批量）为指定的BO表新增记录，该API适用于流程实例驱动或DW仅存储实例驱动的数据记录。
int	createDataBO(java.lang.String boName, BO recordData, UserContext userContext) 为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。
int	createDataBO(java.lang.String boName, BO recordData, UserContext userContext, java.sql.Connection conn) 为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。
int[]	createDataBO(java.lang.String boName, java.util.List<BO> recordDatas, UserContext userContext) （批量）为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。
int[]	createDataBO(java.lang.String boName, java.util.List<BO> recordDatas, UserContext userContext, java.sql.Connection conn) （批量）为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。
int[]	createValueHistory(java.util.List<java.util.Map<java.lang.String,java.lang.Object>> list) 批量插入字段值差异历史数据
int	createValueHistory(java.lang.String processInstId, java.lang.String taskInstId, java.lang.String tableName, java.lang.String sourceId, java.lang.String fieldName, java.lang.String fieldType, java.lang.String fieldTitle, java.lang.String modifyUid, java.lang.String modifyUser, java.lang.String ov, java.lang.String nv, java.lang.String ip, java.lang.String extData1, int extData2) 单条插入字段值差异历史数据
BO	get(java.lang.String boName, java.lang.String boId) 根据BOID查询一条BO数据
java.lang.Object	get(java.lang.String boName, java.lang.String boId, java.lang.String fieldName) 根据BOID查询指定字段的值
BO	getByKeyField(java.lang.String boName, java.lang.String fieldName, java.lang.Object value) 根据唯一字段查询一条BO数据，适用于流程表单的主表数据
BO	getByProcess(java.lang.String boName, java.lang.String processInstId) 根据流程实例查询一条BO数据，适用于流程表单的主表数据
java.lang.Object	getByProcess(java.lang.String boName, java.lang.String processInstId, java.lang.String fieldName) 根据流程实例查询指定字段的值，适用于流程表单的主表数据
java.io.InputStream	getFile(java.lang.String fileId) 读取指定文件内容，该API需要关闭流。
java.io.InputStream	getFile(java.lang.String fileId, java.lang.String repositoryName) 读取指定文件内容，该API需要关闭流。
DCContext	getFileDCContext(FormFile formFile) 获得表单附件的DC上下文
DCContext	getFileDCContext(FormFile formFile, java.lang.String repositoryName) 获得表单附件的DC上下文
DCContext	getFileDCContext(UserContext me, FormFile formFile, java.lang.String repositoryName)
java.util.List<FormFile>	getFiles(java.lang.String boId, java.lang.String fieldName) 获取指定附件字段已上传的全部文件列表
BOQueryAPI	query(java.lang.String boName) 获得该BO的查询对象，该方法默认不加载大文本类型字段值。
BOQueryAPI	query(java.lang.String boName, boolean loadBigText) 获得该BO的查询对象，该方法允许指定是否加载大文本类型字段值。
BOQueryAPI	query(java.lang.String boName, java.lang.String fields) 获得该BO的查询对象
java.util.List<HistoryValueModel>	queryHistoryValueByProcessInstId(java.lang.String processInstId) 根据流程实例ID查询所有历史数据
java.util.List<HistoryValueModel>	queryHistoryValuePagation(java.lang.String processInstId, int start, int limit) 根据流程实例ID分页查询历史数据
int	remove(java.lang.String boName, java.lang.String boId) 删除一条BO表记录。
int	remove(java.lang.String boName, java.lang.String boId, java.sql.Connection conn) 删除一条BO表记录。
int	removeByBindId(java.lang.String boName, java.lang.String bindId) 删除与某流程实例相关的BO表记录。
int	removeByBindId(java.lang.String boName, java.lang.String bindId, java.sql.Connection conn) 删除与某流程实例相关的BO表记录。
void	removeFile(java.lang.String fileId) 删除指定文件
void	removeFiles(java.lang.String boId, java.lang.String fieldName) 批量删除指定字段的所有文件
int	update(java.lang.String boName, BO recordData) 更新一条BO表记录。
int	update(java.lang.String boName, BO recordData, java.sql.Connection conn) 更新一条BO表记录。
int	updateByBindId(java.lang.String entityName, BO recordData) 按bindId更新记录。
int	updateByBindId(java.lang.String boName, java.lang.String bindId, java.lang.String fieldName, java.lang.Object value) （批量）根据流程实例更新BO数据
int	updateByWhere(java.lang.String entityName, java.util.Map<java.lang.String,java.lang.Object> updates, java.util.Map<java.lang.String,java.lang.Object> querys)
void	upFile(FormFile formFile, java.io.InputStream data) 将文件上传到BO表的指定字段并设置formFile附加信息，该API需要关闭流。
void	upFile(FormFile formFile, java.lang.String repositoryName, java.io.InputStream data) 将文件上传到BO表的指定字段并设置formFile附加信息，该API需要关闭流。

方法详细资料

create

int create(java.lang.String boName,
           BO recordData,
           ProcessInstance processInst,
           UserContext userContext)
    throws AWSDataAccessException

为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

recordData构建例子：
BO boRecordData = new BO();
boRecordData.set("S1", "0001");
boRecordData.set("S2", 100);

参数:

boName - BO表名称

recordData - 一个BO数据对象

processInst - 流程实例对象

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordData中取ID

抛出:

AWSDataAccessException

create

int create(java.lang.String boName,
           BO recordData,
           java.lang.String bindId,
           java.lang.String uid)
    throws AWSDataAccessException

为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

参数:

boName - BO表名称

recordData - 一个BO数据对象

bindId - 流程实例Id

uid - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordData中取ID

抛出:

AWSDataAccessException

create

int create(java.lang.String boName,
           BO recordData,
           ProcessInstance processInst,
           UserContext userContext,
           java.sql.Connection conn)
    throws AWSDataAccessException

为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

recordData - 一个BO数据对象

processInst - 流程实例对象

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordData中取ID

抛出:

AWSDataAccessException

create

int create(java.lang.String boName,
           BO recordData,
           java.lang.String bindId,
           java.lang.String uid,
           java.sql.Connection conn)
    throws AWSDataAccessException

为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

recordData - 一个BO数据对象

bindId - 流程实例Id

uid - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordData中取ID

抛出:

AWSDataAccessException

create

int[] create(java.lang.String boName,
             java.util.List<BO> recordDatas,
             ProcessInstance processInst,
             UserContext userContext)
      throws AWSDataAccessException

（批量）为指定的BO表新增记录，该API适用于流程实例驱动的数据记录。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

recordDatas构建例子：
List<BO> boTest2Datas = new ArrayList<BO>()
BO boTest2RecordData1 = new BO();
boTest2RecordData1.set("S1", "0001");
boTest2RecordData1.set("S2", 100);
boTest2Datas.add(boTest2RecordData1);

BO boTest2RecordData2 = new BO();
boTest2RecordData2.set("S1", "0002");
boTest2RecordData2.set("S2", 89.2);
boTest2Datas.add(boTest2RecordData2);

参数:

boName - BO表名称

recordDatas - 表记录数据，一个List类型的BO集合 多行记录封装到List

processInst - 流程实例对象

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordDatas中取ID

抛出:

AWSDataAccessException

create

int[] create(java.lang.String boName,
             java.util.List<BO> recordDatas,
             java.lang.String bindId,
             java.lang.String uid)
      throws AWSDataAccessException

（批量）为指定的BO表新增记录，该API适用于流程实例驱动或DW仅存储实例驱动的数据记录。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

参数:

boName - BO表名称

recordDatas - 表记录数据，一个List类型的BO集合 多行记录封装到List

bindId - 流程实例Id

uid - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordDatas中取ID

抛出:

AWSDataAccessException

create

int[] create(java.lang.String boName,
             java.util.List<BO> recordDatas,
             ProcessInstance processInst,
             UserContext userContext,
             java.sql.Connection conn)
      throws AWSDataAccessException

（批量）为指定的BO表新增记录，该API适用于流程实例驱动或DW仅存储实例驱动的数据记录。

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

recordDatas - 表记录数据，一个List类型的BO集合 多个Map加入到List

processInst - 流程实例对象

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordDatas中取ID

抛出:

AWSDataAccessException

createDataBO

int createDataBO(java.lang.String boName,
                 BO recordData,
                 UserContext userContext)
          throws AWSDataAccessException

为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

recordData构建例子：
BO boRecordData = new BO();
boRecordData.set("S1", "0001");
boRecordData.set("S2", 100);

参数:

boName - BO表名称

recordData - 一个BO数据对象

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordData中取ID

抛出:

AWSDataAccessException

createDataBO

int createDataBO(java.lang.String boName,
                 BO recordData,
                 UserContext userContext,
                 java.sql.Connection conn)
          throws AWSDataAccessException

为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

recordData - 一个BO数据对象

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordData中取ID

抛出:

AWSDataAccessException

createDataBO

int[] createDataBO(java.lang.String boName,
                   java.util.List<BO> recordDatas,
                   UserContext userContext)
            throws AWSDataAccessException

（批量）为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

recordDatas构建例子：
List<BO> boTest2Datas = new ArrayList<BO>();
BO boTest2RecordData1 = new BO();
boTest2RecordData1.set("S1", "0001");
boTest2RecordData1.set("S2", 100);
boTest2Datas.add(boTest2RecordData1);

BO boTest2RecordData2 = new BO();
boTest2RecordData2.set("S1", "0002");
boTest2RecordData2.set("S2", 89.2);
boTest2Datas.add(boTest2RecordData2);

参数:

boName - BO表名称

recordDatas - 表记录数据，一个List类型的BO集合 多行记录封装到List

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordDatas中取ID

抛出:

AWSDataAccessException

createDataBO

int[] createDataBO(java.lang.String boName,
                   java.util.List<BO> recordDatas,
                   UserContext userContext,
                   java.sql.Connection conn)
            throws AWSDataAccessException

（批量）为指定的BO表新增记录，该API适用于纯数据迁移和查询、利用，不能由流程实例或仅存储实例驱动。

注意：
API的机制是：BO对象中的字段如果不赋值，会默认为空值，所以需要处理该字段的默认值，如果默认值是@公式，需要解析@公式后再赋值

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

recordDatas - 表记录数据，一个List类型的BO集合 多行记录封装到List

userContext - 记录创建人，如果为null默认该记录以admin身份创建

返回:

返回操作影响的记录数，新建成功后的ID值可以从recordDatas中取ID

抛出:

AWSDataAccessException

remove

int remove(java.lang.String boName,
           java.lang.String boId)
    throws AWSDataAccessException

删除一条BO表记录。

参数:

boName - BO表名称

boId - BO表记录Id

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

remove

int remove(java.lang.String boName,
           java.lang.String boId,
           java.sql.Connection conn)
    throws AWSDataAccessException

删除一条BO表记录。

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

boId - BO表记录Id

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

removeByBindId

int removeByBindId(java.lang.String boName,
                   java.lang.String bindId)
            throws AWSDataAccessException

删除与某流程实例相关的BO表记录。

参数:

boName - BO表名称

bindId - 流程实例Id

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

removeByBindId

int removeByBindId(java.lang.String boName,
                   java.lang.String bindId,
                   java.sql.Connection conn)
            throws AWSDataAccessException

删除与某流程实例相关的BO表记录。

参数:

conn - 当前操作使用的数据库连接

boName - BO表名称

bindId - 流程实例Id

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

update

int update(java.lang.String boName,
           BO recordData)
    throws AWSDataAccessException

更新一条BO表记录。

参数:

boName - BO表名

recordData - 一个BO数据对象

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

updateByBindId

int updateByBindId(java.lang.String entityName,
                   BO recordData)
            throws AWSDataAccessException

按bindId更新记录。recordData必须设置bindId

参数:

entityName - BO表名

recordData - 更新数据

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

updateByWhere

int updateByWhere(java.lang.String entityName,
                  java.util.Map<java.lang.String,java.lang.Object> updates,
                  java.util.Map<java.lang.String,java.lang.Object> querys)

update

int update(java.lang.String boName,
           BO recordData,
           java.sql.Connection conn)
    throws AWSDataAccessException

更新一条BO表记录。

参数:

conn - 当前操作使用的数据库连接

boName - BO表名

recordData - 一个BO数据对象

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

updateByBindId

int updateByBindId(java.lang.String boName,
                   java.lang.String bindId,
                   java.lang.String fieldName,
                   java.lang.Object value)
            throws AWSDataAccessException

（批量）根据流程实例更新BO数据

参数:

boName - BO表名

bindId - 流程实例ID

fieldName - 字段名称

value - 字段更新值

返回:

该操作影响的记录数

抛出:

AWSDataAccessException

get

BO get(java.lang.String boName,
       java.lang.String boId)
throws AWSDataAccessException

根据BOID查询一条BO数据

参数:

boName - BO表名

boId - BO数据ID

返回:

如果未查到，返回null

抛出:

AWSDataAccessException

get

java.lang.Object get(java.lang.String boName,
                     java.lang.String boId,
                     java.lang.String fieldName)
              throws AWSDataAccessException

根据BOID查询指定字段的值

参数:

boName - BO表名

boId - BO数据ID

fieldName - 字段名称

返回:

如果未查到，返回null

抛出:

AWSDataAccessException

getByProcess

BO getByProcess(java.lang.String boName,
                java.lang.String processInstId)
         throws AWSDataAccessException

根据流程实例查询一条BO数据，适用于流程表单的主表数据

参数:

boName - BO表名

processInstId - 流程实例ID

返回:

如果未查到，返回null

抛出:

AWSDataAccessException

getByProcess

java.lang.Object getByProcess(java.lang.String boName,
                              java.lang.String processInstId,
                              java.lang.String fieldName)
                       throws AWSDataAccessException

根据流程实例查询指定字段的值，适用于流程表单的主表数据

参数:

boName - BO表名

processInstId - 流程实例ID

fieldName - 字段名称

返回:

如果未查到，返回null

抛出:

AWSDataAccessException

getByKeyField

BO getByKeyField(java.lang.String boName,
                 java.lang.String fieldName,
                 java.lang.Object value)
          throws AWSDataAccessException

根据唯一字段查询一条BO数据，适用于流程表单的主表数据

参数:

boName - BO表名

fieldName - 字段名

value - 字段值

返回:

如果未查到，返回null

抛出:

AWSDataAccessException

query

BOQueryAPI query(java.lang.String boName)

获得该BO的查询对象，该方法默认不加载大文本类型字段值。
！！！请注意！！！，该方法默认不加载大文本类型字段值。
！！！请注意！！！，该方法默认不加载大文本类型字段值。

参数:

boName - BO表名

返回:

BO查询对象

query

BOQueryAPI query(java.lang.String boName,
                 java.lang.String fields)

获得该BO的查询对象

参数:

boName - BO表名

fields - ,号分割的字段列表

返回:

BO查询对象

query

BOQueryAPI query(java.lang.String boName,
                 boolean loadBigText)

获得该BO的查询对象，该方法允许指定是否加载大文本类型字段值。

参数:

boName - BO表名

loadBigText - 是否读取大文本字段

getFiles

java.util.List<FormFile> getFiles(java.lang.String boId,
                                  java.lang.String fieldName)
                           throws AWSDataAccessException

获取指定附件字段已上传的全部文件列表

参数:

boId - BO表记录Id

fieldName - 字段名称。该字段一定是表单附件类型

返回:

表单附件列表，无文件返回NULL

抛出:

AWSDataAccessException

getFile

java.io.InputStream getFile(java.lang.String fileId)
                     throws AWSDataAccessException

读取指定文件内容，该API需要关闭流。

参数:

fileId - 附件文件Id。可以通过getFields返回的FormFile.getId()获取

返回:

文件流

抛出:

AWSDataAccessException

另请参阅:

#getFiles(String, String)}

getFile

java.io.InputStream getFile(java.lang.String fileId,
                            java.lang.String repositoryName)
                     throws AWSDataAccessException

读取指定文件内容，该API需要关闭流。

参数:

fileId - 附件文件Id。可以通过getFields返回的FormFile.getId()获取

repositoryName - 仓库根目录名，该场景下使用固定值：DCConst.REPOSITORY_UI_FILE

返回:

文件流

抛出:

AWSDataAccessException

另请参阅:

#getFiles(String, String)}, DCConst

upFile

void upFile(FormFile formFile,
            java.io.InputStream data)
     throws AWSDataAccessException

将文件上传到BO表的指定字段并设置formFile附加信息，该API需要关闭流。 如果formFileModel的id不为空，将执行附件和附件信息的更新操作 ，但是如果指定的InputStream为null，则只更新其他相关附属信息，如remark

如果formFile对象中指定的地址是“图片标识”组件，可以构造一个JSON放到formFile对象中的Ext1属性中。将会按照图片标识的机制上传

“图片标识”组件设置的参数，会解析@公式，会使用formFile.getCreateUser()中的值构造用户上下文

“图片标识”组件上传的机制仅支持6.2.14后的平台版本

JSON结构用于裁切图片处理：

{"x":48,"y":4,"width":122,"height":122,"showWidth":200,"showHeight":200,"ratio":1}

x:目标切片起点坐标X

y:目标切片起点坐标Y

width:目标切片宽度

height:目标切片高度

showWidth:裁切宽度，目前仅支持正方形

showHeight:裁切高度，目前仅支持正方形

ratio:缩放比例

参数:

formFile - 表单附件对象，接口FormFile或FormFileModel实现类

data - 附件流

抛出:

AWSDataAccessException

另请参阅:

FormFileModel

upFile

void upFile(FormFile formFile,
            java.lang.String repositoryName,
            java.io.InputStream data)
     throws AWSDataAccessException

将文件上传到BO表的指定字段并设置formFile附加信息，该API需要关闭流。 如果formFileModel的id不为空，将执行附件和附件信息的更新操作 ，但是如果指定的InputStream为null，则只更新其他相关附属信息，如remark

参数:

formFile - 表单附件对象，接口FormFile或FormFileModel实现类

repositoryName - 仓库根目录名

data - 附件流

抛出:

AWSDataAccessException

另请参阅:

FormFileModel

removeFiles

void removeFiles(java.lang.String boId,
                 java.lang.String fieldName)
          throws AWSDataAccessException

批量删除指定字段的所有文件

参数:

boId - BO表记录Id

fieldName - 字段名称。该字段一定是表单附件类型

抛出:

AWSDataAccessException

removeFile

void removeFile(java.lang.String fileId)
         throws AWSDataAccessException

删除指定文件

参数:

fileId - 附件文件Id。可以通过getFields返回的FormFile.getId()获取

抛出:

AWSDataAccessException

getFileDCContext

DCContext getFileDCContext(FormFile formFile)

获得表单附件的DC上下文

参数:

formFile - 表单附件对象，接口FormFile或FormFileModel实现类

getFileDCContext

DCContext getFileDCContext(FormFile formFile,
                           java.lang.String repositoryName)

获得表单附件的DC上下文

参数:

formFile - 表单附件对象，接口FormFile或FormFileModel实现类

repositoryName - 指定formFile对应的仓库根目录名

getFileDCContext

DCContext getFileDCContext(UserContext me,
                           FormFile formFile,
                           java.lang.String repositoryName)

copyFileTo

void copyFileTo(java.lang.String sourceBoId,
                java.lang.String sourceFieldName,
                java.lang.String targetBoId,
                java.lang.String targetBOName,
                java.lang.String targetFieldName,
                java.lang.String targetProcessInstId,
                java.lang.String targetTaskInstId)

将指定的源附件字段的全部文件复制到目标附件字段

参数:

sourceBoId - 源BO表Id

sourceFieldName - 源BO表附件字段名

targetBoId - 目标BO表Id

targetBOName - 目标BO表名

targetFieldName - 目标BO表附件字段名

targetProcessInstId - 目标流程实例Id

targetTaskInstId - 目标任务实例Id，如果与任务无关，允许为空

copyFileTo

void copyFileTo(java.lang.String sourceBoId,
                java.lang.String sourceFieldName,
                java.lang.String targetBoId,
                java.lang.String targetBOName,
                java.lang.String targetFieldName,
                java.lang.String targetProcessInstId,
                java.lang.String targetTaskInstId,
                boolean keepCreateUser)

将指定的源附件字段的全部文件复制到目标附件字段

参数:

sourceBoId - 源BO表Id

sourceFieldName - 源BO表附件字段名

targetBoId - 目标BO表Id

targetBOName - 目标BO表名

targetFieldName - 目标BO表附件字段名

targetProcessInstId - 目标流程实例Id

targetTaskInstId - 目标任务实例Id，如果与任务无关，允许为空

copyFileTo

void copyFileTo(java.lang.String sourceBoId,
                java.lang.String sourceFieldName,
                java.lang.String sourceRepositoryName,
                java.lang.String targetBoId,
                java.lang.String targetBOName,
                java.lang.String targetFieldName,
                java.lang.String targetRepositoryName,
                java.lang.String targetProcessInstId,
                java.lang.String targetTaskInstId)

将指定的源附件字段的全部文件复制到目标附件字段

参数:

sourceBoId - 源BO表Id

sourceFieldName - 源BO表附件字段名

sourceRepositoryName - 源BO表字段使用的附件仓库根目录名

targetBoId - 目标BO表Id

targetBOName - 目标BO表名

targetFieldName - 目标BO表附件字段名

targetRepositoryName - 目标BO表字段使用的附件仓库根目录名

targetProcessInstId - 目标流程实例Id

targetTaskInstId - 目标任务实例Id，如果与任务无关，允许为空

createValueHistory

int createValueHistory(java.lang.String processInstId,
                       java.lang.String taskInstId,
                       java.lang.String tableName,
                       java.lang.String sourceId,
                       java.lang.String fieldName,
                       java.lang.String fieldType,
                       java.lang.String fieldTitle,
                       java.lang.String modifyUid,
                       java.lang.String modifyUser,
                       java.lang.String ov,
                       java.lang.String nv,
                       java.lang.String ip,
                       java.lang.String extData1,
                       int extData2)

单条插入字段值差异历史数据

参数:

processInstId - 流程实例ID

taskInstId - 任务实例Id

tableName - 当前修改字段所在BO表名

fieldName - 修改字段名

sourceId - bo记录id

fieldType - 字段组件类型，参考UIConstant类

fieldTitle - 修改字段标题

modifyUid - 修改人账号

modifyUser - 修改人名称，值为：部门全路径/用户姓名 格式如：公司1/部门1/张三

ov - 旧值

nv - 新值

ip - 当前主机ip地址

extData1 - 扩展字段1

extData2 - 扩展字段2

从以下版本开始:

6.3.2

另请参阅:

com.actionsoft.bpms.ui.constant.UIConstant

createValueHistory

int[] createValueHistory(java.util.List<java.util.Map<java.lang.String,java.lang.Object>> list)

批量插入字段值差异历史数据

参数:

list - 插入的数据列表，Map键值为： processInstId 流程实例ID,taskInstId 任务实例Id,tableName 当前修改字段所在BO表名,fieldName 修改字段名,sourceId bo记录id,fieldType 字段组件类型，参考UIConstant类, fieldTitle 修改字段标题, modifyUid 修改人账号, modifyUser 修改人名称，值为：部门全路径+用户姓名,ov 旧值,nv 新值, ip 当前主机ip地址,extData1 扩展字段1,extData2 扩展字段2 参数类型为int

从以下版本开始:

6.3.2

另请参阅:

com.actionsoft.bpms.ui.constant.UIConstant

queryHistoryValuePagation

java.util.List<HistoryValueModel> queryHistoryValuePagation(java.lang.String processInstId,
                                                            int start,
                                                            int limit)

根据流程实例ID分页查询历史数据

参数:

processInstId - 流程实例ID

start - 查询起始位置

limit - 查询个数

从以下版本开始:

6.3.2

queryHistoryValueByProcessInstId

java.util.List<HistoryValueModel> queryHistoryValueByProcessInstId(java.lang.String processInstId)

根据流程实例ID查询所有历史数据

参数:

processInstId - 流程实例ID

从以下版本开始:

6.3.2