南车电机ESB项目需求分析说明书.docx
- 文档编号:26124575
- 上传时间:2023-06-17
- 格式:DOCX
- 页数:56
- 大小:486.74KB
南车电机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
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 电机 ESB 项目 需求 分析 说明书