移动审批模板预置说明.docx
《移动审批模板预置说明.docx》由会员分享，可在线阅读，更多相关《移动审批模板预置说明.docx（21页珍藏版）》请在冰豆网上搜索。
移动审批模板预置说明
移动审批模板预置说明
移动审批App提供审批任务在移动终端的和审批功能。
1.移动审批实现方式
移动审批采用数据引擎+移动模板实现功能，后台服务统一使用移动数据查询服务组件提供服务接口实现，前端根据模板和数据动态显示内容，实现方式不需要单据业务开发人员编写服务和前端代码，只要在数据库中预置相关的数据引擎和模板元数据，即可在移动审批中支持单据的查看和审批。
2.元数据预置
2.1.定义相关接口参数
移动审批使用跟工作流和移动应用服务组件事先约定的一组接口参数调用单据审批和查看功能，在预置元数据之前需要明确定义这些接口参数，为预置数据作准备。
参数
说明
来源
示例
工作流对象ID
单据在工作流中注册的审批对象ID，用于移动端向工作流请求数据时指明单据类型
单据在UFData库AuditBizObjects
表注册的
cBizObjectId
字段值
销售订单：
17
单据CardNumber
单据在单据信息表中注册的单据类型ID，用于单据栏目同步
单据在UFData库
Vouchers表中注册的
CardNumber字段值
销售订单：
17
审批模板ID
单据的移动审批模板ID，用于移动审批的服务接口调用
固定前缀
getTaskBill_
加上工作流对象ID
销售订单：
getTaskBill_17
单据表头实体名称
表示单据头实体名，用于在移动模板中区分表头表体
自定义，移动模板预置表全局唯一
销售订单：
OrderTaskMainCols
单据表体实体名称
表示单据体实体名，用于在移动模板中区分表头表体
自定义，移动模板预置表全局唯一
销售订单：
OrderTaskDetailCols
2.2.预置数据引擎
数据引擎用于移动审批中读取单据数据。
可复用U8系统中已预置的单据查看或审批数据引擎配置，也可以新建数据引擎配置。
数据引擎配置请参考数据引擎相关文档。
如果使用新建的数据引擎配置，或对现有的配置进行了更改以支持移动审批，需要通过数据引擎配置工具导出配置脚本，以便在客户环境中部署，或提交到U8安装盘和补丁系统。
重要：
对于客户化开发，数据引擎配置应在UAP的“客户化”项目中进行，并确认导出脚本中的相关项目编号属性为“U8CUSTDEF”，否则用户升级U8版本后，客户化开发数据将被清除。
对于在U8标准产品中预置的内容，产品号应为“U870”。
移动审批模板预置数据中，要使用的数据引擎相关信息包括：
●业务对象ID
●功能名称
●数据查询名称
2.3.预置移动栏目
和U8的单据显示、打印模板类似，移动审批模板包含表头表体栏目集合，栏目集合决定了单据的哪些字段可以在移动审批中显示。
通常审批模板包含表头和表体两个栏目集合，表头和表体栏目集合使用不同的实体名称表示。
栏目集合定义了审批单据包含的数据字段，而单据业务数据来源于数据引擎查询的结果，因此，每个栏目集合需要指定一个数据引擎查询，并且栏目对象的字段名应包含在查询返回的结果列中。
2.3.1.预置栏目数据查询配置表
UFMeta库MERP_TemplateSub表保存移动相关的模板栏目配置信息。
表结构定义如下：
列名
类型
长度
可空
说明
示例
cActionType
nvarchar
200
no
审批模板ID，同时也是移动调用的服务接口，使用固定前缀
getTaskBill_
加上工作流对象ID
销售订单:
getTaskBill_17
cKey
nvarchar
200
no
表头或表体栏目实体名称
销售订单表头：
OrderTaskMainCols
销售订单表体：
OrderTaskDetailCols
cParentColumnID
nvarchar
400
yes
父级栏目实体名称。
表体栏目记录的该字段值为表头栏目实体名；表头记录的该字段值保留为Null
销售订单表头：
Null
销售订单表体：
OrderTaskMainCols
cNode
nvarchar
400
yes
栏目实体中文名，用于在移动模板设计器中显示
销售订单表头
或
销售订单表体
cBOID
nvarchar
400
no
数据引擎业务对象ID
8b457306-8339-4ee7-87bf-a939e9b1b19c
cFunctionName
nvarchar
400
no
数据引擎功能名称
销售订单表体：
SA_OrderDetailForMerp
cQueryName
nvarchar
400
yes
数据引擎查询名称
销售订单表体：
SA_OrderListForMerp
cGroupFld
nvarchar
400
yes
审批模板不使用
cGroupMode
nvarchar
400
yes
审批模板不使用
subID
nvarchar
200
no
子产品号
SA
projectID
nvarchar
200
no
项目号，标准产品预置使用U870，客户化开发使用U8CUSTDEF。
U870
cSynchronousKey
nvarchar
400
yes
模板同步Key，取对应单据在Data库Vouchers表中注册的CardNumber
销售订单：
17
cSynchronousType
nvarchar
400
yes
模板同步类型，单据审批取值只能是1
1
对于包含表头表体结构的单据，该表中的预置数据为两条记录。
2.3.2.预置数据查询条件参数
移动审批运行时通过数据引擎配置生成SQL查询语句，再根据移动服务调用的上下文传入查询参数。
数据过滤的参数通常不需要在数据引擎配置中定义，而在移动模板配置中指定查询条件参数，实现对数据的过滤。
查询条件参数在UFMeta库MERP_Conditions表中预置。
表结构定义如下：
列名
类型
长度
可空
预置说明
示例
cKey
nvarchar
200
no
栏目项所属的栏目实体名称，与MERP_TemplateSub表保持一致
销售订单表头：
OrderTaskMainCols
cVarient
nvarchar
200
no
参数名，以@开头。
审批模板只需要一个参数，固定为@voucherid
@voucherid
cExpression
text
16
no
SQL条件表达式，实现从数据引擎查询中过滤具体某条单据的数据。
可使用cVarient定义的参数名和数据引擎字段别名表。
表达式中的单引号需要使用两个单引号转义以便在Exec语句中执行。
#FN[orderid]=''+@voucherid+''
（以上表达式为预置的结果，预置时的Insert语句中单引号需要使用4个转义：
N'#FN[orderid]=''''+@voucherid+'''''
cVarientDataType
nvarchar
400
yes
sql数据类型
nvarchar（100）
cDescription
nvarchar
400
yes
条件描述
销售订单ID
subID
nvarchar
200
no
子产品号
SA
projectID
nvarchar
200
no
项目编号，标准产品预置使用U870，客户化开发使用U8CUSTDEF。
U870
cDefaultValue
nchar
400
yes
不使用
null
在该表中，需要分别为表头栏目和表体栏目数据引擎查询定义一个查询条件参数。
2.3.3.预置栏目项字典表
UFMeta库MERP_ColumnDic表保存移动栏目集合包含的栏目项字典。
表结构定义如下：
列名
类型
长度
可空
预置说明
示例
cKey
nvarchar
200
no
栏目项所属的栏目实体名称，与MERP_TemplateSub表保持一致
销售订单表头：
OrderTaskMainCols
cFld
nvarchar
200
no
栏目项字段名，与数据引擎查询结果列名保持一致
csocode
cCaption
nvarchar
400
no
栏目中文标题（移动应用只支持中文）
订单号
cPointBit
nvarchar
400
yes
小数位数，支持U8系统精度关键字。
可选值：
1、整数1-9
2、U8精度关键字：
amount（金额，固定为2）
billprice（开票单价精度）
exchangeper（换算率精度）
piece（件数精度）
price（存货单价精度）
quantity（数量精度）
tax（税率精度）
weight（存货重量精度）
volume（存货体积精度）
整数1-9或关键字，非数字型保留为null
cFormat
nvarchar
400
yes
格式化字符串，仅对数字和日期型有效，使用C#语法，日期格式yyyy-MM-ddHH:
mm:
ss，其中各位置的大小写必须匹配。
日期:
yyyy-MM-dd
日期时间：
yyyy-MM-ddHH:
mm:
ss
数字格式化为两位小数带分隔符：
{0:
#,##0.00}或{0:
N}
数字格式化为两位小数不带分隔符：
{0:
0.00}
数字格式化为带%：
{0:
0.00%}
cPrefix
nvarchar
400
yes
不使用
iColWidth
nvarchar
400
yes
不使用
cSuffix
nvarchar
400
yes
不使用
iAlign
nvarchar
400
yes
不使用
cGroupCode
nvarchar
400
yes
不使用
cOrder
nvarchar
400
yes
不使用
cReferType
nvarchar
400
no
不使用
bIsFixend
bit
1
no
不使用
bIsAbstract
bit
1
no
不使用
iAbsOrder
smallint
2
no
不使用
eNodeType
smallint
2
no
不使用
cAbsExpression
nvarchar
400
yes
表达式，可使用简单大纲语法拼接字符串，可使用@@标记的变量取栏目项的数值，用于显示特定格式的数据。
如在金额前显示币符：
RMB2000.00,可使用币符和金额字段拼接一个数值。
销售订单明细在数量后显示单位：
@@tity@@@@_unit@@
bIsVisble
bit
1
no
是否默认在移动审批中可见（原始字段名因预置时拼写错误，脚本中应注意）
1
subID
nvarchar
200
no
所属子产品
SA
projectID
nvarchar
200
no
项目编号，标准产品预置使用U870，客户化开发使用U8CUSTDEF。
U870
iColPos
nvarchar
400
yes
不使用
iDisplayColPos
int
4
yes
显示顺序，整数
1
bIsCollect
bit
1
yes
不使用
bMustReturn
bit
1
yes
是否必须在数据引擎查询中返回。
移动数据引擎查询默认只返回bIsVisble=1的字段，对于在
升级会员 