如何在word文档中批量插入二维码

合同系统中，一般流程是线上拟稿、审批、定稿，然后线下打印定稿的合同并且存档。当拿到一个纸质合同，需要去线上系统查询当时的合同拟制过程，那如何快速定位到这个文档，是一个问题。通用的做法是，将该文档的线上访问url，生成一个二维码，放到文档首页或最后一页。接下来介绍一下如何通过zOffice的Open API将一个或多个二维码批量插入到word文档中。

zOffice简介

zOffice提供云端Office能力，包括Word、Excel、PPT三类办公文档的在线协同编辑，通过专业级的文档能力，高效的协作体验，内容级的安全管控，丰富的集成开发接口，来赋能企业的业务系统，帮助业务系统实现文档在线预览和编辑，文档操作过程全部线上进行，完成在线办公的场景闭环。

官网链接： https://www.filez.com/zoffice

集成介绍文档：http:// https://lenovocloud.zbox.filez.com/l/a0OsO0

批量插入二维码

插入步骤：

1. 在合同文档模板的合适位置，插入二维码书签

2. 调用zOffice Open API的书签替换功能

3. 等待回调通知

书签替换API介绍

接口说明

POST {apiPrefix}/content/update

提交文档内容操作任务

- 任务添加失败，同步返回失败原因

- 任务添加成功，同步返回任务ID。第三方可以配置任务回调通知获取任务状态。

请求体

Content-Type为application/json

参数名	类型	说明	是否必须
fileUrl	string	文件下载地址	是
filename	string	包含后缀的文件名，目前源文件类型仅支持doc/docx/wps	是
tokenType	string	三方token类型，值为cookie或者header	否
tokenValue	string	三方token值，zOffice下载文件或回调通知时回传	否
callback	string	回调地址。任务结束后zOffice回调通知状态	是
ops	数组	对文档内容操作的有序操作数组，数组对象见下方op说明。	是

ops说明

选项名	选项类型	是否必须	说明
args	BookmarkRef数组	是	BookmarkRef对象包含四个属性： bookname dataType dataRef refName

- bookname: 书签名。书签名不存在时，对应替换会被忽略，但不会影响其他书签替换。

- dataType: 书签引用类型。可选值TEXT，DOC，PIC。分别对应引用内容为字符串，文档，图片。

- dataRef: 书签引用内容。

    - dataType为TEXT时，该值为字符串；

    - dataType为DOC或PIC时，该值为下载对应文件的URL。

        - 请求URL要求返回对应的文件流，其他无限制。

- refName: 书签引用名称。

    - dataType为TEXT时，该值可以省略；

    - dataType为DOC或PIC时，该值为dataRef对应带后缀的文件名，请确保文件后缀名正确，否则会导致套红结果不符预期

正确返回：

{

    "taskId": "6f6598c8-c87e-420b-b6c4-6f1b187201dc",

    "code": "Ok",

    "detail": {

        "taskStatus": "IN_QUEUE"

    }

}

错误返回：

{

    "taskId": "695fbf6e-90d2-42ba-83d5-00e81e5e366e",

    "code": "TaskQueueCongestion",

    "detail": {

        "taskStatus": "FAIL"

    }

}

限制

同一次文档内容替换，若actId为UpdateBookmarkRef，仅允许有一个

替换二维码

request请求体示例

{

"fileUrl": "http://{{thirdparty-demo}}/v2/context/sample.docx/content",

"filename": "sample.docx",

"callback": "http://{{thirdparty-demo}}/v2/context/callbackurl",

"ops": [

{

"actId": "UpdateBookmarkRef",

"options": {

"args": [

{

"bookname": "文档线上访问地址二维码",

"dataType": "PIC",

"dataRef": "http://{{thirdparty-demo}}/v2/context/local-PublicAPI-contentUpdate-updateBkRef-pic/content",

"refName": "qrcode.png"

},

{

"bookname": "公司官网二维码",

"dataType": "PIC",

"dataRef": "http://{{thirdparty-demo}}/v2/context/local-PublicAPI-contentUpdate-updateBkRef-body/content",

"refName": "webqrcode.png"

},

{

"bookname": "公司app下载二维码",

"dataType": "PIC",

"dataRef": "http://{{thirdparty-demo}}/v2/context/local-PublicAPI-contentUpdate-updateBkRef-body/content",

"refName": "appqrcode.png"

}

]

}

}

]

}

插入二维码的效果

总结

使用 zOffice Open API提供的文档操作能力，可以快速插入二维码等其他想要插入的图片内容，帮助业务系统批量操作，提高效率，安全快捷的处理业务流转过程中的线上环节。

另外，zOffice提供非常丰富的其他集成能力，您可以在论坛中搜索zOffice获取更多内容。相信利用zOffice，您可以更高效地生成各类业务文档，从而极大的提高您的办公自动化效率。