南车电机ESB项目需求分析说明书.docx

1、南车电机ESB项目需求分析说明书南车电机ESB项目需求说明书1.1 参与人员序号名称描述负责人电话邮箱1PDM（TC）产品数据管理系统2ERP企业资源计划（金蝶）3HCM人力资源管理信息系统4RTX腾讯通5AD域6TDM试验数据管理系统7QS质量信息管理系统8Portal门户系统9OA自动化办公系统1.2 目的与适用范围本文档规范对南车株洲电机有限公司各业务系统的接口集成进行现状描述，用于ESB系统方案设计。1.3 相关术语1.4 参考资料1. ERP系统服务接口资料：企业服务总线（ESB）构建项目ERP调用文档（定稿）.doc2. TDM系统服务接口资料:TDM与TC集成方案_V05.doc

2、获取委托单接口基本信息(TC提供)_-_副本.docx接口文档(TDM提供).docx3. PDM（TC）系统服务接口资料：南车电机_Teamcenter-ERP数据同步设计方案_V04.doc2 项目总体情况2.1 系统整体交互图Ps:箭头指向的方向是请求的方向2.2 接口清单Soap接口类型:序号系统接口名称协议类型正式地址是否接入接口规范文档1OA获取待办Soap是2OAOA待阅Soap是3OAOA邮件Soap是4HCMHCM待办Soap是5PDM获取实验大纲Soaphttp:/ 10.168.0.29: 8889/TDM/services/UFCTDMSer?wsdl是中间表类型序号写

3、入系统调用系统接口名称操作方式服务器地址是否接入1ERPPDM(TC)首次同步（读）中间表10.168.0.107是2ERPPDM(TC)定时同步（读）中间表10.168.0.107是3ERPPDM（TC）材料库编码同步中间表10.168.0.107是4ERPPDM（TC）工具编码同步中间表10.168.0.107是5ERPPDM（TC）工作中心同步中间表10.168.0.107是6PDM（TC）ERP工装编码同步中间表10.168.0.107是7ERPPDM（TC）工装价格同步中间表10.168.0.107是8PDM（TC）ERP制造BOM新增修改中间表10.168.0.241是9PDM（T

4、C）ERP制造工艺新增修改中间表10.168.0.241是10PDM（TC）ERP流程更改单中间表10.168.0.241是11ERPPDM系统物料接口表视图10.168.0.107是12ERPEAM采购的设备数据和资本性支出采购订单明细中间表10.168.0.107是13ERPK3设备固定资产数据中间表10.168.0.107是14ERP供应商和客户数据系统表10.168.0.10715PDMBOM数据系统表Ldap类型序号系统调用系统接口名称操作方式服务器地址是否接入1AD域TDM、企业邮箱获取用户信息Java Ldap10.168.0.5是Asmx类型序号系统调用系统接口名称操作方式服务

5、器地址是否接入1RTXOA传入提醒消息Java调用Asmx服务10.168.0.102是3 项目需求情况3.1 AD域系统3.1.1 系统接口交互图AD域通过中间表的方式获取HCM的用户信息，TDM通过LDAP方式获取AD域人员信息。Rtx和企业邮箱也是通过ldap的方式同步的AD域用户信息。3.1.2 环境说明3.1.2.1 1.AD域的相关信息接口名称AD域服务器信息接口作用AD域服务器信息服务器IP地址10.168.0.5端口ldap 389urlOUOU=南车株洲电机有限公司,DC=motor,DC=csr,DC=comDC10.168.0.5测试用户名admt密码pssw0rd调用频

6、度：每天的凌晨（只限于hcm）涉及的系统：HCM、RTX、Mail、门户3.1.3 接口说明RTX依据参数OU(组织单元)为参数来同步数据。企业邮箱的用户会通过AD域做密码验证（0116开头的用户）3.2 HCM人力资源管理信息系统3.2.1 系统接口交互图门户系统通过HTTP方式获取HCM的待办。AD域通过中间表的方式获取HCM的人员信息3.2.2 环境说明（待获取总部资料）3.2.3 接口说明3.2.3.1 HCM待办方法名称描述门户获取HCM的待办C#代码如下Stringusername = Convert.ToBase64String(Encoding.Default.GetBytes

7、(_UserName);string serurl= String XmlMessage = serurl.Replace(#userName, username);然后解析XmlMessage服务器IP接口协议类型HTTP服务器端口发布路径输入参数参数名称是否必填参数说明取值说明UserId是用户名输出参数返回值类型返回值长度说明异常信息描述文件示例HCM写入用户信息表的详情？需要去找相关人员获取文档资料3.3 ERP企业资源计划(金蝶)3.3.1 系统接口交互图ERP通过中间表的方式从PDM获取制造BOM，工艺BOM，工装等信息。PDM通过中间表方式从ERP获取外购件，工具，工装单价，工作

8、中心等信息。ERP和PDM之间的中间表在两个不同的数据库服务器上，IP地址分别为10.168.0.56（Oracle）和192.168.0.241（Oracle）上。自身系统的数据库在10.168.0.107服务器上备注：ERP系统分为，总公司ERP，和三个子公司的ERP系统（金蝶）3.3.2 环境说明ERP中间库地址数据库类型Oracle服务器ip10.168.0.56数据库名erp2tcm用户名allink密码password系统描述TCM西门子 Teamcenter平台下的制造工艺管理模块ERP金蝶ERP管理系统服务器ip10.168.0.107数据库名allinkerp 用户名erp_

9、allink密码erpadminsql3.3.3 接口描述3.3.3.1 材料库编码同步写入系统读取系统中间表读取条件参数参数取值ERPPDM（TC）T_ERPMATERIAL_TCMFSTATUS= 0FSTATUS0或1备注FSTATUS(0待处理，1已处理)，FDISPOSE(0新增、1更新)表结构说明：【ERP材料库类物料信息表】：T_ERPMATERIAL_TCM（对应ERP表：T_MATERIAL）物料编码修改时：修改Fmaterialno、fmaterialid相同的行。FSTATUS=1时将FDISPOSE置为1、FSTATUS置为0。中间表字段名称字段类型字段描述TCM字段名

10、称说明FNUMBERvarchar2(32)物料编码item_id（主键）非空FNAMEvarchar2(64)物料名称object_name非空FSTATUSchar(1)处理状态NULL非空，0待处理，1已处理FDISPOSEchar(1)处理方式NULL非空，0新增、1更新FC3STATUSvarchar2(16)状态c3_status正常、废除（不可用）FCATEGORYvarchar2(32)所属类别c3_categoryFSOURCEvarchar2(32)来源c3_sourceFMODELvarchar2(80)型号c3_typeFSPECVARCHAR2(30)规格c3_spe

11、cFCZVARCHAR2(30)材质c3_czFCHARTNOVARCHAR2(30)图号c3_drawing_noFUNITVARCHAR2(32)计量单位c3_unitFSUTTLENUMBER净重c3_suttleFGROSSWEIGHTNUMBER毛重c3_grossweightFREMARKvarchar2(256)备注c3_remarkFCLASSIDvarchar2(16)分类号NULL分类的标记（物料编码前几位，ERP写）【ERP表：T_MATERIAL】存在ERP库中中间表字段名称字段类型字段描述TCM字段名称说明Fmaterialnovarchar2(32)物料编码item

12、_id（主键）非空Fmaterialnamevarchar2(64)物料名称object_name非空fstatevarchar2(16)状态c3_status正常、废除（不可用）FSOURCEvarchar2(32)来源c3_sourceFMODELvarchar2(80)型号c3_typeFSPECVARCHAR2(30)规格c3_specFCZVARCHAR2(30)材质c3_czFCHARTNOVARCHAR2(30)图号c3_drawing_noFINVUNITIDVARCHAR2(32)计量单位c3_unitFNETWEIGHTNUMBER净重c3_suttleFGROSSWEIG

13、HTNUMBER毛重c3_grossweightfnotevarchar2(256)备注c3_remarkfmaterialidint物料内码NULL3.3.3.2 工具编码同步写入系统读取系统中间表读取条件参数参数取值ERPPDM（TC）T_ERPTOOLSFSTATUS= 0FSTATUS0或1备注FSTATUS(0待处理，1已处理)，FDISPOSE(0新增、1更新)表结构说明：3.3.3.3 工作中心同步写入系统读取系统中间表读取条件参数参数取值ERPPDM（TC）T_ERPPLANTSFSTATUS= 0FSTATUS0或1备注FSTATUS(0待处理，1已处理)，FDISPOSE(

14、0新增、1更新)表结构说明工作中心信息【T_ERPPLANTS】中间表字段名称字段类型字段描述TCM字段名称说明FWORKSHOPvarchar2(32)厂房item_id非空（TCM中维护）FPRODLINEvarchar2(64)生产线object_name非空（TCM中维护）FSTATUSchar(1)状态NULL非空，0待处理，1已处理FDISPOSEchar(1)处理方式NULL非空，0新增、1更新FNUMBERVARCHAR2(30)工作中心编码（主键）非空FNAMEVARCHAR2(64)工作中心名称非空3.3.3.4 工装价格同步写入系统读取系统中间表读取条件参数参数取值ERP

15、PDM（TC）T_TCMTOOLINGS无备注读取中间表的所有数据单个物料价格查询ERP查询语句：（根据物料ID查询的单个物料价格）selecttop 1 t_purcinvoiceItems.Famount/t_purcinvoiceItems.Fqty as pricefrom t_purcinvoice with(nolock)join t_purcinvoiceItems with(nolock)on t_purcinvoice.FpurInvoiceID = t_purcinvoiceItems.FpurinvoiceID join t_purivtype tpt with(nolo

16、ck)on tpt.Fpurivtype=t_purcinvoice.FTRANSTYPE where(selectcount(1)from t_purcinvitemchild where finstrockid=1064 and t_purcinvitemchild.Frow=t_purcinvoiceItems.frowid and t_purcinvitemchild.FpurinvoiceID=t_purcinvoiceItems.FpurinvoiceID)=0 and tpt.Fisest=0 and tpt.FicDoctype=0 and tpt.frefmode=0 and

17、convert(varchar(10),t_purcinvoice.Fdate,21)= lyearst andconvert(varchar(10),t_purcinvoice.Fdate,21)=2 and t_purcinvoice.fred=0 orderby t_purcinvoice.Fdate desc3.3.3.5 系统物料接口1. 接口需求：2. 由于物料数据都是在ERP中进行申请定义的，PDM设计系统需要从ERP中读取物料数据，进行设计BOM的开发，这种接口方式可以避免PDM系统与ERP系统物料信息部统一，一料多码，造成后期的工艺BOM、制造BOM数据不准确。3. 接口实现

18、方式：4. ERP系统提供视图，供PDM系统进行访问。5. 详情：6. ERP视图：共三个。具体的语句参照SQL数据库。其中：7. V_Mtview表示查询出ERP系统中物料状态=未作废 and 物料编码长度在7-10位 and 物料来源=外购件 and 物料编码第一个字符为数字的物料。8. V_Mtview_cl表示查询出ERP系统中物料状态=未作废 and 物料编码长度在7-10位 and 物料来源=外购件 and 物料编码第一个字符为数字 and 物料编码的前两个字符不等于28的物料。9. V_Mtview_jgj表示查询出ERP系统中物料状态=未作废 and 物料编码长度在7-10位

19、and 物料来源=外购件 and 物料编码的前两个字符in(28, 36, 17, 15, 16, 34, T2, T3, T1, 14, 29, 33, 77, 13, 11, 32, 99, 30, 40, 50, 35, 08, 69)。ERP定义的PDM访问方式：视图属性结构：【V_Mtview】字段名类型描述物料编码varchar（30）物料名称varchar（112）材质varchar（142）型号规格varchar（111）技术标准varchar（80）备注图号varchar（30）单重decimal(18,4)计量单位varchar（10）物料分类varchar（80）fsou

20、rcetinyint0外购1自制2虚拟expr1varchar(2)物料编码第一位【V_Mtview_cl】字段名类型描述物料编码varchar（30）物料名称varchar（142）材质varchar（30）型号规格varchar（111）技术标准varchar（80）备注varchar（30）单重decimal(18,4)计量单位varchar（10）物料分类varchar（80）fsourcetinyint0外购1自制2虚拟expr1varchar(2)物料编码第一位【V_Mtview_jgj】字段名类型描述物料编码varchar（30）物料名称varchar（112）材质varchar

21、（30）型号规格varchar（111）技术标准varchar（80）备注varchar（10）单重decimal(18,4)计量单位varchar（10）物料分类varchar（80）fsourcetinyint0外购1自制2虚拟expr1varchar(2)物料编码第一位3.3.3.6 采购的设备数据和资本性支出采购订单明细ERP与EAM（设备管理），EAM读取ERP里面的采购的设备数据条件：读取所有数据【资本性支出采购订单表头】ERP(T_Capital_Proorder_H)字段类型字段描述说明Fidint单据内码主键Ftypeint单据类型T_Capital_Proorder_Typ

22、e.FidFBillNoVarchar(30)单据编码FDateDatetime单据日期默认等于编辑日期FVendidint供应商IDt_supplier.finteridFPactNoVarchar(255)合同号Fstatesmallint单据状态0编辑，2审核FCurrentCheckLevelsmallint当前审核级别Fopidint编辑人IDT_user.finteridFopDateDatetime编辑日期FPIDateDatetime提交日期Fcheckeridint审核人IDT_user.finteridFcheckDatedatetime审核日期FCurrentChecks

23、tatesmallint当前审核状态Fbztext备注【资本性支出采购订单明细】ERP(T_Capital_Proorder_D)字段类型字段描述说明Fidint单据内码T_Capital_Proorder_H.fidFrowint行号与FID联合主键FPuridint预算计划单IDT_Capital_Purrequest_H.fidFpurRowint预算计划单行号T_Capital_Purrequest_D.frow（T_Capital_Purrequest_H.fid= T_Capital_Purrequest_D.fid）FmemoVarchar(255)项目描述Fqtyint数量Fp

24、riceDecimal(15,6)单价FAmountDecimal(15,2)金额FTaxTypeVarchar(3)税类t_taxtype.ftaxtypeFTaxRateDecimal(8,5)税率FTaxDecimal(15,2)税额FNoTaxPriceDecimal(15,6)不含税单价FNoTaxAmountDecimal(15,2)不含税金额FplanAmountDecimal(15,2)预算计划金额FBzVarchar(200)备注FCreateCardtinyint是否建卡0不建1建（固定资产卡片）3.3.3.7 ERP物料最新发票价查询根据物料ID查询的单个物料最新发票价格：(查询语句如下)select top 1 t_purcinvoiceItems.Famount/t_purcinvoiceItems.Fqty as price from t_purcinvoice with(nolock) join t_purcinvoiceItems with(nol