通过webservice接口启动一个蓝凌EKP审批流程

蓝凌ekp应用于很多单位的OA系统，早期的版本只提供webservice接口供开发调用，新的版本提供rest接口，调用更为方便。
webservice接口url一般是http://[IP]:[PORT] /sys/webservice/kmReviewWebserviceService?wsdl
可以用浏览器访问这个路径得到相关定义信息。
启动审批流程是调用这个方法：
addReview(KmReviewParamterForm webForm)
主要参数如下：

属性	类型	描述
docSubject	字符串（String）	标题
fdTemplateId	字符串（String）	模板id
formValues	字符串（Json）	流程表单数据
docStatus	字符串（String）	文档状态，可以为草稿（“10”）或者待审（“20”）两种状态，默认为待审
docCreator	字符串（Json）	流程发起人
attachmentForms	链表（List)	附件列表

启动审批流程的话，docStatus 得指定"20"，当然不指定的话，默认也是"20";docCreator的值不是一个username这种样子的字符串，而是类似{"LoginName":"username"}这种样子的字符串。formValues的值是一个json字符串，json的各属性是要传给流程的变量，以在ekp流程中呈现给审批人看到的信息。attachmentForms是一个json列表，每一项大概是这样子 { fdKey:“fd_enclosure”,fdFileName:“filename”,fdAttachment:fileimgBase64} 注意文件或者图片是base64编码的，大文件的话就不太适合放在流程附件里了，要传大文件的话，建议将大文件上传到某web服务器上，然后把链接放到formValues 里的某个属性的字符串中。
有个小细节要注意下，ekp的变量里，如果一个变量允许单值和多值，多值是list，单值则不能用list表示，必须去掉方括号。
下面我们介绍下在nodejs里怎么启动ekp审批流程

...
var jargs = require('./argsfile.json');
const soap = require('strong-soap').soap;//这个比较好用
...
var ekpargs = { 
	arg0:{
		docSubject: jargs.docSubject,
		fdTemplateId:jargs.ecptmpltid,
		formValues:'',
		docStatus:20,
		docCreator:'',
		attachmentForms:[]
		}
	} //webservice soap body 参数
...
//附件带两个图片为例
imgData = fs.readFileSync("images\\a.jpg");
imgBase64 = Buffer.from(imgData).toString('base64');
ekpargs.arg0.attachmentForms.push({ fdKey:"fd_enclosure",fdFileName:"a.jpg",fdAttachment:imgBase64});
imgData = fs.readFileSync("images\\b.jpg");
imgBase64 = Buffer.from(imgData).toString('base64');
ekpargs.arg0.attachmentForms.push({ fdKey:"fd_enclosure",fdFileName:"b.jpg",fdAttachment:imgBase64});

let formjv={ "fd_apluser":{"LoginName": obj.apluser }, "fd_srcnet": obj.src, "fd_destnet":obj.dest,"fd_reason":obj.reason, "fd_reviewer":{"LoginName": obj.reviewer },"fd_fileloc":obj.fileloc }
ekpargs.arg0.formValues=JSON.stringify(formjv);

ekpargs.arg0.docCreator=JSON.stringify({"LoginName": obj.apluser});

soap.createClient(jargs.ekpwsdlurl,(errscc, client)=> {
	if (errscc) { logger.error("EKP接口连接出错");  }
	else {
		logger.info("向EKP接口传数据");
		client.addSoapHeader(jargs.soapheader);//注意soapheader字符串请让ekp侧开发提供准确信息，比如分配的包含认证信息，形如`<tns:RequestSOAPHeader xmlns:tns=\"http://sys.webservice.client\">....</tns:RequestSOAPHeader>`
		client.addReview(ekpargs, (errcar, result)=> { 
			if (errcar) { logger.error("EKP接口传输出错"); } 
			else {
				logger.info("获取EKP返回流程ID: "+result.return);
				}
			})
		}
	})