跳到主要内容

HTTP 连接器 - 钉钉开放平台 - 获取员工花名册信息

1. 使用场景

本例介绍一下如何使用钉钉开放平台 OpenAPI 获取员工花名册信息 。

2. 实现功能

2.1. 申请钉钉开放平台应用凭证及接口权限

若已申请,可忽略此步骤。

2.2. 创建 HTTP 连接器

本例用到的连接器:获取员工花名册字段信息

2.2.1. 创建 HTTP 连接器

2.2.2. 配置连接器基本信息和登录方式

2.2.3. 配置连接器执行动作

接口请求 Body:

{
"agentid": 957064202,
"userid_list": "user123,user456",
"field_filter_list": "sys01-positionLevel,sys05-nowContractEndTime"
}

接口返回:

{
"errcode": 0,
"errmsg": "ok",
"result":[],
"success": true,
"request_id": "7dw5ezodufiy"
}

配置成功标识位:

2.2.4. 配置鉴权模板

若无账号,需新增账号,账号所需参数参考 2.1:

鉴权模板具体配置可参考:

此处为语雀内容卡片,点击链接查看:准备工作 - 宜搭自定义连接器鉴权模板配置

2.2.5. 测试 HTTP 连接器

当 Status 返回 200OK 成功且 Body 无返回错误证明连接器配置正确且可用。

2.3. 在宜搭页面配置数据源和使用数据源

2.3.1. 在数据源中选择刚刚创建的连接器

2.3.2. 配置页面

2.3.3. 配置 onChange 事件

绑定下述函数:

export function onUserIdChange({ value }) {
if (!value) {
this.$('textField_lcijv9od').reset();
this.$('textField_lcijv9oe').reset();
return;
};
this.dataSourceMap.getUserMessage.load({
inputs: JSON.stringify({
Body: {
userid_list: value,
agentid: '2345185741',
},
}),
}).then((res) => {
console.log(res);
const { success, result = [] } = res;
if (success) {
const data = result[0].field_data_list;
const deptName = data.filter((item) => {
return item.field_code === 'sys00-dept';
});
const position = data.filter((item) => {
return item.field_code === 'sys00-position';
});
this.$('textField_lcijv9od').setValue(deptName[0].field_value_list[0].value); // 部门
this.$('textField_lcijv9oe').setValue(position[0].field_value_list[0].value); // 职位
} else {
this.utils.toast({
title: '获取员工花名册信息失败',
type: 'error',
});
}
}).catch((error) => {
console.error(error.message);
this.utils.toast({
title: '请检查花名册的连接器是否配置正确.',
type: 'error',
});
})
}

3. 实现效果

4. 在线试玩

Copyright © 2024钉钉(中国)信息技术有限公司和/或其关联公司浙ICP备18037475号-4