0

SAP AG 1999
Tools
Registration
Further DX-WB Functions
Contents:
SAP AG BC420 6-1

0.2
SAP AG 1999
Create files
Change and display files
Copy files
enerate test data for data transfer
Register progra!s
"t the conclusion of this unit# you $ill %e a%le to:
Further DX-WB Functions: &nit '%(ecti)es
SAP AG BC420 6-2

0.*
SAP AG 1999
Course ')er)ie$ Diagra!
Daten+%ernah!e
DX Wor,%ench
-./ Wor,%ench
0rinciples of .tandard
Data Tansfer
D
i
r
e
c
t

1
n
p
u
t
B"01
T
"

R
e
c
o
r
d
e
r
Course ')er)ie$
B
a
t
c
h

1
n
p
u
t
C
a
l
l

T
r
a
n
s
a
c
t
i
o
n
*
2D1
Basics
3
4
5 60
60
7
66
68
6*
62
66
62
6
2
99
66
8
With some data transfer objects you can create a file with test data. Data from R/3 is inserted into a
file.
The function is available for standard transfer programs (!"#T"D!$ and %&!s
Note: This function is not available for all data transfer programs. It is application-dependent.
'ee appendi( )* for an overview of the objects that can use this function.
SAP AG BC420 6-3

0.8
SAP AG 1999
Goto Analyse files and data structures
File name
Standard
transfer
program for
customers
The object type
from the BOR
O!ect ty"e
#as$ ty"e
Pro%ra& ty"e
Pro%ra& ' &et(od
)ile ty"e
)ile na&e
P
*+A1
B,+P
-)B,./00
0oad data into -'3
BC4201./B,2SAP
.ata transfer "ro%ra&
,n"ut file
DX-WB: Tools
To use the tools of the D+,W" you have to specify the program or the method for the data transfer.
&roceed as follows-
'elect the relevant object type in your application.
'elect the supported program type.
'elect the supported program or method.
.ote- /se the 01 input help
Then you must specify the file name and the directory in which this is stored or should be created. %
physical or logical path/file name should be specified. (0or more information about logical file
names see the unit on se2uential files$
The path shown is valid for Release 1.3%
0or the Release 1.3 the valid path is Goto -> Analyze files and data structures.
SAP AG BC420 6-4

0.4
SAP AG 2001
Creates initial file under specified path:file na!e
File contains all the structures of the o%(ect
.ession header is filled
.tructures are preassigned $ith ;:<.
2=ception:
Field Name Initial Value
S#3P/
G-O4P
5A+.#
4S+A5
S#A-#
6*//P
+O.A#A
0
Object name
Current client
Current user
2 2
'
Field Name Initial Value
S#3P/
#B+A5
1 or 2 222222
Structure na&e
Function: Create File
When you create a file for a selected object and method" this file is an initiali4ed file. !t contains all
the structures that the object supports.
!f you are using a standard transfer program" the associated record layout always contains a session
header.
'tructures are predefined with the .5D%T% character only for !" #T or D!. This is not re2uired for
%&!s.
SAP AG BC420 6-7

0.9
SAP AG 2001
Function: Create File $ith Data
>eeds a progra! that can create test data
The progra! !ust %e pro)ided %y the
application
?')er)ie$: see appendi=# unit 64@
File $ith the test data
With some data transfer objects you can create a file with test data. Data from R/3 is inserted into a
file.
This function is not available for all transfer programs. It is application-dependent.
'ee appendi( )* for an overview of the objects that can use this function.
The function is available for standard transfer programs (!"#T"D!$ and %&!s.
SAP AG BC420 6-6

0.3
SAP AG 2001
16.01 8-00-1000
. . .
.ession record 0/appe6 00* ...
Aeader date 6
BB>"6 .tandard
Structure
BR00
BB>00
Contents
2B*+A1 ' 9o(n
B*+A1 Custo&ers
)ield +a&e
S(ort .escri"tion
)ield Contents
S#3P/ -ecord ty"e 2
#B+A5 #ale na&e B*+A1
+a&e1 +a&e 1 S&it(
+a&e2 +a&e 2 '
O-#01 Ort Berlin
-ecord na&e
. . .
0A+.1 0and ./
' . . .
.ata record
. . .
.tructure editor ena%les the
indi)idual structures to %e
changed
Function: Display:Change File
The file display template contains the following information-
The number of data records is displayed in the title. This shows how many transactions the transfer
file contains.
The fields of the transfer object are displayed in predefined length and se2uence for each structure.
'o you can identify which fields of a structure are re2uired in which length and se2uence. y
double clic6ing on a structure line you can see the fields of the structure.
The different hierarchy levels of a data record are indicated in different colors-
7ierarchy level *-green
7ierarchy level 8-yellow
7ierarchy level 3- blue
7ierarchy level 1-gray
9ou can print the transfer file (Table -> Print$
.ote that only the first *)) characters of each structure are displayed in the overview.
.ote- This functionality applies only for !" #T and D!.
SAP AG BC420 6-:

0.5
SAP AG 1999
)ile na&e
Source
A""lication ser;er
-e&ote ser;er
)ile ty"e
Presentation ser;er
)ile na&e
)ile na&e
#ar%et
A""lication ser;er
-e&ote ser;er
)ile ty"e
Presentation ser;er
)ile na&e
"ll the structures of the selected
transfer o%(ect can %e copied
Function: Copy File
The data transfer file can be copied between the application and presentation servers.
The data transfer programs e(pect the transfer file to have a fi(ed length.
The following conversions are possible-
#opy without converting
The data transfer file is coped unmodified
#onversion of fi(ed length ,: Delimited tabulator
This copy function can only be used to copy from the application server to the presentation
server. The data is copied into a format and the data is delimited by a tabulator.
#onversion of delimited tabulator ,: 0i(ed length
This copy function can only be used to copy from the presentation server to the application
server. The data is copied to a fi(ed length.
SAP AG BC420 6-<

0.7
SAP AG 1999
.tructure 'perations
16.01 8-00-1000
. . .
.ession header record 0.ession6 00* ...
Aeader data 6
BB>"6 eneral
Structure
BR00
BB>00
Contents
2B*+A1 ' 9o(n
Delete structure ro$s
2dit %loc,s in structure
Duplicate structure ro$s
9ou can edit the structure of an imported file as follows-
Delete-
&lace the cursor on the row you want to delete and choose Delete row.
#opy-
&lace the cursor on the row you want to duplicate and choose Duplicate row. The system duplicates
the row and adds it to the structure.
'elect bloc6-
&lace the cursor on the first row of the bloc6 you want to edit.
#hoose Select block. The bloc6 is selected and now has a gray bac6ground.
&lace the cursor on the last row of the bloc6 you want to edit.
#hoose Copy or Cut.
&lace the cursor on the row in front of the location where you want to add the copied or cut bloc6
to.
#hoose Insert clipboard.
SAP AG BC420 6-9

0.60
SAP AG 1999
Creating Test Data in DX-WB
Test data can be
inserted into the record
layout structure
B*+A1 Custo&ers
)ield na&eS(ort .escri"tion )ield Contents
S#3P/ -ecord ty"e 2
#B+A5 #ale na&e B*+A1
+a&e1 +a&e 1 S&it(
+a&e2 +a&e 2 '
O-#01 Ort Berlin
-ecord na&e
. . .
0A+.1 0and ./
' . . .
16.01 8-00-1000
. . .
.ata record
. . .
.ession record 0session6 00* ...
Aeader data 6
BB>"6 .tandard
Structure
BR00
BB>00
Contents
2B*+A1 ' 9o(n
.earch help
9ou can enter values for the individual fields in change mode. ;ost of the fields have input help.
Note: All fields that are not needed must be filled with the NODATA character.
SAP AG BC420 6-10

0.66
SAP AG 1999
/apping 0lan
B*+A1-A+-/.
B*+A1-+A5/1
B*+A1-SO-#0
B*+A1-S#-AS
B*+A1-P)AC=
B*+A1-O-#01
B*+A1-PS#08
B*+A1-SP-AS
C=A- 7
C=A- 37
C=A- 10
C=A- 37
C=A- 10
C=A- 37
C=A- 10
C=A- 2
#itle
+a&e 1
Sort field
Street
Post o>
City
Postal code
0an%ua%e
>
>
>
>
>
>
*2#,0
*3+A5
*3S#-
*4P)A
*4O-#
*4PS#
7
30
30
10
37
10
5
5
?
5
5
5
5
,
5ust still e clarified
Al@ays ./ ./
+a&e #y"e 0% .escri"tion +a&e 0% +otes ,nitial
5 A 5o;e
# A #ale
, A ,nitial Bfi>ed ;alueC
P A Pro%ra&
Creating the mapping plan on paper
...
Target structure .ource structure
efore you create test data the fields in the non,'%& system should be formatted and assigned to the
fields in the '%& system. This is best done in a table.
SAP AG BC420 6-11

0.62
SAP AG 1999
>'D"T" 1ndicator
:
:
:
:
:
The default >'D"T" indicator is ;:<
2nter the >'D"T" indicator in fields that do not need to %e
transferred
For the file created fro! the DX - WB# all fields are
auto!atically filled $ith the >'D"T" indicator.
0ields in the '%& record layout structure that are not needed for data transfer" must be filled with the
.5D%T% indicator. This means that these fields or field values will not be used during data transfer.
!f a field is not filled with the .5D%T% indicator" it will be transferred with the value '&%#<. This
could create severe problems" as the '&%#< value may overwrite e(isting values in the system.
.ote- This only applies to !" #T" and D!.
SAP AG BC420 6-12

0.6*
SAP AG 1999
Session header
Transaction header data
0
Transaction data 1
Transaction data 2
Transaction header data
6
2
2
6
The file structure is chec,ed in accordance
$ith the standard structure description
Function: Chec, File
9ou can chec6 the structure of a file.
!f you have selected an object that uses the '%& standard transfer program" it is chec6ed against
the record layout structure.
!f the file is in !Doc format" all the <D! inbound processing chec6s are carried out.
!f a %&! is used for the transfer" so that non,processed objects can be stored in an !Doc in R/3"
your file must be free of errors. !f you save objects with errors to a file" you can ignore all the
messages about missing inbound partner profiles.
SAP AG BC420 6-13

0.68
SAP AG 2001
BEGIN_SEGMENT_SECTION
BEGIN_DXOB 00500000
BEGIN_GROUP 1
LEVEL 02
STATUS MANDATORY
...
BEGIN_SEGMENT BGR00
LEVEL 02
STATUS MANDATORY
...
BEGIN_FIELDS
NAME STYPE
TEXT Recor !"#e $or BI %&!er$'ce
...
NAME GROUP
TEXT ()e)e *ro)# &'+e
...
NAME MANDT
TEXT C,%e&!
...
NAME USNAM
TEXT ()e)e )-er ID . /%-!or%c',,"
e!er+%&e
...
NAME NODATA
TEXT No 0'!c/ %&#)! $or !/%- $%e,
...
Field descriptions
Description of
segment BR!!
C'B'-
X1122 VALUE SPACE.
. . .
/apping Tool
Record -ayout - Displaying .tructure ?2@
%fter you choose Structure Display" a list of information about all included structures and fields
appears. 9ou can download this list to your &#.
'ome e(ternal mapping tools use this list for defining and generating the '%& target structures
during conversion.
SAP AG BC420 6-14

0.64
SAP AG 1999
Transfer 0rogra! Transfer 0rogra!
"#ternal Data
"#ternal Structure Definitions
S$% St Structure Definitions
"#ternal System
"B"0 0rogra!
"B"0 0rogra!
"B"0 Dictionary
C'B'-
C'B'-
0-:6
0-:6
C
C
R0
R0
Include
&hoose 'anguage
Structure Generate
Record -ayout - enerating .tructure ?6@
C'B'-
X1122 VALUE SPACE.
. . .
%fter you choose Structure Generate you can translate '%& 'tructures (stored in the %%&
Dictionary$ into other programming languages" such as #obol" and store them in the file system as
Include files.
0or this process" the '%& 'ystem supports the creation of transfer programs in #" #55=" &=/*" and
&>R&?. 9ou use the %%& program RDD'R#?) to generate the structure descriptions in the
relevant programming language.
SAP AG BC420 6-17

0.69
SAP AG 2001
Record -ayout - enerating .tructure ?2@
Pro%ra&&in% lan%ua%e
C'B'-
0-:6
C
0CR0
#ale selection
Data transfer o%(ect
Acti;ity ty"e
Out"ut
+a&e of out"ut file
0ocal file syste&
Generate ali%n&ent fields
Structure for "ro%ra&&in% lan%ua%e
Structure for "ro%ra&&in% lan%ua%e
0040
!!(! is the
customer
master
enerates S$%
structures in the
selected programming
language
C'B'-
X1122 VALUE SPACE.
. . .
The displayed utility considerably simplifies conversion in the e(ternal system.
9ou can select the data transfer object for e(tracting the structure definitions. This sets the re2uired
'%& structures and creates them in a file in the programming language.
SAP AG BC420 6-16

0.63
SAP AG 2001
Registration
Function !odule
- &se the specified interface
?see online docu!entation@
0rogra!
- By using the )ariant# each progra! ?type 6@
can %e used
B"01
- Dou ha)e to generate the B"01-"-2 interfaces
For !ore infor!ation see the online docu!entation
B"01
0unction modules" programs of type * and %&!s" which you have developed yourself can be used in
the D+,W. They must" however" be registered in the D+,W.
!f you want to register function modules" they re2uire a special interface so that you can" for
e(ample" set the log status automatically.
!f you want to register programs" these programs can then be started with a variant from the D+,W.
!n Release 1.3%/ this is only possible without a variant , here it is similar to a function module
needing a special interface (selection options$.
!f you want to register a %&!" 6eep in mind-
To use %&!s you have developed yourself in the D+,W" you have to generate %&!,%=<
interfaces.
!f you want to enhance %&!s delivered by '%& for data transfer with your own %&!s" refer to
the %&! &rogramming ?uide.
SAP AG BC420 6-1:

0.65
SAP AG 1999
Registration in the DX-WB
Goto -e%istration Pro%ra&s and )unction 5odules
Object type
*+A1
Task type
5AP
Program type
)4+C
Create Registration
Tas, types:
/"0: )ap data
-'": 'oad data
/.C: )iscellaneous
...
Object type
*+A1
Function module
810S5D15AP
Function /odule
9ou create programs and function modules for tas6s such as e(tracting data from the e(ternal system
or cleaning up this data" and register them with the corresponding object type.
!n the data transfer wor6bench" choose Goto e!istration and the relevant option-
Pro!ra"s and function "odules
#hoose Create re!istration.
!n the dialog bo(" choose values using Possible entries help-
#b$ect type
, #hoose an object type.
Task type and Pro!ra" type
, 'everal program types are assigned to each tas6 type.
SAP AG BC420 6-1<

0.67
SAP AG 1999
Create files
Change and display files
Copy files
enerate test data for data transfer
Register progra!s
Dou are no$ a%le to:
DX-WB Tools: &nit .u!!ary
SAP AG BC420 6-19

Eercise !
"nit: #urther D$-%& #unctions
Topic: 'reating Test Data
#reating test data in the D+,W.
The address data for debtors have to be transferred. To do this"
use program R0!D<)). 9ou have determined the fields or data
to be transferred from the e(ternal system. !dentify the
appropriate '%& fields in the record layout structure.
#ile: &'()*+DE&+,,.TE-
.ro/ect: #I-,,
-ubpro/ect: DE&+,,
0un: &I+TE-T-,,
Tas1: TE-T-,,
2oad .rogram: 0#&IDE**
SAP AG BC420 6-20

* 0irst do the mapping (assignment of the fields$ on a piece of paper. The e(ternal data
should be mapped onto the record layout structure of program R0!D<)). %fterwards
a test data record must be generated using this mapping plan in the D+,W. #reate the
run !,T<'T,@@ in the D+,W and test the data record.
*,* The database from the legacy system contains the following fields-
0ield name Description- =ength- Type- 0ield value-
#>.5 #ustomer number 1 #har 1A3B
.%;< #ustomer name 3) #har ?eorge ;iller
'<%R#7 'earch term 8) #har ;iller
#>T9&< #ustomer type 1 #har )))1
%>D%T% 'treet 1) #har 8C)B <agle Drive.
>D%T% #ity 3) #har =os %ngeles
D!& Dip code *) #har C833)
#5 #ountry 8 #har /'
'&5 =anguage * #har <
T<=0 &hone no. *3 #har C8A,311,C11
E%T 'ales ta( identification
number
8) #har )3)8)A831A
.ote- /se the necessary E%T no. for your country.
*,8 #reate the mapping plan for the record layout structure of program
R0!D<)). /se the list from the appendi(- FTas6sF.
The following list contains the necessary record layout structures and the most
important fields -
?R))" G.))" G.%*" G.*
*,3 %ssign the fields of the legacy system to the fields of the '%& record layout
structure (mapping$. 0or assistance use the online transaction and read the field
descriptions of the fields. /se the following abbreviations for the conversion
method-
, 0- 0i(ed value
, E- Eariable
, ;- ;ove
, ;H#- ;ove H #onvert
SAP AG BC420 6-21

*,1 /nder #oding/#omment fill in the necessary field value or the Rule/#omment.
0or the assignment (mapping$ of the data" the following is applicable for the
fields of the record layout structure-
*. The name of the session I Deb,@@
8. #lient I =ogon client
3. /ser name I #18),@@
1. Geep indicator I +
A. #ustomer number I D,@@,88))
3. #ompany #ode I )))*
B. %ccount group I G/.%
J. Transaction code I +D)*
C. =anguage I convert from < to <.
*). Reconciliation account I *8))))
**. #reate old debtor number in the field G.*,%=TG.
*8. The field customer type in the legacy data is not needed.
*3. %ll remaining fields from *,*
8 'tart the D+,W and go to the D+,W tools. (!n the D+,W under Goto -> Analyze
%iles and Data Structures$.
8,* #reate the empty file #18)>D<>@@.T<'
#hoose the following settings-
, 5bject type- G.%*
K &rogram type- !.&
, &rogram/;ethod- R0!D<))
8,8 Delete the structures that are not needed (only the first four structures are
neededL$
8,3 ?o to the structure editor. #opy the values from the list for a test data record.
8,1 'ave the file before leaving the editor.
8,A #hec6 the structure (function- #hec6 file$
SAP AG BC420 6-22

3 Test the file in a run.
3,* 'o that program R0!D<)) can be created as a tas6 in a run in the D+,W"
you need a variant with the appropriate file name.
#reate variant T<'T>E%R>@@ for program R0!D<)).(using" for e(ample" the
%%& editor$. %s the file name use file #18)>D<>@@.T<' that you created
previously.
3,8 /nder your project and subproject D<,@@ create the run !>T<'T,@@ with the
description FTest with !M.
3,3 !n the run !>T<'T,@@" create the following tas6-
, Tas6- T<'T,@@
, Description- Test Transfer
, Tas6 type- =5%
, &rogram type- !.&
3,1 'elect the program R0!D<)) and variant T<'T>E%R>@@ that you created
earlier.
3,A 'tart the run and confirm the tas6 manually.
3,3 Ta6e a loo6 at the log
3,B !n a new session start the ! ;onitor and process the ! session using the mode
Process in fore!round.
SAP AG BC420 6-23

Eercise )
"nit: #urther D$-%& #unctions
Topic: 0egistering .rograms
Registering a program to carry out special tas6s in the D+,W.
.rogram: 30-&D'-"&+,,
The R'D#'/ is not registered in the D+,W in the standard system. !f you want to
process ! sessions automatically" you have to register this program for the business object in
2uestion.
'o that each participant group can practice registering" in this e(ercise program R'D#'/ is
first copied and then registered.
* #reate the development class D#18),@@ (transaction- '<J)$
8 #opy program R'D#'/ to DR'D#'/>@@.
3 %ctivate program DR'D#'/>@@.
1 #reate variant E%R,@@ for this program to process ! session !,@@.
A ?o to the D+,W. Register program DR'D#'/>@@. (Goto -> e!ister Pro!ra"s$
5bject type- G.%*
Tas6 type- ;'#
&rogram type- R<&5
&rogram- DR'D#'/>@@
3 #hange run !,@@ under your project 0!,@@" subproject D<,@@. The session should be
processed with the copied program DR'D#'/>@@.
!n the tas6 ;'#,@@ change the program name and the variant.
.ote- % run can only be changed" if it has finished and there are no logs for it.
'tart the run and in the ! ;onitor chec6 that the ! session has been processed.
SAP AG BC420 6-24

-olution )
"nit: #urther D$-%& #unctions
Topic: 0egistering .rograms
Registering a program to carry out special tas6s in the D+,W.
.rogram: 30-&D'-"&+,,
* #reate development class D#18),@@ (Transaction- '<J)$
utton &dit #b$ect
<nter development class D#18),@@.
#reate the development class. utton Create
<nter a short description
'elect an entry using 01 help for the #18) with your tas6.
#hoose Continue to confirm your entry.
8 #opy program R'D#'/ to DR'D#'/>@@. (Transaction- '<J)$
3 %ctivate program DR'D#'/>@@.
1 #reate variant E%R,@@ for this program to process the ! session !,@@. ('tart the program or
use transaction '<3J$.
A 'tart the D+,W and choose Goto -> e!ister Pro!ra"s.
Register program DR'D#'/>@@. utton Create e!istration
<nter the following data-
5bject type- G.%*
Tas6 type- ;'#
&rogram type- R<&5
&rogram- DR'D#'/>@@
3 #hange run !,@@ under your project 0!,@@" subproject D<,@@. The session should be
processed with the program you copied earlier DR'D#'/>@@.
!n tas6 ;'#,@@ change the program name and the variant.
.ote- % run can only be changed" if it has finished and there are no logs for it.
'tart the run and chec6 in the ! ;onitor that the ! session has been processed.
SAP AG BC420 6-27