NC客户化开发详细分析设计说明书

XXXX系统机密

________项目

客户化开发详细分析设计说明书

建立日期:2013-01-01

文控编号:YY_XX（NC/OTH）_XX（项目编码）-01（阶段序号）_XXX（流水号）

作者:XXXX

客户项目经理：_____________________________

日期：______________________________

用友项目经理：_____________________________

日期：

客户logo用友

yonyou

文档信息

项目编号编号代码文档编号文档代码

项目名称

标题

类别（维护文档、需求文档、设计文档、验收文档、开发文档）

当前阶段需求规划、分析设计、系统架构、实施交付、持续支持等

摘要

文档拥有者NC客开支持与管理部

文件XXXX.doc

修改记录

日期版本作者修改内容

2013-01-011.0张三初始版本

审阅记录

日期版本姓名职位备注

2013-01-011.0张三

客户logo用友

yonyou

审批记录

日期版本姓名职位签名

2013-01-011.0张三

客户logo用友

yonyou

目录

1.弓I言..........................................................................................6

1.1项目名称..................................................................................6

1.2项目背景和内容概要.......................................................................6

13相关资料、缩略语、定义..................................................................6

1.4目标......................................................................................6

1.5范围......................................................................................6

1.6假定条件与约束限制.......................................................................6

2.XXXX管理业务组件削........................................................................7

3.命名空间约定..................................................................................8

3.1XXXX开发组件...........................................................................8

■开发组件元数据文件、国际化资源文件命名.............................................8

■类命名空间...........................................................................8

4.组件设计.....................................................................................11

4.1[XXXX]开发组件..........................................................................11

■XXXX开发组件关系图...............................................................11

■实体组件设计.......................................................................13

■操作组件t比十.......................................................................14

■服务组件谢十.......................................................................19

■(JI组件蚓........................................................................23

■业务活动建模.......................................................................27

客户logo用友

yonyou

■特征集..............................................................................28

客户logo用友

yonyou

1.引言

1.1项目名称

1.2项目背景和内容概要

L3相关资料、缩略语、定义

Ju。

1.4目标

1.5范围

1.6假定条件与约束限制

客户logo用友

yonyou

2.XXXX管理业务组件设计

本业务组件与其它业务组件的关系如下图:

电采购申诘管理业务组件《中采购交易订单管理业务蛆件

中SCMiS购单所雇业务组件

电采购预案管理业务组件

电采购方案及寻源业务蛆件

如图所示,采购申请管理业务组件与其他业务组件关系如下:

1.采购预案可由采购申请受理单拉式生成。

2.采购方案也可直接由采购申请单受理拉式生成。

3.采购申请管理业务组件采购申请受理单可调用采购交易订单管理业务组件接口推式生成采购订单。

4.SCM请购单可以推式生成采购申请受理单。

客户logo用友

yonyou

3.命名空间约定

本业务组件内包含《采购申请受理》一个开发组件。开发组件命名空间为purapply。其它命名规则遵守命

名规范文档。

其元数据文件、国际化资源文件、类命名空间设计如下:

3.1XXXX开发组件

方发组件元数据文件、国际化资源文件命名

业务组件中文名及英文名开发组件中文名及英文名元数据文件国际化资源文件

采购申请管理(purapplymgr)采购申请受理(purapply)purapply.bmfperties

purapplybpf.bpf

|类命名空间

Iciient目录下命名空间

客户端dient目录下包括UI视图类、编辑事件处理类、按钮事件监听类和模型类等。如下图：5个末

级目录中model下为模型类、edit下编辑事件类、view下为列表卡片视图类、config下为配置文件、

actions下为操作类。

客户logo用友

yonyou

3亡Iclient

B亡］nc

亡1ui

BDebpur

BDpurapply

由口model

由••Dedit

由-Qview

Dconfig

由mactions

Public目录下命名空间

公共public目录下主要包括校验类、VO类和服务接口类等代码。如下图：

三个末级目录分别为V。类、service接口、校验类命名空间。

日亡］public

BDnc

£}•尸1vo

［白亡］ebpur

由•亡］purapply

BD吁

:自亡］ebpur

自亡）purapply

由亡|service

E5,亡］bs

自口ebpur

白白purapply

由亡）validator

private目录下命名空间

私有private目录下包括相关动作类、服务实现类，如下图：两个末级目录分别为service实现类、

审批动作类命名空间。

客户logo用友

yonyou

m亡1private

E｝亡］nc

日亡1impl

日亡］ebpur

B亡］purapply

由Oservice

日Dbs

Q亡］pub

L-亡］action

客户logo用友

yonyou

4.组件设计

本业务组件包含一个开发组件：采购申清受理开发组件。

4.1[XXXX]开发组件

|xxxx开发组件关系图

采购申请管理业务组件下只有一开发组件：采购申请受理。采购申请受理开发组件可以自制,也可来源于

SCM领域请购单（采用推式生成方式入采购申请受理维护需求采购部门的具体采购产品清单及推荐供应商。

审核通过的采购申请受理可以指定供应商或匹配合同协议报价生成采购订单，或走寻源流程为后续采购预案、

采购方案所用。本业务组件推式生成采购订单的过程,大部分V。对照以及数据处理规则均可通过业务流程配

置完成处理。

采购申请受理开发组件包括采购申请受理实体组件、采购申请受理操作组件、采购申请受理服务组件、采

购申请受理业务活动组件、采购申请受理UI组件。采购申请受理相关开发组件关联其它业务组件的相关组件如

下图:

客户logo用友

yonyou

,采购申请受理实体组件

飞

上图关键业务如下:

•SCM请购单可以依据业务流配置推式生成采购申请受理单,在完成V。交换后,调用采购申请受理服

务组件相关接口,保存推式生成的采购申请受理单。

其中黄色部分EC系统其它业务组件:

•采购预案可以依据业务流配置,调用采购申请受理UI组件的查询UI,依据业务流程处理进行VO交

•采购方案可以依据业务流配置,调用采购申请受理UI组件的查询UI,依据业务流程处理进行VO交

换，拉式生成采购方案。

•采购申请受理操作组件可依据业务流程配置,完成VO交换后,调用采购交易订单服务组件接口

IPurOrderWsService推式生成采购交易订单。

客户logo用友

yonyou

实体组件设计

实体组件设计一共分为采购申请受理单、采购申请受理明细、采购申请受理一推荐供应商3个实体，分

别为主、子、孙关系。元数据文件属性信息如下图:

•-,1r-ri

PropertyValue

日Mise

连接线路由手动

日基本

ID7a42a857-c726-49f6-8ed5-277e2f.

版本号130

创建人

创建时间2010-03-1815:48:13

代码风格HC传统样式

多语资源模块名purapply

扩展标签

描述

名称purapply

名称空间ebpur

是否预加载false

所属模块ebpur

显不名称采购申谙受理单

修改人

修改时间2010-04-1911:18:02

主实体采购申请受理单

采购申请受理主要实现了审批流接口,见下图:

客户logo用友

yonyou

«实体分«实体分

采购申谙受理单采购申请受理明细K做举〉耐用）

单据状态

习，采购申请受理ID㈢？采购申请受理..・

_r审批未通过

口所属集团方源头单据类型

_7审批通过

求*所属蛆织jf源头单据号

」•审批进行中

»丁版本主组织土源头单据主表工D

«实体》」■提交

_r采购申请受理编号」源头单据子表工D采购申请受.…

丁自由一

口单据类型源头交易类型

力产品推荐...

产单据状态如r产品分类主键

’r产品分类

与审核时间臣产品主槌

审采购申请受理名称立单位产产品

yr产品版本

别采购申请受理部门h申请数量i..n

供应商类型

启采购申请受理人21预计单价

“T内部供应商

声而种?金额

?外部供应

货预算总金额前需求组织

J外部供应

者备注，需求部门

山外部供应...

，r创建人3*需求日期＜也举》

不植苓理由是否关闭

,告创建时间白项目

窜制单人jr生产厂商3^^~~

寺制单时间寸质量等级方打开

再修改人_r累计采购数量

有4修改时间小不是否行关闭

除作组件设计

操作组件包括两种类型的操作:

-：与UI按钮相对应的操作,此部分在服务端代码可能体现也可能不体现,但是作为操作设计注册,

供权限系统进行操作权限、业务活动权限配置的元数据使用。

-:业务处理对应的操作,此部分可能体现为UI,可能体现为后台服务。用与控制服务操作权限的处

理。

三：操作组件与服务组件的关系：操作组件是全集。操作组件内部分操作可以对外发布为服务,构成

服务组件.

客户logo用友

yonyou

I操作建模

«Inter£ace»

采购申请受理<<Cliiterface»

采购申请受理产品明细

V新增

V增行（产品）

弋修改

-S插入行（产品）

-S删除

V复制行（产品）

-S保存

噌删行（产品）

7复制

弋粘贴行（产品）

V查询

■：粘贴行到表尾（产品）

唯刷新»

弋取消

弋提交

7取回

7审批«Inter£ace>>

采购申谙受理推荐供应商

7取消审批

"联查采购预案V增行（供应商）

7联查采购方案7插入行（供应商）

7联查订单V册行（供应商）

7整单打开"拷贝（供应商）

"整单关闭V粘贴（供应商）

7行打开V附件管理

飞行关闭7保存

7指定供应商7删除

7匹配合同协议V取消

7生成订单

7导入

弋导出

弋预览

7打印

客户logo用友

yonyou

《业务操作》「《业务操作》《业务操作>>

维护采购申涛受理审批采购申谙受理打开关闭采购申请受理单及明细

4整单打开

卜|取消审批

用修改g整单关闭

4删除g联查采购预案行打开

同联查采购方案

g保存Z行关闭

m复制h联查采购订单

4查询

4刷新

4取消

4提交

4取回

«业务操作》«业务操作>>

4导入指定供应商生成订单匹配合同协议生成订单

x导出

4指定供应商X匹配合同协议

X预览

4生成订单4生成订单

m打印

如上图所示，操作接口分别为：采购申请受理、采购申请受理产品明细、采购申请受理推荐供应商，分别基于

前述3实体而建立。基于此3操作接口生成5个图示业务操作。

操作规则描述:详见需求文档《立项.doc》

操作接口操作名称引用服务/组件影响实体描述

（*为外部业务组件服务）

采购申请受理新增无

修改无

删除更新采购受理主实体的删除标志

保存无

复制调用采购申请受理服务复制数据并新增采购申请受理实

体

查询无

刷新无

客户logo用友

yonyou

取消无

提交更新采购申请受螂务更新采购申请受理主实体的单据

状态属性

取回更新采购申请受理服务更新采购申请受理主实体的单据

状态属性

审批更新采购申请受理服务更新采购申请受理主实体的单据

状态属性

取消审批更新采购申请受理服务更新采购申请受理主实体的单据

状态属性

联查采购预案

联查采购方案

联查采购订单

整单打开更新采购申请受理服务更新采购申请受理主实体的单据

状态属性

整单关闭更新采购申请受理服务更新采购申请受理主实体的单据

状态属性

行打开

行关闭

指定供应商*调用供应商所属业务组件

VO及服务

客户logo用友

yonyou

匹配合同协议*调用合同协议业务组件内

V。及服务

生丁单*调用采购订单业务组件服务

导入

导出

预览

打印

采购申请受理产品增行（产品）

明细

插入行（产品）

复制行（产品）

删行（产品）

粘贴行（产品）

粘贴行到表尾（产品）

采购申请受理推荐增行（供应商）引用推荐供应商实体

供应商

插入行（供应商）引用推荐供应商实体

删行（供应商）引用推荐供应商实体

拷贝（供应商）引用推荐供应商实体

粘贴（供应商）引用推荐供应商实体

附件管理引用推荐供应商实体

客户logo用友

yonyou

跖引用推荐供应商实体

删除引用推荐供应商实体

取消引用推荐供应商实体

I服务组件设计

I服务接口设计

PurApplyWsServicelmpI

IPurApplyWsService

本处仅描述关键服务，参见上图及下述内容:

序号服务名称简要描述

1回写累计采购数量供采购预案、采购方案、采购订单回写采购申请受理表体"累计

采购数量"字段。

2生成采购申请受理单供SCM请购单调用生成EC采购申请受理单。

3删除采购申请受理单SCM取消发布、即删除采购申请受理单。

客户logo用友

yonyou

上述序号为2、3两个服务接口涉及到SCM与EC交互接口,详细实现参见本文档4.L4.2章节描述。

|xxxx与XXXX接口设计

本开发组件与SCM中请购单之间进行接入,本部分需求的详细描述详见《NC-ERP接口部分doc》

文档。

本章描述接口部分相关设计。

需要说明的是,需求中关于数据补全的处理方式的描述,结合NC目前的架构模型以及相关要求,并

从业务职能区分的角度,再详细设计中进行实现方式的划分。本部分与需求描述中差异以详细削为准.

.1接口功能用例

接口功能用例如下图所示：

如图所示,EC与SCM接入的接口用例主要分为:

■SCM系统（本处仅列出部分处理,供参考理解不作具体实现约束或理解）

客户logo用友

yonyou

■发布请购单到EC:SCM使用业务流程将请购单推式推送到EC采购申请单中。

■取消发布到EC的请购单:SCM使用调用EC本组件服务,删除发布的采购申请单,并

根据删除结果进行相关处理,控制事务。

.2接口用例实现设计

EC与SCM的接口接入实现,主要基于UAP业务流程平台以及基于事件的扩展机制来实现。

本设计对于实现的基础描述如下:

■只考虑对于EC与SCM集成部署的情况。对于EC与SCM的分布部署时的数据同步机制，由NC

系统基础平台统一考虑分布式系统数据的同步问题。

■目前本部分的实现考虑基于现有UAP平台支撑的实现机制,与EC系统与其它ERP系统（例如

ORACLE、SAP平台）的领域依赖层的实现，本处仅做描述，不作实现。

.2.1XXXX接口实现设计

客户logo用友

yonyou

如图所示：右侧部分(接口及灰色部分)为EC系统处理。

左侧部分为SCM部分处理,其中这部分描述仅做描述,不作为相关实现依据或要求。

接口名称:IPurApp/yWsService

接口参数：采购申请受理单1/。

接口实现调用逻辑:

本业务接口为实现SCM调用EC领域提供服务发布请购单从而生成EC采购申请受理单。如图示:

请购单操作员在SCM点击"发送请购单到EC：将根据系统中业务流配置好的V。转换规则生成EC

采购申请受理单VO,之后更新SCM请购单状态并发布请购单到EC,此时将调用EC领域提供的服

务,EC领域内处理时将判断是否符合业务规则,进行业务逻辑校验通过后,如符合推式生单要求,则

调用EC服务,进行相关持久化操作生成采购申请受理单。

2.XXXX与XXXX数据V0转换规则：

源单据：请购单(SCM)

目的单据：采购申请受理单(EC)

目的单据栏目源单据栏目约束或规则

所属集团表头.所属集团

受理采购组织空

需求组织*表头.库存组织

请购单号*表头.请购单号

请购单行ID请购单行ID

产品分类编码*由物料编码自动带入

产品分类名称