自定义字段参数说明
- 单据自定义字段的传参如下所示
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifier | string | Y | 字段占位符 |
value | string | 字段内容 | |
detailFieldValues | List<Map<String,String>> | 明细类型字段 |
identifier字段占位符,是指某一类自定义字段在某种单据(普通保销,消费申请等)上的唯一标识符,可在表单管理->字段管理里配置,如下图所示,如果要在普通报销上传入数量这个字段,则identifier为field1
value字段内容,是指在单据上某个自定义字段具体的值,如下图所示,value的值是12
不同类型的自定义字段value的格式不一样,参考下表:
类型 | value格式 |
---|---|
单行文本/多行文本 | 字符串,如:"xxx" |
数字/金额 | 数字,如:"123" |
选项 | 选项的编码,如:"RD2002201AM4Z1XC" |
日期(单日) | "yyyy-MM-dd"或"yyyy-MM",具体根据该字段置的日期格式来 |
日期(时间段) | "yyyy-MM-dd~yyyy-MM-dd" |
- detailFieldValues是针对明细这一类自定义字段,如下图所示,如果单据上没有配置这种类型的字段则不用传, List<Map<String,String>>,其中List代表明细字段的行,可以有多行,Map的key为明细表单里的字段(也就是列)的identifier,value为该字段的值,value的格式参考上表
- 参数示例:
{
"customFormValues": [{
"identifier": "field1",
"value": "单行文本"
}, {
"identifier": "field2",
"value": 123
}, {
"identifier": "field3",
"detailFieldValues": [{
"field1": "单行文本1",
"field2": 234
}, {
"field1": "单行文本2",
"field2": 456
}]
}]
}