TIPTOP集成配置方法
李锋
集成原理
TIPTOP集成接口通过企业对象与外部系统进行数据交换，企业对象的其操作部分由集成API实现，数据部分由TIPTOP资料库中取得，视需求不同，可来源于单个数据表，或多个数据表关联得来。
ITEM对象
ima_file
对象来自于单个数据表
COUNTRY对象
geb_file
geo_file
too_file
top_file
对象来自于多个数据表（主从关系）
gen_file
EMPLOYEE对象
gem_file
对象来自于多个数据表（JOIN关系）
在开始数据交换之前，必须首先将各个数据表的关联关系，以及数据的组织形式在系统中进行配置，如果本次集成只涉及到服务性操作（即所有数据交换的操作都由目标系统发起），那么只需要配置在TIPTOP中的对象信息就可以了，如果需要由TIPTOP发起数据交换操作，则除了配置TIPTOP的对象之外，还需要配置来自目标系统的对象信息，以及在TIPTOP对象和目标系统对象之间的对应关系。
步骤一 配置TIPTOP对象
BOM
BRAND
DEPARTMENT
……
步骤二 配置目标系统
PDM
CRM
HR
……
一个完整的集成配置流程
步骤四 建立对象间对应关系
BOM <->（BOM）PDM
BRAND <->（BrandInfo）CRM
DEPARTMENT <->（Department）HR
……
步骤三 配置目标系统对象
（BOM）PDM
（BrandInfo）CRM
（Department）HR
……
详细过程将在下面章节进行介绍：
配置TIPTOP企业对象
配置一个TIPTOP企业对象的简单流程如下：
awsi002
维护对象信息
awsi003
维护对象属性信息
awsi009
维护属性选项信息
首先，运行awsi002集成配置作业，该作业的功能是定义对象，下属表即表之间的关系。基本操作同其他双档作业。
单头栏位说明：
企业对象ID：企业对象的标识，在系统中对企业对象的应用均通过其ID进行。该栏位必填
对象名称：中文的名称，可选。
对象描述：说明信息，可选。
- 可新增：是否允许对该对象中的数据执行新增（INSERT）操作
- 可修改：是否允许对该对象中的数据执行更新（UPDATE/SYNC/ADJUST）操作
- 可删除：是否允许对该对象中的数据执行删除（DELETE）操作
单身栏位说明:
表名：该对象对应的数据表名称，必填。
表的描述，描述信息，可选。
上级表：该数据表对应的上级表（如果类型为Head则空缺）
下级表：该数据表对应的下级表（如果类型为SubDetail则空缺）
与下级表之间的字段关系：表之间的关联，如果在下级表栏位中输入了内容，则该栏位必填。请注意在图示中该栏位出现的（＋），它只能位于下级表栏位一侧。此处输入的内容将直接被用于SQL语句中的关联条件，所以如果希望当子表中不存在对应记录是仍然能够选出主表记录则请使用（＋），反之可以不使用。对于同一个主表带有多个子表的情况每个子表栏位后面都必须使用（＋），否则可能导致选不出记录的错误。
类型：表在逻辑层次结构中的种类，目前系统支持最多四级的层次结构，分别是Head、Body、Detail和SubDetail。
说明：单身的主键是表名，下级表，所以当某个表带有多个同级子表的时候，可能会出现多条表名相同的记录（如示例中的ten_file）。
当完成对象和表的维护之后，可以单击右侧的属性定义信息维护对象下属的各个属性（或直接运行awsi003启动该作业）
单身栏位说明：
企业对象：前面设定的企业对象ID，必填
属性标识：属性的唯一标识，必填
属性名称：中文的属性名称
表 名：属性来自的数据表，必须为前面单身维护的表。必填
字 段 名：属性来自的字段名，必填
数据类型：属性的数据类型，有C/D/N/I四种，分别代表字符型/日期型/数值型/整型，必填
长 度：属性的数据长度，在内部处理过程中，用于对字符型变量进行截取操作，其他数据类型无影响，必填
Key 值：该属性是否为对象的主键，必填
必 填：该属性是否必填
可 更 改：该属性的内容是否允许被更改（对于某些从别的表中Join过来的只读属性要取消勾选）
描述信息：该属性的附加说明信息
起 始 值：如果该属性的取值有一个连续范围的话，在此处给出该范围的起始值
截 止 值：如果该属性的取值有一个连续范围的话，在此处给出该范围的截止值
默 认 值：该属性的默认值（如果目标系统发出的更新操作中没有包含某些必填栏位，则服务函数会自动从此处取得值填充该栏位，如果这时没有发现默认值设置，则会返回一个错误）
在上面的作业中完成了属性的配置之后，对于某些属性的取值为选项（比如性别的取值为：0-男，1-女）的情况，我们可以点击窗体右侧的“定义栏位选项值”按钮来进行维护（或直接运行awsi009启动该作业）
单头栏位说明同上面介绍:
单身栏位说明：
选 项 值：选项的编码，必填
选项说明：对应的说明信息，可选
配置目标系统
如果在集成中需要从TIPTOP向目标系统中导出报表，或者由TIPTOP发起数据访问的动作，则首先需要在TIPTOP中配置目标系统的信息：
该项目的配置比较专业，某些栏位的取值需要技术工程师测试取得，所以此处不做介绍，请注意的几个地方是：Web service URL中的IP地址是否正确，如果有报表抛转需求的时候，最下面的两项服务器IP地址和报表存放路径是否正确。如果遇到不能集成的错误，该作业可以提供一个测试连接的功能，请选出对应的系统，点击窗体右侧的“测试连接”按钮，如果出现下面的提示则标识该目标系统的配置是正确的：
配置目标系统对象
与TIPTOP系统对象的配置基本相同，对方系统也需要配置用来交换的企业对象，运行awsi007启动该配置作业：
该作业是一个标准双档作业，可以直接录入对方企业对象的信息，除此之外，系统还提供一种从目标系统中直接抓去对象和属性列表的功能。请点击窗体右侧“从目标系统中抓资料”按钮:
请千万注意：该功能只适用于新增对象或系统初始阶段成批创建资料，因为它会自动覆盖现有的对象信息，所以当指定对象已经维护过对应关系的时候切勿使用！否则之前的辛苦都白费了
在其中输入目标系统ID（即前面录入的目标系统标识），并点击确定，此时会列出目标系统中开放的所有对象清单：
在单身中勾选需要导入的对象（可多选）并单击确认：
相应的对象信息即成功导入系统，可以看到单身中除了TIPTOP字段名称之外，其他的栏位均可从对方系统中导入，同时系统也允许手工维护。
建立对象间对应关系
在前面的作业中，当我们从目标系统中导入了对象信息之后，还需要在这些对象和TIPTOP对象之间建立对应关系，在awsi007中，需要维护的地方有三处：
- 对象之间的关系 － 单头TIPTOP企业对象
- TIPTOP栏位和对方属性之间的关系 － 单身TIPTOP字段名称，
- 属性选项值的对应关系 － 点击窗体右侧“维护选项对应关系”按钮
配置完成后的界面如下：
需要说明的是，如果某个属性的信息在被定义为必填，那么必须为其配置一个对应的TIPTOP栏位，否则会无法通过。因此当某些栏位的确不需要对应栏位（可能是传递上的误差）时，必须先手工取消勾选必填栏位。
除必填栏位的检查外，系统还会对属性类型和栏位类型以及长度进行检测，如果发现有不匹配的状况则会进行提示：
除了目标属性与TIPTOP栏位之间的对应之外，我们经常还需要配置属性的选项值和栏位的选项值之间的对应关系，方法是先选中某一笔单身，并单击前面窗体右侧的“维护选项对应关系”按钮：
在单身中分别列出了目标系统中可选的选项值和TIPTOP中可选的选项值，如果对方在接口中列出了选项值，那么单身中目标系统的对应信息（即选项值和选项说明）可以直接带出，否则需要手工维护。我们需要指定对应的TIPTOP选项的值，说明信息会自动从相关表中带出（由前面介绍的awsi009栏位选项维护作业维护的信息）
这里说明一下在什么情况下需要维护选项对应关系，比如说有效码栏位，在TIPTOP中使用Y/N来表示的，但在CRM系统中可能是用TRUE/FALSE来表示的，因为集成规则是以遵守服务端定义规则，所以如果我们作为发起操作的一方，必须在传递数据之前把Y/N形式的数据转换成对方系统能识别的TRUE/FALSE形式的数据。
理想状态下，集成的两个系统间对于选项的处理是传递代码，由双方各自来显示对应的说明信息，某些特殊的情况下，如果对方系统需要直接传递说明信息，且这些信息对于对方来说是只读的时候，我们可以通过在对应关系中将对方的值和说明都维护成说明信息（如上图所示的状态）来实现。
转载请注明：赫非域 » TIPTOP集成配置方法