单据转换新字段历史数据填充工具

一、功能

用户在单据转化规则中追加了新的字段映射，由于新的字段不参与以前单据的下推，所以历史的下游单据存在该新增的字段没有值的现象。针对此场景，提供【单据转换新字段历史数据填充工具】（以下简称“单据转换新字段维护”）功能，允许用户基于最新的单据转换规则更新指定字段的空值数据。

二、适用环境说明

    仅支持私有化部署的环境（私有云、私有云订阅），公有云不支持。

    仅支持MS SQLServer，不支持Oracle数据库

三、单据转换新字段流程图

图1

四、使用步骤

（一）登录客户成功云（csc.kingdee.com），选择云运维服务，点击左上角的云巡检，在异常检查中选择【单据转换新字段维护】进入操作界面。

图2

（二）选择数据中心

进入界面后，第一步先选择数据中心，源连接需要手动配置。在新建连接时，系统会提示下载“专业服务小助手”，相关的安装流程参照安装包中的《专业服务小助手使用说明》进行操作。登录小助手和金蝶云平台账号，如下图所示：

图3

图4

安装完成后即可正常配置源连接，只有连接测试成功的数据中心能被选择。

图5

图6

成功创建的数据中心可在数据库配置信息列表中进行查询。如图7所示。

图7

（三）选择目标单据

数据中心添加完成后，第二步是选择目标单据。目标单据根据子系统分类，选择需要添加字段的目标单据。选择完成后点击加载字段，该过程需要等待几分钟。

图8

（四）选择目标字段和上游单据

最后，根据所选的单据，加载完成的所有字段会在目标字段下拉列表中展示。选择需要更新的目标字段以及上游单据，点击执行即可自动运行更新。例如：基于所选上游单据更新销售出库单的“备注”字段。如图9所示，更新完成后列表将会展示更新的单据及更新后的值。

图9

更新数据范围默认加载1000行，超出1000的数据可以通过【显示更多】按钮刷新，或者通过【显示数据存储】后台查看。

五、支持修改的字段类型

仅源字段与目标字段都属于下列类型的情况下，才支持进行更新，否则会出现选择选择字段的时候选不到该字段的情况。

六、常见问题

问题1：加载字段后，目标字段里面选不到想要更新的字段，如下图所示：

解答：可能原因如下：

1、目标单据该字段没有加入到任何一个单据转换规则中

工具对目标字段的更新，是依赖于单据转换规则来获取到数据的来源的。只有在单据转换规则中配置了目标字段与源字段的映射关系，才能被工具识别到，从而加载到列表中。

2、单据转换规则中配置了映射关系，但是不是字段到字段映射

下图为字段到字段的映射，可更新，目标字段可以加载【单据头.价税合计】

下图原字段取自定义公式，这种情况不支持，目标字段不能加载【明细.源单单据类型】

3、单据转换规则上虽然是字段到字段的映射，但是源或者目标字段类型不是第五项中支持的类型，这种情况也选不到目标字段。例如目标字段是【下拉列表】类型的，这种情况不支持。