SpotFlow: Tracking Method Calls and States at Runtime
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.