更新日期:     浏览次数:

1. 组织与人员

本页介绍了和云之家组织与人员相关的JS-API方法,开发者可以根据应用的需求进行相应的配置。本页方法会不定期更新以满足更多应用个性化的开发需求。如果您有什么需求,欢迎在云之家开发者交流社区留言反馈,我们会根据您的需求进行优化。

1.1. 打开人员详情页面

调用代码: 这里说的人员详情是指调出云之家APP上面的人员详情页,而不是返回人员详细的内容。

qing.call('personInfo',  {
    'openId':'ge6sjw12sda2scdfefe2',
    'success': function (result) {}
});

参数说明:

参数名称 数据类型 必选 说明
openId string 云之家账号体系下的用户ID。

回调说明:

  • 当调用成功时直接调出指定人的个人信息详情页。

  • 当调用失败时:

{
success: false
error: 错误信息(String)
errorCode: 错误码(int)
data:
}

1.2. 返回人员信息

qing.call('getPersonInfo',  {
    'success': function (result) {
        alert(JSON.stringify(result))
    }
});

返回结果

    {
    success: true or false 是否成功(string)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data: {
       name:用户姓名(string)
       photoUrl:用户头像地址(string)
       gender:用户性别(int)
       eid:云之家账号体系下的工作圈id(string)
       openId:云之家账号体系下的用户id(string)
       wbuserid:部落账号体系下的用户id(string)
       wbnetworkid:部落账号体系下的工作圈id(string)
       email:邮箱(string)
       companyName:团队名称(string)//0.9.4及以上支持
       }
    }

1.3. 选择人员

调用代码:

qing.call('selectPersons', {
    'isMulti':false,
    'isShowMe':false,
    'range':['xxx','yyy'],//如果不需要指定范围,则不传该字段,而不是传空数组
    'selected':['aaa','bbb'],
    'ignore':['111','222'],
    'success': function(result){}
});

参数说明:

参数名称 数据类型 必选 说明
isMulti int 是否为多选,默认false。
isShowMe int 是否在选人组件中显示自己,默认false。
range array(string) 指定选人范围,仅在指定的范围内选人,数组中传openId。
selected array(string) 已选人员名单,数组中传openId。
ignore array(string) 过滤人员名单,数组中传openId。如果是指定范围选人,则该参数无效。

回调说明:

{
    success: true or false 是否成功(String)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data:{
        persons:[
            {
                name: 用户姓名
                avatarUrl:用户图像地址
                openId: 用户Id
            },...]
          }
}

1.4. 选择部门

调用代码:

qing.call('selectOrgs', {
    'isMulti':false,
    'success': function(result){}
});

参数说明:

参数名称 数据类型 必选 说明
isMulti int 是否为多选,默认false。

回调说明:

{
    success: true or false 是否成功(String)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data:{
        orgs:[
            {
                orgId: 部门ID
                orgName:部门名称
                personCount: 部门人数
            },...]
          }
}

results matching ""

    No results matching ""