1 导入接口配置文件说明
文档修订记录
版本编号或者更改记录编号 变化状态 简要说明(变更内容和变更范围) 日期 变更人 批注日期 批准人 V1.0 C 新建 2016-04-05
*变化状态：C-创建,A-新增,M-修改,D-删除
2016 年 4 月
2 目录
1 前言 .............................................................................................................................................. 3 1.1 目的 .................................................................................................................................... 3 1.2 适用范围 ............................................................................................................................ 3 1.3 读者对象 ............................................................................................................................ 3 1.4 术语与缩略语 .................................................................................................................... 3 1.5 参考/引用文档 ................................................................................................................... 3 2 功能特性 ....................................................................................................................................... 3 2.1 概述 .................................................................................................................................... 3 2.2 使用场景 ............................................................................................................................ 3 3 接口文件各节点说明 ................................................................................................................... 4 4 导入接口配置模板 ........................................................................................................................ 7
3 1 前言 1.1 目的 指导开发人员快速实现导入接口的开发。
1.2 适用范围 本文档适合于 V4.5 资产管理系统的开发。
1.3 读者对象 开发人员 1.4 术语与缩略语
无 1.5 参考/ 引用文档 无 2 功能特性 2.1 概述 通过配置数据导入接口文件，实现不同类型、不同格式的数据文件的导入功能，目前能够支持 XLS、DBF、TXT、INC、CSV 等类型文件导入功能。
2.2 使用场景 当需要将外部数据文件的数据导入到系统里时需配置相应的接口文件。
4 3 接口文件各节点说明 可参照图 3-1 对各节点进行理解：
（1 ）
importConfig
配置文件的根节点
（2 ）
cfgCode 配置编码，唯一。用于标识接口的唯一代码，一般以 INFI 开头。例如：
上交所过户库<cfgCode>INFI_JY_GH_SH</cfgCode> （ （3 ）
cfgName 配置的名称。
例如：<cfgName>上交所过户库</cfgName> （ （4 ）
cfgType 配置类别可取值为词汇表中的接口类型的值。可取值有：TRADE（投
资交易数据）、Corp_Action（公司行为信息）、PUB_MP（公共行情信
息）、TRADE_TA （TA 交易数据）、OTHER（其他）。
此标签是根据导入数据的类型来选择相应的值，比如上交所过户库数据
属于投资交易类数据，则应填<cfgType>TRADE</cfgType> （ （5 ）
fileType 需导入的数据文件的类型，如：TXT、DBF、XLS、CSV、INC；
如：<fileType>DBF</fileType> （ （6 ）
inOrOut 已废弃 （ （7 ）
characterSet 字符集，如：GBK、UNICODE、UTF-8。用于指定导入文件的编
码格式。如：<characterSet>GBK</characterSet> （ （8）
）
specialParam 专用参数（可不填）。
用于标识该接口属于哪个投资组合专有的，
取值则为某个投资组合代码。
（ （9 ）
fileNameList 文件名集合。
可配置多个 fileName 节点。
（ （10 ）
fileName 待导入数据文件的名字（必填），可支持参数[yyyyMMdd]，代表日期；
*代表任意字符。如：<fileName>*holddata[YYYYMMDD]</fileName> （ （11 ）
tableList 配置表的集合。
可配置多个 table 节点。
（ （12 ）
table 数据导入的表节点 cvtMode 转换类型，默认为“”，可取值“IMP_ROW_TO_COL”，表示导入数据时 进行行列交换，如下图：
5
srcName 源表名称，针对数据文件是 Excel,MDB 有效。
如果接口文件中配置多个表，则每
个表的 srcName 值对应 Excel 中相应的 sheet 名，如：srcName=“T_D_OD_GH” splitChar 分割字符。
一般用于数据文件是 txt 格式的。由于文本文件不像 excel 那样每列
可以代表一个字段的值，则需要用特殊的标记，如“|”“@”等将数据分隔开，以
便解析。例如：splitChar="|"； splitType 分割类型，可取值：“UNFIX”（非固定长度）、“FIX”（固定长度）
FIX 一般用于 txt 格式文件，UNFIX 一般用于其他格式的文件 tableName 导入原始表名。
用于标明数据应该导入数据库中的哪张表中。
例如：tableName="T_D_OD_ETF_MAIN" tabDefine 表定义的 SQL 语句。
节点内容为表的创建语句，部署接口后找到接口点击执
行可在数据库中创建对应的表。
addDefField 确定表中是否添加默认字段的标识，可取值：“TRUE”或“FALSE”，可不填，
默认为 TRUE（目前仅 5.0 版本支持此属性）。
系统中原始数据表在建表过程中会自动添加 7 个默认字段供导入数据使用，但
有些特殊的表不需要这几个默认字段，则需要这个属性来区分。
（ （13 ）startMark
开始标记节点
type 属性，开始标记的类型，可取值为“Mark”、“RowNum”
Mark 一般用于 txt 格式的数据文件，确定以行号还是以字符标记开始读数据
RowNum 一般用于其他类型文件，表示以行号读数据
startRow 开始导入数据的位置。
标识从文件哪一行开始读数据。一般有列头的从
第二行开始，没有列头的从第一行开始。如：<startRow>2</startRow>
markValue 开始导入数据的标记字符串。
当 type 属性为 Mark 时，则以该节点的
值作为导入数据的开始。当 type 属性为 RowNum 时不需要该节点。
6 如：<markValue>[ETF50]</markValue> （ （14 ）endMark 结束标记。
当配置 startMark 的 type 属性值为 Mark 时需要该节点，标
识读取数据的结束位置。如：<endMark>TAGTAG</endMark> （ （15 ）delField 原始表数据的删除条件。
取值为一个或几个字段名，也可为空，系统在导
入数据时为了防止重复，会根据这几个字段唯一确定表中是否存在与导入数
据相同的数据，如果存在则删除表中的相同的数据重新插入。
例如上交所过户库的<delField>GDDM,BCRQ,GSDM</delField> （ （16 ）field
字段节点，可配置多个。
dict 对应词汇表的值（可不填）。用转换的数据替换原始数据。
fieldCond 筛选条件，符合条件的数据执行导入（可不填）。
当对某个字段的数据有限
制时，可以配置。
比如：fieldCond=“between 1 and 1000”； nullValue
null 的代替值（可不填）。
当数据文件中某字段没有值时，可将该值作为
默认值插入到数据库表中。如：nullValue="1"； fieldName 数据库字段名（必填）。
该属性应与 sourceField 一一对应。取值为数据库
表的某个字段名，用来将数据文件中某列的值与数据库中的某个字段值对应
起来。
sourceField 源数据文件列名（必填）。
该属性应与 fieldName 一一对应。对于 dbf 格
式的数据文件，值应配为每一列的列名，sourceField="NAME(GDDM)"；对
于 XLS、CVS、TXT 文件，值应配置为对应的列号，如 sourceField="INDEX(1)"
对于要使用序列的应配置为 sourceField="SEQU" typePre
字段类型（必填）。
用来标识数据库中字段的类型，数值为 NUM(M,N)；字
符为 STR(M)；日期为 DATE。
例如：<field sourceField="NAME(GDDM)" typePre="STR(10)" fieldName="GDDM"/>
7
图 3-1
4 导入接口配置模板
示例1.xml 示例2.xml（双击可打开）