docs-web-logo
使用指南

字段映射

1、字段映射规则说明

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

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

  1姓名：Alex Zhang                
  2手机号：12345678901      
  3邮箱：alexzhang@eid.com  
  4岗位：研发工程师       
  5毕业学校：腾讯云学院      
  6性别：男                
  7用户ID：333

但是在本系统中，人员属性结构为

  1姓名：        
  2手机：        
  3邮箱：        
  4工号：        
  5职位：        
  6入职时间：

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

即您预期形成以下人员属性结构：

  1姓名：Alex Zhang              
  2手机：12345678901     
  3邮箱：alexzhang@eid.com
  4工号：333             
  5职位：研发工程师        
  6入职时间：

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

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

img

我们为您提供了常用的字段映射作为默认配置（例如：飞书中mobile字段 映射至 本系统的mobile字段），您也可以根据自身业务需要来配置双方的字段映射关系。

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

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

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

  1{
  2	"errcode": 0,
  3	"errmsg": "ok",
  4	"userid": "zhangsan",
  5	"name": "张三",
  6	"department": [1, 2],
  7	"order": [1, 2],
  8	"position": "后台工程师",
  9	"mobile": "13800000000",
 10	"gender": "1",
 11	"email": "zhangsan@gzdev.com",
 12	"biz_mail":"zhangsan@qyycs2.wecom.work",
 13	"is_leader_in_dept": [1, 0],
 14	"direct_leader":["lisi"],
 15	"avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
 16	"thumb_avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/100",
 17	"telephone": "020-123456",
 18	"alias": "jackzhang",
 19	"address": "广州市海珠区新港中路",
 20	"open_userid": "xxxxxx",
 21	"main_department": 1,
 22	"extattr": {
 23		"attrs": [
 24			{
 25				"type": 0,
 26				"name": "文本名称",
 27				"text": {
 28					"value": "文本"
 29				}
 30			},
 31			{
 32				"type": 1,
 33				"name": "网页名称",
 34				"web": {
 35					"url": "http://www.test.com",
 36					"title": "标题"
 37				}
 38			}
 39		]
 40	},
 41	"status": 1,
 42	"qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx",
 43	"external_position": "产品经理",
 44	"external_profile": {
 45		"external_corp_name": "企业简称",
 46		"wechat_channels": {
 47			"nickname": "视频号名称",
 48			"status": 1
 49		},
 50		"external_attr": [{
 51				"type": 0,
 52				"name": "文本名称",
 53				"text": {
 54					"value": "文本"
 55				}
 56			},
 57			{
 58				"type": 1,
 59				"name": "网页名称",
 60				"web": {
 61					"url": "http://www.test.com",
 62					"title": "标题"
 63				}
 64			},
 65			{
 66				"type": 2,
 67				"name": "测试app",
 68				"miniprogram": {
 69					"appid": "wx8bd80126147dFAKE",
 70					"pagepath": "/index",
 71					"title": "my miniprogram"
 72				}
 73			}
 74		]
 75	}
 76}

2）企业微信获取字段说明

参数属性名称属性说明
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激活状态可以直接获取；已自动映射OneID身份状态，无需手动更改。激活状态: 1=已激活，2=已禁用，4=未激活，5=退出企业。已激活代表已激活企业微信或已关注微信插件（原企业号）。未激活代表既未激活企业微信又未关注微信插件（原企业号）。
qr_code员工个人二维码数据源同步时无法直接获取，只能通过管理员授权且用户oauth2授权获取；
external_profile成员对外属性可以直接获取，需要管理员授权才返回；
external_position对外职务可以直接获取，需要管理员授权才返回；
address地址数据源同步时无法直接获取，只能通过管理员授权且用户oauth2授权获取；
open_userid全局唯一标识无法直接获取。
main_department主部门可以直接获取，仅当应用对主部门有查看权限时返回。

3、AD获取数据说明

1）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 部门经理

2）AD部门数据说明

AD默认字段AD默认字段
dept.ou部门名称
dept.objectGUID部门ID