Evilom
4.0 KiB
4.0 KiB
PUQyw4Uqui7v9rkjOr4cnZCinYg
Source: https://ocnmca6f1o0p.feishu.cn/wiki/PUQyw4Uqui7v9rkjOr4cnZCinYg
一、工作内容概述
二、实施过程
（一）接入方案梳理
将金蝶云星空作为新增取数源接入现有工具体系，与已落地的 Superset 直连、数据库直连等取数方式统一纳管，使工具使用逻辑与操作体验一致。
- 方案设想：金蝶云星空与传统 K/3 系统取数机制存在本质差异，为避免方向偏差导致无效投入，优先完成技术路线选型，最终采用官方开放接口方案，放弃数据库直连路径。
- 推进接口打通：按照 “身份认证→账套定位→数据拉取” 完成链路贯通，验证账号密码方式可实现稳定登录，无需额外授权流程；同时在架构层面预留扩展能力，支持后续快速接入其他金蝶产品实例。
（二）取数口径与字段映射
围绕科目余额表场景逐项对齐取数口径，搭建 “底层明细 + 界面报表” 双轨取数模式。
- 双轨模式设计逻辑：底层明细数据满足入库加工对原子化数据的要求，界面报表数据匹配财务复核与系统展示口径一致的需求，单一路径无法同时覆盖两类场景。
- 数据分层设计：底层明细数据按 “科目 × 期间 × 币别” 维度组织，支撑后续二次加工与灵活分析；界面报表保留借贷分列、本年累计等原生口径，可直接用于数据复核。
- 字段口径统一：科目、年度 / 期间、币种等维度字段与现有业务系统标准对齐，保障与线上看板口径一致；完成币种展示逻辑适配，支持综合本位币等多口径展示。
（三）配套资料与工具完善
针对金蝶开放平台缺少统一可取对象清单的问题，完成业务对象清单与接口说明文档的梳理沉淀，形成本地标准化资料库。
- 资料库建设：解决官方口径信息分散、查询效率低且易出错的问题，实现本地快速检索，减少重复查阅成本，同时为后续扩展其他报表类型提供基础支撑。
- 通用取数框架优化：基于沉淀成果迭代通用取数框架，新增取数源仅需完成基础配置，无需调整前端界面；对常用报表参数与字段做本地缓存，提升导出与复核效率，降低网络环境依赖；框架方案已通过交叉评审。
三、工具问题修复
（一）界面口径核对取数
将接口取数结果与金蝶云星空前端界面数据进行交叉核对，发现导出金额与界面展示存在显著差异；经定位，差异根源为底层明细数据与前端报表的加工逻辑不一致，前端界面包含借贷分列、本年累计等额外计算处理。
（二）口径统一处理
明确两套数据口径的适用场景后，针对性校准接口取数逻辑；经多轮与前端界面的比对调优，最终取数结果与系统界面完全一致，完成数据准确性验证，保障数据可信度。
（三）问题与细节修正
推进过程中针对多类问题逐项定位并闭环解决：
- 取数对象定位偏差：同类型报表在系统中存在多个相似名称与访问入口，初期出现数据拉取不稳定的问题；通过逐一比对官方接口文档，确认正确的接口入口，同时明确两类取数方式的适用场景。
- 登录态稳定性问题：登录凭证易失效，需频繁重登导致作业中断；优化为会话复用机制，登录成功后保持会话连续性，减少重复登录的时间损耗。
- 资料查询与访问限制问题：系统无统一业务对象清单，信息检索成本高；批量梳理资料时因访问频次过高触发临时限流。前者通过搭建本地资料库彻底解决，后者通过调整请求频率、增加断点续传能力处理，最终完成全量资料落地。