作者：张岳鹏
推荐理由
使用场景分享--集成平台+飞书通讯录+多维表格，将公司整体通讯录信息实时更新到多维表格中，供业务侧或集成平台其他工作流使用。
一、关于我们
大家好，我们是一家能源行业的下级 IT 服务单位，我们依赖飞书高效智能协同办公，赋能数字化转型。我是一名前端工程师，目前主担任飞书 Office 场景落地顾问角色和集成平台管理员角色。
二、需求分析
【业务痛点】
- 开发平台没有单独获取公司全员通讯录信息的接口；
- 集成平台中只有单独获取部门和部门通讯录的案例；
- 原来折中方式通过用户纬度活跃率统计获取人员信息，由于该接口只能获取前一天的数据，数据滞后。
于此，我们需要一个利用飞书集成平台，每日定时公司全体员工花名册同步到多维表格，供人力维护人员台账信息，业务部门及时获取员工通讯方式或是集成平台工作流配置中使用的一套工作流。
三、方案调研
通过调研飞书开放能力/集成平台等飞书产品能力,我们发现飞书开放平台尚未提供统一的 API 接口文档获取通讯录信息，但是有提供获取子部门列表 - 服务端 API - 开发文档 - 飞书开放平台——可以获取到指定结构性所有部门信息和获取部门直属用户列表 - 服务端 API - 开发文档 - 飞书开放平台——获取部门直属员工通许录列表。我们可以领用这两个接口，首先获取到所有子部门信息，然后根据子部门获取该部门下的所有人员通许录信息，一次维护到多维表中。
四、开发流程
💡此流程可以拆分出主子流程，可以灵活控制，由于时间关系没来得及优化，6K 数据执行 22分钟，还有很大优化空间，需要的小伙伴可以自行拆解。
250px|700px|reset
【附件：多维表和工作流】
【实现方式】
每日定时先获取到公司层级在4级以内（一般公司这个层级够用）部门信息并更新到多维表中，再通过部门信息拉取到员工通讯录，同样更新到多维表中。
【操作步骤】
1.配置用户凭证
权限要求⬇️
250px|700px|reset
申请权限⬇️
2.配置多维表和数据表
部门信息⬇️
员工信息⬇️
250px|700px|reset
3.清空历史数据
4.获取到公司4级以内全体部门信息，更新到多维表
250px|700px|reset
5.获取部门通讯录并写入到多维表
获取部门下直属员工⬇️
五、更多相关开发心得
一个人甚至一个团队的思路眼界都是有限的，闭门造车不如出门问道，我平时学习集成平台开发技巧主要有以下几个方面：
- 熟悉集成平台中每个小组件的功能和特点；
- 熟悉飞书开放平台 API；
- 遇到难点问题及时向飞书技术支持服务台咨询；
