驰骋工作流引擎 .net版CCFlow &java版本的JFlow微信微工作台集成配置说明

CCFlow & JFlow微信微工作台集成配置说明

1.创建微工作台

         1.先用管理员账号登录微信企业号后台 https://work.weixin.qq.com/

         2.点开应用与小程序。

​

         3.点击创建引用，输入应用名称、选择图标、选择可见范围（可见范围中的部门、人员都属于微信中的通讯录）

​

​

4.创建完成。

 

2.设置网页授权及JS-SDK

         1.进入创建的应用，找到开发者接口下面的网页授权及JS-SDK。

​

         2.点击设置，输入域名。此处必须是域名，可以加端口号，但是不能增加http://。比如ccflow.org:6666

         3.申请校验域名。点击后，会自动下载一个文件，将此文件，放到系统代码的根目录下。放入完成之后，点击确定，完成验证。

​

3.自定义菜单

1.找到自定义菜单，并点击设置，进入菜单配置页面。

​

2.添加菜单。目前ccflow&jflow支持6个通用的菜单配置，即：发起（Start.htm）、待办(Todolist.htm)、在途(Runing.htm)、抄送(CC.htm)、已完成(Complete.htm)、查询(Search.htm)。

在创建菜单时，请注意url中的参数变化。比如：

         https://open.weixin.qq.com/connect/oauth2/authorize?appid=12121212121212&redirect_uri=http://*****/CCMobile/action.aspx&response_type=code&scope=snsapi_base&state=Start#wechat_redirect

标红的，是需要修改的参数，其他参数固定不变。

appid:企业ID，在企业信息中可以查看到具体ID值。

​

redirect_uri:免登验证页面。免登验证页面是固定，http://****/CCMobile/action.aspx.

state:验证通过后，要进入的页面名称。名称对应上面的6个菜单，比如：Start=发起（Start.htm）

4.设置消息提醒

         设置消息提醒，是为了向用户推送消息。比如，张三向李四提交一个申请，点击发送之后，李四会在微信中收到该流程申请的消息推送通知。

         目前ccflow&jflow支持6中消息推送，即：工作到达、节点发送成功、节点退回后、节点撤销后、流程结束、流程删除。

        

         在设置微信消息推送之前，需要先在流程中设置消息事件。具体步骤：节点属性--节点消息--新建消息。微信推送的消息，属于短信消息设置，设置时设置如下图所示部分。

​

 

配置微信中的消息推送。找到接收消息，点击设置API接收。

​

 

输入微信验证请求的URL，比如：

    http://ccflow.org:6666/CCMobile/WeiXin.aspx.如果自己有专门编写的验证页面，可以将WeiXin.aspx替换。

​

Token与EncodingAESKey点击随机获取后，点击保存。保存成功后，配置成功。

​

5.参数配置

ccflow的配置文件web.config中（jflow配置文件地址：

\jflow-web\src\main\resources\jflow.properties），需要将微信中的几个重要参数进行配置。

 

​

 

 

 

配置文件中的参数与微信中的参数对应说明：

1.CorpID：企业ID。企业信息中。

​

2.AgentID，微工作台ID。

​

3.AppSecret，微工作台唯一标识。

​

4.WeiXinToKen，接收消息中的Token

​

5. EncodingAESKey,接收消息中的EncodingAESKey

​

6.WeiXin_MessageUrl，消息推送的域名地址，必须有http://。其实就是相当于网页授权及JS-SDK中配置的地址，增加了一个http头。

​

7.ShortMessageWriteTo，消息写入类型。0=写入SMS消息表，1=写指定的webservices接口，2=写入钉钉，3=写入微信。

 

 

 

 

6.注意事项

1.以上配置完成之后，需要检查微信通讯录与ccflow&jflow的port_emp表。用户在微信免登时，用户的帐号必须与在port_emp表中No列或Tel列相同，并且该用户已经关注了该微工作台，符合以上两个条件，才可以免登。

​

​

 

2.微信中消息推送，为图片消息。

newArticle.picurl = BP.Sys.SystemConfig.WX_MessageUrl + "/DataUser/ICON/" + BP.Sys.SystemConfig.SysNo + "/LogBig.png";

 

SysNo,是系统标识，CCFlow  or  JFlow

 

如果设置了LogBig.png 图片，消息显示格式为：

​

未设置图片的格式，显示为：

​