1.  氚云后端代码，是不能直接调用到第三方接口，必须做个中间层webservice，通过webservice去调用第三方返回数据，在将数据转义为JSON字符串，以SOAP协议回传给氚云。

总体业务流程图如下：

  2. webservice规范性：只能有4个同名接口，大小写都要一致，返回类型都为JSON字符串。对应关系如下表:

序号	函数
1	GetSchema(string schemaCode)
2	GetSchemaList()
3	GetList(string userCode, string   schemaCode, string filter)
4	Invoke(string userCode, string   schemaCode, string methodName, string param)

示例（C#）：

1. namespace   DingtalkWebService
   
2. 
   
3. {
   
4. 
   
5.       /// <summary>
   
6. 
   
7.       /// DingWebService 的摘要说明
   
8. 
   
9.       /// </summary>
   
10. 
    
11.       [WebService(Namespace = "http://tempuri.org/")]
    
12. 
    
13.       [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
    
14. 
    
15.       [System.ComponentModel.ToolboxItem(false)]
    
16. 
    
17.       // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消注释以下行。
    
18. 
    
19.       // [System.Web.Script.Services.ScriptService]
    
20. 
    
21.       public class DingWebService :   System.Web.Services.WebService
    
22. 
    
23.       {
    
24. 
    
25.           [WebMethod]
    
26. 
    
27.           public string   GetSchema(string schemaCode)
    
28. 
    
29.           {
    
30. 
    
31.             return string.Empty;//返回JSON字符串
    
32. 
    
33.           }
    
34. 
    
35.           [WebMethod]
    
36. 
    
37.           public string   GetSchemaList()
    
38. 
    
39.           {
    
40. 
    
41.             return string.Empty;//返回JSON字符串
    
42. 
    
43.           }
    
44. 
    
45. 
    
46. 
    
47.           [WebMethod]
    
48. 
    
49.           public string   GetList(string userCode, string   schemaCode, string filter)
    
50. 
    
51.           {
    
52. 
    
53.             return string.Empty;//返回JSON字符串
    
54. 
    
55.           }
    
56. 
    
57. 
    
58. 
    
59.           [WebMethod]
    
60. 
    
61. //氚云后端调用的方法名
    
62. 
    
63.           public string   Invoke(string userCode, string   schemaCode, string methodName, string   param)
    
64. 
    
65.           {
    
66. 
    
67. //书写调用第三方接口方法
    
68. 
    
69. 
    
70. 
    
71.             return string.Empty;//返回JSON字符串
    
72. 
    
73.           }
    
74. 
    
75.       }
    
76. 
    
77. }

复制代码

Invoke方法返回的JSON字符串格式

1. 
   
2. {"ResultCode":"0",   "Message":"",   "Schema":{"Code":"Student","Items":[{"Name":"Name","DisplayName":"学生姓名","DataType":"String"},{"Name":"Age","DisplayName":"学生年龄","DataType":"Int"},{"Name":"ReturnData","DisplayName":"子表数据","DataType":"BizStructureArray","ChildSchema":{"Code":"ResultObject","Items":[{"Name":"ResultCode","DisplayName":"执行结果代码","DataType":"Int"},{"Name":"ErrorMessage","DisplayName":"异常原因","DataType":"String"}]}}]},   "Data":{"Name":"张三","Age":"10","ReturnData":[{"ResultCode":"0","ErrorMessage":"0"},{"ResultCode":"1","ErrorMessage":"1"}]}}

复制代码

  3.  氚云系统集成-接入第三方系统的配置：将书写好的webservice挂载到服务器上，发布访问的webservice地址（外网要能访问）,在将该地址配置‘接入通用系统 ’，如下图所示：

注意若webservice书写的不规范，则会显示连接失败。

  4. 氚云后端调用webservice方法：Invoke

示例：

1.   //定义传输结构-主表
   
2. 
   
3.           H3.BizBus.BizStructureSchema paramSchema = new   H3.BizBus.BizStructureSchema();
   
4. 
   
5.           paramSchema.Add(new H3.BizBus.ItemSchema("BillsCustomer",   "客户", H3.Data.BizDataType.ShortString, 200,   null));
   
6. 
   
7.           paramSchema.Add(new H3.BizBus.ItemSchema("TotalMoney",   "总计", H3.Data.BizDataType.Double, 200,   null));
   
8. 
   
9.           //定义传输结构-子表
   
10. 
    
11.           H3.BizBus.BizStructureSchema detailsSchema = new   H3.BizBus.BizStructureSchema();
    
12. 
    
13.           detailsSchema.Add(new H3.BizBus.ItemSchema("Type", "收款类型", H3.Data.BizDataType.ShortString, 200, null));
    
14. 
    
15.           detailsSchema.Add(new H3.BizBus.ItemSchema("Money", "金额", H3.Data.BizDataType.Double, 200, null));
    
16. 
    
17.           //主表赋值
    
18. 
    
19.           paramSchema.Add(new H3.BizBus.ItemSchema("details", "明细", H3.Data.BizDataType.BizStructureArray, detailsSchema));//子表添加到主表
    
20. 
    
21.           H3.BizBus.BizStructure paramData = new   H3.BizBus.BizStructure(paramSchema);
    
22. 
    
23.           paramData["BillsCustomer"] = "chen";
    
24. 
    
25.           paramData["TotalMoney"] = 123;
    
26. 
    
27.           //子表赋值
    
28. 
    
29.           List < H3.BizBus.BizStructure > detailsDatas=new   List<H3.BizBus.BizStructure>();
    
30. 
    
31.           for(int k = 0;k < 2; k++)
    
32. 
    
33.           {
    
34. 
    
35.             H3.BizBus.BizStructure   detailsData = new H3.BizBus.BizStructure(detailsSchema);
    
36. 
    
37.             detailsData["Type"] =   "氚云";
    
38. 
    
39.             detailsData["Money"] =   11;
    
40. 
    
41.             detailsDatas.Add(detailsData);
    
42. 
    
43.           }
    
44. 
    
45.           //子表的值赋值给主表
    
46. 
    
47.           paramData["details"] = detailsDatas.ToArray();
    
48. 
    
49. 
    
50. 
    
51.           //调用Invoke接口，系统底层访问第三方WebService接口的Invoke方法
    
52. 
    
53.           H3.BizBus.InvokeResult InResult = this.Engine.BizBus.Invoke(H3.Organization.User.SystemUserId,   H3.BizBus.AccessPointType.Legacy, this.Request.SchemaCode, "自定义参数", paramData);
    
54. 
    
55.           if(InResult != null)
    
56. 
    
57.           {
    
58. 
    
59.             int Code = InResult.Code; //调用是否成功
    
60. 
    
61.             if(Code == 0)
    
62. 
    
63.               {
    
64. 
    
65.                 //获取返回数据
    
66. 
    
67.                 H3.BizBus.BizStructure Obj =   InResult.Data;
    
68. 
    
69.             }
    
70. 
    
71.             else
    
72. 
    
73.             {
    
74. 
    
75.                 //获取错误信息
    
76. 
    
77.                 string ErrorMessage =   InResult.Message;
    
78. 
    
79.             }
    
80. 
    
81.           }

复制代码

请问有springboot版本的webservice demo示例吗