You are on page 1of 3

SAP Note

Header Data
Symptom
You want t o def i ne user - def i ned f i el ds f or t he r eal est at e cont r act or anot her RE- FX mast er dat a t abl e and di spl ay and change t hemi n t he
mai nt enance di al og.

Other Terms
RECN, REBDBE, REBDPR, REBDBU, REBDRO, REBDAO, RESCPG, RESCSU, REAJ CG

Reason and Prerequisites
Not e:
To r epr oduce t he exampl e of t hi s not e, you must have i mpor t ed Suppor t Package 04 i nt o your syst em. I t cont ai ns t he sampl e f unct i on gr oup
REGC_EXT_EXAMPLE speci f i ed bel ow.

The mast er dat a di al ogs ar e i mpl ement ed wi t h t he Busi ness Dat a Tool set ( BDT) . The Busi ness Dat a Tool set pr ovi des a l ar ge number of ext ensi on
opt i ons. Take car e t hat you onl y use t he ext ensi on opt i ons of t he appl i cat i on i nt er f ace i n t he cont ext of t he r eal est at e
mast er dat a. To i mpl ement user - def i ned checks or save addi t i onal dat a i n user - def i ned t abl es, do not use BDT event s but t he speci f i c
enhancement met hod f or t he r eal est at e mast er dat a ( see I MG document at i on f or t he act i vi t y "I mpl ement enhancement s ( BADI ) " f or t he r espect i ve
obj ect t ype) . Compar ed t o t he pur e BDT sol ut i on t hi s has t he advant age t hat you can execut e, f or exampl e, addi t i onal checks not onl y wi t hi n t he
i nt er f ace but al so dur i ng t he l egacy dat a t r ansf er and i n case of BAPI cal l s.

I n t hi s exampl e, t he pr ocedur e f or addi ng user f i el ds i s descr i bed f or t he cont r act . For busi ness ent i t y ( BE) , pr oper t y ( PR) , bui l di ngs ( BU) ,
r ent al obj ect ( RO) , ar chi t ect ur al obj ect ( AO) , set t l ement uni t ( SU) , par t i ci pat i on gr oup ( PG) and compar at i ve gr oup of apar t ment s ( CG, as of
SAP ECC 5. 0) , you have t o pr oceed accor di ngl y. I n t he t echni cal names ( t r ansact i on, f unct i on gr oup, t abl e, . . . ) you must r epl ace xx by t he
cor r espondi ng obj ect abbr evi at i on speci f i ed her e i n par ent heses.

The BDT appl i cat i on obj ect f or t he cont r act i s cal l ed REGC, and t he one f or t he ot her obj ect s i s cal l ed RExx.

The r espect i ve t abl e names ar e par t i al l y di f f er ent i n Rel ease 470x200 and subsequent r el eases. The l i st bel ow cont ai ns t he obj ect s i ncl udi ng
t hei r t abl es f or Rel ease 470x200 and hi gher :

Solution
The f ol l owi ng exampl e shows t he st eps r equi r ed t o i ncl ude a new user f i el d i n t he r eal est at e cont r act and t o mai nt ai n i t i n t he cont r act
di al og. The exampl e i s based on t he exampl e document ed i n Not e 632104 f or Rel ease 470x110.

Fi r st of al l , make sur e t hat Not e 691511 has been i mpl ement ed i n your syst em. Funct i on gr oup REGC_EXT_EXAMPLE i s i mpor t ed i nt o your syst emwi t h
Suppor t Package 04.

The Busi ness Dat a Tool set st r uct ur es cust omer enhancement s and par t ner enhancement s accor di ng t o appl i cat i ons. I n t he RE envi r onment , t he
appl i cat i on del i ver ed by SAP has t he same name as t he BDT obj ect ( t hat i s, REGC i n t he case of t he cont r act ) . However , t her e may be addi t i onal
appl i cat i ons - f or exampl e, t he f ast ent r y of t he cont r act was i mpl ement ed as appl i cat i on GCFE. By encapsul at i ng appl i cat i ons t hat ar e
f unct i onal l y r el at ed, you can act i vat e or deact i vat e t hemas r equi r ed ( f or exampl e, f or t est pur poses) .
User - def i ned appl i cat i ons must st ar t wi t h Y or Z ( appl i cat i ons by a par t ner st ar t wi t h X) . Come up wi t h a name f or your appl i cat i on. I n t he
f ol l owi ng, abbr evi at i on ZZZZ i s used f or t he appl i cat i on.
1. To i ncl ude one or sever al f i el ds i n t he mast er dat a t abl e, cal l t he ABAP Di ct i onar y ( Tr ansact i on SE11) and di spl ay mast er dat a t abl e
VI CN01 / VI CNCN. I n t he f i el d l i st , sel ect . I NCLUDE CI _VI CNCN ( or . I NCLUDE CI _VI CN01 f or Rel ease 470x200) and pr ess F2.
I f t he st r uct ur e does not cont ai n any f i el ds yet , t he syst emasks you whet her you want t o cr eat e t hese f i el ds. Conf i r mt hi s quest i on wi t h
'Yes'.You reach the maintenance screen where you can enter the required customer fields into the field list. The field names have to be
i n t he cust omer namespace ( st ar t i ng wi t h YY or ZZ) , f or exampl e f i el d YYI D wi t h dat a el ement YYI D ( al so cr eat e "Fi l e number ") . Act i vat e
t he st r uct ur e.
I n gener al , t he name of t he I ncl ude i n whi ch you have t o i ncl ude t he user - def i ned f i el ds i s al ways CI _YYY, YYY i s t he name of t he mast er
dat a t abl e.
I n t hi s st r uct ur e, onl y i ncl ude f i el ds t hat must be st or ed i n t he dat abase. I f you need mor e addi t i onal f i el ds, cr eat e anot her st r uct ur e
f or t hese f i el ds i n t he ABAP Di ct i onar y ( t he name must st ar t wi t h Y or Z) .
2. Di spl ay f unct i on gr oup REGC_EXT_EXAMPLE i n Tr ansact i on SE80. Sel ect t he f unct i on gr oup wi t h t he r i ght mouse but t on and choose ' Copy' .
I n t he cust omer namespace, ent er a f unct i on gr oup as a "New f unct i on gr oup", f or exampl e ZZZZ_REGC_EXT.
Al so sel ect t he names f or t he new f unct i on modul es i n such a way t hat t hey ar e i n t he cust omer namespace, f or exampl e:
690900 - User-defined real estate master data fields as of 470x200
Version 14 Validity: 06.12.2004 - active Language angielski
Released On 06.12.2004 16:11:29
Release Status Released for Customer
Component RE-FX-BD Basic Data
Priority Correction with low priority
Category Exit added
Obj ect Up t o 470x200Hi gher r el ease
Busi ness ent i t y VI OB01 VI BDBE
Pr oper t y VI OB02 VI BDPR
Bui l di ng VI OB03 VI BDBU
Rent al obj ect VI MI 01 VI BDRO
Ar chi t ect ur al obj ect VI BDAO VI BDAO
RE cont r act VI CN01 VI CNCN
Set t l ement uni t VI AK03 VI SCSU
Par t i ci pat i on gr oup VI AK23 VI SCPG
Compar at i ve gr oup of apar t ment s not avai l abl e REAJ CG
Ol d f unct i on modul e New f unct i on modul e
REGC_REGC_EVENT_FMOD2_EXAMPLE ZZZZ_REGC_EVENT_FMOD2
REGC_REGC_PBO_EXAMPLE ZZZZ_REGC_PBO_Z901
REGC_REGC_PAI _EXAMPLE ZZZZ_REGC_PAI _Z901
3. When you copy t he f unct i on gr oup, t he syst emal so copi es a scr een ( subscr een) . I t s number i n t he t empl at e i s 901. Change t he l ayout of
t hi s scr een so t hat you can mai nt ai n t he desi r ed f i el ds. The f i el ds r ef er t o st r uct ur e RECN_CONTRACT_CI whi ch i s gl obal l y def i ned i n t he
f unct i on gr oup and cont ai ns t he f i el ds of t he cust omer I ncl ude ( t he name of t he st r uct ur e i s al ways i ssued i n t he onl y TABLES st at ement of
t he r espect i ve TOP i ncl ude LRExx_EXT_EXAMPLETOP) .
The f l ow l ogi c of t he scr een can r emai n unchanged. I f you st i l l need ot her scr eens, you can cr eat e t hemi n t he same f unct i on gr oup by
copyi ng scr een 901. I n t he same way you can i nser t , i f r equi r ed, ot her modul es i nt o t he f l ow l ogi c and i ncl ude t he sour ce code of t he
cor r espondi ng modul es and subr out i nes i n t he mai n pr ogr amof t he f unct i on gr oup. For each addi t i onal scr een you r equi r e an addi t i onal PBO
and PAI f unct i on modul e i n anal ogy t o REGC_REGC_PBO_Z901_EXAMPLE and REGC_REGC_PAI _Z901_EXAMPLE.
4. Then you have t o make sur e t hat t he syst emdi spl ays your subscr een when you mai nt ai n t he cont r act and t hat t he cor r espondi ng f unct i on
modul es ar e r un.
a) Fi r st of al l , publ i sh your appl i cat i on. For t hi s pur pose, cal l t he f ol l owi ng t r ansact i on f or each appl i cat i on obj ect :
b) Then publ i sh t he scr eens you have def i ned t o t he Busi ness Dat a Tool set . You can f i nd t he cor r espondi ng t r ansact i ons i n t he
Cust omi zi ng menu, Tr ansact i on RECACUST. Fr omt her e you can al so cal l t he t r ansact i ons f or t he ot her obj ect s. Al l set t i ngs ar e
cl i ent - speci f i c and must t her ef or e be t r anspor t ed i nt o al l cl i ent s wher e t hey ar e needed.

For t he mai nt enance of t he ot her BDT Cust omi zi ng ent r i es, you f i nd t he cor r espondi ng ent r i es i n t he I MG f or ever y mai nt enance di al og
i n t he ' Di al og' menu opt i on. For exampl e, t he compl et e di al og f or t he cont r act i s
' Fl exi bl e Real Est at e Management - > Cont r act - > Di al og'

Cr eat e a new f i el d gr oup f or your f i el ds by choosi ng I MG act i vi t y ' Di al og - > Scr een Layout - > Fi el d Gr oups - > Fi el d Gr oups' . Choose
a number st ar t i ng wi t h 7, f or exampl e 701. I n t he ' Gener al dat a' ar ea, ent er a mnemoni c name i n t he ' Descr i pt i on' f i el d f or your new
f i el ds, f or exampl e ' Fi l e number ' . I n addi t i on, ent er t he name of t he f unct i on modul e f r ompoi nt 2 ( ZZZZ_REGC_EVENT_FMOD2) i n f i el d
' FM f or f l d gr oupi ng' . You can l eave t he r emai ni ng f i el ds empt y. Doubl e- cl i ck ' Fi el d Gr oup - > Fi el ds' i n t he di al og st r uct ur e f or
t he new f i el d gr oup and assi gn al l f i el ds of t he subscr een t o t he f i el d gr oup, f or exampl e:
Tabl e: RECN_CONTRACT_CI
Fi el d name: YYI D
I nput f i el d: sel ect ed ( Thi s checkbox must be sel ect ed f or al l f i el ds t hat ar e r eady f or i nput . I n addi t i on, t hese f i el ds must be
def i ned as i nput f i el ds i n t he Scr een Pai nt er ) .
When you save, t he syst emdi spl ays a war ni ng message whi ch you can i gnor e.
c) Cr eat e a vi ew f or your f i el ds by choosi ng ' Di al og - > Scr een Layout - > Vi ews' . For t hi s pur pose, copy an exi st i ng ent r y, f or
exampl e REGC02. The name of t he new vi ew must begi n wi t h t he appl i cat i on, f or exampl e ZZZZ01 wi t h t he t ext ' Cont r act : Fi l e number ' .
I n ' Appl i cat i on' f i el d, ent er t he name of your appl i cat i on.
I n t he ' Subscr een' ar ea, ent er t he pr ogr amname ( SAPLaaaaaa wi t h aaaaaa bei ng t he name of your f unct i on gr oup) and t he scr een number
of t he subscr een cr eat ed bef or e:
Pr ogr amname: SAPLY_REGC_EXT
Scr een number : 0901

I n t he ' Funct i on modul e' ar ea, ent er t he name of your PBO modul e i n f i el d ' Bef or e Out put ' ( f or exampl e, ZZZZ_REGC_PBO_Z901) , and
ent er t he name of your PAI modul e i n t he ' Af t er Ent r y' f i el d ( f or exampl e, ZZZZ_REGC_PAI _Z901) . Leave t he val ues of t he r emai ni ng
f i el ds f or t he vi ew unchanged. NEVER use t he f unct i on modul es f r omt he st andar d vi ew i n your own scr eens. I f you do so, a pr ogr am
t er mi nat i on wi l l occur because t he subr out i ne t o be cal l ed i s det er mi ned dynami cal l y by t he st andar d modul e.

I n t he navi gat i on t r ee, doubl e- cl i ck ' Vi ew - > Fi el d Gr oups' and ent er t he f i el d gr oup ( 701) cr eat ed bef or e. Under ' Fur t her checks,
you do not have t o make any ent r i es.
d) I n t he next st ep, def i ne a sect i on by choosi ng ' Di al og - > Scr een Layout - > St ages' . The name of t he sect i on must begi n wi t h t he
appl i cat i on ( f or exampl e, ZZZZ01) wi t h descr i pt i on ' Fi l e number ' and t i t l e ' Fi l e number ' . The t i t l e you ent er her e wi l l be di spl ayed
as a gr oup headi ng on t he scr een.

I n t he di al og st r uct ur e, doubl e- cl i ck ' Sect i on - > Vi ews' t o assi gn t he vi ew cr eat ed bef or e t o t he sect i on. The l ast t wo di gi t s of
t he l i ne i t emnumber have t o be di f f er ent f r om' 00' , f or exampl e ' 9000050' .
e) Choose ' Di al og - > Scr een Layout - > Scr eens' and def i ne t he scr een on whi ch t he new f i el ds ar e t o be di spl ayed. For exampl e, i f
you want t he f i l e number t o be di spl ayed on t he ' Gener al Dat a' scr een, sel ect l i ne REGC2 and doubl e- cl i ck ' Scr een - > Sect i ons' i n
t he di al og st r uct ur e. The l i ne i t emnumber t hat you assi gn her e t o t he newl y def i ned sect i on det er mi nes t he posi t i on of t he sect i on
on t he scr een. For exampl e, i f you want t he f i l e number t o be di spl ayed af t er t he adj ust ment , choose a l i ne i t emnumber bet ween
300000 and 400000, f or exampl e 300050 f or sect i on Z901. Thi s l i ne i t emnumber i s i ndependent of t he number t hat you have assi gned t o
t hi s sect i on i n ' Di al og - > Scr een Layout - > St ages' , but i t must not end wi t h ' 00' ei t her . I gnor e er r or message "Maxi mum10 vi ews"
i f i t occur s.
I f you want t o cr eat e a compl et el y new scr een wi t h own sect i ons not e t hat al ways t he f i r st sect i on i n Vi ew - > Sect i on of BDT NI CHT
i s di spl ayed. For t hi s r eason you must ent er an ' empt y sect i on' as f i r st sect i on i n t he l i st . See al so t he vi ew- sect i on assi gnment
del i ver ed by SAP ( f or exampl e f or cont r act s, see sect i on REGC9X) .
Not e t hat not al l scr eens ar e al ways used. The syst emgr oups t he scr eens i n scr een sequences ( mai nt enance vi a ' Di al og - > Scr een
Sequences' ) and assi gns a scr een sequence t o t he cont r act t ype i n Cust omi zi ng. I f you use ( cr eat e) a new scr een, you have t o i ncl ude
i t i n t he scr een sequence.

I n t he appl i cat i on, a scr een cor r esponds t o a t ab page. You can al so def i ne a t ab page. To do t hat , copy an exi st i ng scr een t o a new
scr een wi t h anot her name ( begi nni ng wi t h t he name of t he appl i cat i on, f or exampl e ZZZZ01) and assi gn t he new scr een t o your new
sect i ons. I n t hi s case you MUST al so def i ne a new scr een sequence f or t he new scr een and make sur e t hat i t i s di spl ayed. For t hi s
pur pose, r ef er t o t he document at i on i n I MG act i vi t y ' Scr een Sequences' .
5. Cal l Tr ansact i on RECN ( i n gener al : RExx) and check whet her t he added f i el ds r espond cor r ect l y when you change, di spl ay and cr eat e a
cont r act .

Validity
The t empl at e f unct i on gr oup i s gener al l y cal l ed RExx_EXT_EXAMPLE, t he
f unct i on modul es st ar t wi t h RExx_RExx. Bear i n mi nd t hat your f unct i on
modul es must st ar t wi t h ZZZZ_RExx_ accor di ng t o t he BDT nami ng convent i ons
( ZZZZ i s t he user - def i ned appl i cat i on def i ned, RExx i s t he appl i cat i on
obj ect enhanced by t hi s appl i cat i on) .
Tr ansact i on Obj ect
REBDAO0001
Ar chi t ect ur al
obj ect
REBDBE0001 Busi ness ent i t y
REBDBU0001 Bui l di ng
REAJ CG0001
Compar at i ve gr oup
of apar t ment s
REGC0001 RE cont r act
RESCPG0001 Par t i ci pat i on gr oup
REBDPR0001 Pr oper t y
REBDRO0001 Rent al obj ect
RESCSU0001 Set t l ement uni t
I n t he di al og, choose ' New Ent r i es' and speci f y t he name of your
appl i cat i on and a t ext . To act i vat e t he appl i cat i on, sel ect t he
' Act i ve' checkbox on t he det ai l scr een.
Software Component From Rel. To Rel. And Subsequent

EA-APPL

200

200

Support Packages & Patches
References
This document refers to:
SAP Notes
This document is referenced by:
SAP Notes (14)


500

500

600

600
Support Packages
Software Component Release Support Package

EA-APPL

200

SAPKGPAB04
1093689 REFX: BDT required field check for CI includes
1151136 FAQ: Using BAPIs in RE-FX
1375861 BAPIs and user fields
1562916 Business area as selection field for reports
1822230 Clearing Custom Field Contents on Contract
517673 Flexible Real Estate: Features and release restrictions
632104 User-defined fields real estate contract RE-FX 470x110
691511 Necessary interface changes for BDT-enhancements
782947 Programming interfaces for RE-FX
858209 Data retrieval, customer enhancements, master data dialog
892613 Transaction variants and screen variants are not possible
903854 REFX: CUA additional functions for customer enhancements
904347 REFX: BDT subscreens without frames
932805 Payment method supplement (BSEG-UZAWE) in flexible RE mgmt
939971 FAQ and consulting notes for RE-FX
969234 User-defined tables for real estate master data
939971 FAQ and consulting notes for RE-FX
858209 Data retrieval, customer enhancements, master data dialog
892613 Transaction variants and screen variants are not possible
903854 REFX: CUA additional functions for customer enhancements
904347 REFX: BDT subscreens without frames
1151136 FAQ: Using BAPIs in RE-FX
517673 Flexible Real Estate: Features and release restrictions
1562916 Business area as selection field for reports
932805 Payment method supplement (BSEG-UZAWE) in flexible RE mgmt
1822230 Clearing Custom Field Contents on Contract
969234 User-defined tables for real estate master data
632104 User-defined fields real estate contract RE-FX 470x110
1093689 REFX: BDT required field check for CI includes
782947 Programming interfaces for RE-FX