自定义数据打印
功能说明
调用表单打印模板实现打印。
支持表单已有字段数据打印,也支持自定义数据(风格和字段内容等)打印。
表单已有字段数据打印:Word模板和在线模板均支持;
自定义数据(风格和字段内容等)打印:只有Word模板支持。
接口详情
请求URL
https://XXX.XXX.XXX/openapi/v1/group/custom_print
请求参数
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
appId | 是 | String | 应用id |
entryId | 是 | String | 表单id |
printId | 是 | String | 打印模版的ID |
data | 否 | Object | 数据内容 |
markList | 否 | Object | 自定义表格数据列表(仅支持word模版); 自定义数据,可自定义字段内容及风格。 mark_key:标识,文字可自定义。将\${mark_key}写入Word打印模板中,调用本接口实现打印。 header_style:表格的表头样式。 value_style:表格中值的样式。 header:表格的表头值。 value:表格中的值。 |
请求示例:
{
"appId": "51fd950725cce8d9ab2d20c0",
"entryId": "5ebe210bc7c73f2b0d5c1d08",
"printId": "d8512a2009c6225f2fbfbdea",
"data": {
"单行文本": "内容",
"复选框组": [
"选项A",
"选项B"
],
"成员单选": "55cb7d57f7a190e382857117",
"图片": [
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
],
"地址": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "世贸"
},
"子表单": [
{
"子表单数字": 123,
"子表单单行文本": "内容"
},
{
"子表单数字": 1234,
"子表单单行文本": "内容22"
}
]
},
"markList": {
"mark_key": {
"common_style": {
"header-height": 2000, //表头高
"value-height": 7370 //内容高
},
"header_style": {
"1": {
"font-family": "楷体", //字体
"font-size": 44, //字体大小
"font-bold": true, //是否加粗 true false
"font-strike": true, //是否删除线
"font-italic": true, //是否斜体
"font-underline": true, //是否下划线
"font-color": "FF0000", //字体颜色 颜色的16进制
"v-align": "center", //center 居中 top靠上 bottom靠下 垂直对齐方向
"text-align": "right", //center 居中 left左 right右 水平对齐方向
"background-color": "000000", //单元格背景色 颜色的16进制
"width": 1000 //单元格宽
},
"3": {
"font-family": "楷体",
"font-size": 20,
"font-bold": true,
"font-strike": true,
"font-italic": true,
"font-underline": true,
"font-color": "FF0000",
"v-align": "center",
"text-align": "right",
"background-color": "000000",
"width": 500
}
},
"value_style": {
"0": {
"font-family": "楷体",
"font-size": 20,
"font-bold": true,
"font-strike": true,
"font-italic": true,
"font-underline": true,
"font-color": "FF0000",
"v-align": "center",
"text-align": "right",
"background-color": "000000",
"width": 500
}
},
"header": [
{
"title": "姓名",
"type": "text"
},
{
"title": "年龄",
"type": "number"
},
{
"title": "地址",
"type": "address"
},
{
"title": "图片",
"type": "image"
}
],
"value": [
[
"张三",
20,
{
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "世贸"
},
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
],
[
"李四",
21,
{
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "世贸"
},
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
],
[
"王五",
22,
{
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "世贸"
},
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
]
]
},
"中文key": {
"header": [
{
"title": "姓名",
"type": "text"
},
{
"title": "年龄",
"type": "number"
}
],
"value": [
[
"张三",
20
],
[
"李四",
21
],
[
"王五",
22
]
]
},
"again111": {
"header": [
{
"title": "图片",
"type": "image"
}
],
"value": [
[
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
],
[
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
],
[
{
"url": "https://qiniu.XXX.com/Fkb2p_cpcuTTt8IAvXHgvdOg0hGg"
}
]
]
}
}
}
返回参数
参数 | 说明 |
---|---|
url | 打印文件URL链接 |
size | 打印文件大小 |
响应示例:
{
"url": "https://XXX.XXX.com/e6159bd0c0318281bcc2265e9af06e03",
"size": 52803
}
使用接口步骤
以调用Word打印模板为例:
第一步:本地设计Word打印模板,并将${mark_key}写入Word打印模板。
Word打印模板设计 |
---|
第二步:表单设置-打印模板处,上传Word打印模板,获取模板printId。
第三步:调用接口,实现打印。
接口返回 |
---|
打开接口返回值中的URL |
---|