Web流程设计器—外部服务节点kscript调用模式

适用版本：EAS_V8.6私有云

其他版本待出补丁

场景一，与异构系统集成：

       我们在使用工作流的时候可能会需要与其他系统或者其他模块进行协同，比如工作流中有一步是需要员工签署合同，这一步给员工发送短信，员工通过短信打开页面签署合同，签署完后，回调工作流，需要想在员工签署完后，才驱动工作流往下走，进行企业签署。

登记服务：

在使用外部服务节点之前，首先需要登记可以被工作流使用的外部服务，服务通过编写脚本代码实现，本文档只介绍kscirpt调用模式。

路径：应用→企业建模→业务流程管理→WEB流程设计器→流程资源→外部服务→新增→编写自定义业务脚本→保存

假设业务脚本为一个自定义的java类，方法：

com.kingdee.bos.workflow.othersysTest.OtherSysTest的sendMessage(...)

脚本调用java类com.kingdee.bos.workflow.othersysTest.OtherSysTest的sendMessage()方法：

流程设计：

路径：应用→企业建模→业务流程管理→WEB流程设计器→流程设计→新建流程→添加外部服务节点→打开节点→选中登记的外部服务→配置入参出参

打开外部服务节点，选择刚刚我们新增的外部服务，并且填入相应出入参数：

Web流程设计器配置好之后发布流程，就可以提交单据触发工作流了，流程运转到外部服务节点后，会先执行刚刚我们编写的脚本代码：

工作流运转到外部服务节点后会暂停，保持节点闪烁状态，不过本文中的案例只是模拟客户签署合同后回调工作流，所以在流程转到到外部服务节点，执行外部服务，执行完毕时就会回调工作流，驱使流程往下运转：

可以看到，在客户签署合同回调工作流后，工作流往下运转到了二级审批节点

回调工作流：

只有调用了回调工作流的代码，工作流才会继续往下运转，与异构系统集成的回调方式：

       1，通过openApi调用回调接口

       2，自定义webservice接口之后，再调用工厂类直接回调

使用openAPI的形式回调

（注：openAPI常见问题及学习资料详见：https://vip.kingdee.com/article/175622642354077952）

登录方式一：普通用户密码方式(需先登录再调用回调接口)

http://127.0.0.1:6888/easportal/openapi/login?authPattern=BaseDB&dcName=EAS850BETA3&isEncodePwd=0&language=l2&password=&user=zqtest

返回格式：

{

"data":"{"token":"qZbT9PATjqwuINItQwIZxCSYjesmiDtSYVIPuvV3LzPty2feKpVeFdJrcRnUS9iL"},

    "errCode":0,

    "errMsg":"执行成功"

}

username : 用户

password : 密码

dcName : 数据中心代码

language : 语言

slnName : eas

authPattern :验证方式 默认 "BaseDB" ; 其他认证方式KEY可从easAuthPatterns.xml中获取。如BaseTrdLtpaToken可动态切上下文

isEncodePwd  密码是否加密方式传递，0未加密，1加密（加密方式为DES，key为username，可以引用common.jar ）

errCode 为0代表执行成功，其他为失败

登录方式二：LtpaToken 免密码方式

http://local