金蝶云星空集成平台操作指南V7.X

V7.X最新补丁环境，金蝶云可以支持基础资料集成，并且针对WISE12.2的部分基础资料做了预设方案，可以参考使用。

V7.X主要功能说明：

1、【映射关系设置】
【映射关系设置】是进行【基础资料同步】、【业务单据同步】、【基础资料映射】的前提，同时影响到【映射关系查询】能够查看的字段
2、【基础资料映射】
建立第三方系统基础资料到金蝶云星空基础资料的对应关系，一个第三方系统的基础资料只能找到一个金蝶云基础资料与之对应。完成基础资料映射的前提是金蝶云星空已经存在与对应的基础资料。完成【基础资料映射】有以下两种方式：
方式一：手动录入的金蝶云星空基础资料（通常适用于基础资料数量很少且在金蝶云星空中为共享控制策略如币别），通过建立基础资料映射完成映射。对于不能自动匹配的记录，可以【映射关系查询】里可以手动维护基础资料的映射关系
方式二：通过基础资料同步导入的金蝶云星空基础资料，系统自动完成映射
3、【基础资料同步】和【业务单据同步】
通过执行同步方案将第三方系统的基础资料数据或业务单据数据导入到金蝶云星空中，若基础资料或者业务单据有引用其他基础资料，则要求被引用的基础资料先做好映射，系统同步的过程中会根据映射表将被引用的其他基础资料“翻译”为金蝶云星空中的基础资料。

系统预设常用的【WISE基础资料同步】、【WISE业务单据同步】、【WISE基础资料映射】、【WISE映射关系设置】方案，迁移的时候复制新增，维护源系统连接和组织字段即可。


操作指南（以WISE V12.2为范例进行描述）

第一步：集成准备

（一）WISE准备工作

1、【核算项目】：确定哪些核算项目是需要迁移的

2、【备份数据】：务必每个账套都做好备份、存放到指定存储路径；最好在备份数据的名称上做明显区分，以避免后续选择错误

3、梳理基础资料

1）系统预设的核算项目，迁移到金蝶云星空对应的基础资料。如果目标是控制策略为分配或者共享的基础资料，要求所有WISE账套中相同的资料，只迁移一个到金蝶云星空中（迁移之后共享类型资料所有组织都能使用，分配类型资料经分配之后其他组织亦能使用）。这就要求进行整理：以一个主要账套的基础资料为基准，将全部基础资料进行合并梳理，以避免出现重复内容。如果目标是控制策略私有的基础资料，则每个WISE账套使用各自的基础资料，可以不进行梳理
2）对于多个账套使用同一基础资料值的，可以用基准账套的编码替换WISE中其他账套对应的基础资料编码（使用SQL语句处理）。

同步为共享或者分配类型的基础资料，整理阶段是一个不小的工作量，如无特殊需求，建议同步为私有的基础资料。


（二）金蝶云星空准备工作

1、【安装部署】：安装好金蝶云产品，并做好相关部署工作，尽量不要让金蝶云星空与WISE安装在同一台应用服务器
2、【组织架构】：新建金蝶云星空数据中心，根据客户需求创建组织架构。只有管理员用户才能使用迁移相关的功能
3、确定【基础资料控制策略】：
1）启用多组织的，需要维护组织机构资料；再维护基础资料控制策略，确定基础资料的创建组织和使用组织
2）确定基础资料分配方案

4、集成平台方案引入

方式1：Excel将预设方案导出，维护好必录字段（比如源系统连接等）后，再导入【WISE业务单据同步】方案——导入【WISE映射关系设置】——导入【WISE基础资料同步】，此时【WISE基础资料映射】也会随着【WISE业务单据同步】一起导入到账套中
方式2：采用下面的描述，逐个手工维护建立。

第二步：源系统数据连接设置

设置界面如下：

注意：1）目前只支持SQL数据库，选择WISE账套对应的实体，不同源通过名称和编码加以区别。

2）一个源系统账套对应一个数据连接方案

第三步：WISE映射关系设置

正确设置【WISE映射关系设置】是进行同步、映射等操作的前提。以基础资料科目为例介绍映射关系设置过程：

1、设置基本信息

1）选择“源系统连接方案”，以确定源系统表的来源

2）【源数据类型】和【源系统资料】

确定源数据类型，有3个内容（表/视图/自定义SQL），按需选择使用

3）【源主键】和【源唯一标识】是唯一标识一个WISE资料的字段（若一个字段不能保证唯一，可以新增行，使得字段组合唯一）

【金蝶云唯一标识】为唯一标识一个金蝶云星空基础资料的字段或字段组合。它是判断同步到金蝶云星空的数据是否重复的标识

【源查看字段】和【金蝶云星空查看字段】为查看映射关系结果时，作为补充显示的字段

4)一个源数据连接，同一对象只能设置一个【WISE映射关系设置】方案

科目基本信息设置如下：

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image002.jpg

2、实体关键信息设置

在实体关键信息设置页签，金蝶云系统资料相关的其他实体信息会自动带出，如果该实体也需要进行同步，则需要进行相应的设置

例如科目基础资料同步的时候，除了同步基本信息之外，还需要同步核算维度数据，外币核算数据。核算维度数据和外币核算数据是通过FAccountID识别为同一个科目的信息，因此，【对应源父表字段】均设置为FAccountID。另外，存在同一个科目下挂多个核算维度的情况，因此，需要添加FItemClassID来标识不同的核算项目。

核算维度单据体：

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image004.jpg

外币核算单据体：

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image006.jpg

第四步：WISE基础资料映射及同步

1、WISE基础资料映射

以基础资料【币别】为例介绍WISE基础资料映射

场景：客户某WISE账套使用了币别为人民币（精度2位）、港币（精度4位）、美元（精度4位）、英磅（精度4位），对币别资料做映射关系。金蝶云星空系统预设币别已经包含了这四种币别，因此金蝶云星空不需要新增币别资料。但是，金蝶云星空预设的币别精度为2，需要先修改为与WISE币别精度一致（多个账套迁移时取所有账套币别最高精度）

1）进行【WISE映射关系设置】，启用该方案

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image002.jpg

2）设置【WISE基础资料映射】方案，这里选择按照名称进行匹配。注意如果不是共享的基础资料，则需要维护对应的金蝶云星空使用组织字段

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image004.jpg

执行【WISE基础资料映射】方案时，系统通过匹配规则将WISE和金蝶云的币别数据匹配起来。点【执行】后可以看到执行结果。如下图所示，成功3条，失败1条。

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image006.jpg

3）通过【映射结果查询】查看结果

file:///C:\Users\ADMINI~1\AppData\Local\Temp\msohtmlclip1\01\clip_image008.jpg

3条已经成功映射的数据，英磅数据没有成功匹配，因为名称与金蝶云中的英镑不一致，需要手动匹配，F8选择、返回数据后保存即可。至此，WISE币别映射完成

2、WISE基础资料同步

请参考：
https://vip.kingdee.com/article/8598

第五步：WISE业务单据同步

【WISE业务单据同步】的过程与基础资料同步类似，区别是业务单据往往有多个页签，每个页签的字段也比较多，而且单据可能会引用其他资料（被即将同步的单据引用的资料必须先完成映射才能进行该单据的同步）

第六步：基础资料同步查询与业务单据同步查询

1、通过【基础资料同步查询】与【业务单据同步】可以查看同步过程中出现的错误信息

例如在做基础资料和业务单据同步的时候，出现下面的提示：

可以在【基础资料同步查询】获得具体的错误列表：

选择最新记录点进去查看错误明细：

此处因为全部员工都已经同步过了，所以不需要再同步。

2、其他情况，同步查询没有明显的提示，可以通过日志查询获得检查思路。如下面报错：

查看【业务单据同步】没有明显的提示：

这种情况下，可以通过下面路径找到集成平台当天的日志：C:\Program Files(x86)\Kingdee\K3Cloud\WebSite\App_Data\Log一些与数据库有关的报错，会写入到该文件中。