CodeBuddy 字段映射

这篇说说腾讯云IDaaS目录导入的字段映射规则,并说明企业微信与AD数据源的可获取字段及同步限制。字段映射通过箭头配置数据源字段与系统字段的对应关系,默认提供常用映射。企业微信部分字段(如手机号、邮箱)需管理员授权及OAuth2才能获取,敏感字段可借助wecomExtAttr脚本获取自定义属性。AD支持用户与部门字段的默认映射。 企业微信:手机、邮箱等敏感字段需授权或OAuth2获取,状态字段自动映射。 AD:提供用。

相关产品
CodeBuddy 产品页,含版本规格、价格与购买入口。

一、字段映射规则说明

当你选择从数据源将目录数据导入到本系统时,会遇到人员属性结构不同的问题。例如:

假如在飞书中,人员的属性结构为

姓名:Alex Zhang

手机号:12345678901

邮箱:alexzhang@eid.com

岗位:研发工程师

毕业学校:腾讯云学院

性别:男

用户 ID:333

在本系统中,人员属性结构为

姓名:

手机:

邮箱:

工号:

职位:

入职时间

在将人员“Alex Zhang”从飞书导入到本系统的过程中,你希望飞书的“岗位”、“用户 ID”分别填写到本系统的“职位”、“工号”中,飞书中的“毕业学校”不做导入,本系统中的“入职时间”留空。

即你预期形成以下人员属性结构:

姓名:Alex Zhang

手机:12345678901

邮箱:alexzhang@eid.com

工号:333

职位:研发工程师

入职时间:

上述功能,“字段映射”模块可以帮助你完成。

箭头 “→” 代表映射关系,其左侧代表数据源中的字段,右侧代表本系统的字段。该配置的含义为:将数据源中人员的某字段中的信息,填入到本系统的对应字段中,并在后续同步中遵循此规则。

同时我们为你提供了常用的字段映射作为默认配置(例如:飞书中 mobile 字段映射至本系统的 mobile 字段),你也可以根据自身业务需要来配置双方的字段映射关系。

二、企业微信获取数据说明

受企业微信个人隐私保护规则影响,企业微信部分数据不可直接获取,此章节将详细描述具体企业微信可获取字段信息。

三、企业微信获取数据字段格式

{ "errcode": 0, "errmsg": "ok", "userid": "zhangsan", "name": "张三", "department": [1, 2], "order": [1, 2], "position": "后台工程师", "gender": "1", "biz_mail":"zhangsan@qyycs2.wecom.work", "is_leader_in_dept": [1, 0], "direct_leader":["lisi"], "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0", "thumb_avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/100", "telephone": "020-123456", "alias": "jackzhang", "address": "广州市海珠区新港中路", "open_userid": "xxxxxx", "main_department": 1, "extattr": { "attrs": [ { "type": 0, "name": "文本名称", "text": { "value": "文本" } }, { "type": 1, "name": "网页名称", "web": { "url": "http://www.test.com", "title": "标题" } } ] }, "status": 1, "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx", "external_position": "产品经理", "external_profile": { "external_corp_name": "企业简称", "wechat_channels": { "nickname": "视频号名称", "status": 1 }, "external_attr": [{ "type": 0, "name": "文本名称", "text": { "value": "文本" } }, { "type": 1, "name": "网页名称", "web": { "url": "http://www.test.com", "title": "标题" } }, { "type": 2, "name": "测试 app", "miniprogram": { "appid": "wx8bd80126147dFAKE", "pagepath": "/index", "title": "my miniprogram" } } ] }}

注意:说明:

注意:若希望同步企微的手机号、邮箱等敏感字段至企业控制台,则需要:

注意:示例: 获取企微自定义字段 empid 的值

注意:脚本为: wecomExtAttr("empid", user.extattr)

四、企业微信获取字段说明

参数 属性名称 属性说明
userid 成员 UserID 可以直接获取,对应企业控制台的账号,企业内必须唯一。不区分大小写,长度为1~64个字节;
name 成员名称 可以直接获取,需要管理员授权才返回;
mobile 手机号码 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2授权获取;
department 成员所属部门 ID 列表 可以直接获取,仅返回该应用有查看权限的部门 id;
order 部门内排序 可以直接获取,默认为0。数量必须和 department 一致,数值越大排序越前面。值范围是[0, 2^32)。
position 职务信息 可以直接获取,需要管理员授权才返回;
gender 性别 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;0表示未定义,1表示男性,2表示女性。
email 邮箱 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;
biz_mail 企业邮箱 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;
is_leader_in_dept 是否为所在部门负责人 可以直接获取,表示在所在的部门内是否为部门负责人,数量与 department 一致;
direct_leader 直属上级 UserID 可以直接获取,返回在应用可见范围内的直属上级列表,最多有1个直属上级;
avatar 头像 URL 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;
thumb_avatar 头像缩略图 URL 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;
telephone 座机 可以直接获取,需要管理员授权才返回;
alias 别名 可以直接获取,需要管理员授权才返回;
extattr 扩展属性 可以直接获取,需要管理员授权才返回;字段详见成员扩展属性。
status 激活状态 可以直接获取;已自动映射企业控制台身份状态,无需手动更改。激活状态: 1=已激活,2=已禁用,4=未激活,5=退出企业。已激活代表已激活企业微信或已关注微信插件(原企业号)。未激活代表既未激活企业微信又未关注微信插件(原企业号)。
qr_code 员工个人二维码 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;
external_profile 成员对外属性 可以直接获取,需要管理员授权才返回;
external_position 对外职务 可以直接获取,需要管理员授权才返回;
address 地址 数据源同步时无法直接获取,只能通过管理员授权且用户 OAuth2 授权获取;
open_userid 全局唯一标识 无法直接获取。
main_department 主部门 可以直接获取,仅当应用对主部门有查看权限时返回。

五、AD 用户数据说明

AD 默认字段 AD 默认字段
user.sAMAccountName 登录名(建议使用)
user.userPrincipalName 登录名
user.objectGUID 用户唯一标识
user.cn 姓名(建议使用)
user.mobile 移动电话(建议使用)
user.telephoneNumber 电话号码
user.mail 电子邮箱
user.homePhone 家庭电话
user.ipPhone IP 电话
user.distinguishedName DN
user.employeeNumber 工号
user.employeeID 工号
user.whenCreated 创建时间
user.displayName 显示名称
user.initials 英文缩写名字
user.name 姓名
user.sn 姓
user.givenName 名
user.description 描述
user.physicalDeliveryOfficeName 办公室
user.wWWHomePage 网页
user.co 国家/地区
user.st 省/自治区
user.l 市县
user.streetAddress 街道
user.postOfficeBox 邮政信箱
user.postalCode 邮政编码
user.facsimileTelephoneNumber 传真
user.pager 寻呼机
user.company 公司
user.department 部门
user.title 职务
user.manager 部门经理

六、AD 部门数据说明

AD 默认字段 AD 默认字段
dept.ou 部门名称
dept.objectGUID 部门 ID
赞 (0)
上一篇 4天前
下一篇 4天前