功能開發(fā)說明書，是業(yè)務(wù)顧問和ABAP顧問在項(xiàng)目上進(jìn)行有效溝通的基本工具之一。
作為業(yè)務(wù)顧問，寫出一份邏輯清晰、表述合理的功能開發(fā)說明書，是必備的技能之一。
本篇，我們就簡單聊聊SAP功能開發(fā)說明書一般該怎么寫。
導(dǎo)讀
功能開發(fā)說明書，也稱“功能說明書”，項(xiàng)目上也有稱為“Function Specification”，實(shí)際項(xiàng)目中，多為簡稱“Function Spec”,也有直接簡稱為“FS”。
以上是一些對(duì)“功能開發(fā)說明書”較為通用的稱呼。這里之所以提到對(duì)功能開發(fā)說明書的多種不同稱呼，是為了接觸實(shí)際項(xiàng)目不多的朋友，多了解一些項(xiàng)目中的常用稱呼。
如果有項(xiàng)目組同事、項(xiàng)目經(jīng)理，甚至用戶提到一些簡稱，我們不理解，雖然沒有太多影響，但是可能在一瞬間，會(huì)讓他人覺得你項(xiàng)目經(jīng)驗(yàn)有限，特別是當(dāng)你的用戶將“功能開發(fā)說明書”稱為“FS”時(shí)，你作為顧問還不清楚用戶說的是什么，這就會(huì)讓你在用戶心里的專業(yè)性產(chǎn)生一定影響。當(dāng)然，還有很多項(xiàng)目有其他專門的說法，這就另當(dāng)別論了。
對(duì)于功能開發(fā)說明書來說，不同的項(xiàng)目組一般都有自己定義好的FS基本格式，所以，在實(shí)際項(xiàng)目中，我們需要按照既定的格式去寫。但不論格式有何種變化，基于功能開發(fā)說明書的功能，基本的要素是要完整的。
SAP中常見的二次開發(fā)工作，包括：報(bào)表、增強(qiáng)、接口、對(duì)話程序，表單打印等。
系統(tǒng)接口，實(shí)際上就是實(shí)現(xiàn)系統(tǒng)間數(shù)據(jù)傳輸?shù)墓δ?，是企業(yè)信息系統(tǒng)間非常常見的功能。
本篇，就簡單和大家聊聊接口的功能開發(fā)說明書，對(duì)業(yè)務(wù)顧問來說，應(yīng)該如何分析接口、如何合理表述，從而能保證需求被有效傳遞。
本篇所分享的內(nèi)容，更多從技術(shù)理解和思路方法上，分享一點(diǎn)內(nèi)容，并不會(huì)固定于某種格式，其實(shí)如果對(duì)接口技術(shù)有比較深刻的理解，無論什么格式，都能夠完成一份開發(fā)能理解，且能有效交付的功能開發(fā)說明書。
如有不合理之處，還請(qǐng)大家指正。希望分享內(nèi)容對(duì)大家有一些作用。
思路分析
有過SAP中報(bào)表的使用經(jīng)驗(yàn)，都應(yīng)該清楚SAP表報(bào)的使用方法。比如，我們要通過一個(gè)報(bào)表查詢某些數(shù)據(jù)，以下就是我們的操作順序：
這里，我們就要考慮，設(shè)計(jì)自己的報(bào)表時(shí)，第一個(gè)要考慮的就是定義：SAP系統(tǒng)事務(wù)碼（T-Code）。當(dāng)然，不同項(xiàng)目中，都有事務(wù)碼設(shè)計(jì)的基本準(zhǔn)則，我們需要按照項(xiàng)目上的規(guī)則，去定義設(shè)計(jì)自己的T-Code。
正文
在實(shí)際工作中，數(shù)據(jù)接口從業(yè)務(wù)要求到技術(shù)實(shí)現(xiàn)，再到數(shù)據(jù)流向等不同維度上去區(qū)分，會(huì)有各種各樣的接口方式。
比如，按照，外部系統(tǒng)從SAP中提取數(shù)據(jù)，或者SAP系統(tǒng)給外部系統(tǒng)主動(dòng)推送數(shù)據(jù)，或者SAP從其他外部系統(tǒng)獲取數(shù)據(jù)后進(jìn)行處理等等。
再比如，數(shù)據(jù)傳輸方式，可能是調(diào)用遠(yuǎn)程函數(shù)，文件傳輸，或者，采用中間數(shù)據(jù)庫等方式進(jìn)行的。
當(dāng)然，如果按照業(yè)務(wù)上的功能實(shí)現(xiàn)來說，也有各種各樣的功能要求，不同的數(shù)據(jù)傳輸觸發(fā)點(diǎn)等。
基于各種各樣的接口，作為業(yè)務(wù)顧問，我們?cè)诮拥綌?shù)據(jù)接口傳輸?shù)男枨蠛?，要有能力設(shè)計(jì)合理的數(shù)據(jù)交互，進(jìn)而滿足業(yè)務(wù)需求。
1.接口結(jié)構(gòu)設(shè)計(jì)
作為業(yè)務(wù)顧問，我們必須有能力根據(jù)對(duì)用戶業(yè)務(wù)需求的分析，設(shè)計(jì)出接口的基本結(jié)構(gòu)，為接口的實(shí)現(xiàn)做準(zhǔn)備。
對(duì)于很多新手顧問來說，之所以經(jīng)常難以完成對(duì)接口的設(shè)計(jì)，主要是缺少以接口實(shí)現(xiàn)的思維去分析業(yè)務(wù)需求的能力。
接下來，我們就結(jié)合一個(gè)簡單的實(shí)例，從接口的數(shù)據(jù)流向、觸發(fā)和處理這三個(gè)方面，去展示如何進(jìn)行接口的分析。
業(yè)務(wù)舉例：
假定，企業(yè)希望在SAP系統(tǒng)中做采購訂單，在相應(yīng)訂單到貨后，能夠在企業(yè)的一個(gè)專用收貨系統(tǒng)中收貨，在此系統(tǒng)中完成收貨后，SAP系統(tǒng)相應(yīng)的采購訂單，也將自動(dòng)收貨，避免用戶需要出現(xiàn)兩個(gè)系統(tǒng)都要收貨的重復(fù)操作。
1.1.數(shù)據(jù)流向
根據(jù)業(yè)務(wù)需求，我們做一個(gè)初步分析：
a.參考采購訂單的收貨，是在外部的專用收貨系統(tǒng)進(jìn)行的，可是當(dāng)SAP系統(tǒng)中采購訂單被創(chuàng)建完成后，這個(gè)收貨系統(tǒng)是沒有采購訂單的，所以，我們能首先確認(rèn)的是：采購訂單的信息，需要被傳輸?shù)绞肇浵到y(tǒng)，這樣，這個(gè)收貨系統(tǒng)才能在到貨后，有可參考的采購訂單信息；
b.當(dāng)?shù)截浐?，在收貨系統(tǒng)進(jìn)行收貨操作，并要SAP系統(tǒng)執(zhí)行相應(yīng)的收貨動(dòng)作，所以我們能確定：收貨系統(tǒng)中的收貨信息，需要傳輸?shù)絊AP系統(tǒng)中，進(jìn)而SAP系統(tǒng)能夠參考相應(yīng)信息進(jìn)行收貨。
基于上述的簡單分析，我們能夠得出一個(gè)簡單的數(shù)據(jù)流向：
僅僅這樣的數(shù)據(jù)流向，是否能夠滿足實(shí)際業(yè)務(wù)需要？
采購訂單信息從SAP系統(tǒng)，被傳輸?shù)绞肇浵到y(tǒng)，我們?nèi)绾伪ＷC數(shù)據(jù)被傳輸?shù)搅耸肇浵到y(tǒng)？假定，我們從SAP端做了傳輸操作以后，但因?yàn)楦鞣N各樣的問題，收貨系統(tǒng)沒有收到數(shù)據(jù)，這樣就造成了，SAP端有這個(gè)采購訂單，收貨系統(tǒng)沒有這個(gè)采購訂單的問題？
如何解決這個(gè)問題？總不能整天讓采購部的操作員傳輸后，還得讓收貨部門的人檢查一下數(shù)據(jù)到?jīng)]到？
同樣的問題，也會(huì)出現(xiàn)在收貨操作上，收貨系統(tǒng)收貨了，但是SAP沒有接到數(shù)據(jù)，沒法收貨，這樣也會(huì)造成差異。
這種隱藏需求是用戶不會(huì)專門給顧問去提的。但是作為業(yè)務(wù)顧問，必須要有能力注意到這些隱藏需求，或者要注意到這些通用的問題。
所以，我們?cè)谠O(shè)計(jì)數(shù)據(jù)流向時(shí)，或者叫設(shè)計(jì)數(shù)據(jù)交互時(shí)，一定要注意：數(shù)據(jù)接收系統(tǒng)在接收到系統(tǒng)后，需要給數(shù)據(jù)發(fā)出系統(tǒng)反饋已接收的信息，數(shù)據(jù)發(fā)出系統(tǒng)在接收到反饋信息后，可以將已接收的反饋信息，及時(shí)地顯示在發(fā)出系統(tǒng)中，進(jìn)而相關(guān)發(fā)出數(shù)據(jù)的操作人員，也就能知道自己發(fā)出的數(shù)據(jù)已經(jīng)被成功接收了。
結(jié)合這個(gè)需求，我們的數(shù)據(jù)交互就大致如下了：
當(dāng)然，實(shí)際業(yè)務(wù)情況，就得根據(jù)不同情況而定。
上述這一部分，就可以理解為一個(gè)簡單的接口架構(gòu)（interface landscape）。
在接口的功能說明書中，接口架構(gòu)，或者叫接口設(shè)計(jì)結(jié)構(gòu)等，是非常重要的一部分，它能夠清晰地說明接口的數(shù)據(jù)流向。
1.2.數(shù)據(jù)觸發(fā)
當(dāng)我們?cè)O(shè)計(jì)好了接口的數(shù)據(jù)流向基本結(jié)構(gòu)，對(duì)于從SAP系統(tǒng)發(fā)出的數(shù)據(jù)，我們得分析具體的數(shù)據(jù)觸發(fā)點(diǎn)，或者理解為接口數(shù)據(jù)會(huì)在哪一個(gè)操作中產(chǎn)生。
對(duì)于數(shù)據(jù)觸發(fā)，一般來說可以簡單地分為：自動(dòng)觸發(fā)和手動(dòng)觸發(fā)。
a.自動(dòng)觸發(fā)
當(dāng)我們?cè)赟AP系統(tǒng)中完成某項(xiàng)操作時(shí)，系統(tǒng)將自動(dòng)觸發(fā)接口功能，將相應(yīng)的數(shù)據(jù)從接口傳輸出去。
比如，結(jié)合之前的業(yè)務(wù)舉例，采購訂單需要被傳輸?shù)绞肇浵到y(tǒng)，我們就可以設(shè)計(jì)自動(dòng)觸發(fā)。
假定，采購訂單的流程是：ME21N創(chuàng)建采購訂單，ME29N一級(jí)領(lǐng)導(dǎo)審批采購訂單，ME29N二級(jí)領(lǐng)導(dǎo)審批采購訂單。經(jīng)過二級(jí)部門領(lǐng)導(dǎo)審批后，此采購訂單會(huì)被發(fā)送給供應(yīng)商。
如果我們要設(shè)置自動(dòng)數(shù)據(jù)的觸發(fā)點(diǎn)，很明顯，我們需要設(shè)置在二級(jí)部門領(lǐng)導(dǎo)審批的位置，也就是要在二級(jí)部門領(lǐng)導(dǎo)使用ME29N審批時(shí)，設(shè)置增強(qiáng)點(diǎn)，當(dāng)ME29N審批通過采購訂單時(shí)，觸發(fā)增強(qiáng)程序，將相應(yīng)采購訂單信息傳輸出去。
這里，就需要業(yè)務(wù)顧問按照寫增強(qiáng)邏輯的方式，在功能開發(fā)說明書中，表達(dá)清楚數(shù)據(jù)傳輸觸發(fā)的功能了。
b.手動(dòng)觸發(fā)
這類觸發(fā)，是我們可以專門設(shè)置某一個(gè)功能，用戶可以選定自己要發(fā)出去的數(shù)據(jù)，比如，當(dāng)我們需要把一些物料、供應(yīng)商、客戶、成本中心等主數(shù)據(jù)，有選擇地傳輸出去，我們就可以設(shè)計(jì)一個(gè)功能，選擇需要的數(shù)據(jù)，用戶可以執(zhí)行傳輸?shù)炔僮鳌?br style="overflow-wrap: break-word; caret-color: rgb(68, 68, 68); color: rgb(68, 68, 68); font-family: Tahoma, Helvetica, SimSun, sans-serif;">這個(gè)功能在功能開發(fā)說明書的表述，可以按照?qǐng)?bào)表的方式，表達(dá)清楚篩選條件，以及數(shù)據(jù)展示界面，以及傳輸按鈕的設(shè)計(jì)等。
還以上述業(yè)務(wù)舉例，當(dāng)二級(jí)領(lǐng)導(dǎo)ME29N審批后，我們不做自動(dòng)傳輸，而是由采購員在手動(dòng)觸發(fā)的程序中，每天統(tǒng)一選擇被審批通過的采購訂單，點(diǎn)擊傳輸執(zhí)行操作，進(jìn)而進(jìn)行數(shù)據(jù)的傳輸。這種設(shè)計(jì)也是可能存在的。
實(shí)際項(xiàng)目中，多數(shù)需求為：上述兩種傳輸方式均存在的需求。
結(jié)合上述舉例，用戶肯定希望自動(dòng)化的程度高一點(diǎn)，當(dāng)領(lǐng)導(dǎo)審批通過后系統(tǒng)自動(dòng)傳輸數(shù)據(jù)。
但是，如果數(shù)據(jù)傳輸不成功，用戶就需要重新再傳輸一遍，但采購訂單已經(jīng)被審批過了，原則上不能要求領(lǐng)導(dǎo)撤銷后再審批一遍。
這時(shí)，就需要設(shè)計(jì)系統(tǒng)功能，能夠支持用戶將沒有成功傳輸?shù)臄?shù)據(jù)再傳輸一遍。
如果用戶進(jìn)一步要求，或者需要更完善的功能設(shè)計(jì)時(shí)，我們可以設(shè)置SAP的后臺(tái)作業(yè)。
在前面接口數(shù)據(jù)流向設(shè)計(jì)中，當(dāng)數(shù)據(jù)傳輸出去以后，在沒有收到對(duì)方系統(tǒng)的反饋時(shí)，認(rèn)為數(shù)據(jù)沒有被成功傳輸。
因此，我們完全可以在SAP系統(tǒng)中設(shè)置后臺(tái)作業(yè)，讓每天凌晨某個(gè)時(shí)間點(diǎn)，系統(tǒng)自動(dòng)將已經(jīng)發(fā)出的，但沒有接到對(duì)方信息反饋信息的數(shù)據(jù)，通過手動(dòng)觸發(fā)的程序，再發(fā)送一遍。
一般設(shè)計(jì)到這種情況，幾乎能夠滿足所有接口數(shù)據(jù)傳輸?shù)挠|發(fā)情況了。
1.3.數(shù)據(jù)處理
當(dāng)SAP作為數(shù)據(jù)的接收方系統(tǒng)時(shí)，我們就需要考慮對(duì)于接收數(shù)據(jù)的處理。
一般常見的處理方式：直接處理和先存儲(chǔ)再處理。
a.直接處理
有時(shí)候，我們對(duì)系統(tǒng)間的數(shù)據(jù)一致性要求非常嚴(yán)格，比如在出庫業(yè)務(wù)中，掃描槍掃描貨物出庫，掃描系統(tǒng)將數(shù)據(jù)傳輸給SAP，一般會(huì)要求SAP系統(tǒng)根據(jù)傳輸?shù)臄?shù)據(jù)，做了成功過賬出庫后，并將出庫信息反饋給掃描系統(tǒng)后，才允許掃描系統(tǒng)這筆出庫完成，實(shí)際貨物可以出庫，否則，如果SAP沒有反饋出庫成功，掃描系統(tǒng)也不能認(rèn)為出庫成功。
在這種情況下，就意味著，SAP系統(tǒng)提供相應(yīng)的可調(diào)用函數(shù)，掃描系統(tǒng)調(diào)用SAP系統(tǒng)提供的函數(shù)，執(zhí)行出庫過賬等操作。
如果接口這樣設(shè)計(jì)，作為業(yè)務(wù)顧問，就需要寫清楚調(diào)用函數(shù)的業(yè)務(wù)參數(shù)，并由SAP開發(fā)人員開發(fā)好相應(yīng)函數(shù)給對(duì)方系統(tǒng)，用以發(fā)生業(yè)務(wù)時(shí)的調(diào)用。
結(jié)合我們之前的舉例，我們采購訂單收貨的接口，SAP就是數(shù)據(jù)的接收方，如果為了保證數(shù)據(jù)的絕對(duì)一致，也可以設(shè)置此方式。
b.先存儲(chǔ)，再處理
有時(shí)候?yàn)榱吮ＷC系統(tǒng)的處理業(yè)務(wù)的及時(shí)性，和系統(tǒng)一定程度上的獨(dú)立性，當(dāng)我們不希望數(shù)據(jù)的發(fā)出方系統(tǒng)，不收系統(tǒng)接收方數(shù)據(jù)的影響時(shí)，會(huì)建議數(shù)據(jù)接收方系統(tǒng)，先將收到的數(shù)據(jù)存起來即可，后續(xù)系統(tǒng)的接收方自行處理。
還是以之前的業(yè)務(wù)舉例，當(dāng)收貨系統(tǒng)做了收貨以后，將數(shù)據(jù)傳輸給SAP，SAP系統(tǒng)可以先將數(shù)據(jù)存儲(chǔ)在自建表中，之后按照順序逐一進(jìn)行收貨的操作。
這種先存儲(chǔ)再處理的方式，可以直接將數(shù)據(jù)存儲(chǔ)在自定義表中，如果接口是文件傳輸?shù)哪Ｊ?，可以直接存?chǔ)中間文件。
如果是這種方式，我們?cè)趯懝δ荛_發(fā)說明書的時(shí)候，就需要設(shè)計(jì)相應(yīng)的自定義表，以及相應(yīng)的程序讀取自定義表中的數(shù)據(jù)，進(jìn)行相應(yīng)的系統(tǒng)操作。這個(gè)功能可能是ALV報(bào)表格式+調(diào)用業(yè)務(wù)處理的函數(shù)（BDC程序）等的執(zhí)行。
還要注意，這種接口數(shù)據(jù)的處理方式，需要小心數(shù)據(jù)的不一致性，比如，當(dāng)外部系統(tǒng)做了出庫，傳輸相應(yīng)數(shù)據(jù)給SAP，SAP系統(tǒng)只是存了起來，還沒有做出庫的操作，但外部系統(tǒng)默認(rèn)已經(jīng)出庫成功，并且已經(jīng)按照之后的業(yè)務(wù)流程進(jìn)行了，此時(shí)，當(dāng)SAP利用傳輸?shù)臄?shù)據(jù)出庫時(shí)，發(fā)現(xiàn)數(shù)據(jù)有問題，無法出庫，這個(gè)時(shí)候就會(huì)出現(xiàn)同一筆業(yè)務(wù)，在不同系統(tǒng)中的業(yè)務(wù)狀態(tài)不一致，數(shù)據(jù)不一致等問題。
2.接口數(shù)據(jù)設(shè)計(jì)
接口數(shù)據(jù)的設(shè)計(jì)，其實(shí)我們可以理解為哪些數(shù)據(jù)需要通過接口被傳輸出去。
比如，上述舉例中，采購訂單的傳輸，假定在收貨系統(tǒng)中掃描收貨時(shí)，需要校驗(yàn)這批貨物的供應(yīng)商ID，物料編號(hào)，供貨數(shù)量，以及送貨日期，是否與原采購訂單上的信息一致，如果一致才能收貨。
如果是這種情況，這個(gè)采購訂單信息的傳輸接口至少包含：采購訂單號(hào)、行項(xiàng)目號(hào)、供應(yīng)商號(hào)、物料號(hào)、采購數(shù)量、到貨日期等基本信息。
在接口數(shù)據(jù)設(shè)計(jì)的信息中，我們需要將每個(gè)要傳輸?shù)淖侄晤愋?、長度、字段說明等信息羅列清楚。
下圖只是一個(gè)簡單舉例，實(shí)際業(yè)務(wù)中，說明的內(nèi)容要非常詳細(xì)。
如果是中間文件的接口方式，我們需要清楚地說明文件格式，文件中每個(gè)字段的具體作用等。從而確保信息能夠被有效地傳遞給開發(fā)人員，開發(fā)人員就能夠根據(jù)文檔信息生成相應(yīng)格式的數(shù)據(jù)文件，或者根據(jù)相應(yīng)格式解析對(duì)方系統(tǒng)傳輸過來的數(shù)據(jù)文件。
3.接口技術(shù)實(shí)現(xiàn)
系統(tǒng)接口的實(shí)現(xiàn)方式，這里就不做進(jìn)一步的解釋了，大家可以參考之前文章進(jìn)行理解。
4.總結(jié)
當(dāng)我們能夠?qū)Y(jié)合系統(tǒng)接口的設(shè)計(jì)邏輯，對(duì)用戶的接口業(yè)務(wù)需求進(jìn)行合理分析，并按照上述的核心內(nèi)容形成相應(yīng)文檔，基本上就能將自己的思路有效地傳遞給開發(fā)，以及相應(yīng)的接口系統(tǒng)。
多數(shù)項(xiàng)目中，也有專門的文檔：接口協(xié)議（interface contract），用于管理接口設(shè)計(jì)中，主要和外部系統(tǒng)相關(guān)的部分，這類文檔主要包含了：接口的基本架構(gòu)，數(shù)據(jù)流向，以及系統(tǒng)間的字段對(duì)應(yīng)關(guān)系等。
好了，本篇就先寫到這里吧，后面有機(jī)會(huì)給大家分享，接口相關(guān)的功能開發(fā)說明書在編寫時(shí)，要注意哪些核心問題。
1、致力于SAP ERP系統(tǒng)應(yīng)用的服務(wù)商；
2、已為國內(nèi)200多家SAP系統(tǒng)客戶的ERP信息化建設(shè)提供了咨詢及實(shí)施服務(wù)；
3、擁有完善的產(chǎn)品策劃、研發(fā)、實(shí)驗(yàn)、測(cè)試、質(zhì)量控制過程；
4、公司自主研發(fā)的AMS系列軟件產(chǎn)品是國內(nèi)首個(gè)用于SAP權(quán)限風(fēng)險(xiǎn)識(shí)別的增強(qiáng)系統(tǒng)；
5、為用戶管理、風(fēng)險(xiǎn)規(guī)避和信息審計(jì)提供輔助工具；
6、幫助用戶規(guī)范企業(yè)的管理行為，建立合規(guī)的管控流程，有效提高企業(yè)IT資產(chǎn)投資回報(bào)率；
7、技術(shù)指標(biāo)上擁有完全的、獨(dú)立的領(lǐng)先優(yōu)勢(shì)，可以滿足市場(chǎng)競爭、技術(shù)許可和標(biāo)準(zhǔn)制定等方面的需要；
標(biāo)簽：
#SAP系統(tǒng)#
#ERP系統(tǒng)#
