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實體而建立?；诖?操作接口生成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

產品分類編碼*由物料編碼自動帶入

產品分類名稱