小编推荐

许多大型企业往往拥有较为全面的财务系统，但各系统之间往往关联性不高，数据共享成难题。尤其是面对报表推送第三方系统的迫切需求，因多维数据库对接复杂，投入的成本较高。

本期案例针对上述痛点，详细阐述了通过苍穹OpenAPI调用多维数据库，实现数据有序输出的两种高效策略：报表模板与维度组合取数。助力实施人员快速对接，降低沟通成本，有效支撑集团信息化建设，实现数据价值最大化。

撰稿人：金蝶-罗艺轩

一、业务背景

（一）客户及业务介绍

ST集团，是一家深圳市人民政府国有资产监督管理委员会直管的国有独资大型企业。财务信息系统方面，目前已建设财务共享系统、Oracle EBS核算系统，海波龙预算系统，资金系统，财务机器人系统等。但各系统之间关联度较差，导致信息很难进行共享，当合并报表平台涉及数据推送需求时，因其底层架构与部分第三方系统不一，会存在传输数据困难的问题。

（二）客户痛点及诉求

2023年，星瀚合并报表系统上线后，ST集团客户希望将报表数据推送到第三方系统。由于星瀚采用多维数据库，与传统的二维表对接方式不同，对接过程中双方需要较高的多维数据库理解和经验，增加了沟通和赋能成本。例如，对接ST集团投资平台时，常因对方多维对接经验不足导致取数问题，需多次会议沟通解决。

ST集团要求星瀚合并报表平台将法定报表大合并抵销数据推送至其预算系统进行预算分析，另外需将总资产、净资产、营业收入、利润总额、净利润、资产负债率、净利润率、净资产收益率八大指标数据推送至投资平台以供其投资决策使用。

二、解决方案

（一）整体思路

结合ST集团实际，发现可以利用苍穹OpenAPI调用多维数据库来实现。苍穹OpenAPI适用于第三方系统与金蝶云苍穹的系统集成的场景，当第三方系统调用金蝶云苍穹OpenAPI时，金蝶云苍穹会对每个API进行身份鉴权，判断其请求合法性，最后响应API请求。合并报表平台亦是如此，外部系统可通过OpenAPI调用多维数据库。多维库数据在推送异构系统时，有以下两种方式实现，可通过客户实际需求判断哪种方式更为简易合理，进而满足客户第三方系统数据对接的要求：

方式一：通过报表模板获取多维数据；

方式二：通过维度组合获取多维数据。

图1 多维库推送异构系统集成蓝图

对于ST集团预算系统查看抵销数据的诉求，合并报表系统选择通过搭建报表模板（过程维EJE）将数据以表的形式进行推送，同步给预算专用账号分配数据查看权限，然后再通过OpenAPI调用这张模板实现数据推送。

图2 内部交易抵销数据报表展示

对接第三方投资平台时，鉴于其仅需八项指标，且这些指标在多维库中已有现成的维度组合，若沿用报表模板推送，过程略显繁琐。因此，我们采取捷径，直接利用这些维度组合推送数据，既高效又直接。具体做法是，先整理出所需指标的维度组合清单，再附上多维数据字典，让第三方开发小伙伴轻松调用。这种方式，即便是面对非多维架构的数据库高手，也能轻松上手，减少理解障碍。

图3 八大指标的维度组合

（二）系统配置

异构系统在调用合并报表多维数据库时，需先获取到访问环境的access_token。以下是需金蝶方完成的相关系统配置，并需将相关信息告知第三方系统：

1、注册第三方应用；

2、查询数据中心id：accountId；

3、授权第三方系统代理用户人员账号。

（三）关键步骤及呈现效果

完成基础配置工作后可借助API测试工具，对API功能进行完整测试，再同调用方进行系统集成对接。

1、第一步：获取访问环境app_token

 图4 获取访问环境令牌

 
注意：令牌有有效期，每次两小时。快过期时，用户得重新申请或刷新令牌，保持它有效。

2、第二步：登录系统，获取access_token

 图5 获取access_token

3、第三步：接口调用多维数据库

（1）调用苍穹OpenAPI获取报表模板数据

图6 获取报表模板数据

注意：

• 此处要取的报表数据需要将模板编码设置在“tmplList”中，未设置维度，会根据模板设置取。币别如果为空默认为“EC”，过程如果为空会默认过程为“ERPT”；

• 除预置的维度外，其他维度均需放到“scope”中。且不支持维度范围，当某个维度存在多个维度成员时只可通过一一列举实现数据推送。
  
  

（2）调用苍穹OpenAPI获取多维组合数据

图7 获取多维组合数据

注意：

• 体系编码modelNum，即CUBE，必填项；

• 固定维度组合fixDim：财年、期间、情景，每个维度只允许传入一个值，且固定维不支持范围；

• 可选维度组合filters支持范围查询，并且同一维度可设置多个过滤条件，取并集。如果设置了filter但最终未找到任何满足的成员，则报传入参数错误。其中scope范围，可选项，不设置即自身过滤；

• 该方式下需给第三方应用进行“olap/queryOlapDatas 多维数据查询服务”API授权，否则调用接口时无法成功获取数据，返回信息为“该第三方应用-xxxx没有此接口访问权限”。

三、方案的可推广价值

（一）行业的普适程度

星瀚合并报表项目中涉及多维数据库对接第三方系统做数据推送。均可参考该案例做推数对接。

（二）对客户的价值

1、可以提高对接效率和经济效益。本案例能在在缺乏开发资源的前提下，指导实施人员独立完成多维数据库对接第三方系统的需求，降低对接成本，提高经济效益。

2、数据对接灵活、全面。本案例提供两种对接方式可供采取，即调用报表模板和调用多维组合数据。