Siebel数据导入工具--V1.6--用户手册

1、eSiebel数据导入工具用户手册汉得信息技术股份有限公司黄安邦版本号：V1.6版序 言Siebel数据导入工具软件是基于Microsoft .NET Framework开发的一个Siebel的外挂工具,使用siebel提供的标准API，针对Siebel本身的Business Component进行操作,用户只需在首次使用时进行简单的配置,即可进行数据导入。该工具最初的使用时在青啤项目，比较成型并且大规模使用时在阿胶项目，阿胶项目的所有的数据导入均采用此小工具，没有耗费额外的人天去开发EIM、Import等功能。在阿胶中所导入的对象有：值列表、视图、预定义查询、职位、职责、组织、部门、仓库、地

2、址、雇员、订单、价格表、客户、联系人、期初库存、客户信用额度等，其中客户约7万条记录，订单行约20万记录。Siebel各种数据导入方法比较：EIM操作方式：Excel数据收集->转为CSV->使用SQLLDR导入到自己创建的临时表->运行存储过程进行校验数据工作->运行存储过程将临时表的数据写入到EIM中间表中->运行siebel中的EIM工作流进行导入（编写ifb配置文件）-运行存储过程进行后处理（更新一些字段、关联等）。优点：n 导入速度较快n 可以处理较大数据量缺点：n 技术含量比较高，需要全程技术顾问参与n 需要编写SQLLDR的配置文件n 需要编写复杂的

3、存储过程，且每个项目只能参照，不能直接使用其他项目的成果n 需要编写ifb配置文件n 出现错误非常难以找到原因，通常查找错误的方式只能是通过数据库的trace文件查询sql，方能知道错误原因，（错误原因进程是外键关联、值列表等原因）n 每一个类型的操作必须编写一套不同的ifb文件，比如新建、更新、删除等Siebel导入工具操作方式：Excel数据收集->使用小工具直接导入（只需要编写简单的一个配置文件即可）优点：n 方便可靠，采用的是siebel提供的API直接操作BC层（业务组件层），类似于最终用户在页面创建记录的操作（UI->BC->Table）。n 技术含量较低，操作简

4、单，业务顾问即可完成操作。错误信息比较明了，会直接根据BC的限制抛出siebel的标准错误信息，比如违反了唯一性索引、值列表不存在等。n 可以使用多线程操作、模拟多个用户的操作，一定程度上提高了导入的速度。n 通用性比较强，无需对服务器有任何改动，只需要修改小工具的配置文件，可以较快的应用到其他项目。n 功能较多、新建、更新、新建或者更新、删除、查询等n 使用了Siebel的标准事物功能，对于导入的数据可以选择提交事物和回滚事物，有效避免导入垃圾数据。n 可以对复杂结构的数据放在一个excel里面一次导入。比如订单头、订单行、发货行等。n 方便知识转移给客户缺点：n 由于是操作BC层，速度方面

5、不及直接操作表层面的EIM。小工具一般对象的导入速度为（2000条/分，10万条/小时）n 由于速度的原因，所以一般对于超过50万或者百万级别的数据显得有点力不从心，Import ObjectExcel数据收集->CSV文件->通过页面导入到siebel中优点n 对于单层结构的少量数据比较方便。缺点：n siebel应用需要配置页面使用Import Object功能，n 每次导入只能导入2000条数据，这是oracle的限制。n 只能导入单层机构的数据，不能导入多值字段。n 报错信息比较差Siebel数据导入工具主要功能其主要功能有：Ø 对任何单个BC或者多层结构的BC进

6、行数据新建。Ø 对任何单个BC或者多层结构的BC进行数据更新或者新建。Ø 对任何单个BC或者多层结构的BC进行数据更新。Ø 对任何单个BC或者多层结构的BC进行数据删除。Ø 对任何单个BC或者多层结构的BC进行数据查询。Ø 对查询数来的数据，或者处理以后的数据保存为Excel、Html、XML内容。Ø 本文中未描述的功能或者描述错误之处请读者见谅。更新记录：V1.2Beta版本 2012-05-24n 对界面进行了全面的调整，可以同时打开多个子窗体。n 增加了对数据的查询功能，并且查询出来的数据可以较为方便的导出n 修改了部分bugn

7、 增加了多线程导入，可以同时开50个以内的线程，相当于用50个账户同时登陆服务器进行对bc的操作。n 增加了EAI事务处理，可以对导入的没有提交的数据进行回滚。第一章 软件安装与初始化Siebel数据导入工具是一个免安装工具，双击运行目录下的SDI.exe即可运行。但是前提是您的电脑中安装有Microsoft .NET Framework，否则程序无法打开启动页面，可能会报如下错误：可通过以上地址下载安装Microsoft .NET Framework。 若可以成功打开，则能看到如下界面： 第二章 操作说明2.1 配置参数文件2.2 功能说明2.2.1打开文件2.2.2 执行导入或者其它操作2

8、.2.3 执行查询2.2.4 导出结果数据2.4 调试与故障说明2.1 配置参数文件 如图所示说明该程序最终将使用LstOfVal.ini文件，最终的配置信息都将在LstOfVal.ini文件中。如图所示的内容为LstOfVal.ini文件的一个示例内容，以下对于每个参数做简单的说明：n ConnectString：该链接字符串指定siebel应用服务器的连接地址，注意，这并非是网页登陆的地址，实际上是连接应用组件的地址，该地址的默认端口是2321，在系统安装时指定，并且该端口需要在运行该程序的主机上可以联通，比如类似地址：host="siebel:/SIEBELDB:2321/SB

9、A_81/ePharmaObjMgr_chs其中的SIEBELDB为主机的地址，也可以是采用IP地址，比如38其中的SBA_81是Enterprise的名称，由服务器安装时指定，也可以再siebel应用的【管理服务器配置】->【企业】中查看到其中的ePharmaObjMgr_chs为组件的别名，可以在【管理服务器配置】->【企业】->【组件定义】查看，n ConnectUserName： 为连接服务器的用户名。n ConnectPassword：为连接服务器的密码。n RepositoryName：为服务器的配置中的存储库，默认为Siebel Repos

10、itory，一般不会有变化，除非特殊项目需求。n EXCEL_SHEET_NAME：该为我们最后需要打开的Excel的Sheet名称，比如这个名称不能有错误，否则无法打开excel，这就类似于数据库的表名称，一旦表名称有错误，那必然是无法查询到数据的。n HierarchyLevel：注意，此处代表需要导入的数据的结构层次，单层BC为1，头行结构bc为2,爷、爸、孙结构为3，当大于1时需要指定主键列。换言之：如果只对一个bc导入数据，那么就是1，如果对于头行结构，比如客户以及客户下的联系人，那么就是2，如果是订单头、订单行、发货行这种3层结构的，或者是客户、客户下的联系人、客户下的地址这种一个

11、头，两个并列行的是3。n ProcessNum：该参数代表最终需要使用单线程还是两个线程来处理，如果是2个线程处理的话速度会double，但是也可能会出现两个线程同时操作到一条记录的风险。该参数是为了让大数据量的导入速度快一点设置的，目前只能设置1或者2。n BOName：这是需要导入的对象。n BCName1：为第一个BC，n BCName2：如果有第二个BC，n BCName3：如果有第三个BC，n ActiveField1：这里面为第一个BC中需要激活的字段以逗号分隔。n ActiveField2：这里面为第二个BC中需要激活的字段以逗号分隔。n ActiveField3：这里面为第三个

12、BC中需要激活的字段以逗号分隔。n Field1： 第一个BC的字段以及对应于EXCEL的列的名称。每个字段间用分号分隔，字段与excel列名之间用逗号分隔。n Field2：第二个BC的字段以及对应于EXCEL的列的名称。每个字段间用分号分隔，字段与excel列名之间用逗号分隔。n Field3：第三个BC的字段以及对应于EXCEL的列的名称。每个字段间用分号分隔，字段与excel列名之间用逗号分隔。n PickMapField1：如果在bc中有动态的picklist，并且需要多个字段共同来确认一条记录的时候需要填写，例如：PickMapField1=Parent,Type,父类型,Name

13、,父许可证编码其中的Parent是需要做Picklist的字段，Type为Picklist中的类型，父类型为对应的excel的列，如果还需要第二个字段来一起确定，则还有一个Name，这就是里面的独立源代码的字段，其对应的excel的列名为父许可证编码。多个字段使用分号分隔。n PickMapField2：类似PickMapField1n PickMapField3：类似PickMapField1n MVGField1：;分别为MVG字段的名称，弹出关联BC中的字段，弹出关联BC中的字段的值对应的excel列名，是否设置为主要，为N则不设置，使用默认，后一个值代表是否需要将MVG中除此之外的值删

14、除，多个以分号分隔比如“Responsibility,Name,职责,Y” 代表字段“Responsibility”所对应的mvg中对字段“Name”进行查询，所来源的值为Excel的职责列，然后需要设置为主要，不需要删除MVG中的其他值。例如：Responsibility,Name,职责,Y,N;Position,Name,职位,Y,N;Employee Organization,Name,组织,Y,Nn MVGField2：类似MVGField1n MVGField3：类似MVGField1n KeyField1：当我们需要进行更新或者插入或者更新操作时，我们需要判断一个唯一性，比如图：这

15、表明唯一性字段未Login Name，其对应的excel的名称为用户 ID，多个Key使用分号分隔。2.2.1打开需要导入的excel文件运行程序选择配置文件选择数据文件2.2.2执行导入或者其它操作可执行sql语句，支持sqlite的关于语法可以打开新的日志窗口，在导入的时候实时查询最新的导入状态选择高级插入或者更新在执行导入之前，可以考虑是否需要使用多线程，以及是否需要启用事务，默认是启用了事务，此事务和oracle数据库的事务类似，但是是使用的siebel的标准的eai的事务功能。观察导入过程：导入完毕此时您需要选择是否提交该次导入的数据，选择事务提交事务或者回滚事务2.2.3 执行查询

16、该查询功能的有两个，1、 根据现有的数据进行查询是否有记录，那么请参照之前的导入过程自己琢磨一下。2、 根据条件查询出系统中的数据，即为导出数据功能。设置查询条件：选择查询设置查询条件可以设置想要的查询条件，表达式遵循siebel的查询表达式，例如和siebel配置的search一样的。图中可以对3个bc进行设置，分别有查询条件、排序字段、是否包含标准字段（创建时间、创建者等标准字段）、是否生成查询sql，生成查询sql需要到服务器的bin目录下取得执行查询设置显示数量由于服务器数据可能比较多，可以设置一个查询数据，仅返回这么多数据2.2.4 导出结果数据选择导出导出CSV到Excel此处可以将当前页面的数据导出为excel或者其它格式。也可以再执行完成导入数据之后导出正确的或者错误的数据根据word模板导出word内容2.3 调试与故障说明在程序的目录中有一个log目录，其中detaillog.txt会记录详细的错误信息，如果出