1 简介

1.1 功能介绍

集成服务云提供了离线系统间的数据迁移工具，支持将通过集成对象获取源系统的数据导出到文件中转站（可以是本地文件夹、FTP服务器或文件服务器），或从文件中转站中导入数据并通过集成对象加载到目标系统，从而实现离线数据源之间稳定高效的数据同步。

功能列表：新增/复制、修改、删除、任务列表/创建任务、导出/导入

1.2 应用场景

数据导入的第一步即设计数据导入方案，选择导入对象和导出字段从而将本地excel文件或json文件的数据导入目标系统的集成对象当中。

1.3 系统路径

【集成管理】→【数据迁移】→【数据导入】→【导入方案】

1.4 字段/按钮说明

字段说明：

按钮说明：

2 主要操作

2.1 数据导入方案管理

导入方案列表：包含数据导入方案的新增/复制、修改、删除、查看任务列表/创建任务、导出/导入/导出zip包等对数据导入方案的管理功能。

2.2 新增数据导入方案

步骤1：填写基本信息

步骤2：选择导入字段

根据所选导入对象进行新增或批量新增导入字段，用于将上传的文件加载到集成对象中。

图3. 数据导入方案的导入字段

• 字段名：导入对象字段的名称，用于加载具体字段的值。

注意事项 1：目前分录支持Excel、CSV格式导入，可以导入一、二级分录字段，例如：

一级分录：entryentity.seq、entryentity.id

二级分录：entryentity.subentryentity.id、entryentity.subentryentity.seq

注意事项 2：多语言字段请使用【字段名.语言类型】作为字段名导入，即每个多语言文本字段需要选到zh_CN层级，如name.zh_CN、creator.name.zh_CN等取简体中文的名称字段值。

注意事项 3：导入字段中需要选择具有唯一性且不可修改的字段作为候选键，可以将多个字段组合作为候选键。（若导入分录字段，则需要同时为分录字段选择候选键）。

• 别名：别名为导入文件数据时的取值字段，不填时默认为字段名。

• 数据类型和字段描述根据所选集成对象字段自动带出。

步骤3：选择操作

数据加载到导入对象时的操作，根据导入对象的操作下拉列表进行选择，不填时默认为保存。

2.3 复制数据导入方案

支持选择已有的数据导入方案进行复制，除编码外，其余属性与被复制的方案一致，适用于同一集成对象已存在导入方案，需要修改操作等数据导入场景。

2.4 脚本支持批量接口

步骤1：数据导入任务中设置目标单批量大小大于1，并关闭“保存全部日志”。

注：以下场景不支持批量处理：

1、层级结构数据；

2、数据集成方案设置了动态代理用户；

3、需要调用多个操作；

4、目标系统不支持批量接口。

步骤2：在数据迁移->导入方案->导入数据处理脚本中编写脚本如下(该脚本仅为示例，请根据实际业务情况配置)

注：脚本中执行批量后可能会出现业务异常，所以编写脚本时需要根据批量操作返回值来判断是否需要抛出异常，不然出现异常后看不到异常日志。

var data = _tars;
//使用_tars构造接口调用的入参
var judgeFields = {  "$":["number"]};

//$batch_action 批量保存接口
var result = $batch_action("isc_demo_basedata_1",data,"id",judgeFields,"save");

for(var i = 0;i < _tars.length;i++){    
//在返回的数据中遍历，将返回的id和type依次赋值给_tars中的每条数据    
//因为返回的数据顺序和传入数据顺序相匹配，此处可以按每条数据的位置进行赋值   
_tars[i].id = result[i].id;   
_tars[i].type = (result[i].type == null?"UNKNOWN":result[i].type);
}

变量说明：

• _tars:为集成方案每批目标数据构成的列表，用户可根据接口调用的返回结果自行构造_tars中的如下两个属性：[{id : 单据ID, type : 处理类型},…]，其中“处理类型”取值为INSERT, UPDATE, DELETE,NOP。
  注：若_tars中不存在id值，则赋值""，若不存在type值，则赋值UNKNOWN

• _tars.type:集成云脚本支持批量给list赋值，如希望将处理类型批量赋值为‘插入’，可写作：_tars.type = ‘INSERT’。
  注：此处仅为示例写作INSERT，用户应根据现场实际情况配置