组织人员同步(星空旗舰-飞书)操作手册2025年2月13日12文档修改记录版本日期编制/修订审核批准修改原因V1.02024-11-18郭玲郭玲郭玲初稿3目录1.概述....................................................................................................................................51.1版本说明.....................................................................................................................51.2使用场景.....................................................................................................................51.3同步逻辑.....................................................................................................................52.准备工作............................................................................................................................52.1飞书环境准备.............................................................................................................52.1.1登录飞书管理后台.............................................................................................52.1.2创建应用.............................................................................................................62.1.3获取应用信息.....................................................................................................72.1.4开通服务端API权限并发布.............................................................................82.2方案订阅和获取.......................................................................................................112.3飞书连接配置...........................................................................................................122.4配置数据源...............................................................................................................143.方案详解..........................................................................................................................153.1行政组织...................................................................................................................153.1.1行政组织初始化...............................................................................................153.1.2行政组织增量同步...........................................................................................163.1.3指定组织ID同步..............................................................................................173.1.4日志分析...........................................................................................................173.2人员...........................................................................................................................183.2.1人员初始化.......................................................................................................193.2.2人员增量同步...................................................................................................213.2.3指定人员ID同步..............................................................................................223.2.4人员即时同步...................................................................................................223.2.5日志分析...........................................................................................................224.参考资料..........................................................................................................................22451.概述1.1版本说明该集成解决方案包是基于以下版本制作输出，其他版本不确定是否完全适用，存在可能微调的可能性。该方案已做过DEMO验证，客户现场需要根据实际情况进行必要的调整，并且无论是否调整都必须经过客户现场验证可行后才可使用。星空旗舰版：R202411.001飞书版本：2024年11月的飞书网页端1.2使用场景将星空旗舰的行政组织和人员同步至飞书，支持初始化和增量同步。1.3同步逻辑输入源系统行政组织根组织id，将行政组织根组织下的组织挂在飞书根组织下面，eg：如果输入100000，则只同步源系统行政组织根组织id为100000的下级组织。组织和人员飞书的id和旗舰的id保持一致，根据源系统id来查询飞书是否存在对应的组织人员，并做新增或者修改的逻辑处理。目前提供的组织集成方案只选择核心字段，特殊需要的字段现场根据情况再加。2.准备工作2.1飞书环境准备飞书开放平台：6https://open.feishu.cn/document/server-docs/application-scope/introduction2.1.1登录飞书管理后台https://hcnrvyv5vtsi.feishu.cn/admin/contacts/departmentanduser/people-standard-plugin/people-manage/roster2.1.2创建应用企业概览->应用管理->创建应用72.1.3获取应用信息企业概览->应用管理->创建应用->基础信息82.1.4开通服务端API权限并发布批量授权API权限创建部门开发文档https://open.feishu.cn/document/server-docs/contact-v3/department/create?9appId=cli_a7bc40ea42b3900b如何为应用申请所需权限https://open.feishu.cn/document/faq/trouble-shooting/how-to-fix-the-99991672-error分别开通“创建部门、修改部门部分信息、获取单个部门信息、搜索部门”的API权限也可以通过错误提示，搜索权限名称后开通。在应用的开发配置>权限管理页面，找到权限配置区域，选择权限并点击批量开通。批量授权数据权限10根据现场实际情况选择配置创建版本并发布112.2方案订阅和获取公有云：参考以下操作指南云订阅获取https://vip.kingdee.com/link/s/MizID-待上架后补充私有云：请找集成服务云团队获取注意：连接类型一定要覆盖更新，122.3飞书连接配置集成管理->连接管理->连接配置，分别新增连接类型为“飞书”和“当前账套”的连接配置13142.4配置数据源集成管理->连接管理->数据源管理配置前配置后153.方案详解3.1行政组织3.1.1行政组织初始化特别说明：飞书组织不允许删除，建议在测试环境找一棵子树做验证，验证通过后再批量同步服务流程编码和名称：KDflow_OrgInit(XKQJ-FEISHU)预置flow_行政组织初始化（星空旗舰-飞书）默认同步根组织id为100000下的组织数据，可以修改16注：组织id可以在查询分析器查询获取（管理员登录->安全管->查询分析器select*fromt_org_org）3.1.2行政组织增量同步服务流程编码和名称：KDflow_OrgAdd(XKQJ-FEISHU)预置flow_行政组织定时增量（星空旗舰-飞书）定时同步修改时间16分钟内的数据，定时间隔15分钟，现场可以根据实际需17要修改3.1.3指定组织ID同步服务流程编码和名称：KDflow_Create_ORG_ID(XKQJ-FEISHU)预置flow_根据星空旗舰组织ID同步(星空旗舰-飞书)183.1.4日志分析WebAPI日志（集成管理->API集成->WebAPI登记，选中WebAPI点击日志）KD_modifyOrg_feishu根据部门id更新飞书部门信息KD_getDeptInfo_feishu根据部门id获取飞书部门信息KD_departments_feishu创建飞书部门创建飞书部门时需要先查询，查询不到才会新增，所以下面失败的日志可以忽略notavalid{department_id}ornotexists,Invalidids:[2086434938873216000]服务流程实例日志（集成管理->服务编排->服务流程，选中服务流程点击流程实例）KDflow_OrgAdd(XKQJ-FEISHU)预置flow_行政组织定时增量（星空旗舰-飞书）KDflow_Create_ORG_ID(XKQJ-FEISHU)预置flow_根据星空旗舰组织ID同步(星空旗舰-飞书)KDflow_OrgInit(XKQJ-FEISHU)预置flow_行政组织初始化（星空旗舰-飞书）193.2人员同步人员的过程会将人员的部门负责人信息，同步至部门的负责人字段（当一个部门有多个负责人时，只同步一个负责人，以后面更新的人员为准），入下图：3.2.1人员初始化服务流程编码和名称：KDflow_UserInit(XKQJ-FEISHU)预置flow_人员初始化（星空旗舰-飞书）默认同步根组织100000下面的所有人员，想要同步哪个组织下面的人员输入组织id即可20注：1)飞书不允许更新未加入状态的用户信息。错误码：440102）源有多个直接上级和职位时只取第一行213）未分配部门下的人员，同步至飞书的根组织下面3.2.2人员增量同步服务流程编码和名称：KDflow_UserAdd(XKQJ-FEISHU)预置flow_人员定时增量（星空旗舰-飞书）定时同步修改时间16分钟内的数据，定时间隔15分钟，现场可以根据实际需要修改223.2.3指定人员ID同步服务流程编码和名称：注：人员id可以在查询分析器查询获取（管理员登录->安全管->查询分析器select*fromT_SEC_USER）233.2.4人员即时同步监听人员的保存、启用和禁用操作，实时同步服务流程编码和名称：KDflow_UserJS(XKQJ-FEISHU)预置flow_人员即时同步（星空旗舰-飞书）3.2.5日志分析类似组织，参考3.1.4章节4.参考资料金蝶云•苍穹集成服务云使用指南https://developer.kingdee.com/article/4531224
