SIEBEL助手

Siebel助手

 

 

用

户

手

册

 

黄福强/Johnny Huang

版本号：V2.0 Beta版

 

序  言

 

该软件是基于Microsoft .NETFramework开发的一个针对Siebel CRM的工具,使用Siebel提供的标准API，对Siebel对象进行操作。

目前实现的功能有：

【地址信息助手】可以按项目管理地址信息，应用地址信息可以直接使用IE或默认浏览器打开，数据库地址信息可以生成tnsnames.ora，操作系统地址信息可以直接打开远程桌面进行连接。

【被锁对象查询助手】可以查看当前所有被锁住的对象，可以设定多条件查询，如果发现有锁住对象的顾问已经不在场，可以强制解锁该对象，支持批量解锁对象。

【脚本查询助手】对于技术负责人，需要对项目上的代码进行Review，该功能可以按开发人员、时间、对象名进行Review；对于技术顾问，基本上在每个项目都要写很多代码，该功能可以方便收集项目上的代码，并以Excel或者文件形式进行归档。也可通过多个条件组合快速查询代码。

【查询助手】 该功能可以选择同一个BC下的ListApplet和Form Applet上面的字段，导出数据。并可设置查询条件，获取执行SQL，避免了打开Tools进行Debug的繁琐，可设置无数据的查询条件快速获取查询SQL。

【数据导入工具】该功能可以实现数据的导入，操作简单，错误信息比较明了，可以进行增加，修改，删除，查询功能，并可选择事务操作，多用户执行。用户只需在首次使用时进行简单的配置,即可进行数据导入。

【向导生成配置文件】该功能可以通过界面配置的形式，生成导入工具所需要的配置文件和数据模板。

 

文档部分内容未及时更新请见谅。下载地址：http://download.csdn.net/detail/hfq_1991/9407700

如果您在使用该软件遇到问题，请您Email:[e-mail]

 

 

版本更新

版本：1.0    时间：2013-12-20

其主要功能有：

Ø  对任何单个BC或者多层结构的BC进行数据新建。

Ø  对任何单个BC或者多层结构的BC进行数据更新或者新建。

Ø  对任何单个BC或者多层结构的BC进行数据更新。

Ø  对任何单个BC或者多层结构的BC进行数据删除。

Ø  对任何单个BC或者多层结构的BC进行数据查询。

Ø  对查询数来的数据，或者处理以后的数据保存为Excel、Html、XML内容。

Ø  EAI事务的处理，多用户处理，相当于多个用户同时登陆

Ø  对导入过程的实时监控

 

 

版本1.1      时间2014-04-30

更新记录：

A.   新增功能:界面向导生成导入所需的配置文件和数据模板

B.   新增功能：可以根据界面上的字段生成所需的数据，包括List Applet和Form Applet

C.   修复数据混乱照成的数据丢失问题

D.   时间条点击弹出平均速度，预计剩余时间。进度条点击弹出导入进度

E.   数据导入情况界面添加导出错误数据，统计未操作数据

F.   修复多次导入不同数据文件，列混乱的情况

G.   修复导入Excel数据，数字较大时，产生科学计数法问题

H.   增加非事务操作，可根据定义来执行

I.   修复查询数据带有单引号出现错误但是未显示为错误信息

J.   优化查询助手，向导生成配置文件选择下拉框更加流畅

K.   支持导入xlsx格式的数据

 

版本1.2      时间2014-06-14

更新记录：

A.   新增功能：脚本查询助手，可以直接把项目上的代码导出成Excel格式和文件格式。方便管理、收集项目上的代码

B.   界面多种风格切换，优化界面提示信息

C.   修复极个别情况导入第一列无法被识别为标题行

D.   打开界面默认出现类似Excel的界面

E.   导入结束默认只显示失败数据，可以切换显示数据模式

 

版本1.3      时间2014-07-07

A.   新增功能：被锁对象查询助手，可以查看当前所有被锁住的对象，可以设定多条件查询，如果发现有锁住对象的顾问已经不在场，可以强制解锁该对象，支持批量解锁对象。

B.   美化表格控件，增加右键菜单选择

C.   修复数据文件载入失败，计时器没有停止

D.   修复没有安装Siebel Tools直接要求退出的情况

 

版本2.0      时间2014-07-17

A.   更新页面风格

B.   脚本助手列可以拖动，并增加查看脚本功能，该功能可以非常清晰的对代码格式进行检查

C.   查询助手添加查看执行SQL功能，免去打开Tools进行Debug的繁琐，可以设置空查询快速获取SQL。

D.   数据导入情况增加错误信息汇总视图

E.   添加地址信息助手，可以按项目维护应用地址信息，数据地址信息等

 

 

软件安装与初始化

软件下载地址：

 

l  下载软件安装包,然后点击安装即可。

l  安装过程如果提示需要.Net3.5，可以在上面地址找到安装文件，Win7下自带.Net3.5，无需该步；window2008可直接在【服务器管理-功能】添加.Net3.5。

l  安装完成，可看到界面如下

 

 

操作说明

【地址信息助手】

该功能主要可以按项目管理常用的地址信息，包括Siebel应用地址、数据库地址信息、操作系统地址、SVN地址等。在记录上右击可以看到菜单，应用地址信息可以直接使用IE或默认浏览器打开，数据库地址信息可以生成tnsnames.ora，操作系统地址信息可以直接打开远程桌面进行连接。

通过【地址信息助手】打开，可以看到如下界面。默认会把最新修改过的项目排在最前面，可自行点击列进行排序。如果需要备份或迁移，可以拷贝【安装路径：/ Siebel助手/Data/ SystemInfo.db】到相同目录下即可。

【被锁对象查询工具】

该功能主要可以直观展现目前项目上被锁住的对象，了解目前每个顾问正在操作的对象，按锁住时间倒序，还可以设定多条件查询，如果发现有锁住对象的顾问已经不在场，可以强制解锁该对象，支持批量解锁对象。

从【被锁对象查询助手】打开，可以看到如下界面，该数据库连接信息在整个系统是共用的，维护后点击保存到本地可以方便以后使用。

关键信息说明：

该界面的信息可以参考本地Oracle客户端下tnsnames.ora文件。

名称：本地数据连接名称，方便自己识别即可

数据库IP：对应tnsnames.ora里面的HOST

数据库端口：对应tnsnames.ora里面的PORT

数据库名：对应tnsnames.ora里面的SERVICE_NAME

用户名/密码：有权限能够访问SIEBEL用户对应对象的数据库用户名密码

 

点击加载数据，如果加载成功则会在后台查询数据，看到如下界面。

该界面共有六个字段：序号、对象名称、对象类型、语言、操作用户、对象被锁时间。默认是按对象被锁时间排序的，可以通过点击列名进行排序。可以设定多个字段组合查询，设置完查询条件后除了可以通过查询按钮查询，还可以直接在文本框内进行回车查询。

如果由于某些原因，需要强制解锁某些对象，可以直接选中这些对象，通过点击‘强制解锁’按钮或者右键选择‘强制解锁’菜单进行强制解锁。该操作会导致操作对象的顾问不能正常的Check In，请谨慎操作。

    如果需要返回重新设置连接信息，可以右键选择‘设置连接’菜单。

【脚本查询助手】

对于技术顾问，基本上在每个项目都要写很多代码，该功能可以方便收集项目上的代码，并以Excel或者文件形式进行归档。也可通过多个条件组合快速查询代码。

    从【脚本查询助手】打开，可以看到如下界面，该数据库连接信息在整个系统是共用的，维护后点击保存到本地可以方便以后使用。

    点击加载数据，如果加载成功则会在后台查询脚本数据，默认显示一年内有修改的脚本，看到如下界面。

该界面共有九个字段：序号、对象名称、对象类型、最后更新时间、创建时间、最后更新用户、创建用户、方法名称、脚本。默认是按最后更新时间排序的，可以通过点击列名进行排序，可以拖宽行查看脚本具体内容。下图是查询‘脚本内容带有Johnny Huang 并且是2014年五一之后创建’的脚本。设置完查询条件后除了可以通过查询按钮查询，也可以直接在文本框内按回车查询。

查询到结果后，可以直接右击一条记录，选择查看脚本，该功能对间距进行放大，可以非常直观看出代码格式是否规范，对于那些用空格而没有用Tab对齐的代码可以非常清楚的看出差别；该功能可以方便技术负责人进行代码的Review。

Tools下查看的效果：

 

对于查询结果，还可以点击导出Excel或文件归档，把脚本导出。

 

【查询助手】

例子I-员工

如果业务顾问需要导出界面上的数据，可以通过【查询助手】实现。可以选择List Applet和Form Applet上面的字段，进行导出操作。

例如：在员工界面，我们想导出List Applet上面的姓氏、名称、用户ID、职位；FormApplet上面的办公电话号码，电子邮件。

第一步：选择数据库连接，加载数据

从【查询助手】打开，可以看到如下界面

1.      该数据库连接信息在整个系统是共用的，维护后点击保存到本地可以方便以后使用。

2.      点击加载数据源，判断数据源是否加载成功，并加载后续数据信息

3.      如果加载成功，点击下一步

第二步：选择要查询的Applet对应的BO，BC，然后选择List Applet和Form Applet，获取字段

1.      该步骤选择BO后，会列出该BO下的BC；选择BC后，会列出所有基于该BC的List Applet和Form Applet。选择完后，点击获取字段，就可以看到界面上的字段。如下图：

 

2.      如果只需要选择一个Applet，另一个不要选择即可。

3.      如果字段太多，不能快速定位，可以通过下面的搜索框实现快速查找记录

4.      如果查找之后发现存在相同显示值的记录，例如搜索职位发现有两个职位，可以点击字段名，查看显示值对应的字段名。

5.      添加完所需要字段，点击下一步

 

第三步：设置EAI的连接信息

该EAI连接信息在整个系统是共用的。

1.      填写好配置文件信息后，可以保存到本地，方便下次使用

2.      点击测试连接按钮，查看测试连接是否成功

3.      连接成功后，点击下一步

 

 

第四步：查看查询结果，导出Excel

查询后发现有4162条记录，到员工界面进行计数统计，结果数量一致，导出为Excel。

第五步：查看执行SQL

点击查看执行SQL，可以查看本次查询使用的SQL语句。设置一个无数据的查询条件，可以快速获取查询SQL语句，免去打开Tools进行Debug的漫长等待，

【向导生成配置文件】

例子I-职位

如果是第一次导入，需要进行配置文件的生成，然后在生成的Excel模板维护好数据，即可进行导入操作。导入操作可见【数据导入工具】。配置文件是导入必须的文件，该文件存储了要配置的对象，对象之间的关系，服务器EAI的连接信息等。

例如：导入职位(BO：Position，BC：Position)，需要导入的字段

l  职位名字(Field：Name直接导入)

l  部门(Field：Division，动态picklist，通过部门名称Name进行搜索)

l  姓氏(Field：Last Name，MVG,通过员工的登陆名Login Name来搜索)

 

第一步：选择数据库连接，加载数据

从【向导生成配置文件】打开，可以看到如下界面，该界面可以维护数据库连接的信息，该信息可以保存在本地，方便下次操作直接选择。

1.      该数据库连接信息在整个系统是共用的，维护后点击保存到本地可以方便以后使用。

2.      点击加载数据，如果提示“加载成功，进行后续操作”则继续，否则说明数据库连接信息有错误。

3.      选择要导入的对象对应的BO名称，比如选择Position

4.      选择要导入的对象对应的BC名称，比如选择Position，该操作只能选择到上一步选择的BO下维护的BC。

5.      维护完成点击下一步

 

第二步：选择本次操作要使用到的字段

如果字段太多，可以通过搜索框进行搜索，快速选择到需要的字段。例如本次操作需要用到的字段有：职位名字Name、部门Division、主要联系人姓氏Last Name，选择完所需要的数据后，点击下一步

第三步：选择本次操作要用到的单值字段

上一步选择完要操作的字段后，对于单值字段、动态picklist字段、mvg字段处理方式不一样，所以需要分开进行选择；该步选择本次操作用到的单值字段，如果是需要进行修改、查询或删除操作，则需要指定具体根据那几个字段来作为查询条件。

第四步：选择本次操作要用到的PickList字段

对于要导入的PickList字段，需要选择该字段的查询条件，通过查询条件查询后，选择满足条件的记录，该查询条件得到的结果最好只有一条，多条的话也只能选择第一条，例如部门这个字段，我们利用部门BC的Name字段(名称)来进行查询。

1.      可以利用多个字段一起查询，最多支持四个参数的查询。

2.      设置完成点击下一步

第五步：选择本次操作要用到的MVG字段

对于要导入的MVG字段，需要选择该字段的查询条件，通过查询条件进行查询，对查询结果进行操作。例如主要员工这个MVG，我们利用员工BC的Login Name字段(用户ID)来进行查询。

1.      对于每个MVG字段，可以利用多个字段一起查询，最多支持四个参数的查询。

2.      可以设置是否设为主要

3.      可以设置是否删除其他，对于查询条件得到的结果如果不止一条，该字段不要设为Y，否则删除其他的操作得到的结果只有一条

4.      设置完成点击下一步

 

 

 

第六步：设置EAI的连接信息

该EAI连接信息在整个系统是共用的。

1.      填写好配置文件信息后，可以保存到本地，方便下次使用

2.      点击测试连接按钮，查看测试连接是否成功

3.      连接成功后，点击下一步

 

 

关键字段说明

名称：本地的EAI数据连接名称，方便自己识别即可

连接地址：Siebel Server所在服务器IP

端口：EAI的端口

Enterprise：EnterpriseServer名称

组件别名：所要导入的组件名称

用户数量：该数量也可以导入的时候，在菜单【编辑-设置用户数量】进行设置，如果设置多个用户，就相当于登陆多个用户进行操作。如果导入数据量较大，可以把用户数量设大点，但是要考虑服务器所能承受的最大任务数。

第七步：修改数据模板，生成配置模板

最后一步，我们要维护导入的数据模板，左边列是要导入的字段名，右边列是导入字段在Excel里面对应的列名。该列名最好跟已经整理好的数据的列名一致，以免后续需要再次修改。

修改之后如下图，对于BC的Name(职位)字段，直接把Excel里列为职位名称的数据写入；对于Division：Name(部门)字段，会先在部门BC利用Name字段进行搜索匹配，匹配条件为‘Name={Excel里列为部门的数据}’；如果条件不止一个，比如部门是通过部门名称和部门类型进行匹配的话，那还会有一列Division：Type(类型)，然后也需要维护对应Excel的列名。

修改之后点击下一步，生成如下两个文件

l  Position_Config.ini为配置文件

l  Position.xlx为数据模板

具体内容可看附件1

附件1

 

说明

1.   如果需要修改已经生成的配置文件，MVGField1对应的第一个Y/N表示是否设为主要，第二个Y/N表示是否删除其他。如下：

MVGField1=Organization,Y,N,Name,所属组织;Position,N,Y,LoginName,销售人员;

2.   对于选择操作字段后的字段的分类是这样的：BC上Field对应的PickList如果是动态的PickList，该字段为PickList字段；如果该字段是MVF，则为MVG字段。如果需要做一些特殊处理(如MVF的字段要当做单值字段，直接写入值)，可以生成配置文件后手动修改配置文件。

 

 

 

 

 

【数据导入工具】

该功能在维也纳项目上进行测试，维也纳项目大部分数据都是使用该功能进行导入，其中数据量最大的客户及协议达到35万。对于没有过多MVG和PickList字段的导入操作会比较快，决策人每分钟大概2000条，企业客户和协议每分钟大概1000条。

修改界面风格

在界面的右上角，可以通过点击风格下拉框，切换界面的风格，目前支持9种风格，可以根据个人喜欢切换不同的界面风格。

隐藏功能区

在界面的右上角，可以通过切换显示和隐藏按钮来控制菜单栏的状态。

例子I-职位

生成配置文件和数据模板后，只需要维护数据文件的内容，添加三条数据用于测试

第一步：打开配置文件

可以利用向导生成，具体步骤看【生成配置文件和数据模板】

第二步：打开数据文件，打开后界面如下

第三步：测试连接，只有测试通过才能进行导入操作

选择完配置文件和数据文件后，需要进行测试连接，判断是否能够成功连接，才能进行后续操作

如果在10秒内连接失败，会提示连接超时，查看是否网络或服务器未启动等原因，再次点击测试连接进行测试即可

第四步：选择要执行的操作【编辑-新建数据】，根据列“导入是否成功”判断数据是否导入。

执行操作前可以设置执行的用户数量，该数量可以在菜单【编辑-设置用户数量定义执行计划】进行设置，如果设置多个用户，就相当于登陆多个用户进行操作。如果导入数据量较多，可以把用户数量设大点，可以提升导入的速度，但是要考虑服务器所能承受的最大任务数。

导入成功的情况：导入完成默认只显示失败数据，可以在【数据-数据显示】显示所有数据

导入失败的情况：可在菜单【数据-导出错误数据】后，处理数据在进行导入

l  如果需要查看导入的进行的情况，可以通过菜单【编辑-导入情况】查看导入过程，也可以通过双击导入进度条右边导入的百分比进行查看；

第五步：提交事务或回滚事务

第六步：到界面或数据库上查看导入的数据

结果跟预期的一样。

导出数据

对于导入结果，可以导出为Excel格式，CSV格式，Html格式，XML格式。

注：如果在导入过程发生错误，可以利用导出错误数据把没导入成功的导出来，然后对这部分数据处理完后，再进行导入。导出的单元格均为文本格式，防止类似0011导出后自动被转化为数字11。

 

说明

1.   如果遇到类似未在本地计算机上注册“Microsoft.ACE.OLEDB.12.0”提供程序的错误。需要下载AccessDatabaseEngine.exe，下载地址在【软件安装】可以看到。

2.   在导入的过程如果想要暂停或中断，在菜单【编辑-操作暂停】可以暂停操作，菜单【编辑-操作继续】可以继续操作，在菜单【编辑-操作停止回滚事务】可以中断操作

3.   在软件的左下角可以查看软件的处理信息，右下角可以很直观地查看导入的进度，导入所花费的时间。为了避免过多弹窗，如果在点击按钮发现没有反应，可以查看左下角给出的提示，或者打开日志查看日志信息。

4.   双击右边的运行时间，可以显示平均速度，剩余未导入数量，预计剩余时间

5.  除了进行导入操作，还可以进行修改、查询、删除操作，这些操作需要设定查询条件定位到具体的记录，所以需要设置查询字段

6.  如果想要进行非事务的处理，可以在菜单【编辑-设定用户数量定义执行操作】选择要进行的操作类型后，点击菜单【编辑-根据定义执行(无事务)】

7.      该导入功能需要系统有安装Siebel Tools(非绿色版)、Siebel Client、Oracle Client，在装有Siebel服务器的系统可直接使用。

8.      如果导入数据后，界面出现细微混乱，可以通过设置兼容性，以管理员打开解决该问题

9.      对于数据量较大的导出，可以使用快速拷贝全部数据，快速拷贝选中数据来进行导出。