企业数据接口管理规范V10Word文档格式.docx
《企业数据接口管理规范V10Word文档格式.docx》由会员分享，可在线阅读，更多相关《企业数据接口管理规范V10Word文档格式.docx（38页珍藏版）》请在冰豆网上搜索。
6MDM主数据包含范围
6.1组织架构：
包含公司及部门信息
6.2岗位：
包含岗位及岗位部署信息
6.3人员基本信息
6.4客户基本信息
6.5产品基本信息
6.6供应商基本信息
7第三方系统与ESB对接流程
7.1调研：
确定需要与哪些主数据进行对接，一般情况下组织、岗位、人员数据是必须进行对接的，其他视系统业务而定。
7.2设计：
接口细节分析，确定对接规则（对接时机：
实时/定期；
对接方式：
完全同步/条件同步/选择同步；
输入输出：
字段对应关系、转换关系）。
7.3开发：
7.3.1MDM作为数据源：
当MDM中的数据发生变化时，ESB会主动将变更后的数据进行分发，如果第三方系统需要这些主数据，就必须提供相应的WebService接口让ESB调用，第三方提供的WebService需要符合ESB规范要求（请参考附件三《第三方系统与ESB对接开发规范》），并根据自身系统的逻辑对接收的数据进行解析和处理，同时第三方系统应关闭主数据操作权限，只保留扩展属性的维护，以保证与MDM同步。
7.3.2第三方系统作为数据源：
需要调用ESB提供的WebService将数据写入到MDM（请参考附件二《ESB接口调用说明》）。
7.3.3第三方系统可调用ESB提供的WebService查询MDM数据。
7.4测试：
包括内部测试和集成测试。
7.5上线：
接口测试通过后进行数据初始化并部署上线（对于在用的系统需要对历史数据进行同步调整）。
7.6维护：
系统管理员应及时监控接口运行状态、跟踪处理异常情况、定期做数据备份。
8服务设计原则
8.1服务应具有精心选择的粒度。
8.2服务应是内聚而完整的。
8.3服务应对实现细节进行封装。
8.4服务要适应多种调用模式。
9接口技术规范及要求
9.1接口以WSDL标准描述的WebService形式发布。
9.2接口传输采用HTTP通讯协议，支持SOAP访问协议。
9.3接口中传递的数据使用XML格式封装。
9.4接口在性能上要做到实时性强、响应速度快、稳定性高、容错性好等特点。
9.5接口要确保数据安全性、保密性、一致性。
10附则
本办法由ESB项目组负责制定、解释及修改。
本规范自发布之日起生效。
石家庄星光股份有限公司
二〇一五年十一月
附件1MDM数据库设计
公司表（BAS_BASIC_COMPANY）
字段名
类型（长度）
描述
备注
ID
NUMBER
序列号
COMPNAME
VARCHAR2（255）
公司名称
PID
上级公司
MORDER
序号
COMPENNAME
公司英文名称
COMPCODE
VARCHAR2（100）
公司代码
AREAID
所属地区
STATUS
VARCHAR2（20）
状态（启用/禁用）
HRID
VARCHAR2（50）
HR系统ID
部门表（BAS_BASIC_DEPT）
DEPTNAME
部门名称
父部门ID
排序
COMPID
所属公司
DEPTCODE
VARCHAR2（200）
部门编号
DEPTENNAME
部门英文名称
FULLNAME
全名
ISDELETE
VARCHAR2
（2）
是否删除
y为删除
岗位表（BAS_BASIC_POSITION）
POSNAME
职位名称
POSCODE
职位代码
POSNAMEEN
职位英文名
POSN_STATUS
VARCHAR2（52）
职位状态（启用/禁用）
岗位部署表（MDM_CPCJOBCODETODEPT）
JOBDEPTID
VARCHAR2（60）
DEPTID
部门ID
JOBCODEID
职位ID
IS_DIRECTOR
VARCHAR2（10）
是否负责人岗位
IS_CORE
是否核心职位
ISDELETED
启用状态
FLAG
同步标记
UPDATEDATE
DATE
更新时间
IS_MKEMAIL
是否创建邮箱
员工信息表（EMPLOYEE）
EMPUID
员工UID
EMPID
员工工号
CNNAME
中文名称
ENNAME
英文名称
EMAIL
邮件
SYN_INDEX
正常为0，新增为1，更新为2
IS_DELETED
VARCHAR2
（1）
逻辑删除标识
OFFICEPHONE
办公室电话
MOBILEPHONE
VARCHAR2（30）
手机号码
REMARK
VARCHAR2（2000）
POSTID
所属职位ID
SUPERIOR
主管/上级
所属部门ID
SEX
性别
OPERATINGTIME
操作时间
GENDER
操作人
HR人员ID
产品表（MDM_GOODS）
PRODCODE
商品编码
PRODNAME
商品名称
PRODTYPE
商品类型
PRODSPEC
规格
是否禁用
UPDATETIME
更新日期
客户信息表（MDM_CUSTOMER）
OrgCode
编码
OrgName
名称
CustomerType
客户类型
客户分三类：
商业、医院、药店
HosType
医院类型/商业类别
HosLevel
医院级别/药店级别/商业级别
NationLevel
国家级别
RegionName
省份代码
CityName
城市代码
DATA
供应商表（MDM_SUPPLIER）
VARCHAR2（44）
FID
财务系统ID
FCREATORID
创建者
FCREATETIME
DATETIME
创建时间
FLASTUPDATEUSERID
最后修改者
FLASTUPDATETIME
最后修改时间
FNUMBER
VARCHAR2（80）
供应商编码
CUSTOMER
供应商名称
FSIMPLENAME
简称
FARTIFICIALPERSON
法人代表
FBROWSEGROUPID
供应商基本分类
FBUSIEXEQUATUR
生产经营许可证
FBIZREGISTERNO
工商注册号
FBUSILICENCE
营业执照
FCITYID
城市
FCOUNTRYID
国家
FGSPAUTHENTICATION
GSP认证
FINDUSTRYID
行业
FISINTERNALCOMPANY
NUMBER（10）
是否集团内公司
FPROVINCEID
省
FREGIONID
区
FTAXDATAID
税务资料
FTAXREGISTERNO
税务登记号
FEFFECTEDSTATUS
生效状态
FFOREIGNNAME
外文名称
FADMINCUID
管理组织
FADDRESS
VARCHAR2（500）
地址
FISCARRIER
是否承运商
FISOUTER
是否委外
Web服务表（MDM_WEBSERVICE）
WS_URL
VARCHAR2（1000）
服务URL
WS_TYPE
数据类型ID
WS_METHOD
服务方法名
WS_TABLENAME
数据表名称
WS_TABLEKEY
数据表关键字段
WS_SYSTEM
应用系统名称
数据分发表（MDM_WS_SYS）
日志表（MDM_ERROR_INFO）
SYS_INFO
系统信息
ERROR_INFO
VARCHAR2（4000）
报错信息
UPDATE_TIME
默认系统时间
附件2ESB接口调用说明
1.更新接口
1.1人员信息
服务名称
新增、修改MDM人员信息
服务标识
InsertOrUpdateEMPLOYEE
服务提供者
ESB
服务测试地址
http:
//172.16.7.111:
7001/WP_OA_MDM/Proxy_Services/
ReceiveEmployeeService_PS?
wsdl
服务描述
接收传入参数，根据工号判断MDM中是否存在该人员、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明
输入参数
参数名称
参数类型
说明
String
工号
主键
NAME
姓名
邮箱
手机
在职状态
试用/正式/退休/离职/调出/提拔/未接受/兼任待转入/不在职/调出待转入
Number
岗位ID
状态
Y/N逻辑删除标识
Date
数据插入或更新时间
输出参数
RESULT
调用结果
例：
Success：
数据插入成功；
Error：
数据更新失败，失败原因是：
......
请求xml
返回xml
1.2客户资料
新增、修改MDM客户信息
InsertOrUpdateCUSTOMER
7001/WP_MDM/Proxy_Services/
ReceiveCustomerService_PS?
接收传入参数，根据客户编号判断MDM中是否存在该客户、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明
ORGCODE
客户编号
ORGNAME
客户名称
CUSTOMERTYPE
（商业/医院/药店）
HOSTYPE
医院类型/商业级别
HOSLEVEL
NATIONLEVEL
REGIONNAME
省份名称
CITYNAME
城市名称
（0：
正常；
-1：
失效）
1.3产品资料
新增、修改MDM产品信息
InsertOrUpdateGOODS
ReceiveGoodsService_PS?
接收传入参数，根据商品编号判断MDM中是否存在该商品、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明
商品编号
PRODABBR
缩写
PACKAGING
小包装
DOSAGEFORM
剂型
BRAND
品牌（注册商标）
CATEGORY
类别
ISPRESCRIPTIONDRUGS
是否处方药
UNIT
计量单位
CRMCODE
CRM编码
CRMCLASSIFICATION
CRM分类
EASCODE
EAS编码
EASCLASSIFICATION
EAS分类
1.4供应商资料
新增、修改MDM供应商信息
InsertOrUpdateSUPPLIER
ReceiveSupplierService_PS?
接收传入参数，根据供应商编号判断MDM中是否存在该供应商、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明
供应商分类
是否集团内
管理组织地址
2.查询接口
2.1组织机构
查询MDM组织机构数据
selectMDMDept_PS
7001/WP_MDM_SEL/Proxy_Services/
SelectMDM_Dept_PS?
根据传入的条件参数将查询结果返回给调用者
查询条件
查询结果
参
升级会员 