1 read me fs template guidance
Download as DOCX, PDF0 likes66 views
The document provides guidance for using Function Specification templates in Microsoft Word to specify ABAP-based custom developments on SAP systems. Different templates are provided for different types of developments like workflows, reports, interfaces, conversions, enhancements, and forms. The templates prompt the user to replace guidance text in red or curly brackets with their own text. Headers will automatically populate the workstream and development details from the cover page. Users can save the templates to their Custom Office Templates folder to create new documents directly from the templates in Word.
1 read me fs template guidance
- 1. October 2015 FS Templates – Guidance for Use 1 Function Specification (FS) Templates – Guidance for Use These FStemplateshave beendesignedforspecifyingABAP-basedcustomdevelopments,onSAP NetWeaverbasedsystems.Theyare notintendedtospecify: Interface definitionandmappingthatwouldbe definedinmiddleware suchasSAP NetweaverProcessIntegration(PI). Data Migrationobjectssuchas those definedusingSAPDataServicestools. Data objectsforreporting,suchas those createdinSAPBusinessWarehouse (BW),or nativelyonSAPHANA. Reportsor Dashboardsto be createdwithBI toolssuchas SAP Lumira. The FS templatesare savedasMicrosoftWord template(.docm) files. Toactual an actual document, right-clickatemplate andchoose new. To be able tostart newdocumentsdirectlyinWord,follow the instructionsatthe endof this document. Differenttemplateshave beenprovided,whichare eachtailoredtothe differenttypesof ABAP- basedcustomdevelopments.These are basedonthe commonlyused WRICEF(orFRICEFW) acronym: W - Workflow R - Report I - Interface e.g.ABAPorIDOCdevelopmentsneededforanInterface C - ‘Conversion’e.g.afile uploadordownloadprogram E - Enhancement(simple) e.g. single BAdIs,CMODcustomerenhancements,BTEs,VOFM routines - Enhancements(transactionsandapps) e.g.customappsor transactions;changesto standardapps or transactionssuchas addingcustomfields. F - (Print) Forms A - ApplicationsandTransactions Thisapproach wastakenin preference toprovidingone verylongtemplate,where foranygiven developmentmostof the sectionswouldbe irrelevant. Whenusingthe templates, guidance texttobe replacedis shownin redor {curlybrackets}. On the coverpage the Workstreamand WRICEF ID and Description valuesenteredhere will automatically appearinthe headersof the subsequentpages. Onsubsequentpagesyoucanjust type overthe red promptsto replace themwithyourowntext.
- 2. October 2015 FS Templates – Guidance for Use 2 The date fieldonthe coverpage will automaticallypopulate withthe date the documentwaslast saved– so initiallyitwill showzeroes. The templatesmaybe re-branded –e.g.by replacingthe SAPlogointhe page headers,orby adding a customerlogoalongside it. Functional Spec Content Each Functional Specshouldfirstlyrecordthe businessneedandintentof the customdevelopment. Secondlyitshouldprovide the developerwithacleardescriptionof the functionalityrequired.This needstostrike a balance:informationsuchasnamesof tables,BAPIs,BAdIsetctouse certainly shouldbe includedif known.Howeverthe FSshouldnotbe tryingto specifyfine detailsof how to buildthe solution.It’sforthe developertouse theirjudgementtofindthe bestapproachto implementthe functionality,followingthe codingstandardsastheydoso.
- 3. October 2015 FS Templates – Guidance for Use 3 Appendix – Using Custom Templates in MS Word To be able tostart newdocumentsdirectlyinWord, firstsave the templates toyourPCinthe ‘CustomOffice Templates’folderunder‘Documents’(previously‘Mydocuments’): In MS Word go to File ->Optionsthenchoose the Save tab.Ensure the ‘Defaultpersonaltemplates location’ismaintained,e.g. You’ll thenbe able tocreate newdocumentsbasedonthe templatesbychoosingFile ->New,then choosing‘Custom’ –you shouldbe able tosee a file containingyourtemplates:
- 4. October 2015 FS Templates – Guidance for Use 4 In the folderyoucan see all the templatesthatyousavedtoyourfolder,andcan pickthe one that youwant to use.