企业数据接口管理规范V10Word文档格式.docx

1、6 MDM主数据包含范围6.1 组织架构：包含公司及部门信息6.2 岗位：包含岗位及岗位部署信息6.3 人员基本信息6.4 客户基本信息6.5 产品基本信息6.6 供应商基本信息7 第三方系统与ESB对接流程7.1 调研：确定需要与哪些主数据进行对接，一般情况下组织、岗位、人员数据是必须进行对接的，其他视系统业务而定。7.2 设计：接口细节分析，确定对接规则（对接时机：实时/定期；对接方式：完全同步/条件同步/选择同步；输入输出：字段对应关系、转换关系）。7.3 开发：7.3.1 MDM作为数据源：当MDM中的数据发生变化时，ESB会主动将变更后的数据进行分发，如果第三方系统需要这些主数据，就

2、必须提供相应的WebService接口让ESB调用，第三方提供的WebService需要符合ESB规范要求（请参考附件三第三方系统与ESB对接开发规范），并根据自身系统的逻辑对接收的数据进行解析和处理，同时第三方系统应关闭主数据操作权限，只保留扩展属性的维护，以保证与MDM同步。7.3.2 第三方系统作为数据源：需要调用ESB提供的WebService将数据写入到MDM（请参考附件二ESB接口调用说明）。7.3.3 第三方系统可调用ESB提供的WebService查询MDM数据。7.4 测试：包括内部测试和集成测试。7.5 上线：接口测试通过后进行数据初始化并部署上线（对于在用的系统需要对历史

3、数据进行同步调整）。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项目组负责制定、解释

4、及修改。本规范自发布之日起生效。石家庄星光股份有限公司二一五年十一月附件1 MDM数据库设计公司表（BAS_BASIC_COMPANY）字段名类型（长度）描述备注IDNUMBER序列号COMPNAMEVARCHAR2（255）公司名称PID上级公司MORDER序号COMPENNAME公司英文名称COMPCODEVARCHAR2（100）公司代码AREAID所属地区STATUSVARCHAR2（20）状态（启用/禁用）HRIDVARCHAR2（50）HR系统ID部门表（BAS_BASIC_DEPT）DEPTNAME部门名称父部门ID排序COMPID所属公司DEPTCODEVARCHAR2（200

5、）部门编号DEPTENNAME部门英文名称FULLNAME全名ISDELETEVARCHAR2（2）是否删除y为删除岗位表（BAS_BASIC_POSITION）POSNAME职位名称POSCODE职位代码POSNAMEEN职位英文名POSN_STATUSVARCHAR2（52）职位状态（启用/禁用）岗位部署表（MDM_CPCJOBCODETODEPT）JOBDEPTIDVARCHAR2（60）DEPTID部门IDJOBCODEID职位IDIS_DIRECTORVARCHAR2（10）是否负责人岗位IS_CORE是否核心职位ISDELETED启用状态FLAG同步标记UPDATEDATEDATE

6、更新时间IS_MKEMAIL是否创建邮箱员工信息表（EMPLOYEE）EMPUID员工UIDEMPID员工工号CNNAME中文名称ENNAME英文名称EMAIL邮件SYN_INDEX正常为0，新增为1，更新为2IS_DELETEDVARCHAR2（1）逻辑删除标识OFFICEPHONE办公室电话MOBILEPHONEVARCHAR2（30）手机号码REMARKVARCHAR2（2000）POSTID所属职位IDSUPERIOR主管/上级所属部门IDSEX性别OPERATINGTIME操作时间GENDER操作人HR人员ID产品表（MDM_GOODS）PRODCODE商品编码PRODNAME商品名

7、称PRODTYPE商品类型PRODSPEC规格是否禁用UPDATETIME更新日期客户信息表（MDM_CUSTOMER）OrgCode编码OrgName名称CustomerType客户类型客户分三类：商业、医院、药店HosType医院类型/商业类别HosLevel医院级别/药店级别/商业级别NationLevel国家级别RegionName省份代码CityName城市代码DATA供应商表（MDM_SUPPLIER）VARCHAR2（44）FID财务系统IDFCREATORID创建者FCREATETIMEDATETIME创建时间FLASTUPDATEUSERID最后修改者FLASTUPDATET

8、IME最后修改时间FNUMBERVARCHAR2（80）供应商编码CUSTOMER供应商名称FSIMPLENAME简称FARTIFICIALPERSON法人代表FBROWSEGROUPID供应商基本分类FBUSIEXEQUATUR生产经营许可证FBIZREGISTERNO工商注册号FBUSILICENCE营业执照FCITYID城市FCOUNTRYID国家FGSPAUTHENTICATIONGSP认证FINDUSTRYID行业FISINTERNALCOMPANYNUMBER（10）是否集团内公司FPROVINCEID省FREGIONID区FTAXDATAID税务资料FTAXREGISTERNO税

9、务登记号FEFFECTEDSTATUS生效状态FFOREIGNNAME外文名称FADMINCUID管理组织FADDRESSVARCHAR2（500）地址FISCARRIER是否承运商FISOUTER是否委外Web服务表（MDM_WEBSERVICE）WS_URLVARCHAR2（1000）服务URLWS_TYPE数据类型IDWS_METHOD服务方法名WS_TABLENAME数据表名称WS_TABLEKEY数据表关键字段WS_SYSTEM应用系统名称数据分发表（MDM_WS_SYS）日志表（MDM_ERROR_INFO）SYS_INFO系统信息ERROR_INFOVARCHAR2（4000）报

10、错信息UPDATE_TIME默认系统时间附件2 ESB接口调用说明1. 更新接口1.1 人员信息服务名称新增、修改MDM人员信息服务标识InsertOrUpdateEMPLOYEE服务提供者ESB服务测试地址http:/172.16.7.111:7001/WP_OA_MDM/Proxy_Services/ReceiveEmployeeService_PS?wsdl服务描述接收传入参数，根据工号判断MDM中是否存在该人员、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明输入参数参数名称参数类型说明String工号主键NAME姓名邮箱手机在职状态

11、试用/正式/退休/离职/调出/提拔/未接受/兼任待转入/不在职/调出待转入Number岗位ID状态Y/N 逻辑删除标识Date数据插入或更新时间输出参数RESULT调用结果例：Success：数据插入成功；Error：数据更新失败，失败原因是：.请求xml返回xml1.2 客户资料新增、修改MDM客户信息InsertOrUpdateCUSTOMER7001/WP_MDM/Proxy_Services/ReceiveCustomerService_PS?接收传入参数，根据客户编号判断MDM中是否存在该客户、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返

12、回错误说明ORGCODE客户编号ORGNAME客户名称CUSTOMERTYPE（商业/医院/药店）HOSTYPE医院类型/商业级别HOSLEVELNATIONLEVELREGIONNAME省份名称CITYNAME城市名称（0：正常；-1：失效）1.3 产品资料新增、修改MDM产品信息InsertOrUpdateGOODSReceiveGoodsService_PS?接收传入参数，根据商品编号判断MDM中是否存在该商品、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明商品编号PRODABBR缩写PACKAGING小包装DOSAGEFORM剂型B

13、RAND品牌（注册商标）CATEGORY类别ISPRESCRIPTIONDRUGS是否处方药UNIT计量单位CRMCODECRM编码CRMCLASSIFICATIONCRM分类EASCODEEAS编码EASCLASSIFICATIONEAS分类1.4 供应商资料新增、修改MDM供应商信息InsertOrUpdateSUPPLIERReceiveSupplierService_PS?接收传入参数，根据供应商编号判断MDM中是否存在该供应商、如果存在就执行修改操作，如果不存在则执行新增操作，处理完成后返回处理结果，如果执行失败，返回错误说明供应商分类是否集团内管理组织地址2. 查询接口2.1 组织机构查询MDM组织机构数据selectMDMDept_PS7001/WP_MDM_SEL/Proxy_Services/SelectMDM_Dept_PS?根据传入的条件参数将查询结果返回给调用者查询条件查询结果参