NC客戶化開發(fā)詳細(xì)分析設(shè)計說明書

XXXX系統(tǒng)機(jī)密

________項(xiàng)目

客戶化開發(fā)詳細(xì)分析設(shè)計說明書

建立日期:2013-01-01

文控編號:YY_XX（NC/OTH）_XX（項(xiàng)目編碼）-01（階段序號）_XXX（流水號）

作者:XXXX

客戶項(xiàng)目經(jīng)理：_____________________________

日期：______________________________

用友項(xiàng)目經(jīng)理：_____________________________

日期：

客戶logo用友

yonyou

文檔信息

項(xiàng)目編號編號代碼文檔編號文檔代碼

項(xiàng)目名稱

標(biāo)題

類別（維護(hù)文檔、需求文檔、設(shè)計文檔、驗(yàn)收文檔、開發(fā)文檔）

當(dāng)前階段需求規(guī)劃、分析設(shè)計、系統(tǒng)架構(gòu)、實(shí)施交付、持續(xù)支持等

摘要

文檔擁有者NC客開支持與管理部

文件XXXX.doc

修改記錄

日期版本作者修改內(nèi)容

2013-01-011.0張三初始版本

審閱記錄

日期版本姓名職位備注

2013-01-011.0張三

客戶logo用友

yonyou

審批記錄

日期版本姓名職位簽名

2013-01-011.0張三

客戶logo用友

yonyou

目錄

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

1.1項(xiàng)目名稱..................................................................................6

1.2項(xiàng)目背景和內(nèi)容概要.......................................................................6

13相關(guān)資料、縮略語、定義..................................................................6

1.4目標(biāo)......................................................................................6

1.5范圍......................................................................................6

1.6假定條件與約束限制.......................................................................6

2.XXXX管理業(yè)務(wù)組件削........................................................................7

3.命名空間約定..................................................................................8

3.1XXXX開發(fā)組件...........................................................................8

■開發(fā)組件元數(shù)據(jù)文件、國際化資源文件命名.............................................8

■類命名空間...........................................................................8

4.組件設(shè)計.....................................................................................11

4.1[XXXX]開發(fā)組件..........................................................................11

■XXXX開發(fā)組件關(guān)系圖...............................................................11

■實(shí)體組件設(shè)計.......................................................................13

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

■服務(wù)組件謝十.......................................................................19

■(JI組件蚓........................................................................23

■業(yè)務(wù)活動建模.......................................................................27

客戶logo用友

yonyou

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

客戶logo用友

yonyou

1.引言

1.1項(xiàng)目名稱

1.2項(xiàng)目背景和內(nèi)容概要

L3相關(guān)資料、縮略語、定義

Ju。

1.4目標(biāo)

1.5范圍

1.6假定條件與約束限制

客戶logo用友

yonyou

2.XXXX管理業(yè)務(wù)組件設(shè)計

本業(yè)務(wù)組件與其它業(yè)務(wù)組件的關(guān)系如下圖:

電采購申詰管理業(yè)務(wù)組件《中采購交易訂單管理業(yè)務(wù)蛆件

中SCMiS購單所雇業(yè)務(wù)組件

電采購預(yù)案管理業(yè)務(wù)組件

電采購方案及尋源業(yè)務(wù)蛆件

如圖所示,采購申請管理業(yè)務(wù)組件與其他業(yè)務(wù)組件關(guān)系如下:

1.采購預(yù)案可由采購申請受理單拉式生成。

2.采購方案也可直接由采購申請單受理拉式生成。

3.采購申請管理業(yè)務(wù)組件采購申請受理單可調(diào)用采購交易訂單管理業(yè)務(wù)組件接口推式生成采購訂單。

4.SCM請購單可以推式生成采購申請受理單。

客戶logo用友

yonyou

3.命名空間約定

本業(yè)務(wù)組件內(nèi)包含《采購申請受理》一個開發(fā)組件。開發(fā)組件命名空間為purapply。其它命名規(guī)則遵守命

名規(guī)范文檔。

其元數(shù)據(jù)文件、國際化資源文件、類命名空間設(shè)計如下:

3.1XXXX開發(fā)組件

方發(fā)組件元數(shù)據(jù)文件、國際化資源文件命名

業(yè)務(wù)組件中文名及英文名開發(fā)組件中文名及英文名元數(shù)據(jù)文件國際化資源文件

采購申請管理(purapplymgr)采購申請受理(purapply)purapply.bmfperties

purapplybpf.bpf

|類命名空間

Iciient目錄下命名空間

客戶端dient目錄下包括UI視圖類、編輯事件處理類、按鈕事件監(jiān)聽類和模型類等。如下圖：5個末

級目錄中model下為模型類、edit下編輯事件類、view下為列表卡片視圖類、config下為配置文件、

actions下為操作類。

客戶logo用友

yonyou

3亡Iclient

B亡］nc

亡1ui

BDebpur

BDpurapply

由口model

由??Dedit

由-Qview

Dconfig

由mactions

Public目錄下命名空間

公共public目錄下主要包括校驗(yàn)類、VO類和服務(wù)接口類等代碼。如下圖：

三個末級目錄分別為V。類、service接口、校驗(yàn)類命名空間。

日亡］public

BDnc

￡}?尸1vo

［白亡］ebpur

由?亡］purapply

BD吁

:自亡］ebpur

自亡）purapply

由亡|service

E5,亡］bs

自口ebpur

白白purapply

由亡）validator

private目錄下命名空間

私有private目錄下包括相關(guān)動作類、服務(wù)實(shí)現(xiàn)類，如下圖：兩個末級目錄分別為service實(shí)現(xiàn)類、

審批動作類命名空間。

客戶logo用友

yonyou

m亡1private

E｝亡］nc

日亡1impl

日亡］ebpur

B亡］purapply

由Oservice

日Dbs

Q亡］pub

L-亡］action

客戶logo用友

yonyou

4.組件設(shè)計

本業(yè)務(wù)組件包含一個開發(fā)組件：采購申清受理開發(fā)組件。

4.1[XXXX]開發(fā)組件

|xxxx開發(fā)組件關(guān)系圖

采購申請管理業(yè)務(wù)組件下只有一開發(fā)組件：采購申請受理。采購申請受理開發(fā)組件可以自制,也可來源于

SCM領(lǐng)域請購單（采用推式生成方式入采購申請受理維護(hù)需求采購部門的具體采購產(chǎn)品清單及推薦供應(yīng)商。

審核通過的采購申請受理可以指定供應(yīng)商或匹配合同協(xié)議報價生成采購訂單，或走尋源流程為后續(xù)采購預(yù)案、

采購方案所用。本業(yè)務(wù)組件推式生成采購訂單的過程,大部分V。對照以及數(shù)據(jù)處理規(guī)則均可通過業(yè)務(wù)流程配

置完成處理。

采購申請受理開發(fā)組件包括采購申請受理實(shí)體組件、采購申請受理操作組件、采購申請受理服務(wù)組件、采

購申請受理業(yè)務(wù)活動組件、采購申請受理UI組件。采購申請受理相關(guān)開發(fā)組件關(guān)聯(lián)其它業(yè)務(wù)組件的相關(guān)組件如

下圖:

客戶logo用友

yonyou

,采購申請受理實(shí)體組件

飛

上圖關(guān)鍵業(yè)務(wù)如下:

?SCM請購單可以依據(jù)業(yè)務(wù)流配置推式生成采購申請受理單,在完成V。交換后,調(diào)用采購申請受理服

務(wù)組件相關(guān)接口,保存推式生成的采購申請受理單。

其中黃色部分EC系統(tǒng)其它業(yè)務(wù)組件:

?采購預(yù)案可以依據(jù)業(yè)務(wù)流配置,調(diào)用采購申請受理UI組件的查詢UI,依據(jù)業(yè)務(wù)流程處理進(jìn)行VO交

?采購方案可以依據(jù)業(yè)務(wù)流配置,調(diào)用采購申請受理UI組件的查詢UI,依據(jù)業(yè)務(wù)流程處理進(jìn)行VO交

換，拉式生成采購方案。

?采購申請受理操作組件可依據(jù)業(yè)務(wù)流程配置,完成VO交換后,調(diào)用采購交易訂單服務(wù)組件接口

IPurOrderWsService推式生成采購交易訂單。

客戶logo用友

yonyou

實(shí)體組件設(shè)計

實(shí)體組件設(shè)計一共分為采購申請受理單、采購申請受理明細(xì)、采購申請受理一推薦供應(yīng)商3個實(shí)體，分

別為主、子、孫關(guān)系。元數(shù)據(jù)文件屬性信息如下圖:

?-,1r-ri

PropertyValue

日Mise

連接線路由手動

日基本

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

版本號130

創(chuàng)建人

創(chuàng)建時間2010-03-1815:48:13

代碼風(fēng)格HC傳統(tǒng)樣式

多語資源模塊名purapply

擴(kuò)展標(biāo)簽

描述

名稱purapply

名稱空間ebpur

是否預(yù)加載false

所屬模塊ebpur

顯不名稱采購申諳受理單

修改人

修改時間2010-04-1911:18:02

主實(shí)體采購申請受理單

采購申請受理主要實(shí)現(xiàn)了審批流接口,見下圖:

客戶logo用友

yonyou

?實(shí)體分?實(shí)體分

采購申諳受理單采購申請受理明細(xì)K做舉〉耐用）

單據(jù)狀態(tài)

習(xí)，采購申請受理ID㈢？采購申請受理..?

_r審批未通過

口所屬集團(tuán)方源頭單據(jù)類型

_7審批通過

求*所屬蛆織jf源頭單據(jù)號

」?審批進(jìn)行中

?丁版本主組織土源頭單據(jù)主表工D

?實(shí)體》」■提交

_r采購申請受理編號」源頭單據(jù)子表工D采購申請受.…

丁自由一

口單據(jù)類型源頭交易類型

力產(chǎn)品推薦...

產(chǎn)單據(jù)狀態(tài)如r產(chǎn)品分類主鍵

’r產(chǎn)品分類

與審核時間臣產(chǎn)品主槌

審采購申請受理名稱立單位產(chǎn)產(chǎn)品

yr產(chǎn)品版本

別采購申請受理部門h申請數(shù)量i..n

供應(yīng)商類型

啟采購申請受理人21預(yù)計單價

“T內(nèi)部供應(yīng)商

聲而種?金額

?外部供應(yīng)

貨預(yù)算總金額前需求組織

J外部供應(yīng)

者備注，需求部門

山外部供應(yīng)...

，r創(chuàng)建人3*需求日期＜也舉》

不植苓理由是否關(guān)閉

,告創(chuàng)建時間白項(xiàng)目

竄制單人jr生產(chǎn)廠商3^^~~

寺制單時間寸質(zhì)量等級方打開

再修改人_r累計采購數(shù)量

有4修改時間小不是否行關(guān)閉

除作組件設(shè)計

操作組件包括兩種類型的操作:

-：與UI按鈕相對應(yīng)的操作,此部分在服務(wù)端代碼可能體現(xiàn)也可能不體現(xiàn),但是作為操作設(shè)計注冊,

供權(quán)限系統(tǒng)進(jìn)行操作權(quán)限、業(yè)務(wù)活動權(quán)限配置的元數(shù)據(jù)使用。

-:業(yè)務(wù)處理對應(yīng)的操作,此部分可能體現(xiàn)為UI,可能體現(xiàn)為后臺服務(wù)。用與控制服務(wù)操作權(quán)限的處

理。

三：操作組件與服務(wù)組件的關(guān)系：操作組件是全集。操作組件內(nèi)部分操作可以對外發(fā)布為服務(wù),構(gòu)成

服務(wù)組件.

客戶logo用友

yonyou

I操作建模

?Inter￡ace?

采購申請受理<<Cliiterface?

采購申請受理產(chǎn)品明細(xì)

V新增

V增行（產(chǎn)品）

弋修改

-S插入行（產(chǎn)品）

-S刪除

V復(fù)制行（產(chǎn)品）

-S保存

噌刪行（產(chǎn)品）

7復(fù)制

弋粘貼行（產(chǎn)品）

V查詢

■：粘貼行到表尾（產(chǎn)品）

唯刷新?

弋取消

弋提交

7取回

7審批?Inter￡ace>>

采購申諳受理推薦供應(yīng)商

7取消審批

"聯(lián)查采購預(yù)案V增行（供應(yīng)商）

7聯(lián)查采購方案7插入行（供應(yīng)商）

7聯(lián)查訂單V冊行（供應(yīng)商）

7整單打開"拷貝（供應(yīng)商）

"整單關(guān)閉V粘貼（供應(yīng)商）

7行打開V附件管理

飛行關(guān)閉7保存

7指定供應(yīng)商7刪除

7匹配合同協(xié)議V取消

7生成訂單

7導(dǎo)入

弋導(dǎo)出

弋預(yù)覽

7打印

客戶logo用友

yonyou

《業(yè)務(wù)操作》「《業(yè)務(wù)操作》《業(yè)務(wù)操作>>

維護(hù)采購申濤受理審批采購申諳受理打開關(guān)閉采購申請受理單及明細(xì)

4整單打開

卜|取消審批

用修改g整單關(guān)閉

4刪除g聯(lián)查采購預(yù)案行打開

同聯(lián)查采購方案

g保存Z行關(guān)閉

m復(fù)制h聯(lián)查采購訂單

4查詢

4刷新

4取消

4提交

4取回

?業(yè)務(wù)操作》?業(yè)務(wù)操作>>

4導(dǎo)入指定供應(yīng)商生成訂單匹配合同協(xié)議生成訂單

x導(dǎo)出

4指定供應(yīng)商X匹配合同協(xié)議

X預(yù)覽

4生成訂單4生成訂單

m打印

如上圖所示，操作接口分別為：采購申請受理、采購申請受理產(chǎn)品明細(xì)、采購申請受理推薦供應(yīng)商，分別基于

前述3實(shí)體而建立?；诖?操作接口生成5個圖示業(yè)務(wù)操作。

操作規(guī)則描述:詳見需求文檔《立項(xiàng).doc》

操作接口操作名稱引用服務(wù)/組件影響實(shí)體描述

（*為外部業(yè)務(wù)組件服務(wù)）

采購申請受理新增無

修改無

刪除更新采購受理主實(shí)體的刪除標(biāo)志

保存無

復(fù)制調(diào)用采購申請受理服務(wù)復(fù)制數(shù)據(jù)并新增采購申請受理實(shí)

體

查詢無

刷新無

客戶logo用友

yonyou

取消無

提交更新采購申請受螂務(wù)更新采購申請受理主實(shí)體的單據(jù)

狀態(tài)屬性

取回更新采購申請受理服務(wù)更新采購申請受理主實(shí)體的單據(jù)

狀態(tài)屬性

審批更新采購申請受理服務(wù)更新采購申請受理主實(shí)體的單據(jù)

狀態(tài)屬性

取消審批更新采購申請受理服務(wù)更新采購申請受理主實(shí)體的單據(jù)

狀態(tài)屬性

聯(lián)查采購預(yù)案

聯(lián)查采購方案

聯(lián)查采購訂單

整單打開更新采購申請受理服務(wù)更新采購申請受理主實(shí)體的單據(jù)

狀態(tài)屬性

整單關(guān)閉更新采購申請受理服務(wù)更新采購申請受理主實(shí)體的單據(jù)

狀態(tài)屬性

行打開

行關(guān)閉

指定供應(yīng)商*調(diào)用供應(yīng)商所屬業(yè)務(wù)組件

VO及服務(wù)

客戶logo用友

yonyou

匹配合同協(xié)議*調(diào)用合同協(xié)議業(yè)務(wù)組件內(nèi)

V。及服務(wù)

生丁單*調(diào)用采購訂單業(yè)務(wù)組件服務(wù)

導(dǎo)入

導(dǎo)出

預(yù)覽

打印

采購申請受理產(chǎn)品增行（產(chǎn)品）

明細(xì)

插入行（產(chǎn)品）

復(fù)制行（產(chǎn)品）

刪行（產(chǎn)品）

粘貼行（產(chǎn)品）

粘貼行到表尾（產(chǎn)品）

采購申請受理推薦增行（供應(yīng)商）引用推薦供應(yīng)商實(shí)體

供應(yīng)商

插入行（供應(yīng)商）引用推薦供應(yīng)商實(shí)體

刪行（供應(yīng)商）引用推薦供應(yīng)商實(shí)體

拷貝（供應(yīng)商）引用推薦供應(yīng)商實(shí)體

粘貼（供應(yīng)商）引用推薦供應(yīng)商實(shí)體

附件管理引用推薦供應(yīng)商實(shí)體

客戶logo用友

yonyou

跖引用推薦供應(yīng)商實(shí)體

刪除引用推薦供應(yīng)商實(shí)體

取消引用推薦供應(yīng)商實(shí)體

I服務(wù)組件設(shè)計

I服務(wù)接口設(shè)計

PurApplyWsServicelmpI

IPurApplyWsService

本處僅描述關(guān)鍵服務(wù)，參見上圖及下述內(nèi)容:

序號服務(wù)名稱簡要描述

1回寫累計采購數(shù)量供采購預(yù)案、采購方案、采購訂單回寫采購申請受理表體"累計

采購數(shù)量"字段。

2生成采購申請受理單供SCM請購單調(diào)用生成EC采購申請受理單。

3刪除采購申請受理單SCM取消發(fā)布、即刪除采購申請受理單。

客戶logo用友

yonyou

上述序號為2、3兩個服務(wù)接口涉及到SCM與EC交互接口,詳細(xì)實(shí)現(xiàn)參見本文檔4.L4.2章節(jié)描述。

|xxxx與XXXX接口設(shè)計

本開發(fā)組件與SCM中請購單之間進(jìn)行接入,本部分需求的詳細(xì)描述詳見《NC-ERP接口部分doc》

文檔。

本章描述接口部分相關(guān)設(shè)計。

需要說明的是,需求中關(guān)于數(shù)據(jù)補(bǔ)全的處理方式的描述,結(jié)合NC目前的架構(gòu)模型以及相關(guān)要求,并

從業(yè)務(wù)職能區(qū)分的角度,再詳細(xì)設(shè)計中進(jìn)行實(shí)現(xiàn)方式的劃分。本部分與需求描述中差異以詳細(xì)削為準(zhǔn).

.1接口功能用例

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

如圖所示,EC與SCM接入的接口用例主要分為:

■SCM系統(tǒng)（本處僅列出部分處理,供參考理解不作具體實(shí)現(xiàn)約束或理解）

客戶logo用友

yonyou

■發(fā)布請購單到EC:SCM使用業(yè)務(wù)流程將請購單推式推送到EC采購申請單中。

■取消發(fā)布到EC的請購單:SCM使用調(diào)用EC本組件服務(wù),刪除發(fā)布的采購申請單,并

根據(jù)刪除結(jié)果進(jìn)行相關(guān)處理,控制事務(wù)。

.2接口用例實(shí)現(xiàn)設(shè)計

EC與SCM的接口接入實(shí)現(xiàn),主要基于UAP業(yè)務(wù)流程平臺以及基于事件的擴(kuò)展機(jī)制來實(shí)現(xiàn)。

本設(shè)計對于實(shí)現(xiàn)的基礎(chǔ)描述如下:

■只考慮對于EC與SCM集成部署的情況。對于EC與SCM的分布部署時的數(shù)據(jù)同步機(jī)制，由NC

系統(tǒng)基礎(chǔ)平臺統(tǒng)一考慮分布式系統(tǒng)數(shù)據(jù)的同步問題。

■目前本部分的實(shí)現(xiàn)考慮基于現(xiàn)有UAP平臺支撐的實(shí)現(xiàn)機(jī)制,與EC系統(tǒng)與其它ERP系統(tǒng)（例如

ORACLE、SAP平臺）的領(lǐng)域依賴層的實(shí)現(xiàn)，本處僅做描述，不作實(shí)現(xiàn)。

.2.1XXXX接口實(shí)現(xiàn)設(shè)計

客戶logo用友

yonyou

如圖所示：右側(cè)部分(接口及灰色部分)為EC系統(tǒng)處理。

左側(cè)部分為SCM部分處理,其中這部分描述僅做描述,不作為相關(guān)實(shí)現(xiàn)依據(jù)或要求。

接口名稱:IPurApp/yWsService

接口參數(shù)：采購申請受理單1/。

接口實(shí)現(xiàn)調(diào)用邏輯:

本業(yè)務(wù)接口為實(shí)現(xiàn)SCM調(diào)用EC領(lǐng)域提供服務(wù)發(fā)布請購單從而生成EC采購申請受理單。如圖示:

請購單操作員在SCM點(diǎn)擊"發(fā)送請購單到EC：將根據(jù)系統(tǒng)中業(yè)務(wù)流配置好的V。轉(zhuǎn)換規(guī)則生成EC

采購申請受理單VO,之后更新SCM請購單狀態(tài)并發(fā)布請購單到EC,此時將調(diào)用EC領(lǐng)域提供的服

務(wù),EC領(lǐng)域內(nèi)處理時將判斷是否符合業(yè)務(wù)規(guī)則,進(jìn)行業(yè)務(wù)邏輯校驗(yàn)通過后,如符合推式生單要求,則

調(diào)用EC服務(wù),進(jìn)行相關(guān)持久化操作生成采購申請受理單。

2.XXXX與XXXX數(shù)據(jù)V0轉(zhuǎn)換規(guī)則：

源單據(jù)：請購單(SCM)

目的單據(jù)：采購申請受理單(EC)

目的單據(jù)欄目源單據(jù)欄目約束或規(guī)則

所屬集團(tuán)表頭.所屬集團(tuán)

受理采購組織空

需求組織*表頭.庫存組織

請購單號*表頭.請購單號

請購單行ID請購單行ID

產(chǎn)品分類編碼*由物料編碼自動帶入

產(chǎn)品分類名稱