exercise - file to idoc
TRANSCRIPT
-
8/12/2019 Exercise - File to Idoc
1/67
File to IDOC Scenario
In this Scenario:
Get the Vendor Master Data from file and create a Vendor in R/3 System
Perquisites: Try creating a vendor in R/3 using transaction XK! and get list o" #andatory "ields to$ave t$e source "ile structure% &ere 'e are using XI server as File Syste# and ID(S as R/3 Syste#%
T$e IDOC ty)e used is CR(*+S,
Exercise Steps:
!% Syste# -andSca)e .S-D
0% Integration 1uilder: Design
3% Integration 1uilder: Con"iguration
,% Testing
Step 1: SLD
Create a Product and so"t'are Co#)onent "or File Syste#%
Create a T$ird Party Tec$nical and 1usiness Syste# "or File Syste#%Create a 2e +S +1+P Tec$nical Syste# and 1usiness Syste# "or S+P R/3 Syste#
4o t$e transaction code 5SX*16IFR7 and go "or Syste# -andsac)e
8nder t$e So"t'are Catalog9 you $ave t$e o)tion to create t$e Product and So"t'are Co#)onent%
!.a%Select t$e Product and go "or e' Product ;ersion as s$o'n in t$e elo' screens$ot%
-
8/12/2019 Exercise - File to Idoc
2/67
(nter t$e Product a#e9 ;endor and ;ersion o" t$e Product%
4o "or Create
(nter t$e on
-
8/12/2019 Exercise - File to Idoc
3/67
-
8/12/2019 Exercise - File to Idoc
4/67
Since 'e are creating t$e Tec$nical Syste# "or File Syste#9 select t$e radio
-
8/12/2019 Exercise - File to Idoc
5/67
S'itc$ over to ta Installed Products o" your Tec$nical Syste#: &ere you can "ind your Product and
So"t'are Co#)onent
!.d% To Create e' 1usiness Syste#:T$ere are t'o 'ays o" creating usiness syste#
!% Fro# S-D &o#e Page9 you can select t$e 1usiness Syste# and create
2. T$e elo' #entioned 'ay is t$e second 'ay '$ere you can add t$e usiness syste# to your
tec$nical syste# y S'itc$ing over to ta 1usiness Syste#s o" your Tec$nical Syste#% ?ou can
"ollo' eit$er o" t$e 'ays%
-
8/12/2019 Exercise - File to Idoc
6/67
-
8/12/2019 Exercise - File to Idoc
7/67
Select you Product and So"t'are Co#)onent and go "or e>t
(nter t$e related Integration Server and go "or Finis$
+s "ar as no' 'e $ave created t$e )roduct9 so"t'are co#)onent 9 "ile syste#7s tec$nical syste# and
usiness syste#
-
8/12/2019 Exercise - File to Idoc
8/67
!.e% Create a 2e +S +1+P Tec$nical Syste# and 1usiness Syste# "or S+P R/3 Syste# :
4o to t$e S-D $o#e)age y clic=ing on 5&o#e7 in t$e u))er corner
Select t$e Tec$nical Syste#s
4o to e' Tec$nical Syste#
Since 'e are creating t$e Tec$nical Syste# "or S+P R/3 Syste#9 select t$e radiot
-
8/12/2019 Exercise - File to Idoc
9/67
-ogon to (C@. S+P R/3 Syste# and go to Syste#
-
8/12/2019 Exercise - File to Idoc
10/67
(nter t$e R/3 Syste# a#e% Installation and Dataase &ost a#e and go "or e>t
(nter t$e *essage Server9 Port and Central +))lication Server details and go "or e>t
-
8/12/2019 Exercise - File to Idoc
11/67
(nter
t$e +))lication Server &ost a#e and Instance u#er and go "or e>t
-
8/12/2019 Exercise - File to Idoc
12/67
+dd t$e client and t$e logical client na#e and go "or e>t
Select your Product and So"t'are Co#)onent and go "or "inis$
-
8/12/2019 Exercise - File to Idoc
13/67
!."%To Create e' 1usiness Syste#: Re"er to t$e )oint !.d in t$e sa#e docu#ent
-
8/12/2019 Exercise - File to Idoc
14/67
-
8/12/2019 Exercise - File to Idoc
15/67
Step !:
Inte"ration Repository # Desi"n:
I#)ort t$e So"t'are Co#)onent "ro# S-D
Create t$e a#es)ace "or "ile to IDOC scenario
I#)ort t$e IDOC Cre#as3
0.a% I#)ort t$e So"t'are Co#)onent "ro# S-D as "ollo's:
4o to Tools
-
8/12/2019 Exercise - File to Idoc
16/67
Select your so"t'are co#)onent "ro# t$e list and i#)ort
0.% T$e ne'ly created S2C s$ould a))ear in t$e le"t "ra#e% 4o to your S2C and create ne'
a#es)ace
-
8/12/2019 Exercise - File to Idoc
17/67
In our scenario 'e need to $ave connection 'it$ S+P R/3 Syste# to i#)ort t$e IDOC9 so '$ile creating
t$e na#es)ace select t$e radio utton 5I#)ort o" RFC and IDOC Inter"ace "ro# S+P Syste# Per#itted7%
(nter t$e S+P R/3 Syste# details li=e Syste#9 Client9 *essage Server and 4rou) and S+;(
-
8/12/2019 Exercise - File to Idoc
18/67
0.% To I#)ort t$e IDOC CR(*+S3 "ro# your S+P R/3 Syste#9 go to 5I#)orted OBects7 in your
a#es)ace%
Select t 5IDOCS7 and rig$t clic= on t$at
Select t$e I#)ort "ro# S+P OBects
-
8/12/2019 Exercise - File to Idoc
19/67
(nter t$e details o" +))lication Server9 Syste# u#er9 8ser a#e and Pass'ord o" t$e S+P R/3
Syste# and go "or continue and Select 5IDOC7 and (>)and
-
8/12/2019 Exercise - File to Idoc
20/67
-
8/12/2019 Exercise - File to Idoc
21/67
Searc$ your IDOC CR(*+S%CR(*+S3 and select it and go "or continue and Finis$
-
8/12/2019 Exercise - File to Idoc
22/67
-
8/12/2019 Exercise - File to Idoc
23/67
T$e IDOC got i#)orted in your a#es)ace
0.c% 8nder your na#es)ace in t$e le"t "ra#e9 e>)and t$e node
$Interface o%&ects'
Create ne' data ty)es%Rig$t
-
8/12/2019 Exercise - File to Idoc
24/67
0.d% In t$e data ty)e editor9 create a structure "or t$e +ddress 'it$ t$e "our
String ele#ents Street9 City9 Ei)9 Country9 as s)eci"ied elo'%
Save t$e oBect%
0.e% o' create anot$er data ty)e called ;endor6DT% Its structure s$ould e as "ollo's:
ote t$at t$e +ddress6DT ty)e )reviously created is no' re"erenced "ro# t$e #ain data ty)e%
T$is is called nesting o" data ty)es% T$is is ac$ieved y selecting Searc$ &el) "ro# t$e
Dro)isting data ty)e in t$e sa#e
S2C%
-
8/12/2019 Exercise - File to Idoc
25/67
0."% Create *essage Ty)e
Create a ne' #essage ty)e called ;endor% In t$e le"t "ra#e9 rig$t
-
8/12/2019 Exercise - File to Idoc
26/67
"ro# t$e le"t "ra#e .onto t$e icon 'it$ t$e $and% *a=e sure t$at t$e na#es)ace is "illed
in correctly% Save t$e oBect%
-
8/12/2019 Exercise - File to Idoc
27/67
0.g% Create a *essage Inter"ace oBect ."ro# t$e le"t "ra#e9 called ;endor6out% T$e
inter"ace s$ould e outound and async$ronous% It s$ould re"erence your #essage ty)e
.drag and dro) or use F, $el)%
Create a gra)$ical #a))ing et'een t$e custo# X*- #essage and t$e IDoc%
-
8/12/2019 Exercise - File to Idoc
28/67
-
8/12/2019 Exercise - File to Idoc
29/67
0.$% (>)and t$e node *a))ing OBects% Create a *essage *a))ing oBect and na#e it
;endor6CR(*+S3%
-
8/12/2019 Exercise - File to Idoc
30/67
?ou are no' in t$e gra)$ical #a))ing editor% T$e source #essage is on t$e le"t9 t$e target #essage on t$e
rig$t9 and t$e #a))ing rules at t$e otto#%
+s source #essage9 select your #essage ty)e ;endor% ?ou can c$oose Searc$ "or Re)ository oBect%
*a=e sure t$at you select your o'n S2C%
T$ere you 'ill e ale to "ind your na#es)ace and #essage ty)e% +lternatively9 you can drag and dro)
your #essage ty)e onto t$is area o" t$e screen .onto t$e icon 'it$ t$e $and%
+s target #essage9 select t$e CR(*+S%CR(*+S3 IDoc% +s a re#inder9 you can "ind t$e IDoc under
S2C I#)orted OBects%
-
8/12/2019 Exercise - File to Idoc
31/67
-
8/12/2019 Exercise - File to Idoc
32/67
-
8/12/2019 Exercise - File to Idoc
33/67
0.i% o' t$at 'e $ave de"ined t$e source and target #essage9 'e can start de"ining t$e
*a))ing rules%
ote: in order to get a larger 'or=ing area9 you can detac$ t$e 'indo' y clic=ing on t$e t$u#nail int$e u))er rig$t corner%
*a) t$e "ields o" t$e source docu#ent to t$e equivalent "ields in t$e IDoc%
T$is can e ac$ieved easily y locating t$e target "ield in t$e IDoc structure and t$en drag
-
8/12/2019 Exercise - File to Idoc
34/67
;endor u#er (!-F+!* -IFR
+ddress Country (!-F+!* -+D!
-ast a#e (!-F+!* +*(!
+ddress City (!-F+!* ORT!
+ddress Ei) (!-F+!* PST-E
Searc$ Ter# (!-F+!* SORT-
+ddress Street (!-F+!* STR+S
;endor u#er (!-F+!* (!-F1!* -IFR
;endor u#er (!-F+!* (!-F*!* -IFR
Currency (!-F+!* (!-F*!* 2+(RS
T$is is a good ti#e to save your #a))ing%
o' 'e $ave to assign constants to certain "ields and attriutes in t$e IDoc ."or seg#ent uali"iers9$ardcoded values and X*- attriutes% T$is can e ac$ieved y "ollo'ing t$e )rocedure elo'%
Doule
-
8/12/2019 Exercise - File to Idoc
35/67
T$is is a good ti#e to save your #a))ing again%
For t$e seg#ents (!-F1!* and (!-F*!* )lease assign an e#)ty constant% T$is is necessary ecause
t$ese seg#ents are o)tional in t$e IDoc%
+lt$oug$ so#e underlying "ields $ave already een #a))ed9 i" t$e )arent node is not e>)licitly used as
t$e target o" a #a))ing9 t$e seg#ent 'ill not e instantiated at all%
Finally9 rig$t
-
8/12/2019 Exercise - File to Idoc
36/67
Save your #a))ing%
0.B% o' you can test your #a))ing y selecting t$e test ta%
Fill in t$e "ollo'ing values in t$e X*- instance and clic= e>ecute #a))ing% In t$e
Rig$t
-
8/12/2019 Exercise - File to Idoc
37/67
-
8/12/2019 Exercise - File to Idoc
38/67
ote t$at all o)tional seg#ents and "ields o" t$e IDoc9 t$at 'ere not e>)licitly #a))ed9 'ere not
generated%
;endor u#er: 30HH .HH is your (#)ID nu#er
-ast a#e ?our c$oiceA
Searc$ Ter# ?our c$oiceACurrency 8SD
+ddress Street ?our c$oiceA
+ddress City ?our c$oiceA
+ddress Ei) ?our c$oiceA
+ddress Country 8S
Save t$e source X*- instance to t$e XI server directory% T$is 'ill e used later as a in)ut "ile "or testing%
Select Source docu#ent vie'%
-
8/12/2019 Exercise - File to Idoc
39/67
&ig$lig$t t$e entire X*- docu#ent and co)y it to t$e cli)oard%
O)en note)ad .on t$e 2TS session9 )aste t$e cli)oard and save t$e docu#ent to a "ile na#ed
Vendor))*xml on your "older *y Docu#ents on t$e server:
-
8/12/2019 Exercise - File to Idoc
40/67
0.B% Create an Inter"ace #a))ing9 na#ed Vendor+o,t+-REM.S3% +ssign t$e "ollo'ing re"erences:
Source inter"ace: Vendor+o,t.your outound inter"ace
Target inter"ace:-REM.S*-REM.S3.t$e IDoc "ro# t$e ase S2C
.Select Re"res$ Inter"aces and assign your #a))ing )rogra#< *a))ing )rogra#:Vendor+-REM.S3.your #essage #a))ing
Follo' t$e elo' #entioned ste)s to ac$ieve t$e inter"ace #a))ing
-
8/12/2019 Exercise - File to Idoc
41/67
-
8/12/2019 Exercise - File to Idoc
42/67
-
8/12/2019 Exercise - File to Idoc
43/67
-
8/12/2019 Exercise - File to Idoc
44/67
-
8/12/2019 Exercise - File to Idoc
45/67
Finally9 in t$e le"t
-
8/12/2019 Exercise - File to Idoc
46/67
Ste) 3:Inte"ration Directory
3%! Fro# t$e Integration 1uilder $o#e )age9 select Integration Directory% T$is 'ill launc$ t$e Java 2e
Start a))lication%
-og in 'it$ your user ID and )ass'ord "ro# t$e Integration Server
-
8/12/2019 Exercise - File to Idoc
47/67
3%0 T$e "irst ste) is to create Con"iguration Scenario OBect
-
8/12/2019 Exercise - File to Idoc
48/67
3%3 +dd your 5S+P 1usiness Syste#7 to your scenario
3%,Go to Ser0ice (itho,t party and rig$t
-
8/12/2019 Exercise - File to Idoc
49/67
3%, o' create a Comm,nication -hannel% T$e co##unication c$annel is essentially t$e )$ysical
connectivity to/"ro# t$e a))lication syste#% T$is is '$ere t$e ada)ter con"iguration ta=es )lace% In t$is
case 'e need to con"igure t$e "ile ada)ter to )oll "or ne' "iles and send t$e# to t$e Integration Server%
In t$e 'iard9 leave t$e Party na#e lan= and t$en select your o'n usiness syste#
8nc$ec= t$e o> Create Co##unication C$annels +uto#atically% T$is service .usiness syste#re)resents t$e legacy syste# '$ic$ 'ill e sending data as X*- "iles%
-
8/12/2019 Exercise - File to Idoc
50/67
Note: In case your business system is not listed, a cache refresh is necessary. Close the wizard and use the
menu Environment / Clear S! data cache. "nce this is done by any user, the Inte#ration !irectory will
fetch all currently available business systems from the S!.
o' create a comm,nication channel% T$e co##unication c$annel is essentially t$e )$ysical
connectivity to/"ro# t$e a))lication syste#% T$is is '$ere t$e ada)ter con"iguration ta=es )lace% In t$iscase 'e need to con"igure t$e "ile ada)ter to )oll "or ne' "iles and send t$e# to t$e Integration Server%
(>)and your service .Con"iguration Scenario and rig$t
-
8/12/2019 Exercise - File to Idoc
51/67
-
8/12/2019 Exercise - File to Idoc
52/67
*essage Protocol: ile.you can )rocess t$e "ile as
-
8/12/2019 Exercise - File to Idoc
53/67
3% Receiver syste# Co##unication c$annel: .Select IDOC
-
8/12/2019 Exercise - File to Idoc
54/67
T$e receiver idoc ada)ter is no' con"igured%
-
8/12/2019 Exercise - File to Idoc
55/67
3*7 Sender ."reement: T$is de"ines a inding et'een t$e co##unication c$annel you Bust created9 and
t$e outound inter"ace%
In t$e le"t "ra#e9 rig$t
-
8/12/2019 Exercise - File to Idoc
56/67
3% Fro# t$e le"t "ra#e9 create a ne' Recei0er Determination oBect% T$is is t$e #ain )art o" t$e
routing )rocess9 '$ere you assign a receiver "or your #essage%
Select your sender service and inter"ace
In t$e Con"igured Receivers area9 c$oose t$e e>isting service "or t$e target R/3 syste#
R3+.-8ED.c$ec= 'it$ instructor% Save your receiver deter#ination%
-
8/12/2019 Exercise - File to Idoc
57/67
-
8/12/2019 Exercise - File to Idoc
58/67
Deter#ine your receiver syste#
3*9 In t$e "ollo'ing ste)s9 you 'ill create an Interface Determination oBect% o' t$at 'e $ave
de"ined a receiver "or t$e #essage9 'e need to assign an inound inter"ace9 and an inter"ace #a))ing .i"
necessary%
In t$e receiver deter#ination you Bust created9 $ave a loo= elo' at t$e area
Con"iguration Overvie' "or Receiver Deter#ination at t$e otto# o" your screen9 and $itRefresh "or t$at t$e usiness syste# you assigned is dis)layed in t$at area as 'ell%
In t$e colu#n Receiver .Partner/Service o)en t$e details y using t$e little triangle%
T$e entry ot de"ined s$o's you t$at t$ere is no inter"ace deter#ination )resent% Rig$t
-
8/12/2019 Exercise - File to Idoc
59/67
.Since t$e so"t'are co#)onent t$is inter"ace elongs to #ay not e assigned to t$e usiness syste#%+"ter
c$oosing-REM.S*-REM.S39 t$e inound inter"ace is s$o'n in t$e inter"ace deter#ination%
+ #a))ing $as to e s)eci"ied since t$e sender inter"ace is di""erent "ro# t$e selected receiver inter"ace%
8se t$e F, $el) ne>t to t$e Inound Inter"ace to select your inter"ace #a))ing%
-
8/12/2019 Exercise - File to Idoc
60/67
-
8/12/2019 Exercise - File to Idoc
61/67
-
8/12/2019 Exercise - File to Idoc
62/67
-
8/12/2019 Exercise - File to Idoc
63/67
-
8/12/2019 Exercise - File to Idoc
64/67
-
8/12/2019 Exercise - File to Idoc
65/67
In t$e screen (dit Receiver +gree#ent9 "or t$e "ield Receiver Co##unication C$annel use t$e in)ut
$el) .F,9 and select t$e co##unication c$annel IDoc6receiver% T$is is a )rede"ined c$annel '$ic$ is
used "or all inound IDocs into t$e R/3 syste#%
Save t$e Receiver +gree#ent%
4o ac= to t$e #ain receiver deter#ination screen and re"res$% o' your con"iguration is co#)lete%
1e"ore activating t$e oBects 'e need to set u) t$e in)ut "ile in t$e ne>t ste) .indeed9 as soon as your
sender co##unication c$annel is activated9 t$e )olling sequence o" t$e "ile ada)ter 'ill start
i##ediately%
Step ;Q Testing
-
8/12/2019 Exercise - File to Idoc
66/67
;*1Find t$e "ile Vendor))*xml '$ic$ you $ad )reviously saved9 and co)y it to your s$ared "older grou)HH
on t$e XI server% Please note9 t$e na#e o" t$e "ile s$ould #atc$ e>actly '$at you $ave s)eci"ied in your
sender co##unication c$annel%
;*!o' you can go ac= to t$e Integration Directory9 o)en your c$ange list and activate your oBects%
;*3*onitor your directory% +"ter a "e' seconds your "ile
Vendor))*xml s$ould disa))ear% T$is #eans t$at t$e "ile ada)ter $as success"ully )rocessed it and t$e "ile
'as deleted%
;*;In S+P48I9 c$oose #onitoring Integration (ngine #onitoring .transaction Srocessed )and t$e status record you 'ill see
t$e vendor nu#er t$at 'as created% 2rite do'n t$e vendor nu#er "or "uture re"erence%
,% C$ec= in transaction M83 t$at your vendor 'as created%
-
8/12/2019 Exercise - File to Idoc
67/67