利用zOffice SDK实现合同续签系统

经过用户调研和实际考察发现。商务、政务和个人的真实使用场景中，很多用户会有通过“用户数据”+“固定模板”生成“批量合同（文件）”的需求，并且存在着使用痛点。在在线办公不断发展的今天，我们需要一个在线编辑的工具可以批量完成这样的工作，帮助我们提升工作效率，并保证正确性。

一、zOffice简介

zOffice是一款自主研发的在线编辑套件。套件里有Word、Excel、PPT和在线预览四个产品，支持多种Office/WPS的文档格式。拥有丰富的API和SDK，可以集成到各种业务系统中。作为在线文档编辑服务，zOffice提供丰富的API，可以实现对Excel，Word等文档的内容操作。

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

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

二、场景描述

小张是一位市场总监助理，每周都要有几十份续签合同需要拟制。她需要将excel里的客户信息一个一个复制粘贴进word，进行保存。做一份需要3 - 5分钟，全部做完可能要2个小时。机械重复的工作让小张苦不堪言，希望能够有一个工具帮助他快速完成机械性的工作。

三、解决步骤

通过"合同模板"和"客户数据"两个文件, 通过zOffice的API即可实现工作效率的提升

第一步：实现一个简单的集成界面：

第二步：通过点击数据源可以打开客户数据的表格（此表格保存在一个excel文件中）

此步是通过发送RESTAPI到zOffice服务端，通过上传excel文件，可通过文件id和获取表格数据的API实现浏览表格内容条目，具体实现如下：

1、获取表格应用对象

要获取表格里面的数据，首先要获取表格应用对象

var application

在挂在了在线表格后，通过在javascript中定义application即可获取表格对象，此部分是SDK内置的函数对此变量进行了赋值

2、获取当前正在编辑的sheet表格

var sheet = await application.ActiveWorkbook.getActiveSheet();

这样我们就获取到了当前正在编辑的sheet表格，这里先获取到了application的ActiveWorkbook，也就是当前表格文件，然后调用了getActiveSheet()方法来获取sheet表格对象。

window.onload = async function() {    const app = await ZOfficeSDK.mount('http://<ip>/docs/app/<repoid>/<docid>/edit/content', '#doc1');      const sheets = await app.getSheets(); }

3、获取框选的需要统计的范围

const activeSheet = await app.getActiveSheet(); const range = activeSheet.getRange(1, 1, 5, 5);

通过调用sheet对象的getActiveRange()对象，我们就获取到了要统计的区域这个对象。之后就是将获取这个对象里每个单元格的值，这样我们就能进行统计逻辑的代码编写了。
//这四个变量是整个要统计区域的起始行，起始列，结束行，结束列

var beginRow = range.row;   var endRow = range.endRow;   var beginColumn = range.column;   var endColumn = range.endColumn;

//这个是将range对象转化为二维数组，方便进行每个单元格里值的获取

var valuesArray = await range.getValues();

通过getValues()的方式我们就能获取到要统计的范围里每个单元格的值。这样我们就能进行整个统计逻辑的构建，后面就是通过html,css,javascript完成整个逻辑并且将结果展示在结果展示区。

第三步：打开合同模版

此模版中包含一些需要动态修改内容的区域，如甲方名称，合同日期等，此部分内容通过标签标识

第四步：点击开始生成，即可通过调用zOffice提供的API接口逐一将表格中的信息替换到合同模版中，并生成相应的成品合同保存在系统中

此部分的示例代码如下：

async replaceBookmarkFileds(items) {     if (!items     items.length == 0)       return;     for(var it of items) {       if (it.val && it.val != "") {         await this.replaceBookmarkText(it.key, it.val);       }     }   },   async replaceBookmarkText(key, val) {     var app = await this.getDocumentApp(this.selectorTemplate);     var bm = await app.getBookmark(key);     await bm.setText(val);   },

其中，key是书签的名称，此名称可以和excel中客户信息的列名对应，方便我们操作对应的内容区域，val是此书签标识的内容需要替换成的内容。通过bookmark.setText即可实现书签内容的替换。

完成替换后，即可调用app.save() 直接保存文件。

保存后的文件可保存在云端，或者下载至本地.

四、总结

除了以上的API，zOffice还提供丰富的文档内容操作接口，可以对文档内容和格式进行深入的操作，让我们期待更多好用的功能和场景介绍吧。