氚云帮助中心

{{ item.text }} webservice

webservice

更新时间： 2023-12-01 浏览次数： {{ hits }}

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#）：

namespace DingtalkWebService

{

/// <summary>

/// DingWebService 的摘要说明

/// </summary>

[WebService(Namespace = "http://tempuri.org/")]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[System.ComponentModel.ToolboxItem(false)]

// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消注释以下行。

// [System.Web.Script.Services.ScriptService]

public class DingWebService : System.Web.Services.WebService

{

[WebMethod]

public string GetSchema(string schemaCode)

{

return string.Empty;//返回JSON字符串

}

[WebMethod]

public string GetSchemaList()

{

return string.Empty;//返回JSON字符串

}

[WebMethod]

public string GetList(string userCode, string schemaCode, string filter)

{

return string.Empty;//返回JSON字符串

}

[WebMethod]

//氚云后端调用的方法名

public string Invoke(string userCode, string schemaCode, string methodName, string param)

{

//书写调用第三方接口方法

return string.Empty;//返回JSON字符串

}

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

{"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

示例：

//定义传输结构-主表

H3.BizBus.BizStructureSchema paramSchema = new H3.BizBus.BizStructureSchema();

paramSchema.Add(new H3.BizBus.ItemSchema("BillsCustomer", "客户", H3.Data.BizDataType.ShortString, 200, null));

paramSchema.Add(new H3.BizBus.ItemSchema("TotalMoney", "总计", H3.Data.BizDataType.Double, 200, null));

//定义传输结构-子表

H3.BizBus.BizStructureSchema detailsSchema = new H3.BizBus.BizStructureSchema();

detailsSchema.Add(new H3.BizBus.ItemSchema("Type", "收款类型", H3.Data.BizDataType.ShortString, 200, null));

detailsSchema.Add(new H3.BizBus.ItemSchema("Money", "金额", H3.Data.BizDataType.Double, 200, null));

//主表赋值

paramSchema.Add(new H3.BizBus.ItemSchema("details", "明细", H3.Data.BizDataType.BizStructureArray, detailsSchema));//子表添加到主表

H3.BizBus.BizStructure paramData = new H3.BizBus.BizStructure(paramSchema);

paramData["BillsCustomer"] = "chen";

paramData["TotalMoney"] = 123;

//子表赋值

List < H3.BizBus.BizStructure > detailsDatas=new List<H3.BizBus.BizStructure>();

for(int k = 0;k < 2; k++)

{

H3.BizBus.BizStructure detailsData = new H3.BizBus.BizStructure(detailsSchema);

detailsData["Type"] = "氚云";

detailsData["Money"] = 11;

detailsDatas.Add(detailsData);

}

//子表的值赋值给主表

paramData["details"] = detailsDatas.ToArray();

//调用Invoke接口，系统底层访问第三方WebService接口的Invoke方法

H3.BizBus.InvokeResult InResult = this.Engine.BizBus.Invoke(H3.Organization.User.SystemUserId, H3.BizBus.AccessPointType.Legacy, this.Request.SchemaCode, "自定义参数", paramData);

if(InResult != null)

{

int Code = InResult.Code; //调用是否成功

if(Code == 0)

{

//获取返回数据

H3.BizBus.BizStructure Obj = InResult.Data;

}

else

{

//获取错误信息

string ErrorMessage = InResult.Message;

}

webservice