RF Programming Guide

8/12/2019 RF Programming Guide

1/35

November 2000

SAP AG

Neurottstrasse 16

69190 WalldorfGermany

Mobile Data Entry (RadioFrequency)

Programming Guideline: Radio re!uen"y A##li"ations

Please contact Chris Roediger ([email protected])or

Christoh !essmoellmann (e-mail" [email protected])#rom Product Management $uly Chain

Management #or your #eedbac%.


2/35

Programming Guideline: Radio Frequency Applications

Coyright

$o#yrig%t 2000 SAP AG& All rig%ts reserved&

No #art of t%is do"umentation may be re#rodu"ed or transmitted in any form or for any #ur#ose'it%out t%e e(#ress #ermission of SAP AG&

)%e information "ontained %ere may be "%anged 'it%out #rior noti"e&

SAP AG ...... Version 1.0 Novemer !000 Page ! o" #$


3/35



C&'E'$

1 INTRODUCTION..............................................................................................................

1.1 Audience....................................................................................................................1.! Release %ependent %evelopment..............................................................................1.# Furt&er %ocumentation...............................................................................................

2 INTRODUCTION INTO RADIO FREQUENCY (RF).........................................................

!.1 'ntroduction into RF....................................................................................................!.! ()isting Functions......................................................................................................

3 DESIGNING RADIO FREQUENCY APPLICATIONS.......................................................

#.1 *ne +ransaction , %i""erent %isplays.........................................................................3.1.1 Dynamic Screen Call............................................................................................

#.1.1.1 -ogical and P&ysical Screens..........................................................................................................................#.1.1.! ser ()it............................................................................................................................................ ......... ....

#.! Screen Navigation......................................................................................................3.2.1 Screen Types.......................................................................................................3.2.2 Screen Procedure..............................................................................................10

#.# Screen /reation: SAPGui vs. RF %evices................................................................3.3.1 Screen Flow.......................................................................................................3.3.2 Screen Logic.......................................................................................................3.3.3 Message Mechanism..........................................................................................3.3. !rror "andling....................................................................................................3.3.# $%S&$%'..........................................................................................................3.3.( Special )*+ec,s..................................................................................................12

#. %ynamic enu..........................................................................................................#.$ ser2System 'nteraction...........................................................................................

3.5.1 User Input ............................................................................................................1#*&+&1&1 $%anging t%e un"tion ,eys in t%e G-. Status....................................................................................................*&+&1&2 /nter un"tion ,ey..........................................................................................................................................

3.5.2 System Feedback...................................................................................................1-3.5.3 User Support: F1 Field Help and F4 Value Input Help..............................................1-

4 OVERVIEW DESIGN PRINCIPLES FOR RF APPLICATIONS.......................................

.1 Not Supported Features on /&aracter /ell +erminals...............................................! Guideline Summary..................................................................................................

5 BASIC OBJECTS RECOMMENDED FOR TE RF DEVELOPMENT..........................

! DEVELOPING RADIO FREQUENCY APPLICATIONS..................................................

3.1 Guide "or t&e RF %evelopment in Releases Prior to 34..........................................3.! Step2y2step Guide "or t&e RF %evelopment 5Release 67 348...............................

(.2.1 Deelopmen, Class............................................................................................2/(.2.2 epor,................................................................................................................2/(.2.3 Transac,ion.........................................................................................................32(.2. Screen................................................................................................................32(.2.# '& S,a,us..........................................................................................................33

SAP AG . .. .. . Version 1.0 Novemer !000 Page # o" #$


4/35



1 I"#$%&'#%"

1.1 A'&*"*

)%is do"ument is intended for SAP develo#ers #artners and "ustomers '%o im#lement radiofre!uen"y R in different a##li"ation areas andareas& .tdes"ribes all t%e ste#s t%at %ave to be

#erformed to develo# R a##li"ations& )%e do"ument lists t%e s#e"ifi" re!uirements t%at must beta3en into "onsideration '%en develo#ing in t%e mobile environment& .t tries to giveenvironment andgivesan overvie' of t%e most im#ortant guidelines to design useful and useable a##li"ations&

4evelo#ers outside SAP "an often not use t%e tools and te"%ni!ues t%at SAP develo#ers %ave at t%eirdis#osal& )%is #rogramming guideline s%o's t%em %o' R transa"tions s%ould loo3 li3eand '%i"%s"reen elements "an be used&

)%is guide #rovides a list of ob5e"ts t%at "an be t%e frame'or3 for t%e R develo#ment& .t "ontainsalso information on t%e en%an"ement of e(isting fun"tions by "ustomers t%e user e(its&

1.2 R*+*,-* D**"&*"# D*/*+%0*"#

e a'are of t%e different releases in '%i"% R a##li"ations in SAP %ave been develo#ed so far& .nea"% release you are "onfronted 'it% a different 'or3ing environment and #rere!uisites& 7ou "anmainly distinguis% t%ree #%ases:

Releases #rior to 86b '%ere no R e(isted and in '%i"% you must start your develo#mentfrom s"rat"% sin"e you "annot base on e(isting fun"tionality& )%e instru"tions mentioned in"%a#ter + asi" b5e"ts /ssential for t%e R 4evelo#ment; "an sim#lify matters sin"e t%ey%el# you to im#lement t%e %eart; of t%e R develo#ment a #a"3age of t%e basi" fun"tionsand tables in your develo#ment system


5/35



2 I"#$%&'#%" I"#% R,&% F$*'*" (RF)

2.1 I"#$%&'#%" "#% RF

)%e R solution #rovides fast and error?free data "ommuni"ation and mobile data "olle"tion t%roug%t%e use of mobile R devi"es& )y#i"al R devi"es are %and%eld terminals bar"ode s"anners andtru"3?mounted terminals for e(am#le for3lift tru"3s& R devi"es re"eive data via radio 'avesdire"tly from t%e SAP System and transmit t%e results ba"3 to t%e system& 7ou "an s"an t%einformation t%at needs to be re"orded su"% as storage unit numbers using a bar"ode for e(am#le

based on -$$


6/35



t%e %ost "om#uter& Real time data "an be "a#tured "lose to material flo's ma3ing t%e use of #a#erlists obsolete&

SAP AG . .. .. . Version 1.0 Novemer !000 Page 3 o" #$


7/35



3 D*-"" R,&% F$*'*" A+,#%"-

or mobile a##li"ations it is very im#ortant t%at t%e fun"tionality develo#ed is easy to use& )%e user

%as a limited area on %is devi"e t%at "an be used for orientation and navigation& e s%ould re"ogniBe%is tas3 on t%e first vie' and be able to a""om#lis% it 'it% as littlefe'3eystro3es as #ossible& ,ee#al'aysAl'ays 3ee#in mind: =inimiBing t%e in#ut effort ma(imiBes t%e effi"ien"y related to t%e useof R terminals&

)%e guidelines #rovided in t%is "%a#ter refle"t t%e 'ay in '%i"% t%e e(isting R a##li"ations %avebeen "reated& $ertainly t%is is not t%e sim#lest and not t%e fastest met%od& .n t%e Ste#?by? ste#guide; in "%a#ter 6 'e outline t%e s%ort met%od you "an "%oose to "reate a fun"tioning Ra##li"ation&

3.1 O"* T$,"-,#%" 6 D77*$*"# D-+,-

SAP$onsole is anSAP integrated utility t%at is aimed at non?standard #resentation environmentssu"% as "%ara"ter?"ell user interfa"es t%at are re!uired for t%e ma5ority of R terminals& Any s"reenmay be dis#layed on bot% SAPGui and "%ara"ter "ell s"reens& )%e "%ara"ter "ell standard 'ill serveas "ommon denominator& elo' you see a fe' s"reens%ots '%i"% s%o' you t%e differen"e in t%edis#lay bet'een t%e SAPGui and t%e SAP$onsole and t%e different s"reen siBes&)%e usage of t%e SAP$onsole does not re!uire any additional develo#ment effort& Any s"reen t%at"an be dis#layed 'it% t%e SAPG-. "an also be dis#layed using t%e SAP$onsole 'it% somerestri"tions t%at are mentioned in "%a#ter 8&"%a#ter 8&

)%e R solution su##orts t%e "reation of transa"tions for different s"reen siBes& )%e standard s"reensiBes are designed for for3lift?mounted devi"es @C80 and for %and%elds 16C20& .n addition t%e

user %as t%e o#tion to tailor t%e s"reens to t%e needs of t%e o#erator and t%e a"tivity %e is #erformingfor e(am#le to omit fields to add fields or to "%ange t%e se!uen"e of t%e fields dis#layed& )%es"reen siBe s%ould be dynami"ally sele"ted a""ording to t%e user #rofile& Su"% fle(ibility re!uires"ertain guidelines t%at must be "onsidered '%en "reating t%e res#e"tive s"reens&

All t%e s"reens s%ould be "onsistent regarding t%e layout as 'ell asandt%e information given& )%egeneral; #us%buttons t%at a##ear on most of t%e s"reens must al'ays be lo"ated at t%e same #la"e&)%e user s%ould not be for"ed to loo3 for t%e 1 SAD/ button al'ays in a different #la"e& .fverifi"ation fields are used to verify data t%ey s%ould be #la"ed on t%e rig%t side of t%e field to beverified&

Not to overload t%e s"reens 'it% information is even more im#ortant for R a##li"ations t%an for t%e

usual a##li"ations& )%e field names s%ould be as s%ort as #ossible or in ot%er 'ords only as long asne"essary&Nevert%elesso'everit is im#ortant not to abbreviate t%e names in su"% a 'ay t%at t%euser doesnEt understand t%em& .f t%e limited s#a"e re!uires an abbreviation use only 'ell?3no'nabbreviations&



8/35



Dislay $P*ui +s. $PConsole and di##erent screen si,es

$creen si,e /0"

$creen si,e 1230"

SAP AG . .. .. . Version 1.0 Novemer !000 Page o" #$

un"tion 3eys %ave a ma(imal lengt% of 9digits bra"3ets "an be disabled to save t%es#a"e for t%e number


9/35



#.1.1 %ynamic Screen /all

)%e #arallel su##ort of more t%an one s"reen siBe is solved in t'o different 'ays: logi"al s"reennumber and user e(its&

3.1.1.1 Logical and Physical Screens

/a"% R s"reen %as a uni!ue logi"al number s#e"ified in a database table& .n an additional table t%erelation bet'een logi"al s"reens and #%ysi"al s"reens is defined& )%e userEs "urrent devi"e "om#letest%e logi"al?#%ysi"al data stru"ture&W%en logging on to t%e system t%e userEs devi"e is derived as defined in t%e user #rofile&A""ording to t%is t%e user gets t%e res#e"tive #%ysi"al s"reen for ea"% logi"al s"reen %e is "alling&)%erefore t'o users "an get different s"reen siBes for t%e same transa"tion if t%ey use different Rdevi"es&

3.1.1.2 User Exit

.f t%e "ustomer 'ants to develo# s"reens different in siBe and


10/35



#.!.! Screen Procedure

At ea"% loo# t%e "ontrol is given to one of t%e t%ree s"reen #ro"edures: entry sour"e and destination&/a"% s"reen #ro"edure is a "ombination of t'o ste#s: $all s"reen '%i"% is follo'ed by "%e"3 s"reen&)%e first gat%ers t%e data from t%e user and t%e latter analysesanalyBesit&)%erefore t%ese t'o routines are al'ays one after t%e ot%er:

Call Screen:)%is subroutine "alls t%e re!uired s"reen and dis#lays t%e re!uired fields& )%ent%e user "an enter t%e re!uired values t%at 'ill be sent to t%e "alling #rogram toget%er 'it%t%e additional data fun"tion "ode "urrent field et"&&

Check Screen:After a"!uiring t%e information from t%e s"reen a series of validation "%e"3sis e(e"uted& .n "ase t%e data fulfills t%e #redefined rules t%e business e(e"ution "ontinues&)%ereu#on a "%e"3 s"reen subroutine e(e"utes t%e re!uired business fun"tion&

efore returning t%e "ontrol to t%e #rogram "%e"3 s"reen subroutine defines t%e ne(t s"reen tobe #ro"essed& .t "an be any of t%e s"reen ty#es in"luding t%e message s"reens&

$creen Flo4

/ n t r y S " r e e n

S o u r " e s " r e e n

4 e s t i n a t i o n s " r e e n

E n t r y

$ c r e e n 5

$ o u r c e 6

D e s t i n a t i o n

Y E S

S o u r c e

D e s t i n a t i o n

P / R : R = $ A > > F S $ R / / N F 0 6 + 0 &

P / R : R = $ / $ , F S $ R / / N F 0 6 + 0 &

P / R : R = $ A > > F S $ R / / N F C C C C &

P / R : R = $ / $ , F S $ R / / N F S : - R $ / &

P / R : R = $ A > > F S $ R / / N F C C C C &

P / R : R = $ / $ , F S $ R / / N F 4 / S ) &

3.3 S$**" C$*,#%"8 SAPG' /-. RF D*/*-



11/35



)%e s"reen #ainter is t%e AAPWor3ben"% tool t%at allo's you to "reate s"reens for yourtransa"tions& 7ou use it to "reate t%e s"reen itself 'it% fields and ot%er gra#%i"al elements and to'rite t%e flo' logi" be%ind t%e s"reen&.n general t%e s"reen #ainter vie' refle"ts %o' t%e des3to# a##li"ation s"reen s%ould a##ear& )%is is

not valid for R devi"es& )%e SAPGui su##orts features t%at are %ard or even im#ossible toim#lement in a "%ara"ter "ell environment& e"ause of t%is limitation t%e R develo#ment must uses#e"ial met%ods and routines and "ertain G-. ob5e"ts&

#.#.1 Screen Floist o(

$%e"3bo(es: Sin"e #ointing devi"es are not al'ays available t%e "%e"3ing of t%ese bo(es

s%ould be ta##ed by fun"tion 3eys&

Radio uttons

)able $ontrol

."ons

5.2 G'&*+"* S'00,$

)%e user intera"ts 'it% t%e system via #us%buttons '%i"% must be assigned a""ordingly in

t%e G-. status

Ad5ust your s"reen elements and t%e s"reen layout to t%e devi"e siBe

$reate a menu for navigation #ur#oses

4onEt forget t%at no 1 el# 8 .n#ut el# and no message long te(t is available

.f you 'ant to ad5ust t%e s"reen siBe to your devi"e siBe you s%ould 'or3 'it% a logi"al vs&

#%ysi"al s"reen stru"ture

-se t%e user e(its to tailor an e(isting s"reen to your needs to dea"tivate fun"tion "odes or

to enable t%e #rint fun"tion

SAP AG . .. .. . Version 1.0 Novemer !000 Page 1; o" #$


20/35



! B,- O;


21/35



7ie4 o# the Dynamic Menu able" 789190

$ustomiBing table used to "%ange and u#date t%e menu& /a"% user "an tailor t%e menua""ording to %is needs&

SAP AG . .. .. . Version 1.0 Novemer !000 Page !1 o" #$


22/35



e;t able #or the Dynamic Menu" 9190:

)%is table "ontains t%e te(t for t%e menus in t%e different languages&

ield 4omain 4ata element Remar3s

1& =AN4) =AN4) =AN4) Already Available

2& SPRAS S7>ANG- S7>ANG- Already Available

*& >GN-= >GN-= >GN-= Already Available

8& ==/N- )$4/ S7)$4/ Already Available

+& S/K-/N$/ RFS/K RFS/K >abel: Se!& no&

6& )/C) )/C)80 =4)/C) >abel: =enu )e(t

L& S)/C) )/C)20 =4S)/C) >abel: S%ort te(t

$R


23/35



/(am#le for #us%button data element de"laration:

ield 4omain 4ata element Remar3s

1& PSAD/ >DSF4,- =SAD/ 1 P for save

2& P$>/AR >DSF4,- =$>/AR 2 P for "lear

*& PA$, >DSF4,- =A$, * P for ba"3

8& PN/C) >DSF4,- =N/C) 8 P for ne(t

)%ese are data di"tionary de"larations for t%e first four #us%buttons similar de"laration areused for additional #us%buttons + 6 et"&

SAP AG . .. .. . Version 1.0 Novemer !000 Page !# o" #$


24/35



Dynamic Menu $creen"

ransaction" se=1 Program" R!ME'< $creen" 0

)%e follo'ing is t%e element attributesE dis#lay of t%e first and se"ond #us%button:

)%e S"reen lo' logi":

PR$/SS /R/ -)P-)&

=4->/ S)A)-SF=A.N=/N-&

=4->/ 47NA=.$F=/N-F-))NSF)/C)&

PR$/SS A)/R .NP-)&

./>4 ,F$4/ =4->/ -S/RF$==AN4F=A.N=/N-&

MH?????????????????????????????????????????????????????????????????????M

SAP AG . .. .. . Version 1.0 Novemer !000 Page ! o" #$


25/35



MH =odule 47NA=.$F=/N-F-))NSF)/C) -)P-)

MH?????????????????????????????????????????????????????????????????????M

M andles dynami" te(t on t%e menu #us% buttons

M??????????????????????????????????????????????????????????????????????M

=4->/ 47NA=.$F=/N-F-))NSF)/C) -)P-)&

=/N-F.4 OJJRO&

C-S/R?4/D)7 O0@C80O&

$>/AR: )/C)1)/C)2)/C)*)/C)8)/C)+)/C)6&

$A)$ S7S)/=?/C$/P).NS $ND/RS.NF/RRRS 01&

S/AR$ C-S/R?4/D)7 R OCO&

CFPS.).N S7?4PS 1&

=D/ C-S/R?4/D)7CFPS.).N ) 4/D.$/F$>-=NS&

4/D.$/F$>-=NS 4/D.$/F$>-=NS ? 2&

S/>/$) M R= J)*1*0A .N) )A>/ )F)*1*0A

W/R/ ==/N- =/N-F.4&

/N4$A)$&

$AS/ S7?S-R$&

W/N 01&

W/N )/RS&

/N4$AS/&

S/>/$) M R= J)*1*0 W/R/ SPRAS S7?>ANG-

AN4 ==/N- =/N-F.4&

M?Q $ombining t%e te(t 'it% its se!uen"e&

$N$A)/NA)/ J)*1*0?S/K-/N$/11 O& O J)*1*0?)/C)

.N) =4../4F)/C)&

)/C)F>/NG) S)R>/N =4../4F)/C) &

. 4/D.$/F$>-=NS N/ 0&

. )/C)F>/NG) G) 4/D.$/F$>-=NS&

=D/ =4../4F)/C)04/D.$/F$>-=NS ) =4../4F)/C)&

/N4.&

R/A4 )A>/ )F)*1*0A W.) ,/7 >GN-= J)*1*0?>GN-=

==/N- J)*1*0?==/N-

SAP AG . .. .. . Version 1.0 Novemer !000 Page !$ o" #$


26/35



S/K-/N$/ J)*1*0?S/K-/N$/&

4)FPS.).N 4/D.$/F$>-=NS ? 1&

. )F)*1*0A?PRF)7P O1O&

=D/ )F=/N-FS.GN ) =4../4F)/C)4)FPS.).N1&

/>S/&

4 N-=FF4)S ).=/S&

=D/ =4../4F)/C)4)FPS.).N1 ) N/C)$R&

. N) N/C)$R .S .N.).A>&

/C.)&

/N4.&

=D/ )F)RANSA$).NFS.GN ) =4../4F)/C)4)FPS.).N1&

4)FPS.).N 4)FPS.).N ? 1&

/N44&

/N4.&

/N4.&

$AS/ J)*1*0?S/K-/N$/&

W/N 1&

)/C)1 =4../4F)/C)&

W/N 2&

)/C)2 =4../4F)/C)&

W/N *&

)/C)* =4../4F)/C)&

W/N 8&

)/C)8 =4../4F)/C)&

W/N +&

)/C)+ =4../4F)/C)&

W/N )/RS&

)/C)6 =4../4F)/C)&

/N4$AS/&

/N4S/>/$)&

/N4=4->/& 47NA=.$F=/N-F-))NSF)/C) -)P-)

MH?????????????????????????????????????????????????????????????????????M



27/35



MH =odule -S/RF$==AN4F=A.N=/N- .NP-)

MH?????????????????????????????????????????????????????????????????????M

M Navigation from main menu

M??????????????????????????????????????????????????????????????????????M

=4->/ -S/RF$==AN4F=A.N=/N- .NP-)&

$AS/ ,F$4/&

W/N $4/F$>/AR&

>/AD/ ) )RANSA$).N S7?)$4/&

W/N $4/FN/C)&

R/A4 )A>/ )F)*1*0A W.) ,/7 S/K-/N$/ ,F$4/&

. S7?S-R$ N/ 0&

=/SSAG/ .4 O=LO )7P/ O/O N-=/R O01+O&

/C.)&

/N4.&

$A>> )RANSA$).N )F)*1*0A?=/NF)RANS&

W/N )/RS&

M?Q Retrieve t%e relevant trans& from )*1*0A

R/A4 )A>/ )F)*1*0A W.) ,/7 S/K-/N$/ ,F$4/

==/N- =/N-F.4&

. S7?S-R$ N/ 0&

/C.)&

/N4.&

$A>> )RANSA$).N )F)*1*0A?=/NF)RANS&

/N4$AS/&

/N4=4->/& -S/RF$==AN4F=A.N=/N- .NP-)

he #ollo4ing D declarations should be included in the o include:

4A)A =4../4F)/C) >.,/ )*1*0?)/C)&

4A)A N/C)$R1 )7P/ $&

4A)A 4/D.$/F$>-=NS )7P/ . DA>-/ 0&

4A)A )/C)F>/NG) )7P/ .&



28/35



4A)A CFPS.).N )7P/ .&

4A)A 4)FPS.).N )7P/ .&

4A)A )F)*1*0A >.,/ )*1*0A $$-RS 20 W.) /A4/R >.N/&

4A)A C-S/R?4/D)710 )7P/ $&

4A)A =/N-F.4 >.,/ )*1*0A?=/NF)RANS&

4A)A $-RSR./>420 )7P/ $&

M&&&&&&&&$onstants&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&M

$NS)AN)S:

)F=/N-FS.GN1 )7P/ $ DA>-/ OQO

)F)RANSA$).NFS.GN1 )7P/ $ DA>-/ O&O

N-=FF4)S )7P/ . DA>-/ *&

M&&&&&&&&)e(tOs for dynami" menu&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&M

4A)A: )/C)1 >.,/ )*1*0?)/C)

)/C)2 >.,/ )*1*0?)/C)

)/C)* >.,/ )*1*0?)/C)

)/C)8 >.,/ )*1*0?)/C)

)/C)+ >.,/ )*1*0?)/C)

)/C)6 >.,/ )*1*0?)/C)&

SAP AG . .. .. . Version 1.0 Novemer !000 Page ! o" #$


29/35



= D*/*+%" R,&% F$*'*" A+,#%"-

=.1 G'&* 7%$ #* RF D*/*+%0*"# " R*+*,-*- P$%$ #% 4!B

)o start your 'or3 "o#y t%e basi" ob5e"ts t%at are essential for t%e R develo#ment into yourdevelo#ment system& Refer to "%a#ter +&irst "reate t%e 44.$ ob5e"ts J)*1*0A JDF)*1*0A J)*1*0 and JR>=&

Note: t%e ob5e"ts J)*1*0A JDF)*1*0A and J)*1*0 e(ist in order to su##ort t%e dynami"menu t%is feature is not essential to su##ort your R develo#ment but it is ni"e to %ave& )%eJR>= ob5e"t is essential to su##ort t%e #us%buttons on t%e s"reen I t%e fun"tion 3eys&ollo' t%e ste#?by?ste# guide in "%a#ter 6&2& /(e"ute all ste#s 'it% t%e follo'ing differen"es:

Add t%e additional data de"larations to JR)P refer to "%a#ter + only if you '%is% to in"lude t%e

dynami" menu in your develo#ment&

$reate a dialog transa"tion t%at triggers s"reen JR)/S) 0@@@ '%i"% is t%e menu s"reen& Refer to"%a#ter +for t%e layout and t%e flo' of t%e s"reen&

4o not "reate re#ort JR/PF/RRRFAN4>/ t%e errors are "alled in t%e follo'ing 'ay:

=/SSAG/ .4 S7?=SG.4 )7P/ S7?=SG)7 N-=/R S7?=SGN

After maintaining t%e entries in t%e tables you s%ould be able to navigate from t%e menu to t%etransa"tion youEve "reated&

=.2 S#*9;9-#* G'&* 7%$ #* RF D*/*+%0*"# (R*+*,-* >? 4!B)

)%e follo'ing e(am#le s%o's ste#?by?ste# t%e "reation of an R a##li"ation derived from t%e.nventory =anagement transa"tion mb1b: )ransfer Posting& $reating an R transa"tion similar to t%emb1b re!uires additional #rere!uisites and "ustomiBation of t%e system not related to t%e R"on"e#t&Sin"e t%is a guide fo"used on t%e R develo#ment 'e leave t%e "ustomiBing out of "onsideration&)%e #ur#ose of t%e follo'ing e(am#le is only to des"ribe t%e ste#s one %as to ta3e in order to "reatea transa"tion& )%e "oding is 5ust a "on"e#t illustration and does not fulfill all "onditions for an a"tualmovement in t%e system&

9.!.1 %evelopment /lass

$reate a develo#ment "lass in t%e "ustomerEs names#a"e&

9.!.! Report

Go to se*@: AAP /ditor$reate an e(e"utable #rogram& )%is #rogram s%ould "ontain t%e business logi" for t%e transa"tion&)%e follo'ing e(am#le s%o's a sim#lified re#ort and "ontains detailed "omments&)%e JR)/S) is t%e main #rogram for t%e transa"tionJR)P is an in"lude t%at %olds all data de"larationsJR/PF/RRRFAN4>/ is a re#ort t%at is submitted from t%e main #rogram for /rror < =essages%andling&

SAP AG . .. .. . Version 1.0 Novemer !000 Page !; o" #$


30/35



R/PR) JR)/S) &

M )%is re#ort is triggered by a re#ort transa"tion&M A s"reen is "alled and bot% P H PA. modules areM %andled in t%e re#ort

M )%e four elements for t%e R transa"tion areM 1& Re#ort 2& Re#ort transa"tion *& S"reen 8& G-. Status

M )%is in"lude %olds re!uired data de"larations

.N$>-4/ JR)P&

M .t is #ossible to "all t%e s"reen dynami"ally via fun"tionM as #erformed in t%e standard R&

$A>> S$R//N O0100O&

MH????????????????????????????????????????????????????????????MH =odule S)A)-SF0100 -)P-)MH????????????????????????????????????????????????????????????M G-. Status t%at su##orts t%e fun"tion 3eysM )%is module is "alled from t%e P of t%e s"reenM?????????????????????????????????????????????????????????????

=4->/ S)A)-SF0100 -)P-)& S/) P?S)A)-S OJJRFS)A)-S2O& S/) ).)>/AR OS7?47NNRO&

/N4=4->/& S)A)-SF0100 -)P-)

MH???????????????????????????????????????????????????????????MH =odule -S/RF$==AN4SF0100 .NP-)MH????????????????????????????????????????????????????????????M andling t%e #eration #erformed by t%e userM )%is module is "alled from t%e PA. of t%e s"reenM?????????????????????????????????????????????????????????????

=4->/ -S/RF$==AN4SF0100 .NP-)&

M /a"% fun"tion 3ey on t%e s"reen %olds a fun"tion "ode

$AS/ ,F$4/&

W/N $4/FSAD/&

M -sing .= fun"tions to build an .= R transa"tion

$A>> -N$).N O=F$R/A)/FG4SF=D/=/N)O

/CPR).NG .=,P .=,P $)$4 O=1O .=PR).NG /=,P /=,P )A>/S /=S/G /=S/G .=S/G .=S/G /C$/P).NS )/RS 1&

$AS/ /=,P?S-R$& W/N O1O&

SAP AG . .. .. . Version 1.0 Novemer !000 Page #0 o" #$


31/35



$A>> -N$).N O=FPS)FG4SF=D/=/N)O .=PR).NG /=,P /=,P

/C$/P).NS )/RS 1&

$==.) WR,&

M .n order to send an /rror message t%at 'ill use t%e s"reen SAP>>= 0999 '%i"% serves as a #o#?u# s"reen for error message%andling 'e s%ould "reate an additional re#ort t%at 'ill be res#onsible for #o##ing u# t%is s"reen& .t is not re!uired to "reate t%iss"reen in your #rogram& We 'ill submit t%is re#ort at t%e #oint '%ere 'e '%is% to #resent t%e error and t%en return to our #rogram&.t is re!uired to deliver t%e error message number to t%e submitted re#ort 'e 'ill use t%e S/)/ .N.).A>.J/F4A)A -)P-)&

=,P?-4A) S7?4A)-=& =,P?>4A) S7?4A)-=& R=0L=?WAR)WA O*11O&

$>/AR =S/G?/R=G&

G/) PARA=/)/R .4 OWR,O ./>4 R=0L=?W/R,S& G/) PARA=/)/R .4 O>AGO ./>4 R=0L=?>GR)&

/N4=4->/& .N.).A>.J/F4A)A -)P-)

MMM.N$>-4/ JR)P &

M&&&&&4atabase tables&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&)A>/S: R=0L= =,P =S/G $> =S/G, R>= )*1*0A )*1*0 .=,P /=,P&

M &&&&&/rror %andling&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&

SAP AG . .. .. . Version 1.0 Novemer !000 Page #1 o" #$


32/35



4A)A: =/SSAG/FN-= >.,/ )100?=SGNR&

M&&&&&&&&"odes&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&M4A)A: ,F$4/ >.,/ S7?-$== $4/FA$, >.,/ S7?-$== DA>-/ OA$,O

$4/FSAD/ >.,/ S7?-$== DA>-/ OSAD/O $4/F$>/AR >.,/ S7?-$== DA>-/ O$>RO $4/FN/C) >.,/ S7?-$== DA>-/ ON/C)O&

M&&&&&&&4ifferent #arameters&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&4A)A: =/SSAG/FN-=/R >.,/ )100?=SGNR /RRRF$4/ >.,/ S7?S-R$ PS$RN >.,/ S7?47NNR&

M&&&&&&&.nternal tables&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&& 4A)A /G.N .=S/G $$-RS 0& .N$>-4/ S)R-$)-R/ .=S/G& 4A)A /N4 .=S/G&

4A)A /G.N /=S/G $$-RS 0& .N$>-4/ S)R-$)-R/ /=S/G& 4A)A /N4 /=S/G&

R/PR) JR/PF/RRRFAN4>/&

.N$>-4/ JR)P&M )%is re#ort uses an SAP fun"tion from t%e R module '%i"% "allsM t%e error s"reen&

G/) PARA=/)/R .4 OR.4O ./>4 =/SSAG/FN-=& $A>> -N$).N O$A>>F=/SSAG/FS$R//NO

/CPR).NG .F=SG.4 O>O .F>ANG O/O .F=SGN =/SSAG/FN-= /C$/P).NS .NDA>.4F=/SSAG/1 1 )/RS 2 & . S7?S-R$ Q 0&M =/SSAG/ .4 S7?=SG.4 )7P/ S7?=SG)7 N-=/R S7?=SGNM W.) S7?=SGD1 S7?=SGD2 S7?=SGD* S7?=SGD8& /N4.&

.n order to maintain t%e 4ynami" menu t%e follo'ing re"ord s%ould be inserted to )*1*0A or toJ)*1*0A if release 8&6

=AN4) >GN-= ==/N- S/K-/N$/ PRF)7P =/NF)RANS -S/RF=A.NF=/N- )/C)

$lient W%snum

JJR 01 2 J1 /nrty not Re!uired )ransfer#osting

$lient W%snum

JJR 01 2 J1 /ntry not Re!uired )ransfer#osting

)able )*1*0 s%ould be automati"ally filled using t%e vie' DF)*1*0A&

SAP AG . .. .. . Version 1.0 Novemer !000 Page #! o" #$


33/35



9.!.# +ransaction

Go to se9*: =aintain transa"tion$reate a re#ort transa"tion t%at triggers t%e e(e"utable #rogram t%at you "reated before&

9.!. Screen

se+1: S"reen Painter/nter t%e #rogram name t%at belongs to t%is s"reen& )%e numbering of t%e s"reens is fle(ible only t%euser e(it s%ould get a number starting 'it% 9T&&.f you base your develo#ment on an e(isting standard transa"tion you s%ould orientateyourself ont%e business logi" and elements t%at e(ist in t%is transa"tion and build your R s"reen a""ordingly"onsidering t%e limitations&4esign a dialog "on"e#tU all intera"tion 'it% t%e end user s%ould be done via fun"tion 3eys& .n t%e Rdevelo#ment t%e 1 is used for Save or $onfirm t%e 2 is used for $lear * for a"3 and 8 for

Ne(t& )ry to be as "onsistent as #ossible 'it% t%e fun"tionality of t%e fun"tion 3eys

or every R s"reen add t%e , ty#e in t%e s"reen element list I add ,F$4/ &

&riginal screen o# the transaction" mb1b d>usted RF screen

SAP AG . .. .. . Version 1.0 Novemer !000 Page ## o" #$


34/35



SAP AG . .. .. . Version 1.0 Novemer !000 Page # o" #$


35/35



)%e follo'ing is t%e element attributes dis#lay of t%e 1 I Save Pus%button:

/(am#le for a sim#le flo' logi":

PR$/SS /R/ -)P-)& =4->/ S)A)-SF0100& G-. Status =4->/ .N.).A>.J/F4A)A& Pre#are data on t%e s"reenMPR$/SS A)/R .NP-)&

=4->/ -S/RF$==AN4SF0100& -ser "ommand

Documents

RF Programming Guide