H3 BPM 跨平台表单发起详解

Posted 2020-08-26

1.1 目的

　　为方便技术对接服务，实现流程业务的跨平台对接，给出指引和帮助文档。

 

2 跨平台以Java为例调用.NET BPM表单流程全过程

2.1 双方系统确定接口协议规则

    通信协议：基于soap通信utf-8编码，webservices访问。令牌、鉴权等（不知什么原因鉴权未做说明，理论上肯定是需要的）用于安全验证。

2.2 传参要求

    按照接口文档实现方法传参赋值。

2.3 .NET代码实现

以“启动H3流程实例”接口文件BPMService.asmx中的“StartWorkflow”方法为例说明。

 首先确定参数传送形式，此例以json字符串形式传参，出参。

BPM服务端实现：通过strjosn去做序列化转换成DataItemParam对象，将传参包进行解析，复制成BPM需要的参数格式形式，通过发起实例后返回实例发起结果。代码如下

 

 /// <summary>

        /// 启动H3流程实例

        /// </summary>

        /// <param name="workflowCode">流程模板编码</param>

        /// <param name="userCode">启动流程的用户编码</param>

        /// <param name="finishStart">是否结束第一个活动</param>

        /// <param name="paramValues">流程实例启动初始化数据项集合</param>

        /// <returns></returns> 

        [System.Web.Services.Protocols.SoapHeader("authentication")]

        [WebMethod(Description = "启动H3流程实例")]

        public string StartWorkflow(

            string workflowCode,

            string userCode,

            bool finishStart,

            string paramValues)

        {

 

            paramValues = "[{ItemName:‘苹果‘,ItemValue:5.5},{ItemName:‘橘子‘,ItemValue:2.5},{ItemName:‘柿子‘,ItemValue:16}]";

             List<DataItemParam> param = new List<DataItemParam>();

             param = StrJsontoObj.JSONStringToList<DataItemParam>(paramValues);

             BPMServiceResult result = startWorkflow(workflowCode, userCode, finishStart, param);

             var rel = new { Success=result.Success,

                             Message=result.Message,

                            data= new{

                                     instanceId=result.InstanceID,

                                     WorkItemID=result.WorkItemID,

                                     WorkItemUrl=result.WorkItemUrl  

                                    }

                           };

             return GetJson(rel);

        }

        public static string GetJson(object obj)

        {

            string str;

            try

            {

                str = Newtonsoft.Json.JsonConvert.SerializeObject(obj);

            }

            catch

            {

                str = "";

            }

            return str;

        }

解析字符串，返回需要的字符串

 

Josn字符串序列化与对象转换

 

出参格式调整

返回结果

 数据库实例

流程发起

 

2.4  Java代码实现

使用axis架包实现对接.NET服务（方法很多不唯一，仅作为实现范例）

方法实现

方法参数说明

Soap表头说明

输出结果。