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

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

《南车电机ESB项目需求分析说明书.docx》由会员分享，可在线阅读，更多相关《南车电机ESB项目需求分析说明书.docx（56页珍藏版）》请在冰点文库上搜索。

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

南车电机ESB项目需求说明书

1.1参与人员

序号

名称

描述

负责人

1

PDM（TC）

产品数据管理系统

2

ERP

企业资源计划（金蝶）

3

HCM

人力资源管理信息系统

4

RTX

腾讯通

5

AD

域

6

TDM

试验数据管理系统

7

QS

质量信息管理系统

8

Portal

门户系统

9

OA

自动化办公系统

1.2目的与适用围

本文档规对南车株洲电机各业务系统的接口集成进行现状描述，用于ESB系统方案设计。

1.3相关术语

1.4参考资料

1.ERP系统服务接口资料：

企业服务总线（ESB）构建项目ERP调用文档（定稿）.doc

2.TDM系统服务接口资料:

TDM与TC集成方案_V05.doc

获取委托单接口基本信息（TC提供）_-_副本.docx

接口文档（TDM提供）.docx

3.PDM（TC）系统服务接口资料：

南车电机_Teamcenter-ERP数据同步设计方案_V04.doc

2项目总体情况

2.1系统整体交互图

Ps:

箭头指向的方向是请求的方向

2.2接口清单

Soap接口类型:

序号

系统

接口名称

协议类型

正式地址

是否接入

接口规文档

1

OA

获取待办

Soap

oa.motor.csr./indishare/indiwscenter.nsf/wsGetTodolist?

wsdl

是

2

OA

OA待阅

Soap

oa.motor.csr./indishare/indiwscenter.nsf/wsGetToReadlist?

wsdl

是

3

OA

OA

Soap

oa.motor.csr./indishare/indiwscenter.nsf/wsformail?

wsdl

是

4

HCM

HCM待办

Soap

hr.csr./OA/BASEUOSReadWebService?

UserID=#{userName}

是

5

PDM

获取实验大纲

Soap

10.168.0.29:

8889/TDM/services/UFCTDMSer?

wsdl

是

中间表类型

序号

写入系统

调用系统

接口名称

操作方式

服务器地址

是否接入

1

ERP

PDM（TC）

首次同步（读）

中间表

10.168.0.107

是

2

ERP

PDM（TC）

定时同步（读）

中间表

10.168.0.107

是

3

ERP

PDM（TC）

材料库编码同步

中间表

10.168.0.107

是

4

ERP

PDM（TC）

工具编码同步

中间表

10.168.0.107

是

5

ERP

PDM（TC）

工作中心同步

中间表

10.168.0.107

是

6

PDM（TC）

ERP

工装编码同步

中间表

10.168.0.107

是

7

ERP

PDM（TC）

工装价格同步

中间表

10.168.0.107

是

8

PDM（TC）

ERP

制造BOM新增修改

中间表

10.168.0.241

是

9

PDM（TC）

ERP

制造工艺新增修改

中间表

10.168.0.241

是

10

PDM（TC）

ERP

流程更改单

中间表

10.168.0.241

是

11

ERP

PDM

系统物料接口

表视图

10.168.0.107

是

12

ERP

EAM

采购的设备数据和资本性支出采购订单明细

中间表

10.168.0.107

是

13

ERP

K3

设备固定资产数据

中间表

10.168.0.107

是

14

ERP

供应商和客户数据

系统表

10.168.0.107

15

PDM

BOM数据

系统表

Ldap类型

序号

系统

调用系统

接口名称

操作方式

服务器地址

是否接入

1

AD域

TDM、企业

获取用户信息

JavaLdap

10.168.0.5

是

Asmx类型

序号

系统

调用系统

接口名称

操作方式

服务器地址

是否接入

1

RTX

OA

传入提醒消息

Java调用Asmx服务

10.168.0.102

是

3项目需求情况

3.1AD域系统

3.1.1系统接口交互图

AD域通过中间表的方式获取HCM的用户信息，TDM通过LDAP方式获取AD域人员信息。

Rtx和企业也是通过ldap的方式同步的AD域用户信息。

3.1.2环境说明

3.1.2.11.AD域的相关信息

接口名称

AD域服务器信息

接口作用

AD域服务器信息

服务器IP地址

10.168.0.5

端口

ldap389

url

motor.csr.

OU

OU=南车株洲电机,DC=motor,DC=csr,DC=

DC

10.168.0.5

测试用户名

admt

密码

pssw0rd

调用频度：

每天的凌晨（只限于hcm）

涉及的系统：

HCM、RTX、Mail、门户

3.1.3接口说明

RTX依据参数OU（组织单元）为参数来同步数据。

企业的用户会通过AD域做密码验证（0116开头的用户）

3.2HCM人力资源管理信息系统

3.2.1系统接口交互图

门户系统通过HTTP方式获取HCM的待办。

AD域通过中间表的方式获取HCM的人员信息

3.2.2环境说明

（待获取总部资料）

3.2.3接口说明

3.2.3.1HCM待办

方法名称

描述

门户获取HCM的待办

C#代码如下

Stringusername=Convert.ToBase64String（Encoding.Default.GetBytes（_UserName））;

stringserurl="hr.csr./OA/BASEUOSReadWebService?

UserID=#{userName}";

StringXmlMessage=serurl.Replace（"#{userName}",username）;

然后解析XmlMessage

服务器IP

接口协议类型

HTTP

服务器端口

发布路径

hr.csr./OA/BASEUOSReadWebService?

UserID=#{userName}

输入参数

参数名称

是否必填

参数说明

取值说明

UserId

是

用户名

输出参数

返回值类型

返回值

长度

说明

异常信息

描述文件

示例

HCM写入用户信息表的详情？

需要去找相关人员获取文档资料

3.3ERP企业资源计划（金蝶）

3.3.1系统接口交互图

ERP通过中间表的方式从PDM获取制造BOM，工艺BOM，工装等信息。

PDM通过中间表方式从ERP获取外购件，工具，工装单价，工作中心等信息。

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

服务器ip

10.168.0.56

数据库名

erp2tcm

用户名

allink

密码

password

系统

描述

TCM

西门子Teamcenter平台下的制造工艺管理模块

ERP

金蝶ERP管理系统

服务器ip

10.168.0.107

数据库名

allinkerp                     

用户名

erp_allink

密码

erpadminsql

3.3.3接口描述

3.3.3.1材料库编码同步

写入系统

读取系统

中间表

读取条件

参数

参数取值

ERP

PDM（TC）

T_ERPMATERIAL_TCM

FSTATUS=0

FSTATUS

0或1

备注

FSTATUS（0待处理，1已处理），FDISPOSE（0新增、1更新）

表结构说明：

【ERP材料库类物料信息表】：

T_ERPMATERIAL_TCM

（对应ERP表：

T_MATERIAL）物料编码修改时：

修改Fmaterialno、fmaterialid相同的行。

FSTATUS=1时将FDISPOSE置为1、FSTATUS置为0。

中间表字段名称

字段类型

字段描述

TCM字段名称

说明

FNUMBER

varchar2（32）

物料编码

item_id

（主键）非空

FNAME

varchar2（64）

物料名称

object_name

非空

FSTATUS

char

（1）

处理状态

NULL

非空，0待处理，1已处理

FDISPOSE

char

（1）

处理方式

NULL

非空，0新增、1更新

FC3STATUS

varchar2（16）

状态

c3_status

正常、废除（不可用）

FCATEGORY

varchar2（32）

所属类别

c3_category

FSOURCE

varchar2（32）

来源

c3_source

FMODEL

varchar2（80）

型号

c3_type

FSPEC

VARCHAR2（30）

规格

c3_spec

FCZ

VARCHAR2（30）

材质

c3_cz

FCHARTNO

VARCHAR2（30）

图号

c3_drawing_no

FUNIT

VARCHAR2（32）

计量单位

c3_unit

FSUTTLE

NUMBER

净重

c3_suttle

FGROSSWEIGHT

NUMBER

毛重

c3_grossweight

FREMARK

varchar2（256）

备注

c3_remark

FCLASSID

varchar2（16）

分类号

NULL

分类的标记（物料编码前几位，ERP写）

【ERP表：

T_MATERIAL】存在ERP库中

中间表字段名称

字段类型

字段描述

TCM字段名称

说明

Fmaterialno

varchar2（32）

物料编码

item_id

（主键）非空

Fmaterialname

varchar2（64）

物料名称

object_name

非空

fstate

varchar2（16）

状态

c3_status

正常、废除（不可用）

FSOURCE

varchar2（32）

来源

c3_source

FMODEL

varchar2（80）

型号

c3_type

FSPEC

VARCHAR2（30）

规格

c3_spec

FCZ

VARCHAR2（30）

材质

c3_cz

FCHARTNO

VARCHAR2（30）

图号

c3_drawing_no

FINVUNITID

VARCHAR2（32）

计量单位

c3_unit

FNETWEIGHT

NUMBER

净重

c3_suttle

FGROSSWEIGHT

NUMBER

毛重

c3_grossweight

fnote

varchar2（256）

备注

c3_remark

fmaterialid

int

物料码

NULL

3.3.3.2工具编码同步

写入系统

读取系统

中间表

读取条件

参数

参数取值

ERP

PDM（TC）

T_ERPTOOLS

FSTATUS=0

FSTATUS

0或1

备注

FSTATUS（0待处理，1已处理），FDISPOSE（0新增、1更新）

表结构说明：

3.3.3.3工作中心同步

写入系统

读取系统

中间表

读取条件

参数

参数取值

ERP

PDM（TC）

T_ERPPLANTS

FSTATUS=0

FSTATUS

0或1

备注

FSTATUS（0待处理，1已处理），FDISPOSE（0新增、1更新）

表结构说明

工作中心信息【T_ERPPLANTS】

中间表字段名称

字段类型

字段描述

TCM字段名称

说明

FWORKSHOP

varchar2（32）

厂房

item_id

非空（TCM中维护）

FPRODLINE

varchar2（64）

生产线

object_name

非空（TCM中维护）

FSTATUS

char

（1）

状态

NULL

非空，0待处理，1已处理

FDISPOSE

char

（1）

处理方式

NULL

非空，0新增、1更新

FNUMBER

VARCHAR2（30）

工作中心编码

（主键）非空

FNAME

VARCHAR2（64）

工作中心名称

非空

3.3.3.4工装价格同步

写入系统

读取系统

中间表

读取条件

参数

参数取值

ERP

PDM（TC）

T_TCMTOOLINGS

无

备注

读取中间表的所有数据

单个物料价格查询

ERP查询语句：

（根据物料ID查询的单个物料价格）

selecttop1t_purcinvoiceItems.Famount/t_purcinvoiceItems.Fqtyaspricefromt_purcinvoicewith（nolock）joint_purcinvoiceItemswith（nolock）ont_purcinvoice.FpurInvoiceID=t_purcinvoiceItems.FpurinvoiceIDjoint_purivtypetptwith（nolock）ontpt.Fpurivtype=t_purcinvoice.FTRANSTYPEwhere（selectcount

（1）fromt_purcinvitemchildwherefinstrockid=1064andt_purcinvitemchild.Frow=t_purcinvoiceItems.frowidandt_purcinvitemchild.FpurinvoiceID=t_purcinvoiceItems.FpurinvoiceID）=0andtpt.Fisest=0andtpt.FicDoctype=0andtpt.frefmode=0andconvert（varchar（10）,t_purcinvoice.Fdate,21）>=lyearstandconvert（varchar（10）,t_purcinvoice.Fdate,21）<=getdate（）andfmaterialid=物料IDandt_purcinvoice.festimate=0andIsNull（t_purcinvoice.Fisexpo,0）=0andt_purcinvoice.fstate>=2andt_purcinvoice.fred=0orderbyt_purcinvoice.Fdatedesc

3.3.3.5系统物料接口

1.接口需求：

2.由于物料数据都是在ERP中进行申请定义的，PDM设计系统需要从ERP中读取物料数据，进行设计BOM的开发，这种接口方式可以避免PDM系统与ERP系统物料信息部统一，一料多码，造成后期的工艺BOM、制造BOM数据不准确。

3.接口实现方式：

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位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）

fsource

tinyint

0外购1自制2虚拟

expr1

varchar

（2）

物料编码第一位

【V_Mtview_cl】

字段名

类型

描述

物料编码

varchar（30）

物料名称

varchar（142）

材质

varchar（30）

型号规格

varchar（111）

技术标准

varchar（80）

备注

varchar（30）

单重

decimal（18,4）

计量单位

varchar（10）

物料分类

varchar（80）

fsource

tinyint

0外购1自制2虚拟

expr1

varchar

（2）

物料编码第一位

【V_Mtview_jgj】

字段名

类型

描述

物料编码

varchar（30）

物料名称

varchar（112）

材质

varchar（30）

型号规格

varchar（111）

技术标准

varchar（80）

备注

varchar（10）

单重

decimal（18,4）

计量单位

varchar（10）

物料分类

varchar（80）

fsource

tinyint

0外购1自制2虚拟

expr1

varchar

（2）

物料编码第一位

3.3.3.6采购的设备数据和资本性支出采购订单明细

ERP与EAM（设备管理），EAM读取ERP里面的采购的设备数据

条件：

读取所有数据

【资本性支出采购订单表头】

ERP（T_Capital_Proorder_H）

字段类型

字段描述

说明

Fid

int

单据码

主键

Ftype

int

单据类型

T_Capital_Proorder_Type.Fid

FBillNo

Varchar（30）

单据编码

FDate

Datetime

单据日期

默认等于编辑日期

FVendid

int

供应商ID

t_supplier.finterid

FPactNo

Varchar（255）

合同号

Fstate

smallint

单据状态

0编辑，2审核

FCurrentCheckLevel

smallint

当前审核级别

Fopid

int

编辑人ID

T_user.finterid

FopDate

Datetime

编辑日期

FPIDate

Datetime

提交日期

Fcheckerid

int

审核人ID

T_user.finterid

FcheckDate

datetime

审核日期

FCurrentCheckstate

smallint

当前审核状态

Fbz

text

备注

【资本性支出采购订单明细】

ERP（T_Capital_Proorder_D）

字段类型

字段描述

说明

Fid

int

单据码

T_Capital_Proorder_H.fid

Frow

int

行号

与FID联合主键

FPurid

int

预算计划单ID

T_Capital_Purrequest_H.fid

FpurRow

int

预算计划单行号

T_Capital_Purrequest_D.frow

（T_Capital_Purrequest_H.fid=T_Capital_Purrequest_D.fid）

Fmemo

Varchar（255）

项目描述

Fqty

int

数量

Fprice

Decimal（15,6）

单价

FAmount

Decimal（15,2）

金额

FTaxType

Varchar（3）

税类

t_taxtype.ftaxtype

FTaxRate

Decimal（8,5）

税率

FTax

Decimal（15,2）

税额

FNoTaxPrice

Decimal（15,6）

不含税单价

FNoTaxAmount

Decimal（15,2）

不含税金额

FplanAmount

Decimal（15,2）

预算计划金额

FBz

Varchar（200）

备注

FCreateCard

tinyint

是否建卡

0不建1建（固定资产卡片）

3.3.3.7ERP物料最新发票价查询

根据物料ID查询的单个物料最新发票价格：

（查询语句如下）

selecttop1t_purcinvoiceItems.Famount/t_purcinvoiceItems.Fqtyaspricefromt_purcinvoicewith（nolock）joint_purcinvoiceItemswith（nolock）ont_purcinvoice.FpurInvoiceID=t_purcinvoiceItems.Fpurinvo