ynu-ws-client v0.2.1

ws-client

基于金智主数据平台的云南大学WebService客户端

How to Install

npm install ynu-ws-client

示例

注意: 由于有防火墙限制，以下实例只能运行在云南大学校内。

使用ES7：

import Client from 'ynu-ws-client';

// 创建客户端实例，需要填入正确的用户名和密码
const client = new Client({
  username: 'username',
  password: 'password',
});

// 使用invoke方法调用服务
const result = await client.invoke(8141, 1, 10, [{ key: 'XXMC', value: '云南大学' }]);
/*
返回结果：
{
  message: '调用成功!',
  returnCode: '600000',
  data: { columns: [ 'rn', 'xxdm' ], values: [ [Object] ] },
  pageNum: 0,
  pageSize: 0,
  total: '1'
}
 */

API

Client(options)

Client的构造函数。

参数

options: 构造函数参数。可用的参数如下：

invoke(interfaceId, pageNum, pageSize, params) : Promise

调用远程服务

参数

• interfaceId: 服务接口Id
• pageNum: 返回数据的页码。从1开始计数，默认为1.
• pageSize: 返回数据每页的数量。
• params: 服务接口需要的参数。一个数组，其元素是包含key和value属性的对象。

返回值

函数返回一个Promise对象。

• 调用成功时，resolve返回的是调用结果，一个JSON对象：

{
  message: '调用成功!',           // 调用结果信息
  returnCode: '600000',         // 返回码（详见下文）
  data: {                       // 返回数据
    columns: [ 'rn', 'xxdm' ],  // 数据列名称
    values: ['xx', 'yy']        // 列对应的值
  },
  pageNum: 0,                   // 数据页码
  pageSize: 0,                  // 数据每页数目
  total: '1'                    // 查询获得的数据总条数
}

其他

返回码

服务接口

获取组织机构标准 (810000001)

请求参数

无

返回字段

返回数据结构示例

{
  "returnCode" : "600000",
  "message" : "调用成功!",
  "total" : 1,
  "pageSize" : 10,
  "pageNum" : 1,
  "data" : {
    "columns" : [ "CC", "LS", "PX", "DM", "MC" ],
    "values" : [ [ "xx", "xx", "xx", "xx", "xx" ] ]
  }
}