企業(yè)治理軟件的需求描述要領(lǐng)摘要本文介紹了企業(yè)治理軟件需求的5元素描述法：＜組織，流程，功效，數(shù)據(jù)，業(yè)務(wù)邏輯＞，詳細(xì)介紹了對(duì)每個(gè)元素的描述要領(lǐng)、5個(gè)元素之間的干系描述要領(lǐng)，提出了針對(duì)差別的讀者編寫差別的需求文檔的看法，并給出了一些提高需求可讀性的發(fā)起。要害詞組織，流程，功效，數(shù)據(jù)，業(yè)務(wù)邏輯需求是整個(gè)軟件項(xiàng)目最要害的一個(gè)輸入，據(jù)統(tǒng)計(jì)，不樂成的項(xiàng)目中有37%的問題是由需求造成的。和傳統(tǒng)的硬件生產(chǎn)企業(yè)相比力，軟件的需求具有模糊性、不確定性、變革性和主觀性的特點(diǎn)，在硬件生產(chǎn)企業(yè)中，產(chǎn)物的需求是明確的、有形的、客觀的、可描述的、可檢測(cè)的，而軟件需求不具備此特征。需求文檔作為客戶和開發(fā)人員、開發(fā)人員之間進(jìn)行交互的文檔，它將系統(tǒng)的需求進(jìn)行了“固化”，是需求的載體，其作用是至關(guān)重要的。筆者結(jié)合多年的企業(yè)治理信息系統(tǒng)的開發(fā)經(jīng)驗(yàn)，總結(jié)了如下的需求描述的要領(lǐng)與經(jīng)驗(yàn)，供列位同行參考。組成企業(yè)治理信息系統(tǒng)的5個(gè)根本要素對(duì)企業(yè)需求的描述可以從2個(gè)方面來進(jìn)行描述，一個(gè)方面是對(duì)客戶現(xiàn)行系統(tǒng)的描述，一個(gè)方面是對(duì)系統(tǒng)未來的設(shè)想?？偟亩?，無論是從那個(gè)方面來描述，組成企業(yè)信息系統(tǒng)主要包羅5個(gè)根本要素：企業(yè)的組織結(jié)構(gòu)、流程、數(shù)據(jù)、商務(wù)規(guī)矩與功效（性能）。其中從用戶的角度主要存眷流程，是以流程為核心的，通過流程將其他幾個(gè)要素貫串起來，需求闡發(fā)人員也應(yīng)該從這個(gè)角度來和用戶相同；從開發(fā)者的角度主要存眷企業(yè)的數(shù)據(jù)、商務(wù)規(guī)矩與功效，以便于系統(tǒng)的實(shí)現(xiàn)；從實(shí)施者的角度主要存眷企業(yè)的組織結(jié)構(gòu)與功效，以便于系統(tǒng)的公布與實(shí)施。綃臨枸！角色散齬商勢(shì)廄則■i翦啞龍圖1)1)企業(yè)的組織模型即企業(yè)的組織結(jié)構(gòu)干系，包羅部分設(shè)置、崗?fù)ぴO(shè)置、崗?fù)ぢ氊?zé)等。樹型組織結(jié)構(gòu)圖是描述企業(yè)的組織模型的一種常用要領(lǐng)，它可用來搞清各部分之間的領(lǐng)導(dǎo)干系,每個(gè)部分內(nèi)部的人員配備情況,職責(zé)分工等情況,它是分別系統(tǒng)范疇,進(jìn)行系統(tǒng)網(wǎng)絡(luò)籌劃的底子。在組織結(jié)構(gòu)圖中應(yīng)將用戶的組織結(jié)構(gòu)逐層詳細(xì)描述，每個(gè)部分的職責(zé)也應(yīng)進(jìn)行簡樸的描述。組織結(jié)構(gòu)是用戶企業(yè)業(yè)務(wù)流程與信息的載體，對(duì)闡發(fā)人員理解企業(yè)的業(yè)務(wù)、確定系統(tǒng)范疇具有很好的資助。取得用戶的組織結(jié)構(gòu)圖，是需求獲取步調(diào)中的底子事情之一。用戶情況中的企業(yè)崗?fù)せ蚰_色，和組織機(jī)構(gòu)一樣，也是闡發(fā)人員理解企業(yè)業(yè)務(wù)的底子，也是闡發(fā)人員提取東西的底子。每個(gè)崗?fù)さ穆氊?zé)可以進(jìn)行詳細(xì)的描述，發(fā)起接納表格的形式，如：崗位心所在部門心相關(guān)的業(yè)務(wù)卩采購員4業(yè)務(wù)部口負(fù)責(zé)商品米購、進(jìn)貨合同的簽定、洪應(yīng)商的選擇申進(jìn)貨、合同管理PPQ-Q□申Q+3表1）對(duì)用戶腳色的識(shí)別經(jīng)常遺漏的是盤算機(jī)系統(tǒng)的系統(tǒng)治理人員，腳色識(shí)別不全，對(duì)以后的功效識(shí)別會(huì)造成盲區(qū)。（2）企業(yè)的流程模型即企業(yè)的業(yè)務(wù)流程，包羅哪些流程、流程之間的干系、每個(gè)流程中包羅哪些運(yùn)動(dòng)、每個(gè)運(yùn)動(dòng)涉及到的崗?fù)?。企業(yè)的作業(yè)流程首先要有一個(gè)總的業(yè)務(wù)流程圖，將企業(yè)中種種業(yè)務(wù)之間的干系描述出來，然后對(duì)每種業(yè)務(wù)進(jìn)行詳細(xì)的描述，使業(yè)務(wù)流程與部分職責(zé)結(jié)合起來。詳細(xì)業(yè)務(wù)流程圖可以接納直式業(yè)務(wù)流程圖形式，如圖2所示。對(duì)企業(yè)而言需要界說關(guān)于業(yè)務(wù)流程圖的描述尺度，各人接納相同的圖例來描述，便于治理。

（圖2）業(yè)務(wù)流程圖的優(yōu)點(diǎn):■畫圖的歷程,實(shí)際上是作業(yè)流程條理化的歷程■表達(dá)形象直觀,易于和用戶交換,易于項(xiàng)目組內(nèi)部交換調(diào)研的結(jié)果,需要得到用戶的認(rèn)同,這就需要和用戶交換調(diào)研的結(jié)果,交換的文檔要通俗、易懂,不能接納專業(yè)術(shù)語?！隹梢宰鳛榕嘤?xùn)實(shí)施人員與技能辦事人員的文檔業(yè)務(wù)流程圖的缺點(diǎn):■對(duì)高層治理人員的實(shí)際需求觀察的不清楚.這一方面是由于用戶沒有打仗過盤算機(jī),對(duì)接納盤算機(jī)后的治理會(huì)是什么樣子?盤算性能夠完成當(dāng)前手工操縱的哪些內(nèi)容?能夠作哪些現(xiàn)在手工無法完成的事情等等沒有清楚的看法,因此用戶無法將這些問題反響出來.另一方面說明闡發(fā)人員沒有經(jīng)驗(yàn),對(duì)原始質(zhì)料挖掘不深,不能從用戶提供的質(zhì)料中提煉處來用戶的真正需求,不能找到當(dāng)前治理中的問題?！鰧?duì)種種業(yè)務(wù)之間的總體干系沒有表達(dá)出來.接納直式業(yè)務(wù)流程圖可以將企業(yè)的每一種業(yè)務(wù)的處置懲罰流程清楚地表達(dá)出來,但是各業(yè)務(wù)之間的聯(lián)系卻沒有體現(xiàn)出來,單看一種業(yè)務(wù)的流程圖很清楚,但是卻不能綜合在一起,沒有整體的看法,作為需求闡發(fā)的文檔,在這方面表達(dá)的不敷完整?！鲈诘姑褂脰|西的情況下,畫法啰嗦。圖形可以將流程描述的很清楚，但是還要附加以一些文字說明，如關(guān)于業(yè)務(wù)產(chǎn)生的頻率、意外事故的處置懲罰、岑嶺期的業(yè)務(wù)頻率等，不能在流程圖中描述出的內(nèi)容，需要用文字進(jìn)行詳細(xì)描述。（3）企業(yè)的數(shù)據(jù)模型即企業(yè)中的信息載體有哪些？以及對(duì)這些信息載體的詳細(xì)刻畫，包羅企業(yè)的種種票據(jù)、帳本、報(bào)表的描述。在需求陳訴中，應(yīng)該將票據(jù)的描述格式化，需要描述的內(nèi)容包羅：票據(jù)的用途，即票據(jù)用在什么地方？票據(jù)的格式：需要明確的畫出來，并有實(shí)際的有數(shù)據(jù)的樣例，能夠具體直觀地說明問題；票據(jù)中的數(shù)據(jù)項(xiàng)的具體描述：長度、類型、盤算生成要領(lǐng)、約束條票據(jù)的數(shù)據(jù)項(xiàng)是由哪些差別類型的腳色來填寫地，包羅用盤算機(jī)可以填那些數(shù)據(jù)項(xiàng)。票據(jù)中哪些數(shù)據(jù)是必填的，哪些是可以不消填的。票據(jù)流量：平均每天產(chǎn)生幾多條記載，岑嶺期的數(shù)量；票據(jù)的分類：可以從多個(gè)角度上進(jìn)行分類，如：按業(yè)務(wù)類型來分類（采購/銷售/生產(chǎn)），按生成的方法來分類（手工錄入型/自動(dòng)生成型），按格式變革的頻繁水平來分類（易變型/穩(wěn)定型），按體現(xiàn)形式來分類（列表型/卡片型）等等。票據(jù)之間的干系：引用干系等等。同樣對(duì)付需要的報(bào)表與帳本也可以參照上面的條目進(jìn)行詳細(xì)的刻畫。（4）企業(yè)的商務(wù)規(guī)矩模型即企業(yè)中的商務(wù)規(guī)矩有哪些?這些規(guī)矩用在哪些地方?商務(wù)規(guī)矩可以從影響的范疇分別為2類：一類是局部的規(guī)矩，如不允許出現(xiàn)負(fù)庫存，一類是整體的規(guī)矩，如對(duì)所有的物料治理到批次。商務(wù)規(guī)矩一般是隱藏在功效模型大概流程模型中，不需要單獨(dú)描述，但是有些龐大的商務(wù)規(guī)矩是需要單獨(dú)抽取出來描述，如企業(yè)的種種票據(jù)記帳的商務(wù)邏輯：庫存保管帳存庫存咸本帳屮往來帳衛(wèi)采峋入庫單心誣i的育法Q銷售發(fā)票口銷■?提貨單卡采購忖款單梓銷售回款單衛(wèi)（表2）（5）企業(yè)的功效模型功效需求是用戶的最主要的需求，對(duì)用戶功效需求的描述可以接納文字描述也可以接納語言加圖形的描述方法，只要能夠?qū)⒂脩舻男枨竺枋龅赝暾?、?zhǔn)確、易于理解即可。對(duì)功效需求比力龐大的系統(tǒng)（如凌駕10個(gè)功效項(xiàng)），可以先描述一個(gè)提要，對(duì)簡樸的系統(tǒng)可以直接進(jìn)行詳細(xì)描述。對(duì)付用戶的功效需求要進(jìn)行分類，分類的要領(lǐng)應(yīng)便于用戶理解，如憑據(jù)用戶的部分設(shè)置情況，進(jìn)行描述每個(gè)部分的需求，這樣也便于組織用戶進(jìn)行評(píng)審。以下是分類要領(lǐng)的舉例：按部分分類：如采購科、銷售科、籌劃科、生產(chǎn)車間、財(cái)政科、統(tǒng)計(jì)科、總經(jīng)理等；按功效類型分類：如票據(jù)錄入、票據(jù)審核、票據(jù)查詢、記帳、帳本查詢、統(tǒng)計(jì)報(bào)表、系統(tǒng)維護(hù)等；對(duì)功效需求的分類在差別的條理可以接納差別的要領(lǐng)。對(duì)每一項(xiàng)功效應(yīng)有一個(gè)功效編號(hào)，以便于與功效規(guī)格說明書中的章節(jié)進(jìn)行對(duì)應(yīng)。對(duì)每一項(xiàng)功效的描述，應(yīng)指明用戶的輸入（input）、處置懲罰要領(lǐng)（process）、系統(tǒng)的輸出（output）及對(duì)此項(xiàng)功效的其他要求。功效需求還應(yīng)注明使用此功效的崗?fù)?。?duì)系統(tǒng)治理員要求的特殊功效可以在此注明，非特殊要求可以在需求闡發(fā)規(guī)格說明書中詳細(xì)論述。如用戶權(quán)限可分級(jí)，要有操縱日志等。對(duì)具體功效需求接納USECASE的描述方法不失為一種好的要領(lǐng)，如：執(zhí)行者行曲衛(wèi)系酈應(yīng)總發(fā)出杳詢做屮?提供設(shè)首杳詢條件的畀面』錄入需要的條件；団烹、日期、線路、狀脊□.列出符合條件的團(tuán)從列表，提供兩個(gè)選擇=f一丿査看最新國豪沖剝（二？查看國駄更改記錄f?可選過程—査看最藥裁風(fēng)琢￡.顯示選擇的團(tuán)隊(duì)計(jì)劃■>';可選過程（二）…査看團(tuán)氏更改記尿顯喬所選團(tuán)陸的更改記錄亦（表3）功效需求與性能需求是密不可分的，籠統(tǒng)的性能需求沒有任何意思必須具體到某項(xiàng)功效需求上來，這是闡發(fā)人員在闡發(fā)系統(tǒng)時(shí)容易忽略的一項(xiàng)。對(duì)上述的5個(gè)根本元素可以將他們描述為一個(gè)五元組〈組織，流程，功效，數(shù)據(jù)，業(yè)務(wù)邏輯〉，對(duì)付用戶來講，他們習(xí)慣于從組織維來看待系統(tǒng)，即某個(gè)部分有哪些崗?fù)?，每個(gè)崗?fù)さ綀?chǎng)了哪些流程的哪些運(yùn)動(dòng)（功效），在某個(gè)功效上操縱了哪些數(shù)據(jù)，對(duì)這些數(shù)據(jù)進(jìn)行了哪些邏輯處置懲罰；對(duì)付開發(fā)人員習(xí)慣于從功效維來看待系統(tǒng)，即某個(gè)功效操縱了哪些數(shù)據(jù)，對(duì)這些數(shù)據(jù)進(jìn)行了哪些邏輯處置懲罰，這個(gè)功效屬于哪個(gè)流程，可以由哪些崗?fù)硎褂?；?duì)付設(shè)計(jì)人員可能習(xí)慣于從數(shù)據(jù)維來看待系統(tǒng)：即系統(tǒng)中有哪些數(shù)據(jù)，在這些數(shù)據(jù)上可以做哪些處置懲罰，這些處置懲罰用OO的思想來看便是對(duì)數(shù)據(jù)東西的操縱。對(duì)此五個(gè)根本元素之間干系的刻畫可以接納矩陣的方法：對(duì)付上表中列的排列順序可以憑據(jù)面向的讀者的差別而改變。對(duì)以上的5個(gè)根本元素進(jìn)行描述實(shí)際上就是系統(tǒng)建模的歷程，為確保模型的可操縱性，除了上面的5個(gè)根本要素外，還需要重點(diǎn)描述的內(nèi)容有：（1）新系統(tǒng)對(duì)應(yīng)用模式帶來的變革包羅對(duì)企業(yè)的組織結(jié)構(gòu)、作業(yè)流程、票據(jù)帳本報(bào)表等的格式、商務(wù)規(guī)矩等的改變。（2）新系統(tǒng)的界面模型用開發(fā)東西將用戶操縱界面快速畫出來，使用戶心中有數(shù)。若時(shí)間允許，可將界面原型與數(shù)據(jù)庫表、字段連接起來，真正做出系統(tǒng)雛形，即快速原型法。閱讀需求文檔的4類讀者需求陳訴的最終目的是給人來閱讀的，所以一定要考慮需求陳訴的讀者群，有4類腳色可能閱讀企業(yè)治理系統(tǒng)的需求文檔：客戶與用戶業(yè)務(wù)高層；用戶的中層治理人員與具體人員；用戶IT主管與開發(fā)人員，包羅設(shè)計(jì)人員、編碼人員、同行的專家;項(xiàng)目治理人員：包羅項(xiàng)目經(jīng)理、質(zhì)量包管人員、測(cè)試人員、需求治理員、配置治理員、籌劃人員等等；差別的讀者對(duì)文檔的閱讀需求是差別的，他們存眷的信息是差別的。我見過了許多次需求評(píng)審的失敗（如果做好需求評(píng)審我會(huì)另外再撰文描述），總結(jié)下來我認(rèn)為和需求描述沒有區(qū)分讀者群是很有干系的。針對(duì)上述的4種分類，我們具體的來闡發(fā)一下每類讀者的特點(diǎn)：（1）客戶與用戶業(yè)務(wù)高層他們體貼的企業(yè)是系統(tǒng)的目標(biāo)性需求，體貼的是系統(tǒng)總體的功效框架，體貼的是系統(tǒng)解決了哪些治理問題，對(duì)具體的需求是不體貼的，所以給他們閱讀的文檔應(yīng)該是從總體上來描述，要高度抽象。由于他們的事情很忙，很難有比力長的時(shí)間來讀這些質(zhì)料，所以要簡短明了，能夠用1頁紙說明問題的就要不要用2頁紙，并且一般都要給高層進(jìn)行需求報(bào)告，需要配上語言說明，因此接納PowerPiont片子也就成了一種常用的要領(lǐng)，解說需求與討論一般應(yīng)掌握不要凌駕1小時(shí)。需求人員常犯的毛病是過多地存眷了企業(yè)的細(xì)節(jié)性需求，而忽略系統(tǒng)的目標(biāo)性需求，所以在擺設(shè)需求獲取的步調(diào)上、需求陳訴的編寫上往往沒有抓住企業(yè)高層最體貼的問題、沒有抓住根天性的問題，在給企業(yè)的高層報(bào)告時(shí)固然很難通過評(píng)審。（2）用戶的中層治理人員與具體人員企業(yè)的中層治理人員存眷的是企業(yè)的局部需求，他們要求對(duì)自己的賣力的局部系統(tǒng)能夠有總體的了解，能夠和其他的子系統(tǒng)銜接的很好，業(yè)務(wù)流程很流暢，籠罩了自己需要的所有業(yè)務(wù)流程，能夠通過系統(tǒng)起到控制作用就行了。具體的操縱人員更體貼自己的的哪些運(yùn)動(dòng)是否在系統(tǒng)中都能處置懲罰，軟件是否可以很容易地操縱，他們存眷的核心更具體，要求更直觀。所以對(duì)這類的讀者可以通過比力詳細(xì)的文檔來描述需求了，固然應(yīng)該以他們習(xí)慣的思維方法來描述，不能從開發(fā)人員的角度來描述。我看到過許多幾百頁的需求文檔給用戶去閱讀、去評(píng)審，結(jié)果要么用戶不置可否，要么直接講看不懂，為什么呢？一是開發(fā)人員在文檔中分子系統(tǒng)、分模塊、分功效點(diǎn)一層深入下去描述，不切適用戶的思維習(xí)慣，他們希望能夠從業(yè)務(wù)流程、業(yè)務(wù)運(yùn)動(dòng)的角度來考慮問題，而不是功效；二是太多了，用戶也沒有時(shí)間靜下心來去消化、吸收如此多的文檔，需求究竟不是小說，能夠那么吸引讀者。用戶IT主管與開發(fā)人員，包羅設(shè)計(jì)人員、編碼人員、同行的專家大多數(shù)闡發(fā)人員可能最擅長的就是些寫這類的文檔了，往往也是那這類的文檔給所有的讀者看，其問題我們上邊都說了，這里我們就不贅述了。需要注意的是在描述需求時(shí)候傳統(tǒng)的做法是以功效為主線，來展開描述，實(shí)際上如果是以數(shù)據(jù)為主線來描述需求也是一種很好的措施，在我們上面談到的五元組中，從數(shù)據(jù)的角度來闡發(fā)系統(tǒng)可以更容易實(shí)現(xiàn)向OOA、OOD的切換。項(xiàng)目治理人員：包羅項(xiàng)目經(jīng)理、質(zhì)量包管人員、測(cè)試人員、需求治理員、配置治理員、籌劃人員等等把拿給開發(fā)人員看的需求文檔給治理人員看，這也是闡發(fā)人員常犯的毛病。治理人員實(shí)際上最體貼的是需求列表，如下表所示：序號(hào)屮需求項(xiàng)婁功能、特性）心功能描述心優(yōu)先級(jí)P石儀戶■P（表5）在此底子上項(xiàng)目經(jīng)理、質(zhì)量包管人員可以據(jù)此來進(jìn)入項(xiàng)目籌謀歷程，測(cè)試人員可據(jù)此進(jìn)入測(cè)試籌謀歷程，需求治理員、配置治理員可以識(shí)別配置項(xiàng)制定相關(guān)的運(yùn)動(dòng)籌劃。沒有這張表治理人員就很難高效地開展他們的治理運(yùn)動(dòng)，也就談不到最根本的需求復(fù)用了。在上述的表中，需求的優(yōu)先級(jí)是很重要的一列，對(duì)項(xiàng)目經(jīng)理進(jìn)行項(xiàng)目治理的平衡決策是很重要的，實(shí)際上需求的優(yōu)先級(jí)可能比需求自己更重要。憑據(jù)上面描述的論述，我們可以看出需求文檔不是一個(gè)文檔，而是多個(gè)文檔，如：序號(hào)申文檔護(hù)建諫的棍式玄目橇慷者卍■1-P目標(biāo)與范圍描述文檔屮PPT文件屮用戶咼層與客戶盧a用戶需求損告中WORD.VISO文件Q最繩用戶少需求規(guī)格定文QWORD.VISIOS件Q門主管；開發(fā)兀員r領(lǐng)域?qū)＜议T4心需求列表口EXGEJ>管理人員Q需求描述的體現(xiàn)本領(lǐng)上面我們談到了，需求文檔是人與人之間交互的文檔，是差別類型的人之間交互的文檔，因此需求文檔的可讀性是一個(gè)很重要的方面，為了提高文檔的可讀性可以借鑒下面的一些做法：在文檔的描述中，適當(dāng)運(yùn)用鏈接，增強(qiáng)文檔的可讀性；多用圖表，如某企業(yè)的業(yè)務(wù)與票據(jù)之間的關(guān)聯(lián)干系可以用矩陣的方法描述為：進(jìn)嶺方式丄茨票聯(lián)隕軀五聯(lián)進(jìn)貨報(bào)單癖單代銷驗(yàn)收單已網(wǎng)代銷通知單+正常經(jīng)銷1老狀密4代銷進(jìn)貨丄（丈Z丄屮延期忖款丄J』J站1和（表7）