需依托智能人事模块统一维护员工花名册，包括启用配置权限、添加/导入信息、更新字段、查询导出元数据、联动其他系统五步操作。
如果您作为钉钉管理员需对组织内员工花名册进行统一维护与管理，则需依托智能人事模块完成人员信息的录入、查询、更新及结构化配置。以下是具体操作路径：
一、启用智能人事并配置基础权限
该步骤确保管理员具备访问与操作花名册数据的系统能力，包括字段定义、分组设置及接口调用权限。
1、登录钉钉管理后台，进入【工作台】→【应用管理】→【智能人事】，点击「开通」按钮启用服务。
2、在智能人事设置页中，点击【权限管理】，为当前管理员账号分配「花名册管理」「员工信息编辑」「字段配置」三项核心权限。
3、确认企业已开通钉钉专业版，因花名册元数据获取、连接器调用等功能依赖专业版权限支持。
二、添加或导入员工花名册信息
支持手动新增与批量导入两种方式，适用于新员工入职、组织架构调整等场景，确保花名册数据实时准确。
1、在智能人事首页点击【员工管理】→【花名册】→【新增员工】，填写基本信息、工作信息、合同信息等必填字段。
2、点击【批量导入】，下载标准Excel模板，按字段映射要求填写后上传，系统自动校验格式并提示错误行。
3、对于待入职员工，进入【待入职管理】页面，填写姓名、手机号、预计入职日期等信息，状态将自动同步至花名册。
三、更新员工花名册字段内容
当员工发生岗位变动、联系方式变更、学历更新等情况时，需通过更新接口或管理界面实时修正花名册字段值。
1、在花名册列表中搜索目标员工，点击右侧【编辑】按钮，修改「工作信息」或「个人信息」等分组下的对应字段。
2、若需批量更新，使用「更新员工花名册信息」服务端API，POST请求至https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/update，传入param参数对象及agentid。
3、关键字段如手机号、身份证号、银行卡号等受敏感数据保护机制约束，修改时需二次身份验证，必须由具备HR权限的子管理员执行。
四、查询与导出花名册元数据及字段定义
了解花名册结构是进行数据对接、表单填充、系统集成的前提，元数据包含分组、字段类型、可见范围等配置信息。
1、进入【智能人事】→【系统设置】→【花名册字段管理】，查看当前启用的字段列表及其所属分组（如“基本信息”“合同信息”）。
2、调用「获取花名册元数据」接口，传入access_token和agentid，返回GroupMetaInfo[]结构，含字段ID、名称、是否必填、权限标识等。
3、导出全部字段定义为Excel：点击字段管理页右上角【导出】按钮，导出文件包含字段编码（fieldCode），用于OA表单映射与ISV开发对接。
五、通过连接平台实现花名册数据联动
利用钉钉连接平台可将花名册信息自动同步至OA审批、考勤、培训等其他业务系统，避免重复录入与数据不一致。
1、登录钉钉开发者后台，进入【开放能力】→【连接平台】→【连接流市场】，搜索并安装「获取智能人事花名册指定字段信息」连接流。
2、在OA审批表单设计中，选择该连接器作为数据源，在「数据映射」区域将表单控件绑定至花名册字段，例如将「手机号」控件绑定至mobile字段。
3、发起审批时，系统自动根据当前登录人userid查询智能人事花名册，仅返回该用户有权限查看的字段值，敏感字段默认不返回。
