exercise - file to idoc

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%


2/67

(nter t$e Product a#e9 ;endor and ;ersion o" t$e Product%

4o "or Create

(nter t$e on


3/67


4/67

Since 'e are creating t$e Tec$nical Syste# "or File Syste#9 select t$e radio


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%


6/67


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/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


9/67

-ogon to (C@. S+P R/3 Syste# and go to Syste#


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


11/67

(nter

t$e +))lication Server &ost a#e and Instance u#er and go "or e>t


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$


13/67

!."%To Create e' 1usiness Syste#: Re"er to t$e )oint !.d in t$e sa#e docu#ent


14/67


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


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


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+;(


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


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


20/67


21/67

Searc$ your IDOC CR(*+S%CR(*+S3 and select it and go "or continue and Finis$


22/67


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


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%


25/67

0."% Create *essage Ty)e

Create a ne' #essage ty)e called ;endor% In t$e le"t "ra#e9 rig$t


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%


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%


28/67


29/67

0.$% (>)and t$e node *a))ing OBects% Create a *essage *a))ing oBect and na#e it

;endor6CR(*+S3%


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%


31/67


32/67


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


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


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


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


37/67


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'%


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:


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


41/67


42/67


43/67


44/67


45/67

Finally9 in t$e le"t


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


47/67

3%0 T$e "irst ste) is to create Con"iguration Scenario OBect


48/67

3%3 +dd your 5S+P 1usiness Syste#7 to your scenario

3%,Go to Ser0ice (itho,t party and rig$t


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%


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


51/67


52/67

*essage Protocol: ile.you can )rocess t$e "ile as


53/67

3% Receiver syste# Co##unication c$annel: .Select IDOC


54/67

T$e receiver idoc ada)ter is no' con"igured%


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


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%


57/67


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


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%


60/67


61/67


62/67


63/67


64/67


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


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%


67/67

exercise - file to idoc

Documents