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）企业微信获取字段说明

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