Idoc Technology

BC620 - SAP IDoc Interface (Technology)
BC620
Release 46D 03/10/2003
0
SAP AG 1999
BC620 - SAP IDoc Interface (Technology)
SAP AG
BC620
BC620
SAP IDoc
Interface
(Technology)
SAP IDoc
Interface
(Technology)
Release: 4.6A
Status: January 2000
Mat. No.: 5003 4022
0.2
SAP AG 2002
Copyright 2002 SAP AG. All right reer!e".
#o part of thi p$%lication &ay %e repro"$ce" or tran&itte" in
any for& or for any p$rpoe 'itho$t the e(pre per&iion of
SAP AG. The infor&ation containe" herein &ay %e change"
'itho$t prior notice.
All right reer!e".
Copyright
Trademarks
Some software prou!ts mar"ete #y SA$ A% an &ts &str&#utors !onta&n propr&etary software
!omponents of ot'er software (enors.
M&!rosoft
)
* +,N-.+S
)
* N/
)
* 01C02
)
* +or
)
* $ower$o&nt
)
an S32 Ser(er
)
are re4&stere
traemar"s of M&!rosoft Corporat&on.
,BM
)
* -B2
)
* .S52
)
* -B256000
)
* $arallel Sysple6
)
* M7S50SA
)
* RS56000
)
* A,1
)
* S5380
)
*
AS5400
)
* .S5380
)
* an .S5400
)
are re4&stere traemar"s of ,BM Corporat&on.
.RAC20
)
&s a re4&stere traemar" of .RAC20 Corporat&on.
,N9.RM,1
)
:.n2&ne for SA$ an ,N9.RM,1
)
-ynam&! Ser(er
/M
are re4&stere traemar"s of
,nform&6 Software ,n!orporate.
;N,1
)
* 15.pen
)
* .S95<
)
* an Mot&f
)
are re4&stere traemar"s of t'e .pen %roup.
=/M2* -=/M2* 1M2* 1=/M2 are traemar"s or re4&stere traemar"s of +3C
)
* +orl +&e
+e# Consort&um* Massa!'usetts ,nst&tute of /e!'nolo4y.
JA7A
)
&s a re4&stere traemar" of Sun M&!rosystems* ,n!.
JA7ASCR,$/
)
&s a re4&stere traemar" of Sun M&!rosystems* ,n!.* use uner l&!ense for
te!'nolo4y &n(ente an &mplemente #y Nets!ape.
SA$* SA$ 2o4o* R52* R,7A* R53* ABA$* SA$ Ar!'&(e2&n"* SA$ Bus&ness +or"flow* +e#9low*
SA$ 0arly+at!'* BA$,* SA$$=,R0* Mana4ement Co!"p&t* mySA$.!om 2o4o an mySA$.!om
are traemar"s or re4&stere traemar"s of SA$ A% &n %ermany an &n se(eral ot'er !ountr&es all
o(er t'e worl. All ot'er prou!ts ment&one are traemar"s or re4&stere traemar"s of t'e&r
respe!t&(e !ompan&es.
0.3
SAP AG 2001
B$ine Integration Technologie II
Business Integration
Technolog
BC0)* 3 !as
+e!el 2 +e!el ,
Data Trans"er
BC-20 # !as
Progra$$ing %ith
BAPIs in &isual Basic
.CA)2* # !as
Interface
Progra&&ing
Data e(change
'o$$unication
Inter"aces in ABAP
BC-/* 2 !as
Progra$$ing %ith
BAPIs in (A&A
.CA)26 # !as
SAP IDoc Inter"ace )
De*elo+$ent
BC62/ 1 !a
SAP IDoc Inter"ace
Technolog
BC620 2 !as
A++lication ,in-
.na/ling 0A,.1
Technolog
BC6/) 3 !as
.DI Inter"ace
CA2/0 4 !as
2B'620 "ro$ 01/2002 BIT320
2B'619 "ro$ 01/2002 BIT300
2B'621 "ro$ 04/2002 BIT3#0
2'A92# "ro$ 01/2002 BIT#2#
2'A926 "ro$ 01/2002 BIT#26
0.4
SAP AG 1999
0eco&&en"e"1
Baic 2no'le"ge of the 03, Syte&4 a gaine" fro&
co$re SAP20 an" SAP*04 for e(a&ple
Co$re Prere5$iite
0.5
SAP AG 1999
Participant1
Con$ltant
A"&initrator
Pro6ect tea&
&e&%er
D$ration1 2 "ay
Target Gro$p
/
SAP AG 1999
Co$re 7!er!ie'
Co$re Goal
Co$re 7%6ecti!e()
Co$re Content
Co$re 7!er!ie' Diagra&
8ain B$ine Scenario
Content1
>C? SA$ A% BC620 <
1.2
SAP AG 1999
9n"ertan" the poi%ilitie offere" %y the
IDoc Interface for electronic "ata tranfer
9e the IDoc Interface
Co$re Goal
Thi co$re 'ill ena%le yo$ to1
>C? SA$ A% BC620 2
1.3
SAP AG 1999
Co$re 7%6ecti!e()
Config$re the IDoc Interface
Trace the proceing of IDoc in the
yte&
Select an" $e the correct IDoc type for
yo$r %$ine procee
At the concl$ion of thi co$re4 yo$ 'ill %e
a%le to1
>C? SA$ A% BC620 3
1.4
SAP AG 1999
Co$re Content
3nit 9 General Setting
3nit 10 :$rther Tet Progra&
3nit 11 A Proce Chain
3nit 12 Statitic an" 8onitoring
3nit 13 ;or2flo' an" IDoc
3nit 14 9ing an <DI S$%yte&
3nit 1# Archi!ing
3nit 1 Co$re 7!er!ie'
3nit 2 Baic Principle
3nit 3 IDoc in B$ine Proce
3nit 4 Doc$&entation Tool
3nit # Port Definition
3nit 6 Partner Profile
3nit 4 The Tet Tool
3nit 5 8C an" IDoc
Preface an" Intro"$ction
<(ercie
Sol$tion
Appen"i(
>C? SA$ A% BC620 4
1.5
SAP AG 1999
.6ternal Sste$ .6ternal Sste$
Co$re 7!er!ie' Diagra&
Data flo'
A Proce Chain
Tet4
&onitoring
8eage
Control4
;or2flo'
Archi*e IDoc7
Archi*e IDoc7
.DI Su/sste$7
.DI Su/sste$7
Partner Pro"iles
Partner Pro"iles
Port De"inition
Port De"inition
Docu$entation
Tools
Docu$entation
Tools
IDoc in B$ine
Procee
R/3 Sste$
/'e un&ts !an #e &(&e as follows:
;n&ts w'&!' es!r&#e 'ow to !onf&4ure t'e ,-o! ,nterfa!e
;n&ts w'&!' es!r&#e t'e ata flow &n t'e R53 System an #etween R53 Systems an e6ternal
systems
/'e un&t @/est@ es!r&#es an &mportant step &n t'e pro!ess of !onf&4ur&n4 t'e ,-o! ,nterfa!e. /'e
emp'as&s &s pla!e on t'e &mplementat&on of t'e test pro4rams &n t'e ata flow.
/'e un&t @%eneral Sett&n4s@ es!r&#es Custom&A&n4 a!t&(&t&es w'&!'* for e6ample* !reate templates
for !onf&4ur&n4 t'e ,-o! ,nterfa!e. Bou s'oul t'erefore !ons&er t'&s !'apter to #e more a(an!e
t'an t'e ot'er @!onf&4urat&on !'apters@.
>C? SA$ A% BC620 5
1.6
SAP AG 1999
8ain B$ine Scenario
8eage
IDoc IDoc
=$ic2Deli!er
S&art8art
SAP 03, Syte& SAP 03, Syte&
<DI S$%yte& <DI S$%yte&
<DI S$%yte& <DI S$%yte&
,n orer to reu!e !osts* t'e !ompany SmartMart w&s'es to sen pur!'ase orers to 3u&!"-el&(er (&a
0-,. 3u&!"-el&(er w&s'es to &mme&ately post t'ese pur!'ase orers ele!tron&!ally. Bot' !ompan&es
'a(e R53 Systems an must !onf&4ure t'e&r ,-o! ,nterfa!e a!!or&n4ly. /'e ,-o!s are to #e
translate &nto anot'er 0-, stanar form.
>C? SA$ A% BC620 6
2
SAP AG 1999
Baic Principle
IDoc concept an" f$n"a&ental ter&
Data flo' an" proce flo' 'hen $ing the IDoc Interface
Content1
>C? SA$ A% BC620 <
2.2
SAP AG 1999
<(plain the ter& IDoc4 <DI an" A+<
I"entify the %aic tep in IDoc proceing
Topic 7%6ecti!e
At the concl$ion of thi $nit4 yo$ 'ill %e a%le to1
>C? SA$ A% BC620 2
2.3
SAP AG 1999
IDoc Concept
8eage-oriente"
Aynchrono$
Syte& /
Doc$&ent
Syte& 2
IDoc
Doc$&ent
,-o! &s an SA$ stanar format for ata transfer #etween systems. ,-o! stans for Intermediate
Document. ,t &s intermediate &n two respe!ts:
Message-oriented : -ata &s also store &n appl&!at&ons* only &n ot'er formats >t'e appl&!at&on
o!uments?. /'e ,-o! !ommun&!ates #etween t'ese appl&!at&on o!uments* as t'e lan4ua4e
spo"en #y #ot' appl&!at&ons. ,t &s not &mportant w'et'er t'e appl&!at&on &s pro4ramme #y SA$ or
#y anot'er t'&r:party system.
Asynchronous : -ata !an #e store &n ,-o!s #efore an appl&!at&on o!ument &s !reate. /'&s &s
&mportant* for &nstan!e* w'en &n!orre!t ata &s transferre: ,n t'&s !ase* t'e appl&!at&on o!ument &s
only !reate w'en t'e ata &s !orre!te.
/'e ,-o! ,nterfa!e &s a(a&la#le &n t'e R53 System from Release 2.<A onwars an &n t'e R52 System
from Release 5.09.
>C? SA$ A% BC620 3
2.4
SAP AG 1999
IDoc Application
;or2flo' ;or2flo'
B$ine B$ine
Connector Connector
<lectronic <lectronic
:or& :or&
A+< A+<
<DI <DI
S$%yte& S$%yte&
03, Syte& 03, Syte&
032 Syte& 032 Syte&
7ther 7ther
Syte&... Syte&...
Internet Internet
Intranet Intranet
IDoc IDoc
06amples of systems or appl&!at&ons w'&!' use ,-o!s:
A20: Appl&!at&on 2&n" 0na#l&n4
0-,: 0le!tron&! -ata ,nter!'an4e
Bus&ness Conne!tor: Sen&n4 #us&ness o!uments us&n4 t'e ,nternet
>C? SA$ A% BC620 4
2.5
SAP AG 1999
<DI an" A+<
Doc$&ent
IDoc
8eage
IDoc IDoc
<DI S$%yte& <DI S$%yte& <DI S$%yte& <DI S$%yte&
/wo spe!&al ,-o! appl&!at&on areas s'oul #e ef&ne:
0-,: 0le!tron&! ata &nter!'an4e #etween &fferent !ompan&es
A20: 0le!tron&! ata &nter!'an4e #etween &fferent systems w&t'&n one !ompany
Systems !an e6!'an4e ,-o!s e&t'er &re!tly >for e6ample R53 w&t' R53? or 'a(e t'em translate &nto
ot'er stanars >for e6ample ;N50-,9AC/ or ANS, 1.<2? #y 0-, su#systems.
/'e appl&!at&on w'&!' uses ,-o!s >for 0-, or A20? must #e a#le to wr&te ata to ,-o!s* or rea ata
from ,-o!s* or #ot'.
/'e ,-o! format &s (al& as an 0-, stanar w'en use for 0-,. =owe(er* translat&n4 ,-o!s &nto
ot'er stanars 'as t'e a(anta4e of allow&n4 !ommun&!at&on w&t' more partners.
+&t'&n t'e R53 System* only ,-o! formats are use. All translat&ons &nto ot'er 0-, Stanars are
performe #y an 0-, su#system. /'e a(anta4e &s t'at SA$ appl&!at&ons only 'a(e to re!o4n&Ae t'e
,-o! format : not se(eral 0-, stanars : an are t'erefore eas&er to ma&nta&n. /'e &sa(anta4e &s
t'at SA$ oes not supply an 0-, su#system an !ustomers must pur!'ase su!' a su#system w'en
ot'er 0-, stanars are to #e use.
>C? SA$ A% BC620 5
2.6
SAP AG 1999
Proce :lo'1 Sen"ing Data
Chec2 partner4 fin" port
Tranfer "ata4
proce f$rther
Pot "oc$&ent
Generate IDoc
R/3 Sste$ R/3 Sste$
.6ternal sste$ .6ternal sste$
,n t'e follow&n4 e6amples* ata flow &s always seen from t'e po&nt of (&ew of t'e R53 System.
/'erefore* &f ata &s sent (&a ,-o!s from an R53 System to an e6ternal system* t'e pro!ess &s !alle
o!t"o!nd #rocess$ng or s&mply out#oun.
.ut#oun pro!ess&n4 &n!lues:
$ost&n4 t'e appl&!at&on o!ument
%enerat&n4 t'e !orrespon&n4 out#oun ,-o!
9&n&n4 t'e partner an t'e port
/ransfer of t'e ,-o! to t'e e6ternal System (&a t'e port
>C? SA$ A% BC620 6
2.7
SAP AG 1999
IDoc Setting1 Sen"ing Data
Post !ocu$ent
Generate IDoc
'hec- +artner8 "in! +ort
Trans"er !ata8
+rocess "urther
Archi!e IDoc >
Archi!e IDoc >
<DI S$%yte& >
<DI S$%yte& >
Partner Profile
Partner Profile
Port Definition
Port Definition
Doc$&entation
Tool
Doc$&entation
Tool
R/3 Sste$ R/3 Sste$
SmartMart must !onf&4ure t'e ,-o! ,nterfa!e for out#oun pro!ess&n4:
SmartMart ef&nes t'e system w'&!' w&ll re!e&(e ,-o!s an t'e te!'n&!al parameters (&a t'e #ort
def$n$t$on.
SmartMart ef&nes 3u&!"-el&(er as a partner for messa4e type .R-0RS &n t'e #artner #rof$les
an enters t'e port w'&!' 'as alreay #een ef&ne.
.ut#oun ,-o!s !reate &n t'e R53 System s'oul #e arch$%ed #y SmartMart an t'en elete.
/'e doc!mentat$on tools &nform t'e &DI S!"system w'&!' ,-o! types are to #e re!o4n&Ae.
>C? SA$ A% BC620 C
2.8
SAP AG 1999
Proce :lo'1 0ecei!ing Data
<rror han"ling
o2>
o2>
#o
#o
Chec2 port ? partner4
Generate IDoc
Sen" "ata to
03, Syte&
tranfer
Pot "oc$&ent
R/3 Sste$ R/3 Sste$
Re!e&(&n4 ata from an e6ternal system an t'e su#seDuent pro!ess&n4 &n t'e R53 System &s !alle
$n"o!nd #rocess$ng or also $n"o!nd'
,n#oun pro!ess&n4 &n!lues:
Re!e&(&n4 ,-o! ata from an e6ternal system (&a an &n#oun port
Creat&n4 t'e &n#oun ,-o!
9&n&n4 t'e !orre!t pro!ess&n4 type (&a t'e partner prof&les
Creat&n4 t'e appl&!at&on o!ument
,f an error o!!urs* error handl$ng >more 4eneral: e6!ept&on 'anl&n4? &s tr&44ere. 06!ept&on
'anl&n4 &s a &fferent "&n of pro!ess&n4 an &s not part of &n#oun pro!ess&n4. /'ere &s also
e6!ept&on 'anl&n4 for out#oun pro!ess&n4 #ut &t &s less &mportant: 9or out#oun pro!ess&n4 you
s'oul usually presume t'at t'e ata #e&n4 sent &s !orre!t.
>C? SA$ A% BC620 E
2.9
SAP AG 1999
IDoc Setting1 0ecei!ing Data
<rror han"ling
Sen! !ata to
R/3 Sste$
'hec- +ort 9 +artner8
generate IDoc
Post !ocu$ent
Port Definition4
Partner Profile
Port Definition4
Partner Profile
Archi!e IDoc >
Archi!e IDoc >
Doc$&entation
Tool
Doc$&entation
Tool
<DI S$%yte& >
<DI S$%yte& >
R/3 Sste$ R/3 Sste$
3u&!"-el&(er must !onf&4ure t'e ,-o! ,nterfa!e for &n#oun pro!ess&n4:
/'e o!umentat&on tools &nform t'e 0-, Su#system w'&!' ,-o! types are to #e re!o4n&Ae.
/'e port name must #e ma&nta&ne &n t'e #ort def$n$t$on #efore ,-o!s !an #e a!!epte #y t'e R53
System.
,n t'e #artner #rof$les( 3u&!"-el&(er enters SmartMart as a partner for &n#oun pro!ess&n4 an t'e
messa4e type .R-0RS. ,n a&t&on* a4ents respons&#le for error pro!ess&n4 are entere 'ere*
spe!&f&!ally for partners an messa4es.
2&"e SmartMart* 3u&!"-el&(er w&s'es to arch$%e an su#seDuently elete &n#oun ,-o!s w'&!' 'a(e
#een 4enerate.
>C? SA$ A% BC620 8
2.10
SAP AG 1999
IDoc i an SAP tan"ar" for "ata tranfer %et'een
yte&.
@no'n i&ple&entation area for IDoc1 A+< an"
<DI cenario
The IDoc Interface facilitate %oth IDoc proceing
an" fle(i%le error3e(ception han"ling
Baic Principle1 S$&&ary
,
SAP AG 1999
IDoc 0ecor" Type
IDoc an" IDoc type
IDoc proceing1 In%o$n" an" o$t%o$n"
proceing
IDoc in B$ine Procee
>C? SA$ A% BC620 <0
>C? SA$ A% BC620 <<
3.2
SAP AG 1999
IDoc in B$ine Procee1 Co$re 7%6ecti!e
<(plain the "ifference %et'een IDoc an"
IDoc type
Decri%e the tr$ct$re of an IDoc
Deter&ine 'here in the %$ine proce or
the proce chain the IDoc 'a create"
3.3
SAP AG 1999
B$ine cenario
A a &e&%er of the i&ple&entation tea& for
yo$r co&pany (S&art8art or =$ic2Deli!er)4 yo$
are reponi%le for config$ring the IDoc
Interface. Ao$ &$t therefore $n"ertan" the
%aic principle %ehin" the interface1 the IDoc
for&at an" ho' to e&%e" the interface in %oth
o$t%o$n" proceing (S&art8art) an" in%o$n"
proceing (=$ic2Deli!er).
>C? SA$ A% BC620 <2
3.4
SAP AG 1999
IDoc 0ecor" Type
Stat$ recor"
Data recor"
Control recor"
ea!' ,-o! &n t'e SA$ ata#ase !ons&sts of:
.ne !ontrol re!or
-ata re!ors w'&!' store t'e appl&!at&on ata &n se4ments an es!r&#e t'e '&erar!'y of t'ese
se4ments.
Status re!ors w'&!' eterm&ne t'e ef&ne pro!ess&n4 steps for t'e ,-o!. As a result* t'e
num#er of status re!ors for an ,-o! &n!reases as pro!ess&n4 !ont&nues.
An ,-o! for transm&ss&on to or from an e6ternal system* 'owe(er* only !ons&sts of:
.ne !ontrol re!or
/'e ata re!ors
,f t'e e6ternal system &s to &nform t'e R53 System of t'e pro4ress of t'e ,-o!s w'&!' were sent* a
stat!s conf$rmat$on messa4e &s sent. /'e R53 System t'en appens t'e status re!ors w'&!' were
re!e&(e to t'e !orrespon&n4 out#oun ,-o! &n t'e ata#ase. /'e R53 System !an also sen status
!onf&rmat&on messa4es for ,-o!s. =owe(er* t'&s &s only poss&#le (&a t'e spe!&al ,-o! type
SBS/A/0<* t'at &s* no !ontrol re!ors or ata re!ors are sent &n t'&s !ase. /'e status &nformat&on &s
t'erefore lo!ate &n t'e ata re!ors for ea!' ,-o!F
Summary: ,-o!s w'&!' are transm&tte #etween two &fferent systems are always GsmallerG t'an t'e
,-o!s &n t'e R53 System #e!ause t'ey o not !onta&n status re!ors.
>C? SA$ A% BC620 <3
3.5
SAP AG 1999
Control recor"
Control recor"
IDoc ID
Partner
IDoc t+e an! logical $essage
.6ternal structure
An &mportant part of t'e !ontrol re!or &s t'e ,-o! ,-* a <6:&4&t num#er w'&!' &s ass&4ne
automat&!ally #y t'e system. /'&s num#er &s use as a un&Due &ent&f&er for t'e ,-o! &n t'e R53
System. Status !onf&rmat&ons also refer to t'&s num#er.
/'e !ontrol re!or also !onta&ns t'e "ey f&els for partner prof&les: $artner an lo4&!al messa4e >3
f&els ea!'?* as well as a fla4 &n&!at&n4 w'et'er &t &n(ol(es a test partner. 9or &n#oun ,-o!s* t'ese
"ey f&els eterm&ne t'e epenent parameters of t'e &n#oun partner prof&le* for e6ample* 'ow
&n#oun ,-o!s s'oul #e pro!esse &n t'e R53 System.
/'e t'ree "ey f&els for t'e partner >re!&p&ent? are:
$artner num#er >&nternal num#er from master ata &n t'e R53 System?
$artner type >!ustomer* (enor or lo4&!al system &n A20 s!enar&os?
$artner fun!t&on >&mportant &n out#oun pro!ess&n4 us&n4 Messa4e Control* ot'erw&se opt&onal?
/'e t'ree f&els for lo4&!al messa4es are:
Messa4e type >!orrespons to ;N50-,9AC/ messa4es &f poss&#le?
Messa4e (ar&ant >opt&onal?
Messa4e fun!t&on >opt&onal?
.t'er f&els relate to t'e !ontrol re!or* for e6ample !on(ers&on to anot'er 0-, stanar (&a an 0-,
su#system or an e6ternal 0-, messa4e ar!'&(e.
>C? SA$ A% BC620 <4
3.6
SAP AG 1999
Data 0ecor" an" Seg&ent Str$ct$re
Data recor"
'ontrol +art8 contains
seg$ent na$es
A++lication !ata
:iel! 2 :iel! 1 ;;;
Seg$ent
Se4ment names are store &n t'e !ontrol part of a ata re!or. /'&s se4ment &s ef&ne as a stru!ture
&n t'e R53 System.
As a result of t'e se4ment name #e&n4 store &n t'e !ontrol part* a stru!ture &s ass&4ne to t'e
unstru!ture se!t&on of t'e appl&!at&on ata #y apply&n4 t'e @networ" of appl&!at&on f&els@. /'&s
always 'appens w'en an appl&!at&on reas ata from an ,-o! or w'en t'e appl&!at&on wr&tes ata to
an ,-o!.
/'e ata type of t'e se4ment f&els &s character.
,f poss&#le* ,S. !oes are use for !oe f&els.
>C? SA$ A% BC620 <5
3.7
SAP AG 1999
Stat$ 0ecor"
Stat$ 0ecor"
IDoc ID
Status in"or$ation
/'e ,-o! num#er of t'e ,-o! to w'&!' t'e status re!or refers &s an &mportant part of t'e status
re!or. /'&s allows t'e ,-o! rele(ant to a status !onformat&on messa4e to #e &ent&f&e &n t'e system
an t'e returne status re!ors !an t'erefore #e appene.
/'e f&rst status &nformat&on ur&n4 pro!ess&n4 &s ta"en from t'e status (alue or status. /'&s &s use as
a #as&s for t'e e6!ept&on 'anl&n4.
More eta&le &nformat&on !an #e o#ta&ne from t'ree f&els w'&!' are use to name R53 messa4es &n
t'e stanar system. ,f an error o!!urs ur&n4 ,-o! pro!ess&n4 &n t'e R53 System* a !orrespon&n4
error messa4e !an #e store &n t'e status re!or (&a t'e status (alue @&n!orre!t@. 06ample : messa4e
SA$00<33 >@error ur&n4 R9C w&t' port 1@?:
SA$: R53 messa4e* &splaye &n a stanar w&now >f&el S/AM3;?
00: Messa4e !lass as ef&ne &n ta#le /<00 >f&el S/AM,-?
<33: Messa4e num#er as ef&ne &n ta#le /<00 >f&el S/AMN.?.
,f t'e f&rst t'ree !'ara!ters refer to an e6ternal system* spe!&al messa4es !an #e &splaye for t'e
system. =owe(er* t'e &splay must #e pro4ramme spe!&f&!ally an a l&n" to t'e pro4ram must #e
&n!lue to ta#le /0-03.
.t'er f&els &n t'e status re!or &n!lue t'e !reat&on ate* !reat&on t&me an name of t'e pro4ram
w'&!' &s!o(ere t'e error ur&n4 ,-o! pro!ess&n4.
>C? SA$ A% BC620 <6
3.8
SAP AG 1999
IDoc 0ecor" Type1 S$&&ary
Control recor"
Data recor"
IDoc ID
Partner
IDoc t+e an! logical $essage
.6ternal structure
'ontrol +art A++lication !ata
Stat$ recor"
IDoc ID
Status in"or$ation
>C? SA$ A% BC620 <C
3.9
SAP AG 1999
IDoc Type
Control 0ecor"
Stat$ 0ecor"
Data recor"4 repreente" a a eg&ent tree
</T+S98
</BDAD0
</ITSCB
</BDD7C
</ITD7C
<lterneg&ent
@in"eg&ent
</ITSCB
' #
</ITD7C
< 1
' 99
< 1
' #
' 1
0a!' #us&ness pro!ess >for e6ample a pur!'ase orer? usually !orrespons to a !erta&n ,-o! type*
w'&!' !an &n!lue t'e rele(ant ata.
An ,-o! type &s ef&ne #y t'e se4ments* t'e&r '&erar!'y* seDuen!e an freDuen!y of use. /'&s
&nformat&on &s !onta&ne &n t'e !ontrol part of t'e ata re!ors.
/'e se4ment '&erar!'y !an #e represente &n tree form as parent an !'&l se4ments. /'&s allows t'e
appl&!at&on ata to #e stru!ture.
Summary: ,-o! types are spe!&al ata stru!tures for spe!&al appl&!at&ons or messa4es. ,f su!' a
stru!ture !onta&ns appl&!at&on ata* an ,-o! &s !reate >t'e &nstan!e of t'e ,-o! type?.
>C? SA$ A% BC620 <E
3.10
SAP AG 1999
7$t%o$n" an" In%o$n" Proceing
7$t%o$n" Proceing In%o$n"
IDoc Interface3A+< Ser!ice
<(ternal Syte&
SAP Application
03, Syte&
-&re!t&ons are always ef&ne from R53. /'erefore* &n t'e o!t"o!nd &re!t&on* ata &s sent from t'e
appl&!at&on to t'e e6ternal system (&a t'e ,-o! ,nterfa!e. 9or t'e &n#oun &re!t&on* t'e oppos&te &s
true.
9or &n#oun pro!ess&n4* t'e e6ternal system must #e ass&4ne !erta&n aut'or&Aat&ons. -o!uments
>,-o!s an appl&!at&on o!uments? are to #e !reate &n t'e R53 System.
-&fferent opt&ons are a(a&la#le for #ot' &n#oun an out#oun pro!ess&n4. /'ese opt&ons are
e6pla&ne &n t'e follow&n4 sl&es.
>C? SA$ A% BC620 <8
3.11
SAP AG 1999
7$t%o$n" Proceing $ing 8eage
Control
IDoc IDoc
8C 8C
recor" recor"
Doc$&ent Doc$&ent
SAP Application
8eage Control (8C)
<(ternal Syte&
IDoc Interface 3 A+< Ser!ice
-ur&n4 out#oun pro!ess&n4 us&n4 Messa4e Control* t'e appl&!at&on sens ,-o!s to t'e ,-o!
,nterfa!e (&a Messa4e Control. /'e ,-o!s !an #e pro!esse furt'er >for e6ample f&ltere? #y t'e A20
ser(&!es* &f reDu&re* #efore #e&n4 sent to t'e port.
/'e ,-o! ,nterfa!e sens ea!' ,-o! to t'e su#seDuent system a!!or&n4 to t'e te!'n&!al port
ef&n&t&on. 06amples of (ar&ous port types:
06ternal system H R53 System: usually transa!t&onal R9C >stanar A20 s!enar&o?
06ternal system H 0-, su#system: ;sually t'e f&le &nterfa!e
>C? SA$ A% BC620 20
3.12
SAP AG 1999
Co&&. IDoc Co&&. IDoc Co&&. IDoc Co&&. IDoc Co&&. IDoc Co&&. IDoc
8
a
t
e
r

I
D
o
c
8
a
t
e
r

I
D
o
c
Direct 7$t%o$n" Proceing $ing A+<
SAP Application
<(ternal Syte&
-ur&n4 &re!t out#oun pro!ess&n4* t'e A20 ser(&!es are always !alle. /'ese ser(&!es:
9&lter t'e ,-o!: -ata not reDu&re for t'e !ommun&!at&on &s remo(e from t'e ,-o!
C'an4e t'e >se4ment? (ers&on: &f t'e re!&p&ent only re!o4n&Aes an earl&er (ers&on of t'e ,-o!
type* t'e (ers&on !an #e !'an4e 'ere. /'&s means t'at less ata &s transporte* as later (ers&ons
of ,-o! types !an only !onta&n more ata t'an former (ers&ons an ne(er less.
-eterm&ne t'e ,-o! re!&p&ent us&n4 a ma&nta&ne &str&#ut&on moel* &n !ase t'e appl&!at&on
&tself & not spe!&fy t'e re!&p&ent.
-upl&!ate t'e ,-o!* &f reDu&re* for &str&#ut&on moels.
/'e A20 ser(&!es !reate one >or more? comm!n$cat$on IDoc(s) from one master IDoc >w'&!' &s
transferre to fun!t&on moule MAS/0RI,-.CI-,S/R,B;/0?. .nly !ommun&!at&on ,-o!s are
sa(e &n t'e ata#ase.
>C? SA$ A% BC620 2<
3.13
SAP AG 1999
In%o$n" Proceing $ing ;or2flo'
Doc$&ent Doc$&ent
IDoc C IDoc C
proce proce
IDoc IDoc
SAP Application
SAP B$ine ;or2flo'
<(ternal Syte&
IDoc Interface ? A+< Ser!ice
/'e e6ternal system sens ,-o!s to t'e R53 System. /'e R53 System &s aresse (&a t'e port name
SA$JS,-K for e6ample SA$C<< for an R53 System !alle C<<.
,f t'e ,-o! ,nterfa!e re!o4n&Aes t'e e6ternal system* t'e &n#oun ,-o!s are a!!epte an !'e!"e*
t'at &s* a synta6 !'e!" &s performe an t'e system !'e!"s w'et'er t'e sener &s entere as a partner.
/'e ,-o! &s sent to t'e appl&!at&on (&a SA$ Bus&ness +or"flow a!!or&n4 to t'e sett&n4s &n t'e
partner prof&le.
,f reDu&re* t'e ,-o! !an #e pro!esse #y t'e A20 ser(&!es #efore #e&n4 sa(e &n t'e ata#ase as an
&n#oun ,-o!.
>C? SA$ A% BC620 22
3.14
SAP AG 1999
IDoc IDoc
Direct In%o$n" Proceing $ing A+<
IDoc IDoc
SAP Application
<(ternal Syte&
;nt&l t'e partner prof&le sett&n4s are rea* &re!t &n#oun pro!ess&n4 wor"s &n t'e same way as
&n#oun pro!ess&n4 (&a wor"flow:
/'e ,-o! &s passe &re!tly to t'e appl&!at&on fun!t&on moule a!!or&n4 to t'e partner prof&le
sett&n4s.
Bou !an also set t'e pro!ess !oe >see t'e $artner $rof&les un&t? so t'at t'e A20 ser(&!es are always
!alle ur&n4 &re!t &n#oun pro!ess&n4. As &n t'e !ase of out#oun pro!ess&n4* t'ese ser(&!es are
respons&#le for f&lter&n4 an (ers&on !'an4es. =owe(er* ,-o!s !annot #e upl&!ate ur&n4 &n#oun
pro!ess&n4.
+'en us&n4 an A20 ser(&!e* t'e Len resultM &s only e(er store &n t'e ata#ase. /'&s &s t'e
a##l$cat$on IDoc* &n !ontrast to t'e &n#oun comm!n$cat$on IDoc.
>C? SA$ A% BC620 23
3.15
SAP AG 1999
IDoc in B$ine Procee1 S$&&ary
<ach IDoc in the 03, "ata%ae conit of one control
recor" an" e!eral "ata an" tat$ recor". 7nly
control recor" an" "ata recor" are e(change" 'ith
e(ternal yte&.
There are !ario$ IDoc type 'hich are "iting$ihe"
%y their eg&ent an" their or"er. Thi infor&ation i
tore" in the control part of the "ata recor".
Different proceing option are a!aila%le for IDoc in
%oth in%o$n" an" o$t%o$n" proceing.
>C? SA$ A% BC620 24
3.16IDocs in Business Processes Exercise
Data for e(ercie1
Training yte&1 ;ill %e anno$nce" %y the intr$ctor (for e(a&ple
I-0)
Client1 -00
9er1 BC620-nn
Pa'or"1 @90S
Port1 S9BSAST<8 of type D:ileE ("efa$lt)
Data Data $n tra$n$ng system Data $n ID&S
C!stomer s$de
Mater&al S=:<00 S=:<00
7enor /:B,2nn <0<4
$ur!'as&n4 or4an&Aat&on <000 <000
$ur!'as&n4 4roup 00< 00<
$lant <<00 <<00
)endor s$de
Mater&al S=:<00 S=:<00
Sol:to party /:B,Nnn <<<0
.rer type /A
Sales or4an&Aat&on <020 <020
-&str&#ut&on !'annel 22 22
-&(&s&on 00 00
-el&(er&n4 plant <<00 <<00
nn &s your 4roup num#er
>C? SA$ A% BC620 25
*n$t IDocs $n B!s$ness Processes
06pla&n terms
-ef&ne ,-o! stru!ture
<.< /rue or false:
<.<.< ,-o!s are always use for pro!ess !'a&ns.
<.<.2 ,-o!s are &nterme&ate o!uments: +'en t'e appl&!at&on o!uments 'a(e
#een !reate* t'e ,-o!s are elete from t'e R53 System.
<.<.3 ,-o! types es!r&#e 'ow ,-o!s are stru!ture.
<.<.4 /'ere are #as&! rules for ,-o! stru!tures.
<.<.5 /'e &fferen!es #etween ,-o! types &n(ol(e more t'an t'e se4ments w'&!'
t'ey !onta&n.
<.2 /rue or false:
<.2.< ,n out#oun pro!ess&n4* ,-o!s are always 4enerate #y t'e ,-o! ,nterfa!e
or #y t'e appl&!at&on.
<.2.2 ,n &n#oun pro!ess&n4* ,-o!s are always 4enerate #y t'e ,-o! ,nterfa!e.
<.2.3 06!ept&on 'anl&n4 (&a wor"flow &s not poss&#le &n out#oun pro!ess&n4.
<.2.4 An e6ternal system 'as &ts own formats for ,-o! ata. /'ere are t'erefore
no ,-o!s &n t'e e6ternal system.
>C? SA$ A% BC620 26
3.17IDocs in Business Processes Solutions
*n$t IDocs $n B!s$ness Processes
<.< /rue or false:
<.<.< ,-o!s are always use for pro!ess !'a&ns.
false: Process chains can also be used within the R/3 System (for example
workflow) and can therefore be used without Iocs!
<.<2 ,-o!s are &nterme&ate o!uments: +'en t'e appl&!at&on o!uments 'a(e
#een !reate* t'e ,-o!s are elete from t'e R53 System.
false: Iocs can only be deleted from the system when they ha"e been
archi"ed! #he phrase $intermediate document% does not refer to the &life
expectancy& of an Ioc!
<.<.3 ,-o! types es!r&#e 'ow ,-o!s are stru!ture.
true
<.<.4 /'ere are #as&! rules for ,-o! stru!tures.
true
<.<.5 /'e &fferen!es #etween ,-o! types &n(ol(e more t'an t'e se4ments w'&!'
t'ey !onta&n.
false: Ioc types are only defined by their se'ments! Iocs( howe"er( can
be distin'uished by the Ioc type and their contents!
<.2 /rue or false:
<.2.< ,n out#oun pro!ess&n4* ,-o!s are always 4enerate #y t'e ,-o! ,nterfa!e
or #y t'e appl&!at&on.
true
<.2.2 ,n &n#oun pro!ess&n4* ,-o!s are always 4enerate #y t'e ,-o! ,nterfa!e.
true
<.2.3 06!ept&on 'anl&n4 (&a wor"flow &s not poss&#le &n out#oun pro!ess&n4.
false: )xception handlin' exists for processin' errors or syntax errors
when dealin' with both inbound and outbound processin'!
<.2.4 An e6ternal system 'as &ts own formats for ,-o! ata. /'ere are t'erefore
no ,-o!s &n t'e e6ternal system.
false: #he Ioc format must at least be reco'ni*ed by the external system!
In addition( &external systems& can be R/3 Systems or R/+ Systems( in
which case Iocs are always stored in the system!
>C? SA$ A% BC620 2C
-
SAP AG 1999
Doc$&entation Tool
0ecor" type4 IDoc type4 eg&ent
7$tp$t for&at
>C? SA$ A% BC620 <
4.2
SAP AG 1999
9e the "oc$&entation tool
Deci"e in 'hich it$ation they 'o$l" %e $ef$l
Doc$&entation Tool1 9nit 7%6ecti!e
>C? SA$ A% BC620 2
4.3
SAP AG 1999
7!er!ie' Diagra& (Sen"ing Data)
R/3 Sste$ R/3 Sste$
Post !ocu$ent
Generate IDoc
Trans"er !ata8
+rocess "urther
Archi*e IDoc 7
Archi*e IDoc 7
.DI Su/sste$ 7
.DI Su/sste$ 7
Doc$&entation
Tool
Doc$&entation
Tool
Partner Pro"iles
Partner Pro"iles
Port De"inition
Port De"inition
<(ternal Syte& <(ternal Syte&
SmartMart must !onf&4ure t'e ,-o! ,nterfa!e for out#oun pro!ess&n4:
;s&n4 t'e doc!mentat$on tools* SmartMart sens &nformat&on a#out t'e stru!ture of ,-o! /ype
.R-0RS0< to t'e 0-, su#system.
>C? SA$ A% BC620 3
4.4
SAP AG 1999
B$ine cenario
A a &e&%er of the i&ple&entation tea& for yo$r
co&pany (S&art8art or =$ic2Deli!er)4 yo$ are
reponi%le for config$ring the IDoc Interface.
Ao$r <DI $%yte& "oe not yet 2no' the tr$ct$re
of the IDoc type to %e $e". The IDoc Interface can
e(port IDoc type tr$ct$re in !ario$ for&at4 $ing
the "oc$&entation tool. Ao$ &$t 2no' a%o$t thi
f$nction4 a yo$ can a!e yo$relf a lot of
progra&&ing 'or2 in the <DI $%yte&.
>C? SA$ A% BC620 4
4.5
SAP AG 1999
0
e
l
e
a
e

,
.
0
Internal an" <(ternal Str$ct$re
:iel! 1 :iel! 2
:iel! 1 :iel! 2 :iel! 3 :iel! 4
Seg&ent
internal
e(ternal
</...
<2...00/
,-o! types are &st&n4u&s'e #y t'e&r se4ments* t'at &s t'e stru!ture or raster la& upon t'e ata part
of t'e ata re!or. /'ese Se4ments e6&st &n #ot' &nternal an e6ternal form:
,nternally as a release:&nepenent stru!ture >SA$ names #e4&n w&t' 0<?* !onta&n&n4 all t'e
ef&ne se4ment f&els.
06ternally as a release:epenent stru!ture >SA$ names #e4&n w&t' 02?* !onta&n&n4 only t'e
se4ment f&els ef&ne for t'e spe!&f&e release &n t'e partner prof&le.
,n a&t&on to t'e se4ments* t'ere are also ,-o! re!or types* &n #ot' &nternal >&n t'e R53 ata#ase?
an e6ternal >as stru!tures sent to t'e e6ternal system? forms. Bot' 'a(e !'an4e &n &fferent R53
Releases. /'e o!umentat&on tools only e6port t'e e6ternal stru!tures &n t'&s !ase.
As a result* w'en runn&n4 t'e o!umentat&on tools* you 'a(e to enter t'e follow&n4 parameters:
/'e %ers$on of t'e e6ternal record ty#es >as entere &n t'e port ef&n&t&on?
/'e release of t'e e6ternal se4ment >as entere &n t'e partner prof&les?
/'e efault (alues are t'e !urrent release num#er an t'e rele(ant status re!or (ers&on. ,f you
!'an4e t'e (alues* L4o #a!" to t'e pastM.
>C? SA$ A% BC620 5
4.6
SAP AG 1999
7$tp$t in Fario$ :or&at I
>
>
>
>
,-o! types* se4ments an re!or types !an #e &splaye &n user:fr&enly formats w'&!' !an #e rea
#y ot'er systems. /'e follow&n4 &splay opt&ons are a(a&la#le:
R53 tree &splay: ,n t'e !ase of 4eneral re!or types* t'e @tree@ 'as only one le(el #e!ause t'e
'&erar!'y only e6&sts for se4ments an t'erefore for spe!&al ,-o! types.
=/M2 f&le ,n t'e ,-o! am&n&strat&on user parameters you !an set w'et'er an e6ternal #rowser &s
to #e starte or w'et'er t'e SA$ &nternal =/M2 !ontrol s'oul #e use.
/'e o!umentat&on 4oes #eyon t'e stru!ture: ,t also relates to t'e ata elements #e'&n t'e se4ment
stru!ture f&els. /'e o!umentat&on tools !an also pro(&e &nformat&on a#out us&n4 &n&(&ual ,-o!
types.
>C? SA$ A% BC620 6
4.7
SAP AG 1999
7$tp$t in Fario$ :or&at II
Begin
G
<n"
type"ef tr$ct H2inco"(000
G
H2inco"(000
>
>
>
>
I8+
Ma!'&ne:reaa#le formats are:
A s&mple !'a&n of #e4&n..en e!larat&ons w'&!' !an #e rea #y a parser
C:=eaer
Meta:,-o!* type SBR0C-0< >,-o! re!or types? or SB,-.C0< >,-o! types?
Meta ata for ,-o! types &n 1M2 format
Bou start t'e o!umentat&on tools from t'e &n&t&al noe of t'e ,-o! ,nterfa!e from t'e
Documentation menu. /'e parser 'as &ts own menu entry* #ot' for re!or types an ,-o! types.
>C? SA$ A% BC620 C
4.8
SAP AG 1999
Doc$&entation Tool1 S$&&ary
The "oc$&entation tool "ecri%e %oth the
tr$ct$re an" the $e of "ifferent IDoc.
The tr$ct$re i in the tr$ct$re infor&ation.
<(ternal tr$ct$re are al'ay "oc$&ente"4
pecifically regar"ing ho' they are e(change"
'ith e(ternal yte&.
The o$tp$t for&at can %e rea" %y e(ternal
yte&4 o that non-03, Syte& can 5$ic2ly
recogniHe the IDoc tr$ct$re.
>C? SA$ A% BC620 E
4.9Documentation ools Exercise
*n$t Doc!mentat$on Tools
To#$c +!t#!t formats
At t'e !on!lus&on of t'ese e6er!&ses* you w&ll 'a(e:
2earne a#out &fferent output formats
As a mem#er of t'e 0-, proOe!t team for your !ompany* you reDu&re
&nformat&on on ,-o! type .R-0RS0< for two reasons:
/o prepare for a proOe!t &s!uss&on a#out Lpur!'ase orer5orer (&a 0-,M.
/o &nform your 0-, su#system pro(&er of t'&s ata stru!ture.
<:< Sele!t ocumentation Ioc types from t'e &n&t&al noe of t'e ,-o! &nterfa!e. As
you w&s' to use t'e stanar an 'a(e not yet e6tene any ,-o! types* enter t'e ,-o!
type +,D&,S0- an t'en sele!t Bas$c ty#e &n t'e e"elopment ob,ect frame!
<:2 Bou w&s' to re!e&(e all t'e &nformat&on on t'e ,-o! type. By sele!t&n4 -oto .ser
settin's( you !an !'e!" t'at all t'e &splay attr&#utes are a!t&(ate. Sa(e your entr&es
an return to t'e &n&t&al s!reen.
<:3 +'en prepar&n4 for t'e &s!uss&on* you opt for t'e output format /#01 pa'e ue to
t'e !on(en&ent na(&4at&on opt&ons. /'ree f&les are 4enerate on your $C. ,f you 'a(e
not !'an4e any of t'e sett&n4s* t'ese f&les are .R-0RS0<I9.=/M*
.R-0RS0<I,.=/M an .R-0RS0<I-.=/M. 9&le .R-0RS0<I9.=/M !an #e
opene (&a ,nternet 06plorer.
>C? SA$ A% BC620 8
*
SAP AG 1999
Port Definition
Port type an" 'hen they are $e"
Port "efinition para&eter
Co&&$nication 'ith 7l"er 0eleae
>C? SA$ A% BC620 <
5.2
SAP AG 1999
Deci"e 'hich port type ho$l" %e i&ple&ente"
for 'hich e(ternal yte&
<nter a port "efinition in the 03, Syte&
Deter&ine 'hich a""itional tep are re5$ire" for
lin2ing to the rele!ant e(ternal yte&
<nter pecial etting 'hich are re5$ire" for
co&&$nication 'ith ol"er 03, releae an" 032
Syte&
Port Definition1 9nit 7%6ecti!e
>C? SA$ A% BC620 2
5.3
SAP AG 1999
R/3 Sste$ R/3 Sste$
Pot "oc$&ent
Generate IDoc
Tranfer "ata4
proce f$rther
Archi*e IDoc 7
Archi*e IDoc 7
.DI Su/sste$ 7
.DI Su/sste$ 7
Docu$entation
Tools
Docu$entation
Tools
Partner Pro"iles
Partner Pro"iles
Port Definition
Port Definition
<(ternal Syte& <(ternal Syte&
/'e !ompany SmartMart w&s'es to sen pur!'ase orers to 3u&!"-el&(er (&a 0-,. 3u&!"-el&(er
w&s'es to &mme&ately post t'ese pur!'ase orers ele!tron&!ally. Bot' !ompan&es 'a(e R53 Systems
an must !onf&4ure t'e&r ,-o! ,nterfa!e a!!or&n4ly.
SmartMart must !onf&4ure t'e ,-o! ,nterfa!e for sen&n4 ata >out#oun pro!ess&n4 or s&mply
o!t"o!nd?:
SmartMart ef&nes t'e system w'&!' w&ll re!e&(e ,-o!s an t'e te!'n&!al parameters (&a t'e #ort
def$n$t$on.
>C? SA$ A% BC620 3
5.4
SAP AG 1999
Port Definition1 B$ine Scenario
S&art8art4 yo$ are reponi%le for config$ring
the IDoc Interface.
Ao$ &$t "eci"e 'hich port type i $ita%le for
the yte& of yo$r partner co&pany
=$ic2Deli!er.
>C? SA$ A% BC620 4
5.5
SAP AG 1999
IDoc Interface1 Port Type
IDoc Interface
CPI-C
032 Syte& <(ternal Syte&
:ile
IDoc3 IDoc3
tat$ tat$
IDoc3 IDoc3
tat$ tat$
PI
IDoc IDoc
>
I8+
IDoc IDoc
t0:C
IDoc IDoc
Internet
IDoc IDoc
$orts are t'e !'annels (&a w'&!' t'e ,-o!s are e6!'an4e. /'e ,-o! ,nterfa!e supports s&6 &fferent
transm&ss&on met'os. /'ese are t'e port types:
@9&le@: ,-o!s are wr&tten &n f&les at an operat&n4 system le(el. /'e re!e&(&n4 system !an rea t'e f&les
'ere. /'e re!e&(&n4 system !an also #e starte us&n4 t'e syn!'ronous R9C. Bes&es ,-o!s >t'at &s
ata an !ontrol re!ors?* status re!ors !an also #e e6!'an4e #y f&le.
@1M2@: /'e ,-o!s are wr&tten &n 1M2 format &n t'e f&les. As &s t'e !ase w&t' t'e port type @f&le@*
t'e re!e&(&n4 system &s starte (&a R9C* #ut 'ere status re!ors are only transferre #y means of t'e
,-o! type SBS/A/0<.
@/ransa!t&onal R9C@ ,-o!s are sent as ta#les. /yp&!ally 'ere* t'e e6ternal system &s an R53 System
>A20 s!enar&os?.
@C$,:C@ ,-o!s or !ontrol re!ors are transferre a!!or&n4 to t'e C$,:C proto!ol* &n t'e way &t &s
&mplemente for t'e ,-o! ,nterfa!e &n t'e R52 System. /'e e6ternal system &s always an R52 System.
,-o!s are always e6!'an4e #y means of t'e C$,:C proto!ol &n t'e R52 ,-o! ,nterfa!e >a(a&la#le
from R52 Release 5.09?. 9or furt'er &nformat&on see t'e R52 'an#oo"* p53.2.
@,nternet@: /'e ,-o!s are wr&tten &n M,M0 format to an e:ma&l atta!'ment.
@$ro4ramm&n4 ,nterfa!e >$,?@: ,-o!s are sent as ta#les to one of t'e fun!t&on moules ef&ne. .o!
therefore do not lea%e the ,/0 System %$a a PI #ort. Bour fun!t&on moule !an naturally tr&44er or
perform an e6ternal &spat!'.
>C? SA$ A% BC620 5
5.6
SAP AG 1999
Port Definition1 Port Type J:ileJ
Co&&an" file
7$t%o$n" file
In/oun! "ile
Status "ile
IDoc file
Stat$ report
rfce(ec
o$t.cript
0:C "etination
(TCP3IP connection)
-ata for te!'n&!al l&n"&n4 &s eterm&ne &n t'e port ef&n&t&on for t'e ,-o! ,nterfa!e. So t'at a port
!an #e use* sett&n4s outs&e of t'e ,-o! ,nterfa!e must #e mae.
/'e port ef&n&t&on for t'e port type @f&le@ &n!lues
Name an &re!tory of f&les. .nly t'e out#oun f&le &s &mportant* as t'e pla!e an name of t'e f&le
are eterm&ne #y t'e e6ternal system ur&n4 &n#oun pro!ess&n4 of ,-o!s or a status
!onf&rmat&on. =owe(er* &f you o enter a parameter for t'e &n#oun ,-o! an status f&le* t'e test
tool !an 4enerate efault (alues. ,t &s &mportant t'at t'e port e6&sts e(ery t&me* e(en &f &t &s only
use &n &n#oun pro!ess&n4* as t'e ,-o! ,nterfa!e only a!!epts ports t'at &t re!o4n&Aes.
,nstea of t'e out#oun f&le* you !an also store a fun!t&on moule* w'&!' ynam&!ally 4enerates
names an t'us 'elps to pre(ent f&les from #e&n4 o(er:wr&tten. Bou !an also use lo4&!al f&le names:
Bou s'oul also see t'e 9< =elp for t'e f&el.
Name an &re!tory of !omman f&le t'at &s to #e !alle from pro4ram @rf!e6e!@ an w'&!' s'oul
start t'e e6ternal system : t'&s f&le must #e !reate so t'at t'e R53 System !an start t'e re!e&(&n4
system automat&!ally >H tr$gger? as soon as &t 'as 4enerate an ,-o! f&le.
,f you tr&44er us&n4 R9C* you reDu&re t'e R9C est&nat&on. /'&s &s ma&nta&ne w&t' t'e transa!t&on
SM58 >/C$5,$ !onne!t&ons?. ,t &s a sett&n4 outs&e of t'e ,-o! ,nterfa!e.
>C? SA$ A% BC620 6
5.7
SAP AG 1999
Proce :lo'1 Port Type :ile ('ith Triggering)
/
;rite
IDoc file
-
0ea"
2
0:C
,
Call
rfce(ec
o$t.cript
/
;rite
IDoc file
Stat$ report
tartrfc
in.cript
tat$.cript
,
0:C
2
Call
-
0ea"
IDoc Interface
<(ternal Syte&
,-o! out#oun:
,n step <* a new f&le &s 4enerate w&t' t'e transferre ,-o!s #y t'e ,-o! ,nterfa!e. ,n t'e se!on step*
t'e pro4ram Lrf!e6e!M >syn!'ronous R9C? w&t' t'e pat' to an e6e!uta#le pro4ram &s !alle >'ere:
Lout.s!r&ptM? an also t'e pat' to t'e ,-o! f&le. Lout.s!r&ptM t'us !onta&ns t'e pat' an name of t'e
f&le as an &nput (alue. ,n step 3* &t t'erefore !alls t'e e6ternal system* w'&!' reas t'e f&le &n step 4.
After su!!essful pro!ess&n4 of t'e ,-o! f&le* t'e e6ternal system must elete t'e ,-o! f&le. /'e !all
!omman &n Lout.s!r&ptM epens on t'e e6ternal system.
,-o! &n#oun:
,n step <* t'e e6ternal system 4enerates an ,-o! f&le. ,n step 2 &t starts t'e R53 System &n w'&!' &t
e6e!utes t'e pro4ram @startrf!@. Lstartrf!M re!e&(es t'e lo4on parameter an t'e names of t'e fun!t&on
moule to #e e6e!ute* t'e port an t'e pat' to t'e ,-o! f&le. /'e Lstartrf!M!omman !an #e &n!lue
&n an e6e!uta#le pro4ram* 'ere L&n.s!r&ptM. ,n step 4* t'e R53 System starte t'en pro!esses t'e ,-o!
f&le an eletes &t after su!!essful pro!ess&n4. It $s $m#ortant that the e1ternal system logs on to
an ,/0 System 2$th a !ser 2h$ch has the corres#ond$ng a!thor$3at$on for creat$ng a##l$cat$on
doc!ments'
/'e status report wor"s &n e6a!tly t'e same way as an &n#oun ,-o!* e6!ept t'at 'ere a status f&le
&nstea of an ,-o! f&le &s transferre.
Lrf!e6e!M an Lstartrf!M are e6ample pro4rams for t'e use of t'e R9C l&#rary an are suppl&e w&t'
t'&s.
>C? SA$ A% BC620 C
5.8
SAP AG 1999
Port Type I8+1 :lat :ile an" I8+ :ile
0-,I-C40 004000000000030C02346B 30<3 .R-0RS0<
...
020-$0<005 004000000000030C02300002<0000000200
020-$20 004000000000030C02300002200002<0323
...
020-$/<00< 004000000000030C02300002600002<03B0S/-
020-$/200< 004000000000030C02300002C00002604/'&s &s
/'e ,-o! ata &s wr&tten &n a f&le uner t'e port type @1M2@* #ut &n 1M2 format. =en!e t'e port
ef&n&t&on an te!'n&!al stru!ture are almost &ent&!al.
;ner port type @f&le@* no stru!ture &nformat&on at all &s wr&tten &n t'e f&le. /'e &n&(&ual se4ments
are put &n a row one after anot'er as ata re!ors an are separate w&t' carriage return. /'us you
also spea" of a @flat f&le@.
/'e f&els are &ent&f&e #y means of t'e&r pos&t&on &n t'e &n&(&ual re!ors. Su!' a flat f&le t'erefore
!onta&ns as many #lan" !'ara!ters as poss&#le so t'at t'e f&els are &n t'e r&4't pla!e.
>C? SA$ A% BC620 E
5.9
SAP AG 1999
Port Type I8+1 :lat :ile an" I8+ :ile (2)
<DIKDC-0
</<DP0/
</<DP20
</<DPT/
</<DPT2
J0-,I-C40 S0%M0N/H@<@KJ/ABNAMKJFPC-A/
AP0-,I-C40QQKJ5/ABNAMKJMAN-/K004J5MAN
-/KJ-.CN;MK000000000030C023J5-.CN;MK
...
J0<0-$0< S0%M0N/H@<@KJ$.S01K000<0 J5$.S
01KJAC/,.NK00<J5AC/,.NKJ$S/B$K0J5$S/B$
KJM0N%0K23.000J5M0N%0K...
...
J0<0-$20 S0%M0N/H@<@KJ+M0N%K23.000 J5+
M0N%KJ0-A/;K<8880622J50-A/;KJ50<0-$2K
...
J0<0-$/< S0%M0N/H@<@KJ/-,-KB0S/J5/-,-K
J/SS$RASK-J5/SS$RASK...
...
...
J0<0-$/2 S0%M0N/H@<@KJ/-2,N0K/'&s &s t'e
pur!'ase orer te6t.J5/-2,N0K...
...
J50<0-$/<K J50<0-$0<K
/'e se4ments are also wr&tten one after anot'er &n t'e 1M2 f&le. But t'ey are !ons&era#ly &fferent
to a flat f&le:
Se4ments are en!lose #y start an en ta4s an t'erefore o not nee to #e separate #y carriage
return. As t'e f&els are also en!lose #y ta4s* t'e se4ments are only e(er as lon4 as t'e ata
!onta&ne reDu&res 'en!e t'ere are no @unne!essary@ #lan" !'ara!ters.
As t'e ta4s !an #e !onne!te w&t' one anot'er &n 1M2* you !an &splay an 1M2 f&le as a tree. /'e
SA$ system ,-o! stru!ture t'erefore rema&ns &n t'e f&le re!e&(e an !an #e &splaye &n any 1M2:
!ompat&#le #rowser.
>C? SA$ A% BC620 8
5.10
SAP AG 1999
Port Definition - Port Type t0:C
0:C "etination
(03, connection)
Port na&e (aigne" a$to&atically)
Application er!er for
recei!ing yte&
.nly t'e name of an e6&st&n4 lo4&!al R9C est&nat&on &s entere &n t'e port ef&n&t&on. /'e system
t'en 4enerates a name for t'&s port w'&!' !ons&sts of an @A@ an a 8 &4&t num#er. /'e automat&!
num#er ass&4nment reDu&res a num#er ran4e w'&!' &s !onf&4ure &n ,-o! ,nterfa!e Custom&A&n4.
/'ere you !an also set w'et'er t'e num#ers are to #e ass&4ne &nternally or #y an e6ternal system.
Alternat&(ely to port ef&n&t&on &n t'e ,-o! ,nterfa!e* you !an !reate tR9C ports from A20
Custom&A&n4.
/'e R9C est&nat&on &tself &s ma&nta&ne w&t' t'e transa!t&on SM58 as t'e @R53 !onne!t&on@.
>C? SA$ A% BC620 <0
5.11
SAP AG 1999
Proce :lo'1 Port Type t0:C
IDoc Interface
<(ternal Syte&
0:C Interface
0:C Interface
TCP3IP
9or tR9C a system !alls a fun!t&on moule &n a se!on system. ,t follows for t'e ,-o! ata e6!'an4e
t'at t'e sen&n4 system &s always t'e a!t&(e system: ,t !alls t'e fun!t&on moule &n t'e re!e&(&n4
system an transfers t'e ,-o!s as ta#les. /'e fun!t&on moules are t'erefore &n#oun fun!t&on
moules of t'e respe!t&(e system.
,n#oun fun!t&on moules &n t'e ,-o! ,nterfa!e are t'e fun!t&on moules
,NB.;N-I,-.CIASBNC=R.N.;S >new for Release 4.0? an ,NB.;N-I,-.CI$R.C0SS
>oler releases?. /'erefore &f you want to sen ,-o!s from a 4.0 System to an oler R53 release* you
must !all ,NB.;N-I,-.CI$R.C0SS t'ere: /'&s &s set (&a t'e #ort %ers$on.
Non:R53 Systems reDu&re t'e R53 R9C l&#rary. /'e e6ternal R9C ,nterfa!e !an #e 4enerate for t'e
fun!t&on moule from t'e e(elopment en(&ronment >transa!t&on S03C? >menu: Utilities -> RFC
Interface -> Generate?. ,f a non:R53 System wants to #e a#le to re!e&(e ,-o!s #y tR9C* &t st&ll nees
a fun!t&on moule t'at &s !onf&4ure l&"e ,NB.;N-I,-.CIASBNC=R.N.;S or
,NB.;N-I,-.CI$R.C0SS.
All ,-o!s transferre are sa(e asyn!'ronously &n t'e ata#ase us&n4 t'e s&n4le C.MM,/ +.RN
!omman.
9or furt'er &nformat&on see t'e A20 o!umentat&on >uner R/ !i"rary->CA-#usiness Frame$or%?
>C? SA$ A% BC620 <<
5.12
SAP AG 1999
Port Definition1 CPI-C (032 Syte&)
Bot "etination
0:C "etination
Technical para&eter
Sen" tat$ recor">
i"einfo-entry
Bot on 032
TIC78 entry
/'e lo4&!al est&nat&on an t'e 'ost est&nat&on are eterm&ne &n t'e port ef&n&t&on. /'e R9C
est&nat&on &s !reate w&t' t'e transa!t&on SM58 an !onta&ns t'e lo4on ata >name* passwor?. /'e
'ost est&nat&on &n&!ates an entry &n t'e R53 &nternal ta#le /1C.M.
/'e /1C.M entry refers to a 4ateway. /'e lo4&!al est&nat&on &s ass&4ne a logical unit on t'e R52
s&e &n a s&e&nfo:f&le of t'&s 4ateway. /'e logical unit &s part of t'e networ" ar!'&te!ture SNA an
&ent&f&es !omputers or also pro4rams to #e starte.
Bes&es t'e tar4et system* t'e port ef&n&t&on also !onta&ns te!'n&!al parameters l&"e t'e #uffer s&Ae
of t'e C$,:C ata #uffer or a fla4 s'ow&n4 w'et'er t'e R52 System s'oul sen a !onf&rmat&on of
re!e&pt.
Note t'at for t'&s port type not only t'e name* #ut rat'er also te!'n&!al parameters are also &mportant
for $n"o!nd #rocess$ng' /'e reason for t'&s &s t'at t'e R52 System &s always pass&(e* t'at &s* t'e R53
System also !olle!ts t'e ,-o!s from t'e R52 System uner &n#oun pro!ess&n4.
/'e e6a!t fun!t&ons an !onf&4urat&on of t'&s port type !an #e foun
,n t'e R52 manual S53.2 >,-o! ,nterfa!e?. ;n&t E of t'e manual es!r&#es &n eta&l 'ow t'e sen&n4
an re!e&(&n4 s&e of t'e C$,:C !onne!t&on &n an 0-, su#system are !onf&4ure
,n t'e R53 .SS note 6<524 an
,n t'e R52 .SS notes 52553 an 5C0<4.
>C? SA$ A% BC620 <2
5.13
SAP AG 1999
Proce :lo'1 Port Type CPI-C
032 IDoc Interface
+9 6.2
TCP3IP
2. 2. 0etrie!e3en" IDoc or 0etrie!e3en" IDoc or
recei!e3en" tat$ recei!e3en" tat$
recor" recor"
CPI-C
/.
Co&&$nication
tr$ct$re
03, IDoc Interface
/'e R52 System &s always pass&(e* t'e !ommun&!at&on &s always starte from t'e R53 System. /'e
ata #&n&n4s supporte are:
R53 out#oun* ,-o! from R53 to t'e R52 >R53 sens ,-o!s: from R52 Rel. 5.09* from R53 Rel. 3.0?
R53 &n#oun* ,-o! from R52 to R53 >R53 re!e&(es ,-o!s: from R52 Rel. 5.09* from R53 Rel. 3.<?
Status report >R53 sens e6a!tly one status re!or per ,-o!: from R52 Rel. 5.09* from R53 Rel. 3.<?
Status report >R53 re!e&(es e6a!tly one status re!or per ,-o!: from R52 Rel. 5.0=* from R53 Rel.
3.<?
/'e C$,:C proto!ol !ommans are use >Common ;ser $ro4ramm&n4 ,nterfa!e?. /'e 4ateway
!on(erts t'e C$, !ommans &nto:
2; 6.2 proto!ol !ommans to t'e R52 s&e >,BM ma&nframe?
/C$5,$ proto!ol !ommans to t'e R53 s&e >!l&ent5ser(er systems?
/'e ,-o!s are sa(e syn!'ronously &n t'e ata#ase.
>C? SA$ A% BC620 <3
5.14
SAP AG 1999
Port Definition1 Internet
Internet a""re
:ol"er na&e for o$t%o$n" IDoc
A""itional &ail attri%$te
Internet "etination
/'e most &mportant part of t'e port ef&n&t&on &s t'e ,nternet aress >,$ aress?. /o4et'er w&t' t'e
,-o! &t &s transferre (&a SA$!onne!t to t'e ,nternet 4ateway >or t'e M&!rosoft 06!'an4e ser(er?.
9urt'ermore* t'e port ef&n&t&on !onta&ns ma&l attr&#utes:
: an e6planatory te6t w'&!' !an #e rea f&rst w'en re!e&(&n4 a ma&l as t'e ma&l #oy
: t'e t&tle of t'e ma&l &n t'e ma&l 'eaer
: t'e name of a foler &n w'&!' ,-o!s to #e sent !an #e sa(e &n t'e or&4&nal system for !ontrol
purposes.
/'e 4eneral sett&n4s >,-o! Am&n&strat&on? !onta&n t'e name of t'e foler w'ere ma&ls w&t' t'e
&n#oun ,-o!s are sa(e. Normal ,-o! &n#oun pro!ess&n4 !an only #e starte from t'&s foler.
>C? SA$ A% BC620 <4
5.15
SAP AG 1999
Proce :lo'1 Port Type Internet
IDoc Interface
SAPoffice3SAPconnect
<(ternal Syte&
IDoc IDoc
8I8< e-&ail
9or sen&n4 (&a t'e ,nternet* ,-o!s are !on(erte to anot'er format >SA$off&!e name: R3,?: a ta#le
w&t' 255 !'ara!ters. /'&s ta#le &s transferre #y SA$!onne!t:
/o t'e ,nternet 4ateway >sendmail pro4ram?* or
/o t'e M&!rosoft 06!'an4e ser(er.
/'e 4ateway >or t'e 06!'an4e ser(er? !on(erts t'e ,-o! ta#le &nto M,M0 format.
9or &n#oun pro!ess&n4* t'e pro!eure &s re(erse. ,nternet ,-o!s are &splaye to t'e rele(ant users
as ma&l atta!'ments &n SA$off&!e.
/o use t'&s port type* t'e follow&n4 parameters must #e entere:
A SA$!onne!t noe for aress type ,N/ >,nternet? must #e !onf&4ure >for forwar&n4 an
mana4&n4 ,nternet messa4es?
/'e user must 'a(e a SA$off&!e aress for aress type ,N/ to re!e&(e ,-o!s
/'e re!&p&ent of an ,nternet ,-o! forwars t'&s to t'e ummy user 0-, ;S0R >see t'e &el' on the
a''lication &n t'e port ef&n&t&on: LConf&4ure t'e SA$office user aress for t'e ,nternetM
>C? SA$ A% BC620 <5
5.16
SAP AG 1999
Port Definition1 PI
:$nction &o"$le1
#a&e an" "ecription
7'n
f$nction &o"$le
in the 03, Syte&
9or a port of type @pro4ramm&n4 &nterfa!e@* only enter t'e name of t'e fun!t&on moule to #e !alle
for out#oun pro!ess&n4.
,n t'&s ABA$ fun!t&on moule you !an pro4ram any type of pro!ess&n4. .nly t'e &nterfa!e &s
stanar.
/'e stanar system &n!lues t'e fun!t&on moule .+NI9;NC/,.N as an e6ample.
>C? SA$ A% BC620 <6
5.17
SAP AG 1999
Proce :lo'1 Port Type PI
IDoc Interface
7'n f$nction &o"$le
IDoc IDoc
.ut#oun $ro!ess&n4
/'e ,-o! ,nterfa!e !alls t'e fun!t&on moule an transfers t'e ,-o! !ontrol re!ors &n ta#le format.
9urt'er pro!ess&n4 >rea&n4 ata* pro!ess&n4 ata* wr&t&n4 status re!ors? &s pro4ramme #y t'e user.
,n#oun $ro!ess&n4
Bour fun!t&on moule must !all t'e SA$ fun!t&on moule ,-.CI,NB.;N-IASBNC=R.N.;S*
w'&!' sa(es t'e ,-o!s &n t'e ata#ase an tr&44ers t'e e(ent. /'&s e(ent asyn!'ronously starts
&n#oun pro!ess&n4.
>C? SA$ A% BC620 <C
5.18
SAP AG 1999
Co&&$nication 'ith 7l"er 0eleae
:iel" / :iel" 2
:iel" / :iel" 2
:iel" 2
2./32.2
,.03,./
-.I
#e' fiel" ,
:iel" / :iel" ,
Difference in IDoc recor" type
/'e ,-o! re!or types are ef&ne &n t'e &!t&onary #y t'e&r stru!ture.
Stru!tures 'a(e !'an4e &n &fferent releases* w&t' names #e!om&n4 lon4er an new f&els #e&n4
ae.
06ample: 9or R53 Release 3.0* t'e partner fun!t&on was &n!lue &n t'e !ontrol re!or.
/o #e a#le to !ommun&!ate w&t' earl&er releases* t'e %ers$on &s spe!&f&e &n t'e port ef&n&t&on:
7ers&on <: Re!or types are transferre us&n4 t'e Releases 2.1 stru!ture
7ers&on 2: Stru!ture of Release 3.1
7ers&on 3: Stru!ture of Release 4.1
9or port type @tR9C@* a non:R53 System must also re!o4n&Ae t'e fun!t&on moule to #e !alle* as
well as t'e !orre!t re!or types: ,NB.;N-I,-.CIASBNC=R.N.;S >new &n Release 4.0? or
,NB.;N-I,-.CI$R.C0SS >oler releases?.
As re!or types &n t'e R52 System always 'a(e t'e same stru!ture* no (ers&on must #e ma&nta&ne for
port type C$,:C. /'e stru!ture &s !o(ere #y R53 Release 3.053.< >(ers&on 2?.
>C? SA$ A% BC620 <E
5.19
SAP AG 1999
Port Definition1 S$&&ary
IDoc or tat$ recor" are al'ay e(change" 'ith an
e(ternal yte& !ia a port.
In the port "efinition for the IDoc Interface4 $er "efine
the target yte& an" the technical co&&$nication
para&eter. In a""ition4 $er can pecify the releae
tat$ for the e(ternal yte& !ia the !erion entry.
A""itional technical etting &$t alo %e entere" (alo
o$ti"e 03,)4 %efore a port can %e $e".
There are i( %aic co&&$nication techni5$e for the
IDoc Interface4 repreente" %y the i( "ifferent port
type.
>C? SA$ A% BC620 <8
5.20Port De!inition Exercise
*n$t Port Def$n$t$on
At t'e !on!lus&on of t'ese e6er!&ses* you w&ll #e a#le to:
Create a port
Bou are a mem#er of t'e 0-, proOe!t team. /'e e!&s&on 'as #een mae
to !onne!t t'e 0-, su#system to t'e R53 System (&a t'e f&le >port type
@9&le@?.
<:< Create a new port: 9rom t'e &n&t&al noe of t'e ,-o! ,nterfa!e* sele!t Ioc Port
definition( !'oose 2ile an sele!t 3reate.
Bou s'oul use t'e port name $.R/:nn. As t'e f&rst test oes not &n(ol(e tr&44er&n4*
you only 'a(e to ma&nta&n t'e 4utbound file ta# pa4e. 0nsure t'at t'e f&le names !an
#e 4enerate ynam&!ally. Sele!t t'e lo4&!al &re!tory &DI456+BA64PAT7 an a
su&ta#le fun!t&on moule. 2ea(e t'e 4utbound file f&el empty.
9rom t'e 4utbound file ta# pa4e* !'e!" t'e sett&n4s us&n4 t'e !orrespon&n4
pus'#utton >!'e!" &!on?. Sa(e your entr&es.
8SID9 &s t'e 3:!'ara!ter system ,- >for e6ample ,40?
nn &s t'e num#er of your 4roup >0< to <E?
>C? SA$ A% BC620 20
6
SAP AG 1999
Partner Profile
Stan"ar" partner profile
Chec2ing Partner Profile
:at entry
>C? SA$ A% BC620 <
6.2
SAP AG 1999
Partner Profile1 9nit 7%6ecti!e
<(plain the p$rpoe of partner profile an"
proce co"e
8aintain partner profile
>C? SA$ A% BC620 2
6.3
SAP AG 1999
R/3 Sste$ R/3 Sste$
Pot "oc$&ent
Generate IDoc
Tranfer "ata4
proce f$rther
Archi*e IDoc 7
Archi*e IDoc 7
.DI Su/sste$7
.DI Su/sste$7
Docu$entation
Tools
Docu$entation
Tools
Partner Profile
Partner Profile
Port De"inition
Port De"inition
/'e !ompany SmartMart w&s'es to sen pur!'ase orers to 3u&!"-el&(er (&a 0-,. 3u&!"-el&(er
w&s'es to &mme&ately post t'ese pur!'ase orers ele!tron&!ally. Bot' !ompan&es 'a(e R53 Systems*
use 0-, su#systems an must !onf&4ure t'e&r ,-o! ,nterfa!e a!!or&n4ly.
SmartMart must !onf&4ure t'e ,-o! ,nterfa!e for sen&n4 ata >out#oun pro!ess&n4 or s&mply
o!t"o!nd?:
SmartMart ef&nes 3u&!"-el&(er as a partner for messa4e type .R-0RS &n t'e #artner #rof$les an
enters t'e port w'&!' 'as alreay #een ef&ne.
>C? SA$ A% BC620 3
6.4
SAP AG 1999
Partner Profile1 B$ine Scenario
S&art8art &$t "efine =$ic2Deli!er a a partner.
Ao$ ha!e alrea"y config$re" a $ita%le port in the
port "efinition.
In o$t%o$n" proceing4 =$ic2Deli!er i the partner
for the p$rchae or"er. In o$t%o$n" proceing4 it
i the partner for the or"er ac2no'le"g&ent.
>C? SA$ A% BC620 4
6.5
SAP AG 1999
Partner Profile1 :iel"
Partner
A++lication
Process co!e
,ogical $essage
Partner
Per$itte! agents
"eneral
#ut$oun% Processin&
Partner
<essage
Process co!e
Per$itte! agents
In$oun% Processin&
'( )arameters
Partner
<essage
Port
IDoc t+e
.DI structure
Per$itte! agents
/'e ,-o! partner prof&le &s &(&e &nto four areas:
%eneral partner prof&le: Conta&ns partner ata from t'e master ata as a "ey >2 f&els: Num#er an type?.
A&t&onal 4eneral parameters: 9or e6ample* @party to #e not&f&e@ w'en an error o!!urs &f no spe!&al sett&n4s
'a(e #een entere >&n out#oun or &n#oun?.
.ut#oun partner prof&le >4eneral?: 3 "eys are use : partner >3 f&els: num#er* type* fun!t&on?* lo4&!al messa4e
>3 f&els: >type* !oe* fun!t&on? an t'e test fla4. /'e partner refers to t'e 4eneral partner prof&le. A&t&onal
parameters: 9or e6ample* t'e out#oun port an ,-o! type. /'&s means t'at t'e (alues for partner* messa4e
an test fla4 ef&ne t'e port an ,-o! type &n a un&Due way.
/'e out#oun pro!ess&n4 (alues must al2ays #e ma&nta&ne* re4arless of t'e type of out#oun pro!ess&n4
use >&re!t or us&n4 Messa4e Control?.
A&t&onal parameters for out#oun pro!ess&n4 uner Messa4e Control >MC?: /'&s type of out#oun
pro!ess&n4 >appl&e &n MM an S-? uses t'e MC "ey >from t'e !on&t&on re!or?: Appl&!at&on "ey an output
type. /'e partner "ey part !ons&sts of t'e partner type an fun!t&on an &s ta"en from t'e 4eneral partner
prof&le. Bou must ensure t'at you enter t'e !orre!t partner fun!t&on* t'at &s* t'e one t'e appl&!at&on uses to !all
Messa4e Control.
Ca!t$on /'e output type 'as not'&n4 to o w&t' t'e lo4&!al messa4e &n t'e ,-o! &nterfa!e.
,n#oun partner prof&le: /'e same C "ey f&els w'&!' are &n!lue &n t'e out#oun partner prof&le are use &n
t'&s !ase. /'e partner refers to t'e 4eneral partner prof&le. A&t&onal parameters: 9or e6ample* t'e pro!ess
!oe w'&!' ef&nes t'e type of &n#oun pro!ess&n4 >#us&ness pro!ess?. Summary: $artner* messa4e an test
fla4 ef&ne t'e #us&ness pro!ess &n a un&Due way.
>C? SA$ A% BC620 5
6.6
SAP AG 1999
Chec2ing Partner Profile
$artner prof&les !an #e !'e!"e for !ons&sten!y. /'&s fun!t&on &s rea!'e (&a a pus'#utton from t'e
partner prof&le &n&t&al s!reen.
Bou s'oul ensure t'at #ot' parts of t'e out#oun partner prof&le are ma&nta&ne: /'e @out#oun
parameter@ >4eneral? part an t'e @Messa4e Control@ part: ,f t'e Messa4e Control part &s m&ss&n4* a
warn&n4 &s always &splaye* e(en &f t'&s part &s not reDu&re #e!ause t'e system !annot re!o4n&Ae
w'et'er or not t'&s part &s neee. ,f you o not reDu&re t'e Messa4e Control part* you s'oul s&mply
&4nore t'&s warn&n4 messa4e.
>C? SA$ A% BC620 6
6.7
SAP AG 1999
Partner Profile1 7$t%o$n" Proceing I
IDoc IDoc
8C 8C
recor" recor"
Doc$&ent Doc$&ent
Doc$&ent Doc$&ent
SAP Application
<'
0ecei!ing Syte&
8C etting
8C etting
GeneralCo$t%o$n"
GeneralCo$t%o$n"
/'e !ompany SmartMart w&s'es to sen pur!'ase orers from moule MM to 3u&!"-el&(er. ,-o!
out#oun pro!ess&n4 must t'erefore #e !onf&4ure. ,n t'e MM moule* out#oun pro!ess&n4 always
ta"es pla!e us&n4 Messa4e Control >MC?. As a result* SmartMart must ma&nta&n t'e follow&n4 parts
of t'e partner prof&le for 3u&!"-el&(er:
%eneral partner prof&le: =ere* t'e name 3u&!"-el&(er &s entere as t'e #artner n!m"er us&n4 t'e
form &n w'&!' &t appears &n t'e master ata. /'e #artner ty#e &s 2,: /'&s &ent&f&es 3u&!"-el&(er as
a (enor &n t'e R53 System.
.ut#oun pro!ess&n4 >4eneral?: $artner num#er an partner type are entere from t'e 4eneral
sett&n4s. A&t&onal parameter: Partner f!nct$on 29 >(enor?: /'&s fun!t&on must #e entere as &t
refers to t'e !orrespon&n4 "ey &n t'e MC re!or. /'e message ty#e &s .R-0RS.
A&t&onal parameters for out#oun pro!ess&n4 uner MC: /'e partner fun!t&on an messa4e type
are entere from t'e 4eneral out#oun sett&n4s. MC:spe!&f&! "eys are t'e a##l$cat$on 09
>pur!'as&n4? an t'e o!t#!t ty#e N0+ >&n !ontrast to !'an4e messa4es?.
/'e messa4e type &s to #e use prou!t&(ely. As a result* t'e test fla4 &s not set.
:ote .nly t'e "ey f&els are !ons&ere 'ereF
>C? SA$ A% BC620 C
6.8
SAP AG 1999
Partner Profile1 7$t%o$n" Proceing II
Process co!e= <.10
<essage= >RD.RS
Partner= ?D@ >ut+ut t+e= >RD.RS
Port= S3BSAST.< Per$itte! agent=
IDoc t+e= >RD.RS01 .DI agent "or +artner
?uic-Deli*er 0?D1 0+urchase or!ers1
General
7$t%o$n"
8C
etting
Partner= ?D @ A++l= .:@ >t+tT+e = B.C >/Dect t+e8
language8;;;
Partner= ?D @ A++l= .:@ >t+tT+e = B.C
8C recor"
As always* t'e "ey f&els eterm&ne t'e !ontents of t'e ot'er f&els. As a result* w'en SmartMart
sens an orer to 3u&!"-el&(er* t'e partner prof&les 'a(e t'e follow&n4 effe!t:
Messa4e Control >MC? !reates a ata re!or !onta&n&n4 t'e appl&!at&on 09* output type N0+ an t'e
partner 3u&!"-el&(er. ,n t'e MC sett&n4s for t'e partner prof&le* t'ese "ey f&els ef&ne t'e pro!ess
!oe M0<0 an t'e messa4e .R-0RS.
/'e pro!ess !oe spe!&f&es t'e fun!t&on moule w'&!' &nserts t'e orer ata &n t'e ,-o! type. /'e
messa4e .R-0RS an partner 3u&!"-el&(er are ass&4ne to t'e !orrespon&n4 f&els &n t'e 4eneral
partner prof&les* w'&!' are t'e "ey f&els &n t'&s !ase. /'ey eterm&ne t'at t'e ,-o! type .R-0RS0<
&s to #e use >t'at &s* w&ll !onta&n t'e appl&!at&on ata?R as well as t'e out#oun port.
Summary: ,n !on!lus&on* t'e MC re!or eterm&nes t'e ,-o! type* port an fun!t&on moule* 'en!e
t'e ent&re out#oun pro!ess&n4. /'ere are ot'er epenent f&els su!' as @perm&tte a4ents@ for
not&f&!at&ons.
/'e appen&6 !onta&ns a set of !ommon !om#&nat&ons of MC an partner prof&le f&els.
>C? SA$ A% BC620 E
6.9
SAP AG 1999
Partner Profile1 In%o$n" Proceing
Process co!e=
>RDR@
Per$itte! agents= .DI
agent "or +artner
?uic-Deli*er8 or!er
ac-no%le!g$ents
IDoc
Control 0ecor"
In%. Proceing
Partner= ?D@ <essage= >RDRSP
IDoc t+e=
>RD.RS01
Partner= ?D@ <essage= >RDRSP
SmartMart wants to #e a#le to re!e&(e an pro!ess 0-, orer a!"nowle4ments from 3u&!"-el&(er
for t'e&r pur!'ase orers. ,-o! &n#oun pro!ess&n4 must t'erefore #e !onf&4ure. As a result*
SmartMart must st&ll ma&nta&n t'e &n#oun part of t'e partner prof&le for 3u&!"-el&(er. Partner
n!m"er an #artner ty#e are entere from t'e 4eneral sett&n4s. /'e message ty#e &s .R-RS$
>orer !onf&rmat&on?. /'e messa4e &s to #e re!e&(e prou!t&(ely. As a result* t'e test flag &s not set.
As well as t'ese key f$elds( t'e pro!ess !oe .R-R &s an &mportant ata f&el.
,f 3u&!"-el&(er now sens an orer a!"nowle4ment to SmartMart* t'e partner prof&les 'a(e t'e
follow&n4 effe!t:
,n t'e !ontrol re!or* t'e &n#oun ,-o! !onta&ns t'e partner 3u&!"-el&(er an t'e messa4e
.R-RS$* w'&!' are ass&4ne to t'e !orrespon&n4 f&els &n &n#oun pro!ess&n4. /o4et'er w&t' t'e
test fla4 >also part of t'e !ontrol re!or?* t'ese "ey f&els un&Duely eterm&ne t'e pro!ess !oe.
/'e pro!ess !oe spe!&f&es t'e fun!t&on moule w'&!' reas t'e ata from t'e &n#oun ,-o!.
Summary: /'e ,-o! type eterm&nes t'e &n#oun pro!ess&n4 for t'e ,-o!. /'ere are ot'er epenent
f&els su!' as re!&p&ents of not&f&!at&ons.
>C? SA$ A% BC620 8
6.10
SAP AG 1999
Proce Co"e I
Partner
A++lication
<ess;t+e
Process co!e
<(a&ple1 8C para&eter in partner profile
Process co!e
:unction $o!ule 0%rites the a++lication
!ata in an out/oun! IDoc1
A pro!ess !oe &s only anot'er name for a pro!ess !arr&e out #y a fun!t&on moule or a wor"flow.
,-o!s are pro!esse &n t'ese !ases* t'at &s ata &s wr&tten to t'e ,-o!s or rea from t'e ,-o!s.
/'e partner prof&les only !onta&n t'e pro!ess !oes* ne(er t'e real name of t'e fun!t&on moule. Bou
!an t'erefore repla!e an ol pro!ess w&t' a new one for all rele(ant partners &n one s&n4le step:
Ass&4n&n4 t'e new pro!ess to t'e e6&st&n4 pro!ess !oe.
$artner prof&les !onta&n pro!ess !oes for &n#oun an out#oun pro!ess&n4. ,n a&t&on* pro!ess
!oes for error 'anl&n4 are !onf&4ure &n t'e ,-o! ,nterfa!e* w'&!' o not sa(e any wor" &n t'e
a#o(e sense. /'ey were &ntrou!e for !ompleteness* so t'at all pro!esses !onne!te to t'e ,-o!
,nterfa!e !an #e pro!esse (&a a pro!ess !oe.
.nly one pro!ess !oe e6&sts for out#oun pro!ess&n4 w'en Messa4e Control >MC? &s use >#e!ause
t'e &re!t way s&mply sens an ,-o! to t'e ,-o! ,nterfa!e?. /'&s pro!ess !oe always &ent&f&es a
fun!t&on moule.
:ote $ro!ess !oes are !l&ent:spe!&f&!F
>C? SA$ A% BC620 <0
6.11
SAP AG 1999
Process co!e
Proce Co"e II
Partner
<essage
Process co!e
<(a&ple1 In%o$n"
:unction $o!ule/%or-"lo% 0rea!s !ata "ro$ an
in/oun! IDoc an! +rocesses !ata "urther1
/'e &n#oun partner prof&les always !onta&n a pro!ess !oe w'&!' spe!&f&es e&t'er a wor"flow or a
fun!t&on moule >&re!t pro!ess&n4?.
/'ere are two types of pro!ess !oes for error 'anl&n4:
System: 0rror 'anl&n4 for ,-o! pro!ess&n4 >#ot' &n#oun an out#oun?
$ro!ess !oe status: 0rror 'anl&n4 for status !onf&rmat&on
All pro!ess !oes are ass&4ne to pro!esses (&a t'e Control menu &n t'e ,-o! ,nterfa!e.
See t'e onl&ne o!umentat&on for more &nformat&on a#out pro!ess !oes.
>C? SA$ A% BC620 <<
6.12
SAP AG 1999
Proce Co"e III
Doc$&entation !ia &eage
Process co!e
<essage
n
&
,n orer to f&n t'e !orre!t pro!ess !oe for your #us&ness pro!ess* sear!' for &t (&a t'e @lo4&!al@
messa4e >for e6ample .R-0RS for a pur!'ase orer?.
/'en !'oose Documentation (rocess code from t'e &n&t&al noe of t'e ,-o! ,nterfa!e.
/'ere &s an n:m relat&ons'&p #etween pro!ess !oes an messa4e types. 9or new ef&n&t&ons of
#us&ness pro!esses or ,-o! types you eterm&ne new pro!ess !oes or messa4es &n t'e ass&4nment
ta#le >see BC62<?.
>C? SA$ A% BC620 <2
6.13
SAP AG 1999
7$t%o$n" 8o"e1 Port Type :ile
Descri)tion
Trans"er single IDoc E
start e6ternal sste$ 0trigger1
Trans"er single IDoc@
no trigger
Trans"er $ulti+le IDocs E start
e6ternal sste$ 0trigger1
Trans"er $ulti+le IDocs@
no trigger
Partner
)ro!ile
/'e transfer t&me &s only ef&ne &f t'e e6ternal system &s tr&44ere* w'&!' 'elps ma&nta&n ata
!ons&sten!y.
Non:tr&44ere ata transfer &n!lues t'e an4er t'at ,-o! or status f&les may #e pro!esse se(eral
t&mes or not pro!esse at all.
.t'er port types always &n!lue e6ternal system tr&44er&n4 >#e!ause t'e ,-o!s are not sa(e
temporar&ly &n f&les #ut transferre &re!tly?. .nly out#oun moes w'&!' &n!lue tr&44er&n4 are
&splaye 'ere.
/'e ,-o! ,nterfa!e pro4rams use seDuent&al num#ers for out#oun moes: f&el .;/M.- 'as
(alues from < to 4 >rea from top to #ottom &n t'e &a4ram?.
>C? SA$ A% BC620 <3
6.14
SAP AG 1999
Partner Profile 7$tp$t
Diplay
$artner prof&les !an #e &splaye &n t'e R53 System >t'e same &n&t&al a!!ess as !reate?. A l&n" from
t'e Utilities menu leas to t'e tree output w'&!' pro(&es a !lear means of &splay* e(en for se(eral
partners.
/'e tree !an #e pr&nte from t'e menu )ystem->!ist. Also !'e!" t'e @appl&!at&on 'elp@ &n t'e
transa!t&on.
$artner prof&les !an also #e sent (&a t'e spe!&al ,-o! type SB$AR/0<. A partner prof&le for t'&s
,-o! type w&t' t'e @lo4&!al@ messa4e SB$AR/ &s t'erefore a prereDu&s&te.
>C? SA$ A% BC620 <4
6.15
SAP AG 1999
Partner Profile1 S$&&ary
Partner profile pecify 'hich &eage are ent to 'hich
$er4 $ing 'hich &etho" an" ho' they are procee".
Partner &$t %e entere" in the partner profile %efore IDoc can
%e ent $ccef$lly.
The port (the J'ayJ) i part of the o$t%o$n" partner profile.
Technical co&&$nication para&eter are entere" in the port
"efinition. In%o$n" port "o not re5$ire $ch para&eter - their
technical para&eter are "efine" %y the e(ternal en"ing
yte&.
Proce co"e are alo part of the partner profile.
They are $e" for proceing "ata.
Proce co"e 'hich are "efine" o$ti"e the partner profile are
$e" in error han"ling.
>C? SA$ A% BC620 <5
6.16Partner Pro!iles Exercise
*n$t Partner Prof$les
As a mem#er of t'e 0-, proOe!t team for your !ompany* enter t'e
!ompany T-BI6nn as t'e 0-, (enor w&t' w'om pur!'ase orers an
orer a!"nowle4ments are to #e e6!'an4e.
<:< Ma&nta&n t'e partner prof&les for your 0-, (enor as follows:
$ur!'ase orers !an #e sent to t'e 0-, (enor
.rer a!"nowle4ments from t'e (enor !an #e re!e&(e
/'e !orrespon&n4 master ata &n t'e MM appl&!at&on 'as alreay #een !reate for you.
<:2 9rom t'e &n&t&al noe of t'e ,-o! ,nterfa!e* !'oose Ioc Partner Profile. 9&rstly*
enter t'e 'eaer ata for t'e (enor. $os&t&on t'e mouse on t'e partner type 2, an
!'oose 3reate. /'ere* enter a perm&tte a4ent.
<:3 Conf&4ure t'e out#oun pro!ess&n4. C'oose 3reate outbound parameter. 0nter t'e
(enor >!oe 6;?. /'e messa4e &s +,D&,S. 9&rstly* ma&nta&n t'e 4utbound options:
/'e re!&p&ent port 'as alreay #een ma&nta&ne as P+,T-nn an represents t'e
!onne!t&on to t'e 0-, su#system. ,n output moe !'oose Send Ioc immediately an
o not start subsystem. 9&nally &n t'&s (&ew* enter t'e ata stru!ture for t'e e6!'an4e as
an ,-o! type. As you are 4o&n4 to use t'e stanar system* sele!t t'e ,-o! type
+,D&,S0-.
As out#oun pro!ess&n4 for !onf&rmat&ons &s eterm&ne (&a Messa4e Control* you
must also ma&nta&n t'e 0essa'e 3ontrol ta# pa4e. /'e appl&!at&on &s l&n"e to Messa4e
Control. ,n MC* t'e pro!ess &s &ent&f&e #y t'e partner fun!t&on >!oe 6;? an t'e
appl&!at&on >appl&!at&on &; an messa4e type :&*?. Bou eterm&ne 'ow t'e o!ument
ata &s 4enerate as an ,-o! (&a t'e pro!ess !oe. Bou s'oul remem#er t'at &n !erta&n
!&r!umstan!es* t'ere !an #e se(eral pro!ess !oes for one messa4e. Sele!t t'e most
re!ent (ers&on of !onf&rmat&on out#oun pro!ess&n4 (&a pro!ess !oe <&-0.
<:4 Now !onf&4ure &n#oun pro!ess&n4 for t'e orer a!"nowle4ment &n 3reate inbound
parameters. /'e pro!ess epens on t'e (enor an t'e messa4e. ;s&n4 t'e
&nformat&on sent to your system #y t'e 0-, su#system &n t'e !ontrol re!or* t'e !orre!t
partner prof&le !an #e eterm&ne. Bou s'oul t'erefore sele!t t'e messa4e +,D,SP
to &ent&fy t'e pro!ess. /'e a!tual pro!ess&n4 of t'e ,-o! &s sele!te (&a t'e pro!ess
!oe. Sele!t t'e pro!ess !oe +,D,.
<:5 C'e!" t'e sett&n4s you 'a(e entere #y sele!t&n4 Partner 3heck.
nn &s t'e num#er of your 4roup >0< to <E?.
>C? SA$ A% BC620 <6
>C? SA$ A% BC620 <C
L
SAP AG 1999
The Tet Tool
Tet Tool 7ption
>C? SA$ A% BC620 <
7.2
SAP AG 1999
Tet Tool 7ption
Bou al2ays !reate a new test:,-o! w&t' t'e test tool. =owe(er* you !an use one of t'e ,-o!s
a(a&la#le &n t'e ata#ase as a tem#late an ed$t t'e !opy.
Bou !an a or elete se4ments an t'erefore !reate your own ,-o! type &n an a 'o! manner.
Bou !an !'an4e t'e !ontent of e(ery s&n4le se4ment f&el
Bou !an !'an4e all t'e !ontrol re!or f&els
/'ere are ot'er poss&#&l&t&es &f you o not want to use an ,-o! as t'e moel for e&t&n4:
Bou !an enter ata &n t'e empty ,-o! type >&n!lu&n4 t'e !ontrol re!or?
Bou !an &mport an ,-o! from a f&le.
Bou !an e(en !reate an ,-o! from not'&n4 #y s&mply a&n4 se4ments step #y step.
/'e test tool sa(es t'e e&te ,-o! as a new ,-o! &n t'e ata#ase #efore t'e a!tual pro!ess&n4 test
#e4&ns.
>C? SA$ A% BC620 2
7.3
SAP AG 1999
Tet Tool 7ption (2)
:$nction 8o"$le
D
i
r
e
c
t

c
a
l
l
(
i
n
%
o
$
n
"

o
n
l
y
)
G
e
n
e
r
a
t
e

f
i
l
e
Stan"ar" proceing 8a tet
/'e follow&n4 opt&ons are a(a&la#le &n t'e test tool for #ot' $n"o!nd and o!t"o!nd #rocess$ng:
Stanar pro!ess&n4: Bour test ,-o! &s sent for normal &n#oun or out#oun pro!ess&n4.
Mass test&n4: Se(eral !op&es of t'e e&te ,-o! are sent for pro!ess&n4. ,f t'e rele(ant fla4 &s not
set* only one !opy &s sent.
,n a&t&on* t'e follow&n4 opt&ons are a(a&la#le for $n"o!nd #rocess$ng:
%enerate f&le: ,n t'e !ase of a port w&t' type @9&le@* an ,-o! f&le &s !reate ur&n4 &n#oun
pro!ess&n4. /'e test tool ta"es o(er t'e role of t'e e6ternal system. ,n#oun pro!ess&n4 oes not
'a(e to #e tr&44ere #y t'e 4enerat&on of t'e ,-o! f&le* w'&!' means t'at t'e ,-o! f&le &s not
elete #y t'e system an &s t'erefore a(a&la#le for furt'er tests.
-&re!t !all of &n#oun fun!t&on moule. /'&s allows t'e fun!t&on moule to #e e#u44e. ,f t'&s
fla4 &s not set* t'e ,-o! &s sent for stanar pro!ess&n4* as &n t'e out#oun test.
2&"e t'e ot'er test pro4rams* t'e test tool 'as a spe!&al test status w&t' w'&!' you !an &ent&fy test
,-o!s &n t'e mon&tor&n4 pro4rams.
>C? SA$ A% BC620 3
7.4 est ool Exercise
*n$t Process$ng Tests
To#$c Test Tool (order ackno2ledgment)
;se t'e test tool
;se ,-o! &splay to tra!e ,-o!s
As a mem#er of your 0-, proOe!t team &n pur!'as&n4* you want to test t'e
follow&n4 as soon as poss&#le:
Sen&n4 pur!'ase orers
Re!e&(&n4 orer a!"nowle4ments
<:< Create a pur!'ase orer for met'anol >mater&al num#er S7--00) from t'e (enor T-
BI6nn #y sele!t&n4 1o'istics 0aterials 0ana'ement Purchasin' Purchase
4rder 3reate 5endor 6nown >transa!t&on M02<?.
<:2 As a mem#er of t'e pur!'as&n4 epartment* you #elon4 to #!rchas$ng organ$3at$on
-000 an #!rchas$ng gro!# 00-. /'e met'anol &s reDu&re for #lant --00 >Berl&n?.
Com#any code &s -000 >,-0S A% <000?.
<:3 After t'e ata 'as #een entere su!!essfully* sele!t =eaer :K Messa4es from t'e menu
&n t'e &tem o(er(&ew to !'e!" t'e proposal for t'e output of t'e pur!'ase orer (&a
Messa4e Control. ,f d$s#atch t$me = 'as #een sele!te* an ,-o! for t'&s pur!'ase orer
&s 4enerate as soon as t'e ata &s sa(e.
<:4 C'an4e to Purchase 4rder isplay. By sele!t&n4 S*stem 1inks t'e ,-o! t'at 'as
Oust #een 4enerate &s &splaye.
2:< Bou !an now use t'e pur!'ase orer ,-o! t'at 'as Oust #een 4enerate as a template for
t'e &n#oun orer a!"nowle4ment to #e teste.
2:2 9rom t'e &n&t&al noe of t'e ,-o! ,nterfa!e* !'oose #est #est #ool. C'oose )xistin'
Ioc an !all t'e (alue 'elp* &n w'&!' you sear!' w&t' t'e re!&p&ent partner num#er.
C'oose 3reate.
2:3 Sele!t t'e !ontrol re!or >t'e f&rst re!or? #y !l&!"&n4 w&t' t'e mouse an !'an4e t'e
follow&n4 f&els:
Re!&p&ent* $ort: SA$JS,-K
Sener* $ort: $.R/:nn
Sener* $artner num#er: /:B,2nn
>C? SA$ A% BC620 4
Sener* $artner type: 2,
Sener* $artner fun!t&on: 29
Messa4e type: .R-RS$
C'oose 3ontinue.
2:4 As t'e orer a!"nowle4ment s'oul !onta&n at least t'e orer num#er of t'e (enor*
!reate a !orrespon&n4 se4ment. Copy se4ment 0<0-N02 an !'an4e t'e follow&n4
f&els:
3ual&f&er: 002
-o!ument
:
9or e6ample BC620:
/est:4C<<
C'oose 3ontinue to !lose t'e &alo4 #o6.
2:5 /'e a!"nowle4ment of your (enor now 'as to #e ass&4ne to t'e &tem. Create a
!orrespon&n4 se4ment 0<0-$02 &re!tly after t'e &tem se4ment 0<0-$0< as a
su#se4ment. Ma&nta&n t'e follow&n4 f&els:
3ual&f&er: 00<
-o!ument: .rer num#er* &n se4ment 0<0-N02* Dual&f&er 00<* f&el
document
-o!ument
&tem:
-o!ument &tem* &n se4ment 0<0-$0<* f&el document item
C'oose 3ontinue.
2:6 C'oose Standard Inbound an t'en 3ontinue.
2:C /'e system !'an4es your or&4&nal orer. Bou !an &splay t'e !'an4e orer #y
sele!t&n4 1o'istics 0aterials 0ana'ement Purchasin' Purchase 4rder
isplay. ,f you ou#le:!l&!" on t'e &tem* you w&ll see t'e a!"nowle4ment num#er t'at
'as Oust #een transferre. By sele!t&n4 System 1inks from t'e &tem o(er(&ew* you
!an &splay t'e ,-o! w'&!' &s l&n"e to t'e out#oun pur!'ase orer* as well as t'e
,-o! w'&!' &s l&n"e to t'e &n#oun a!"nowle4ment.
8SID9 &s t'e 3:!'ara!ter system ,- >for e6ample* ,-3?
nn &s t'e num#er of your e6er!&se 4roup >from < to <E?
>C? SA$ A% BC620 5
M
SAP AG 1999
8eage Control an" IDoc
8eage "eter&ination an" &eage proceing
Con"ition co&ponent
Dipatch ti&e
>C? SA$ A% BC620 <
8.2
SAP AG 1999
8eage Control an" IDoc1 9nit 7%6ecti!e
<(plain con"ition co&ponent
:in" e(a&ple of con"ition co&ponent in 88
C$to&iHing
Diplay an" proce the propoe" &eage fro& the
88 application tranaction
>C? SA$ A% BC620 2
8.3
SAP AG 1999
B$ine Scenario
S&art8art4 yo$ are reponi%le for config$ring the
IDoc Interface.
A p$rchae or"er fro& S&art8art i firtly create" a a
&eage %y the 8eage Control &o"$le4 %efore %eing
con!erte" into IDoc for&at. Ao$ 2no' that the %aic
etting for thi &o"$le e(it in the tan"ar" SAP
yte&4 %$t 'ih to fin" o$t &ore a%o$t other 8eage
Control f$nction.
>C? SA$ A% BC620 3
8.4
SAP AG 1999
7$t%o$n" Proceing $ing 8eage
Control
8C 8C
recor" recor"
Doc$&ent Doc$&ent
SAP Application
8C
IDoc Interface3A+< Ser!ice
:in" propoal
<"it
Proce
Messa4e Control >MC? 4enerates messa4es from appl&!at&on o!uments. /'e poss&#le messa4es are
ef&ne as !on&t&on re!ors &n Custom&A&n4.
9rom t'e poss&#le messa4es* MC sear!'es for t'ose w'&!' mat!' t'e !urrent appl&!at&on ata. /'&s
messa4e eterm&nat&on !an result &n se(eral messa4es #e&n4 fo!nd( or poss&#ly none. ,n t'e
follow&n4 e6ample* we w&ll presume t'at one messa4e was foun.
,f supporte #y t'e appl&!at&on* t'&s messa4e &s propose for e&t&n4 &n t'e transa!t&on w'&!' starte
MC. +'en !reat&n4 a pur!'ase orer* t'&s means t'at t'e messa4e proposal !an #e e&te >&splaye
an !'an4e? #efore t'e pur!'ase orer &s poste.
,n any !ase* t'e messa4e &s 4enerate an #rocessed >&f not elete ur&n4 t'e e&t&n4 pro!ess?: for
e6ample* &f t'e orer &s to #e pr&nte* t'e pro!ess&n4 pro4ram sens t'e messa4e to t'e pr&nter. ,f t'e
messa4e &s to #e sent as an ,-o!* a spe!&al pro!ess&n4 pro4ram &s !alle from t'e ,-o! ,nterfa!e.
/'e new messa4e &s represente #y a new entry &n t'e MC ta#le. $art of t'&s re!or &s t'e #rocess$ng
stat!s* w'&!' !an 'a(e t'e follow&n4 (alues: 0 H not yet pro!esse* < H su!!essfully pro!esse* 2 H
pro!esse w&t' error.
:ote 9or reasons of !lar&ty* t'&s sl&e oes not s'ow t'e transfer of t'e ,-o! to an e6ternal system*
alt'ou4' t'&s &s also part of out#oun pro!ess&n4.
>C? SA$ A% BC620 4
8.5
SAP AG 1999
8eage Control
SAP Application
8eage Deter&ination
<"iting
Proceing (ta%le T#AP0)
Application "ata
8eage propoal
8C recor"
Proceing progra&4
for e(a&ple 0S#AST<D
7$tp$t4 for
e(a&ple IDoc
/'e pro!ess &a4ram s'ows messa4e eterm&nat&on* messa4e e&t&n4 an messa4e pro!ess&n4.
Messa4e Control allows a d$s#atch t$me fla4 to #e set* w'&!' eterm&nes w'et'er t'e messa4e &s
pro!esse &mme&ately after t'e appl&!at&on o!ument &s !reate or at a later t&me. ,n t'e se!on !ase*
you must s!'eule report RSNAS/00 as a Oo#* ot'erw&se t'e messa4e rema&ns as an MC re!or w&t'
pro!ess&n4 status 0.
/'e MC re!or refers to t'e o!ument as a B.R o#Oe!t >B.R H Bus&ness .#Oe!t Repos&tory? w'&!'
!onta&ns all t'e &mportant ata for t'e messa4e.
/a#le /NA$R !onta&ns t'e pro!ess&n4 pro4rams >RSNAS/0- &n t'e !ase of 0-,?. 9orm rout&ne
0-,I$R.C0SS,N% &s a!!esse w&t'&n t'&s pro4ram.
>C? SA$ A% BC620 5
8.6
SAP AG 1999
Con"ition <le&ent
Proce"$re
SAP Application
7$tp$t Type
Acce Se5$ence
Con"ition Ta%le
/1n
&1n
n1/
&1n
Messa4e eterm&nat&on uses t'e !on&t&on te!'n&Due* w'&!' &s also use &n S- pr&!e eterm&nat&on.
Messa4es ef&ne &n Custom&A&n4 are sear!'e &n a spe!&f&e seDuen!e. /'e cond$t$on elements an
t'e&r '&erar!'y ef&ne t'&s seDuen!e.
/'e messa4es are re!ors &n a cond$t$on ta"le. Se(eral !on&t&on ta#les !an #elon4 to one o!t#!t
ty#e. /'e !on&t&on ta#les !an #e a!!esse a!!or&n4 to a !erta&n access se>!ence w&t' &fferent "ey
f&els.
Se(eral o!t#!t ty#es !an #elon4 to one pro!eure an se(eral #roced!res !an #elon4 to one
appl&!at&on* for e6ample t'e a##l$cat$on 09 >pur!'as&n4?.
/'erefore* &f one appl&!at&on w&s'es to sen 0-, messa4es (&a Messa4e Control* only t'e pro!eure
for t'at appl&!at&on an t'e !urrent appl&!at&on o#Oe!t >for e6ample t'e o!ument? &s sear!'e for
!orrespon&n4 messa4es.
/'e !on&t&on !omponent @A!!ess seDuen!eM !an #e use to ef&ne w'et'er only one messa4e &s to
#e foun: ,f t'&s &s t'e !ase* you s'oul set t'e @e6!lus&(eM fla4. ,f t'&s fla4 &s not set* t'e ent&re
a!!ess seDuen!e &s pro!esse* t'at &s* se(eral messa4es 'a(e poss&#ly #een foun.
>C? SA$ A% BC620 6
8.7
SAP AG 1999
8eage Proceing1 IDoc
0
S
#
A
S
T
<
D
'hec- 8C recor!
Rea! +artner +ro"ile
'all selection $o!ule
0"ro$ a++lication1
'all A+< Ser*ices
Trans"er accor!ing to
out+ut $o!e
F1F/ F2F F3F/ F4F
Single IDoc
<ulti+le IDocs
*ia 0S<79T00
/'e transm$ss$on med$!m &s part of t'e !on&t&on re!or >t'e messa4e ef&ne &n Custom&A&n4?. /'e
transm&ss&on me&a for ,-o! pro!ess&n4 w&t' Messa4e Control are:
@6@ 0-, >0le!tron&! -ata ,nter!'an4e?* t'at &s* w&t'out &str&#ut&on moel
@A@ A20 >Appl&!at&on 2&n" 0na#l&n4?* t'at &s* w&t' &str&#ut&on moel
/'e 0-, pro4ram for messa4e pro!ess&n4 &s starte w&t' t'ese parameters: RSNAS/0-* w&t' t'e
form rout&nes 0-,I$R.C0SS,N% or A20I$R.C0SS,N%.
,-o!s are transferre &n&(&ually from pro4ram RSNAS/0- w'en us&n4 output moes @<@ an @2@
>f&el .;/M.- &n t'e !ontrol re!or?.
,-o!s are not transferre &re!tly w'en us&n4 output moes @3@ an @4@ >f&el .;/M.- &n t'e
!ontrol re!or?. ,nstea* t'ey are !olle!te #y t'e pro4ram RS0.;/00 >#at!' moe? an sent as a
4roup.
>C? SA$ A% BC620 C
8.8
SAP AG 1999
Dipatch Ti&e in 7$t%. Procg $ing 8C
A++lication <' IDoc Inter"ace .6ternal Sste$
+eal time
,ast $atc-
Pot 79T87D N /
Pot 79T87D N /
Pot 79T87D N ,
Pot 79T87D N -
Batc-
Batc-
FSOTP N /
FSOTP N /
FSOTP N /
FSOTP N -
Bou s'oul note t'at t'ere are t2o &fferent &spat!' t&mes for out#oun pro!ess&n4 us&n4 Messa4e
Control: one !ontrolle #y MC* t'e ot'er #y t'e ,-o! ,nterfa!e. 0a!' of t'ese t&mes !an #e sw&t!'e
#etween @&mme&ately@ an @later@. ,f @later@ &s sele!te* t'e pro4ram must #e starte manually >for
test purposes? or as a #at!' Oo# >&n prou!t&on operat&on?* w'&le t'e pro4ram &s starte automat&!ally
&f @&mme&ately@ &s sele!te.
,f an 0-, su#system &s t'e e6ternal system an port type @f&leM &s use* t'ere &s a t'&r stop s&4n: /'e
su#system* w'en &t &s not tr&44ere.
Re!ommene !om#&nat&ons of stop s&4ns >see sl&e?:
Real t&me: ,-o!s are sent to t'e e6ternal system &n&(&ually w'en t'e appl&!at&on o!uments are
!reate.
9ast #at!': ,-o!s are sent to t'e e6ternal system &n&(&ually w'en t'e MC sele!t&on pro4ram &s
starte manually or as a #at!' Oo#. /'&s !an result &n lar4e amounts of ata reDu&r&n4 &n#oun
pro!ess&n4 &n t'e 0-, su#system &n a s'ort spa!e of t&me.
Bat!': A sta!" of ,-o!s &s sent to t'e e6ternal system w'en t'e ,-o! ,nterfa!e sele!t&on pro4ram
&s starte manually or as a #at!' Oo#. /o use t'e system resour!es eff&!&ently* you s'oul sele!t t'e
f&rst stop s&4n* t'e MC &spat!' t&me @later@ >< or 2?.
>C? SA$ A% BC620 E
8.9
SAP AG 1999
S$&&ary
8eage Control i i&portant in IDoc o$t%o$n"
proceing.
8eage "efine" in C$to&iHing are e(a&ine" in a
certain e5$ence to "eter&ine 'hether or not they
apply to the c$rrent application "ata. Thi e5$ence i
"efine" %y the con"ition co&ponent an" their
hierarchy.
IDoc-pecific &eage proceing ta2e place !ia
progra& 0S#AST<D.
9p to three "ifferent "ipatch ti&e can %e "efine" for
o$t%o$n" proceing.
>C? SA$ A% BC620 8
8.10 'essa&e (ontrol an% IDocs Exercise
*n$t <essage Control and IDocs
To#$c Cond$t$on &lements
Create an output type
Create a !on&t&on re!or
As a mem#er of t'e 0-, proOe!t team you must !onf&4ure t'e ele!tron&!
&spat!' of an orer a!"nowle4ment. 9or t'&s you !reate an &n&(&ual
output type an !on&t&on re!ors.
<:< Create t'e output type SBnn as a !opy of output type BA0< &n transa!t&on NAC0.
/'e output type s'oul pro(&e t'e transm&ss&on me&um 6 >0-,? as t'e efault
(alues for t'e !on&t&on re!ors.
<:2 Bou must transfer t'e pro!ess&n4 pro4ram an rout&ne for your transm&ss&on
me&um 0-, from output type BA0< . Bou must also ensure t'at t'e poss&#le
partner fun!t&on 7- >sol:to party? &s entere for your new output type.
<:3 -eterm&ne your new output type &n t'e pro!eure for t'e sales 4rder messa'es
>appl&!at&on 7<?. %o to t'e na(&4at&on 3ontrol for t'&s pro!eure.
<:4 Now !reate a !on&t&on re!or for output type SBnn for your partner /:B,Nnn of
sales or4an&Aat&on <020. Bou s'oul use 6 >0-,? as t'e transm&ss&on me&um.
>C? SA$ A% BC620 <0
8.11'essa&e (ontrol an% IDocs. Solution
*n$t <essage Control and IDocs
To#$c Cond$t$on elements
<:< ,n transa!t&on NAC0 sele!t )xpert mode an !'oose t'e appl&!at&on )- >sales?.
Sele!t 4utput types* 4o to !'an4e moe an sele!t BA0-.
C'oose )dit 3opy as!!!
0nter ?Bnn as t'e tar4et entry. ,n t'e efault "alues ta# pa4e !'an4e t'e
transm&ss&on me&um* &f ne!essary* to &DI.
+'en sa(&n4* you must !onf&rm t'at you also want to !opy all of t'e epenent
entr&es. Bou must st&ll ma&nta&n t'e lan4ua4e f&el for t'e epenent entry for t'e
ma&l t&tle >also &f you o not use t'e transm&ss&on me&um Lma&lM?. C'oose* for
e6ample* &: >0n4l&s'?.
:ote By !opy&n4 you 'a(e also transferre t'e a!!ess seDuen!e of t'e or&4&nal
BA0<* w'&!' !onta&ns a !on&t&on ta#le. Bou must f&ll t'&s !on&t&on ta#le &n t'e
last part of t'e e6er!&se.
<:2 ,n t'e output types s!reen* sele!t your new output type ?Bnn.
,n t'e na(&4at&on frame sele!t t'e entry Processin' routines #y ou#le:!l&!"&n4.
C'e!" t'e entry. /'e pro4ram ,S:AST&D an t'e form rout&ne
&DI4P,+C&SSI:5 must #e eterm&ne for t'e transm&ss&on me&um 6 >&DI?.
,n t'e na(&4at&on frame* now sele!t t'e entry Partner functions.
/o a t'e partner fun!t&on A5* sele!t 8ew )ntries an enter t'&s fun!t&on for t'e
transm&ss&on me&um 6 >&DI?.
Sa(e your !'an4es an return to t'e &n&t&al s!reen of transa!t&on NAC0.
<:3 ,n t'e &n&t&al s!reen of t'e transa!t&on NAC0* sele!t t'e appl&!at&on )- >sales?.
C'oose Procedures.
Sele!t t'e pro!eure )-0000 >orer messa4es?.
>C? SA$ A% BC620 <<
,n t'e na(&4at&on frame sele!t t'e entry 3ontrol #y ou#le:!l&!"&n4.
C'oose 8ew )ntries. 0nter t'e follow&n4:
1e"el >eterm&nes t'e orer? -nn (-00 @ yo!r gro!#
n!m"er)
3ounter >not rele(ant 'ere? -
3#yp >H output type? ?Bnn
-o not enter a !on&t&on* &n orer to ensure t'at &n eterm&nat&on your output type
&s sear!'e e(ery t&me for messa4es.
<:4 ,n t'e &n&t&al s!reen of t'e transa!t&on NAC0* sele!t t'e appl&!at&on )- an !'oose
3ondition records.
$os&t&on t'e mouse on ?Bnn an sele!t 3ondition records a4a&n.
0nter t'e sales or4an&Aat&on -020 &n t'e sele!t&on s!reen an sele!t continue.
Ma"e t'e follow&n4 entr&es &n t'e !on&t&on ta#le:
3ustomer T-BIAnn
2unction A5
#ransmission medium 6 >&DI?
#ime = >$mmed$ately?
1an'ua'e &: >&ngl$sh?
Bou !an lea(e t'e partner f&el empty as t'e partner &s eterm&ne from t'e
!ustomer master ata. ,n t'e present !ase* &t &s &ent&!al to t'e !ustomer. 9&nally t'e
messa4e &s sent to t'em* 'ere as an ,-o!.
:ote /'e !on&t&on ta#le &s usually ma&nta&ne &n t'e sales master ata as an orer
messa4e. /'e ma&ntenan!e &nterfa!e &s t'e same as &n t'e NAC0 &n&t&al a!!ess.
>C? SA$ A% BC620 <2
)
SAP AG 1999
General Setting
#$&%er range
<!ent-recei!er lin2age
IDoc a"&initration
:at entry
+ong na&e - hort na&e
>C? SA$ A% BC620 <
9.2
SAP AG 1999
General Setting1 9nit 7%6ecti!e
Config$re the general para&eter in the I8G
Decri%e 'hen the IDoc A"&initrator i notifie"
>C? SA$ A% BC620 2
9.3
SAP AG 1999
C$to&iHing $ing the I8G
03, C$to&iHing I8G
Cro-application
co&ponent
IDoc Interface
I8G "oc$&entation
Pro6ect "oc$&entation
Pro6ect &anage&ent
Acti!itie
%eneral parameters for t'e ,M% !an #e entere (&a t'e ,M%. /'e ,M% &s a set of &mplementat&on
4u&el&nes w'&!' !an #e use #y !ustomers to !onf&4ure t'e R53 System to meet t'e&r reDu&rements
>@Custom&A&n4@?. /'e !orrespon&n4 ta#les are ma&nta&ne (&a act$%$t$es'
By sele!t&n4 t'e appropr&ate attr&#utes* users !an &splay only t'e a!t&(&t&es w'&!' are reDu&re &n
ea!' !ase. 9or e6ample* &f a !ustomer w&s'es to aopt all SA$ stanar sett&n4s* only t'e a!t&(&t&es
w&t' t'e attr&#ute @reDu&re@ must #e e6e!ute.
/'e ,M% noe or pat' for t'e ,-o! ,nterfa!e &s Cross-a''lication Com'onents :KIDoc Interface.
Bou s'oul rea t'e I<5 doc!mentat$on* w'&!' &s a(a&la#le for ea!' a!t&(&ty >ou#le:!l&!" on t'e
rele(ant o!ument?.
Bou !an also !reate your own proOe!ts from t'e stanar ,M%: $roOe!ts are a type of (&ew of t'e
stanar ,M%* w'&!' are use #y &fferent teams. /'e ,M% offers #roBect management fun!t&ons
>resour!e plann&n4 an so on? as well as fun!t&ons for !reat&n4 your own #roBect doc!mentat$on (&a
!ustomer notes.
>C? SA$ A% BC620 3
9.4
SAP AG 1999
#$&%er 0ange
IDoc Interface
GHI
Num#er ran4es are &nter(als of natural num#ers w'&!' are ass&4ne to o#Oe!ts !entrally #y t'e R53
System. /'&s &s !alle @&nternal num#er ass&4nment@.
,n t'e ,-o! ,nterfa!e* num#er ran4es are set for:
: ,-o!s: t'e ,-o! ,-s are ta"en from t'e &nter(al
: $orts: t'e names of t'e tR9C ports are ef&ne #y t'e &nter(al
: Ma&l#a4s: /'ese are only use for !ommun&!at&on w&t' an R52 System. ,-o!s are transm&tte &n
ma&l#a4s
/'ese num#er ran4es are ma&nta&ne from t'e ,M% noe for t'e ,-o! ,nterfa!e.
>C? SA$ A% BC620 4
9.5
SAP AG 1999
<!ent-0ecei!er +in2age
IDoc Interface
03, Application
P
r
o
c
e
i
n
g
P
r
o
c
e
i
n
g
+'en ,-o!s are re!e&(e* t'ey are f&rst sa(e &n t'e ata#ase. ,n a se!on an &nepenent step* t'ey
are pro!esse furt'er >for port types @f&le@* @1M2@* @C$,:C@?. /'&s &s mae poss&#le #y t'e wor"flow
e(ent !on!ept: ,f ,-o!s are sa(e &n t'e ata#ase* an e(ent &s !reate * w'&!' wa&ts for t'e @re!e&(er@
&n t'e system. /'e @re!e&(er@ >a fun!t&on moule? f&ns t'e e(ent an tr&44ers &n#oun pro!ess&n4.
As a result of t'&s step* t'e fun!t&on moule 'as use t'e e(ent* w'&!' no lon4er e6&sts &n t'e system.
/'e +or"flow Mana4er eterm&nes w'en t'e re!e&(er starts to sear!' for e(ents: /'ere &s t'erefore
an &nter(al #etween t'e ata #e&n4 sa(e an furt'er pro!ess&n4 #e&n4 &n&t&ate >asyn!'ronous
pro!ess&n4?.
/o ena#le t'&s new form of &n#oun pro!ess&n4 to ta"e pla!e* t'e !orrespon&n4 e(ent must #e
a!t&(ely l&n"e to t'e re!e&(er.
Bou must t'erefore a!t&(ate t'e e(ent:re!e&(er l&n"a4e &n t'e ,M% for t'e ,-o! ,nterfa!e.
>C? SA$ A% BC620 5
9.6
SAP AG 1999
IDoc A"&initration1 Glo%al Para&eter
SAP AG
Party to %e notifie" (IDoc A"&initrator)
Syte& en!iron&ent (Bai yte&>)
Proceing "etail
/'e ,-o! am&n&strator &s always not&f&e w'en an error o!!urs ur&n4 ,-o! pro!ess&n4 an no
partner prof&le !oul #e foun. .t'erw&se* t'e partner:spe!&f&! a4ent >an t'e messa4e:spe!&f&! a4ent*
&f reDu&re? entere &n t'e partner prof&le &s not&f&e.
,n t'e system en(&ronment* t'e ,-o! &nterfa!e &s &nforme w'et'er non:Bas&s !omponents e6&st* for
e6ample Messa4e Control or appl&!at&on !omponents. ,f t'ese entr&es are not mae* &t &s poss&#le t'at
t'e ,-o! &nterfa!e may !all fun!t&on moules* for e6ample* t'at o not e6&st &n t'e spe!&f&e system
>Bas&s system only?.
$ro!ess&n4 eta&ls:
/'e ma6&mum num#er of synta6 errors w'&!' !an #e re!o4n&Ae &n one ,-o! an t'erefore lo44e
as status re!ors. /'e lar4er t'&s (alue* t'e '&4'er t'e pro#a#&l&ty t'at t'e error messa4es o not
refer to @real@ errors* #ut only su#seDuent errors.
+'et'er or not ,-o! &n#oun pro!ess&n4 &s tr&44ere syn!'ronously >not (&a t'e e(ent:re!e&(er
l&n"a4e? >port type 9&le?. ,n t'&s !ase* &mme&ately after t'e e(ent of t'e e(ent re!e&(er
System parameters !an #e entere as @4lo#al parameters@ from t'e &n&t&al s!reen of t'e ,-o!
&nterfa!e #y !'oos&n4 Control->IDoc Administration or !an also #e set from t'e ,M% noe of t'e
,-o! &nterfa!e.
After 'ow many ata re!ors a C.MM,/ +.RN &s &n&t&ate. Bou s'oul also see t'e 9< =elp
fun!t&on for t'e &nput f&els.
>C? SA$ A% BC620 6
9.7
SAP AG 1999
SAP AG
IDoc A"&initration1 9er Para&eter
Tet
Doc$&entation Tool
De!elop&ent
;ser:spe!&f&! parameters for t'e ,-o! &nterfa!e cannot #e entere from t'e ,M%. ,nstea* !'oose
Control -> IDoc administration from t'e &n&t&al noe of t'e ,-o! &nterfa!e.
/'e test #arameter &s t'e port propose as stanar #y t'e test pro4rams.
9or t'e doc!mentat$on tools( you s'oul ef&ne t'e efault o!umentat&on output* for e6ample*
w'et'er t'e &n&(&ual se4ment f&els are also to #e &n!lue &n t'e o!umentat&on of ,-o! types.
Bou !an enter a efault de%elo#ment !lass for t'e e(elopment of ,-o!s an se4ments. Course
BC62< !onta&ns more &nformat&on a#out e(elop&n4 an ef&n&n4 ,-o! types.
>C? SA$ A% BC620 C
9.8
SAP AG 1999
:at entry
Defa$lt !al$e
-ur&n4 fast entry of t'e partner prof&le (alues* efault (alues >@templates@? are alreay set &n t'e ,M%
* w'&!' fa!&l&tates t'e ma&ntenan!e of t'e partner prof&les &n t'e ,-o! &nterfa!e.
/'e efault (alues are set for partner type an &re!t&on >&n#oun5out#oun?.
,f you sele!t t'e fast entry opt&on for partner prof&les >(&a t'e pus'#utton on t'e &n&t&al s!reen* see
later un&t?* t'e (alues w'&!' you 'a(e entere &n t'e ,M% for t'e !urrent partner type an &re!t&on
are entere as t'e efault (alues. A!!or&n4 to your reDu&rements* you nee only sele!t an mo&fy
t'ese (alues.
Bou !an also rea!' t'e transa!t&on from t'e &n&t&al noe of t'e ,-o! &nterfa!e.
,n t'e ,-0S system* t'e follow&n4 messa4e types are ma&nta&ne for t'e (enor or !ustomer*
epen&n4 on t'e &re!t&on:
-02,NS : fore!ast5J,/ el&(ery s!'eule
.R-C=% : !'an4e pur!'ase orer5sales orer
.R-0RS : pur!'ase orer5sales orer
-0SA-7 : s'&pp&n4 not&f&!at&on
,N7.,C : &n(o&!e5#&ll&n4 o!ument
.R-RS$ : orer5sales !onf&rmat&on
>C? SA$ A% BC620 E
9.9
SAP AG 1999
+ong #a&e - Short #a&e
0eleae -.0 0eleae ,.I
Type
J+ong#a&eIAO0/J
Type JShort0/J
Release 4.0 &ntrou!e t'e !on!ept of t'e e6tene namespa!e. As a result* new ,-o! ,nterfa!e
o#Oe!ts w'&!' were e(elope for Release 4.0 >for e6ample ,-o! types? !an 'a(e lon4er names t'an
#efore.
/'&s fa!t !an lea to pro#lems w'en !ommun&!at&n4 w&t' oler releases w'&!' only re!o4nTAe s'ort
names. ,f reDu&re* ta#les w'&!' !an !on(ert t'e lon4 names to s'ort names must t'erefore #e
ma&nta&ne.
/'ese ta#les are ma&nta&ne &n t'e ,M% or from t'e ,-o! ,nterfa!e e(elopment >pat' for se4ments
or ,-o! types from t'e rele(ant e&tor: *n+ironment -> Con+ersion -> ,o"-ect name>.. Bou s'oul
also rea t'e onl&ne o!umentat&on.
>C? SA$ A% BC620 8
9.10
SAP AG 1999
General Setting1 S$&&ary
General etting are entere" !ia the I8G. In
a""ition4 $er-pecific para&eter can %e change"
at any ti&e !ia the control &en$.
The IDoc A"&initrator i part of the glo%al
para&eter 'hich are &aintaine" in IDoc
A"&initration. ;hen e(ception occ$r4 the
a"&initrator i al'ay notifie" if no partner profile
i fo$n".
>C? SA$ A% BC620 <0
9.11 "eneral Settin&s Exercise
*n$t 5eneral Sett$ngs
To#$c ;ast data entry
Ma&nta&n t'e efault (alues for fast entry.
As a mem#er of t'e 0-, proOe!t team enter t'e !ompany /:B,Nnn as t'e
0-, !ustomer for t'e sales orers an orer a!"nowle4ments As you
e6pe!t furt'er 0-, !ustomers for t'ese messa4es* you want to use
!orrespon&n4 proposals &n Custom&A&n4.
<:< %o to ,-o! ,nterfa!e Custom&A&n4 >!'oose Basis (om)onents 9asis Ser/ices
Ioc Interface? an !'e!" t'e follow&n4 efault (alues:
.ut#oun $ro!ess&n4:
Parameter )al!e
$artner type N;
Messa4e type .R-RS$
$artner fun!t&on A%
Bas&! type .R-0RS0<
Appl&!at&on 7<
.utput type BA00
$ro!ess !oe S-<0
,n#oun $ro!ess&n4:
Parameter )al!e
$artner type N;
Messa4e type .R-0RS
$artner fun!t&on A%
$ro!ess !oe .R-0
>C? SA$ A% BC620 <<
2:< Now transfer t'ese efault (alues to t'e partner prof&les of your !ustomer. As a result
you !an
Re!e&(e sales orers from t'e !ustomer
Sen orer !onf&rmat&ons to t'&s !ustomer
/'e !orrespon&n4 master ata &n t'e S- appl&!at&on 'as alreay #een !reate for you.
2:2 9rom t'e &n&t&al noe of t'e ,-o! ,nterfa!e* !'oose Ioc Partner Profile. C'oose
0tilities 2ast ata )ntry an enter t'e !ustomer num#er /:B,Nnn. Sele!t t'e
proposal for out#oun pro!ess&n4. /'e lo4&!al messa4e &s .R-RS$.
2:3 C'oose 0tilities 2ast ata )ntry a4a&n #ut now for &n#oun pro!ess&n4. /'e lo4&!al
messa4e &s .R-0RS. Sa(e your entr&es.
2:4 %o to t'e out#oun parameters for messa4e .R-RS$. Repla!e output type BA00 w&t'
your output type SBnn from t'e e6er!&se &n t'e LMessa4e ControlM un&t.
>C? SA$ A% BC620 <2
/0
SAP AG 1999
A""itional Tet Progra&
Tet layer
Tet progra&
>C? SA$ A% BC620 <
10.2
SAP AG 1999
Proceing Tet1 9nit 7%6ecti!e
9e pecial tet progra& an" "eter&ine 'hen to
i&ple&ent the& "$ring proceing
>C? SA$ A% BC620 2
10.3
SAP AG 1999
Proceing Tet1 B$ine Scenario
After tet ha!e %een co&plete" $ccef$lly in
yo$r o'n yte& an" the <DI $%yte& ha %een
connecte"4 yo$ 'ih to tet "ata tranfer.
The IDoc Interface tet progra& are to %e $e" for
thi p$rpoe an" thi $nit contain infor&ation
a%o$t $ing thee tool.
>C? SA$ A% BC620 3
10.4
SAP AG 1999
Tet +ayer1 7!er!ie'
In%o$n"
IDoc file
Application
IDoc Interface
;or2flo' 8C
7$t%o$n"
IDoc file
Stat$
confir&.
1E12
1E16 1E17
1E19 2
1E18
1E15
1E142 1E19
:ile Syte&
<(ternal
Syte&
1E18
/'e arrows s'ow t'e layers w'ere t'e tests start. Alon4s&e &s t'e rele(ant transa!t&on. .ut#oun
pro!ess&n4 &s on t'e left* &n#oun pro!ess&n4 on t'e r&4't. A!!or&n4 to t'e pro!ess !oe >partner
prof&le entry?* t'e &n#oun test ,-o!s are pro!esse &re!tly &n t'e appl&!at&on or (&a a wor"flow.
All test pro4rams wr&te a spe!&al status. =en!e you !an eterm&ne w'et'er or not ea!' ,-o! was
4enerate for test purposes.
/'e ,-o! stat&st&!s pro(&e an o(er(&ew of all test ,-o!s >95 "ey* also see @Stat&st&!s an
Mon&tor&n4@?.
/'e test tool >transa!t&on +0<8* see !orrespon&n4 un&t? &s t'e most 4eneral tool. Bot' &n#oun an
out#oun pro!ess&n4 !an #e teste for one ,-o! >w'&!' !an e(en #e !reate manually?.
/'e ot'er test pro4rams reDu&re e&t'er an e6&st&n4 f&le* a messa4e status re!or >MC re!or?* or a f&le
&n t'e f&le system >at t'e operat&n4 system le(el?.
,f a f&le port &s sele!te &n out#oun pro!ess&n4* a !omplete test !y!le >from out#oun pro!ess&n4 to
&n#oun pro!ess&n4? !an #e e6e!ute* &n!lu&n4 t'e f&le system.
>C? SA$ A% BC620 4
10.5
SAP AG 1999
Tet +ayer1 7$t%o$n" Proceing
Application
8C
1E15
1E142 1E19
<(ternal
Syte&
IDoc Interface
8C
+'en test&n4 from MC >transa!t&on +0<5?* you !an test w'et'er an ,-o! &s !reate !orre!tly from a
4enerate MC re!or. ,n t'&s !ase* &spat!' t&me < or 2 must #e !onf&4ure &n t'e messa4e !on&t&on
re!or: /'&s stops messa4e pro!ess&n4* t'at &s* t'e pro!ess&n4 pro4ram RSNAS/00 &s not starte
&re!tly w'en t'e appl&!at&on o!ument &s !reate* an t'e MC re!or &s ass&4ne t'e status 0 >not
yet pro!esse?.
/ransa!t&on +0<5 oes not'&n4 #ut start pro4ram RSNAS/00* t'at &s* tr&44er furt'er pro!ess&n4
manually. ;s&n4 t'&s met'o* you !an* for e6ample* 4o &nto e#u44&n4 moe or e6port messa4es*
w'&!' &s not poss&#le &n ot'er !ases.
Bot' t'e ,-o! test >transa!t&on +0<4? an t'e test tool >transa!t&on +0<8? test t'e transfer of one or
more ,-o!s to t'e spe!&f&e port. As a prereDu&s&te for t'e ,-o! test* an out#oun ,-o! w'&!' 'as not
#een sent to any ports must e6&st alreay >!urrent status 30?. Su!' an ,-o! !an #e 4enerate* for
e6ample* us&n4 transa!t&on +0<5: ,n t'e !orrespon&n4 partner prof&les* t'e output moe must #e
entere as @!olle!t ,-o!sM* so t'at t'e ,-o!s are not forware &mme&ately.
/'ere are no prereDu&s&tes for t'e test tool.
:ote /ransa!t&on +0<5 !an only #e use &n !onOun!t&on w&t' mo(&n4 ata from t'e appl&!at&ons S-
an MM. /'e !orrespon&n4 messa4e types are .R-0RS* .R-RS$* -0SA-7 an ,N7.,C* for
e6ample. .nly t'ese moules an messa4es use Messa4e Control for ,-o! out#oun pro!ess&n4.
>C? SA$ A% BC620 5
10.6
SAP AG 1999
Tet +ayer1 In%o$n" Proceing
In%o$n"
IDoc file
Application
IDoc Interface
;or2flo'
7$t%o$n"
IDoc file
1E12
1E16
1E19
:ile Syte&
Bot' t'e mo&f&e out#oun f&le test >transa!t&on +0<2? an t'e or&4&nal &n#oun f&le test >+0<6?
test t'e transfer of an ,-o! f&le (&a t'e ,-o! ,nterfa!e. +0<2 !'an4es !ontrol re!ors to !reate an
&n#oun ,-o! from an out#oun ,-o!* #efore t'e ,-o! &s sent to t'e ,-o! ,nterfa!e.
/'ere are no prereDu&s&tes for t'e &n#oun test tool: no &n#oun port of type @f&le@ &s neee an no
f&les are reDu&re from t'e f&le system. /'e test tool !an e(en !reate &n#oun ,-o!s &f ne!essary.
C'e!" t'e onl&ne o!umentat&on >e6tene 'elp? for t'e test tools.
:ote +0<6 erases t'e &n#oun f&le after t'e f&le 'as #een rea su!!essfully. /'&s oes not apply to
out#oun f&les* w'&!' are rea #y +0<2 an !an t'erefore #e use for furt'er test runs.
>C? SA$ A% BC620 6
10.7
SAP AG 1999
Tet +ayer1 Stat$ Confir&ation
Application
IDoc Interface
;or2flo'
1E17
:ile Syte&
7$t%o$n"
file 'ith
SASTAT0/
1E12
1E16
1E19 2
1E18
In%o$n"
file 'ith
SASTAT0/
Stat$
confir&.
1E18
Bou test t'e transfer of status !onf&rmat&ons &n f&le format w&t' @pro!ess status f&le@ >transa!t&on
+0<C?. /ransa!t&on +0<E >@4enerate status f&le@? oes not nee a f&le as &t &s self:4enerat&n4. /'e
,-o! &splay fun!t&on !an #e use to !'e!" &f t'e status re!ors were wr&tten !orre!tly to t'e rele(ant
,-o!.
Ca!t$on As &n t'e !ase of an or&4&nal &n#oun ,-o!* t'e status f&le &s elete after #e&n4 rea
su!!essfully. /'e test !an t'erefore #e !arr&e out only on!e for ea!' f&le.
+'en a status re!or &s re!e&(e w'&!' &n&!ates an error* a wor"flow &s starte: /'e >status? pro!ess
!oe for t'&s purpose &n t'e stanar system &s 0-,S. .t'er pro!ess !oes for ot'er tas"s5wor"flow
ef&n&t&ons for status pro!ess&n4 !an #e !reate (&a Control :K )tatus 'rocess code an Control :K
)tatus maintenance from t'e ,-o! ,nterfa!e &n&t&al s!reen.
Status re!ors must refer to out#oun ,-o!s &n t'e system* ot'erw&se an error o!!urs &n status
pro!ess&n4.
/'e 4eneral status !onf&rmat&on for all port types an &re!t&ons runs (&a t'e spe!&al ,-o! type
SBS/A/0<* w'&!' &s pro!esse #y stanar tas" /S300000206. /'&s status pro!ess&n4 t'erefore
always ta"es pla!e (&a wor"flow. ,f an &n!orre!t status &s returne* a wor" &tem &s 4enerate.
SBS/A/0< !an #e use w&t' all t'e &n#oun test pro4rams. ,-o!s of t'&s type must #e present &n f&le
form* e6!ept &n t'e !ase of t'e test tool.
>C? SA$ A% BC620 C
10.8
SAP AG 1999
;hen to Tet ;hich :$nction>
Data e(change 'ith the file yte&1 ;</-
(o$t%o$n")4 ;</6 (in%o$n")4 ;</L (tat$
confir&ation4 in%o$n")
Proceing 8C recor"1 ;</*
Data tranfer fro& the IDoc Interface to a""itional
in%o$n" proceing1 ;</)
Data tranfer to any port1 ;</-
>C? SA$ A% BC620 E
10.9
SAP AG 1999
Proceing Tet1 S$&&ary
Special tet progra& re5$ire 8C recor"4 file or
e(iting IDoc fro& the "ata%ae. If neceary4
a$to&atic o$t%o$n" proceing &$t %e toppe" !ia
the o$tp$t &o"e fro& the partner profile an" the
"ipatch ti&e in the 8C con"ition recor".
The tet tool allo' general tet for in%o$n"
proceing4 o$t%o$n" proceing an" tat$
confir&ation !ia SASTAT0/.
>C? SA$ A% BC620 8
//
SAP AG 1999
A Proce Chain
Sen" p$rchae or"er
Pot tan"ar" or"er
>C? SA$ A% BC620 <
11.2
SAP AG 1999
A Proce Chain1 9nit 7%6ecti!e
Sen" a p$rchae or"er !ia IDoc
0ecei!e a tan"ar" or"er !ia IDoc
<(plain 'hich <DI-pecific &ater "ata &$t %e
&aintaine"
>C? SA$ A% BC620 2
11.3
SAP AG 1999
A Proce Chain1 B$ine Scenario
:or tet p$rpoe4 IDoc are to %e create" %y
S&art8art an" ent to =$ic2Deli!er.
>C? SA$ A% BC620 3
11.4
SAP AG 1999
P$rchae 7r"er for S&art8art
R/3 Sste$ R/3 Sste$ ) ) S$art<art S$art<art
Copy "ata4 proce f$rther
Pot p$rchae or"er4 'rite 8C-recor"
:in" port (type - J:ileJ) for =$ic2Deli!er
Generate IDoc4 en" to port
.6ternal Sste$ J .6ternal Sste$ J S$art<art S$art<art .DI Su/sste$ .DI Su/sste$
9or SmartMart* t'e ata flow appears as follows:
As t'e pur!'ase orer &s !reate &n MM* out#oun pro!ess&n4 'as to ta"e pla!e us&n4 Messa4e
Control. /'e master ata for t'e (enor 3u&!"-el&(er t'erefore !onta&ns a !on&t&on re!or w'&!'
uses t'e orer to f&n t'e !orrespon&n4 0-, messa4e an wr&tes an MC re!or.
/'e "ey f&els &n t'e MC re!or are ass&4ne to t'e !orrespon&n4 "ey f&els &n t'e partner prof&le
>out#oun pro!ess&n4 us&n4 Messa4e Control?. /'ey eterm&ne t'e pro!ess !oe* w'&!' &n turn
ef&nes t'e out#oun pro!ess&n4 >4enerat&n4 an out#oun ,-o! us&n4 a fun!t&on moule?.
/'e "ey f&els &n t'e partner prof&le >out#oun pro!ess&n4 us&n4 Messa4e Control? are ass&4ne to t'e
!orrespon&n4 "ey f&els &n t'e partner prof&le >4eneral out#oun pro!ess&n4?. /'&s eterm&nes t'e
,-o! type >.R-0RS0<? an t'e port.
/'e ,-o! ,nterfa!e now "nows w'&!' ,-o! type to 4enerate w&t' w'&!' fun!t&on moule. /'e ,-o!
&s !reate. /'e partner prof&le spe!&f&es t'at t'e ,-o! &s &mme&ately sent to t'e port.
>C? SA$ A% BC620 4
11.5
SAP AG 1999
<DI-0ele!ant 8ater Data in P$rchaing
IDoc Type 70D<0S0/
.1.DKA1 (PA0F; N DAGE)=
Partner in"or$ation
.1.DP19 (=9A+:N D00/E)=
<aterial nu$/er
Data recor"
Data recor"
.1.DKA1 (PA0F; N J+:J)1
Partner in"or$ation
Data recor"
Fen"or &ater recor" 1
Partner nu$/er8 t+e8
"unction
Fen"or &ater recor" 1
&en!or account
8aterial &ater recor"1
<aterial na$e
Fen"or &aterial n$&%er1
<aterial na$e "or *en!or
8C con"ition recor" %ith
trans$iss; $e!iu$ L6L 0.DI1
.1.DP19 (=9A+:N D002E)=
<aterial nu$/er
Data recor"
/'e MM master ata must !onta&n !erta&n parameters w'&!' are sent to t'e orer re!&p&ent (&a ,-o!:
Apart from t'e partner num#er an type* t'e (enor master re!or must !onta&n t'e partner fun!t&on.
/'e partner fun!t&on &s a reDu&re f&el entry &n t'e a&t&onal out#oun partner prof&le us&n4
Messa4e Control >MC?.
/'e (enor master re!or s'oul !onta&n t'e name w'&!' appears as t'e partner num#er &n t'e
re!&p&ent partner prof&les as t'e @a!!ount w&t' (enor@ >f&el 29B<:0,N/.?. /'&s f&el &s !ompare
w&t' t'e partner num#er (alue &n t'e re!&p&ent &n#oun partner prof&le. ,f t'&s f&el &s not ma&nta&ne*
a&t&onal !on(ers&ons are reDu&re &n t'e re!&p&ent system.
/'e (enor mater&al &nformat&on must !onta&n t'e mater&al name for t'e (enor* #e!ause t'e
re!&p&ent eterm&nes from t'e !ontents of a se4ment of type 0<0-$<8 w'&!' mater&al 'as #een
orere.
/'e MC !on&t&on re!or must !onta&n a transm&ss&on me&um @6M >0-,?. /'e re!&p&ent !annot see
t'&s (alue. ,f anot'er transm&ss&on me&um &s entere* t'e ,-o! ,nterfa!e w&ll not #e a!t&(ate.
>C? SA$ A% BC620 5
11.6
SAP AG 1999
Stan"ar" 7r"er for =$ic2Deli!er
R/3 Sste$ R/3 Sste$
Generate %or- ite$
o2>
o2>
#o
#o
Sen" "ata to
03, Syte&
Deter&ine proceing for S&art8art "ata4
generate IDoc
Pot tan"ar" or"er
.6ternal Sste$ J .6ternal Sste$ J ?uic-Deli*er ?uic-Deli*er .DI Su/sste$ .DI Su/sste$
9or 3u&!"-el&(er* t'e ata flow appears as follows:
/'e e6ternal system >3u&!"-el&(er 0-, su#system? !alls t'e &n#oun fun!t&on moule for t'e port
type @9&le@ &n t'e 3u&!"-el&(er R53 System (&a R9C. /'e &n#oun port &s t'erefore ef&ne #y t'e
e6ternal system.
/'e ,-o! ,nterfa!e re!o4n&Aes t'e e6ternal system &f t'e system &s ef&ne as an &n#oun port. /'e
,-o! &s t'en !reate &n t'e ata#ase.
Control re!or f&els &n t'e &n#oun ,-o! are ass&4ne to t'e !orrespon&n4 "ey f&els &n t'e &n#oun
partner prof&le. /'ey eterm&ne &n#oun pro!ess&n4 >&n t'&s !ase* &re!t pro!ess&n4 #y a fun!t&on
moule?. /'&s fun!t&on moule reas t'e orer ata an posts t'e o!ument as a stanar orer &n
S-.
:ote -o not !onfuse t'e two fun!t&on moules es!r&#e 'ere: /'e f&rst &s !alle #y t'e e6ternal
system (&a R9C an 4enerates t'e ,-o!* w'&le t'e se!on &s t'e appl&!at&on fun!t&on moule w'&!'
reas t'e ata &n t'e new &n#oun ,-o!.
>C? SA$ A% BC620 6
11.7
SAP AG 1999
<DI-Specific 8ater Data in Sale
IDoc Type 70D<0S0/
IDoc Type 70D<0S0/
.1.DKA1 (PA0F; N J+:J)1
Partner in"or$ation
.1.DP19 (=9A+:N D002E)=
<aterial nu$/er
Data recor"
Data recor"
C$to&er &ater recor"1
Partner nu$/er8 t+e8
"unction
SD C$to&iHing1
Assigning custo$er/
*en!or to sales
organiMation
8aterial &ater recor"1
<aterial na$e
.1.DKA1 (PA0F; N DAGE)=
Partner in"or$ation
Data recor"
/'e S- master ata must !onta&n 0-,:spe!&f&! parameters w'&!' are !ompare w&t' t'e ata from
t'e orer ,-o!:
$artner num#er* type an fun!t&on of t'e sener are ass&4ne a!!or&n4 to t'e ata &n t'e partner
prof&le. /'&s ata must also e6&st &n t'e S- master ata.
/'e mater&al num#er &s transferre &n a se4ment of type 0<0-$<8. /'&s mater&al must e6&st &n t'e
mater&al master re!or. /'e Dual&f&er 002 &n t'e se4ment s'ows t'at t'&s &s t'e mater&al num#er for
t'e (enor.
,f t'e 0-, su#system oes not ass&4n t'e !om#&nat&on of !ustomer an (enor to a sales or4an&Aat&on
(&a se4ments of type 0<0-N<4 >o!ument 'eaer or4an&Aat&onal ata?* you must ma&nta&n t'&s
ass&4nment yourself us&n4 t'e !ustom&A&n4 transa!t&on >7.0-?.
>C? SA$ A% BC620 C
11.8
SAP AG 1999
A Proce Chain1 S$&&ary
Special <DI para&eter &$t %e entere" in the
application &ater "ata. Thee incl$"e partner
infor&ation an" tran&iion &e"i$& J6J in the
con"ition recor" for o$t%o$n" proceing $ing
8eage Control (8C).
7$t%o$n" proceing $ing 8eage Control i
al'ay applie" for p$rchae or"er fro& the 88
&o"$le.
>C? SA$ A% BC620 E
11.9Process (-ain Exercise
*n$t A Process Cha$n
To#$c Send #!rchase order
;se ,-o! &splay to tra!e ,-o!s
As a mem#er of t'e 0-, proOe!t team you want to s&mulate t'e messa4e
!'a&n from t'e out#oun pur!'ase orer (&a t'e &n!om&n4 orer to t'e
sen&n4 an su#seDuent re!e&(&n4 of t'e orer a!"nowle4ment. 9&rst*
you ta"e t'e role of t'e !ustomer* t'en t'e (enor >&n!om&n4 orer an
out#oun orer a!"nowle4ment? &n orer to a!t as t'e !ustomer a4a&n
>&n!om&n4 orer a!"nowle4ment? at t'e en of t'e messa4e !'a&n.
<:< Create a pur!'ase orer for met'anol >mater&al num#er S7--00) from t'e (enor T-
BI6nn #y sele!t&n4 1o'istics 0aterials 0ana'ement Purchasin' Purchase
4rder 3reate 5endor known >transa!t&on M02<?.
<:2 As a mem#er of t'e pur!'as&n4 epartment* you #elon4 to #!rchas$ng organ$3at$on
-000 an #!rchas$ng gro!# 00-. /'e met'anol &s reDu&re for #lant --00.
<:3 After t'e ata 'as #een entere su!!essfully* sele!t -oto 0essa'es from t'e menu &n
t'e &tem o(er(&ew to !'e!" t'e proposal for t'e output of t'e pur!'ase orer (&a
Messa4e Control. ,f d$s#atch t$me = 'as #een sele!te* an ,-o! for t'&s pur!'ase orer
&s 4enerate as soon as t'e ata &s sa(e.
<:4 C'an4e to Purchase order isplay. By sele!t&n4 S*stem 1inks t'e ,-o! t'at 'as
Oust #een 4enerate &s &splaye.
As )end IDoc immediately 'as #een set &n t'e partner prof&les* t'e ,-o! 'as t'e status
03* t'at &s* &t 'as #een wr&tten &n a f&le.
To#$c Incom$ng order
2:< ,n t'e pre(&ous e6er!&se* a f&le was !reate &n w'&!' t'e ata &s !orre!t #ut t'e !ontrol
re!or &s &n!orre!t.
>C? SA$ A% BC620 8
2:2 Sele!t #est :; Inbound Processin' 0odified 4utbound 2ile from t'e &n&t&al noe of
t'e ,-o! ,nterfa!e >transa!t&on +0<2?. /'&s transa!t&on allows you to !'an4e t'e
!ontrol re!or so &t &s !orre!t* t'at &s* mat!'es t'e partner prof&le you !reate &n t'e
e6er!&se @%eneral Sett&n4s@ for your !ustomer /:B,Nnn.
Bou !an set efault (alues for sour!e* est&nat&on an port* #y sett&n4 your port Port:nn
for t'e test #y !'oos&n4 "oto .ser settin's.
2:3 /'e sener &s !ustomer /:B,Nnn/ from w'om you w&s' to re!e&(e t'e orer. 0nter T-
BIAnn as t'e partner num#er* A* as t'e partner type an A5 as t'e partner fun!t&on.
/'e lo4&!al messa4e &s +,D&,S. 9or all ot'er (alues* you !an use t'e efault (alues.
2:4 C'oose )xecute.
2:5 C'oose Ioc isplay Ioc or Ioc Ioc 1ists to (&ew t'e ,-o! w'&!' you 'a(e
!reate. By !'oos&n4 S*stem 1inks t'e orer t'at 'as Oust #een 4enerate &s
&splaye.
To#$c Send order ackno2ledgment
3:< ,n t'e pre(&ous e6er!&se you poste an orer. An out#oun ,-o! 'as alreay #een
4enerate #y Messa4e Control for orer a!"nowle4ment. /'e ,-o! 'as t'e status 30*
t'erefore 'as not yet #een sent #y t'e SA$ System.
3:2 ,n&t&ate t'e transfer of t'e orer ,-o!s #y !'oos&n4 est 4utbound Processin' from
Ioc from t'e &n&t&al noe of t'e ,-o! ,nterfa!e. Sele!t w&t' t'e re!&p&ent partner
num#er.
3:3 Return to t'e orer >transa!t&on 7A03? an !'e!" t'e status of t'e .R-RS$ ,-o!* an
!'oose S*stem 1inks. ,f t'&s ,-o! 'as status 03* you 'a(e 4enerate a f&le.
To#$c ,ece$%e order ackno2ledgment
4:< ,n t'e pre(&ous e6er!&se* a f&le was !reate &n w'&!' t'e ata &s !orre!t #ut t'e !ontrol
re!or &s &n!orre!t.
4:2 Sele!t #est :; Inbound Processin' of 0odified 4utbound 2ile from t'e &n&t&al noe of
t'e ,-o! ,nterfa!e. /'&s transa!t&on allows you to !'an4e t'e !ontrol re!or so &t &s
>C? SA$ A% BC620 <0
!orre!t* t'at &s* mat!'es t'e partner prof&le you !reate &n t'e e6er!&se @partner prof&les@
for your !ustomer /:B,2nn.
4:3 /'e sener &s (enor /:B,2nn/ from w'om you w&s' to re!e&(e t'e orer
a!"nowle4ment. 0nter T-BI6nn as t'e partner num#er* 6I as t'e partner type an 6;
as t'e partner fun!t&on. /'e lo4&!al messa4e &s +,D,SP. 9or all ot'er (alues* you !an
use t'e efault (alues.
4:4 C'oose )xecute.
4:5 C'oose Ioc isplay Ioc or Ioc Ioc 1ists to (&ew t'e ,-o! w'&!' you 'a(e
!reate. By !'oos&n4 S*stem 1inks t'e pur!'ase orer t'at 'as Oust #een !'an4e &s
&splaye. ,f you ou#le:!l&!" on t'e &tem* you w&ll see t'e a!"nowle4ment num#er
t'at 'as Oust #een transferre.
>C? SA$ A% BC620 <<
/2
SAP AG 1999
Statitic an" 8onitoring
Pai!e an" acti!e &onitoring
;or2 Ite& Analyi
>C? SA$ A% BC620 <
12.2
SAP AG 1999
Statitic an" 8onitoring1 9nit 7%6ecti!e
Deci"e 'hen "ifferent tool ho$l" %e i&ple&ente"
for IDoc &onitoring
9e the in"i!i"$al &onitoring tranaction
>C? SA$ A% BC620 2
12.3
SAP AG 1999
B$ine Scenario
The e(change of IDoc %et'een the t'o
co&panie i to %e &onitore". A a re$lt4 yo$
&$t %e fa&iliar 'ith the IDoc &onitoring tool
a!aila%le for the IDoc Interface.
>C? SA$ A% BC620 3
12.4
SAP AG 1999
8onitoring Progra&1 7!er!ie'
Acti!e
&onitoring
Pai!e &onitoring
-L/2
-L//
-L/,
-L/M
Diplay
J0S<ID7C8J Statitic
+it4 IDoc
earch
+'en errors o!!ur* t'e ,-o! ,nterfa!e always not&f&es users a!t&(ely >error 'anl&n4 (&a wor" &tems?.
,n a&t&on* t'e ,-o! ,nterfa!e pro(&es four pass&(e pro4rams an one a!t&(e pro4ram for ,-o!
mon&tor&n4.
/'e pass&(e mon&tor&n4 tools !an #e orere a!!or&n4 to t'e&r le(el of eta&l: /'e ,-o! stat&st&!s
ass&4n ,-o!s to status 4roups a!!or&n4 to t'e&r !urrent status* for e6ample* to t'e 4roup @&n#oun
error w&t'&n t'e ,-o! ,nterfa!e@. /'e &n&(&ual ,-o!s are &splaye &n t'e ,-o! l&st. /'&s also
appl&es to t'e ,-o! sear!'* w'ere ,-o!s are sele!te a!!or&n4 to (alues &n t'e se4ment f&els.
9&nally* ,-o! &splay allows &re!t a!!ess to an &n&(&ual ,-o! (&a t'e ,-. -ou#le:!l&!"&n4 on t'e
rele(ant entry &splays more eta&ls* as usual.
/'e pass&(e mon&tor&n4 tools !an #e foun &n t'e IDoc menu from t'e ,-o! ,nterfa!e &n&t&al noe.
A!t&(e mon&tor&n4 >report RS0,-.CM? uses t'e status 4roups from ,-o! stat&st&!s. ,t &s poss&#le to
ef&ne t'res'ol (alues. +'en t'ese (alues are e6!eee* respons&#le users are not&f&e (&a wor"
&tems. A!t&(e mon&tor&n4 !an t'erefore #e seen as a !onf&4ura#le error 'anl&n4 fun!t&on.
A!t&(e mon&tor&n4 &s s!'eule as a Oo# >from t'e R53 &n&t&al s!reen* !'oose System :K Ser(&!es :K
Jo#s :K -ef&ne Oo#?. 7ar&ants are !reate from t'e ABA$ e&tor >!'oose %oto :K 7ar&ants?.
>C? SA$ A% BC620 4
12.5
SAP AG 1999
Selection :iel" for 8onitoring
Control recor"
Creation
"ate
Change
"ate
Partner4
&eage4...
IDoc tatitic
IDoc lit
IDoc earch
IDoc "iplay
Acti!e
&onitoring
<DI
0eference
/'e mon&tor&n4 pro4rams are reports w'&!' sele!t ,-o!s &n t'e R53 ata#ase a!!or&n4 to !erta&n
!r&ter&a from t'e !ontrol re!or.
/'e most &mportant sele!t&on f&el &s t'e ate on w'&!' t'e !ontrol re!or was !reate. /'e ,-o!
stat&st&!s tool sele!ts a!!or&n4 to t'e !'an4e ate.
All mon&tor&n4 pro4rams allow sele!t&on of ,-o!s a!!or&n4 to partner an messa4e. ,n ,-o!
stat&st&!s* t'&s wor"s (&a t'e e6tene sele!t&on.
/'e '&4'est num#er of sele!t&on f&els &s offere #y t'e ,-o! &splay fun!t&on. Apart from t'e ,-o!
,-* users !an ma"e sele!t&ons a!!or&n4 to 0-,:spe!&f&! parameters* for e6ample t'e transm&ss&on
f&le &n t'e 0-, su#system* w'&!' allows t'e ata flow w&t' t'e 0-, su#system to #e mon&tore.
>C? SA$ A% BC620 5
12.6
SAP AG 1999
Technical le!el1 Stat$4 IDoc ID
IDoc "iplay
I&ple&enting :$nction
Application le!el1 Partner4 &eage
IDoc lit
All mon&tor&n4 fun!t&ons !an &splay an &n&(&ual ,-o!. =owe(er* users !an only a!!ess an ,-o!
&re!tly (&a t'e ,-o! &splay fun!t&on >us&n4 t'e ,-o! ,-?. As t'e most sele!t&(e tool* ,-o! &splay &s
usually use w'en te!'n&!al Duest&ons ar&se >for e6ample pro#lems w'en !ommun&!at&n4 w&t' an
0-, su#system?
/'e ,-o! l&st fun!t&on 'as less sele!t&on f&els an &s t'erefore eas&er to use. As w&t' t'e rema&n&n4
tools* t'&s fun!t&on &s use w'en appl&!at&on Duest&ons ar&se >for e6ample 'ow to &splay all ,-o!s of
messa4e type ,N7.,C?.
,-o! stat&st&!s 4&(es a #roa o(er(&ew an &s often use for presentat&ons #e!ause of &ts 4rap'&!al
!apa#&l&t&es. /o o#ta&n stat&st&!s a#out @repa&re@ ,-o!s* !'oose t'e fun!t&on @0(aluat&on '&story@ &n
t'e ,-o! stat&st&!s. /'&s &splays all status re!ors for t'e ,-o!.
Bou !an use a!t&(e mon&tor&n4 as an alternat&(e to normal e6!ept&on 'anl&n4 &f a user >employee? &s
only to re!e&(e a wor" &tem &f a !erta&n num#er of &n!orre!t ,-o!s >t'e t'res'ol (alue? are foun
w&t'&n a spe!&f&e t&me per&o. =owe(er* note t'at normal e6!ept&on 'anl&n4 st&ll ta"es pla!e.
Note t'at ,-o! stat&st&!s sele!ts all ,-o!s w'&!' 'a(e e6per&en!e a status !'an4e w&t'&n t'e
spe!&f&e t&me per&o* w'&le a!t&(e mon&tor&n4 sele!ts all ,-o!s !reate ur&n4 t'e same per&o.
>C? SA$ A% BC620 6
12.7
SAP AG 1999
Stat$ Gro$p1 8onitor3Statitic
- N JIDoc tranfer - N JIDoc tranfer
$ccef$lJ $ccef$lJ
,) N JIDoc in
target yte& (A+<)J
/2 N
JSen" o2J
/, N
JSen" o2J
0etran&iion
o2
0
20
-0
60
M0
/00
/.
=rtl.
2.
=rtl.
,.
=rtl.
-.
=rtl.
Status (alues for a!t&(e mon&tor&n4 an stat&st&!s a#out status 4roups are !om#&ne to pre(ent t'e
&nformat&on #e!om&n4 too !ompl&!ate.
/'e stanar R53 System ass&4ns a 4roup to ea!' status (&a t'e @Dual&f&!at&onM >synonym for @status
4roupM? (alue. /'&s ass&4nment !an #e !'an4e from t'e &n&t&al ,-o! ,nterfa!e menu #y !'oos&n4
Control -> Maintain status +alues.
A!!or&n4 to t'e status 4roup t'e &n&(&ual statuses* for e6ample* are &splaye &n t'e ,-o! l&st &n
t'e traff&! l&4't !olors 4reen* yellow or re. ,t s'oul t'erefore #e !lear &n t'e stanar system
w'et'er &t !on!erns an error status* transfer: or su!!ess status. /'e traff&! l&4't !olor ass&4nment for
status 4roups !an #e !'an4e #y !'oos&n4 Control -> Maintain status grou's.
9or more &nformat&on a#out t'e status 4roups w'&!' are suppl&e &n t'e stanar R53 System* you
s'oul rea t'e onl&ne o!umentat&on for t'e ,-o! stat&st&!s fun!t&on.
>C? SA$ A% BC620 C
12.8
SAP AG 1999
;or2 Ite& Analyi
9$ally refer to e(ception han"ling
;or2 ite& 'hich e(it in the yte& are lite"
Application for Jlot 'or2 ite&J4 for e(a&ple (no $er
electe")
+or" &tems are &nstan!es of ef&ne s&n4le:step tas"s. /'e ,-o! ,nterfa!e uses t'em ma&nly for
e6!ept&on 'anl&n4 >see !orrespon&n4 un&t?. /'ey t'erefore !onta&n t'e &n!orre!t ,-o! or t'e
&n!orre!t appl&!at&on o!ument w'&!' was !reate from t'e &n#oun ,-o!.
As &n ,-o! stat&st&!s* t'e wor" &tem analys&s fun!t&on allows wor" &tems #elon4&n4 to a !erta&n tas"
to #e &splaye. /'&s !an #e useful* for e6ample* &f no user !oul #e foun for t'e wor" &tem* an t'e
wor" &tem & not t'erefore appear &n any &n#o6. 9rom t'e wor" &tems* you !an Oump to t'e ,-o!
&splay fun!t&on.
/'e wor" &tem analys&s fun!t&on !an #e a!!esse #y !'oos&n4 0ools :K #usiness 1or%flo$ :K
De+elo'ment :K Re'orting :K 1or% item analysis/ for e6ample t'e $or% items 'er tas% >transa!t&on
S+<2I9R03?.
>C? SA$ A% BC620 E
12.9
SAP AG 1999
The IDoc "ata flo' can %e &onitore" !ia fo$r pai!e
progra& an" one acti!e progra& in the IDoc
interface.
Acti!e &onitoring i a f$nction 'hich can %e
in"i!i"$ally config$re" for error han"ling or general
e(ception han"ling.
The le!el of "etail in the pai!e &onitoring progra&
goe a far a "iplaying the in"i!i"$al IDoc. The
leat-"etaile" &onitoring tool i the tat$ gro$p
"iplay $n"er IDoc tatitic.
Statitic an" 8onitoring1 S$&&ary
>C? SA$ A% BC620 8
12.10Statistics an% 'onitorin& Exercise
*n$t Stat$st$cs and <on$tor$ng
To#$c Pass$%e mon$tor$ng
;se ,-o! sear!'
;se ,-o! &splay
Bou are t'e 0-, am&n&strator &n your !ompany. /'e pur!'as&n4
epartment 'as as"e you t'e follow&n4 Duest&ons:
<:< GG+'&!' statuses 'as ,-o! 1B* w'&!' !onta&ns a pur!'ase orer for (enor T-
BI6nn* alreay #een ass&4neUGG
:ote ;se t'e ,-o! &splay fun!t&on
2:< @+'&!' ,-o! was use to sen pur!'ase orer 1B to (enor T-BI6nnU@ Bou 'a(e
t'e follow&n4 &nformat&on:
-&re!t&on As a pur!'ase orer &s &n(ol(e* t'e &re!t&on &s @out#oun@.
Bas&! type $ur!'ase orers are sent to t'e 0-, su#system &n your !ompany
(&a ,-o! type .R-0RS0<.
Se4ment Bou 'a(e t'e num#er of t'e pur!'ase orer. 9rom t'e
o!umentat&on* you "now t'at t'e orer num#er &s transferre &n
t'e f&el B02NR &n se4ment 0<0-N02 w&t' t'e Dual&f&er @00<@
>f&el 3;A29?.
:ote ;se t'e ,-o! sear!' fun!t&on
3:< @As a mem#er of t'e pur!'as&n4 epartment* !an , a!!ess t'e !orrespon&n4 ,-o!s
&re!tly from my pur!'ase orerU@
4:< @As a mem#er of t'e pur!'as&n4 epartment* !an , a!!ess t'e !orrespon&n4 ,-o!s
&re!tly from my sales orerU@
>C? SA$ A% BC620 <0
:ote for e1erc$ses 0 and =: C'oose System 1inks from your appl&!at&on
o!ument.
To#$c Act$%e mon$tor$ng
;s&n4 a!t&(e mon&tor&n4
5:< Bou want to tra!e ,-o!s &n status 03. ,n!lue t'e report RS0,-.CM.
5:2 %o &nto t'e ABA$ +or"#en!' >S03E? an enter t'e report.
5:3 C'oose )xecute. 0nter t'e follow&n4 (alues &n t'e sele!t&on s!reen:
Re!&p&ent type ;S
Re!&p&ent Bour name BC620nn
Start5en t&me #efore #at!' Oo# 0nter a mean&n4ful (alue
Cr&t&!al ,-o! num#er <
Status 4roup 3 >!onta&ns status 03?
5:4 After e6e!ut&n4 t'e report you re!e&(e not&f&!at&on &n t'e Bus&ness +or"pla!e.
06e!ute t'e wor" &tem. /'e ,-o! stat&st&!s are &splaye w'ere t'e !urrent status of
t'e report e6e!ut&on &s &splaye. By sele!t&n4 Refresh* t'e !urrent status &s
&splaye.
>C? SA$ A% BC620 <<
12.11Statistics an% 'onitorin&. Solution
<:< Sear!' #y sele!t&n4 Ioc isplay Ioc an enter&n4 t'e d$rect$on as Lout#ounM
an t'e #artner n!m"er of the rec$#$ent. Bou 'a(e alreay 4enerate t'e pur!'ase
orer ,-o! &n e6er!&se < of t'e pre(&ous !'apter.
<:2 Apart from t'e status w'&!' 'as #een rea!'e* eterm&ne w'&!' messa4e 'as #een put
on 'ol w&t' t'e status (alue @30@* t'at &s* t'e (alues for !oe* messa4e num#er*
messa4e type an ,-.
2:< Sear!' for t'e ,-o!>s? us&n4 t'e ,-o! sear!' fun!t&on. Sele!t t'e follow&n4:
-&re!t&on < H Lout#ounM
Bas&! type .R-0RS0<
Se4ment Bou 'a(e t'e num#er of t'e pur!'ase orer. /'e num#er &s &n
f&el B02NR of se4ment 0<0-N02 w&t' t'e Dual&f&er @00<L.
3:< Sele!t 1o'istics 0aterials 0ana'ement Purchasin' Purchase 4rder
isplay >transa!t&on M023?. 0nter t'e pur!'ase orer num#er an !'oose 3ontinue.
9rom t'e transa!t&on o(er(&ew s!reen* !'oose System 1inks. /'e ,-o! w'&!' &s
l&n"e to t'&s pur!'ase orer &s &splaye an you !an reDuest more eta&le
&nformat&on a#out t'e ,-o! #y ou#le:!l&!"&n4 w&t' t'e mouse on t'e rele(ant entry.
4)1 Sele!t 1o'istics Sales and istribution Sales 4rder isplay >transa!t&on
7A03?. 0nter t'e sales orer num#er an !'oose 3ontinue. /'e o(er(&ew s!reen for
t'e transa!t&on &s &splaye. Alternat&(ely* f&n t'e sales orer (&a t'e pur!'ase orer
num#er from e6er!&se 3 an t'e sear!' fun!t&on. C'oose System 1inks. /'e ,-o!
w'&!' &s l&n"e to t'&s sales orer &s &splaye an you !an reDuest more eta&le
&nformat&on a#out t'e ,-o! #y ou#le:!l&!"&n4 on t'e rele(ant entry.
>C? SA$ A% BC620 <2
/,
SAP AG 1999
;or2flo' an" IDoc
In%o$n" proceing
<(ception han"ling
#otification concept
7rganiHational tr$ct$re
>C? SA$ A% BC620 <
13.2
SAP AG 1999
;or2flo' an" IDoc1 9nit 7%6ecti!e
<(plain ho' the agent reponi%le i infor&e" if
an error occ$r "$ring IDoc proceing
8aintain the organiHational tr$ct$re
>C? SA$ A% BC620 2
13.3
SAP AG 1999
;or2flo' an" IDoc1 B$ine Scenario
=$ic2Deli!er4 yo$ are reponi%le for config$ring
the IDoc interface.
A p$rchae or"er fro& S&art8art i recei!e" %y
=$ic2Deli!er a an in%o$n" IDoc of type
70D<0S0/. In%o$n" proceing i config$re"
$ing a proce co"e a J"irect !ia a f$nction
&o"$leJ4 e(ception han"ling ta2e place %y &ean
of 'or2flo'. Ao$ &$t config$re a party to %e
notifie" if an error occ$r.
>C? SA$ A% BC620 3
13.4
SAP AG 1999
In%o$n" Proceing 'ith ;or2flo'
SAP Application
Doc$&ent Doc$&ent
IDoc C IDoc C
proce proce
;or2flo'
0e!ie'4
e"it4
for'ar"4
an" o on.
,-o! &n#oun pro!ess&n4 !an &n!lue a wor"flow w'&!' &s tr&44ere #y a pro!ess !oe. /'&s
wor"flow &s ef&ne #y t'e user. 06amples:
An appl&!at&on o!ument &s !reate automat&!ally from t'e ,-o!. /'e appl&!at&on o!ument &s t'en
sent to a user for re(&ew.
/'e ,-o! &s e&te an mo&f&e &f ne!essary #efore t'e appl&!at&on o!ument &s !reate. ,n t'&s
!ase* t'e ,-o! &s e&te an not t'e appl&!at&on o!ument.
/'e ,-o! or appl&!at&on o!ument &s forware to ot'er users or new >out#oun? ,-o!s are sent*
us&n4 t'e &n#oun ,-o! as a #as&s.
Note: 9or reasons of !lar&ty* t'&s sl&e oes not s'ow t'e transfer of t'e ,-o! from t'e e6ternal
system* alt'ou4' t'&s &s also part of &n#oun pro!ess&n4.
>C? SA$ A% BC620 4
13.5
SAP AG 1999
<(ception Ban"ling 'ith ;or2flo'
R/3 Sste$ R/3 Sste$
'hec- +artner8 generate IDoc
Post !ocu$ent
.rror han!ling
o2>
o2>
#o
#o
8eage
.6+ress
06!ept&on 'anl&n4 or error 'anl&n4 &s always ef&ne as a wor"flow. .ne or more a4ents !an #e
not&f&e a#out t'e error s&tuat&on. /'e a4ents are ef&ne &n t'e ,-o! ,nterfa!e an &n t'e or4an&Aat&on
moel of your !ompany.
SA$ stanar e6!ept&on 'anl&n4 &n t'e ,-o! ,nterfa!e always ta"es pla!e us&n4 s&n4le:step tas"s. ,t
&s &ent&f&e #y means of pro!ess !oes.
,f you set t'e e6press &n&!ator &n t'e pro!ess !oes ma&ntenan!e* t'e a4ent respons&#le for t'e
!orrespon&n4 tas" re!e&(es a messa4e on t'e&r s!reen as soon as a new wor" &tem appears &n t'e&r
&nte4rate &n#o6.
/'e sl&e only s'ows e6!ept&on 'anl&n4 #e&n4 a!!esse from &n#oun pro!ess&n4. =owe(er*
e6!ept&on 'anl&n4 !an also #e a!!esse from out#oun pro!ess&n4.
>C? SA$ A% BC620 5
13.6
SAP AG 1999
<(ception in 7$t%o$n" Proceing
IDoc IDoc
Docu$ent Docu$ent
or <' or <'
recor! recor!
SAP Application
or 8C
IDoc Interface
<(ternal Syte&
<DI7
<DII
<rror "$ring IDoc
proceing
Synta( error
in IDoc
(ustomer
<DIP
<rror 'hile proceing
IDoc tac2
<DI#
...'ith 8C
<DI8
8eage 'itho$t IDoc
'itho$t 8C...
<DIS
Stat$ confir&ation
<DI0
S&n4le:step tas"s are &ent&f&e #y >system? pro!ess !oes:
/'e pro!ess !oes 0-,M an 0-,N are (al& for &n#oun an out#oun pro!ess&n4. No ,-o! !oul
#e !reate 'ere. 0-,N &s use for out#oun pro!ess&n4 us&n4 Messa4e Control: ;s&n4 t'e MC re!or
you !an #ran!' from t'e wor" &tem to t'e appl&!at&on o!ument.
0-,. &ent&f&es an ,-o! affe!te #y an error ur&n4 out#oun pro!ess&n4.
0-,1 &ent&f&es an ,-o! w'&!' !onta&ns a synta6 error.
0-,$ &ent&f&es a sta!" of out#oun ,-o!s >from a #at!' run of report RS0.;/00?* &n w'&!' a
pro!ess&n4 error o!!urre an affe!te all t'e ,-o!s >a non:e6&stent port* for e6ample?. /'e
!orrespon&n4 s&n4le:step tas" !an #e use to !orre!t t'e error an sen t'e ,-o! sta!" for pro!ess&n4
a4a&n.
,f t'e status @&n!orre!t@ &s ass&4ne to t'e 4roup #y t'e e6ternal system* a s&n4le:step tas" &s
aresse us&n4 t'e status pro!ess !oe 0-,S. A&t&onally* you !an use !oe 0-,R to tr&44er
out#oun pro!ess&n4 a4a&n after you 'a(e !orre!te t'e error.
:ote 0-,R &s new for t'e 0nOoy Release an repla!es t'e ol 0-,S &n t'e stanar system. +'en
up4ra&n4* you must e6pl&!&tly e6e!ute t'e !'an4e to 0-,R &n t'e ,M%.
A&t&onal e6!ept&on 'anl&n4 for status !onf&rmat&ons !an #e ef&ne an &ent&f&e (&a pro!ess
!oes.
>C? SA$ A% BC620 6
13.7
SAP AG 1999
<(ception in In%o$n" Proceing
SAP Application
IDoc IDoc
<(ternal Syte&
<DII
<DIA
8eage 'itho$t IDoc
<rror "$ring IDoc
proceing
Synta( error
in IDoc
3))lication
IDoc 'ith or 'itho$t
application "oc$&ent
8eage !ia IDoc
IDoc IDoc
IDoc Interface
<DI8
4+31
<DI+
...error "$ring
tat$ file
06!ept&on 'anl&n4 (&a s&n4le:step tas"s for &n#oun pro!ess&n4 &s t'e same as for out#oun
pro!ess&n4. 0rrors w'&!' o!!ur w'en post&n4 an appl&!at&on o!ument >ue to &n!orre!t ata* for
e6ample? are somet&mes 'anle an repa&re #y appl&!at&on:spe!&f&! tas"s an t'e !orrespon&n4
pro!ess !oes. Appl&!at&on o!uments !an also #e 4enerate &n t'&s way.
0-,M appl&es as &n out#oun pro!ess&n4* 0-,, an 0-,B are t'e same as t'e out#oun pro!ess
!oes 0-,. an 0-,1.
Any messa4es !an #e sent &n te6t format us&n4 t'e ,-o! type /1/RA+0<. Spe!&al !ase: an
e6!ept&on o!!urs &n t'e e6ternal system an t'e R53 System &s to #e not&f&e of t'&s e6!ept&on.
,f a status f&le of t'e e6ternal system !annot #e rea* t'e pro!ess !oe 0-,2 &s a!t&(ate. /'e SA$
System error messa4e &s &splaye &n e6!ept&on 'anl&n4.
>C? SA$ A% BC620 C
13.8
SAP AG 1999
#otification Concept I
0ole reol$tion
7rganiHational tr$ct$re
Ta2
Partner profile
IDoc Interface
Poi%le agent
Per&itte" agent
Selecte" agent
/'e a4ent eterm&ne &n t'e ,-o! ,nterfa!e &s only t'e perm&tte a4ent of a wor"flow tas". All
@poss&#le a4ents@ are atta!'e to t'e tas" &tself. ,ole resol!t$on eterm&nes t'e set of a4ents w'&!'
are #ot' allowe an poss&#le a4ents. /'ese a4ents are !alle t'e sele!te a4ents.
All sele!te a4ents now re!e&(e t'e not&f&!at&on as a wor" &tem >as an @&nstan!e@ of t'e wor"flow
tas"? &n t'e&r &nte4rate &n#o6.
/'e ,-o! ,nterfa!e fun!t&on moule for role resolut&on &s 0-,IR.20I9.RI$R.C0SS,N%.
/'e ,-o!s !an only #e @repa&re@ an pro!esse furt'er from t'e &nte4rate &n#o6.
Note: ,f t'e tas"s are ef&ne as 4eneral tas"s for not&f&!at&on* all users are poss&#le a4ents* an t'e
set of sele!te a4ents &s t'e same as t'e set of perm&tte a4ents.
>C? SA$ A% BC620 E
13.9
SAP AG 1999
#otification Concept II
Per&itte" agent
General etting
(IDoc A"&initration)
General 7$t%o$n"3
In%o$n"
S
p
e
c
i
a
l

f
o
r

p
a
r
t
n
e
r

a
n
"

&
e
a
g
e
S
p
e
c
i
a
l

f
o
r

p
a
r
t
n
e
r
4
%
$
t

f
o
r

a
l
l

&
e
a
g
e
G
e
n
e
r
a
l
4

f
o
r

a
l
l
p
a
r
t
n
e
r

a
n
"

&
e
a
g
e
<DI74 <DII4 <DI#

<DII4 <DIA
<DI84 <DIP
<DI04 <DIS4 <DI+
$erm&tte a4ents are entere &n t'e follow&n4 partner prof&les for t'e ,-o! ,nterfa!e: ,n#oun*
out#oun >opt&onal?* an 4eneral >reDu&re entry f&el?. +'en an error o!!urs >for e6ample a synta6
error &n an &n#oun ,-o!?* t'e most rele(ant perm&tte a4ent &s eterm&ne: /'e sear!' for t'e a4ent
respons&#le for t'e message an #artner >"ey f&els &n t'e prof&les? t'erefore starts &n t'e &n#oun or
out#oun partner prof&le.
,f no a4ent !oul #e foun &n t'e &n#oun or out#oun prof&les >e&t'er #e!ause no (alue 'a #een
entere or #e!ause no &n#oun or out#oun partner prof&le !oul #e foun for t'e !urrent partner:
messa4e !om#&nat&on?* t'e 4eneral partner prof&le &s sear!'e to eterm&ne a perm&tte a4ent for t'e
partner.
,f t'&s sear!' &s also unsu!!essful >#e!ause no 4eneral partner prof&le for t'e !urrent partner !oul #e
foun?* t'e sear!' !ont&nues &n ,-o! Am&n&strat&on >4eneral sett&n4s?. ,f no entry &s foun* no users
are not&f&eF 9or t'&s reason* you s'oul always enter an a4ent >@am&n&strator@? &n t'e 4eneral
sett&n4s.
,n all !ases* t'e a4ent !an #e a s&n4le person >type ;SHuser? or a 4roup w'&!' must #e ma&nta&ne &n
t'e $-:.R% moel* e&t'er as a Oo# or a epartment.
>C? SA$ A% BC620 8
13.10
SAP AG 1999
#otification Concept III
#r&ani5ational unit
Position
%elong to
incl$"e
incl$"e
%elong to
hol"er
hol"
"ecri%e
"ecri%e" %y
"ecri%e
"ecri%e" %y
cot center aign&ent
"ecri%e
as6
7o$
(ost center
"ecri%e" %y
1or6 center
Person8user
cot center
aign&ent
report to3
i $perior to
+or"flow auto:!ustom&A&n4 >transa!t&on S+;3? &n!lues all tas"s relat&n4 to t'e ,-o! ,nterfa!e as
@4eneral tas"s@* t'at &s* all R53 users are poss&#le a4ents. ,f you want to restr&!t t'&s num#er* you !an
o t'&s us&n4 an or4an&Aat&onal stru!ture.
/'e or4an&Aat&onal stru!ture ef&nes a respons&#&l&ty '&erar!'y. 9or e6ample* a 4eneral or4an&Aat&onal
un&t @am&n&strators@ !oul e6&st. /'&s organ$3at$onal !n$t !an now #e ass&4ne to se(eral persons
w'o 'ol as many #os$t$ons' /'&s organ$3at$onal !n$t >not an &n&(&ual? !oul #e entere as a
poss&#le a4ent &n t'e ,-o! ,nterfa!e.
Bou !an also enter a pos&t&on w'&!' !orrespons to one person as a poss&#le a4ent. /'e a(anta4e &s
t'at not&f&!at&ons are t&e to pos&t&ons* not to &n&(&uals w'ose respons&#&l&t&es !an !'an4e. /'&s
!on!ept !an #e !ompare to t'e pro!ess !oe an t'e rele(ant fun!t&on moule5wor"flow.
9urt'er elements of t'e or4an&Aat&onal stru!ture w'&!' !an #e entere as @poss&#le a4ents@ for a
stanar tas":
Co"
*ser R53 user
Dork center
>C? SA$ A% BC620 <0
13.11
SAP AG 1999
8aintaining an 7rganiHational Str$ct$re
C$to&iHing acti!itie
8aintenance fro& the ;or2flo'
&en$
,f an element of t'e or4an&Aat&onal stru!ture &s to #e entere as a poss&#le a4ent &nstea of a person
>R53 user?* t'&s element must #e ef&ne. /'&s ta"es pla!e &n Custom&A&n4 or from t'e wor"flow area
menu >Definition?: 2rgani3ational 'lan -> Create >transa!t&on $$.M?.
9rom 'ere* elements !an #e ef&ne an ass&4ne to ea!' ot'er or to R53 users.
>C? SA$ A% BC620 <<
13.12
SAP AG 1999
Integrate" In%o(
8eage
SAPoffice
8ie" "ea"line
;or2flo'
...
/'e &nte4rate &n#o6 !an #e a!!esse &re!tly from t'e ,-o! area menu >IDoc :K Integrated in"o4? or
(&a transa!t&on S.0<. 7&a 1or%flo$* you a!!ess your @wor"l&st@* t'at &s* t'e l&st of wor" &tems for
w'&!' you are entere as a @sele!te a4ent@. +or" &tems are t'e &nstan!es of t'e s&n4le:step tas"s.
Bou !an e&t a wor" &tem from your wor"l&st. As a result* t'e wor" &tem &sappears from t'e
&nte4rate &n#o6 of all ot'er sele!te a4ents.
>C? SA$ A% BC620 <2
13.13
SAP AG 1999
;or2flo' an" IDoc1 S$&&ary
#or&al IDoc proceing !ia 'or2flo' i only poi%le for in%o$n"
proceing of certain IDoc type.
<(ception han"ling al'ay ta2e place !ia 'or2flo'. It i calle" in
o$t%o$n" proceing in the a&e 'ay a in in%o$n" proceing.
<rror can %e ca$e" %y incorrect application "ata or incorrect
IDoc ynta(. In thee cae4 error han"ling i "ifferent.
Thro$gh the organiHational tr$ct$re4 'or2flo' allo' $er in a
"efine" ta2 area to %e notifie"4 not in"i!i"$al $er 'hoe
reponi%ilitie &ay change.
;or2flo' allo' incorrect IDoc to %e for'ar"e" a 'or2 ite& Jin
a controlle" &annerJ fro& an integrate" in%o( an" e!en to %e
repaire" in o&e cae.
>C? SA$ A% BC620 <3
13.141or6!lo9 an% IDocs Exercise
*n$t Dorkflo2 and IDocs
To#$c +rgan$3at$onal str!ct!re
Ma&nta&n t'e or4an&Aat&onal stru!ture
As a mem#er of t'e 0-, proOe!t team* you s'oul ma&nta&n t'e
or4an&Aat&onal moel for your !ompany* so t'at not&f&!at&ons for t'e
&n&(&ual areas of respons&#&l&ty !an #e aresse !orre!tly* for e6ample
0-, am&n&strat&on an pur!'as&n4.
<:< /'e or4an&Aat&onal un&t 500<0<20 >@0-, -epartmentL? 'as alreay #een !reate for
0-, am&n&strat&on. Bou s'oul now ass&4n your user to t'e or4an&Aat&onal un&t. /o o
t'&s* pro!ee as follows:
C'oose #ools 9usiness <orkflow e"elopment efinition #ools
4r'ani*ational 0ana'ement 4r'ani*ational Plan 3han'e. 0nter
or'ani*ational unit E00-0-20 an sele!t 3han'e. A!!ess t'e Staff assi'nments. $la!e
t'e !ursor on t'e reDu&re fun!t&on an !'oose 7ssi'n holder. .n t'e ne6t s!reen* you
!an now ass&4n yourself as user BC620-nn of t'e or4an&Aat&onal un&t. C'oose Sa"e.
>C? SA$ A% BC620 <4
*n$t Dorkflo2 and IDocs
To#$c :ot$f$cat$on conce#t
As a mem#er of t'e 0-, proOe!t team* you w&s' to test w'et'er
not&f&!at&ons a#out errors &n t'e !ontrol &nformat&on for &n#oun
pro!ess&n4 are sent to your or4an&Aat&onal un&t 500<0<20 >0-,
epartment?.
2:< /'&s e6er!&se !ont&nues from e6er!&se 3 &n t'e un&t @A $ro!ess C'a&n@ >out#oun orer
a!"nowle4ment?. ,n t'&s e6er!&se* a f&le was !reate &n w'&!' t'e ata &s !orre!t #ut
t'e !ontrol re!or &s &n!orre!t. /'&s out#oun f&le &s to #e mo&f&e to an &n!orre!t
&n#oun f&le.
2:2 C'oose #est Inbound Processin' 0odified 4utbound 2ile from t'e &n&t&al noe of
t'e ,-o! ,nterfa!e. /'&s transa!t&on allows you to !'an4e t'e !ontrol re!or so &t &s
!orre!t an mat!'es t'e partner prof&le you ma&nta&ne &n t'e e6er!&se @partner prof&les@
for your (enor /:B,2nn. =owe(er* you s'oul &ntent&onally ma"e one m&sta"e so t'at
a not&f&!at&on &s 4enerate.
2:3 /'e sener &s (enor /:B,2nn/ from w'om you w&s' to re!e&(e t'e sales orers. 0nter
T-BI6nn as t'e partner num#er. Bou s'oul &ntent&onally ma"e one error &n t'e partner
type an enter *S >&nstea of 6I?. /'&s results &n no partner prof&le #e&n4 foun an t'e
,-o! am&n&strator &s not&f&e. But t'&s &s t'e or4an&Aat&onal un&t 500<0<20.
2:4 Bou must st&ll enter 6; as t'e partner fun!t&on an +,D,SP for t'e lo4&!al messa4e.
C'oose )xecute.
2.5 Sele!t Inbox to &splay t'e &nte4rate &n#o6. 06e!ute t'e wor" &tem. 2oo" at t'e status
re!or an t'e lo44e lon4 te6t. A!!ess t'e !ontrol re!or (&a t'e tree &splay for t'e
,-o!. ,f you use !'an4e moe 'ere* you !an !'an4e t'e partner type to 6I. After you
'a(e sa(e your entr&es an 4one #a!" to t'e pre(&ous s!reen (&a t'e 93 "ey* you !an
!'oose )dit Process 9ack'round Processin' to !ont&nue &n#oun pro!ess&n4.
2.6 Bou !an &splay t'e result&n4 ,-o!s (&a isplay Ioc or Ioc 1ists >sele!t w&t' t'e
partner num#er?. .ne ,-o! was 4enerate as a result of t'e test* t'e ot'er was
4enerate as a !opy of t'e or&4&nal ,-o! &mme&ately #efore t'e or&4&nal was mo&f&e.
nn is the nu$/er o" our e6ercise grou+ 0"ro$ 1 to 151
>C? SA$ A% BC620 <5
/-
SAP AG 1999
9ing an <DI S$%yte&
Con!erting to another tan"ar"
0e5$ire" "ata in control recor"
8ore "oc$&entation
>C? SA$ A% BC620 <
14.2
SAP AG 1999
9ing an <DI S$%yte&1 9nit 7%6ecti!e
At the concl$ion of thi $nit4 yo$ 'ill
%e a%le to1
0ecogniHe the ta2 of the <DI $%yte&
Decri%e the "ifference %et'een re5$ire" fiel" an"
optional fiel" in control recor"
9n"ertan" the "ifferent 'ay to infor& the <DI
$%yte& a%o$t !ario$ IDoc for&at
>C? SA$ A% BC620 2
14.3
SAP AG 1999
7!er!ie' Diagra& (0ecei!ing Data)
R/3 Sste$ R/3 Sste$
Sen! !ata to
R/3 Sste$
'hec- +ort 9 +artner8
generate IDoc
Post !ocu$ent
.rror han!ling
Docu$entation
Tools
Docu$entation
Tools
<DI S$%yte&>
<DI S$%yte&>
Port De"inition8
Partner Pro"iles
Port De"inition8
Partner Pro"iles Archi*e IDoc7
Archi*e IDoc7
3u&!"-el&(er must !onf&4ure t'e ,-o! ,nterfa!e for &n#oun pro!ess&n4:
3u&!"-el&(er !onne!ts t'e &DI s!"system an enters t'e &nformat&on a#out w'&!' ata &s to #e sent.
/'e format ef&n&t&ons for t'e &n#oun ,-o!s !an #e ef&ne #y t'e su#system. /'e R53 System &s
&nforme t'at t'e su#system &s a port.
>C? SA$ A% BC620 3
14.4
SAP AG 1999
B$ine Scenario
reponi%le for config$ring the IDoc interface.
Ao$ 'ih to connect yo$r <DI $%yte&. Ao$ &$t
fin" o$t a%o$t the 'or2 in!ol!e" in config$ring the
$%yte& %efore carrying o$t the 'or2.
>C? SA$ A% BC620 4
14.5
SAP AG 1999
<DI S$%yte&1 0eponi%ilitie
Tranlator
8eage han"ling
Co&&$nication
Archi!ing
8onitoring A""ree
Partner profile
/'e most &mportant tas" of t'e 0-, su#system &s !on(ert&n4 to or from t'e reDu&re 0-, stanarR
/'&s tas" &s !arr&e out #y t'e translator as a su#fun!t&on of t'e 0-, su#system. /'e &n&(&ual
!r&ter&a* for e6ample sele!t&n4 an ass&4n&n4 f&els* are mapp&n4 !omponents >usually !ustomer:
spe!&f&!?.
9urt'er pro!ess&n4* message handl$ng* &s &(&e &nto out#oun pro!ess&n4* &n#oun pro!ess&n4 an
status !onf&rmat&on. ,n out#oun pro!ess&n4* t'e messa4es transferre from t'e translator are
!om#&ne &n transm&ss&on f&les. ,n t'e !ase of &n#oun pro!ess&n4* t'e messa4es are separate from
t'e transm&ss&on f&les an sent to t'e translator. Status !onf&rmat&ons epen on t'e sele!te 0-,
stanar: 9or e6ample* stanar ANS, 1.<2 uses fun!t&onal an &nter!'an4e a!"nowle4ments to
!onf&rm su!!essful ata transfer #etween 0-, systems.
$'ys&!al ata transfer ta"es pla!e us&n4 t'e comm!n$cat$on mod!le of t'e 0-, su#system. /'&s also
&n!lues t'e &mplementat&on of t'e !ommun&!at&on proto!ols* for e6ample 1.25 an 1.400. /'e
!ommun&!at&on moule &s often prou!e #y a &fferent suppl&er.
Partner #rof$les !onta&n t'e &n&(&ual sett&n4s for a partner an a pro!ess* for e6ample mapp&n4.
/'e addresses are reDu&re #y t'e !ommun&!at&on moule.
Arch$%$ng ta"es pla!e &n a!!oran!e w&t' (ar&ous laws an &re!t&(es. /'ese &n!lue t'e 4u&el&nes
la& own #y t'e rele(ant ta6 aut'or&t&es.
+'en 0-, pro!esses are #e&n4 mon$tored* !erta&n statuses are e6pe!te to #e sent to t'e R53 System
as referen!e po&nts to ensure &nte4rat&on w&t' t'e appl&!at&ons.
>C? SA$ A% BC620 5
14.6
SAP AG 1999
0e5$ire" :iel" in IDoc In%. Proceing1 Control
0ecor"
IDoc
control recor"
In%o$n"
Proceing
(partner
profile)
Partner <essage Test7
0Bu$/er8 t+e8 "unction1 0T+e8 co!e8 "unction1
Partner <essage Test7
Proce co"eP In%o$n" proceing 'ith A+<>P
Per&itte" agentP An" o on.
,n &n#oun pro!ess&n4* t'e ,-o! ,nterfa!e ass&4ns t'e "ey f&els from t'e partner prof&les to f&els &n
t'e !ontrol re!or. /'e (alues of ot'er f&els are !'e!"e e6pl&!&tly &n t'e !o&n4.
As a result* an 0-, su#system must sen !erta&n f&els w&t' t'e&r (alues for ,-o! &n#oun
pro!ess&n4:
$artner* messa4e >t'ree f&els ea!'? an test fla4 >< f&el? must !orrespon to t'e entr&es &n t'e
partner prof&le. /'&s also means t'at t'e partner fun!t&on (alue* for e6ample* must #e left empty &f
t'e !orrespon&n4 f&el &n t'e partner prof&le &s also empty.
-&re!t&on H 2 >&n#oun?* stru!ture H 0-,I-C40 >e6ternal !ontrol re!or stru!ture &n Release 4.0?.
An R53 System >Release 3.6? woul e6pe!t a &fferent stru!ture.
Sener port an re!&p&ent port
,-o! type. /'e ,-o! ,nterfa!e !'e!"s w'et'er t'e ,-o! type &s ass&4ne to t'e messa4e
>ass&4nments !an #e ma&nta&ne from t'e &n&t&al noe #y sele!t&n4 De+elo'ment :K IDoc
ty'e5message?.
Spe!&al reDu&rements !an reDu&re a&t&onal f&els:
>Customer:? e6tens&on. >see !ourse BC62< for more &nformat&on?
2o4&!al aress of sener5re!&p&ent for automat&! forwar&n4
/'e ,-o! ,nterfa!e enters (alues for empty opt&onal f&els an !'e!"s t'e (alues* w'&!' !an lea to
an error &f t'e wron4 (alue &s foun.
A !omplete l&st of f&els !an #e foun &n t'e appen&6.
>C? SA$ A% BC620 6
14.7
SAP AG 1999
8ore Doc$&entation
Begin
G
<n"
type"ef tr$ct H2inco"(000
G
H2inco"(000
IDoc Interface1 Doc$&entation Tool
I8+
/'e 0-, su#system !an use a parser w'&!' @unerstans@ t'e appropr&ate output format for t'e ,-o!
,nterfa!e. /'&s means t'at t'e e6ternal formats >re!or types an ,-o! types? !an #e re!o4n&Ae #y
ot'er systems.
C:'eaers fulf&ll t'e same purpose: /'ey !an #e &n!lue &n t'e !orrespon&n4 C:pro4rams &n t'e
0-, su#system.
/'ere are also @meta:,-o!s@: /'ese are two spe!&al ,-o! types w'&!' es!r&#e t'e e6ternal formats
&n t'e&r ata re!ors: /'e types are !alle
SB,-.C0< : !onta&ns t'e format ef&n&t&on of an ,-o! type >t'at &s re!or types an se4ments?
SBR0C-0< : !onta&ns t'e format ef&n&t&ons of ,-o! re!or types:
,t &s !on!e&(a#le* for e6ample* t'at an 0-, su#system only re!o4n&Aes re!or types from releases
2.1 an 3.1 >t'at &s* @(ers&onsM < an 2?. ;s&n4 SBR0C-0< >re!or type (ers&ons < or 2?* t'e new
re!or types for Release 4.0 >(ers&on 3? !an #e sent to t'e 0-, su#system.
Metaata !an also #e output for 1M2 ,-o!s.
>C? SA$ A% BC620 C
14.8
SAP AG 1999
The <DI $%yte& i $e" &ainly for con!erting
the IDoc for&at into an <DI tan"ar" (an" !ice
!era).
The <DI $%yte& i an interface to e(ternal
yte& an" ha it o'n reponi%ilitie.
:or&at "efinition can %e "efine" in the <DI
$%yte& in a for& 'hich can %e rea" %y other
yte&.
9ing an <DI S$%yte&1 S$&&ary
>C? SA$ A% BC620 E
14.90sin& an EDI Su$s*stem Exercise
*n$t *s$ng an &DI S!"system
To#$c <ore Doc!mentat$on
Sen a meta:,-o!
As a mem#er of t'e 0-, proOe!t team for your !ompany* you reDu&re
&nformat&on on ,-o! type .R-0RS0< for two reasons:
<. /o prepare for a proOe!t &s!uss&on a#out Lpur!'ase orer5orer (&a
0-,M.
2. /o &nform your 0-, su#system pro(&er of t'&s ata stru!ture.
<:< A ma!'&ne:reaa#le format s'oul #e 4enerate for your su#system pro(&er. Bou
e!&e to transfer t'e &nformat&on on ,-o! type .R-0RS0< w&t' t'e a& of t'e
#ransport Ioc. A partner prof&le w&t' partner type 6S an partner num#er
ID0C6:T=00 alreay e6&sts an !an #e use &n t'&s e6er!&se.
Note own t'e num#er of t'e ,-o! 4enerate.
<:2 C'oose Ioc isplay Ioc or Ioc Ioc lists from t'e &n&t&al noe of t'e
,-o! &nterfa!e to (&ew t'e ,-o! w'&!' you 'a(e !reate. Sear!' for @your@ ,-o!
num#er.
>C? SA$ A% BC620 8
/*
SAP AG 1999
Archi!ing
Archi!ing o%6ect ID7C
Stat$ tranfer
Archi!ing tat$
>C? SA$ A% BC620 <
15.2
SAP AG 1999
Archi!ing1 9nit 7%6ecti!e
Archi!e IDoc
Decri%e a tat$ tranfer
Config$re the archi!ing tat$ in the yte&
>C? SA$ A% BC620 2
15.3
SAP AG 1999
R/3 Sste$ R/3 Sste$
Post !ocu$ent
Generate IDoc
Trans"er !ata8
+rocess "urther
Archi!e IDoc>
Archi!e IDoc>
.DI Su/sste$7
.DI Su/sste$7
Docu$entation
Tools
Docu$entation
Tools
Partner Pro"iles
Partner Pro"iles
Port De"inition
Port De"inition
SmartMart must !onf&4ure t'e ,-o! &nterfa!e for out#oun pro!ess&n4:

+'en !ommun&!at&on w&t' 3u&!"-el&(er 'as #een teste su!!essfully* SmartMart w&s'es to
eterm&ne w'&!' statuses are su&ta#le for ar!'&(&n4 an !an t'en #e elete from t'e system.
>C? SA$ A% BC620 3
15.4
SAP AG 1999
Archi!ing1 B$ine Scenario
;hen the %$ine proce ha %een co&plete"4 the
procee" IDoc ho$l" %e "elete" fro& the
"ata%ae.
Bo'e!er4 yo$ &$t archi!e the rele!ant IDoc %efore
they are "elete". The IDoc &$t therefore %e
aigne" an archi!ing tat$. ;hen config$ring the
IDoc Interface4 yo$ can "eter&ine 'hich tat$e can
%e archi!e".
>C? SA$ A% BC620 4
15.5
SAP AG 1999
Archi!ing 7%6ect1 ID7C
:ile Syte&
Archi*ing Archi*ing
+rogra$s +rogra$s
Possi/le Possi/le
Storage Storage
IDoc Interface
,-o!s w'&!' !an #e ar!'&(e are !op&e from t'e R53 ata#ase to one or more ar!'&(e f&les &n a f&le
system >at operat&n4 system le(el? (&a t'e ar!'&(&n4 pro4rams &n t'e ,-o! ,nterfa!e. Sett&n4s &n A-N
Custom&A&n4 >Ar!'&(e -e(elopment N&t* en'an!e fun!t&on #u&ler appl&!at&on? eterm&ne w'et'er
t'e ,-o!s are e6porte to an e6ternal stora4e me&um >opt&!al &s"* for e6ample?.
,n a se!on* separate step* all ,-o!s w'&!' 'a(e #een ar!'&(e !an #e elete from t'e R53 ata#ase.
/'e ar!'&(&n4 pro4rams &n t'e ,-o! ,nterfa!e are !alle (&a t'e !entral ar!'&(&n4 transa!t&on
>SARA?. /'&s transa!t&on pro(&es you w&t' t'e ar!'&(&n4 o#Oe!t ,-.C. As a result* you !an see
w'&!' pro4rams you 'a(e to !all. A messa4e an t&me per&o are entere as @(ar&ants@ for t'e
pro4rams >reports?* an ef&ne w'en t'e ,-o!s are 4enerate. /'e pro4rams !'e!" w'et'er t'e
!urrent status !an #e ar!'&(e.
/'e elet&on Oo# com#letes an ar!'&(&n4 run. A !omplete ar!'&(&n4 run t'erefore mo(es t'e ,-o!s to
an e6ternal stora4e me&um an eletes t'e ,-o! from t'e ata#ase.
>C? SA$ A% BC620 5
15.6
SAP AG 1999
Stat$ Tranfer in 7$t%o$n" Proceing
Selecte" tat$e can %e
archi!e"
in the tan"ar" yte&
-2
,L
2)
26
02
20
,/
0/ ,)
/M
0,
,0
2*
-/ -0 /2
/0
0M
06
2-
22
0-
//
0)
0L
0*
/6
/- /*
/L
Statuses !an only #e ass&4ne to an ,-o! &n ef&ne !om#&nat&ons. /'&s sl&e &llustrates
t'e perm&tte !om#&nat&ons for out#oun pro!ess&n4: /'e follow&n4 mean:
0< ,-o! 4enerate
02 0rror w'&le sen&n4 ata to port
03 -ata transfer to port .N
04 0rror &n 0-, su#system !ontrol &nformat&on
05 0rror ur&n4 !on(ers&on
06 Con(ers&on .N
0C Synta6 error &n 0-, messa4e
0E Synta6 !'e!" .N
08 0rror &n &nter!'an4e 'anl&n4
<0 ,nter!'an4e 'anl&n4 .N
<< 0rror w'&le sen&n4
<2 Sen .N
<4 ,nter!'. A!"nowle4ment pos&t&(e >0-,:Su#system?
<5 ,nter!'. A!"nowle4ment ne4at&(e >0-, su#system?
<6 9un!t. A!"nowle4ment pos&t&(e >0-, su#system?
<C 9un!t. A!"nowle4ment ne4at&(e >0-, su#system?
<E 0-, su#system tr&44ere .N
20 0rror w'&le tr&44er&n4
22 Sen .N* st&ll wa&t&n4 for a!"nowle4ment >0-, su#system?
24 0-, su#system !ontrol &nformat&on .N >0-, su#system?
25 9urt'er pro!ess&n4 esp&te synta6 error
26 Synta6 error &n ,-o!
28 0rror &n A20 ser(&!es
30 ,-o! &s reay for &spat!' >A20 ser(&!es?
3< 0rror* no furt'er pro!ess&n4 >elet&on fla4?
35 ,-o! retr&e(e from ar!'&(e
>C? SA$ A% BC620 6
3C ,-o! ae w&t' error <
38 ,-o! &n tar4et system >A20 ser(&!es?
40 Appl&!at&on o!ument not !reate &n tar4et system
4< Appl&!at&on o!ument !reate &n tar4et system
42 ,-o! from test transa!t&on
>C? SA$ A% BC620 C
15.7
SAP AG 1999
Stat$ Tranfer in In%o$n" Proceing
6M
L/
6/
*0 *,
*2
62 6-
L, 6) L0
60
6*
*6
*/
6,
*- *L
Selecte" tat$e can %e archi!e" in the SAP
tan"ar" yte&
66
L-
/'e perm&tte status !om#&nat&ons for &n#oun pro!ess&n4 are &splaye a#o(e. 50 ,-o! ae
5< Appl&!at&on o!ument not poste
52 ,n!omplete appl&!at&on o!ument poste
53 Appl&!at&on o!ument poste
54 0rror ur&n4 formal appl&!at&on !'e!"
56 ,n!orre!t ,-o! ae
5C /est ,-o!: 0rror ur&n4 appl&!at&on !'e!"
60 Synta6 error &n ,-o!
6< 9urt'er pro!ess&n4 esp&te synta6 error
62 ,-o! sent to appl&!at&on
63 0rror w'&le sen&n4 ,-o! to appl&!at&on
64 ,-o! &s reay to #e sent to appl&!at&on
65 0rror &n A20 ser(&!es
66 ,-o! wa&t&n4 for pree!essor >ser&al&Aat&on?
6E 0rror* no furt'er pro!ess&n4 >elet&on fla4?
68 ,-o! e&te
C0 .r&4&nal (ers&on of e&te ,-o!
C< ,-o! retr&e(e from ar!'&(e
C3 ,-o! ar!'&(e
C4 ,-o! !reate from test transa!t&on
>C? SA$ A% BC620 E
15.8
SAP AG 1999
Stat$ 8aintenance - Archi!ing
IDoc tat$ ..
Decription ...
Proceing
Direction .
Proceing layer .
<ffect
=$alification .
Archi!ing
poi%le
e(cl$"e"
9rom t'e &n&t&al noe of t'e ,-o! ,nterfa!e* sele!t Control :K )tatus maintenance >transa!t&on +04C?
to !'an4e t'e attr&#utes of an &n&(&ual status. An e6ample of an attr&#ute &s w'et'er or not
ar!'&(&n4 &s perm&tte.
/'&s transa!t&on !an also #e use to f&n out 4eneral &nformat&on a#out a !erta&n status.
>C? SA$ A% BC620 8
15.9
SAP AG 1999
Archi!ing1 S$&&ary
All archi!ing progra& are a""ree" !ia the central
archi!ing tranaction SA0A. The archi!ing o%6ect i
ID7C.
IDoc can only %e "elete" if they ha!e %een archi!e".
The archi!ing r$n &$t %e co&plete.
IDoc can only %e archi!e" if they ha!e %een
aigne" a tat$ 'hich can %e archi!e". The
tat$e $ita%le for archi!ing can %e config$re" in
the IDoc interface.
>C? SA$ A% BC620 <0
15.10
SAP AG 1999
Co$re S$&&ary
SAP Application
<(ternal Syte& / <(ternal Syte& 2
/'e ,-o! ,nterfa!e allows t'e e6!'an4e of #us&ness ata #etween SA$ appl&!at&ons an e6ternal
systems. /'e formats use for transm&tt&n4 ata >,-o! types? are o!umente.
,-o!s are e6!'an4e w&t' e6ternal systems on a partner:spe!&f&! an messa4e:spe!&f&! #as&s. ,-o!
ata flow &s t'erefore ef&ne (&a t'e partner prof&les an t'e port ef&n&t&ons.
,n out#oun pro!ess&n4* ,-o!s !an #e !olle!te &n a 4roup or sent to t'e e6ternal system
&mme&ately.
,n &n#oun pro!ess&n4* ,-o!s !an #e pro!esse (&a wor"flow.
06!ept&on 'anl&n4 for &n!orre!t ,-o!s always ta"es pla!e (&a wor"flow.
Mon&tor&n4 pro4rams an stat&st&!s pro4rams are a(a&la#le for t'e ,-o! ata flow. A!t&(e mon&tor&n4
!an #e use to automat&!ally not&fy t'e a4ent respons&#le.
,-o!s w'&!' 'a(e #een pro!esse !ompletely !an #e ar!'&(e.
,f t'e ,-o! types &n t'e stanar system o not meet your reDu&rements* you !an a upwarly:
!ompat&#le e6tens&ons or ef&ne your own ,-o! types. /'&s &s t'e su#Oe!t of !ourse BC62<.
>C? SA$ A% BC620 <<
/6
SAP AG 1999
Appen"i(
Thi ection contain $pple&entary
&aterial to %e $e" for reference
Thi &aterial i not part of the tan"ar" co$re
Therefore4 the intr$ctor &ight not co!er thi
"$ring the co$re preentation
>C? SA$ A% BC620 <
16.23))en%ix
5lossary
16.33ccess se:uence Se:uence use% $* 'essa&e (ontrol to
access con%ition recor%s 9-en searc-in& !or messa&es.
A!!ess An a!!ess &ent&f&es t'e o!ument f&els use #y t'e system
w'en sear!'&n4 for a !on&t&on re!or.
Bas&! type ,-o! type suppl&e #y SA$. Bas&! types !an #e mo&f&e #y
!ustomers to !reate a new* upwar:!ompat&#le ,-o! type.
16.4(on%ition com)onent Part o! t-e -ierarc-* 9-ic- is examine%
9-en searc-in& !or a messa&e. Exam)le. t-e messa&e t*)e 9-ic- is
at t-e to) o! t-e -ierarc-*. 9-en a ;ne9< )urc-ase or%er is )oste%2
onl* t-e messa&es un%er t-e no%e !or messa&e t*)e =E1 are
searc-e%.
Con&t&on re!or -ata re!or &n w'&!' t'e "ey f&els represent t'e !on&t&on uner
w'&!' t'e messa4e &s @foun@. /'e rema&n&n4 f&els es!r&#e t'e
messa4e &tself. /'erefore* &f one of t'e ata re!ors transferre
from t'e appl&!at&on mat!'es t'ese "ey f&els* t'e messa4e &s
foun an !an #e pro!esse >e.4. e6porte as a pr&nt form or as
an ele!tron&! messa4e.
Control re!or /'e part of an ,-o! w'&!' !onta&ns t'e ata for &ent&fy&n4 t'e
sener an re!&p&ent* as well as t'e stru!ture of t'e ,-o! &tself.
0a!' ,-o! always 'as one !ontrol re!or.
-ata re!or /'e part of an ,-o! w'&!' !onta&ns t'e appl&!at&on ata. An
,-o! usually !onta&ns more t'an one ata re!or.
0-, H 0le!tron&! -ata ,nter!'an4e >e.4. o!uments? #etween #us&ness
partners* somet&mes &n separate !ountr&es* w'o may use &fferent
'arware* software an !ommun&!at&on ser(&!es. /'e ata &s
formatte a!!or&n4 to spe!&f&! stanars.
>C? SA$ A% BC620 2
16.5EDI messa&e Stan%ar% !ormat !or a $usiness )rocess ;!or
exam)le2 a )urc-ase or%er< to $e -an%le% $* EDI. >arious EDI
stan%ar%s ;EDI,3( or 3=SI 412< can %e!ine %i!!erent EDI messa&es
!or t-e same $usiness )rocess.
16.6EDI stan%ar% "eneral !ormat !or %ata to $e trans!erre%
electronicall*.
3n EDI stan%ar% &enerall* com)rises.
EDI s*ntax
Data element ser/ice
'essa&e t*)e ser/ice
-e S3P stan%ar% ?IDoc? is not *et an EDI stan%ar%2 $ut can $e
com)are% to ot-er EDI stan%ar%s.
16.7EDI su$s*stem S*stem 9-ic- con/erts t-e S3P stan%ar% IDoc
into an EDI stan%ar% ;e.&. EDI,3(2 3=SI 412< an% /ice /ersa. In
a%%ition to t-is tas6 ;9-ic- is carrie% out $* t-e EDI su$s*stem
con/erter<2 t-ere are also a%ministration acti/ities2 e.&. arc-i/in& t-e
trans!erre% messa&es2 an% tec-nical tas6s2 e.&. tec-nical
connection to t-e su$se:uent s*stem an% s*ntax c-ec6s !or
!ormats2 to $e consi%ere%.
9&el !atalo4 Conta&ns all f&els w'&!' !an #e sele!te as "ey f&els for
!on&t&on ta#les &n Messa4e Control.
9&le &nterfa!e H port type L9&leM
=&erar!'y le(el -eterm&nes t'e pos&t&on of a se4ment &n a tree stru!ture. A
se4ment !arr&es #us&ness ata &n an ,-o!. -epenen!&es &n t'e
appl&!at&on ata !an #e represente &n t'&s tree stru!ture* &.e. t'e
(ar&ous '&erar!'y le(els.
,-o! ,nterfa!e -ef&n&t&on of ,-o! types an ata &nter!'an4e met'os >port
ef&n&t&ons? #etween SA$ Systems an partner systems.
,-o! type SA$ format &n w'&!' t'e ata for #us&ness pro!ess &s to #e sent.
An ,-o! &s a real #us&ness pro!ess* formatte a!!or&n4 to a
!erta&n ,-o! type.
,n#oun pro!ess&n4 Con(ers&on an pro!ess&n4 of ata for a #us&ness pro!ess from
t'e t&me t'e ata &s re!e&(e &n ,-o! format to t'e post&n4 of t'e
!orrespon&n4 o!ument>s? &n t'e SA$ appl&!at&on.
Mapp&n4 Rules for ass&4n&n4 t'e ata elements of an 0-, messa4e type to
t'e f&els of an ,-o! type.
Messa4e Control Moule es&4ne to offer &nterfa!es for furt'er pro!ess&n4 for
appl&!at&ons. /'&s &n!lues es!r&pt&ons of t'e (ar&ous ata
!onf&4urat&ons an t'e reDu&re a!t&ons. An e6ample of an a!t&on
&s pr&nt&n4 a o!ument at a !erta&n t&me &n %erman. /'e a!t&on &s
tr&44ere w'en t'e appl&!at&on transfers ata w'&!' mat!'es your
!onf&4urat&on.
>C? SA$ A% BC620 3
16.8'essa&e %etermination 3 c-ec6 to %etermine 9-et-er t-e
a))lication %ata matc-es t-e con%ition recor%s ;s)eci!ie% in
(ustomi5in&<@. I! t-is is t-e case2 one or more messa&es are @!oun%@
an% can t-en $e )rocesse% ;e.&. sent electronicall*<.
In messa&e %etermination2 a searc- is ma%e !or t-e con%ition
recor%s usin& a )re%e!ine% -ierarc-*.
16.9'essa&e status recor%A '( recor%. Bo& recor% !or t-e '( ta$le
9-ic- %escri$es t-e sen% status o! a messa&e in 'essa&e (ontrol.
Messa4e Bus&ness pro!ess >for e6ample* a pur!'ase orer?* w'&!' &s
transferre &n ,-o!:9ormat #etween an SA$ System an an
e6ternal system.
Not&f&!at&on ,f an error o!!urs >for e6ample* an ,-o! w&t' &n!orre!t synta6?* a
not&f&!at&on &s sent to one or more users. /'e users respons&#le
are ef&ne &n t'e ,-o! ,nterfa!e or &n&re!tly (&a t'e
or4an&Aat&on moel >$-:.R%?. Not&f&!at&ons are sent to t'e
&nte4rate &n#o6.
.pt&onal se4ment $art of an ,-o! type >stanar format for ata !ommun&!at&on?*
w'&!' !an &n!lue a&t&onal* opt&onal ata a#out t'e #us&ness
pro!ess. /'e se4ment oes not t'erefore 'a(e to appear &n an
,-o! for a spe!&f&! #us&ness pro!ess.
.ut#oun f&le Conta&ns !erta&n ,-o!s to #e sent for port type L9&leM.
.ut#oun pro!ess&n4 Con(ers&on an pro!ess&n4 of SA$ o!ument ata from post&n4 a
o!ument to sen&n4 t'e ata &n ,-o! format.
$artner prof&le -ef&n&t&on of t'e 4eneral !on&t&ons for ele!tron&! ata
&nter!'an4e w&t' a #us&ness partner (&a t'e ,-o! ,nterfa!e: w'&!'
messa4e &s sent &n w'&!' &re!t&on us&n4 w'&!' met'oU
,f a partner prof&le oes not e6&st* !ommun&!at&on w&t' a partner
(&a t'e ,-o! ,nterfa!e &s not poss&#le.
16.10Partner (ommunication )artner !or t-e IDoc Inter!ace.
De!inition !rom SD. C3n in%i/i%ual 9it-in or outsi%e o! *our o9n
or&ani5ation 9-o is o! commercial interest an% 9-o can $e
contacte% in t-e course o! a $usiness transaction.D
$ort -es!r&pt&on of t'e !'annel use #y t'e SA$ system for
!ommun&!at&n4 w&t' t'e e6ternal system ur&n4 ele!tron&! ata
&nter!'an4e. /'ere are (ar&ous te!'n&!al met'os for
&mplement&n4 t'&s type of !ommun&!at&on >port types?. /'e
sele!t&on of t'e port type epens on t'e te!'n&!al !onf&4urat&on
of t'e e6ternal system. 06ample: most 0-, su#systems rea
,-o!s &n t'e form of seDuent&al f&les* &.e. t'e port type G9&leG &s
use.
$ro!ess !oe Anot'er name for a ef&ne pro!ess&n4 type* e.4. a fun!t&on
moule or an SA$ Bus&ness +or"flow tas". ,n !ontrast* a
ef&ne ,-o! type >stanar format for ata !ommun&!at&on? &s
usually ass&4ne to a !erta&n pro!ess !oe. ,f t'e pro!ess&n4 type
for t'&s ,-o! type &s to #e !'an4e* you s'oul ass&4n t'e
!orrespon&n4 pro!ess !oe to t'e new pro!ess&n4 type. +&t'out
t'e pro!ess !oe* t'&s ,-o! type must #e ass&4ne to t'e new
pro!ess&n4 type &re!tly.
>C? SA$ A% BC620 4
Re!or type An ,-o! type !ons&sts of t'e follow&n4 t'ree re!or types:
: Control re!or
: -ata re!or
: Status re!or
ReDu&re se4ment /'e part of an ,-o! type w'&!' !onta&ns &mportant appl&!at&on
ata an must t'erefore e6&st &n an ,-o! for an a!tual #us&ness
pro!ess.
16.11Sc-ema 3 &rou) o! messa&es. 3 sc-ema is searc-e% !or
messa&es 9-ic- are to $e )rocesse% !or t-e s)eci!ie% %ata
con!i&uration ;e.&. sent electronicall* or )rinte%<.
Se4ment Stru!ture w'&!' &n!lues t'e appl&!at&on ata for an ,-o! from
t'e ata re!ors. As a result* t'e ata !an #e ass&4ne to t'e
!orre!t appl&!at&on f&els.
16.12Status Processin& status o! an IDoc ;S3P stan%ar% !ormat
!or electronic %ata interc-an&e<2 !or exam)le. @&enerate%@ or @rea%*
!or sen%in&@.
3n IDoc -as usuall* -a% se/eral statuses2 9-ic- are store% in t-e
status recor%s an% re/eal in!ormation a$out t-e IDoc -istor*. -e
current ;)rocessin&< status is also store% in t-e control recor% !or
t-e IDoc.
16.13Status con!irmation +e)ort !rom an external s*stem a$out t-e
)rocessin& status o! $usiness %ata recei/e% !rom t-e +83 S*stem in
IDoc !ormat. -e status con!irmation is a%%e% to t-e IDoc in t-e +83
S*stem in t-e !orm o! status recor%s.
Status f&le 9&le w'&!' !onta&ns t'e status re!ors sent to t'e ,-o! ,nterfa!e
#y t'e 0-, su#system for out#oun messa4es.
Status 4roup /'e status 4roup !onta&ns se(eral statuses >@m&lestones@ &n t'e
pro!ess !'a&n?* so t'at t'e mon&tor&n4 pro4rams only 'a(e to
!ons&er t'ese 4roups an not ea!' &n&(&ual status. 06amples:
%roup 3 H out#oun: ,-o! &n t'e e6ternal system
%roup B H &n#oun: ,-o! sent to appl&!at&on
Status re!or .ne of t'e t'ree re!or types &n an ,-o! >SA$ stanar format
for ele!tron&! e6!'an4e of appl&!at&on ata?.
0a!' status re!or !onta&ns a status w'&!' !orrespons to one
step &n ,-o! pro!ess&n4. /'&s means t'at t'e num#er of status
re!ors &n!reases as t'e pro!ess&n4 !ont&nues.
/ranslator Con(erts &nternal ata formats >,-o!s? &nto 0-, messa4es an
(&!e (ersa. /'e translator &s a !omponent of t'e 0-, su#system.
/ransm&ss&on f&le A ata pa!"et w'&!' !onta&ns t'e messa4es to #e e6!'an4e
ele!tron&!ally. /'e messa4es are 0-, messa4es* &.e. t'ey are
formatte a!!or&n4 to an 0-, stanar >e.4. 0-,9AC/?.
/'e !on(ers&on of t'e SA$ stanar ,-o! &nto t'e 0-, stanar
&s !arr&e out #y an e6ternal system >0-,:su#system?.
>C? SA$ A% BC620 5
Im#ortant <en! Paths
Arch$%$ng
0ools Administration
Administration Data archi+ing
D$s#lay IDoc
,-o! &n&t&al s!reen:
IDoc Dis'lay IDoc
IDoc Adm$n$strat$on
Control IDoc Administration
IDoc $n$t$al screen
0ools #usiness Communication
17IDoc IDoc Basis
IDoc stat$st$cs
IDoc IDoc statistics
<a$nta$n$ng an ,;C dest$nat$on
IDoc RFC destination
<a$nta$n$ng arch$%$ng stat!s
Control )tatus maintenance
Partner #rof$le
IDoc (artner 'rofile
Port def$n$t$on
IDoc (ort definition
Process$ng tests
0est ,menu o'tion according to the re5uired function>
>C? SA$ A% BC620 6
,e>!$red ;$elds $n In"o!nd Process$ng (IDoc Control ,ecord)
/'e follow&n4 ta#les !onta&n t'e f&els from t'e ,-o! !ontrol re!or w'&!':
must always #e entere #y t'e e6ternal system &n stru!ture 0-,I-C40
must #e entere &n spe!&al !ases #y t'e e6ternal system &n stru!ture 0-,I-C40
may #e entere #y t'e e6ternal system &n stru!ture 0-,I-C40 >opt&onal f&els?. ,f t'e
(alues are entere* t'ey are !'e!"e #y t'e ,-o! ,nterfa!e.
;$elds 2h$ch m!st al2ays "e entered "y the e1ternal system
;$eld Descr$#t$on
/ABNAM Re!or type >stru!ture?: H L0-,-CI40M for ,-o!s to #e pro!esse &n Release 4.0.
-,R0C/ -&re!t&on: H L2M >&n#oun?.
,-.C/B$ Bas&! type.
M0S/B$ Messa4e type* e.4. .R-0RS. Ass&4ne to one or more ,-o! types &n t'e ,-o!
,nterfa!e.
SN-$.R Sener port. Must #e ef&ne as a port &n t'e re!e&(&n4 R53 System.
SN-$RN $artner num#er of t'e sener. Must !orrespon to a partner num#er from t'e
partner prof&les.
SN-$R/ $artner type of t'e sener. L2SM >lo4&!al system? &n A20 s!enar&os. ,n non:A20
s!enar&os* t'&s (alue &s usually LN;M >!ustomer? or L2,M >(enor?.
RC7$.R Re!e&(er port: H LSA$JSBS,-KM* w'ere JSBS,-K &s t'e ,- of t'e re!e&(&n4 R53
System* e.4. C<<.
RC7$RN $artner num#er of t'e re!&p&ent. ,n A20 s!enar&os* t'&s (alue &s
JSBS,-KC2N/JC2N/K* w'ere JC2N/K &s t'e !l&ent of t'e re!e&(&n4 R53
System an JSBS,-K &s ef&ne &n t'e f&el RC7$.R. ,n non:A20 s!enar&os*
t'&s (alue &s appl&!at&on:spe!&f&! >e.4. t'e (alue !an #e t'e or4an&Aat&on num#er?.
RC7$R/ $artner type of t'e re!&p&ent L2SM >lo4&!al system? &n A20 s!enar&os. ,n non:A20
s!enar&os* t'&s (alue &s appl&!at&on:spe!&f&! >e.4. LS-M for t'e S- moule?.
;$elds 2h$ch are entered $n s#ec$al cases
;$eld Descr$#t$on
C,M/B$ Customer e6tens&on to a #as&! type. Must #e present &n t'e !orrespon&n4 partner
prof&le.
M0S9C/ Messa4e fun!t&on for furt'er messa4e &(&s&on. Must #e present &n t'e
!orrespon&n4 partner prof&le.
M0SC.- Messa4e !oe for furt'er messa4e &(&s&on. Must #e present &n t'e !orrespon&n4
partner prof&le.
SN-$9C $artner fun!t&on for furt'er partner &(&s&on. Must #e present &n t'e !orrespon&n4
partner prof&le.
/0S/ /est fla4.
01$RSS 06press fla4: &f t'&s fla4 &s set* t'e A20 ser(&!es are !alle &mme&ately &n ,-o!
&n#oun pro!ess&n4.
+#t$onal f$elds
;$eld Descr$#t$on
MAN-/ Cl&ent &n t'e R53 System. An &n!orre!t entry !auses an error.
>C? SA$ A% BC620 C
-.CR02 R53 release (ers&on. An &n!orre!t entry !auses an error.
.;/M.- .ut#oun pro!ess&n4 moe >e.4. sen ,-o!s &n&(&ually* start su#system?. 0a!'
(alue &s o(erwr&tten &n &n#oun pro!ess&n4.
-.CN;M ,-o! ,-. As t'e &n#oun ,-o! &s 4enerate f&rst &n t'e ata#ase* ea!' (alue 'ere &s
o(erwr&tten #y t'e &nternal ,-o! ,-.
CR0-A/ -ate of ,-o! 4enerat&on. =anl&n4 as &n -.CN;M.
CR0/,M /&me of ,-o! 4enerat&on. =anl&n4 as &n -.CN;M.
>C? SA$ A% BC620 E
Ty#$cal com"$nat$ons of <C f$elds and f$elds from o!t"o!nd
#artner #rof$les
(rocess code an Message ty'e are f&els &n t'e ,-o! partner prof&les* all ot'er f&els #elon4 to
Messa4e Control >MC?:
$artner
fun!t&on
Appl&!at&on Messa4e
type
C'an4e Messa4e
!ate4ory
$ro!ess !oe
29 0A N0; R03./0 M0<2
29 09 N0; .R-0RS M0<0
29 09 N0; 1 .R-C=% M0<<
A% 7< AN00 3;./0S
A% 7< BA00 .R-RS$
+0 72 2A7A -0SA-7 S-05
+0 73 A;S< 01$,N7
R0 73 R-00 ,N7.,C S-08 >&n(o&!e?
>C? SA$ A% BC620 8
&1am#le Command f$le (Shellscr$#t) - +!t"o!nd
Note: &n t'&s e6ample* a ;N,1 operat&n4 system &s use.
VF5#&n5s'
-,R+.RNH5users5e&am
! W-,R+.RN
9,20HG#asename W<G
ate KK W-,R+.RN5e&am.tra!e
e!'o XX run e6ternal system w&t' f&le W9,20 KK W-,R+.RN5e&am.tra!e
F $nsert command to start &DI s!"system here
e!'o XX remo(e ,-o! f&le W9,20 from appl&!at&on ser(er KK W-,R+.RN5e&am.tra!e
!'mo 666 W-,R+.RN5e&am.tra!e
>C? SA$ A% BC620 <0
&1am#le Command f$le (Shellscr$#t) - In"o!nd
Note: &n t'&s e6ample* a ;N,1 operat&n4 system &s use.
VF5#&n5s'
-,R010CH5users5e&am5run
-,R+.RNH5users5e&am
! W-,R+.RN
ate KK W-,R+.RN5e&am.tra!e
e!'o XX start SA$ system w&t' f&le W< KK W-,R+.RN5e&am.tra!e
W-,R010C5startrf! :3 :t
: Jsystem ,-K :u JuserK :p JpassworK :! J!l&entK
:' Jrouter str&n4K :s Jsystem num#erK
:4 J4ateway ma!'&neK :6 J4ateway nameK
:9 0-,I-A/AI,NC.M,N%
:0 $A/=NAM0HW-,R+.RN5W<
:0 $.R/HJsu#systemK
!'mo 666 W-,R+.RN5e&am.tra!e
Note: t'e s!r&pt for stat!s f$les only &ffers from t'e s!r&pt for &n#oun ,-o!s #e!ause t'e
fun!t&on moule 0-,IS/A/;SI,NC.M,N% &s !alle.
>C? SA$ A% BC620 <<

Idoc Technology

Загружено:

Сведения о документе

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Idoc Technology

Загружено:

Авторское право:

Доступные форматы

BC620 - SAP IDoc Interface (Technology)

<DI74 <DII4 <DI#

SmartMart must !onf&4ure t'e ,-o! &nterfa!e for out#oun pro!ess&n4:

Вам также может понравиться