WorkBuddy Enterprise 字段映射

字段映射规则说明
当您选择从数据源将目录数据导入到本系统时，会遇到人员属性结构不同的问题。例如：
假如在飞书中，人员的属性结构为
姓名：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"
				}
			}
		]
	}
}
﻿
说明：
若希望同步企微的手机号、邮箱等敏感字段至企业控制台，则需要：
在企微内设置成员信息自定义字段，参考企微文档：如何设置成员信息自定义字段﻿
在企业控制台侧企微认证源 > 设置字段映射 > 成员映射中，在“企业微信成员”设置自定义脚本来获取企微自定义字段值。企业控制台侧预置了 wecomExtAttr 方法可以直接使用。
示例: 获取企微自定义字段 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 默认字段
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

参数	属性名称	属性说明
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 默认字段
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 默认字段
dept.ou	部门名称
dept.objectGUID	部门 ID

字段映射

本页目录：

字段映射规则说明

企业微信获取数据说明

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

企业微信获取字段说明

AD 获取数据说明

AD 用户数据说明

AD 部门数据说明