Practical Guide to IDoc Development for SAP

Sabine Maisel

Practical Guide to IDoc Development for SAP ®

www.sap-press.com

332 Book.indb 3

Bonn � Boston

11/3/09 10:21:31 AM

Contents at a Glance 1

Introduction  ................................................................. 15

2

Generating IDocs   ........................................................ 29

3

Test Tools  . .................................................................... 51

4

Changes to IDocs   ........................................................ 67

5

Confirmations  . ............................................................. 187

6

Serializing IDocs   . ........................................................ 193

7

Administration  ............................................................. 211

8 IDocs in Conjunction with SAP NetWeaver Process Integration  ...................................................... 243

www.sap-press.com

332 Book.indb 5

11/3/09 10:21:31 AM

Contents Preface  ......................................................................................... 11

1 Introduction  .................................................................. 15 1.1 1.2

1.3 1.4

What Is ALE?  ................................................................. BAPIs and IDocs — An Introduction  .............................. 1.2.1 BAPIs  ................................................................ 1.2.2 IDocs  ................................................................ Differentiation of ALE and EDI  ....................................... Summary  .......................................................................

15 18 18 19 25 27

2 Generating IDocs   ......................................................... 29 2.1

Standard Methods for the IDoc Generation  ................... 2.1.1 Shared Master Data Tool  ................................... 2.1.2 Message Control  ............................................... 2.1.3 Special Functions  .............................................. 2.2 Use of Logical Systems in the Message Control  .............. 2.3 Summary  .......................................................................

29 29 43 46 49 50

3 Test Tools  ...................................................................... 51 3.1 Individual IDocs  . ........................................................... 3.2 Testing Processing of Multiple IDocs   ............................. 3.2.1 Message Control  ............................................... 3.2.2 Sending Ready-for-Dispatch IDocs  .................... 3.2.3 Files  .................................................................. 3.3 Processing Status Files  ................................................... 3.4 Summary  .......................................................................

52 57 57 58 59 61 66

4 Changes to IDocs   . ....................................................... 67 4.1

Customizing  . ................................................................. 67 4.1.1 Filtering Using Filter Objects  ............................. 67

www.sap-press.com

332 Book.indb 7

7

11/3/09 10:21:31 AM



4.2

4.3 4.4

4.5

4.1.2 Custom Filter Objects  . ...................................... 4.1.3 Filtering Segments  . ........................................... 4.1.4 Reducing IDocs Through Views  ......................... 4.1.5 Rules  . ............................................................... 4.1.6 Version Conversion  ........................................... 4.1.7 Special Conversions in SAP ERP Financials  . ....... Adapting Existing IDoc Types  ......................................... 4.2.1 Different Exit Types on the Basis of the Material Master Example  .................................. 4.2.2 General Exits  ..................................................... 4.2.3 Custom Segments  . ............................................ 4.2.4 Special Requirements for Master Data  ............... Custom Function Modules for File Generation in File Ports  ................................................................... Custom IDocs   ............................................................... 4.4.1 Creating Custom IDoc Types and Message Types  .................................................. 4.4.2 Generating an IDoc  ........................................... 4.4.3 Updating an IDoc  .............................................. 4.4.4 Generating IDoc Function Modules  ................... 4.4.5 Error Workflow for Custom IDocs  . .................... 4.4.6 Useful Function Modules  .................................. Summary  .......................................................................

73 76 77 80 84 85 89 90 119 122 134 138 141 143 153 161 172 175 184 186

5 Confirmations  ............................................................... 187 5.1 “ALEAUD” IDocs  ........................................................... 187 5.2 “STATUS” IDocs  ............................................................. 190 5.3 Summary  ....................................................................... 192

6 Serializing IDocs   .......................................................... 193 6.1 6.2 6.3 6.4 6.5

8

332 Book.indb 8

Serialization Using Groups  ............................................. Serialization Using Timestamps  ...................................... Serialization Using Business Objects  . ............................. Serialization Using qRFC  ................................................ Summary  .......................................................................

193 198 200 205 209

www.sap-press.com

11/3/09 10:21:31 AM



7 Administration  .............................................................. 211 7.1 7.2 7.3 7.4 7.5 7.6

IDoc Links  ..................................................................... Regular Jobs  .................................................................. Transaction Code Overview  . .......................................... Archiving  ....................................................................... Status Conversion  .......................................................... Summary  .......................................................................

211 216 217 224 230 242

8 IDocs in Conjunction with SAP NetWeaver Process Integration  . ..................................................... 243 8.1 8.2 8.3 8.4 8.5 8.6

Conversion of Logical Systems to Business Systems  ........ Conversion of IDoc Partner Roles  . ................................. Header Mapping  . .......................................................... Handling the Control Record in SAP NetWeaver PI  ........ Updating IDocs Directly in SAP NetWeaver PI  ............... Summary  .......................................................................

243 244 245 246 248 248

The Author  ................................................................................... 249 Index.............................................................................................. 251

www.sap-press.com

332 Book.indb 9

9

11/3/09 10:21:31 AM

S a b in e M a i s e l

Practical Guide to IDoc Development for SAP'

Galileo Press

Preface

ID o c s r e p r e s e n t a s t a n d a r d i n t e r f a c e to SAP s y s t e m s . T h e y a r e a l w a y s a sy n c h ro n o u s, so th e sy stem sh o u ld b e d e sig n e d fo r ch a n g in g a n d creat­ in g d a t a in t h e d a t a b a s e . T h e e r r o r h a n d l i n g , w h i c h c a n b e c a r r i e d o u t w i t h a t i m e d e l a y in a s y n c h r o n o u s c o m m u n i c a t i o n , is a l w a y s h a n d l e d w h e r e t h e e r r o r o c c u r s — in c o n t r a s t t o t h e n o r m a l RFC c o m m u n i c a t i o n w h e r e t h e e r r o r is a l w a y s n o t i f i e d to t h e s e n d e r . A l t h o u g h m o r e r e c e n t SAP r e le a s e s a ls o h a v e o t h e r n o n - S A P - p r o p r i e t a r y c o m m u n i c a t i o n o p t i o n s (s u c h as SOAP, HTTP, a n d p r o x i e s ) , t h e i m p o r ­ t a n c e o f ID o c s is u n d i m i n i s h e d : T h i s is b e c a u s e o f t h e h i g h n u m b e r in w h i c h t h e y a r e a v a ila b le , a s w e ll as t h e m u l t i t u d e o f s o f t w a r e s o l u t i o n s t h a t w o r k w i t h SAP a n d a l r e a d y s u p p o r t t h i s f o r m a t . ID o c s a s s t a n d a r d i n t e r f a c e s t o SAP s y s t e m s a r e u s e d b o t h f o r EDI s c e n a r i o s b e t w e e n d i f ­ f e r e n t e n t e r p r i s e s a n d f o r ALE s c e n a r i o s w i t h i n e n t e r p r i s e s . L ike all s t a n d a r d i n t e r f a c e s , t h e ID o c s r e f e r to t h e p a r t o f t h e SAP s y s t e m t h a t is d e l i v e r e d b y SAP. In m o s t b u s i n e s s e s , h o w e v e r , i t's n e c e s s a r y to b r e a k a d a p t a t i o n s t h a t w e r e m a d e i n t h e b u s i n e s s p a r t o f t h e SAP s y s t e m d o w n t o t h e i n t e r f a c e s . T h i s t a s k is c a r r i e d o u t b y A B A P d e v e l o p e r s . This b o o k is p a r t i c u l a r l y i n t e n d e d f o r t h e m , a n d t h e ta s k s r e l a t i n g to t h e s e a d a p t a t i o n s a r e d i s c u s s e d in d e t a i l . T h e s y s t e m a d m i n i s t r a t o r s u s u a l l y h a n d le th e c o m m u n ic a tio n se ttin g s so th e se s ettin g s a r e o n ly m e n tio n e d i f th e y are d irec tly re la te d to th e d e v e lo p m e n t w o rk .

C o n te n t of T h is B o o k T h is b o o k d e s c r i b e s t h i n g s in t h e s e q u e n c e in w h i c h t h e y a p p e a r . It s ta rts w i t h t h e c r e a t i o n o f I D o c s a n d c o n c l u d e s w i t h t h e r e g u l a r ta s k s . T h e a d a p ta tio n o f ID ocs to c u s to m e r r e q u ir e m e n ts sta rts w ith th e lo w e s t e f fo rt, t h a t is, t h e o p t i o n s o f C u s t o m i z i n g , a n d p r o c e e d s s t e p b y s t e p to

11

Preface

t h e ta s k t h a t r e q u i r e s t h e h i g h e s t e f f o r t : t h e c o m p l e t e c u s t o m p r o g r a m ­ m i n g o f ID ocs. C h a p t e r 1, In tr o d u c tio n , d i f f e r e n t i a t e s ALE a n d E D I a n d d e s c r i b e s t h e b a s i c p r i n c i p l e s o f ID o c s . C h a p t e r 2 , G enerating ID ocs, o u t l i n e s t h e d i f ­ f e r e n t o p t i o n s f o r g e n e r a t i n g ID o c s . C h a p t e r 3, Test Tools, d i s c u s s e s h o w y o u c a n t e s t ID o c s f o r t h e d a t a e x c h a n g e e v e n w i t h o u t t h e c o m m u n i c a ­ tio n p a rtn e r. A f t e r t h e g e n e r a t i o n o f s t a n d a r d I D o c s h a s b e e n f u l l y o u t l i n e d , th is c h a p t e r d e t a i l s t h e c u s t o m e r a d a p t a t i o n s . H e re , I D o c s a r e c o n n e c t e d to t h e d i f f e r e n t e n h a n c e m e n t t e c h n o l o g i e s o f SAP. S o m e o p t i o n s o f ID o c m a n i p u l a t i o n a l r e a d y a r i s e i n C u s to m i z i n g , w h i l e o t h e r s r e q u i r e c u s t o m d e v e l o p m e n t s o r t h e e n h a n c e m e n t o f t h e s t a n d a r d ID o c f u n c t i o n m o d ­ u l e s . T h e r e a r e a ls o s p e c ia l d e v e l o p m e n t o b j e c t s t h a t a r e o n l y u s e d in c o m b i n a t i o n w i t h ID o c s . So C h a p t e r 4 , C hanges to ID ocs, d e s c r i b e s p a r ­ tic u l a r l y w i t h r e g a r d t o ID o c s h o w y o u m u s t h a n d l e e n h a n c e m e n t s a n d w h a t y o u n e e d t o c o n s i d e r . T h e fo c u s is o n t h e e n h a n c e m e n t t e c h n o l o ­ g ie s r e l e v a n t f o r ID o c s . T h o s e e n h a n c e m e n t s t h a t a r e u s e d f o r all IDoc t y p e s a r c d i s c u s s e d in d e t a i l . T h is c h a p t e r a l s o d e s c r i b e s t h e s p e c if ic fe a­ t u r e s in t h e c o n t e x t o f e n h a n c e m e n t s o r c u s t o m - d e v e l o p e d ID o c s, s u c h as th e w o rk flo w co n n e ctio n . C h a p t e r 5, C o n firm a tio n s, t h e n d i s c u s s e s t h e liv e o p e r a t i o n a n d s h o w s h o w y o u can learn fro m y o u r c o m m u n ic a tio n p a r tn e rs w h a t h a p p e n e d to t h e ID o c d e s p i t e t h e a s y n c h r o n o u s p r o c e d u r e . C h a p t e r 6, Seria lizin g ID ocs, o u t l i n e s t h e d i f f e r e n t o p t i o n s t o k e e p a s p e c if ic s e q u e n c e f o r p r o ­ c e s s in g ID o c s , a s w e l l a s t h e a v a il a b il i t y o f t h e s e o p t i o n s . C h a p t e r 7, A d m in is tr a tio n , d e s c r i b e s n e c e s s a r y r e g u l a r ta s k s in d e t a i l . F in a lly , in C h a p t e r 8, ID ocs in C o n ju n ctio n w ith S A P N e tW e a v e r Process In te g ra tio n , t h o s e w h o w o r k w i t h SAP N e t W e a v e r PI ( f o r m e r l y SAP N e t W e a v e r XI) l e a r n h o w t h e y c a n i m p l e m e n t ta s k s t h a t a r e o n l y r e q u i r e d in t h e c o n t e x t o f ID o c s , s p e c if ic a lly in t h e c o m m u n i c a t i o n w i t h SAP N e t W e a v e r PI.

12

Preface

A c k n o w le d g m e n ts A b o v e all, I w o u l d lik e t o l h a n k m y h u s b a n d M a n f r e d . T h i s b o o k c o n ­ s u m e d a l o t o f o u r tim e , a n d w i t h o u t h i s s u p p o r t a n d all t h e w o r k h e did, I w o u l d n ' t h a v e b e e n a b l e t o w r i t e it. I w o u l d a l s o lik e to t h a n k M a i k e L u b b e r s , S te f a n P r o k s c h , a n d M e g D u n k e r l e y o f G a li l e o P re s s — w i t h o u t t h e i r e n c o u r a g e m e n t a n d s u p ­ p o r t , I m i g h t h a v e b e e n a b l e to fi n i s h t h i s b o o k , b u t i t w o u l d d e f in i t e l y have c o n ta in e d m a n y errors.

S a b in e M aisel

13

T his c h a p te r in tro d u c e s th e in te r fa c e ty p e s u se d b y S A P in A L E scen a rio s. Y o u 'll le a r n a b o u t th e c h a r a c te r istic s o f th e d iffe r e n t te c h n iq u e s a n d w h y d iffe r e n t a rea s n e e d d iffe r e n t in te r fa c e typ es. Y o u ’l l a lso re v ie w te r m in o lo g y u s e d th r o u g h o u t th e book.

1

Introduction

Y o u 'r e c e r t a i n l y f a m i l i a r w i t h t h e t o p i c o f e l e c t r o n i c d a t a e x c h a n g e b e tw e e n d iffe re n t e n te r p ris e s . B ut e v e n w ith in e n te r p ris e s , in d iv id u a l p r o c e s s s t e p s c a n ’t b e c a r r i e d o u t o n t h e s a m e m a c h i n e ( o r in t h e s a m e d a t a b a s e ) u s i n g t h e s a m e s o f t w a r e . SAP m e e t s t h i s r e q u i r e m e n t b y p r o ­ v i d i n g s t a n d a r d i n t e r f a c e s f o r l o c a t i o n s w h e r e t h i s k i n d o f s e p a r a t i o n is c o m m o n . S ta n d a r d in terfa ces a p p l y s p e c if ic n o r m s to a c tu a l d a t a t r a n s f e r to p r o v i d e y o u w i t h a c e r t a i n r e l e a s e s e c u rity .

1.1

W h a t Is A L E ?

A n e x a m p le o f h o w y o u ca n s tru c tu re th e c o m m u n ic a tio n acco rd in g

S t r u c t u r in g

to p r o c e s s s t e p s is t h e s e p a r a t i o n o f h u m a n r e s o u r c e m a n a g e m e n t a n d

c o m m u n ic a t io n

a c c o u n t i n g , w h i c h y o u c a n fin d in m a n y c o m p a n i e s . All d a t a g e n e r a t e d in H R — o n b u s i n e s s t r i p s , f o r e x a m p l e — t h a t a ls o n e e d s to b e t r a n s f e r r e d to a c c o u n t i n g c a n b e p o s t e d in t h e SA P s y s t e m b o t h l o c a lly o r r e m o t e ly . B e c a u s e o f th is , i t is a t t h e s o l e d i s c r e t i o n o f a c o m p a n y w h e t h e r t o u s e o n e o r s e v e r a l s y s t e m s . SA P r e f e r s to t h i s s e p a r a t i o n o f p r o c e s s e s w i t h i n a n e n t e r p r i s e a s A p p lic a tio n L in k E n a b lin g (ALE); p r o c e s s e s t h a t c o n t a i n t h e r e l e v a n t i n t e r f a c e s a r e c a lle d A L E business processes o r A L E scenarios. A n i n t e r f a c e g e n e r a l l y a l l o w s y o u to s e n d d a t a f r o m a c e r t a i n p o i n t w i t h i n t h e p r o c e s s ( o u t b o u n d i n t e r f a c e ) o r to r e c e i v e d a t a a t a sp ec ific p o in t ( in b o u n d in terfa ce). A p re re q u is ite fo r th e u sefu l e m p l o y m e n t o f

15

I n te r fa c e s

1

In tro d u ctio n

a n i n t e r f a c e is t h a t b o t h a t e c h n i c a l a n d s e m a n t i c d e s c r i p t i o n o f t h a t i n t e r f a c e a r c a v a ila b le . T e c h n ic a l

T h e technical description s p e c if ie s w h i c h d a t a is s u p p l i e d o r e x p e c t e d in

d e s c r ip t io n

w h i c h f o r m a t a n d i n w h i c h s e q u e n c e . T h is d e s c r i p t i o n is r e q u i r e d to u n p a c k th e data.

S e m a n tic

T h e se m a n tic d escrip tio n c o n t a i n s all o f t h e r e q u i r e d b u s i n e s s i n f o r m a ­

d e s c r ip t io n

t i o n c o n c e r n i n g t h e u s e o f t h e i n t e r f a c e , f o r i n s t a n c e , w h e t h e r t h e d a ta is r e a d - o n l y o r c a n b e e d i t e d . T h i s d e s c r i p t i o n is r e q u i r e d to i n t e r p r e t t h e i n c o m i n g d a ta . Technical and Sem antic Descriptions o f an Interface Consider an interface th a t w e all use very often in o u r daily life: transferring senten c es by tele p h o n e . Here, th e sem antic description co rresp o n d s to the kn ow led g e t h a t t h e last s e n te n c e is usually a farewell; t h e technical descrip­ tion, o n t h e o th e r h and, co rresp o n d s t o t h e kn ow led g e of h o w t o structure a farewell n o te in English.

R e m o te F u n c tio n

O f c o u r s e , in a d d i t i o n t o t h e d e s c r i p t i o n s , t h e p h y s i c a l t r a n s f e r o f d a ta

C a ll

is n e c e s s a i y a s w e l l v ia a p r o t o c o l . SAP s u p p o r t s its o w n RFC p r o t o c o l (R em ote F unction Call) in all re le a s e s , w h e r e a s n e w e r r e le a s e s a ls o s u p p o r t HTTP (H y p e rte x t T ransfer Protocol) a n d S O A P ( w h i c h o r i g i n a l l y s t o o d f o r S im p le O bject Access Protocol). B e c a u s e ALE b u s i n e s s p r o c e s s e s r e p r e s e n t a s l i g h tl y o l d e r t e c h n o l o g y , t h e y u s e o n l y s t a n d a r d i n t e r f a c e s b a s e d o n RFC a n d d o n ' t s u p p o r t t h e n e w p r o x y i n t e r f a c e s y e t , w h i c h a r c b a s e d o n SOAP. Protocol o f an Interface

P ro to c o l

Let's g e t back to o u r te le p h o n e analogy: The p h o n e line basically allows you to transfer d a ta via fax o r language. However, before you d o th a t, you must agree w ith your p artn er o n which of t h e t w o o p tio n s you w a n t to use. This corresponds t o selecting t h e protocol, t h a t is. t h e transfer type.

W h e n d e sig n in g an interface, y o u h a v e th e fo llo w in g o p tio n s: S y n c h ro n o u s

► S y n c h ro n o u s in te rfa c e s

c o m m u n ic a t io n

S y n c h r o n o u s i n t e r f a c e s c o n s i s t o f a req u est a n d a response. D u r i n g th is p r o c e s s , t h e c o n n e c t i o n b e t w e e n t h e s y s t e m s is k e p t a liv e . C o n sc -

16

W h a t Is A L E

|

q u e n t l y , s y n c h r o n o u s i n t e r f a c e s i m m e d i a t e l y p r o v i d e a re s u lt. This m e a n s th a t y o u — th e u s e r o f th is ty p e o f in te rfa c e — c a n w a it fo r th e r e s p o n s e . T h e a d v a n t a g e o f a s y n c h r o n o u s i n t e r f a c e is t h a t y o u r e c e i v e a d i r e c t c o n f i r m a t i o n a s t o w h e t h e r y o u r o r d e r w a s p r o c e s s e d o r n o t. I t 's y o u r r e s p o n s i b i l i t y t o t r i g g e r t h e e x e c u t i o n o f t h e t a s k . T h e d i s a d ­ v a n t a g e o f t h i s t y p e o f i n t e r f a c e is t h a t y o u c a n ’t c o n t i n u e to w o r k until th e o th e r sy ste m pro cesses th e re q u e s t o r w h e n th e o th e r system i s n ' t a v a il a b le . In a d d i t i o n to t h a t , l o n g r u n t i m e s c a n r e q u i r e y o u to re p e a t th e s a m e o p e ra tio n if y o u th in k a n e r ro r h as occurred. Example: Synchronous Interface Y o u w a n t t o b u y a b o o k a b o u t A L E a n d I D o c s a n d c a ll y o u r lo c a l b o o k s h o p t o o b t a i n i n f o r m a t i o n o n a v a ila b le b o o k s a n d t h e r e s p e c t iv e p r i c e s . I t d e p e n d s o n t h e r e s p o n s e y o u g e t w h e t h e r y o u ’ l l a c t u a l l y m a k e t h e p u r c h a s e o r n o t . If a t e c h n i c a l f a i l u r e t e r m i n a t e s t h e p h o n e c a ll p r e m a t u r e ly , y o u ’ l l c a ll b a c k o n ly i f y o u h a v e n ' t r e c e iv e d a n y r e s p o n s e y e t .

► A sy n c h ro n o u s in te rfa c e s

A s y n c h ro n o u s

A sy n c h ro n o u s interfaces se n d th e re q u ire d d ata to th e o th e r system

c o m m u n ic a t io n

in v o lv e d a n d d o n 't receiv e an im m e d ia te re s p o n se . T h is m e a n s th at o n l y a r e q u e s t is s e n t . As a p r e r e q u i s i t e , n o r e s p o n s e is n e e d e d f o r this process. C o n se q u e n tly , y o u c a n c o n tin u e w o rk in g irre sp ectiv e o f th e o t h e r sy stem . H o w e v er, b ec au se y o u w o n 't receiv e a n im m e d ia te r e s u lt , in a n a s y n c h r o n o u s c o m m u n i c a t i o n p r o c e s s , i t m u s t b e e n s u r e d w i t h o u t y o u r i n t e r f e r e n c e t h a t t h e r e q u e s t a r r i v e s in t h e o t h e r s y s t e m — a n d o n l y o n c e . T h e fact t h a t a n a c ti o n is c a r r i e d o u t o n l y o n c e is r e f e r r e d to a s transaction security. Example: Transaction Security Y o u w a n t t o b u y m y b o o k a n d s e n d a fa x c o n ta in in g t h e p u rc h a s e o r d e r d a ta t o t h e b o o k s h o p . T h e b o o k s e l le r d o e s n ' t r e s p o n d t o y o u r f a x . H o w e v e r , t h e t r a n s m is s io n r e p o r t o f y o u r f a x m a c h in e t e l l s y o u t h a t t h e b o o k s h o p h a s r e ­ c e iv e d t h e p u r c h a s e o r d e r e x a c t ly o n c e .

ALE s c e n a r i o s c a n c o n s i s t o f a n y n u m b e r o f s y n c h r o n o u s a n d a s y n c h r o ­

I n te r f a c e s in A L E

n o u s i n t e r f a c e s . SAP u s e s s y n c h r o n o u s i n t e r f a c e s e v e r y t i m e d a t a fr o m

s c e n a rio s

t h e d a t a b a s e is s u p p o s e d to b e d i s p l a y e d ; a s y n c h r o n o u s i n t e r f a c e s , in t u r n , a r e u s e d e v e i y t i m e y o u w a n t to c r e a t e o r c h a n g e d a t a i n t h e d a ta -

17

1 .1

1

|

In tro d u ctio n

b a s e . I n t h e l a t t e r c a s e , t h e t r a n s a c t i o n s e c u r i t y is p a r t i c u l a r l y i m p o r t a n t to m a in ta in d a ta b a s e co n sisten cy .

1.2 B A P is

B A P Is an d ID o c s — A n In tro d u ctio n

T h e m e d i u m f o r s y n c h r o n o u s i n t e r f a c e s i n ALE s c e n a r i o s is t h e B u si­ ness A p p lic a tio n P ro g ra m m in g In te rfa c e (BAPI). T h e t e r m A p p lic a tio n Pro­ g r a m m in g In te rfa c e (API) is g e n e r a l l y u s e d in t h e IT e n v i r o n m e n t . SAP e x t e n d e d it b y t h e a d d i t i o n " B u s in e s s " to i n d i c a t e t h a t t h e p r o c e s s n o t o n l y i n v o l v e s a p u r e l y t e c h n i c a l d a t a t r a n s f e r , b u t a s t e p w i t h i n a b u s i­ n e s s p r o c e s s . In t h i s c o n t e x t , t h e i n d i v i d u a l s t e p s t h a t m a k e u p t h e p r o ­ ce ss c a n o c c u r in d i f f e r e n t s y s t e m s .

ID o c s

A s y n c h r o n o u s i n t e r f a c e s in ALE s c e n a r i o s a r c i m p l e m e n t e d u s i n g In te r­ m e d ia te D o c u m en ts (ID o cs). I n a d d i t i o n t o t h e b u s i n e s s d o c u m e n t s t h a t a r e c r e a t e d in t h e d i f f e r e n t s y s t e m s i n v o l v e d , a s y n c h r o n o u s p r o c e s s e s a l s o g e n e r a t e a d a t a d o c u m e n t t h a t e n s u r e s t r a n s a c t i o n s e c u r i ty . B e c a u s e t h i s d o c u m e n t i s n 't p a r t o f t h e a c tu a l b u s i n e s s p r o c e s s b u t is r a t h e r an in te rm e d ia te d o c u m e n t, it h a s b e e n a ssig n ed th e c o r re s p o n d in g n am e. T h e f o l l o w i n g s e c t i o n s p r o v i d e a b r i e f i n t r o d u c t i o n t o t h e t o p i c o f BAPIs a n d ID o c s . You'll l e a r n h o w t h e s e d i f f e r e n t m e t h o d s w o r k a n d w h y t w o d i f f e r e n t t y p e s o f i n t e r f a c e e x i s t w i t h i n ALE s c e n a r i o s .

1.2.1

B A P is

A BAPI is a r e m o t e - e n a b l e d f u n c t i o n m o d u l e , t h a t is, a m o d u l e t h a t c a n b e e x e c u t e d b y a n o t h e r p r o g r a m . In t h i s c o n t e x t , it i s n 't i m p o r t a n t w h e t h e r t h a t p r o g r a m calls t h e f u n c t i o n m o d u l e lo c a lly o r f r o m w i t h i n a d i f f e r e n t s y s t e m . BAPis d i f f e r f r o m r e g u l a r RFC -enabled f u n c tio n m odules (R FM ) i n t h e f o l l o w i n g a s p e c ts : bapi

r e q u ir e m e n t s

► A s a m e t h o d , a BAPI is p a r t o f a b u s i n e s s o b j e c t t y p e f r o m t h e Business O bject R ep o sito ry (BOR). F o r all r e l e v a n t o b j e c t s i n t h e SAP s y s t e m , S AP p r o v i d e s a c o r r e s p o n d i n g e l e m e n t i n t h e BOR. I n t h e BOR, y o u c a n fin d i n f o r m a t i o n r e g a r d i n g w h i c h t a b l e s p e r t a i n t o a n o b j e c t a n d w h a t y o u c a n d o w i t h t h e m . It's a ls o t h e b a sis f o r t h e b u sin ess w o rk­ f l o w . S o , i t m a k e s m u c h s e n s e t o a ls o s t o r e in t h e B O R i n f o r m a t i o n

18

B A P Is a n d ID o c s — A n In tro d u ctio n

a b o u t w h i c h p r o c e s s s t e p s in ALE s c e n a r i o s y o u c a n c a r r y o u t w i t h th e r e s p e c t i v e o b je c ts . ► B APIs a r e r e l e a s e d , h a v e a f r o z e n s i g n a t u r e , a n d t h u s p r o v i d e re le a s e s e c u rity . ► T h e y ty p ically u se an u p d a te te c h n iq u e fo r p o stin g s in s te a d o f p o stin g d ire c tly . M o r e o v e r , t h e y d o n ' t c o n t a i n a n y

C o m m it

or

Rol l back

state­

m e n t s . (T h e fe w , m o s t l y v e r y o l d e x c e p t i o n s a r e s p e c ific a lly d o c u ­ m e n t e d b y SAP.) ► T h e a c tu a l p o s t i n g p r o c e s s is t r i g g e r e d b y t h e s p e c ia l T IO N . C O M M IT

BAPl o r is u n d o n e v ia

B A P I_ T R A N S A C -

B A P I_ T R A N $ A C T IO N _ R O L L B A C K .

► BAPIs u s u a l l y d o n ’t d i s p l a y t h e r e s u l t s b e c a u s e i t's u n l i k e l y t h a t t h e c a ll e r h a s a G U I (graphical u se r in terfa ce) a v a il a b le . BAPIs t h a t w e r e s p e c ific a lly d e v e l o p e d f o r a n S A P /S A P c o m m u n i c a t i o n a r e a n e x c e p ­ t i o n t o t h a t . H o w e v e r , t h e s e BAPIs a r e n 't r e l e v a n t f o r i n t e r f a c e s to e x te rn a l sy stem s. L ike all r e m o t e - e n a b l e d f u n c t i o n m o d u l e s , B APIs c a n g e n e r a l l y b e ca lle d

C a llin g B A P Is

u s i n g a syn ch ro n o u s RFC (sRFC) o r a tra n sa c tio n a l RFC (tRFC). T h e t r a n s ­

v ia RFC

a c t i o n a l c a ll is a s y n c h r o n o u s a n d m a k e s s u r e t h a t t h e call is e x e c u t e d ex actly o n c e . H o w e v e r, n o te th a t b o th th e s y n c h r o n o u s a n d th e tran sa c­ ti o n a l call n o t i f y o n l y t h e c a llin g s y s t e m in c a s e o f p o t e n t i a l e r r o r s , e v e n i f t h a t s y s t e m c a n ’t r e m o v e t h e e r r o r . T h a t 's w h y BAPIs a r e g e n e r a l l y u s e d o n l y f o r s y n c h r o n o u s calls in ALE s c e n a r i o s . I n a s y n c h r o n o u s cases, e r r o r s s h o u l d p r e f e r a b l y b e r e p o r t e d d i r e c t l y t o t h e re c e iv e r , p r o v i d e d t h e s e e r r o r s a r e b u s i n e s s - r e l a t e d . BAPIs a r e n ' t i n t e n d e d f o r t h i s p u r p o s e . T h e f o l l o w i n g s e c t i o n d e s c r i b e s h o w t h e s e p a r a t i o n b y e r r o r t y p e s is i m p l e m e n t e d b y m e a n s o f ID o c s.

1 .2 .2

ID O C S

SAP d e v e l o p e d ID o c s s p e c if ic a lly t o e n a b l e t h e a s y n c h r o n o u s m e s s a g e e x c h a n g e b e t w e e n m u l t i p l e SAP a n d / o r n o n - S A P s y s t e m s . T h e a d v a n ­ ta g e s o v e r a n o r m a l , a s y n c h r o n o u s l y (t r a n s a c t i o n a l l y ) c a lle d R FM i n c l u d e a n i m p r o v e d e r r o r - h a n d l i n g p r o c e s s a s w e l l a s a s p e c if ic m o n i t o r i n g l a y e r m a d e a v a il a b le t o I D o c s . B e c a u s e e r r o r p r o c e s s i n g v i a ID o c s a ffec ts t h e s t r u c t u r e o f ID o c i n t e r f a c e s , w e ’ll l o o k a t i t first in t h e f o l l o w i n g s e c ti o n s .

19

|

1 .2

1

In tro d u ctio n

E rro r H a n d lin g w it h ID ocs You c a n g e n e r a l l y d i s t i n g u i s h b e t w e e n t w o d i f f e r e n t t y p e s o f e r r o r : E r r o r ty p e s

► T ech n ical e r r o r s T e c h n ic a l e r r o r s o b v i a t e t h e c o m m u n i c a t i o n w i t h t h e p a r t n e r s y s t e m . T h e y o c c u r , f o r e x a m p l e , i f t h e p a r t n e r s y s t e m i s n ’t a v a il a b le , t h e d a t a b a s e in t h a t s y s t e m c a n ' t a c c e p t a n y a d d i t i o n a l r e q u e s t s , o r t h e s p e c if ie d p a s s w o r d is i n c o r r e c t . ► B u sin e ss-re la te d e rro rs B u s in e s s - r e la te d e r r o r s o c c u r i f t h e p a r t n e r s y s t e m g e n e r a l l y r e s p o n d s t o r e q u e s t s b u t c a n ' t p r o c e s s y o u r s p e c if ic r e q u e s t . M i s s i n g a u t h o r i z a ­ t i o n s , m i s s i n g C u s t o m i z i n g , o r t h e lik e c a n c a u s e t h i s t y p e o f e r r o r . I n t h e c o n t e x t o f RFCs, t h i s d i s t i n c t i o n i s n ’t m a d e . I n a RFC, t h e u s e r d irec tly receiv es a n e r r o r m e ssa g e a n d m u s t m a k e s u r e th a t th e re q u est w ill b e r e p e a t e d a t a l a t e r p o i n t in t i m e . B e c a u s e calls c o n t a i n i n g e r r o r s c a n 't b e r e p e a t e d a u t o m a t i c a l l y a n d d o n ' t h a v e t o b e lo g g e d , t h e d i s t i n c ­ tio n b e tw e e n e rro r ty p es w o u ld n 't m a k e sen se h ere. In tR FC s, e a c h call t h a t c o n t a i n s a n e r r o r is w r i t t e n t o a t a b l e in t h e s e n d ­ in g s y s t e m a n d c a n b e r e s t a r t e d u s i n g a s p e c if ic t r a n s a c t i o n . I n t h i s case, it d o e s m a k e s e n s e t o d i s t i n g u i s h b e t w e e n t h e t y p e s o f e r r o r . I n t h a t case, t e c h n ic a l e r r o r s w o u l d b e lo g g e d in t h e s e n d i n g s y s t e m , a n d t h e call w o u l d b e r e p e a t e d , i f n e c e s s a i y , w h i l e b u s i n e s s - r e l a t e d e r r o r s w o u l d be l o g g e d a n d p r o c e s s e d in t h e r e c e i v i n g s y s t e m . T h is o p t i o n t o d i s t i n g u i s h b e t w e e n d i f f e r e n t t y p e s o f e r r o r s is a s p e c if ic f e a t u r e o f ID o c s a n d i s n ’t p r o v i d e d b y RFCs t h e i r self. In a d d i t i o n , y o u c a n a ls o c h a n g e t h e c o n ­ t e n t s o f I D o c s r e t r o a c t i v e l y in c a s e o f e r r o r s , w h i c h i s n ’t p o s s i b l e e i t h e r w i t h s t a n d a r d RFCs.

E rro rs in s e n d in g

To d i s t i n g u i s h b e t w e e n t e c h n i c a l e r r o r s a n d b u s i n e s s - r e l a t e d e r r o r s , t h e

a n d r e c e iv in g

p r o c e s s i n g o f t h e r e s p e c t i v e p r o c e s s e s m u s t b e d i v i d e d i n t o t w o s t e p s as

s y s te m s

w e ll . T h e first s t e p is r e s p o n s i b l e f o r p u r e l y t r a n s f e r r i n g t h e r e q u e s t to t h e d a t a b a s e o f t h e r e c e i v i n g s y s t e m . T h is s t e p d o e s n ’t d e p e n d o n t h e t y p e o f d a t a t h a t is t r a n s f e r r e d . F o r e x a m p l e , i t d o e s n ’t m a k e a n y d i f f e r ­ e n c e w h e t h e r y o u w a n t t o c r e a t e m a t e r i a l s o r c a n c e l a s a le s o r d e r . To c a r t y o u t t h e t r a n s f e r in t h e s a m e m a n n e r f o r all k i n d s o f d a t a , y o u u s e a n e u t r a l f o r m a t : t h e ID o c f o r m a t .

20

B A P Is a n d ID o c s — A n In tro d u ctio n

|

1 .2

T h e s e c o n d s t e p is c a r r i e d o u t lo c a lly in t h e r e c e i v i n g s y s t e m a n d i n v o lv e s p o s tin g t h e re le v a n t d o c u m e n t . T h is s t e p c a n v a ry d e p e n d in g o n th e bu sin ess o b ject to b e processed.

Technical D e s c rip tio n o f th e ID o c F o rm a t A n ID o c c o n s i s t s o f a h ea d e r record, a n y n u m b e r o f lin e s o f a p p l i c a t i o n

I D o c a s a n e u tr a l

d a t a (a p p lic a tio n records), a n d a n y n u m b e r o f s ta tu s records p e r IDoc.

fo rm a t

► H eader

H e a d e r re c o rd /

T h e h e a d e r c o n t a i n s g e n e r a l i n f o r m a t i o n a b o u t w h i c h d a t a is s u p ­

c o n t r o l re c o rd

p o s e d to b e t r a n s f e r r e d , w h o is t h e s e n d e r , a n d w h o is t h e re c e iv e r. T h is m e a n s t h a t t h e r e c e i v e r c a n l e a r n f r o m t h e h e a d e r r e c o r d w h i c h d a t a h a s b e e n r e c e i v e d a n d — b a s e d o n t h i s i n f o r m a t i o n — d e c id e h o w to p ro c e ss th is data. ► D a ta re co rd s

D a t a re c o r d s

T h e d a t a r e c o r d s c o n t a i n b u s i n e s s - r e l a t e d i n f o r m a t i o n . To m a k e s u r e t h e t e c h n i c a l f o r m a t is i n d e p e n d e n t o f t h e b u s i n e s s o b j e c t a n d c a n a ls o b e u n d e r s t o o d b y n o n - S A P s y s t e m s , t h e c o n t e n t o f e a c h d a t a r e c o r d is s t o r e d a s a s t r i n g o f 1 0 0 0 c h a r a c t e r s . T h is c h a r a c t e r s t r i n g is p r e c e d e d b y a c o n t r o l a r e a c o n t a i n i n g i n f o r m a t i o n a b o u t h o w to i n t e r ­ p re t th e

1000 c h a r a c te r s .

► S ta tu s re c o rd s

S ta tu s re c o r d s

S ta tu s r e c o r d s c o n t a i n i n f o r m a t i o n a b o u t t h e p r e v i o u s s t a t u s e s o f t h e ID o c , s u c h a s " s u c c e s s f u ll y c r e a t e d " o r " s u c c e s s f u lly p o s t e d . " S ta tu s r e c o r d s a r e n ' t t r a n s f e r r e d ; t h a t is, b o t h t h e s e n d e r a n d r e c e i v e r k e e p t h e i r o w n s t a t u s re c o r d s . F ro m a tech n ical p o in t o f v iew , th e s e th re e ty p es o f re co rd h a v e th e s a m e s t r u c t u r e . C o n s e q u e n t l y , t h e s t r u c t u r e d o e s n ' t p r o v i d e a n y c l u e a s to w h ic h k in d o f b u sin e s s -re la te d in fo rm a tio n y o u 'r e d ea lin g w ith . F ig u r e 1.1 c o n t a i n s a t h e o r e t i c a l i l l u s t r a t i o n o f h o w t h e d i f f e r e n t ty p e s o f re c o rd s c a n b e u sed . N o te th a t y o u c a n u se an u n lim ite d n u m b e r o f d a t a r e c o r d s a n d s t a t u s r e c o r d s . T h is is d e s c r i b e d in g r e a t e r d e t a i l in t h e f o l l o w i n g s e c ti o n .

21

1

In tro d u ctio n

C o n t r o l R e c o rd

ID o c N u m b e r S e n d e r a n d R e c e iv e r M e s s a g e T y p e a n d I D o c Typ e E x te r n a l S tr u c tu r e

D a ta R e c o rd s C o n tr o l S e c tio n w it h

A p p lic a t io n D a ta

ID o c N u m b e r

S e g m e n t T y p e e tc .

M a t e r i a l N u m b e r , D a t e e t c . a s C h a r a c te r S trin g (L e n g th : 1 0 0 0 )

S ta tu s R e c o rd s

ID o c N u m b e r S ta tu s In fo r m a t io n (e .g .. 5 3 : P o s t e d S u ccessfu lly )

F ig u r e 1.1

S tr u c tu r e o f a n ID o c

To p r o c e s s i h e IDoc, t h e r e c e i v e r n e e d s m eta in fo rm a tio n , t h a t is, i n f o r m a ­ t i o n c o n c c m i n g t h e m a n n e r in w h i c h t h e d a t a is s u p p o s e d to b e p ro c e s s e d . T h e m e t a i n f o r m a t i o n t h a t d e s c r i b e s a n ID o c c o n s i s t s o f t h r e e parts: M e ssa g e ty p e

►

M essag e ty p e T h e m e s s a g e t y p e p r o v i d e s a s e m a n t i c d e s c r i p t i o n o f t h e d a t a to be p ro c essed . F o r e x a m p le , m e ssag e ty p e

M ATM A S

i n d i c a t e s t h a t m a t e r ia l

m a s t e r d a t a is s u p p o s e d t o b e e x c h a n g e d . T h e m e s s a g e t y p e is also r e s p o n s i b l e f o r t h e w a y a m e s s a g e w ill b e p r o c e s s e d . W h e n y o u c r e ­ a t e o r c h a n g e a s ales o r d e r , f o r e x a m p l e , t h e a c tu a l i n f o r m a t i o n is i d e n t i c a l , b u t t h e p r o c e s s i n g is d i f f e r e n t , w h i c h is w h y t h e c r e a t i o n o f t h e o r d e r is a s s i g n e d t h e OROCHG

O R D ER S

m e ssa g e ty p e , w h ile m e ssa g e type

is a s s i g n e d t o t h e c h a n g e a c tiv ity . T h e n a m e s o f m e s s a g e t y p e s

a r e b a s e d o n t h e n a m e s o f t h e U N /E D IF A C T s t a n d a r d ( U n ited N a tio n s E lectronic D a ta In terc h a n g e f o r A d m in istra tio n , C om m erce a n d T ransport), b u t a p a r t f r o m t h e n a m e s , t h e r e a r e n o o t h e r s i m il a r it i e s b e t w e e n t h e I D o c a n d E D IFA C T f o r m a t s . ID o c ty p e

►

ID o c ty p e T h e ID o c t y p e r e p r e s e n t s t h e t e c h n i c a l d e s c r i p t i o n o f t h e d a t a . It tells y o u w h i c h fie ld s o f w h i c h b u s i n e s s o b j e c t s a r e s u p p o s e d t o b e filled

22

B A P Is a n d ID o c s — A n In tro d u ctio n

|

w i t h w h i c h v a l u e s . T h i s m e a n s t h a t t h e ID o c t y p e d e s c r i b e s h o w to i n t e r p r e t t h e 1 0 0 0 c h a r a c t e r s in t h e d a t a re c o rd . ► S eg m en t ty p e

Segment type

F o r e a c h p o s s i b le v a r i a n t o f t h e s e 1 0 0 0 c h a r a c te r s , t h e r e is o n e s e g ­ m e n t ty p e. F o r e x a m p le , s e g m e n t ty p e m a s t e r d a t a f r o m T a b le

M ARA

E 1M A R A M

i n d i c a t e s t h a t m a t e r ia l

is g o i n g to fo llo w . I n e a c h SAP s y s t e m ,

i n f o r m a t i o n is s t o r e d a s to w h i c h ID o c t y p e c a n h a v e w h i c h s e g m e n t s , h o w o f t e n , a n d in w h i c h s e q u e n c e . You c a n e x p o r t t h i s d a t a t o e x t e r n a l s y s t e m s to a v o i d h a v i n g t o m a i n ­ t a i n a ll s t r u c t u r e s m a n u a l l y . SAP s u p p o r t s t h e t r a n s f e r o f d a t a v i a t r a n s ­ p o r t ID o c s , C files, D TD (D o c u m e n t Type D escription), o r H T M L (H y p ertext M a r k u p L anguage). I f y o u w a n t to u s e t r a n s p o r t ID o c s , y o u m u s t e n s u r e t h a t y o u r p a r t n e r c a n g e n e r a l l y r e c e i v e ID o c s f r o m y o u , w h i c h m e a n s t h a t y o u r SAP s y s t e m m u s t k n o w t h e p a r t n e r as a logical s y s t e m . T h e ID o c , w h i c h e x i s t s a s a s e t o f d a t a r e c o r d s , is t h e n t r a n s f e r r e d f r o m t h e s e n d e r to t h e re c e iv e r . T h e m o s t c o m m o n l y u s e d t y p e o f t r a n s f e r is t h e tR FC . T h e t r a n s f e r is c a r r i e d o u t in s u c h a w a y t h a t t h e s e n d i n g s y s ­ t e m calls t h e f u n c t i o n m o d u l e ID0C_INB0UND_ASYNCHR0N0US in t h e re c e iv ­ in g s y s te m . T h is fu n c tio n m o d u le receiv es th e d a ta a n d p o s ts th e h e a d e r a n d d a t a r e c o r d s to t h e a s s o c i a t e d d a t a b a s e t a b l e s EDIOC a n d EDID4, a n d t h e s t a t u s o f t h e ID o c t o ED I OS. A f t e r t h a t h a s b e e n d o n e , t h e t e c h n ic a l p a r t is f i n i s h e d . I f p r o b l e m s o c c u r d u r i n g t h i s p r o c e s s , t h e s e n d e r w ill b e n o t i f i e d a n d m u s t r e s e n d t h e d a t a a t a l a t e r p o i n t in tim e . O t h e r t y p e s o f t r a n s f e r , s u c h a s f i l e (fla t file), X M L (file i n X M L f o r m a t ) ,

IDoc as file

o r H TTP c a n a ls o b e u s e d b e c a u s e o f t h e s e p a r a t i o n o f d a t a t r a n s f e r a n d d a t a p r o c e s s i n g . F ig u r e 1 .2 s h o w s t h e first p a r t o f a s m a ll m a t e r i a l m a s t e r I D o c a s a file, o p e n e d in N o t e p a d .

i

:D I_ D C 4 0 _ U 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 700 301 2 MATMftSOS £2H AB A*007 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 0 0 0 0 0 1 0 0 0 0 0 0 0 2 005 S H -1 0 0

£2KABA1001 • 2MAKTM001 E2HAKTM001 E2KAKTM001 E2HAKTM001 E2MAKTM001

F ig u re 1.2

ZSM1 19951005/

/

800000000000076076400000200000103/ 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 0 0 0 0 0 3 0 0 0 001030 05C W M a n o l 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 0 0 0 0 0 4 0 0 0 0 0 1 0 3 005 EM et h a n o l 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 0 0 0 0 0 5 0 0 0 0 0 1 0 3 0 0 5 rM e t h a n o l 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 0 0 0 0 0 6 0 0 0 0 0 1 0 3 0 0 5 J r fs y - * 8 0 0 0 0 0 0 0 0 0 0 0 0 7 6 0 7 6 4 0 0 0 0 0 7 0 0 0 0 0 1 0 3 0 0 5 P w et a n o l

ID o c in N o te p a d Ed ito r

23

1 .2

1

In tro d u ctio n

You c a n s p e c i f y t h e t y p e o f t r a n s f e r t o b e u s e d f o r t r a n s f e r r i n g ID o c s to t h e p a r t n e r s y s t e m v i a t h e o u tb o u n d p a r tn e r p rojile (T r a n s a c tio n W E 2 0 ) . A f t e r t h e ID o c h a s a r r i v e d in t h e r e c e i v i n g s y s t e m , t h e b u s i n e s s - r e l a t e d p o s t i n g p r o c e s s b e g i n s . T y pically , t h i s is a ls o c a r r i e d o u t b y m e a n s o f a fu n c tio n m o d u le. T h e in b o u n d p a r tn e r p ro jile (a lso T r a n s a c t i o n W E 2 0 ) s p e c if ie s t h e p r o c e s s co d e to b e u sed . F o r each p o ssib le c o m b in a tio n o f s e n d e r a n d m essage t y p e , y o u c a n d e f i n e w h i c h f u n c t i o n m o d u l e w ill b e u s e d . SAP p r o v i d e s all n e c e s s a i y f u n c t i o n m o d u l e s f o r a ll ALE s c e n a r i o s a v a il a b le . N o t e t h a t y o u c a n c u s t o m i z e t h e s e f u n c t i o n m o d u l e s o r e v e n r e p la c e t h e m w i t h y o u r o w n . C h a p t e r 4 , C h a n g e s t o ID o c s , p r o v i d e s m o r e d e t a i l e d i n f o r ­ m a t i o n o n this. IDoc tracking

I f a n e r r o r o c c u r s d u r i n g t h e b u s i n e s s - r e l a t e d p o s t i n g , t h e e r r o r w ill be d o c u m e n t e d in t h e s u b s e q u e n t s t a t u s r e c o r d o f t h e ID oc, a n d y o u can r e s ta r t t h e p o s t i n g p r o c e s s later. SAP p r o v i d e s a s e p a r a t e t r a n s a c t i o n fo r p o s i n g a n I D o c a f t e r a p r o c e s s i n g e r r o r : T ra n s a c tio n B D 8 7 . This t r a n s a c tio n can r e s e n d ID ocs t h a t c o n t a i n e d e r r o r s in t h e s e n d i n g s y s t e m d u r i n g th e first a t t e m p t a n d c a n r e -p ro c e s s e r r o n e o u s ID o c s in t h e re c e iv in g s y s t e m , i f n e c e s s a iy . A f t e r t h e r e p r o c e s s , e v e r y t h i n g is f i n i s h e d . T h e p o s t i n g o f th e ID o c c r e a te s t h e b u s in e s s D o c u m e n t , o r c h a n g e s it. T h is is o n l y d o n e o n c e . O n c e it is s u c c e s s fu lly c r e a t e d o r c h a n g e d , t h e B u s in e s s D o c u m e n t is n o t t o u c h e d a g a in . I f b o t h s y s t e m s a r e SAP s y s t e m s , y o u c a n e v e n u s e t h e IDoc tra ckin g f u n c ti o n f r o m w i t h i n t h e s e n d i n g s y s t e m to o b t a i n i n f o r m a t i o n o n t h e c u r r e n t s t a t u s o f t h e r e s p e c t i v e ID o c in t h e re c e iv in g s y s t e m . You can s t a r t ID o c t ra c k in g fr o m w i t h i n t h e I D o c m o n i t o r (T ra n s a c tio n B D 8 7). T h is f u n c ti o n u s e s t h e f u n c ti o n m o d u l e I D0C_DATE_T IME_GET v i a sRFC to re ad t h e I D o c n u m b e r a n d its s t a t u s in t h e r e c e i v i n g s y s t e m . BAPIs and IDocs in ALE Scenarios D u e t o t h e t r a n s a c t i o n s e c u r it y e n a b l e d b y t h e u p d a t i n g o f e r r o n e o u s c o n ­ n e c t io n s a n d b e c a u s e o f t a r g e t - o r i e n t e d e r r o r - h a n d l i n g p r o c e d u r e s , t h e A L E i n t e g r a t i o n s c e n a r io s p r o v i d e d b y S A P a lw a y s u s e B A P Is f o r s y n c h r o n o u s , r e ­ q u e s t i n g a c c e s s , a n d I D o c s f o r a s y n c h r o n o u s , c h a n g i n g a c c e s s . I f i t ' s p o s s ib le t o t r a n s f e r d a t a in b o t h w a y s , t h a t is , s y n c h r o n o u s ly a n d a s y n c h r o n o u s ly ( e . g ., in a f i r s t , s y n c h r o n o u s t e s t r u n , a n d t h e n t h e a c t u a l p o s t i n g a s y n c h r o n o u s ly ) , b o t h a B A P I a n d a m a tc h in g ID o c a re n e e d e d . T h e ID o c t h e r e fo r e c a n b e c re ­ a t e d v ia T r a n s a c t io n B D B G , w h i c h is a ls o a v a ila b le t o c u s t o m e r s .

24

D if f e r e n t ia t io n o f A L E a n d E D I

1.3

|

D iffe re n tia tio n of A LE an d ED I

T h e c o n c e p t o f ALE c o m p r i s e s c o m m u n i c a t i o n w i t h i n a n e n t e r p r i s e . H o w e v e r , w i t h i n a n e n t e r p r i s e , d i f f e r e n t p r o c e s s e s a r e c a r r i e d o u t in p h y s i c a l l y d i f f e r e n t IT s y s t e m s , w h i c h m e a n s t h a t i n d i v i d u a l p r o c e s s step s ca n in v o lv e d iffe re n t sy stem s. A s y o u 'v e alre a d y learn ed , th ese s t e p s c a n b e c a r r i e d o u t in a s y n c h r o n o u s p r o c e s s v ia BAPIs as w e ll a s in a n a s y n c h r o n o u s p r o c e s s i n v o l v i n g ID ocs. I n t h i s c o n t e x t , t h e c o m m u n i c a t i o n i t s e l f is c a r r i e d o u t b e t w e e n t h e lo g i­

L o g ic a l s y s te m

cal s y s t e m s (LSs). E ac h LS r e p r e s e n t s a c o m b i n a t i o n o f h a r d w a r e a n d s o f t w a r e in s t a l le d o n t h a t s y s t e m . In a n SA P s y s t e m , a c l i e n t c o r r e s p o n d s to a LS. T h e LS is a s s i g n e d t o t h e c l i e n t a n d p r o v i d e s i n f o r m a t i o n a s to w h e t h e r a d o c u m e n t w a s c r e a t e d o n t h a t SAP c l i e n t o r w h e t h e r i t w a s a d o p te d b y m e a n s o f c o n so lid atio n processes (th e m ajo rity o f d o c u m e n ts c o n t a i n t h e o r i g i n a l s y s t e m in a sp ec ific field in t h e d a t a b a s e ) . T h e a s s i g n ­ m e n t o f t h e LS is p a r t o f t h e p o s t - i n s t a l l a t i o n p r o c e d u r e s . A s y s t e m m u s t k n o w its o w n s y s t e m n a m e a s w e ll a s t h e n a m e s o f all LSs it c o m m u n i ­ c a te s w i t h . T h e LSs m u s t b e u n i q u e a c r o s s t h e e n t i r e e n t e r p r i s e ( a c t u a l l y a c r o s s th e

U n iq u e n e s s o f

e n t i r e r a n g e o f c o m m u n i c a t i o n ) . M o r e o v e r , t h e LSs f o r n o n -S A P s y s t e m s

lo g ic a l s y s te m s

w i t h w h i c h a c o m m u n i c a t i o n is e s t a b l i s h e d m u s t a l s o b e k n o w n . You c a n a s s i g n t h e LS f o r y o u r o w n c l i e n t a s w e ll a s m a k e s y s t e m s k n o w n w i t h w h i c h m e s s a g e s w ill b e e x c h a n g e d v ia A L E - C u s to m iz in g , w h i c h can b e r e a c h e d u s i n g T r a n s a c t i o n SALE. F ig u r e 1 .3 s h o w s t h e C u s to m i z i n g f u n c t i o n s , D e f i n e Logical S y s t e m a n d A s s ig n L og ical S y s t e m to C lie n t. T r a n s a c t i o n B D 5 4 e n a b l e s y o u to a s s ig n n a m e s t o LSs. In a d d i t i o n to th e n a m e f o r t h e LS, y o u s h o u l d a l s o e n t e r a b r i e f d e s c r i p t i o n .

S tru c tu re ^

ID o c li^ r f a c e V B a s ic S e ttin g s [ £ Q

ID o c A d m in is tra tio n ( £ > In b o u n d S O A P fo r ID o c : R e g is te r S e rv ic e P e rfo r m A u to m a tic W o r k flo w C u s to m iz in g

Q 1:7

A c tiv a te e v e n t re c e iv e r lin k a g e fo r ID o c in b o u n d L o g ic a l S y s te m s D e fin e L o g ic a l S y s te m A s s ig n L o g ic a l S y s te m to C lie n t____________________ |

F ig u re 1.3

S e ttin g U p Lo gical System s

1 .3

1

In tro d u ctio n

C u s to m e r

T h e cu sto m e r d istrib u tio n m o d el (T r a n s a c tio n B D 6 4 ) a l l o w s y o u to d e f in e

d i s t r i b u t io n m o d e l

w h i c h BAPIs a n d ID o c s w ill b e e x c h a n g e d b e t w e e n w h i c h s y s t e m s . In t h i s c o n t e x t , e a c h s y s t e m c a n f u n c t i o n as t h e s e n d e r o r re c e iv e r . I n o u r e x a m p l e (s e e F ig u re 1 .4 ), t h e LS t h e LS

SALES,

w h i l e t h e ID o c

T 9 0 CLNT0 9 0

M ATFET

T9 0 C LNT090

to

SALES,

M ATM A S

to

is s e n t in t h e o p p o s i t e d i r e c t i o n .

In a d d i t i o n , t w o BAPIs a r e e x c h a n g e d . T h e se n t from

s e n d s t h e ID o c

w h ile th e

M a te r i a 1 . G e tD e ta i 1

BAPI is

M a te r ia l . A v a il i b i 1 i t y

BAPI

is s e n t in t h e o p p o s i t e d i r e c t i o n .

D is tr ib u tio n M o d e l ^

^

ZSM 1

ggZSM I ^

0 X D O c lie n t 8 0 0 ^

@

V

^

T90C LN T090

S a l e s s y s te m (c lie n t 8 1 0 )

SALES

f a M ATM AS

M a te r ia l m a s t e r

$

D e te r m in e d e t a ils o n m a te r ia l

S t a n d a r d M a te r la l.G e tD e ta il

@

S a le s s y s te m (c lie n t 8 1 0 )

^

0

F ig u r e 1 .4

EDI

|D e s c r ip t io n /t e c h n ic a l n a m e

M o d e l v ie w s

SALES

X D O c lie n t 8 0 0

T90C LN T090

f a M ATFET

R e q u e s t m a te r ia l

$

A T P in fo rm a tio n

S ta n d a r d M a te r ia lA v a ila b ility

D is t r ib u t io n M o d e l w i t h E x a m p le f o r ID o c a n d B A P I

In c o n t r a s t to ALE a s a m e a n s o f e n t e r p r i s e - i n t e r n a l c o m m u n i c a t i o n , EDI (Electronic D a ta In terch a n g e) c o m p r i s e s t h e t r a n s f e r o f d a t a b e t w e e n d i f ­ f e r e n t e n t e r p r i s e s , f o r e x a m p l e , b e t w e e n c u s t o m e r s a n d s u p p l i e r s . Each c o m p a n y h a s its o w n p r o c e s s flo w s . H o w e v e r , a t c e r t a i n p o i n t s w i t h i n a p r o c e s s , t h e p a r t n e r m u s t b e i n f o r m e d . To p r e v e n t t h e p a r t n e r f r o m h a v ­ in g to e n t e r s p e c if ic i n f o r m a t i o n m a n u a l l y i n t o t h e s y s t e m , t h e r e l e v a n t i n f o r m a t i o n m u s t b e t r a n s m i t t e d to t h e p a r t n e r e le c tro n ic a lly . EDI is a l w a y s a n a s y n c h r o n o u s p r o c e s s . W i t h r e g a r d t o SA P s y s t e m s , th is m e a n s t h a t ID o c s a r c a ls o u s e d f o r EDI c o m m u n i c a t i o n . H o w e v e r , n o t e t h a t EDI c o m m u n i c a t i o n is a l w a y s c a r r i e d o u t w i t h o u t t h e d i s t r i b u t i o n m o d e l a n d LSs. W i t h i n t h e s y s t e m , t h e r e l e v a n t s e n d e r s a n d r e c e iv e r s o f m e s s a g e s a r e a ls o r e f e r r e d t o as p a r tn e r s ’, c u s t o m e r s a n d s u p p l i e r s a re o n e e x a m p le h e re . N o te th a t th e y m u s t b e m a in ta in e d as c u s to m e rs a n d s u p p l i e r s in t h e SA P s y s t e m . N o n e w , ID o c -s p e c ific m a s t e r d a t a is n e e d e d in t h i s c o n t e x t .

E D I s ta n d a r d s

B e c a u s e d i f f e r e n t c o m p a n i e s u s e d i f f e r e n t IT s y s t e m s , s p e c if ic E D I s t a n ­ d a r d s e x i s t to f a c ilita te d a t a tr a n s f e r s . In E u r o p e a n c o u n t r i e s , t h e EDI-

26

S u m m a ry

FACT s t a n d a r d is p r i m a r i l y u s e d , w h e r e a s i n t h e U n i t e d S ta te s , A N S I ASC X I 2 {A m erican N a tio n a l S ta n d a rd s In s titu te A ccred ited S ta n d a r d s C o m m ittee X I 2 ) is t h e p r e d o m i n a n t s t a n d a r d . EDIFACT a s s i g n s n a m e s to m e s s a g e s , w h i l e A N S I u s e s n u m b e r s . F o r e x a m p l e , a c c o r d i n g t o t h e E D IFA C T s t a n ­ dard, th e m essage

O R D ER S

rep resen ts a p u rch ase ord er; ac co rd in g to th e

A N SI s t a n d a r d , t h e s a m e m e s s a g e is c a lle d 8 5 0 . W i t h r e g a r d t o m e s s a g e t y p e s , SAP h a s b a s e d its n a m i n g c o n v e n t i o n s o n t h e E D IFA C T s t a n d a r d ; h o w e v e r, th e s tru c tu re o f th e m essag e s d iffe rs su b s ta n tia lly fro m that s t a n d a r d . ( C h a p t e r 2, G e n e r a t i n g ID o c s, d e s c r i b e s t h e s t r u c t u r e o f ID ocs in g r e a t e r d e t a i l . ) In SAP s y s t e m s , ID o c s a r e u s e d f o r a s y n c h r o n o u s d a ta t r a n s f e r s b o t h in E D I a n d ALE p r o c e s s e s , w h i c h is w h y t h e p r o c e d u r e s d e s c rib e d in th e c o u rs e o f th is b o o k c a n alw ay s b e a p p lie d to b o th w ays o f co m m u n icatio n . T h e f o l l o w i n g c h a p t e r s w i l l f o c u s e n t i r e l y o n u s i n g ID o c s . A s f a r a s t h e u s e o f BAPIs is c o n c e r n e d , i t's s i m i l a r to u s i n g f u n c t i o n m o d u l e s . C o n ­ s e q u e n tl y , d e v e l o p e r s w h o a r e f a m i l i a r w i t h f u n c t i o n m o d u l e s c a n c a r i y o u t all d e v e l o p m e n t ta s k s r e l a t e d t o BAPIs w i t h o u t a p r o b l e m . ID ocs, o n t h e o t h e r h a n d , c o n t a i n s o m e s p e c if ic f e a t u r e s t h a t a r e n ’t u s u a l l y d e s c r i b e d in d e v e l o p e r m a n u a l s . T h e s e s p e c if ic f e a t u r e s a r e d e s c r i b e d in th is b o o k .

1.4

S u m m a ry

I n t h i s c h a p t e r , w e d i s c u s s e d t h e r e a s o n s f o r u s i n g i n t e r f a c e s in g e n e r a l , as w e l l a s t h e t y p e s o f i n t e r f a c e s p r o v i d e d f r o m SAP. You l e a r n e d t h a t C u s t o m i z i n g a n d p r o g r a m m i n g w i t h ID o c s is v e i y i m p o r t a n t . I n t h e n e x t c h a p t e r , w e ’ll t a k e a d e e p e r l o o k a t ID o c s , b y s t a r t i n g a t t h e v e i y b e g i n n i n g - t h e d i f f e r e n t p o s s i b il i t i e s t o c r e a t e ID o c s f o r s e n d i n g t h e m t o o u r LSs o r p a r t n e r s .

27

|

1 .4

I n th e s e n d in g s y s te m , i t 's necessa ry to g e n e r a te ID ocs so t h a t th e y c a n b e s e n t to th e rec eivin g s y s te m . H o w th is is d o n e d e p e n d s on th e ty p e o f d a ta a n d th e a p p lic a tio n . T his c h a p te r describes th e d iffe r e n t g e n e r a tio n o p tio n s a n d th e ir use.

2

Generating IDocs

SAP h a s p r o v i d e d t o o l s f o r t h e g e n e r a t i o n o f I D o c s in all l o c a t i o n s w h e r e t h e y a r e u s e d i n ALE s c e n a r i o s o r c lassic ED I, a n d t h e y c a n u s u a l l y be a c tiv a te d u s in g th e C u sto m iz in g s e ttin g s . H o w e v e r, th e re a r e d iffe re n t m e t h o d s o f ID o c g e n e r a t i o n d e p e n d i n g o n t h e t y p e o f d a t a a n d t h e l o c a ­ t i o n w h e r e t h e ID o c w ill b e g e n e r a t e d . T h i s c h a p t e r p r e s e n t s t h e m o s t c o m m o n m e t h o d s o f ID o c g e n e r a t i o n . U s u a lly t h e ID o c a d m i n i s t r a t o r — n o t t h e d e v e l o p e r — i m p l e m e n t s t h e s e t t i n g s r e q u i r e d f o r c r e a t i n g th e p a r t n e r p ro f ile s , f o r i n s t a n c e , s o t h e y a r e o u t l i n e d o n l y b riefly, a n d m o r e i m p o r t a n c e is a t t a c h e d t o t h e f u n c t i o n a l p r o c e s s flow.

2.1

S ta n d a rd M e th o d s fo r th e ID o c

G e n e ra tio n

Initially, y o u m u s t d i s t i n g u i s h b e t w e e n t h e g e n e r a t i o n o f m a s t e r d a t a a n d th e g e n e ra tio n o f tran sa c tio n d ata b ec au se th e re are d iffe re n t re q u ire ­ m e n ts o n th e g e n e ra tio n process o r the g e n e ra tio n fre q u e n c y d e p e n d in g o n t h e t y p e o f d a t a . A s p e c ia l t o o l is a v a il a b le to g e n e r a t e m a s t e r d a t a , c a ll e d t h e S h a r e d M a s te r D a ta Tool (S M D ). T r a n s a c t i o n d a t a I D o c s a re g e n e r a t e d v ia t h e a l r e a d y - e x i s t i n g m e s s a g e c o n t r o l . T h e r e a r e a ls o s o m e s p e c ia l f u n c t i o n s f o r I D o c s t h a t a r c d i r e c t l y g e n e r a t e d in a p r o c e s s .

2.1.1

Shared M a ste r D a ta Tool

T h e S M D is a s p e c ia l t o o l f o r s e n d i n g m a s t e r d a t a v i a ID o c . M a s t e r d a t a

M a s te r d a ta

is c h a r a c t e r i z e d b y a r e la t iv e ly l o n g r e t e n t i o n p e r i o d in t h e s y s t e m d u r i n g

in t h e I D o c

29

2

|

G e n e ra tin g ID o cs

w h i c h t h e d a t a is c h a n g e d rarely. M a s t e r d a t a u s u a l l y c o n s i s t s o f m u l t i p l e v i e w s t h a t a r e n o t u s e d all t h e t i m e . You c a n o m i t v i e w s , i n c l u d i n g t h o s e t h a t c o n t a i n m a n d a t o r y field s, b e c a u s e t h e c h e c k o f w h e t h e r all m a n d a t o i y fields a r e p o p u l a t e d is o n l y c a r r i e d o u t i f t h e v i e w is a c tu a l ly u s e d . T h is e n a b l e s y o u to s e l e c t f r o m t h e w e a l t h o f i n f o r m a t i o n t h a t is o f f e r e d f o r a s p e c if ic o b j e c t a n d u s e e x a c t l y t h e d a t a t h a t is a c t u a l l y r e q u i r e d w ith in y o u r en terp rise. To d i s t r i b u t e d a t a u s i n g I D o c s , a n a u t o m a t e d p r o c e s s is d e s i r a b l e t h a t re s p o n d s to t h e c reatio n a n d m o d ificatio n o f m a s te r d a ta w ith o u t re q u ir­ i n g f u r t h e r u s e r i n t e r v e n t i o n s . A ls o , e m p t y v i e w s a r e n o t s u p p o s e d to be transferred. A u t o m a t io n a n d

T h e S M D tak es th e s e r e q u ir e m e n ts in to a c c o u n t. T h e tec h n ic a l im p le ­

c o n t r o l v ia v ie w s

m e n t a t i o n o f a u t o m a t i o n a n d c o n t r o l v ia v i e w s e n t a i l s t h a t a lre a d y -e x is tin g p ro c e d u re s ca n b e u se d fo r b o th fu n c tio n s. F o r a u to m a tio n , y o u r e v e r t to r e c o r d i n g c h a n g e s , w h i c h is i m p l e m e n t e d b y d e f a u l t ; f o r c o n ­ t r o l v ia v i e w s , y o u u s e t h e o p t i o n ( w h i c h o r i g i n a t e d f r o m b a t c h i n p u t p r o c e s s i n g ) to c o n t r o l i r r e l e v a n t fields u s i n g a

N0_DATA

c h a r a c te r . T h e n ,

t h e ID o c s a r e r e g u la r l y g e n e r a t e d v ia b a c k g r o u n d j o b s . A d d i t i o n a l ly , f o r a l m o s t all o b j e c t s , y o u a ls o h a v e t h e o p t i o n to e x p lic itly g e n e r a t e ID o c s o r t o r e q u e s t ID o c s . You c a n u s e t h i s o p t i o n i f w a i t i n g f o r p e r i o d i c a l l y s c h e d u l e d j o b s is i m p o s s i b l e .

R e co rd in g C hanges C h a n g e p o in t e r

F o r c o n s i s t e n c y r e a s o n s , c h a n g e s to t h e m a s t e r d a t a a r e u p d a t e d i n d e ­ p e n d e n t l y o f t h e u s e o f ALE in SAP s y s t e m s . F o r e a c h i n d i v i d u a l d a t a e l e m e n t o f t h e t a b l e s c o n c e r n e d , SA P h a s s t i p u l a t e d w h e t h e r a c h a n g e s h o u l d b e lo g g e d o r n o t . F ig u r e 2.1 s h o w s t h e

C

h a n g e

D

o c u m e n t

Fl a

g

,

w h i c h is a c ti v a te d in t h i s c a s e a s a n e x a m p l e o f B ISM T ( O ld M a te r ia l N u m ­ ber) f r o m t h e W r i t i n g t h e h is t o r y in t h e a p p lic a t io n

M ARA

ta b le

.

F o r u p d a t i n g t h e c h a n g e s , y o u a l w a y s call t h e

C H A N G E D O C U M E N T .O P E N

func­

tio n m o d u le , w h ic h p re p a re s th e w ritin g o f th e c h a n g e h isto ry . T h en , all c h a n g e s to b e w r i t t e n a r e c o l l e c t e d , a n d t h e p r o c e s s is c o n c l u d e d u sin g th e

30

C H A N G E D O C U M E N T .C L O S E

f u n c t i o n m o d u l e . B e c a u s e ID o c s a re

S tand ard M e th o d s fo r th e I D o c G e n e ra tio n

|

2 .1

s u p p o s e d t o b e g e n e r a t e d w h e r e v e r c h a n g e s a r e u p d a t e d b y d e f a u l t , th e CH A N G ED O C U M EN T_C LO SE

f u n c t i o n m o d u l e h a s a n ALE s h a r e in a d d i t i o n

to its s t a n d a r d f u n c t i o n . T h i s e n a b l e s y o u to g e n e r a t e ch a n g e p o in te rs f o r ALE f o r t h e d e s i r e d m e s s a g e t y p e s . In all U n i c o d e - e n a b l e d r e le a s e s , th i s is d o n e u s i n g t h e

C H A N G E _ P O IN T E R S _ C R E A T E _ L O N G

in o l d r e le a s e s , t h i s is d o n e u s i n g t h e

fu n c tio n m o d u le;

C H A N G E _ P O IN T E R S _ C R E A T E

fu n c tio n

m o d u le.

D ic tio n a ry: D isp la y Data Elem ent

ssiMMMiMMfisisMSMTsiasHi Data ele m e n t

BISH T

Short Description

Attributes

Active

Old m aterial num ber

D a ta Type

P«Aifi i.abei________

Search H elp Nam e Param eters

P a ra m e ter ID

Defau lt C o m p o n en t N a m e

Figure 2.1

OLD_HM_HO

C h a ra c te r is tic s o f D a ta E le m e n ts

You a ls o h a v e t h e

C H A N G E _ P O IN T E R S _ C R E A T E _ D IR E C T

f u n c t i o n m o d u l e as

a s e c o n d o p t i o n t o g e n e r a t e c h a n g e p o i n t e r s . T h i s f u n c t i o n m o d u l e is c a lle d b y a p p l i c a t i o n s t h a t a r e n o t c o n n e c t e d t o t h e p r e v i o u s l y d e s c r i b e d change m a n a g e m e n t fo r d o cu m en ts. In b o t h ca s e s , c h a n g e p o i n t e r s a r e o n l y w r i t t e n i f y o u u s e t h e S M D f o r p e r f o r m a n c e r e a s o n s . I n t h e ALE C u s t o m i z i n g , y o u c a n s p e c i f y w h e t h e r th i s is t h e c a s e a n d f o r w h i c h m a s t e r d a t a y o u r e q u i r e c h a n g e p o i n t e r s . T h e r e is a s e p a r a t e T r a n s a c t i o n c o d e SALE f o r t h e ALE C u s t o m i z i n g t h a t ta k e s y o u d i r e c t l y to t h e c o r r e c t p o s i t i o n in t h e m e n u t r e e . F ig u r e 2 .2 s h o w s t h e m e n u p a t h i n C u s t o m i z i n g in w h i c h y o u m a k e t h e n e c e s s a r y se ttin g s .

31

G e n e r a t in g c h a n g e p o in t e r s d ir e c t ly

2

|

G e n e ra tin g I D ocs

S tru c tu r e

___________________________________________________________________________

^.Interface P

B a s ic S e ttin g s

P

C o m m u n ic a tio n

^

M o d e llin g a n d Im p le m e n t in g B u s in e s s P r o c e s s e s

P

G lo b a l O rg a n iz a tio n a l U n its

t>

C o n fig u r e P r e d e fin e d A L E B u s in e s s P r o c e s s e s

M a in ta in D is tn b u tio n M o d e l a n d D is trib u te V ie w s

________ ^

M a s t e r D a t a D is tn b u tio n ^

R e p lic a t io n o f M o d ifie d D a ta B

( £ > A c tiv a te C h a n g e P o in t e r s - G e n e r a lly

_____________________________A c tiv a te C h a n g e P o in t e r s fo r M e s s a g e T y p e s ______________

F ig u r e 2 .2

A c t iv a t in g C h a n g e P o in te r s f o r t h e S M D

A c t iv a t in g c h a n g e

In itia lly , y o u a c t i v a t e t h e g e n e r a t i o n o f c h a n g e p o i n t e r s g e n e r a l l y . As

p o in t e r s

a r e s u lt, t h e s h a r e o f t h e CHANGEDOCUNENT_CLOSE f u n c t i o n m o d u l e t h a t h a s n o t b e e n u s e d u p t o n o w a n d t h a t is r e s p o n s i b l e f o r t h e S M D is r u n t h r o u g h . T h is m u s t b e s e t o n c e o n l y f o r all m a s t e r d a t a . F ig u r e 2 .3 s h o w s t h e a p p r o p r i a t e fu n c tio n a lity .

A c tiv a te C h a n g e P o in te rs G e n e ra lly

Activation s i a t u s / p ] C h a n g e p o in te rs activated - g e n e ra l^

F ig u r e 2 .3

A c t iv a t e C h a n g e P o in te rs G e n e ra lly

A c t iv a t in g c h a n g e

I f t h e c h a n g e p o i n t e r s a r e a c tiv a te d g e n e ra lly , y o u c a n s p e c if y i n a s e c o n d

p o in t e r s f o r o b je c t

s te p fo r w h ic h m essag e ty p e y o u re q u ire th e g e n e ra tio n o f ch a n g e p o in t­ ers . T h is is d o n e in t h e s e c o n d m e n u s u b i t e m (A c tiv a te C h a n g e P o in te rs f o r M e s s a g e T y p es) a n d h a s b e e n i m p l e m e n t e d f o r t h e m e s s a g e ty p e s , M ATMAS

for

and

M ATCOR

M ATMAS_W M S

and

m a t m a s .G

(s e e F ig u r e 2 . 4 ) . N o c h a n g e p o i n t e r s a r e w r i t t e n DS,

w h i c h h a v e n o t b e e n a c tiv a te d .

In t h i s c o n t e x t , it’s i m p o r t a n t t h a t a c h a n g e p o i n t e r i s n ' t w r i t t e n f o r ea c h c h a n g e d field b e c a u s e t h e r e a r e field s w h o s e v a l u e s a r e n o t s ig n if i­ c a n t f o r t h e d o w n s t r e a m s y s t e m . By m e a n s o f T r a n s a c t i o n B D 5 2 , SAP p r o v i d e s fields f o r e a c h m e s s a g e t y p e c o n n e c t e d to t h e S M D , w h i c h are r e l e v a n t f o r c h a n g e s f r o m SA P's p o i n t o f v iew . F o r t h e m a t e r ia l m a s te r , t h e DM AKT-SPRAS field is i m p o r t a n t , f o r e x a m p l e . I n t h e tr a n s a c tio n , y o u e n t e r t h e field s t h a t a r e u s e d w i t h i n y o u r e n t e r p r i s e . I f y o u ' v e m a d e

32

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

|

c h a n g e s t o t h e c o r r e s p o n d i n g m a s t e r d a t a t a b l e s v ia t h e SAP e n h a n c e ­ m e n t c o n c e p t a n d u s e c u s t o m e r - s p e c i f i c field s, y o u c a n a l s o s e t t h e c u s ­ t o m e r - s p e c i f i c fie ld s h e r e . R e fe r t o C h a p t e r 4 , C h a n g e s to ID o c s , to l e a r n h o w to p r o v i d e t h e s e fields.

C h a n g e V ie w "A c tiv a te C h a n g e p o in te rs f o r M e s s a g e T y p e " : ^

N e w E r f r .e s |

S |

Activate C h a n g e p o in te rs for M e s s a g e Type M essgType

active

|d

MATMAS

0

□

MATMAS_6DS

□

0

M ATHASJMS

0

MATQM

°

F ig u r e 2 .4

1

A c t iv a t e C h a n g e Po n te rs f o r M e s s a g e T yp e

C h a n g e V ie w "C h a n g e d o c u m e n t ite m s f o r m e ssa g e ty p e " : O ve rvie w ^

N e w Entries

Q .

©

©

Q

MATMAS

M e s s a a e Type

C h a n a e do c u m en t item s fo r m e s s a a e fro e T“

O bject

[fa b le N a m e

MATERIAL

D6ESV

fFieiC N a m e KEY

MATERIAL

D6ESV

KOVBM

MATERIAL

D6ESV

VBWRT

MATERIAL

DMAKT

KEY

MATERIAL

DMAKT

flAKTX

MATERIAL

|DMAKT___________________________

[SPRAS

m• AT I FC lPMl 1A1L

rM t PnNn U nA

R Pe 1I T1 oR n

MATERIAL

DMARM

BR6EW

MATERIAL

pHARH

EAN11

MATERIAL

DMARM

GE WEI

1ATERIAL

DMARM

GTIN_VARIAMT

MATERIAL

DMARM

HOEHE

MATERIAL

DMARM

KEY

|

___

F ig u r e 2 .5

C h a n g e -R e le v a n t F ie ld s in T ra n s a c tio n B D 52

F ig u r e 2 . 5 s h o w s a s e c t i o n o f t h e field s f o r t h e

M ATMAS

m essag e type,

w h i c h a r e p r o v i d e d b y SAP a s c h a n g e - r e l e v a n t . T h e m e s s a g e t y p e is d i r e c t ly r e f e r e n c e d to fields a n d ta b le s o f t h e m a t e r ia l m a s t e r e x c e p t f o r t h e KEY field . T h is field i s n ’t p a r t o f t h e r e s p e c t i v e t a b l e b u t a s s u m e s a v e i y i m p o r t a n t , a d d i t i o n a l c o n t r o l ro le : It e n s u r e s t h a t t h e c r e a t i o n o f a

33

C h a n g e - r e le v a n t f ie ld s

2 .1

2

|

G e n e ra tin g ID o cs

ta b le e n t r y c a n b e s e n t v i a ID o c . I f t h e KEY field is s p e c if ie d in T ra n s a c ­ t i o n B D 5 2 , a c h a n g e p o i n t e r is w r i t t e n d u r i n g t h e c r e a t i o n o f t h e c o r r e ­ s p o n d i n g o b j e c t , f o r e x a m p l e , d u r i n g t h e in itia l c r e a t i o n o f t h e m a t e r ia l f o r t h e M A R A -K EY d u m m y field o r d u r i n g t h e c r e a t i o n o f a t e x t in a n e w l a n g u a g e f o r t h e M AKT-KEY d u m m y field. I m a g i n e t h a t t h e k e y v a l u e o f t h e ta b le c o n c e r n e d is c h a n g e d f r o m " e m p t y " to t h e n e w v a l u e . A s a re s u lt, all fie ld s o f t h i s t a b l e a r e t r a n s f e r r e d . A s s ig n in g c h a n g e ­

A d d i t i o n a l ly , f o r e a c h o f t h e c h a n g e - r e l e v a n t field s, y o u m u s t s p e c if y to

r e le v a n t fie ld s

w h i c h fie ld in w h i c h s e g m e n t o f t h e I D o c t y p e it b e l o n g s . T h i s is d o n e in T r a n s a c t i o n B D 6 6 , w h i c h is s h o w n i n F ig u r e 2 . 6 . T h e DMAKT-SPRAS s a m p l e fie ld f r o m T r a n s a c t i o n B D 5 2 b e l o n g s t o t h e E1MAKTM I D o c s e g ­ m e n t a n d t o t h e field t h a t is a ls o c a lle d "SPRAS." F o r y o u r o w n fields, y o u m u s t s p e c if y t h i s u s i n g t h e N e w E n t r i e s b u t t o n .

C h a n g e V ie w "S e g m e n t F ie ld - C h a n g e D o c u m e n t F ie ld ” : O v e rv ie w *

N e w E n tn e s

MATMAS

M e s s a g e Type

S e g m e n t F ie ld - C h a n g e D o c u m e n t Field S e g m e n t type

F ie ld N a m e

1MAKTM

O bject MATERIAL

Table N a m e

: ie id N a m e

j

DNAKT

key

m

1MAKTM

MAKTX

MATERIAL

DMAKT

MAKTX

W

1MAKTM

SPRAS

MATERIAL

DMAKT

SPRAS

I ]

MATERIAL

MARA

KEY AENAM

1MARAM 1MARAM

AENAM

MATERIAL

MARA

1MARAM

AESZN

MATERIAL

MARA

AESZN

1MARAM

8E6RU

MATERIAL

MARA

8E6RU

1MARAM

BEHVO

MATERIAL

MARA

8EHV0

1MARAM

8 IS M T

MATERIAL

MARA

8 IS M T

1MARAM

8LA NZ

MATERIAL

MARA

8LANZ

tMARAM

8L A T T

MATERIAL

MARA

8LA TT

1MARAM

8MATN

MATERIAL

MARA

8MATN

F ig u r e 2 .6

A s s ig n m e n t o f I D o c F ie ld s t o C h a n g e - R e le v a n t F ie ld s

E v a lu a t in g c h a n g e

T h e c h a n g e p o i n t e r s a r e t h e n e v a l u a t e d . It j u s t d e p e n d s o n t h e o b j e c t

p o in t e r s

c o n c e r n e d w h i c h f u n c t i o n m o d u l e is u s e d h e r e . W h e n y o u call T ra n s a c ­ tio n BD60, y o u can v ie w th e s e f u n c tio n m o d u le s a n d re p la c e th e m w ith y o u r o w n f u n c t i o n m o d u l e s i f y o u w a n t to m a k e s o m a n y c h a n g e s t o t h e

34

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

|

s t a n d a r d f u n c t i o n a l i t y t h a t y o u d o n ’t w a n t to e n h a n c e o r m o d i f y t h e SAP o r i g i n a l . F ig u re 2 . 7 s h o w s a n o t h e r e x a m p l e o f t h e m a t e r i a l m a s t e r d a ta . T h e r e , t h e f u n c t i o n m o d u l e t h a t u s e s c h a n g e p o i n t e r s t o g e n e r a t e ID o cs is c a ll e d

M ASTER I DO C_CREATE_SM D_M ATM AS.

C h a n g e V ie w " A d d it io n a l D a ta f o r M e s s a g e T y p e " : O v e r v ie w ^

Q

N e w E n tr .e s

A d d itio n a l D a t a fo r M e s s a g e T y p e M essgType

-

F u n d Mod

T a b le

hathas

Im a t h a s

HA STE R ID O C _C R E A TE _SM D _H A TM A S

HARA

nA TH A SJM S

|MATHAS

N A STE RIDO C_C RE ATE _SM D_M A TM A S

URA

F ig u r e 2 .7

The

R e fm s g .

E j

F u n c tio n M o d u le s t o E v a lu a te C h a n g e P o in te r s

R B D M I DOC

r e p o r t , w h i c h m u s t b e s c h e d u l e d a t r e g u l a r i n t e r v a ls , m u s t

t h e n u se th e s e f u n c tio n m o d u le s to g e n e r a te ID ocs fro m t h e c h a n g e

" R B D M ID O C ” b a c k g ro u n d jo b

p o i n t e r s a n d u p d a t e w h i c h c h a n g e p o i n t e r s h a v e b e e n p r o c e s s e d . As a t r a n s f e r v a l u e , y o u c a n s p e c i f y f o r w h i c h m e s s a g e t y p e y o u w a n t to i m p le m e n t th e ev a lu a tio n . F or th is p u rp o s e , y o u sp ec ify th e a p p r o p ria te ty p e (here: R B D M I DOC

m atm aS)

in t h e M e s s a g e T y p e field in t h e in itia l s c r e e n o f t h e

r e p o r t . T h i s is i l l u s t r a t e d in F ig u r e 2 .8 .

C r e a tin g ID o c T y p e f r o m C h a n g e P o in te r s

M e s s a g e ty p e

F ig u r e 2 .8

MATMAS|

E>

I n it ia l S c re e n o f t h e " R B D M I D O C " R e p o rt

F o r s e n d in g ID ocs u sin g th e S M D a n d fo r c h a n g e p o in te rs , th e a p p lica­

C h a n g e s in th e

t i o n a n d t h e ALE c o m m u n i c a t i o n l a y e r i n t e r a c t closely. F ig u re 2 . 9 s c h e ­

SMD

m a t i c a l l y s h o w s t h e p r o c e s s f l o w o f ID o c g e n e r a t i o n . T h e e n t i r e p ro c e s s o f w r i t i n g c h a n g e p o i n t e r s t a k e s p la c e in t h e a p p l i c a t i o n ; t h e e v a l u a t i o n o f th e c h a n g e p o in te r a n d th e g e n e ra tio n o f ID ocs are carried o u t b y th e ALE c o m m u n i c a t i o n lay er.

35

2 .1

2

|

G e n e ra tin g ID o cs

A p p lic a tio n

1.

W r it e n o r m a l h is to r y

2.

C h e c k i f c h a n g e p o in t e r s a r e g e n e r a lly s u p p o s e d t o b e w r i t t e n

3.

C h e c k i f c h a n g e p o in te r s a r e s u p p o s e d t o b e w r i t t e n f o r th e o b je c t in q u e s tio n

4.

W r i t e c h a n g e p o in te r s

R B D M ID O C

A p p lic a t io n D ocum ent

C hange

1.

R e a d c h a n g e p o in te r s

2.

W r it e ID o c

3.

M a r k c h a n g e p o i n t e r s as

P o in t e r s

p ro c e s s e d

Change Docum ent

F ig u r e 2 .9

ID o c G e n e r a t io n U s in g t h e S M D

N o t e t h a t w h e n y o u s e n d ID o c s v ia c h a n g e p o i n t e r s , y o u o n l y s e n d t h o s e v i e w s in w h i c h c h a n g e s h a v e a c tu a l ly b e e n m a d e . I f a n e w v i e w h a s b e e n c r e a t e d , all its fie ld s a r e t r a n s f e r r e d ; i f a v i e w h a s b e e n c h a n g e d , o n l y t h e c h a n g e d fie ld s a r e t r a n s f e r r e d to i n c r e a s e p e r f o r m a n c e . C h a p t e r 4, C h a n g e s t o ID o c s , u s e s t h e e x a m p l e o f t h e m a t e r i a l m a s t e r t o d e s c r i b e h o w y o u c a n c h a n g e th is d e fa u lt b e h a v io r u s in g a m i n o r m o d ificatio n . You c a n f i n d t h e c h a n g e p o i n t e r s in t h e in g s t a t u s r e c o r d s in t h e

BDCPS

BD C P

tab le a n d th e c o r re s p o n d ­

t a b l e . As o f SAP N e t W e a v e r A p p l i c a t i o n

S e r v e r 6 . 2 0 (SAP N e t W e a v e r AS), p r o c e s s i n g w i t h h i g h e r p e r f o r m a n c e is p o s s i b l e v ia a s h a r e d t a b l e c a lle d

BDC P2.

H o w e v er, th is n e w p ro c e d u re

i s n 't s u p p o r t e d f o r all m e s s a g e t y p e s . W h e t h e r i t's a p p l i c a b l e f o r y o u r m e s s a g e t y p e is i n d i c a t e d in t h e d e ta il v i e w o f T r a n s a c t i o n B D 6 0 . A s o f R e le a se 7 . 1 , o n l y t h e n e w p r o c e s s i n g u s i n g T a b le

8DCP2

is a v a il a b le f o r

all m e s s a g e ty p e s . D i s t r i b u t i o n lo c k

F o r t h e d i s t r i b u t i o n v i a t h e S M D , y o u m u s t c o n s i d e r s o m e sp e c ific s f o r s o m e m a s t e r d a t a . You c a n s e t a d i s t r i b u t i o n lo c k f o r t h e m a t e r i a l m a s ­ t e r to g e n e r a l l y p r e v e n t t h e s e n d i n g o f a m a t e r i a l . F o r t h i s p u r p o s e , y o u

36

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

m u s t m a k e a s h o r t d e t o u r . In t h e d e s i g n d a t a o f t h e m a t e r ia l in t h e

|

2 .1

m a ra

ta b l e , t h e r e is a c r o s s - p l a n t m a t e r i a l s t a t u s (M A R A -M S T A E field ). T h is s t a t u s r e f e r s t o a n e x i s t i n g e n t r y in t h e

T14l

ta b le . H e r e , y o u c a n as s ig n

a d d i t i o n a l p r o p e r t i e s f o r e a c h s t a t u s v a l u e . I f t h e DLOC K field p r o v i d e d h e r e is s e l e c t e d , t h e d i s t r i b u t i o n lo c k is set. F o r co n tracts

(B L A O R D

m e s s a g e t y p e ) , o n l y r e le a s e d c o n t r a c t s a r e t r a n s ­

ferred u sin g th e SMD.

R e d u c in g M e ssa ge s T h e s e c o n d r e q u i r e m e n t o n t h e d i s t r i b u t i o n o f m a s t e r d a t a a r is e s fr o m t h e d i s t r i b u t i o n o f all m a s t e r d a t a t o i n d i v i d u a l v i e w s a n d t h e o p t i o n to d e f in e , in C u s t o m i z i n g , w h i c h fie ld s o f a v i e w a r e a c t u a l l y s u p p o s e d to b e u s e d . T h i s is s c a la b l e f o r t h e ID o c t r a n s f e r b y u s i n g t h e r e d u c e d m e s ­ s a g e ty p e s . A r e d u c e d m e s s a g e t y p e a l w a y s r e la t e s t o a n e x i s t i n g m e s s a g e t y p e b u t

R e d u ce d m essage

t r a n s f e r s le ss d a t a . T h e r e d u c t i o n i s n ' t p o s s i b l e f o r a ll m e s s a g e t y p e s ;

ty p e

s o t h e d e v e l o p e r o f t h e m e s s a g e t y p e m u s t e x p l i c i t l y d e f i n e it a s r e d u c ­ ib le . All v i e w s a n d fie ld s t h a t m u s t b e t r a n s f e r r e d a s a m i n i m u m a rc p r e d e f i n e d h e r e ; all o t h e r v i e w s a n d fie ld s c a n b e s e l e c t e d a d d i t i o n a l l y i f r e q u i r e d . T r a n s a c t i o n B D 6 0 in t h e d e t a i l v i e w f o r a m e s s a g e t y p e is t h e t r a n s a c t i o n f o r d e f i n i n g a m e s s a g e t y p e as r e d u c i b l e . B y c a llin g T r a n s a c ­ ti o n B D 6 5 , y o u d e f i n e t h e m a n d a t o i y fields. F o r e a c h d e l i v e r e d m e s s a g e t y p e , SAP s p e c if ic s w h e t h e r i t ’s r e d u c i b l e . B e c a u s e t h i s i n v o l v e s f u n c t i o n s in t h e g e n e r a t i o n a n d u p d a t e m o d u l e fo r t h e c o r r e s p o n d i n g ID o c , c u s t o m e r s c a n ' t s i m p l y s e t t h e m e s s a g e t y p e to r e d u c i b l e r e tr o a c t i v e l y . T h e m a n d a t o r y fie ld s t h a t SAP p r o v i d e s w i t h T r a n s a c t i o n B D 6 5 c o r r e s p o n d t o t h e C u s t o m i z i n g t h a t SA P p r o v i d e s f o r t r a n s a c t i o n s t h a t a r e u s e d to m a i n t a i n m a s t e r d a t a , f o r i n s t a n c e , T r a n s ­ a c t i o n M AT1 f o r m a i n t a i n i n g t h e m a t e r ia l m a s t e r . I f y o u m a k e c h a n g e s to t h e m a n d a t o r y fie ld s in t h e a p p l i c a t i o n 's C u s t o m i z i n g , y o u a ls o a d a p t t h e m in T r a n s a c t i o n B D 6 5 s o t h a t c u s t o m - d e v e l o p e d m a n d a t o i y fields a r e a ls o m a n d a t o r y f o r r e d u c i n g in t h e ID o c. F ig u r e 2 . 1 0 s h o w s a s e c t i o n o f th e d ata fo r th e

M ATM AS

m e s s a g e ty p e .

37

G e n e r a tin g ID o c s

C h a n g e V ie w " A d d itio n a l D a ta f o r M e s s a g e T y p e " : D e ta ils

\

N*w Entn*$ ] 1 2

B D 6 0 - D e ta il

Type

S A P d e fin e s m e s s a g e ty p e

i£>

a y

" A T IU S

A aom onM O a t a t a M e s s a g e l i o e

Additional o,u

a s r e d u c ib l e

R e fe re n c e M e s s a g e Type

f o r m * F u n ctio n M odulo

C h a n g e V ie w " M a n d a t o r y F ie ld s o f M e s s a g e T y p e " : O v e rv ie w N e w E n t r ie s

Q Ei

B D

M » n o » io r v f n i a t o ' w « s » g » t » d *

B D 65 IHAKTH

1HMIH D e f i n e m a n d a t o r y f ie l d s

. th

S P ftA S

ih a r m i

6»0ES

ih a

(b o th S A P a n d y o u )

1 1 1 *6 *"

VOS"

«««

(U T K l

ih a

IHMM 1HMU1

lU lltft

1HA®»H

fin s

ih a

E I*

H 8RSH

*»k

ih a h

F ig u r e 2.10

ru m HS6FX

«h

HTAR1

IN A R M

P S IA t

ih a s » h

SPA RI

B a s ic M a i n t e n a n c e f o r R e d u c i b l e M e s s a g e T y p e s

R e d u c t io n in

You t h e n c r e a t e y o u r o w n r e d u c e d m e s s a g e t y p e s in C u s t o m i z i n g o f

C u s t o m iz in g

T r a n s a c t i o n SALE. U n d e r t h e C r e a te R e d u c e d M e s s a g e T y p e m e n u i t e m o r v i a T r a n s a c t i o n B D 5 3 y o u c a n fin d t h e in itia l s c r e e n a s s h o w n in Fig­ u r e 2 .1 1 .

Structure

^ Df

5®.f P ! 1.':? P.^P.®!?.9.

I

B asicSettno’s

I

Comm unication

^

Modelling an d im plem enting B usiness Processes

P

Q<

G loba l O rg a n iz a tio n a l Units Maintain Distribution Model and Distribute Views

I' Q t

Configure Predefined A i E B usiness Processes

“

Master D ata Distribution

Q . l>

Replication o f Modified Data

^

v

S e n alizato n for Sending an d Receiving Data ^ v

Scope o f D ata for Distnbution [£

M essag e Reduction Q Q

F ig u re 2 .11

< £ Create Reduced M essag e Type G enerate Transport Request for M essage Type

C reate R e d u ced M e ssag e Type

S ta n d a rd M e th o d s fo r th e ID o c G e n e ra tio n

W h e n y o u s p e c if y t h e n a m e o f t h e n e w r e d u c e d m e s s a g e t y p e (see F ig u re 2 .1 2 ), y o u m u st c o n s id e r th e n a m in g ru les for y o u r o w n o b jec ts

R e d u c tio n s te p s

(th e

n a m e m u st start w ith Y o r Z o r y o u r o w n nam espace).

ID o c R e d u c t io n M a in t e n a n c e : In it ia l S c r e e n [0

]\0 \

1 [ a ] 11A C K W Change pantm

Reduced mes s a g e

] C * t t l V i » ( M j l P O r tt'S

?S «1

S te p 1 :

R e d u c e d m o s s a g o t*te

Wo ieW «nn

4“

B.

& S w e c t « n o ' M e s t a ? e T . s e as ntfifencetc*** Reducoon

A s s ig n n a m e a n d d e s c r ip t io n

ZSMI

IUTIU$

ID o c R e d u c t io n M a in t e n a n c e : In it ia l S c r e e n

?

0

■£>-

0

* i ~ j t e c h a n g e p o .- * * - *

Poduce
o e a < tr-a *

e o m i e 'S

Z$P1

£ ( nler D e s t X f i o n ( ' Reil«ne - 1 n e ^ < * ; * V p e B o d u c e a m e s s a g e tipe

ZSMI

Dosircdon

S a e < n e s B o d u i e o Matonal

M e s s a g e Sine reference

M»TU*S

Doscr«Oon

Material m a s t e i

✓* "■TPiSDl

u

C u t to

Field Distribution (•) P a s t e r u t e r 1 1 1 g e n e n l

J1"«K >8

1

—

EE

1

data

(PARA)

S te p 2 :

(•) A d d i t i o n a l f i e l d * t o r { i p a k a k

(•) Discrete Industries Fields IPAUP

I*) P a s t e r « i t e r u l

1 HAKCB 11 Ml nur.nn

(•) Raster e a te n al C segeent (PABC) (•) P a s t e r e a t e r i a l

units of M a t u r e

1 HBCM"

(•) Ita s t e r e a t e n a l

eateriil

imam

(.) Paster e a te n al e a te n a l data p e r (•) P a t t e r e a t e n a l s a l e s d a t a (PVIC)

1P V K " 1 Ml 11.1

S e le c t r e le v a n t

(PMI)

s e g m e n ts

(IMS*)

valuation

(PBC»)

earehouse nueeer

(•) P a s t e r e a t e n a l

l o n g teit

F.eiflt

Field

Text

PSfiFK HATXfi

(•) F u n c t i o n (•) " a t e r t a l

Kuabcr

S te p 3 :

(•) H a a e o f P o r s o n e h o C r o a t e d t h e O b ) e c t

4—

<-) D a t e o f l a s t C h a n g e

IVOR" «T«RI

(•) F l a g P a t e r i a l

PBBSH

(*)

eisnr

(-) O l d a l t e r l « l

F ig u r e 2.12

S e le c t r e le v a n t fie ld s p e r segm ent

PSIA1

P E IUS

(P i 6 ti

( -) Paster e a te n el t » . c la s s ific a tio n (PiA*)

1 P T 1 HJ1

la- Se^neM £i

short teits

( ’) " a t e r i a l

for Deletion at C H » n t

level

Type

Industry sector nuaber

(•) B a s e U n i t o f " e a s u r e ----------------- L L f r r c W e O r d e r U n y t . o p e . s u r o ______________________

C r e a tin g a R e d u c e d M e s s a g e T yp e

S e g m e n t s a n d f ie ld s t h a t a r e g r e e n in t h e SAP s y s t e m a n d d i s p l a y e d w i t h a n * b e h i n d t h e n a m e a r e m a n d a t o r y a n d c a n ’t b e r e d u c e d . F ie ld s a n d s e g m e n ts t h a t a r c re d o r m a rk e d w ith - arc o p tio n a l a n d n o t selected ; s e g m e n t s o r fie ld s t h a t a r e w h i t e o r m a r k e d w i t h + a r e o p t i o n a l a n d s e l e c t e d in t h e r e s p e c t i v e r e d u c e d m e s s a g e t y p e . You n o w s p e c i f y w h i c h

39

|

2 .1

2

|

G e n e ra tin g ID o cs

s e g m e n t s y o u w a n t to h a v e in a d d i t i o n to t h e m a n d a t o r y s e g m e n t s b y s e l e c t i n g t h e s e g m e n t a n d c l i c k i n g S elect. As s o o n a s y o u ' v e a c t i v a t e d a s e g m e n t , y o u c a n s e l e c t t h e fields w i t h i n t h e s e g m e n t y o u w a n t to h a v e i n a d d i t i o n t o t h e m a n d a t o i y field s, a n d t h e n c lick S e le c t a g a in . C h a n g e p o in t e r s

I f y o u w a n t to g e n e r a t e c h a n g e p o i n t e r s f o r c u s t o m r e d u c e d m e s s a g e

f o r re d u c e d

t y p e s , y o u c a n a c t i v a t e t h e g e n e r a t i o n in T r a n s a c t i o n B D 5 3 u s i n g t h e

m e s s a g e ty p e s

A c t i v a t e C h a n g e P o i n t e r s b u t t o n . O f c o u r s e , y o u c a n a ls o a c t i v a t e t h e c h a n g e p o i n t e r s f o r t h e r e d u c e d m e s s a g e t y p e in C u s t o m i z i n g o f T ra n s a c ­ t i o n SALE. H e r e , y o u m u s t m a k e s u r e t h a t y o u n o t o n l y s e t t h e flag s f o r g e n e r a t i n g c h a n g e p o i n t e r s b u t a ls o c o p y all s t a n d a r d fie ld a s s i g n m e n t s a n d m a n d a t o i y field a s s i g n m e n t s , w h i c h is a u t o m a t i c a l l y d o n e i n T r a n s ­ a c t i o n B D 5 3 . In T r a n s a c t i o n B D 5 3 , y o u c a n a l s o d i s a b l e t h e w r i t i n g o f c h a n g e p o i n t e r s u s i n g t h e D e a c t i v a t e C h a n g e P o i n t e r s b u t t o n (s e e F ig u re 2 .1 3 ) .

IDoc Reduction M aintenance: Initial Screen □

*

all

A c tiv a te c h a n g e p o in te rs

R e d u c e d m e s s a g e ty p e

F ig u r e 2.13

D e a c tiv a te c h a n g e p o in te rs

[Z S M

G )

A c t iv a t e t h e C h a n g e P o in te r f o r R e d u c e d M e s s a g e T ypes

D ire c tly G e n e ra tin g o r R e q u e s tin g M a s te r D a ta If y o u w a n t to p u b lis h th e c re a tio n o r c h a n g e o f m a te ria l m a s te r d a ta w i t h o u t w a i t i n g f o r ID o c s t h a t a r e g e n e r a t e d f r o m c h a n g e p o i n t e r s , y o u c a n u s e T r a n s a c t i o n B D 1 0 . I n T a b le 7 . 5 o f C h a p t e r 7, S e c t i o n 7 . 3 , T r a n s ­ a c t i o n C o d e O v e r v i e w , y o u c a n a ls o f i n d t h e t r a n s a c t i o n s t h a t b e l o n g to o t h e r m a s te r d ata. S e n d in g

B ecause m a s te r d a ta usu ally offers th e o p tio n o f re d u c tio n , th e s e tran sa c­

m a s te r d a t a

t i o n s " e x p e c t " y o u to e n t e r t h e m e s s a g e t y p e y o u w a n t to u s e f o r s e n d i n g a n d t h e lo g ic a l t a r g e t s y s t e m s y o u w a n t to s e n d t o . A d d i t i o n a l ly , y o u c a n s e l e c t t h e o b j e c t s y o u w a n t to g e n e r a t e ID o c s for. H o w e v e r , t h i s is o n l y p o s s i b l e v i a t h e m a t e r ia l n u m b e r s o r t h e c lass m e m b e r s h i p o f t h e o b j e c t (see F ig u r e 2 .1 4 ) .

40

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

S e n d M a te ria l & o M ate rial C la s s M e s s a g e T y p e (S ta n d a rd ) L o g ic a l s y s te m □

S e n d m a te r ia l in full

P a r a lle l p r o c e s s in g S e rv e r group N u m b e r o f m a te r ia ls p e r p ro c e s

F ig u r e 2.14

T a rg e te d S e n d in g o f M a t e r ia l M a s t e r ID o c s

I f y o u a c t i v a t e d t h e S e n d M a t e r i a l in F ull flag a n d a ls o s e t t h e d i s t r i b u ­

S e n d in g t h e

t i o n o f c l a s s i f i c a t io n I D o c s t o t h e s a m e p a r t n e r , t h e s y s t e m g e n e r a t e s

m a te r ia l

t h e c l a s s if ic a tio n ID o c t h a t b e l o n g s t o t h e m a t e r i a l a d d i t i o n a l l y t o t h e m a t e r i a l ID o c itself. T h e s p e c i f i c a t i o n s f o r t h e p a r a lle l p r o c e s s i n g h e l p y o u in c re a se th e p e r fo rm a n c e i f y o u s e n d a h ig h q u a n tity o f d ata, for in s t a n c e , f o r in itial d a t a l o a d . I f y o u le a v e t h e L o gical S y s te m field e m p t y , t h e d a t a is s e n t to all p a r t n e r s t h a t a r e a v a il a b le in T r a n s a c t i o n B D 6 4 . I f a s e l e c t i o n is m a d e , T r a n s a c t i o n B D 6 4 c h e c k s w h e t h e r t h e s e l e c t e d logical s y s t e m is p e r m i t t e d a s a r e c e i v e r o f t h e m a t e r ia l m a s t e r ID o c s . I f t h e r e is a p o s i t i v e r e s u lt , t h e s y s t e m s e n d s t h e ID oc. I f y o u a r e t h e r e c e i v e r o f m a s t e r d a t a ID o c s a n d k n o w t h a t t h e s e n d i n g sy s te m h a s c h a n g e d o r has n e w ly cre a te d d ata, y o u c a n re q u e s t a c o r re ­ s p o n d i n g m a s t e r d a t a ID o c . T h e n a m e o f t h e a p p r o p r i a t e m e s s a g e t y p e s t a r t s lik e t h e m a s t e r d a t a I D o c b u t u s e s a n o t h e r a b b r e v i a t i o n a t t h e e n d , t h a t is,

FET

( f o r " fe tc h " ) i n s t e a d o f

MAS.

F o r e x a m p l e , t h e n a m e is

fo r th e m e ssa g e ty p e o f th e m a te ria l m a s te r ID o cs a n d

mat

FET

M ATM AS

for th e

fe tc h ID o c. T h e s e f e t c h IDocs m u s t b e m a i n t a i n e d a s u s u a l in t h e d i s t r i b u t i o n m o d e l ( s e e F ig u r e 1 . 4 in C h a p t e r 1, S e c t i o n 1 . 3 , D i f f e r e n t i a t i o n o f ALE a n d EDI) — j u s t in t h e o t h e r d i r e c t i o n ; h e r e , t h e p a r t n e r t h a t r e c e i v e s t h e m a s t e r d a t a I D o c s e n d s t h e f e tc h ID o c . F e tc h ID o c s a l w a y s t r a n s f e r th e

41

F e tc h I D o c

|

2 .1

2

|

G e n e ra tin g ID o cs

ob ject k e y for w h ic h m a s te r d ata ID ocs a r e re q u e s te d a n d th e m essag e t y p e t h a t is s u p p o s e d to b e u s e d t o s e n d t h e d a t a . You c a n u s e T ra n s a c ­ t i o n B D 11 t o " g e t" m a t e r i a l m a s t e r s (s e e F ig u re 2 .1 5 ) .

G et Material

--------------------------

M a te ria l

=

i

C la s s 2SM11

M e s s a g e type

F ig u r e 2.15

“ALEREQOr IDoc tyPe

The sam e

0

R e q u e s tin g t h e M a t e r ia l M a s t e r I D o c

ALER EQ 01

ID o c t y p e is a s s i g n e d t o all f e t c h m e s s a g e t y p e s . It

c o n t a i n s t h e s e g m e n t s s h o w n in F ig u r e 2 .1 6 .

■ 6enera1 r e q u e s t - B a s is lO oc t y p e B a s ic t y p e R e lease d O R e lease d f r o a R e le a s e 3 0 * D is p la y f o r R e le a s e 46C V e rs io n 3 o f ID oc r e c o r d t y p e s ID oc r e c o r d t y p e s f o r SAP R e lease 4 0

IT " L -O

‘ to

■ • A l t r e q u e s t ID oc hea der sega ent S egaent d e f i n i t i o n E2AIER100I R e le a s e d f r o a R e le a s e 40A • a n d a to r y a l n /a a x . O0OOOOO0O1/OOOOOOM99

E1AIER1

3 Seoaent f i e l d s --------- n£ST>P

■ o o L o g ic a l aessage ty p e I n t e r n a l le n g t h 000006 E x te r n a l le n g t h 000006 O ff s e t 000063 D a ta t y p e CHAR D a ta e le a e n t E01J1ES1P3 » o o nessa ge ty p e I n t e r n a l le n g t h 000030 E x te r n a l le n g t h 000030 O ff s e t 000069 D a ta t y p e CHAR D a ta e le a e n t E0IJ1ES1YP

'--------- HESIYP4Q

E1ALE01

■ • AIE R equest ID oc • I t e a Segaent Segaent d e f i n i t i o n E2AIEG1 R e le a s e d f r a a n d a to ry a m . / t a x . 0000000001 .

tse 30A

Segaent f i e l d s ---------0BJVALUE

-SI6M ---------OPTION

-HISH

F ig u r e 2.16

42

■ o o O b je c t v a lu e ( e i t h o l d le n g t h o f 40) I n te r n a l le n g t h 000040 E x te r n a l le n g t h 000040 D a ta t y p e CHAR D a ta e le a e n t F08JV01D ■ o 0 ABAP: ID : l/ E ( in c lu d e / e x c lu d e v a lu e * ) I n t e r n a l le n g t h 000001 E x te r n a l le n g t h 000001 D a ta t y p e CHAR D a ta e le a e n t TVARV_SISN ■ o o ABAP: S e le c t io n o p t io n (E 0 /B T /C P /.. . ) I n te r n a l le n g t h 000002 E x te r n a l le n g t h 000002 D a ta t y p e CHAR D a ta e le a e n t TVARV.OPTI ■ o o C h a ra c te r f i e l d o f le n g t h 40 I n t e r n a l le n g t h 000040 E x te r n a l le n g t h 000040 D a ta t y p e CHAR D a ta e le a e n t CHAR40 ■ o o C h a ra c te r f i e l d o f le n g t h 40 I n t e r n a l le n g t h 000040 E x te r n a l le n g t h 000040 D a ta t y p e CHAR D a ta e le a o n t CHAR40

'A L E R E Q 0 1 " I D o c T yp e

O f f s e t 000063

O f f s e t 000103

O f f s e t 000104

O f f s e t 000106

O f f s e t 000146

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

|

T h e a c t u a l l y s e n t f e tc h m e s s a g e c o n t a i n s i n f o r m a t i o n o n t h e m e s s a g e

E x a m p le o f

t y p e t h a t is e x p e c t e d a s t h e r e s p o n s e , t h e s h o r t a n d t h e l o n g n a m e

" M A T F E T ” ID o c

( b e f o r e o r a f t e r R e le a s e 4 .0 ), a n d t h e k e y s o f e l e m e n t s t h a t a r e s u p p o s e d to b e s e n t a s a r e s p o n s e . F ig u r e 2 . 1 7 s h o w s a t h e ZSM1 m a t e r i a l . F o r t h e

M ATM A S

M ATFET

ID o c t h a t r e q u e s t

ID oc, b o t h t h e l o n g a n d t h e s h o r t n a m e

is " M A T M A S " b e c a u s e t h i s is a v e r y o l d m e s s a g e ty p e .

4E STYP

L o g ic a l m e s s a g e ty p e

M ATM AS

M ESTYP40

M e s s a g e Type

M ATM AS

SEGNUM

Segm ent Num ber

000002

SEGNAM

Segm ent Nam e

E1ALE01

O B JVA LU E

O b je c t v a l u e (w ith o ld le n g t h

M ATNR

S IG N

A B A P ID : l/E ( in c lu d e /e x c lu d e

1

O P T IO N

A8AP

EO

LO W

C h a r a c t e r f i e l d o f le n g t h 4 0

F ig u r e 2.17

S e le c t i o n o p t io n ( E O /B T /

ZSM1

M A T F E T ID o c

B e c a u s e m a s t e r d a t a is u s u a l l y e x c h a n g e d b e t w e e n d i f f e r e n t s y s t e m s o f t h e s a m e e n t e r p r i s e , lo g ic a l s y s t e m s a r c u s e d as p a r t n e r s lik e t h e y a r e u s e d in ALE.

2.1.2

M essage Control

T h e m e s s a g e c o n t r o l is a s t a n d a r d f u n c t i o n o f SAP, w h i c h t r i g g e r s a d a t a t r a n s f e r f o r all t r a n s a c t i o n d a t a t h a t is s u p p o s e d t o b e r e c e i v e d b y o t h e r e n t e r p r i s e s , t o o . T h is c a n b e d o n e u s i n g a p r i n t e r , fax, o r a n ID o c . F o r p r o c e s s i n g u s i n g ID o c s , y o u c a n u s e tra n sm issio n m e d iu m 6 f o r p r o c e s s i n g u s i n g p a r t n e r f u n c t i o n s , a n d y o u c a n u s e tra n sm issio n m e d iu m A f o r p r o ­ c e s s in g u s i n g lo g ic a l s y s t e m s . All t h e r e q u i r e d s e t t i n g s f o r t h e m e s s a g e c o n t r o l a r e in T r a n s a c t i o n NACE. You u s e t h e co n d itio n te c h n iq u e t o s p e c i f y w h e n y o u g e n e r a t e w h i c h m e s s a g e s in w h i c h w a y . T h e k e y f o r t h e c o n d i t i o n s is c o m p o s e d o f th e a p p l i c a t i o n y o u ' r e in (e .g ., “EF" f o r p u r c h a s i n g ) , t h e o u t p u t t y p e y o u w a n t t o g e n e r a t e (e.g., " N E U " f o r a p u r c h a s e o r d e r ) , a n d t h e p a r t n e r r o le e v e r y t h i n g w ill b e s e n t t o (e .g ., p a r t n e r " v e n d o r " in its r o l e a s g o o d s v endor).

43

M e s s a g e c o n tro l

2 .1

2

|

G e n e ra tin g I D ocs

” E D I_ P R O C E S S IN G " f u n c t io n

I n m essa g e d e te r m in a tio n , t h e a c tu a l m e s s a g e is g e n e r a t e d u s i n g t h e RSNASTOO

rep o rt. T he

E D I_ P R 0 C E S S I NG

f u n c t i o n t h a t is u s e d h e r e t r a n s f e r s

t h e m e s s a g e as a n EDI m e s s a g e u s i n g t h e ID o c ; it b e l o n g s to t r a n s m i s s i o n m e d i u m 6 . D e p e n d i n g o n t h e s y s t e m s e t t i n g , y o u c a n call t h e

RSNASTOO

re p o r t d ire c tly u p o n sa v in g th e d o c u m e n t o r a t re g u la r in te rv a ls as a batch jo b . In m essage co n tro l, a n E D I c o m m u n i c a t i o n is u s u a l l y a s s u m e d s o t h a t y o u w o r k w i t h p a r t n e r s a n d n o t w i t h lo g ic a l s y s t e m s . O u tb o u n d p a rtn e r

T h e i n f o r m a t i o n o n h o w a n ID o c is s e n t to t h e r e c e i v e r (e.g., v ia RFC o r

p r o f ile

file) a n d w h e t h e r a n E D I s u b s y s t e m is s u p p o s e d t o b e u s e d i f n e c e ss a ry , is s e t in t h e o u tb o u n d p a r tn e r profile in T r a n s a c t i o n W E 2 0 b o t h f o r t h e c o m m u n i c a t i o n w i t h p a r t n e r s a n d f o r t h e c o m m u n i c a t i o n w i t h logical system s.

P ro c e s s c o d e

H e re , y o u a l s o s p e c if y w h i c h ID o c t y p e is s u p p o s e d t o b e u s e d . I f y o u w o r k w i t h t h e m e s s a g e c o n t r o l , in t h e o u t b o u n d p a r t n e r p ro f ile u n d e r t h e M e s s a g e C o n t r o l ta b , y o u s p e c i f y w h i c h p r o c e s s c o d e ( a n d w h i c h u n d e r l y i n g f u n c t i o n m o d u l e ) w ill b e u s e d to p o p u l a t e t h e I D o c d a t a . You c a n f i n d t h e v a l i d p r o c e s s c o d e s f o r t h e r e s p e c t i v e o u t p u t t y p e in T r a n s a c ­ t i o n W E 4 1 (F ig u re 2 .1 8 ) .

Pr&cOiS (000 ^

HE 10

ORDERS PurcM S * (Xdor

□ OulDound process code Q L O flic a l message

Assignm ent to logical message ORDERS

Purchase o rd e r/ order

types • Message code C A lc o d e s

• Message «unc*or> :C M fc in c *> n s

F ig u r e 2.18

A s s ig n m e n t o f t h e P ro c e s s C o d e t o t h e M e s s a g e T yp e

M essa g e codes

You c a n a ls o s p e c i f y t h e o p t i o n a l m essage codes a n d m essa g e fu n c tio n s ,

a n d m essage

w h i c h y o u k n o w f r o m t h e p a r t n e r p ro f ile s , t o b e a b l e to u s e d i f f e r e n t

f u n c t io n s

p r o c e s s c o d e s f o r u p d a t i n g t h e ID o c s . M e s s a g e c o d e s a n d f u n c t i o n s a re

44

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

|

f r e e l y s e l e c t a b l e , a n d y o u d o n ' t n e e d t o a d h e r e to n a m i n g r u l e s . H o w ­ e v e r, t h i s a ls o m e a n s t h a t n o i n p u t h e l p is p r o v i d e d in T r a n s a c t i o n W E 2 0 , s o y o u m u s t e n s u r e t h e c o r r e c t s p e l l i n g o f t h e n a m e s y o u r s e l f . In t h e d etails o f th e s a m p le p ro c e ss c o d e fo r th e

O R D ER S

g e n e r a t i o n , w h i c h is

s h o w n i n F ig u r e 2 . 1 9 , y o u c a n v i e w t h e lin k t o t h e a s s o c i a t e d f u n c t i o n m o d u le.

Structure :

Q

OutDound p ro c e s s c o de CD Log ical m e s s a g e

P ro c ess code

HE10

Description

O R D E R S P u rchase order

Function m odule

1PQC QUTPUI TOPERS

O ption A L E -S ervcelinb.procg • P ro c e s s in g w ith A L E s e rv ic e P ro c e s s in g W o A L E service P ro c e s s in g w . trig g e r (in b o u n d )

V e rs io n o f function m odule • P ro c e s s in g w ith fu n c tio n m o d u le v e rs io n 3.0 P ro c e s s in g w ith fu n c tio n m o d u le v e rs io n 2.2

F ig u r e 2.19

A s s ig n m e n t o f t h e P ro c e s s C o d e t o t h e F u n c tio n M o d u le

U n d e r O p t i o n A L E - S e r v ic e /I n b . P ro c g , y o u c a n s e l e c t w h e t h e r t h e ALE

A L E s e rv ic e s

s e r v ic e s a r e s u p p o s e d to b e u s e d o r n o t . T h e ALE s e r v i c e s r e p r e s e n t o p t i o n s o f ID o c m a n i p u l a t i o n u s i n g filters a n d ru le s . C h a p t e r 4, S e c tio n 4 . 1 , C u s t o m i z i n g , d i s c u s s e s t h e ALE s e r v ic e s t o p i c in m o r e d e ta il. B e c a u s e y o u o f t e n r e q u i r e a lo t o f p a r t n e r p r o f ile s — e s p e c i a l l y i f y o u w o rk w ith p a rtn e rs -

y o u h a v e t h e o p t i o n to c r e a t e t e m p l a t e s to s a v e

s o m e t i m e . T h e p a r t n e r p r o f il e f r o m T r a n s a c t i o n W E 2 0 c a n b e c r e a t e d fro m th is te m p la te , so y o u d o n 't n e e d to c re a te it m an u ally . T ran sactio n W E 2 4 is t h e t r a n s a c t i o n f o r t h e t e m p l a t e in t h e o u t b o u n d p r o c e s s i n g (see F ig u r e 2 . 2 0 ) . T r a n s a c t i o n VVE27 is t h e c o r r e s p o n d i n g t r a n s a c t i o n f o r t h e in b o u n d p ro cessin g .

45

D e f a u lt v a lu e s

2 .1

2

|

G e n e ra tin g ID o cs

C h a n g e V ie w " P ro p o s a l f o r o u tb o u n d p a r tn e r p r o file s " : D e ta ils *2 ?

N e w Entries

^

s

i

a

P a rln Typ e

LI

Direction

l]

M e s s a g e Type

0RDCH6

a

a

Vendor

P a rtn e r Role

M e s s a g e co d e M e s s a g e function -----------0

1=1

C o lle c t ID o c s

□ S ta rt su b system

R e c e iv e r port

SUBSYSTEM

B a sic type

DELF0R01

P o rt fur ein E D I-S u b s y s te m v ia D a teisch n ittste lle

D e livery scheduleAJIT sch ed u le

E xtension V ie w

R e c ip ie n t type

0

O rg an iza tio n al unit

R e c ip ie n t

50010120

E D I D e p a rtm e n t

A pplication

EF

H C h a n g e m essage

O utp ut type

NEU

P r o c e s s co d e (out)

ME11

M e s s a g e control p a ra m e te r

F ig u r e 2 .2 0

2.1.3

O R D C H G : P u rc h a s e o rd e r c h a n g e

D e f a u lt V a lu e s f o r O u t b o u n d P a rtn e r P ro file s

Special Functions

W a re h o u s e

I n s o m e ca s e s , a s p e c if ic b u s i n e s s p r o c e s s c a n b e i m p l e m e n t e d c o m ­

m anagem ent

p l e t e l y lo c a lly o n a n SAP s y s t e m o r d i s t r i b u t e d a c r o s s m u l t i p l e SAP o r

e x a m p le

n o n -S A P s y s t e m s . ID o c s a r e o n l y g e n e r a t e d w h e n p r o c e s s e s a r e d i s t r i b ­ u te d across m u ltip le sy stem s, a n d th e g e n e ra tio n can b e a c tiv a te d v ia th e C u sto m izin g fu n c tio n s o f th e re sp ectiv e a p p lic a tio n . W a re h o u s e m a n a g e ­ m e n t is a n e x a m p l e o f t h i s d i r e c t ID o c g e n e r a t i o n . T h e d e f a u l t s e t t i n g o f w a r e h o u s e m a n a g e m e n t a s s u m e s t h a t y o u r w a r e h o u s e is m a n a g e d b y y o u r SA P s y s t e m . I f t h i s i s n ’t t h e c a s e , y o u c a n a c t i v a t e t h e c o n n e c t i o n o f y o u r w a r e h o u s e s y s t e m v ia ALE in C u s t o m i z i n g . T h i s c o n n e c t i o n c a u s e s a

WMTORD

ID o c to b e g e n e r a t e d d i r e c t l y w h e n y o u c r e a t e a w a r e h o u s e

t r a n s p o r t r e q u e s t to n o t i f y t h e e x t e r n a l w a r e h o u s e o f w h a t is s u p p o s e d

46

S tand ard M e th o d s fo r th e ID o c G e n e ra tio n

|

t o b e t r a n s p o r t e d . H o w e v e r , t h e s e s p e c ia l c a s e s c a n ’t b e d e s c r i b e d in g e n e r a l b u t i n s t e a d m u s t b e n a m e d a n d s e t u p in c o o p e r a t i o n w i t h t h e i n d i v i d u a l e n d - u s e r . B e c a u s e all t r a n s a c t i o n s t h a t a r e r e q u i r e d f o r s u c h a s p e c ia l c a s e a r e m o d u l e - s p e c i f i c , t h e y a r e n o t d i s c u s s e d f u r t h e r h e r e , b u t j u s t b e a w a r e t h a t s u c h s p e c ia l c a s e s e x ist. W i t h i n t h e s c o p e o f ALE s c e n a r i o s , t h e r e c a n a l s o b e c a s e s in w h i c h

ID o c - BAPI

s a m p l e p o s t i n g s a r e i m p l e m e n t e d s y n c h r o n o u s l y v ia BAPI, a n d t h e ac tu a l

in te r fa c e

p o s t i n g s a r e i m p l e m e n t e d a s y n c h r o n o u s l y v ia ID o c . T h e n , t h e BAPI is c r e a t e d o n t h e d e v e l o p m e n t s i d e , a n d t h e a p p r o p r i a t e ID o c is g e n e r a t e d u s i n g T r a n s a c t i o n B D B G . You c a n a ls o u s e t h i s t r a n s a c t i o n i f SAP d o e s n ' t p r o v i d e a n ID o c f o r a BAPI a n d y o u still r e q u i r e i t f o r a d i s t r i b u t i o n s c e ­ n a r i o t h a t i s n 't p r o v i d e d f o r b y SAP. A g a in in t h i s c a s e , y o u m u s t o b s e r v e th e n a m in g ru le s fo r c u s to m e r o bjects. F ig u r e 2 . 2 1 s h o w s a n I D o c g e n e r a t e d b y SA P i n t h e SA P n a m e s p a c e . In t h e ID o c I n t e r f a c e ta b , y o u c a n v i e w t h e n a m e s f o r t h e m e s s a g e ty p e a n d t h e ID o c t y p e ; in t h e ALE O u t b o u n d P ro c e s s i n g ta b , y o u c a n v i e w t h e f u n c t i o n g r o u p in w h i c h t h e ID o c m o d u l e s a r e l o c a t e d a s w e ll as t h e n a m e o f t h e m o d u l e t h a t g e n e r a t e s t h e ID o c ; a n d in t h e ALE I n b o u n d P r o c e s s i n g ta b , y o u c a n v i e w t h e n a m e o f t h e m o d u l e t h a t e x t r a c t s th e I D o c in t h e r e c e i v i n g s y s t e m a n d t r i g g e r s t h e u p d a t e . T h e p r o c e s s o f g e n e r a t i n g a n I D o c f r o m a BAPI is a s fo llo w s :

B A P I p r o c e s s in g

1. T h e s e n d i n g s y s t e m w a n t s t o call t h e BAPI a n d c h e c k s w h e t h e r t h i s is s u p p o s e d to b e c a r r i e d o u t l o c a lly o r r e m o t e ly . 2 . I f t h e call is r e m o t e a n d is s u p p o s e d t o b e c a r r i e d o u t tr a n s a c t i o n a l ly , t h e f u n c t i o n m o d u l e t h a t is g e n e r a t e d in T r a n s a c t i o n BD B G is ca lle d in th e s e n d in g sy stem . T his fu n c tio n m o d u le tran sfers th e tra n s fe r p a r a m e t e r s o f t h e BAPI t o t h e I D o c f o r m a t . 3. A f t e r y o u ’v e m a d e t h e s e t t i n g s in t h e c u s t o m e r d i s t r i b u t i o n m o d e l a n d in T r a n s a c t i o n W E 2 0 , t h i s g e n e r a t e d I D o c is t r a n s f e r r e d t o t h e re ceiv in g system . 4 . In th e receiv in g sy ste m , th e c a lle d u s i n g t h e BAPP

BAPI

B A P I _ I D0 C _ I N P U T 1

process c o d e o r

f u n c t i o n m o d u l e is

B A P I _ I D 0 C _ IN P U T P

u sin g the

p ro cess c o d e ; th is d e p e n d s o n w h e t h e r o n e o r m o re d a ta reco rd s

a r e r e c e i v e d s i m u l t a n e o u s l y . T h e s e f u n c t i o n m o d u l e s call t h e i n b o u n d f u n c t i o n m o d u l e t h a t is g e n e r a t e d in T r a n s a c t i o n B DBG, w h i c h e x t r a c t s

47

2 .1

2

|

G e n e ra tin g ID o cs

( h e ID o c a n d u s e s t h e t r a n s f e r r e d d a t a t o call t h e o r i g i n a l BAPI th a t c a r r i e s o u t t h e a c tu a l u p d a t e . G e n e ra te A L E In te rfa c e f o r B A P I

#

9

q o C heck interface

6? D is p la y interface

ObiecVlnterface Type

BUS6006

Method

POST

4 ^ D is p la y available interfaces

Category -Enter Interface Par

M e s s a g e Type

ACC_EHP10YEE_PAY

ID oc type

ACC_EMPL0YEE_PAY02

Package

ACID_IF

A L E Outbound Processing Function Module Function group

AIE_ACC_EHP10YEE_PAY_P0ST ACAS 0

Data FiRenng Allowed

A L E Inbound P roc e s sin g /

F ig u r e 2.21

Function Module

ID 0C _t HPUT_ACC_EHP10YEE_PAY

Funcbon group

ACC4 0

Cali in u p d a te Task

0

Packet P roc e s s in g Allow ed

I D o c I n te r f a c e t o a B A P I

A s y n c h ro n o u s

B e c a u s e b o t h c a s e s r e p r e s e n t a n ALE s c e n a r i o , y o u m a i n t a i n t h e c u s ­

B A P Is

t o m e r d i s t r i b u t i o n m o d e l f o r BAPIs a n d I D o c s . F o r t h e BAPIs, y o u e n t e r the m e th o d s th a t m u s t b e p ro c e sse d b o th s y n c h ro n o u sly a n d asynchron o u s l y v i a ID o c s . A d d i t i o n a l ly , y o u r e q u i r e p a r t n e r p r o f ile s f o r t h e t r a n s ­ a c ti o n a l c a s e a s u s u a l . I f y o u h a v e t h e s e p a r t n e r p r o f ile s g e n e r a t e d f r o m t h e d i s t r i b u t i o n m o d e l , t h e s y s t e m a u t o m a t i c a l l y k n o w s f o r w h i c h BAPIs t h e r e a r c m e s s a g e t y p e s a n d t h u s f o r w h i c h it r e q u i r e s a p a r t n e r p ro file .

D e t e r m in in g th e

U s e T r a n s a c t i o n B D 9 7 to m a i n t a i n t h e d e s t i n a t i o n f o r t h e s y n c h r o n o u s

t a r g e t s y s te m f o r

BAPI call i n a r e m o t e s y s t e m . T h i s c a n b e d o n e b o t h g e n e r a l l y f o r all

s y n c h r o n o u s B A P Is

m e t h o d c a lls a n d o n l y f o r s p e c ia l BAPIs a n d f o r d i a l o g calls. You n e e d t h e d i a l o g calls i f y o u w a n t to w o r k w i t h t h e I D o c t r a c i n g in T r a n s a c ­ t i o n B D 8 7 . T h e d i s t i n c t i o n w i t h r e g a r d to d i a l o g s is m a d e f o r s e c u r i ty reasons.

48

U se o f Lo gical System s in th e M e ssag e C o n tro l

|

B e c a u s c a d i a l o g u s e r m u s t b e u s e d in t h e RFC d e s t i n a t i o n , t h i s u s e r s h o u ld h a v e o n ly a fe w a u th o riz atio n s. F ig u r e 2 . 2 2 s h o w s a n e x a m p l e f o r e a c h o f t h e t h r e e cases.

A s s i g n R F C D e s t i n a t i o n s f o r S y n c h r o n o u s M e t h o d C a lls

&

9 ^ & □

Standaid BAPi destination

Q

Standard dialog destnabo n

Q

Special m em od destination

1090 * 0 0 c l i e n t 800 -AHRCLNT000 -AHRCLNT003 -AHRCLHT006 -AHRCLNT026 -A 1 I_ 0 0 _ 8 0 0 "AIN1 -A1N2 -A IN _ 8 0 0 -AIN_8O0NBI -AIRCLNT000 -ALRCLHT006 -ALRCLNT062 -AP0CLNT100 AP0CLNI8JP

AHR (HR s y s te m ) c l i e n t 000 AHR (HR s y s te m ) C l ie n t 003 AHR CATTS c l i e n t 006 AHR C A IIS C l i e n t 026 A M S y s t e * c l i e n t 800 AutO ID Node 1 A u to ID Node 2 A u to ID Node 2 .1 c l i e n t 800 A u to ID Node c l i e n t 800 NB I ALR C l i e n t 000 ( ) a i r n a n d t 006 ALR fla n d a n t 062 APOCLNTIOO APOCLNT8O0

— Gj S ta n d a rd RFC d e s t in a t i o n f o r BAPI c a l l s AP0CLNI800

••• /

S ta n d a rd RFC d e s t in a t i o n f o r d i a lo g c a l l s AIEHAHU 3

l e s t ALE c o m u M c a t io n * i t h

n a n u g is t ie s

RFC d e s t in a t i o n s f o r s p e c ia l « e th o d c a l l s

L -O

A c c tn g E « p ly e e P a y b l* s c n e c k A c c o u n tin g

C heck V e ndor A c c t A s $ ig n « e n t f o r HR P o s tin g (0 A 6 : LOAD PAYABLE)

I----------BACKEND

F ig u r e 2 .2 2

C u s t o m iz in g f o r S y n c h r o n o u s B A P I C a lls in A L E S c e n a rio s

T h e s t a n d a r d d e s t i n a t i o n f o r BAPI calls f o r t h e t e m is

APO C LN TSO O ,

and th e

BACKEND

APO C LN TSO O

lo g ic a l s y s ­

t h e d e s t i n a t i o n f o r t h e d i a l o g calls is c a lle d

d e s t i n a t i o n is u s e d f o r t h e

ALEM ANU,

A c c tn g E m p ly e e P a y b le s . C h e c k

m e t h o d o n ly.

2.2

U se of Lo g ica l S y ste m s in the M e ss a g e C o n tro l

T r a n s a c t i o n d a t a m a y b e e x c h a n g e d w i t h i n ALE s c e n a r i o s . F o r e x a m p l e ,

"A L E _

th is c o u ld b e th e s c e n a rio o f ce n tral sa le s /d e c e n tra liz e d s h ip p in g . H ere,

P R O C E S S IN G ’

p u r c h a s e o r d e r s , d e l i v e r ie s , a n d i n v o i c e s a r e e x c h a n g e d b e t w e e n p l a n t s

subroutme

o f t h e s a m e e n t e r p r i s e . F o r t h i s c a s e , i n m e s s a g e c o n t r o l , y o u s i m p l y use t h e c u s t o m e r o r v e n d o r a s t h e p a r t n e r . I n s t e a d o f " 6 " f o r t h e E D I pro -

49

2 .2

2

|

G e n e ra tin g I D ocs

c e s s in g , h o w e v e r , y o u e n t e r "A" f o r t h e ALE p r o c e s s i n g a s t h e t r a n s m i s ­ s i o n m e d i u m f o r t h e f o u n d m e s s a g e . As a r e s u lt , t h e s y s t e m n o l o n g e r uses th e IN G

E D I_ P R O C E S S IN G

s u b ro u tin e a n d in ste a d uses the

ALE _P R O C ES S-

su b ro u tin e.

M e s s a g e c o n tro l

You t h e n m a i n t a i n a c u s t o m e r d i s t r i b u t i o n m o d e l as u s u a l a n d u s e a

a n d ALE

logical s y s t e m as t h e s e n d e r a n d a lo g ic a l s y s t e m as t h e r e c e i v e r o f t h e m essag e . A fte r th e m e ssa g e c o n tro l w ith in th e ap p lic a tio n , th e tra n s m is ­ s i o n m e d i u m A r e a d s t h e c u s t o m e r d i s t r i b u t i o n m o d e l a n d r e p la c e s t h e p a r t n e r f o u n d i n t h e m e s s a g e c o n t r o l w i t h t h e lo g ic a l s y s t e m f o u n d in t h e m o d e l . F o r t h i s p u r p o s e , y o u n e e d t h e a s s i g n m e n t o f o u t p u t t y p e s to m e s s a g e t y p e s . T h e y a r e a v a il a b le in t h e p r o c e s s c o d e s in t h e o u t b o u n d p r o c e s s i n g in T r a n s a c t i o n W E 4 1 a n d in t h e s e t t i n g s t h a t y o u m a d e f o r t h e m e s s a g e c o n t r o l in t h e o u t b o u n d p a r t n e r p r o f il e in T r a n s a c t i o n W E 2 0 .

U n iq u e n e s s o f th e a s s ig n m e n t

T h e d a t a f r o m T r a n s a c t i o n W E 2 0 is e v a l u a t e d i n t h e

A L E .P R O C E S S IN G

s u b r o u t i n e . B e c a u s e t h e s u b s e q u e n t r e c e i v e r i s n 't y e t d e t e r m i n e d in th is f ir s t s t e p , t h e s y s t e m s e a r c h e s u s i n g t h e “L og ical S y s t e m " p a r t n e r t y p e a n d t h e o u t p u t t y p e o n ly . I f m o r e t h a n o n e e n t r y is f o u n d in T r a n s a c t i o n W E 2 0 , fo r ex a m p le , NEU -

ZSM OR D

NEU

-

ORDERS,

w h ic h w o u ld be th e sta n d a rd , a n d

fo r a s e lf-p ro g ra m m e d m essag e ty p e,

A L E _ P R O C E S S IN G

can­

cels w i t h a n e r r o r . You e s t a b l i s h t h e r e q u i r e d u n i q u e n e s s b y u s i n g y o u r o w n o u t p u t t y p e s f o r y o u r o w n m e s s a g e ty p e s . T h e s e a r c h v ia t h e "Logical S y s te m " p a r t n e r t y p e a n d t h e p a r t n e r t y p e r e s u lt s in t h e b e n e f i t o f a r e d u c e d n u m b e r o f p a r t n e r p ro f ile s . T h e n y o u c a n j u s t h a v e a p a r t n e r p r o f il e f o r t h e logical s y s t e m i n s t e a d o f a p a r t n e r p ro f ile f o r e a c h v e n d o r o r c u s t o m e r .

2.3

S u m m a ry

I n t h i s c h a p t e r , w e ' v e t a k e n a c l o s e r l o o k a t t h e c r e a t i o n o f ID o c s . Y ou ’v e l e a r n e d w h i c h m e t h o d s f o r c r e a t i o n e x i s t a n d h o w t h e y a r e r e l a t e d to t h e d i f f e r e n t n e e d s o f d i f f e r e n t p r o c e s s e s o r d a t a t y p e s . T h e d e c i s i o n as t o w h i c h o n e s h o u l d b e u s e d is m a d e b y SAP. N o w l e t ’s t a k e i t a s t e p f u r t h e r r e g a r d i n g o u r w o r k w i t h I D o c s . T h e n e x t c h a p t e r w i l l t e a c h y o u h o w to t e s t t h e c r e a t i o n a n d t h e p o s t i n g o f ID ocs.

50

" A n y th in g t h a t ca n g o w r o n g w ill g o w ro n g ." (M u r p h y 's L aw ) To e n s u re t h a t a s little a s p o ss ib le g o e s w r o n g in y o u r p ro d u c tio n sy ste m , S A P p r o v id e s a v a r ie ty o f te s t tools, each o f w h ic h are d esc rib e d in th is ch a p ter.

3

Test Tools

A b u s i n e s s p r o c e s s t h a t s p a n s s e v e r a l s y s t e m s c a n ' t b e fu lly t e s t e d a n d

T e s tin g w i t h o u t a

a c c e p t e d u n l e s s all o f t h e p a r t n e r s t e s t t h e p r o c e s s . H o w e v e r , b a s i c s e t ­

p a rtn e r

tin g s u s u a l l y u n d e r g o a p r e l i m i n a r y te s t, w i t h o u t a n y i n v o l v e m e n t b y y o u r p a rtn e r. D u rin g th e d e fin itio n p h a se , it m a y also b e n e c e s s a ry fo r y o u to d e t e r m i n e e x a c t l y w h i c h f ie ld s a r e c o n t a i n e d in a n ID o c , a n d o f t h e s e field s, w h i c h a r e n e e d e d f o r a p a r t i c u l a r s c e n a r i o . F o r t h i s b a s ic te s t, SAP h a s d e l i v e r e d a t e s t e n v i r o n m e n t i n w h i c h s y s t e m s c a n g e n e r a t e a n d p o s t ID o c s w i t h o u t h a v i n g a s u i t a b l e SAP s y s t e m g r o u p . T h e s e ID o c s c a n t h e n b e u s e d a s s a m p l e ID o c s o r t e m p l a t e s f o r t h e p a r t n e r . You c a n m a n u a l l y c r e a t e ID o c s a n d p o s t t h e m to y o u r o w n SAP s y s t e m ,

In b o u n d a n d

as w e l l a s m a k e I D o c s a v a il a b le f o r o u t b o u n d p r o c e s s i n g . All o f t h e te s t

o u tb o u n d

t o o l s a r e s t o r e d u n d e r t h e a r e a m e n u in T r a n s a c t i o n W E D I . F ig u r e 3.1 s h o w s t h e s e v e n t e s t t r a n s a c t i o n s p r o v i d e d th e re .

S A P E a s y A c c e s s I D o c a n d E D I B a s is I

| lA

O tw rm e n u 11

| 0

E

I fQ

Create rote |

CD Favorites Q SAP menu .......< $ W E 0 2 - Display IDoc I- □ AdminisVatfon ^ < 3 T#*t ^ V * E 1 9 -T e s t tool 5 -O utbound from MC

0 0 0 0 0

V *E 14- Outbound Processing from lOoc V»E18 - Generate Status File W EI

7- Process Status File

W E12 - Inbound procg o f moOifled ou® file

V Q Documenta»on t> □ D e v e lo p m e n t t> Q Control______________________________________________________

F ig u re 3.1

Test T ra n sa ctio n s in the A re a M e n u o f Transactio n W E D I

51

p r o c e s s in g

3

|

T e s t T o o ls

P ari o f t h e s e t r a n s a c t i o n s is a ls o a v a il a b le in t h e m e n u s o f t h o s e a p p l i c a ­ t i o n s t h a t f r e q u e n t l y w o r k w i t h ID o c s . H o w e v e r , t h i s c h a p t e r w ill p r i ­ m arily focus o n using in d iv id u a l tran sa ctio n s, ra th e r th a n s h o w in g th e m in a s p e c if ic m o d u l e . N o t e t h a t m o s t v a l u e s e n t e r e d f o r t e s t p u r p o s e s a re c a s e -s e n s itiv e .

3.1 T r a n s a c tio n W E 19

In d iv id u a l ID o cs

T r a n s a c t i o n W E I 9 is t h e t e s t t o o l f o r i n d i v i d u a l ID o c s . You c a n c h o o s e w h e t h e r y o u w a n t t o u s e a f i n i s h e d ID o c a s a t e m p l a t e o r w h e t h e r y o u w a n t to c r e a t e a c o m p l e t e l y n e w I D o c b a s e d o n a m e s s a g e t y p e o r IDoc t y p e . You c a n a l s o u s e a n e x i s t i n g file. In t h i s c a s e , h o w e v e r , y o u m u s t u s e a flat file b e c a u s e X M L files a r e n ’t s u p p o r t e d .

I D o c t e m p la t e

T r a n s a c t i o n W E I 9 is p a r t i c u l a r l y h e l p f u l i f it's n o t y e t c l e a r w h i c h ID o c f ie ld s m u s t b e filled a n d w h i c h v a l u e s m u s t b e s p e c i f i e d . You c a n r u n t h r o u g h s e v e r a l v a r i a n t s u n t i l y o u ' v e d e t e r m i n e d t h e field i n f o r m a t i o n r e l e v a n t f o r y o u r s e t o f ta s k s . F ig u r e 3 .2 p r o v i d e s a n o v e r v i e w o f t h e in i­ tial s c r e e n a s w e l l as t h e s e l e c t i o n o p t i o n s a v a il a b le in t h i s t r a n s a c t i o n .

T e s t to o l f o r ID o c p ro c e s s in g

si T e m p la te fo i t e s t / <•> Existing ID oc O BasicTyp w ith E n h a n c e m e n t O V i a m e s s a g e type O File a s tem p la te O w f o tem p la te

F ig u r e 3 .2

M a n u a l te s t ID o c

T e s t T o o l f o r I n d iv id u a l ID o c s

A f t e r y o u ' v e c a lle d a n ID o c , y o u c a n s t r u c t u r e it s o t h a t i t fulfills y o u r t e s t r e q u i r e m e n t s . E ac h s e g m e n t c a n b e e d i t e d s e p a r a t e l y . W h i l e y o u ’re in e d i t m o d e , y o u a l s o c a n c l e a r l y s e e w h i c h fie ld y o u ’re w o r k i n g in w i t h ­ o u t h a v i n g t o c o u n t t h e field s. You c a n a ls o a d d m o r e s e g m e n t s . I f y o u ’re

52

I n d iv id u a l ID o c s

|

3 .1

usin g th e te m p la te o p tio n , th e sy ste m checks s o m e (u n fo rtu n a te ly , n o t all) o f t h e r e q u i r e d p r o p e r t i e s o f t h e ID o c t y p e o r m e s s a g e t y p e t h a t y o u ' v e s e l e c t e d . All o f t h e v a r i a n t s a r e c h e c k e d t o d e t e r m i n e w h e t h e r m a n d a t o i y s e g m e n t s a r e m i s s i n g o r w h e t h e r t h e s e g m e n t in u s e e x i s t s in t h e s e g m e n t d e f i n i t i o n in t h e SAP s y s t e m . F ig u r e 3 .3 s h o w s t h e s e g m e n t s o f a n e x a m p l e ID o c in T r a n s a c t i o n W E 1 9 .

E0I0C

8000000000000768745700 03

1SALES

LSSAIES

1

010 HUHBEft

— E1HAKTH ---------E l MARCH --------E l HARM ---------E l HARM --------E1HYKEH ---------E l HIAMU

F ig u r e 3 .3

OOSESatnnes 0e«o (la te r i s i 0053000* OOSCT 6 1 OOSPCEt 1 005360001 X 000009000 000 0050S UIXJ1

EH 0 0 HO 00 0 800 0 .0 80 0 000 0 080 0 ooo 0 000 0 080 0 ooo 0.080 0.80B 0 800

0 000 0 080 0 000

PCE

0.808 0 800 0 OOO

XCRH

V ie w o f a n I D o c in T ra n s a c tio n W E 19

You c a n n o w e d i t b o t h t h e c o n t r o l r e c o r d a n d t h e d a t a r e c o r d s a n d , f o r

E d it in g th e

e x a m p l e , s e n d a n ID o c to a r e c e i v e r o t h e r t h a n t h e o r i g i n a l r e c e iv e r . As

c o n t r o l re c o rd

y o u c a n s e e in F ig u r e 3 . 4 , o n l y t h e m o s t i m p o r t a n t fie ld s in t h e c o n t r o l r e c o r d a r e d i s p l a y e d in itially . H o w e v e r , i f y o u a ls o w a n t to v i e w o r e d i t t h e o t h e r field s, s i m p l y c h o o s e A ll F ields.

171 R e c e iv e r

Sender

P o rt

P o rt

P a rtn e r N o

P a rtn e r N o

P a ri T ype

P a rt T ype

P a rtn e r R o le

P a rtn e r R o le

L o g ic a l M e s s a g e T ype M e s s a g e Type M e s s a g e V a ria n t M e s s a g e F u n c tio n

□

T e s t F la g

F ig u re 3 .4

E d itin g th e C o n tro l R ecord

53

3

|

T e s t T o o ls

Test flag

T h e te s t f a g p l a y s a s p e c ia l ro le i f y o u a c tu a l ly s e n d te s t ID o c s t o o t h e r s y s t e m s . F o r e v e i y s i n g l e p a r t n e r p ro f ile w i t h i n i n b o u n d p r o c e s s i n g in SAP s y s t e m s , y o u c a n d e t e r m i n e w h e t h e r t h e T est Flag w ill a p p l y t o real o r t e s t I D o c s . I f y o u s e t t h e T est Flag, y o u c a n r e c e i v e t h e ID oc, s a v e i t to t h e d a t a b a s e , a n d v i e w its c o n t e n t s in T r a n s a c t i o n B D 8 7 , b u t y o u c a n ' t p o s t it. O t h e r s y s t e m s t h a t e x c h a n g e ID o c s o r EDI m e s s a g e s u s u a l l y h a v e s i m i l a r b u i l t- in s e c u r i t y m e c h a n i s m s f o r t e s t p u r p o s e s . E ac h t i m e y o u d o u b l e - c l i c k a d a t a r e c o r d , y o u g e t a lis t o f all p o s s i b le f ie ld s f o r t h i s s e g m e n t . You a ls o c a n s c r o ll d o w n t h r o u g h t h e e n t i r e d a ta r e c o r d (s e e F ig u r e 3 .5 ). I f y o u ’re n o t w o r k i n g w i t h a t e m p l a t e , y o u e n t e r t h e fie ld c o n t e n t s t h a t y o u r e q u i r e h e r e . I f y o u ' r e w o r k i n g w i t h a t e m ­ p la te , t h e v a l u e s o f t h e t e m p l a t e ID o c a r e p r e fille d , a n d y o u c a n c h a n g e th e m as req u ired .

C h a n g e D a ta R e c o rd MSGFN

005

M ATN R

ZSM1

ERSDA ERNAM

20081006 _ [

m a is e l s a

L A E DA

20081006

AEN AM

M AISELSA

P S TAT LVO R M

KVE P I

M TAR T

fert]

M BRSH

h]

M ATKL

00107

✓

X

F ig u r e 3 .5

E d itin g a D a ta R e c o rd

Processing the

N o w t h a t y o u ’v e c r e a t e d y o u r c o m p l e t e I D o c , i t c a n b e p r o c e s s e d . In

test IDoc

o t h e r w o rd s , it c a n b e te s t e d w ith th e re le v a n t s ta n d a r d s e ttin g s fo r in b o u n d a n d o u tb o u n d p rocessing. F o r in b o u n d p rocessing, ad d itio n al t e s t o p t i o n s a r e a v a ila b le , e i t h e r d i r e c t l y b y e n t e r i n g a f u n c t i o n m o d u l e o r i n d i r e c t l y b y u s i n g a file ( w e 'l l d e s c r i b e t h i s in g r e a t e r d e t a i l later). F ig u re 3 . 6 s h o w s s ta n d a r d in b o u n d processing. All o f t h e d a t a is o b t a i n e d f r o m a p a r t n e r p ro file , a n d i t c a n ’t b e c h a n g e d . I f n o p a r t n e r p ro f ile is f o u n d , y o u c a n c r e a t e a n ID o c , b u t y o u c a n ’t p o s t it.

54

I n d iv id u a l ID o c s

|

[ & T e s i in b o u n d ID o c u s in g p a rtn e r p ro file CCO

P a fw 'e r 'p r o f i) ^

P a rtn e r N o

ZSM2

P a rt T y p e

LS

L o g ic a l s y s te m

P a rtn e r R o le

L o g ic a l M e s s a g e Typ e M essage

MATNAS

M a te ria l m a s te r

MATH

M ATM AS M a te ria l m a s te r da ta

M e s s a g e V a ria n t M s g F u n c tio n

P r o c e s s in g D e ta ils P ro c e s s code F u n c tio n n a m e

ID 0 C JN P U T J1 A T M A S 0 1

P I A L E Service

^

X

F ig u r e 3 . 6

T e s tin g S ta n d a r d In b o u n d P ro c e s s in g

W h e n y o u u s e t h e T est U s i n g a F u n c t i o n M o d u l e o p t i o n , i t ’s p o s s i b l e to

T e s t u s in g a

d i r e c t l y s p e c if y a f u n c t i o n m o d u l e f o r ID o c p r o c e s s i n g (s e e F ig u r e 3.7 ).

f u n c t io n m o d u le

T h e t e s t I D o c is t h e n p r o c e s s e d w i t h t h i s f u n c t i o n m o d u l e , ir r e s p e c t i v e o f w h e t h e r o r n o t a s u i t a b l e p a r t n e r p ro f ile e x is ts . T h i s e n a b l e s t e s t i n g t o b e c o m p l e t e d p r i o r to t h e fin a l s e t t i n g s , w h i c h a r e s o m e t i m e s i m p l e m e n t e d b y o t h e r s . You c a n a ls o t e s t y o u r o w n d e v e l o p m e n t s h e r e a n d n a v i g a t e d irec tly to d e b u g g in g , i f necessary. If th e re are sev eral p ro c e ss co d e s a n d s e v e r a l f u n c t i o n m o d u l e s f o r t h e s a m e m e s s a g e t y p e , y o u c a n a ls o r u n t h r o u g h all o f t h e m h e r e . You c a n t h e n u s e t h e r e s u lt s to d e t e r m i n e th e m o st re le v a n t p ro c ess c o d e fo r y o u r p u rp o se s.

S ’ T e s t in b o u n d ID o c u s in g a fu n c tio n m o d u le F u n c tio n M o d u le □

[lD 0 C _IN P U T _M A T H A S 01

□ g )

C a ll in d e b u g g in g m o d e C a ll tra n s a c tio n p r o c e s s in g / ® In B a c k g ro u n d O In fo re g ro u n d O In fo re g ro u n d a lte r e r ro r

✓

X

F ig u re 3 .7

E x ten d ed Test in In b o u n d Processing

55

3 .1

3

|

T e s t T o o ls

T e s t I D o c a s a file

T h e tw o s c e n a rio s d e s c rib e d p re v io u sly — a te s t u s in g th e s ta n d a r d set­ tin g s o r a t e s t u s i n g a f u n c t i o n m o d u l e — w o r k d i r e c t l y in t h e SAP s y s ­ t e m . F r e q u e n tl y , h o w e v e r , y o u a ls o h a v e to i m p o r t p a r t n e r files i n t o y o u r b u s i n e s s p r o c e s s e s . To p r e v e n t e r r o r s f r o m o c c u r r i n g , y o u r p a r t n e r w ill m o s t lik e ly a p p r e c i a t e a sa m p le f i l e w h o s e s t r u c t u r e c a n b e u s e d d u r i n g l i v e i m p l e m e n t a t i o n . B y u s i n g a file to t e s t i n b o u n d p r o c e s s i n g , y o u c a n w r i t e s u c h a file w i t h s e v e r a l ID o c s a n d t h e n p r o c e s s i t d ire c tly .

T e s t in g in b o u n d

W r i t i n g a file w i t h a r e p e a t f a c t o r in a p p e n d m o d e c a n a ls o b e u s e d a s t h e

p ro c e s s in g

basis fo r m ass tests fo r p e r fo rm a n c e a n a ly sis p u rp o s e s . C o n se q u e n tly , ID o c s a r e g e n e r a t e d f r o m y o u r d a t a as o f t e n a s p e r m i t t e d b y t h e r e p e a t f a c t o r a n d t h e n p l a c e d in a l a r g e s h a r e d file. To u s e t h i s f u n c t i o n , y o u m u s t e n t e r a v a l i d file p o r t f o r w h i c h y o u c a n a c t i v a t e o r d e a c t i v a t e U n i ­ c o d e (s e e F ig u r e 3 .8 ). H o w e v e r , y o u m u s t s p e c if y t h e file p a t h y o u r s e l f b e c a u s e it c a n ' t b e o b t a i n e d f r o m t h e p o r t i n f o r m a t i o n .

[*] /

E ’ T e s t in b o u n d ID o c u s in g tile F ile n a m e 3

f lio c a lh o s V d e m o fo id e r fd e m o fiie

S ta r t ID o c in b o u n d p r o c e s s in g o f file i m m e d ia t e ^

N o . o f ID o c s to w r it e in f ile (re p e titio n facto r)_____________________________ |1

F i le m o d e /

~

® O v e r w r ite file

O A ppend

ID o c to file

in b o u n d p r o c e s s in g

P o ri

S N F IL E

S a b in e s T e s tp o r t fo r F ile s

[ B E _______________________________________________________ F ig u r e 3 .8

T e s tin g In b o u n d P ro c e s s in g U s in g a F ile

S ta tu s v a lu e s o f

N o m a tte r w h ic h o f th e s e th re e test m e th o d s y o u u se to create an

t h e t e s t ID o c

i n b o u n d ID oc, t h e ID o c is s t o r e d w i t h a n a d d i t i o n a l s t a t u s r e c o r d t h a t a lw a y s i n d i c a t e s t h a t t h i s ID o c w a s n o t r e a l l y c r e a t e d b u t r a t h e r c r e a t e d u s i n g t e s t T r a n s a c t i o n W E 1 9 . H o w e v e r , t h e re a l c h a n g e s a r e w r i t t e n to

56

T e stin g P ro ce ssin g o f M u ltip le ID o c s

|

3 -2

( h e d a t a b a s e , s o y o u m u s t c a r e f u ll y c o n s i d e r w h e t h e r y o u w a n t t o p e r ­ m i t t h e u s e o f t h i s t e s t t r a n s a c t i o n in a p r o d u c t i o n s y s t e m . F ig u r e 3 . 1 4 in S e c tio n 3 . 3 , P ro c e s s i n g S ta t u s Files, s h o w s t h e s t a t u s v a l u e s o f a n ID o c c r e a t e d u s i n g t e s t T r a n s a c t i o n W E I 9 . I n o u t b o u n d p r o c e s s i n g , t h e te s t s t a t u s v a l u e is 4 2 : IDoc w a s created b y te s t tra n sa ctio n . W h e n t e s t i n g o u t b o u n d p r o c e s s i n g , y o u c a n a ls o s e n d s e v e r a l ID o c s a t

T e s tin g o u t b o u n d

o nce. H o w e v e r, y o u d o n 't h a v e th e p re v io u sly m e n tio n e d ad d itio n a l

p r o c e s s in g

o p t i o n s o f d e b u g g i n g o r w o r k i n g w i t h o u t s u i t a b l e p a r t n e r p r o f ile s h e r e . You c a n o n l y u s e s t a n d a r d o u t b o u n d p r o c e s s i n g . As y o u c a n s e e in F ig u re 3 . 9 , all o f t h e i n f o r m a t i o n y o u r e q u i r e ( a p a r t f r o m t h e r e p e a t fa c to r) is o b t a i n e d f r o m t h e p a r t n e r p ro f ile s . T h e s e s e t t i n g s a r e t h e n u s e d t o s e n d a n ID o c t o a p a r tn e r .

| Q ? O u tb o u n d p r o c e s s in g o f lD o c 0

0

/

S la r l ID o c o u tb o u n d p ro c g o f file im m e d .

N o . o f ID o c s to b e g e n e r a te d ( r e p e a t facto r)

R e c e iv e r p o rt

SAPSM1

P o rtT y p e

tR F C P o rt

L o g .d e s tin a tio n ;

DEST_SM 1

F ig u r e 3 .9

3.2

1

T e s tin g S ta n d a rd O u t b o u n d P ro c e s s in g

T e stin g P ro ce ssin g o f M u lt ip le ID o cs

O n l y o n e I D o c w a s c r e a t e d w h e n w e u s e d t h e te s t m e t h o d s d e s c r i b e d in t h e p r e v i o u s s e c t i o n . H o w e v e r , y o u a l s o h a v e t h e o p t i o n o f c r e a t i n g m u l t i p l e ID o c s a t o n c e . W e ’ll n o w d e s c r i b e t h i s o p t i o n in d e ta il.

3.2.1

M essage Control

I f m e s s a g e c o n t r o l is u s e d to g e n e r a t e ID o c s, t h e a p p l i c a t i o n f r e q u e n t l y

T e s t tr a n s a c t io n

c o n f ig u r e s t h e p a r a m e t e r s e t t i n g s t h e r e . T h e a c tu a l ID o c s a r e first g e n ­

W E 15 a n d re p o rt

e r a t e d u s i n g a s c h e d u l e d r e p o r t ( a n d n o t a s s o o n a s t h e d o c u m e n t is

57

"R S N A S T O O "

3

|

T e s t T o o ls

p o s t e d ) . F r e q u e n tl y , t h i s p r o c e s s c a n ’t b e a d a p t e d f o r te s t p u r p o s e s , a n d , as a r e s u lt , y o u m u s t m a n u a l l y s t a r t t h e r e l e v a n t r e p o r t e a c h t i m e y o u w a n t to t e s t a n ID o c . To m a k e life a little e a s i e r f o r y o u , T r a n s a c t i o n W E I 5 is a v a il a b le f o r g e n e r a t i n g I D o c s f r o m m e s s a g e c o n t r o l re c o r d s . T h is t r a n s a c t i o n d i r e c t l y r e f e r e n c e s t h e r e p o r t

RSNASTOO,

a n d i t ’s l i s t e d in

y o u r E D I o v e r v i e w m e n u W E D I . F ig u r e 3 . 1 0 s h o w s a p u r c h a s i n g e x a m ­ p l e t h a t u s e s t h e s t a n d a r d m e s s a g e t y p e d e l i v e r e d b y SAP.

S e le c tio n P r o g r a m f o r I s s u in g O u tp u t ;© -& n S e le c t io n p a r a m e t e r O u tp u t a p p lic a tio n

to

4500017125

O b je c t key O u tp u t type

to

T r a n s m i s s i o n m e d iu m

to

□

S e n d a g a in

S o rt

P a r a m e t e r fo r c a llin g u p th e p r o c e s s in g p r o g r a m s P r in te r d e fa u lt S p o o l: S u ffix 2

F ig u r e 3.10

T e s t T ra n s a c tio n f o r M e s s a g e C o n tr o l

T h e m a i n d i f f e r e n c e b e t w e e n t h i s t e s t t r a n s a c t i o n a n d all o t h e r t e s t t r a n s ­ a c t i o n s is t h a t a n ID o c t h a t w a s a c t u a l l y g e n e r a t e d b y a n a p p l i c a t i o n is s e n t e a rlie r th a n p la n n e d , in s te a d o f w a itin g fo r th e s y s te m to ex ecu te the re p o rt

R SN ASTO O

b y d efau lt. A n e w ID oc i s n 't g e n e ra te d (th e original

j o b s c h e d u l e d l a t e r d o e s n ’t g e n e r a t e t h i s I D o c a g a in ) . I n s t a t u s m o n i t o r ­ ing, y o u c a n ’t s e e h o w t h i s ID o c w a s g e n e r a t e d b e c a u s e i t s i m p l y s ta rts as n o r m a l w i t h s t a t u s 0 1 : ID oc generated.

3.2.2

Sending R e ad y-fo r-D isp atch IDocs

A d v a n c e d d is p a t c h

T r a n s a c t i o n W E I 4 is t h e o n l y t r a n s a c t i o n t h a t c a n b e u s e d to a n t i c i p a t e

o f f in is h e d ID o c s

a j o b t h a t is o t h e r w i s e s c h e d u l e d o n a r e g u l a r b a s is . H e r e , r e a d y - f o r d i s p a t c h ID o c s ( s t a t u s 3 0 ) a r e d i s p a t c h e d b e f o r e t h e r e g u l a r “d a t e , " i f

58

T e stin g P ro ce ssin g o f M u ltip le ID o c s

|

y o u d o n ’t w a n t t o w a i t u n t i l t h e n . H o w e v e r , y o u c a n a ls o s e t t h e t e s t flag h e r e , s o t h a t y o u r p a r t n e r k n o w s t h a t h e s h o u l d n o t p r o c e s s t h e ID oc. F ig u r e 3 .1 1 s h o w s h o w y o u c a n u s e T r a n s a c t i o n W E 1 4 to s p e c i f y w h i c h ID o c s y o u w a n t to c r e a te . S im ilarly , t h i s t r a n s a c t i o n d o e s n ' t g e n e r a t e a n e w ID o c . C o n s e q u e n t l y ,

S ta n d a r d r e p o r t

in T r a n s a c t i o n B D 8 7 ( I D o c M o n i t o r ) , y o u c a n ’t i d e n t i f y a d i f f e r e n c e to

"R S E O U T O O "

th e ID ocs th a t a r e d is p a tc h e d re g u la rly v ia a b a c k g ro u n d j o b b ec au se T r a n s a c t i o n W E I 4 a l s o p r o v i d e s s p e c i a l a c c e s s to t h e s t a n d a r d r e p o r t RSEO UTO O .

P ro c e ss A li Selected ID ocs (EDI)

Doc N um ber

i

.0

B a s le T y p e

Q ueue N am e S e n d c o m p le te ly 1? P o tt o f R e c e iv e r P a rtn e r T y p e o f R e c e iv e r P a rtn e r F u n c tio n o f R e c e iv e r P a rtn e r N u m b e r o f R e c e iv e r

L o g ic a l M e s s a g e

Last C hanged On Last C hanged

At

O u tp u t M o d e □

T e s t O p tio n

M a x im u m N u m b e r o f ID o c s

F ig u r e 3.11

3.2.3

S e le c tio n o f ID o c s t o Be S e n t

Files

In a d d i t i o n to t e s t i n g i n d i v i d u a l I D o c s , y o u c a n a l s o p r o c e s s c o m p l e t e files w i t h ID o c d a t a . You c a n c r e a t e t h e s e files o r t h e y c a n b e t r a n s f e r r e d f r o m a p a r t n e r . H e r e , w e 'l l a s s u m e t h a t all o f t h e d a t a in t h e p a r t n e r file is

59

3 -2

3

|

T e s t T o o ls

c o r r e c t a n d s i m p l y n e e d s to b e i m p o r t e d . T h i s is d o n e u s i n g T r a n s a c t i o n W E I 6 . O n c e a g a in , y o u o n l y h a v e to e n t e r t h e file n a m e , file p a t h , a n d p o r t , a s w e ll a s s e t t h e U n i c o d e flag o n t h e i n p u t s c r e e n . E d it in g th e

I n t h e c a s e o f files t h a t y o u c r e a t e y o u r s e l f , y o u c a n e i t h e r c r e a t e a file

c o n tro l re c o rd

in a n e d i t o r , w h i c h is a v e r y l a b o r i o u s ta s k , o r y o u c a n u s e a t e s t to o l in o u t b o u n d p r o c e s s i n g t o c r e a t e a file t h a t w ill c o n t a i n t h e d a t a y o u r e q u i r e . I n t h e l a t t e r s c e n a r i o , h o w e v e r , y o u r lo g ic a l s y s t e m is s p e c if ie d a s t h e s e n d e r ( a n d n o t t h e r e c e i v e r ) in t h e c o n t r o l r e c o r d . T h e r e f o r e , t h e c o n t r o l r e c o r d c a n ' t b e u s e d f o r y o u r p u r p o s e s . SAP p r o v i d e s T ra n s a c tio n W E I 2 h e r e , w h i c h y o u c a n u s e to o b t a i n t h e b u s i n e s s d a t a f r o m t h e file s p e c if ie d a s w e ll a s m a n u a l l y e n t e r t h e c o n t r o l r e c o r d d a t a . T h e r e s u lt i n g file is t h e n t e m p o r a r i l y s t o r e d a g a in .

C h a n g in g th e

You c a n , f o r e x a m p l e , m a k e t h i s file a v a il a b le t o a p a r t n e r a s a t e m p l a t e .

sender

F ig u re 3 . 1 2 s h o w s p a r t o n e o f t h e r e q u i r e d i n f o r m a t i o n o n t h e S e n d e r tab page.

M od ificatio n o f O utbound File T rig g e rin g Inb o un d Procg

Source D irectory • file \usrV sap\SM HSYS\gl0baftSM FILE_O U T8O U ND

Target D irectory • file lusr\sap'S M 1lS Y S \g loba l\S M F iLE _iN B O U N D

R ecipient

P a rtn e r n u m b e r

ZSH2

P a rtn e r T ype

LS

P a rtn e r Role

M e s s a g e type

m inus

vana nl Function

P o rt

F ig u re 3 .12

60

O Test

S H F lL fl

Transfer D a ta in S e n d in g System

P ro ce ssin g Status F ile s

O n th e R ecip ien t tab page, y o u e n t e r p art tw o o f th e in fo rm a tio n re q u ire d

C h a n g in g t h e

to o v e r r i d e t h e c o n t r o l r e c o r d (s e c F ig u r e 3 .1 3 ) . I D o c s g e n e r a t e d u s i n g

r e c e iv e r

T r a n s a c t i o n W F .12 a l s o o b t a i n t h e v a l u e 74: In b o u n d ID oc f r o m te st tra n s­ a ctio n a s t h e i r f ir s t s t a t u s , s o t h a t i t's a l w a y s c le a r t h a t t h e y a r e f o r te s t p u r p o s e s on ly .

M o d ific a tio n o f O u tb o u n d F ile

T rig g e rin g In b o u n d P ro c g

D irectory * file lu s r\$ a p \S M H S Y S lfllO b a n S M F IL E _ O U T 0 O U N D

Target D ire c to ry * t ile \u s r\s a p X S M U S Y S lg lo b a n S M F lL E _ lN B O U N D

S ftp s m ]

P o rt

F ig u r e 3.13

g )

T ra n s fe r D a ta in R e c e iv in g S yste m

You n o w k n o w all o f t h e o p t i o n s a v a il a b le f o r g e n e r a t i n g ID o c s f r o m test t r a n s a c t i o n s . In t h e n e x t s e c t i o n , w e 'l l t u r n o u r a t t e n t i o n t o s t a t u s files, w h ic h also h a v e s o m e g o o d te st o p tio n s.

3 .3

P ro ce ssin g S ta tu s File s

I D o c p r o c e s s i n g is a l w a y s a n a s y n c h r o n o u s p r o c e s s , w h i c h m e a n s t h a t , i f n o f u r t h e r a c t i o n is t a k e n , y o u d o n ' t r e c e i v e a n y i n f o r m a t i o n

61

|

3 .3

3

|

T e s t T o o ls

a b o u t w h e t h e r o r n o t t h e p a r t n e r h a s s u c c e s s f u l l y p r o c e s s e d y o u r ID o c. H o w e v e r , b e c a u s e t h i s i n f o r m a t i o n is f r e q u e n t l y r e q u i r e d , t h e r e a r c v a r i ­ o u s w a y s in w h i c h y o u r p a r t n e r c a n m a k e t h i s i n f o r m a t i o n a v a il a b le to you. " s ta tu s " and "S Y S T A T 0 1 "

O n e o f t h e s e o p t i o n s , w h i c h is f r e q u e n t l y u s e d b y EDI s u b s y s t e m s , in v o lv es re s e n d in g an ID oc w ith m essag e ty p e S Y S TA T01

STATUS

a n d ID o c t y p e

a l o n g w i t h a n ID o c s t a t u s file. N o r m a ll y , t h e s e n d e r d o e s n ’t

k n o w i f t h e r e c e i v e r w a s a b l e t o s u c c e s s f u l l y p r o c e s s its ID o c . H o w e v e r , t h e r e c e i v e r c a n u s e a s t a t u s file o r s t a t u s ID o c t o m a k e t h i s i n f o r m a t i o n a v a il a b le t o t h e s e n d e r . T h e s t a t u s ID o c w ill b e d e s c r i b e d in g r e a t e r d eta il in C h a p t e r 5 , S e c t i o n 5 . 2 , STATUS ID o c s . T e s tin g c o n c e r n s t h e s t a t u s file only. F ig u r e 3 . 1 4 s h o w s t h e s t a t u s v a l u e s o f a n ID o c t h a t h a s a l r e a d y b e e n d i s ­ p a t c h e d . T h i s ID o c w ill b e o u r s t a r t i n g p o i n t f o r t e s t i n g s t a t u s files. T h e s t a t u s v a l u e s 0 1 : ID oc g en e ra te d , 3 0 : ID oc re a d y f o r d isp a tch (A L E service), a n d 0 3 : D a ta p a ssed to p o r t O K a r e t h e s t a t u s v a l u e s t h a t a n ID o c m u s t r e c e i v e a t le a s t o n c e s o t h a t i t c a n b e d i s p a t c h e d s u c c e s s fu lly . In a d d i ­ t i o n , s t a t u s 4 2 s p e c if ic s t h a t t h e t e s t t r a n s a c t i o n h a s s u c c e s s f u l l y c r e a t e d t h e ID o c . B e c a u s e ID o c s c a n a l s o b e v i e w e d b y a u d i t i n g a u t h o r i t i e s , i f r e q u i r e d , i t m u s t b e c l e a r t h a t a n ID o c is e i t h e r " re a l" o r h a s b e e n c r e ­ a t e d f o r t e s t p u r p o s e s . SAP u s e s s t a t u s v a l u e 4 2 t o ta k e t h i s s i t u a t i o n i n t o acco u n t.

ID o c d is p la y _______________________

*

T e c h n ic a l s h o r l info

i ( U ID o c 0 0 0 0 0 0 0 0 0 0 7 6 8 7 5 9 0

C o n tr o l R e c

□

D a ta re c o rd s

D ir e c t io n C u r r e n t s ta t u s

P

03

O u tb o x CCO

T o ta l n u m b e r: 0 0 0 0 0 8 B a s ic ty p e

C 3 S t a t u s re c o r d s l>

1

hatmasos

[3

03

D a t a p a s s e d to p o rt O K

E x te n s io n

□

□

30

ID o c r e a d y fo r d is p a tc h (A L E s e r v ic e )

M e s s a g e ty p e

HATMAS

01

ID o c g e n e r a te d

P a rtn e r N o . _

ZSM

Q

42

ID o c w a s c r e a t e d b y te s t tra n s a c tio n

P a rtn T y p e

LS

P o rt

SAPSN1

F ig u r e 3.14

62

S ta tu s V a lu e s o f a n ID o c C r e a te d U s in g T ra n s a c tio n W E 1 9

P ro ce ssin g S ta tu s F ile s

W h e n t e s t i n g a s t a t u s file, t h e first s t e p is t o c r e a t e a s t a t u s file in T r a n s ­

C r e a t in g a

ac tio n W E 1 8 . T h e s y s te m p ro p o s e s c e rta in d e fa u lt v alu es th a t are u sed

s t a t u s f ile

|

w h e n c r e a t i n g a s t a t u s file, f o r e x a m p l e , 0 5 : E rror D u r in g T ranslation (s e e F ig u r e 3 . 1 5 ) . You c a n e d i t t h e s e s t a t u s v a l u e s a n d a d d n e w v a l u e s , i f req u ired .

Generate test status file for outbound IDocs q »

<*•

ID o c n u m b e r

768745

P a rtn e r N u m b e r

SALES

S a l e s s y s t e m ( c lie n t 8 1 0 )

P a r t n .T y p e

LS

L o g ic a l s y s t e m

MATMAS|

M a te ria l m a s t e r

P a r tn e r R o le M e s s a g e ty p e M e s s a g e V a ria n t M e s s fu n c t io n

□

S t a t u sTDate

T im e

T e s t in d ic a to r

Doc num ber

S t a t u s te x t

05

[0 8 / 17 /20 08 [2 0 : 2 7 :5 0 0000000000768745

E r r o r D u r i n g T r a n s la t io n

06

|0 8 / 17/2008 2 0 : 2 7 :5 8 0000000000768745

T r a n s la t io n O K

09

0 8 / 17/2008 2 0 : 2 7 :5 0 0000000000768745

E r r o r d u r in g i n t e r c h a n g e h a n d lin g

10

0 8 / 17/2008 2 0 : 2 7 :5 0 0000000000768745

11

j0 8 / 1 7/2 00 8 |2 0 : 2 7 : 50 0000000000768745

E r r o r d u r in g d is p a t c h

12

0 8 / 1 7/2 00 8 2 0 : 2 7 :5 0 0000000000768745

D is p a tc h O K

F ig u r e 3.15

n t e r c h a n g e h a n d li n g O K

C r e a tin g a S ta tu s F ile

T h e s ta tu s v alu es th e m s e lv e s a re m a d e av a ila b le v ia th e i n p u t h elp,

P o s s ib le s t a t u s

w h i c h c o n t a i n s a ll o f t h e s t a t u s v a l u e s t h a t a r e p o s s i b l e h e r e f r o m SAP's

v a lu e s

p e r s p e c t i v e , n a m e l y all v a l u e s t h a t b e l o n g t o p r o c e s s i n g l a y e r S = e x t e r ­ n a l s y s t e m / E D I s u b s y s t e m . A lis t o f p o s s i b l e s t a t u s v a l u e s is p r o v i d e d in T r a n s a c t i o n W E 4 7 , S ta tu s M a i n t e n a n c e ( s e e F ig u r e 3 . 1 6 ) . U n f o r t u n a t e l y , t h e d e s c r i p t i v e s h o r t t e x t c a n ' t b e t r a n s f e r r e d a t p r e s e n t . T h e r e is a ls o n o se p a ra te help, w h ic h m e a n s th a t y o u m u s t m a n u a lly e n te r th e s h o rt text in t e s t T r a n s a c t i o n W E I 8.

63

3 .3

3

|

T e s t T o o ls

Stu

"

n n d i [ 3 E 0 E E E ] [ in Stat 04

(Description E rro r w it h in c o n tro l in fo rm a tio n o f E D I s u b s y s te m

05

Error D u r in g T r a n s la tio n

06

T r a n s la t io n O K

07

E rro r d u r in g s y n ta x c h e c k

08

S y n ta x c h e c k O K

09

Error d u r in g in te rc h a n g e h a n d lin g

10

n t e r c h a n g e h a n d lin g O K

11

E rro r d u r in g d is p a tc h

12

D is p a tc h O K

13

R e t r a n s m is s io n O K

14

n t e r c h a n g e A c k n o w le d g e m e n t p o s itiv e

15

n t e r c h a n g e A c k n o w le d g e m e n t n e g a liv e

16

F u n c tio n a l A c k n o w le d g e m e n t p o s itiv e

17

F u n c tio n a l A c k n o w le d g e m e n t n e g a tiv e

22

D is p a tc h O K a c k n o w le d g e m e n t still d u e

23

E rro r d u r in g r e tr a n s m is s io n

24

C o n tr o l in fo rm a tio n o f E D I s u b s y s t e m O K

36

E le c tro n ic s ig n a t u r e n o t p e r f o r m e d (tim e o u t)

F ig u r e 3 .1 6

P o s s ib le S ta tu s V a lu e s f o r t h e S ta tu s F ile

S t a t u s file

In t h e n e x t s t e p (s e e F ig u r e 3 .1 7 ) , y o u u s e t h e D i r e c t o r y + file fie ld to

a c c o r d in g t o y o u r

s p e c i f y w h e r e y o u w a n t t o s a v e t h e n e w file, a n d y o u u s e t h e S t a r t S ta tu s

s p e c if ic a t io n s

P ro c e s s i n g I m m e d i a t e l y flag to s p e c if y w h e t h e r y o u w a n t t h e file t o be p r o c e s s e d i m m e d i a t e l y . T h e s y s t e m t h e n c r e a t e s a s t a t u s file a c c o r d i n g to y o u r s p e c if ic a t i o n s . Y our p a r t n e r c a n n o w u s e t h i s file a s a t e m p l a t e f o r c r e a t i n g s u c h files.

S _____ G e n e r a t e te s t s t a t u s f ile fo r o u tb o u n d ID o c s P o rt S H F IL E □

U n ic o d e ____________

D ir e c t o r y * file

\u s rts a p \S M 2 lS Y S X g lo b a l\S ta tu s _ s a b m e _ d e m o

s t a r t s t a t u s p r o c e s s in g im m e d ia t e ly

F ig u re 3 .17

64

In p u t V a lu e s fo r S a v in g th e Status File

P ro ce ssin g Status F ile s

|

You c a n n o w u s e T r a n s a c t i o n W E 1 7 to i m p o r t a s t a t u s file ( t h a t y o u 'v e

I m p o r t in g t h e

cre a te d y o u r s e lf o r tra n sfe rre d fro m a p a rtn e r) in to y o u r sy stem . The

s t a t u s f ile

p a t h a n d p o r t s p e c i f i c a t i o n s c o r r e s p o n d t o t h o s e s p e c if ie d in t h e t r a n s ­ a c t i o n s h o w n p r e v i o u s l y ( W E I 9). F o r t e s t p u r p o s e s , it d o e s n ' t m a t t e r i f y o u ' v e c r e a t e d t h e file y o u r s e l f o r i f t h e file h a s b e e n t r a n s f e r r e d f r o m a p a r t n e r . In a d d i t i o n t o y o u r p r e v i o u s s t a t u s v a l u e s , t h e ID o c a l s o g e t s t h e n e w s t a t u s v a l u e s f r o m t h e s t a t u s file. F ig u r e 3 . 1 8 s h o w s t h e o u t c o m e w h e n y o u u s e t h e d a t a e n t e r e d in T r a n s a c t i o n W E 1 8 .

ID o c d is p la y ^

|

d

ID o c 0 0 0 0 0 0 0 0 0 0 7 6 8 7 5 9 □

C o n tr o l R e c .

P

□

D a ta re c o rd s

^

< 3 S t a t u s re c o r d s

p

P

T o ta l n u m b e r 0 0 0 0 0 8

(H 12

D is p a tc h O K

□

E rro r d u rin g d is p a tc h

11

0

10

In te rc h a n g e h a n d lin g O K

Q

09

E rro r d u rin g In te r c h a n g e h a n d lin g

□

06

T r a n s la t io n O K

GD 0 5

E rro r D u rin g T r a n s la t io n

GD 0 3

D a t a p a s s e d to p o r t O K

0

30

ID o c r e a d y fo r d is p a tc h (A L E s e r v ic e )

Q

01

ID o c g e n e r a te d

0

42

ID o c w a s c r e a t e d b y t e s t tra n s a c tio n

F ig u r e 3 .1 8

S ta tu s V a lu e s o f I D o c A f t e r I m p o r t in g t h e S ta tu s F ile

As y o u c a n s e e , t h e s t a t u s v a l u e s in F ig u r e 3 . 1 8 a r e s u c c e s s a n d fa ilu re

R esponse to

s t a t u s v a l u e s . N o t e t h a t , in t h e c a s e o f e r r o r m e s s a g e s , y o u c a n t r i g ­

s t a t u s v a lu e s

g e r e r r o r w o r k f l o w s ( e r r o r T r a n s a c t i o n EDIS) a g a in , a n d t h e ID o c m a y g e t a s t a t u s t h a t m a k e s i t r e a d y - f o r - d i s p a t c h a g a in . T h e last o r i g i n a l s t a ­ tu s ( 0 3 : D a t a p a s s e d t o p o r t OK) is a s t a t u s v a l u e t h a t d o e s n ’t a l l o w t h e ID o c t o b e d i s p a t c h e d a g a in . T h e o p t i o n o f u s i n g t h e n e w s t a t u s v a l u e t o r e s c h e d u l e a n I D o c is o f t e n t h e r e a s o n w h y s u c h s t a t u s v al­ u e s a r e e x c h a n g e d w i t h a n E D I s u b s y s t e m o r a n o t h e r p a r t n e r . A s far as t h e SAP s y s t e m is c o n c e r n e d , t h e r e a r e n o p r o b l e m s o n c e a n ID o c is d i s p a t c h e d s u c c e s s fu lly . C o n s e q u e n t l y , t h e r e is n o n e e d t o d i s p a t c h th e ID o c a g a in . I f t h e r e c e i v i n g s y s t e m e x p e r i e n c e s s e r i o u s e r r o r s a n d n e e d s t h e I D o c a g a in , i t m u s t i n f o r m t h e s e n d i n g s y s t e m . W i t h o u t t h e u s e o f s t a t u s ID o c s o r s t a t u s files, i t w o u l d n o t b e p o s s i b l e t o s u b s e q u e n t l y a s s ig n a n e w s t a t u s t o ID o c s t h a t h a v e b e e n s u c c e s s f u l l y p r o c e s s e d i n t h e SAP s y s t e m .

65

3 .3

3

|

T e s t T o o ls

3 .4

S u m m a ry

In t h i s c h a p t e r , y o u l e a r n e d a b o u t t e s t t o o l s . N o w , y o u s h o u l d b e a b l e to te s t t h e ID o c c o n n e c t i o n s t h a t y o u w o u l d l i k e to u s e w i t h y o u r p a r t n e r s w ith o u t h av in g to in v o lv e th e p a rtn e rs. D e p e n d in g o n the d ire c tio n o f t h e I D o c ( i n b o u n d o r o u t b o u n d ) , y o u c a n fig u re o u t t h e t e s t to o l t h a t fits y o u r n e e d s b e s t . You a ls o l e a r n e d h o w s t a t u s h a n d l i n g c a n b e t e s t e d as n e e d e d . By k n o w i n g t h a t t h e s t a n d a r d p r o c e s s w o r k s as n e c e s s a r y , w e c a n m o v e o n t o t h e a d o p t i o n o f s p e c i a l n e e d s t o t h e SAP S t a n d a r d ID o c s , in C h a p t e r 4.

66

So f a r , th is b o o k h a s d esc rib e d th e use o f S A P -p ro v id e d ID ocs. In th is ch a p ter, y o u 'l l le a rn h o w y o u c a n c u s to m iz e th ese ID ocs w ith o p tio n s r a n g in g f r o m s lig h t C u s to m iz in g a d ju s tm e n ts to co m p le x c u s to m d e v e lo p m e n ts in te g r a te d in to exits.

4

Changes to IDocs

T h e S A P - p r o v id e d s t a n d a r d ID o c t y p e s ( w h i c h a r e a ls o c a ll e d b a s ic ty p e s )

C h a n g e s to th e

c o n s i d e r fie ld s t h a t a r e i n c l u d e d in t h e SAP s t a n d a r d a n d r e l e v a n t f o r t h e

s t a n d a r d v e r s io n

c o r r e s p o n d i n g s c e n a r i o . T h i s m a y n o t b e s u f f i c ie n t f o r t h e p r o c e s s y o u w a n t to p ro v id e , p artic u la rly i f c u sto m er-sp ecific e n h a n c e m e n ts hav e b e e n i m p l e m e n t e d in t h e a p p l i c a t i o n t r a n s a c t i o n s , w h i c h a r c c o r r e ­ s p o n d i n g to t h e ID o c t y p e s . C o n s e q u e n t l y , t h e r e a r e v a r i o u s o p t i o n s fo r c h a n g i n g ID o c s t h a t a p p l y to b o t h t h e d a t a v o l u m e a n d t h e d a t a c o n t e n t . You c a n e v e n c o m p l e t e l y s u p p r e s s t h e g e n e r a t i o n o f ID o c s u n d e r c e r t a i n c i r c u m s t a n c e s . T h e c h a n g e s c a n b e m a d e v ia C u s t o m i z i n g a s w e ll as b y u s i n g t h e e n t i r e r a n g e o f e n h a n c e m e n t t e c h n o l o g i e s p r o v i d e d b y SAP, w h i c h a r e i n t r o d u c e d in t h i s c h a p t e r . L et's s t a r t w i t h t h e C u s to m i z i n g , w h ic h re q u ire s th e least in terfe ren c e.

4.1

C u s to m iz in g

C u s t o m i z i n g p r o v i d e s s e v e r a l o p t i o n s f o r s u p p r e s s i n g p a r t s o f ID o c s o r e n t i r e ID o c s a n d p r o c e s s i n g c o n t e n t o f ID o c s u s i n g r u l e s . C u s t o m i z i n g t h r o u g h f i lte rin g a n d c o n v e r s i o n is u s e d m o s t o f t e n a n d c a n b e i m p l e ­ m e n t e d r e l a t i v e l y easily, w h i c h is w h y it's i n t r o d u c e d first.

4 .1.1

Filte rin g U sing Filter O bje cts

You c a n c o n f i g u r e f i lte rin g w i t h f i l t e r objects in T r a n s a c t i o n B D 6 4 in t h e c u s t o m e r d i s t r i b u t i o n m o d e l . I f SAP p r o v i d e s t h e s e , y o u c a n s e l e c t filte r o b j e c t s a n d a s s ig n v a l u e s t o t h e m f o r a n y o b j e c t t h a t is a v a il a b le i n a c u s ­ t o m e r d i s t r i b u t i o n m o d e l v i e w . E ac h f i l t e r o b j e c t c o r r e s p o n d s t o a field.

67

F ilt e r o b je c t s

4

|

C h an g e s to ID o cs

You c a n a ls o c o m b i n e f i l t e r o b j e c t s . In t h i s c a s e , A N D a s w e ll a s O R lin k s o f m u l t i p l e fie ld s a r c fe a s ib le . T h e d i s t r i b u t i o n m o d e l d i r e c t l y i n d i c a t e s i f a m e s s a g e t y p e c o n t a i n s f i l t e r o b j e c t s (s e e F ig u r e 4 .1 ).

C h a n g e D is t r ib u t io n M o d e l S y s te m V ie w

^

F ilte r m o d e l d is p la y

D is trib u tio n M o d e l ^

□

C r e a te m o d e l v ie w

|D e s c r ip t io n /t e c h n ic a l n a m e

M o d e l v ie w s ^

S £ zsm _v e w

Z S M _ V IE W

^

ZSM t

0

S a b in e s D e m o S y s te m 1

^

0

S a b in e s D e m o S y s te m 2

ZSM 2

^

0

M a te r ia l m a s t e r

M ATM AS N o filte r s e t

F ig u r e 4.1

F ilt e r g r o u p s

D is t r ib u t io n M o d e l W i t h o u t F ilte r in g

I f filte r o b j e c t s a r c a v a ila b le , y o u c a n c r e a t e f i l t e r g ro u p s f o r t h e r e s p e c t i v e m essag e typ e. Your setting s alw ays re fe r to a c o m b in a tio n o f s e n d e r a n d re c e iv e r , s o y o u c a n d e c i d e f o r e a c h s e n d i n g o r r e c e i v i n g s y s t e m i f filte r­ i n g w ill b e i m p l e m e n t e d o r n o t . F ig u r e 4 . 2 s h o w s a n e x a m p l e w i t h t w o filte r g r o u p s , w h e r e e a c h filte r g r o u p i n c l u d e s t w o f i l t e r o b j e c t s (M a te ria l G r o u p a n d P l a n t as w e ll a s M a t e r i a l G r o u p a n d D iv is io n ) t h a t c o n t a i n t w o v a l u e i n s t a n c e s e a c h . T h e lin k is d e s i g n e d s o t h a t t h e c o n d i t i o n s o f o n e o r t h e o t h e r f i l t e r g r o u p m u s t b e m e t . I f c o n d i t i o n s f o r m u l t i p l e filte r o b j e c t s a r e s p e c if ie d w i t h i n t h e f i l t e r g r o u p , all c o n d i t i o n s m u s t b e m e t . W ith in a filter o b ject, o n e c o n d itio n m u s t b e m et.

P o s itiv e f i l t e r i n g

I f a f i l t e r o b j e c t b e l o n g s to a n o p t i o n a l s e g m e n t o f a n ID o c , t h e s y s t e m g e n e r a t e s th is s e g m e n t i f t h e f i l t e r v a l u e is m e t ; t h e s y s t e m d o e s n ' t g e n e r ­ a t e t h e s e g m e n t i f t h e f i l t e r v a l u e i s n ' t m e t . In t h e e x a m p l e f r o m F ig u re 4 .2 w ith p lan ts 1 0 0 0 , 2 0 0 0 , 3 0 0 0 , a n d 4 0 0 0 a ss ig n e d to a m ateria l, th e sy ste m w o u ld g e n e ra te tw o

E1M ARCM

s e g m e n t s f o r t h e first filte r g r o u p ,

t h a t is, t h e s e g m e n t s w i t h p l a n t s 1 0 0 0 a n d 2 0 0 0 , a n d w o u l d s u p p r e s s the o t h e r tw o seg m e n ts. S u p p r e s s in g ID o c s u s in g f ilt e r s

I f a filte r o b j e c t b e l o n g s to a field in a m a n d a t o i y s e g m e n t , t h e s y s t e m s u p p r e s s e s t h e e n t i r e ID o c i f i t c a n ' t g e n e r a t e t h e s e g m e n t . In o u r e x a m ­ p le , t h e s y s t e m w o u l d g e n e r a t e ID o c s f o r m a t e r i a l s w i t h t h e haw a

m a te ria l ty p es; fo r th e

h alb

FERT

and

m a t e r i a l t y p e , it w o u l d s u p p r e s s t h e

ID o c c o m p l e t e l y . F o r a m a t e r i a l ( i n d e p e n d e n t o f t h e m a t e r i a l t y p e a n d

68

C u s to m iz in g

plan t) th a t b e lo n g s to th e

|

4 .1

002 o r 001 m a t e r i a l g r o u p a n d 01 o r 10 d i v i ­

s i o n , t h e s y s t e m w o u l d g e n e r a t e a c o m p l e t e ID o c a c c o r d i n g t o t h e ru les o f t h e s e c o n d filte r g r o u p .

D isplay Distribution Model 0

§ | | -

h Q S y s te m V ie w

V

Filter m o d e l d is p la y

D is trib u tio n M o d el ^

[D e s c rip tio n /te c h n ic a l n a m e

M o d e l v ie w s "

Z S M _V 1E W

ZSM _YEW

0

S a b in e s D e m o S y s te m 1

ZSM 1

^

@

ZSM2

S a b in e s D e m o S y s te m 2

^

M ATM AS ”

^

l ^ | F ilte r group ^

^

^

Q ) M a te ria l G ro u p

M a te ria l G ro u p

(U fert

N o sh o rt text m a in ta in e d

[ 3 -H A W A

N o sh o rt text m a in ta in e d

Q ) P lan t

P la n t

^ 1 0 0 0

W e r k H a m b u rg

[S' 2000

H e a th r o w /H a y e s

! ® Filter group ^

^

F ig u r e 4 .2

M a te ria l m a s te r

S } D a ta filte r active

Q j M a te ria l G ro u p

M a te ria l G ro u p

S ' 001

M e ta l p ro c e s s in g

S 002

E le c tro n ic s

Q ) D ivisio n

D M s io n

U O I

N o sh o rt text m a in ta in e d

££10

N o sh o rt text m a in ta in e d

D is t r ib u t io n M o d e l w i t h F ilt e r in g U s in g S ta n d a rd F ilt e r O b je c ts

F o r m e s s a g e t y p e s t h a t b e l o n g t o a n o b j e c t t y p e t h a t a l l o w s f o r classificat i o n . y o u c a n a ls o f i l t e r b y c lass m e m b e r s h i p . W h e t h e r t h i s is p o s s i b l e is d e s c r i b e d in T r a n s a c t i o n B D 6 0 , w h i c h y o u a l r e a d y k n o w f r o m C h a p t e r 2 , S e c t i o n 2 . 1 . 1 , S h a r e d M a s t e r D a t a Tool. F ig u r e 4 . 3 d i s p l a y s a p a r t o f T ran sactio n B D 60 s h o w in g the s ettin g s fo r th e

M ATM A S

m a t e r ia l m a s t e r

m e s s a g e t y p e . T h e s e s e t t i n g s a r e i m p l e m e n t e d b y t h e d e v e l o p e r o f th e m e s s a g e t y p e b e c a u s e t h i s is t h e o n l y p e r s o n w h o k n o w s i f a n a p p r o p r i ­ a t e c la s s ific a tio n o b j e c t is a v a ila b le .

C l a s s if ia b le O b je c t A L E O b je c t Typ e

F ig u re 4-3

T ra n s a c tio n B D 6 0

69

F ilt e r o b je c t " c la s s ”

4

|

C h an g e s to ID o cs

I f f i lte rin g b y c la s s ific a tio n is p o s s i b l e , t h i s is i n d i c a t e d in t h e filte r g r o u p a s a s p e c if ic f i l t e r o b j e c t , n a m e l y , D e p e n d e n t o n C lass M e m b e r s h i p (see F ig u r e 4 . 4 ) . H o w e v e r , t h e c o r r e s p o n d i n g f i l t e r m e c h a n i s m is o n l y a c ti ­ v a t e d h e r e . F o r a c t u a l l y u s i n g t h e fi l t e r i n g , f u r t h e r s t e p s n e e d t o b e p erfo rm ed .

D is p la y D is t r ib u t io n M o d e l 'y

Q

*

■ € System v ie w ] ^

Fine* m o d e l display

[D lsln b u lio n Model

[~ |Descrtpt>onr technical nam e

(B u s in e s s object

Model ^ ^

ZSM _VEW

ZSM_V)EW

@ Sabines D e m o System 1

ZSMt

"

g j Sabines D e m o System 2

ZSM2

~

M aterial m aster

m atm as

v ^ ^

Data (liter active I ® Filter group f f f l Dependent o n c la s s m e m b e rsh ip

F ig u r e 4 . 4

R e quires cla s s e s lo be d e f ned in the se n d in g system

p ) Dependent on c la s s m em bership

F ilte r in g b y Class M e m b e r s h ip

In g e n e r a l , y o u c a n m a i n t a i n t h e c u s t o m e r d i s t r i b u t i o n m o d e l in b o t h t h e s e n d i n g a n d t h e r e c e i v i n g s y s t e m . All s e t t i n g s t h a t a r e n e c e s s a r y f o r f i l t e r i n g , h o w e v e r , m u s t b e m a d e in t h e s e n d i n g s y s t e m b e c a u s e th is s y s t e m is n o t s u p p o s e d to s e n d u n w a n t e d I D o c s a t all. D is tr ib u tio n

class

ty p e

F ir s t o f all, y o u m u s t c r e a t e a n a p p r o p r i a t e c lass t y p e . You c a n d o th is u s in g T r a n s a c t i o n 0 1 CL. You h a v e to a s s i g n t h e c la s s t y p e t o t h e c o r ­ r e s p o n d i n g t a b l e in T r a n s a c t i o n B D 6 0 . In o u r m a t e r i a l m a s t e r e x a m p l e , t h i s w o u l d b e T a b le

M ARA.

F u r t h e r m o r e , y o u m u s t i d e n t i f y t h e c lass t y p e

as a d i s t r i b u t i o n c lass t y p e u s i n g t h e D i s t r i b u t i o n Class T y p e c h e c k b o x in t h e F u n c t i o n s t a b . T h e r e m u s t b e o n l y o n e d i s t r i b u t i o n c lass t y p e f o r e a c h c la s sifia b le o b j e c t , w h i c h s h o u l d n ' t b e t h e s t a n d a r d c lass t y p e . T h e s y s t e m a l w a y s p r o p o s e s t h e s t a n d a r d c lass t y p e i f a c lass is u s e d f o r th is o b j e c t . H o w e v e r , t h i s d i s t r i b u t i o n c lass t y p e is le s s o f t e n u s e d t h a n t h e class t y p e s f o r fi n d i n g o b j e c t s b y c lass ific a tio n , s o , y o u s h o u l d n ' t d e f i n e it a s t h e s t a n d a r d c lass t y p e . You c a n m a i n t a i n t h e r e m a i n i n g fie ld s a c c o r d ­ in g to y o u r c o m m o n e n t e r p r i s e r e g u la t io n s ; t h e s e fields a r e n ’t r e l e v a n t f o r t h e d i s t r i b u t i o n , a n d s o m e o f t h e m c a n ’t b e s e l e c t e d a n y w a y . F ig u re 4 .5 s h o w s a n e x a m p le o f the input.

70

C u sto m iz in g

Change V iew "C la ss T yp e s": Details

C la s s Type ^

ZSH U s ts fo r m a te ria l d is tn b u tio n (ALE)

C ] O b je c t Table ^

Q

C la s s Types Q

Objects

Q

C la s s Status

O bject / Table

C ] O rga nizatio nal Areas D T e r t Types □

C la s s ific a tio n Status

C ] Fun ctions/F ilters fo r F in d in g Ob)ects

S c re e n s /

F u n c tio n s /

E Keyw ords

□ S ta n d a rd C la s s Type

C C h ara cteristics

0

C D o cu m e n ts

□ C la s s , in m a s te r rec

M ultiple cla s s ific a tio n

C Texts

□ V a r ia n t c la s s ftp e

C S ta n d a rd s data

□ M ultiple o b is allo w e d

C ia s s ific a to n s /

0 D i s t r c la s s type

C E C H f lim e )

□ H ie ra rc h y allow ed

C E C H (param e ter)

□ G en e ra te d table s

□ C la s s nod e

C Change Docs

F ig u r e 4 . 5

P r o p e rtie s o f t h e D is t r ib u t io n C la ss T y p e

F o r e a c h c lass t y p e , y o u c a n s p e c i f y d i f f e r e n t s t a t u s v a l u e s , w h i c h t h e

Status values

classes o f t h i s c lass t y p e c a n a d o p t (s e e F ig u r e 4 .6 ). F o r t h e m e r e d i s t r i b u -

of classes

tio n , t h e 1: R e le a s e d s t a t u s is r e q u i r e d . W h e t h e r y o u n e e d t o a s s ig n f u r ­ t h e r s t a t u s d e p e n d s o n y o u r e n t e r p r i s e r e g u la t io n s . T h e 1: R e le a s e d s ta tu s is n e c e s s a r y t o u s e a c lass as a c r i t e r i o n f o r d i s t r i b u t i o n . F ig u re 4 . 6 d i s ­ p la y s t w o a d d i t i o n a l s t a t u s v a l u e s t h a t a r c f r e q u e n t l y u s e d : 0 : In c r c a t i o n a n d 2 : B lo ck ed . B e c a u s e b o t h d o n ' t a l l o w f o r a s s i g n m e n t s o f o b j e c t s , y o u d o n ’t u s e t h e m f o r d i s t r i b u t i o n c lasse s. SA P p r o v i d e s t h e m f o r t h e m a t e ­ rial m a s t e r d i s t r i b u t i o n class ty p e , s o t h e y a r e d i s p l a y e d h e r e a s w ell.

Change V iew "C la ss S tatu s": O verview

D ia lo g Structure “

Ty

Q ] O b je c t Table Q

O biects

Q j C la s s Status

2SH

S iT ert lin creation R e lease d

-

zsn

Blocked

C ] T e i l Types C l C la s s ific a tio n Slatus Q

F ig u re 4 .6

F u n c tio n s ^ lite rs fo r F in d in g O bjects

Status V a lu e s o f th e D is trib u tio n C lass Type

71

|

4 .1

4

|

C h an g e s to ID o cs

S am e c la s s ific a tio n

D u e to t h e p r e v i o u s w o r k , y o u c a n n o w c r e a t e a c lass in a r e le a s e d s t a ­ t u s t h a t b e l o n g s t o t h e d i s t r i b u t i o n c lass t y p e u s i n g T r a n s a c t i o n C L 02 . You m u s t s e l e c t t h e D o N o r

C

heck

o p tio n fo r

Sa

m e

C

l a s s if ic a t io n

(see

F ig u r e 4 . 7 ) . T h e c h e c k a c tu a l ly e n s u r e s t h a t t w o o b j e c t s w i t h t h e s a m e v a l u e s a s s i g n e d t o t h e i r c h a r a c t e r i s t i c s c a n ’t b e a s s i g n e d t o t h e s a m e class. H o w e v e r , b e c a u s e d i s t r i b u t i o n c la s se s d o n ’t i n v o l v e c h a r a c te r i s t ic v a lu e a ssig n m e n ts, th e s e c o n d assig n e d o b je c t alre ad y en tails m u ltip le c la s sific a tio n ( t w o o b j e c t s w i t h e x a c t l y t h e s a m e p r o p e r t i e s ) , s o a c h e c k i s n ’t w a n t e d h e r e .

5 * 3 ] C r e a te C la s s : £1

C h a n g e Lan guage

C lass

ZS H LIS TIN 6.A L E

C la s s tn>e

ZSH

E50 G JE E

Lists fo r m aterial distribution (ALE)

C h an g e Number

08/17/2009

valid from

V a lid ity

Keywords

Status C la s s group Organizational area V alid From

S a m e classification / ~

Authorizationsf

® D o not check

C lass maintenance

O w a r n in g m essage

Classification

O Check vrtth error

Find object

F ig u re

4.7

C r e a t i n g a D i s t r i b u t i o n Class

A s s ig n in g to

You c a n n o w a s s i g n s u c h a d i s t r i b u t i o n c lass to a p a r t n e r u s i n g T ra n s a c ­

th e p a rtn e r

t i o n B D 6 8 (s e e F ig u re 4 .8 ). D e f i n e t h e r e c e i v i n g s y s t e m a s t h e Logical S y s te m . In t h e PoP field, a l w a y s e n t e r "2" f o r p u s h b e c a u s e y o u w a n t to s e n d o b j e c t s . N o w , i t's n o l o n g e r p o s s i b l e t o s e n d o b j e c t s to t h e p a r t ­ n e r s t h a t h a v e n ' t b e e n a s s i g n e d t o t h e c o r r e s p o n d i n g c lass in T ra n s a c tio n C L 2 0 N . T h e ID o c f o r a n o b j e c t t h a t h a s n ' t b e e n a s s i g n e d t o a c lass (e.g., m a t e r ia l) is s u p p r e s s e d c o m p l e t e l y a n d w ill n e v e r b e d i s p l a y e d in T r a n s ­ a c t i o n B D 8 7 , ID o c m o n i t o r i n g .

72

C u sto m iz in g

|

4 .1

You c a n a ls o a s s ig n m u l t i p l e c la s s e s to t h e s a m e r e c e i v i n g s y s t e m . N o

A s s ig n in g m u ltip le

s e t t i n g s h a v e t o b e m a d e o n t h e r e c e i v e r s i d e in t h i s c a s e . T h e p u l l f u n c ­

c la s s e s

t i o n a l i t y (" 1 " ) i s n 't u s e d f o r ALE c o m m u n i c a t i o n .

Change V iew "C lasses in L ogical S ystem ": O verview V

N e w E n trie s ] f c 5

L o g ic a l System

| ^

| £

B

B

ZSH2

C la s s e s in Logical System m essage Type

C lass

HATHAS

|P o P

Z S M IIS T IN G .A IE

I

E

I

S

0

2

^ F u n c t io n o n h s l "P ush* o r ' P u i r (4) 1o

1801361H

1

I Q

2 E n trie

D E I/

-

>ush
Figure 4-8

A s s i g n i n g t h e D i s t r i b u t i o n C la ss t o t h e P a r t n e r S y s te m

T h is f i lte rin g e n a b l e s y o u t o s e n d t h e d a t a to t h e p a r t n e r s y s t e m . D e p e n d ­ i n g o n t h e s y s t e m 's f u n c t i o n , t h i s d a t a is r e l e v a n t t h e r e . F o r e x a m p l e , i f y o u h a v e a s p e c ia l d i s t r i b u t i o n c e n t e r , y o u p r o b a b l y o n l y w a n t to s e n d trad in g g o o d s

(HAWA

m a t e r ia l t y p e ) to t h e c o r r e s p o n d i n g w a r e h o u s e m a n ­

a g e m e n t sy stem ; i f y o u w o r k w ith a ce n tra l m a s te r d a ta s y s te m , a n d e v e r y p l a n t u s e s its o w n SAP s y s t e m , e a c h s y s t e m s h o u l d b e p r o v i d e d w i t h t h e m a t e r i a l d a t a f o r its p l a n t on ly .

4.1.2

Custo m F ilte r O bjects

T h e f i lte rin g o p t i o n s d e s c r i b e d s o f a r a r c d e l i v e r e d b y SAP. I f y o u h a v e a d d i t i o n a l r e q u i r e m e n t s , y o u c a n a l s o c r e a t e c u s t o m filte r o b j e c t s . This c a n b e d o n e n o t o n l y f o r s t a n d a r d SA P fields a n d s e g m e n t s b u t a l s o fo r fie ld s in c u s t o m t a b le s , f o r ta b l e a p p e n d s , o r f o r c u s t o m s e g m e n t s . F ilter­ i n g b y filte r o b j e c t s is a n ALE s e r v ic e . You i m p l e m e n t t h e n e c e s s a r y s e t t i n g s in T r a n s a c t i o n B D 9 5 . First, as s ig n

C re a tin g filte r

a n a m e to th e filter o b je c t. T h is n a m e m u s t m e e t t h e c o m m o n c u s­

o b je c ts

t o m e r n a m e s p a c e r u l e s , t h a t is, b e g i n w i t h Z o r Y o r y o u r o w n c u s t o m e r n a m e s p a c e . In o u r e x a m p l e , t h e n a m e is th e tab le

(MARA)

ZBISMAT

a n d t h e field in t h e d a t a b a s e

(s e e F ig u r e 4 . 9 ) . A s s ig n

(BISMT)

to t h i s n a m e .

73

4

|

C h an g e s to ID o cs

A L E O b je c t T y p e I a l E O b je c t T y p e

jT a b ie N a m e

iF ie ld n a m e

jZ B IS M A T

IhARA

Ib is h t

Figure 4 .9

C re a tin g a C u s to m F ilte r O b je c t

To i m p l e m e n t t h a t y o u r filte r o b j e c t is a c tu a l ly u s e d in t h e ALE s e r v ic e s , y o u m u s t d e f i n e in w h i c h s e g m e n t s o f w h i c h m e s s a g e t y p e s it c a n be u s e d . F o r t h i s p u r p o s e , first s e l e c t a m e s s a g e t y p e as t h e w o r k a r e a in T r a n s a c t i o n B D 5 9 . F ig u r e 4 . 1 0 s h o w s t h i s f o r t h e m a t e r ia l m a s t e r e x a m ­ ple, t h a t is, f o r t h e

MATMAS

m e s s a g e t y p e as t h e w o r k a re a .

M aintain T a b le View s: Initial Screen ( * ] F in d M a in te n a n c e D ia lo g ■ S ' D e te r m in e W o r k Axea: E n try

0

/

W o r k A re a M e s s a g e Type

< s ? \ [ F u r th e r s e l e c t c o n d .

Figure

4.10

0

M A TM A S

A ppend

^

1

A s s ig n in g t h e C u s to m F ilte r O b je c t t o t h e M e s s a g e T ype — Step

T h e n , s e l e c t t h e s e g m e n t o f t h e m e s s a g e t y p e in w h i c h y o u w a n t to c a rry o u t t h e f i lte rin g (s e e F ig u r e 4 . 1 1 ) . I n o u r e x a m p l e , t h i s is t h e

E1MARAM

s e g m e n t . You c a n n o w a d d r e s s all fie ld s o f t h i s s e g m e n t t o g e n e r a t e y o u r p e r s o n a l filte r o b j e c t .

New E n trie s: O verview of Added Entries i *

S

i l l

M e s s a g e Type

MATMAS

A s s ig n m e n t o f O b je c t T y p e to M e s s a g e A L E O b je c t T y p e

(s e g m ty p e

[n o

Z B IS M A T

E1NARAM

|1

F ig u re 4 .11

74

:ie id 6 IS M T

|o its e t „

(in tL e n g th „

A ssig n in g th e C u sto m F ilte r O b je c t to th e M e ssa g e T y p e — S te p 2

C u sto m iz in g

|

4 .1

W h e n a s s i g n i n g t h e filte r o b j e c t , t h e s y s t e m a u t o m a t i c a l l y d e t e r m i n e s

A s s ig n in g th e filte r

w h e r e in t h e d a t a r e c o r d w i t h i n t h e s e g m e n t t h e r e s p e c t i v e fie ld is

o b je c t t o th e ID o c

l o c a t e d . T h i s l e a d s to t h e O f f s e t; i n o u r e x a m p l e , t h e v a l u e is " 9 1 ." If

fie ld

y o u ' v e c r e a t e d t h e s e g m e n t t h a t c o n t a i n s t h e filte r o b j e c t y o u r s e l f , a n d i f y o u m o d i f y it s o t h a t t h e p o s i t i o n o f t h e c o r r e s p o n d i n g field c h a n g e s , t h e s y s t e m d o e s n ' t c o p y t h e n e w o f f s e t to y o u r f i l t e r o b j e c t a u t o m a t i c a l l y . In th is case, y o u h av e to u p d a te t h e n e w in fo rm a tio n y o u rs e lf. To d o th is , first d e t e r m i n e t h e n e w o f f s e t v a l u e , f o r e x a m p l e , u s i n g T r a n s ­

C u s to m iz in g

a c t i o n W E 6 0 , t h e ID o c d o c u m e n t a t i o n . T h e n , s e l e c t y o u r filte r o b j e c t ,

th e o ffse t

and choose

Ed

• Ch

it

a n g e

Fiel d C o

n t en t

in t h e m e n u . T h r e e s e t t i n g

o p t i o n s a r e a v a ila b le : ► F ie ld N a m e ► I n t e r n a l L e n g th ► T a b le P o s itio n First, s e l e c t T a b le P o s it i o n , a n d s e l e c t t h e p r e v i o u s l y d e t e r m i n e d o f f s e t v a l u e . I f t h e l e n g t h o f t h e filte r fie ld s h a s c h a n g e d , t o o , y o u c a n a d a p t t h e c o r r e s p o n d i n g v a l u e s in t h e s a m e w a y v ia I n t e r n a l L e n g th . I f t h e field n a m e h a s c h a n g e d , t h e s y s t e m fi n d s t h e n e w v a l u e a u t o m a t i c a l l y . A fte r y o u 'v e im p le m e n te d th e se settin g s, th e s y s te m p ro v id e s y o u r cre­

F ilt e r in g in th e

a te d filter o b je c t in t h e c u s to m e r d is trib u tio n m o d e l w h ic h can b e seen

c u s to m e r

in F ig u r e 4 . 1 2 . You c a n u s e i t lik e a s t a n d a r d SAP f i l t e r o b j e c t . O f c o u r s e , y o u c a n a l s o u s e t h e s a m e f i l t e r o b j e c t f o r m u l t i p l e m e s s a g e ty p e s .

D isp lay Distribution Model ^ [ 0 1 1 5 1 ^ 1 3 B l f ^ O S y s te m V i e w

^

M o d el ^

d el

F ille r m o d e l d is p la y

| D e s c r ip tio n /te c h n ic a l n a m e

M o d e l v ie w s ^

$ g Z S M _ V IE W

Z S M .V IE W

^

0

S a b in e s D e m o S y s te m 1

ZSM 1

^

@

S a b in e s D e m o S y s te m 2

ZSM 2

^

( Q M A TM A S

M a te ria l m a s te r

^

^

D a ia fiile r active

^

^

F ilte r g ro u p Q | O ld m a te r ia l n u m b e r

fg

F ig u re 4 .12

S A B IN E S O L D M A T E R IA L N U M B E R

O ld m a t e n a l n u m b e r N o s h o rt text m a in ta in e d

C u sto m e r D is trib u tio n M o d e l w ith F ilte rin g U sin g C u sto m Filte r O b je c ts

75

d is trib u tio n m odel

4

|

C h an g e s to ID o cs

It m a k e s s e n s e t o p r o v i d e a n i n p u t h e l p f o r t h e field ( t h e SAP s y s t e m o u t p u t s a w a r n i n g i f y o u r e f e r to a fie ld w i t h o u t a c h e c k t a b l e f o r a filte r o b je c t) .

S u p p re ssin g an ID o c C u sto m e r segm ent

I f a f i l t e r c o n d i t i o n f o r a field i s n ’t m e t in a m a n d a t o r y s e g m e n t , t h e s y s ­

f o r s u p p re s s in g

t e m d o e s n ' t g e n e r a t e t h e e n t i r e ID oc. You c a n i m p l e m e n t t h i s b e h a v i o r

ID ocs

a l s o f o r fie ld s in o p t i o n a l s e g m e n t s b y c r e a t i n g a c u s t o m e r s e g m e n t as a m a n d a t o r y s e g m e n t , u s i n g t h e s a m e fie ld in t h i s c u s t o m e r s e g m e n t , a n d g e n e r a t i n g a s p e c if ic filte r o b j e c t f o r it. F o r e x a m p l e , i f y o u w a n t t h e s y s t e m to s e n d a m a t e r i a l m a s t e r ID o c t o a p a r t i c u l a r r e c e i v e r o n l y i f a s p e c if ic p l a n t is a v a ila b le , y o u c a n i m p l e m e n t t h i s b y s p e c if y in g t h e p l a n t a n d t h e n f i l t e r i n g b y p l a n t i n a c u s t o m e r s e g m e n t t h a t is d e f i n e d a s a m a n d a t o r y s e g m e n t a n d d i r e c t l y b e l o n g s to t h e

E I M A RAM

s e g m e n t ty p e .

T h e SAP s t a n d a r d f o r t h e " p l a n t " f i l t e r o b j e c t , in t u r n , i n v o l v e s s u p ­ p r e s s i n g i n a p p r o p r i a t e p l a n t s e g m e n t s b u t still s e n d i n g t h e m e n t ty p e a n d

E 1 M AKTM

E 1 MARAM

seg­

s e g m e n t s . H o w e v e r , t h i s d o e s n ' t a l w a y s m e e t th e

c u s to m e r re q u ir e m e n ts . S ectio n 4 .2 .3 , C u sto m S e g m e n ts, d e s c rib e s h o w y o u ca n d e fin e c u s to m seg m en ts.

O v e rv ie w o f V a rio u s ID o c F ilte rs W h e n filterin g an ID o c u s in g filter o b je c ts, y o u c a n — d e p e n d i n g o n t h e c o n t e n t o f t h e ID o c s — s e n d o n l y s p e c if ic s e g m e n t s o r e v e n e n t i r e ID o c s . T h e f i l t e r i n g is p o s i t i v e h e r e : You d e f i n e w h i c h e l e m e n t s c a n pass. W h e n r e d u c i n g ID o c s , y o u c a n a l s o c o m p l e t e l y o m i t e n t i r e s e g m e n t s a n d s u p p r e s s i n d i v i d u a l fie ld s in t h e r e m a i n i n g s e g m e n t s . H o w e v e r , y o u c a n u s u a l l y r e d u c e ID o c s f o r m a s t e r d a t a o n ly . I f y o u d o n ’t w a n t to s e n d s e g ­ m e n ts for n o n -m a s te r d ata for p e rfo rm a n c e reasons, y o u ca n su p p re ss t h e m u s i n g s e g m e n t f i lte rin g o r v i e w s . B o th a p p r o a c h e s a r e e x p l a i n e d in t h e f o l l o w i n g s e c ti o n .

4.1.3

Filte rin g Segm ents

W h e n s e g m e n t s a r e u s e d f o r f ilte rin g , t h e s y s t e m c o m p l e t e l y s u p p r e s s e s t h e g e n e r a t i o n o f a s p e c if ic s e g m e n t f o r a p a r t i c u l a r c o m b i n a t i o n o f s e n d e r , r e c e i v e r , a n d m e s s a g e t y p e . T h e c o n t e n t o f t h e s e g m e n t i s n 't

76

C u sto m iz in g

|

4 .1

r e l e v a n t h e r e . F o r e x a m p l e , i f y o u d o n ’t w a n t t o s e n d a n y p l a n t d a t a o f a m a t e r i a l t o t h e d o w n s t r e a m s y s t e m , y o u m u s t c o n f i g u r e t h i s v ia s e g ­ m e n t filterin g . T h e f i lte rin g t a k e s p la c e in C u s to m i z i n g . I n T r a n s a c t i o n B D 5 6 , y o u d e f in e

F ilte rin g s e g m e n ts

t h e c o m b i n a t i o n t h a t y o u w a n t to s u p p r e s s (s e e F ig u r e 4 . 1 3 ) . F o r th is

in t h e C u s t o m iz in g

p u r p o s e , e n t e r "LS" f o r lo g ic a l s y s t e m in t h e t w o T y p e field s, s p e c if y t h e logical s y s t e m n a m e o f y o u r s e n d i n g s y s t e m in t h e S e n d e r field, a n d s p e c if y t h e lo g ic a l s y s t e m n a m e o f t h e r e c e i v i n g s y s t e m in t h e R e c e iv e r field. I n t h e c a s e o f E D I c o m m u n i c a t i o n , t h e s p e c if ic a t i o n i n t h e Type field is “KU" f o r c u s t o m e r o r "LI” f o r v e n d o r . In t h i s case, y o u m u s t also m a i n t a i n t h e p a r t n e r ro le w h o s e v a l u e c a n b e "A G ’’ f o r s o l d - t o p a r ty , f o r e x a m p l e . T h e S e g m e n t T y p e field i n d i c a t e s t h e n a m e o f t h e s e g m e n t y o u w a n t t o s u p p r e s s . In c o n t r a s t to r e d u c i n g ID o c s a n d u s i n g filte r o b j e c t s in t h e c u s t o m e r d i s t r i b u t i o n m o d e l , w h i c h a l w a y s t a k e s p l a c e i n t h e s e n d i n g s y s t e m , t h e f i lte rin g c a n a ls o b e i m p l e m e n t e d in t h e re c e iv in g s y s t e m . T h a t m e a n s t h e I D o c is t r a n s f e r r e d c o m p l e t e l y b u t n o t u p d a t e d c o m p l e t e l y . F o r p e r f o r m a n c e r e a s o n s , y o u s h o u l d o n l y c o n f i g u r e filte rin g b y s e g m e n t s in t h e re c e i v i n g s y s t e m i f t h e s e n d i n g s y s t e m is a n e x t e r n a l s y s t e m t h a t c a n ’t s u p p r e s s s e g m e n t s itself. T h e f i l t e r i n g o f s e g m e n t s is a ls o a n ALE serv ic e .

Ch ange View "Segm ent Filters": O verview N e w E n tr ie s

.£

[ i

[5 ^

©

Q .

MATMAS

M e s s a g e T yp e

S e g m e n t F ilte rs ry. LS

Figure

4.1.4

Sender ZSH1

4.13

Func.

ry LS

[ R e c e iv e r

R o le

( S e g m e n t type

ZSM 2

|E1 MARCH

1

.

F ilte rin g a S e gm ent

Reducing IDocs Through View s

C r e a ti n g a n d u s i n g v i e w s is p o s s i b l e f o r all ID o c ty p e s , b u t d o e s n ' t p r o ­ v i d e as m a n y f u n c t i o n s a s r e d u c e d ID o c s . H e re , y o u c a n s e l e c t a t s e g ­ m e n t lev el w h i c h o b j e c t s y o u w a n t t o s e n d ; h o w e v e r , y o u c a n n o l o n g e r

77

ID o c v ie w s

4

|

C h an g e s to ID o c s

s u p p r e s s s p e c if ic fie ld s w i t h i n a s e g m e n t as p r o v i d e d f o r t h e r e d u c t i o n . T h e t r a n s a c t i o n t h a t e n a b l e s y o u to d e f i n e t h e v i e w s is T r a n s a c t i o n W E 3 2 . T he e x a m p le d e lib e ra te ly c o m b in e s a n o n -re d u c ib le m e ssag e type, th a t is,

ORDERS,

w ith th e

ORDERS05

I D o c t y p e . F o r ID o c s t h a t a l l o w f o r r e d u c ­

tio n , t h i s is u s u a l l y t h e m o r e p o w e r f u l m e t h o d f o r c u s t o m i z i n g ID o c s . F ig u re 4 . 1 4 s h o w s t h e in itia l s c r e e n o f t h i s t r a n s a c t i o n .

Create view: ZSM1 S EDI*! U S

— in

E1EDK01 E1EDK14

ID o c

D ocum ent h e a d e r g e n e r a l

ID o c

D ocum ent H e a d e r O r g a n i z a t i o n a l

E1ED K 93

ID o c

E1EDK84

ID o c

D ocum ent h e a d e r d a t e s e g n e n t O ocu«ent h e a d e r ta x e s

E1EDK05 E1E0KA1

ID o c

E1EDK02 E1EDK17

ID o c ID o c

E 1 E D K I8

ID o c :

ID o c

d a ta

D ocum ent h e a d e r c o n d i t i o n s Docu«ent H eader P a r tn e r In fo r a a tlo n D ocum ent h e a d e r r e f e r e n c e d a t a D ocum ent H e a d e r

T e ra s o f D e liv e r y

D ocum ent H e a d e r

T e ra s o f P ayn en t

E1EDK35

ID o c :

D ocum ent H e a d e r A d d i t i o n a l

E 1E 0K 36

IDOC:

D o c .h e a d e r p a y m e n t c a r d s

— i c E1E0KT1 — 1C E1E0P01 — U) E1CUCFG

CU: C o n f i g u r a t i o n

— 10 E1ED L37

H a n d l in g u n i t h e a d e r

E1EDS01

Figure 4 1 4

ID o c

D ocum ent H e a d e r

ID o c

D ocum ent

ID o c

D a ta

Ite »

Text

G e n e ra l

D a ta

Id e n tific a tio n D a ta

d a ta

S u a n a ry s e g a e n t g e n e ra l

In itia l Screen f o r V ie w s

M a n d a to ry

T h i s m e t h o d a l s o i n v o l v e s s e g m e n t s t h a t a r e n e c e s s a r y f r o m t h e SAP

s e g m e n t s in v ie w s

p e r s p e c t i v e a n d n e e d t o b e p a r t o f t h e v i e w . T h e t o p - l e v e l o r ro o t seg­ m en t (here:

E1 EDK0 1)

is i n d i s p e n s a b l e . You a l r e a d y k n o w t h e r e a s o n f o r

t h i s f r o m t h e f i lte rin g a n d r e d u c t i o n p r o c e s s e s : I f y o u s k i p t h e t o p -le v e l i t e m , t h e e n t i r e ID o c d i s a p p e a r s . You c a n n o w d e f i n e w h i c h s e g m e n t s y o u w a n t t o a d d t o t h e s e g m e n t t h a t is r e q u i r e d a s a m i n i m u m . F ig u re 4 . 1 5 d i s p l a y s a c o m p l e t e v ie w . T h is fig u re a ls o s h o w s t h e a t t r i b u t e s o f t h e v i e w , its n a m e , f o r e x a m p l e . W h e n y o u ’v e d e f i n e d a s e g m e n t a s r e l e v a n t f o r y o u r v i e w u s i n g t h e m e n u t h a t o p e n s w h e n y o u rig h t-c lic k o n t h e s e g m e n t , y o u c a n e x p a n d i t a n d s e l e c t t h e s e g m e n t s lis te d u n d e r n e a t h t h a t y o u w a n t t o i n c l u d e in y o u r v ie w .

78

C u sto m iz in g

|

D is p la y v ie w : Z S M 1

S a b in e s ORDERS V1e» •E1EDK01

ID o c :

D o cu m en t h e a d e r g e n e r a l

-E1EDK14

ID o c :

D o cu m en t H e a d e r O r g a n i z a t i o n a l

•E1EDK03

ID o c :

D o cu m en t h e a d e r d a t e s e g m e n t D o cu m en t h e a d e r t a x e s

E1EDK04

ID o c :

•E1EDK05

ID o c :

D o cu m en t h e a d e r c o n d i t i o n s

E1E0KA1

ID o c :

D o cu m en t H e a d e r P a r t n e r

E1EDKA3

ID o c :

E1E 0K 02 E1E 0K 17

D a ta

In fo r m a tio n

D o cu m en t H e a d e r P a r t n e r

In fo rm a tio n

ID o c :

D o cu m en t h e a d e r r e f e r e n c e d a t a

ID o c : ID o c :

D o cu m en t H e a d e r Term s o f D e l i v e r y D o cu m en t H e a d e r Term s o f Paym ent

E1E 0K 35 E1EDK36

ID o c :

D o cu m en t H e a d e r A d d i t i o n a l

ID O C :

D o c .h e a d e r p a y m e n t c a r d s

E1E0KT1

ID o c :

D o cu m en t H e a d e r T e x t

ID o c :

D o cu m en t It e m G e n e r a l

E1EDK18

— m

d a ta

E1EDP01

A d d it io n a l

D a ta

Id e n tific a tio n D a ta

0 /

E * A ttributes fo iv ie w Z S M i -----------E 1 E 0P 0 2 -----------E1CUREF

A ttrib u te s

-----------E l A D O !1

QRDERS05

BasicTyp

-----------E1EDP03 -----------E1EDP04

Extension

— 0 3 E1EDP05 -----------E1EDP20 — tQ

D a ta

ORDERS

L o g ic a l M e s s a g e

©

E1EDPA1

-----------E1EDP19

D e s c rip tio n

S a b in e s O R D E R S V ie w

E1EDPA0 E1EDP17 E1EDP18 E 1 E 0P 3 5

T ec h n ic a l Attributes

E1EDPT1

— tfi

E1CUCFG

— f f)

E1ED L37

JThP

Pckg

E1EDC01

I0 H

---------- E1EDS01

F ig u re

4.15

E x a m p le o f a C u s to m - D e fin e d V ie w

In c o n t r a s t to r e d u c e d ID o c s w h e r e y o u g e n e r a t e a s p e c if ic m e s s a g e t y p e ,

v i e w s in th e

y o u c o n tin u e to u se s ta n d a rd m essag es h ere. C o n seq u en tly , y o u m u st

p a rtn e r p ro file

a ls o s p e c i f y in t h e p a r t n e r p ro file s in T r a n s a c t i o n W E 2 0 i f y o u w a n t to w o r k w i t h a v i e w a n d w h i c h v i e w y o u w a n t to u s e (s e e F ig u r e 4 .1 6 ) . As u s u a l, o u r e x a m p l e u s e s t h e file. I n t h e d e t a i l s

(O u tb o u n d

are a , y o u t h e n s p e c i f y

ZSM1

ORDERS

m e ssag e ty p e for th e p a r tn e r p ro ­

O p tio n s

in t h e V i e w

• ID o c f ie l d

Type)

in t h e ID o c T y p e

in a d d i t i o n t o

ORDERS05

in

t h e B asic T y p e field.

79

4 .1

4

|

C h an g e s to ID o cs

Partner profiles: Outbound parameters

P a rtn e r N o .

zsm

S a b in e s D e m o S y s te m 1

P a rtn .T y p e

LS

L o g ic a l s y s te m

P a rtn e r R o le ___________

§

M e ssag e Type

ORDERS

P u r c h a s e o r d e r / o rd e r

M e s s a g e cod e M e s s a g e functio n

□

M e s s a g e C o n lr o l

SH F1LE

R e c e iv e r port

g )

Test

P o s t P r o c e s s in g P e rm itte d A g e n t

F ile

T e le

S a b in e s T e s tp o r t fo r F lies

O u tp u t M o d e O T r a n s fe r ID o c Im m e d

O S ta rt s u b s y s te m

® C o lle c t ID o c s

® D o n o t sta rt s u b s y s te m

O u tp u t M o d e

4

ID o c Typ e B a s ic type

m iB m

P u rc h a s in g /S a le s

zsm

S a b in e s O R D E R S V ie w

E x te n s io n v ie w 0

C a n c e l P r o c e s s in g A lte r S y n ta x Erro r

S e g . r e le a s e in ID o c type

F i g u r e 4.16

S e g m en t Appl Rel

U s i n g t h e V i e w i n t h e P a r t n e r P r o f ile

F il t e r in g b y v i e w s i s n ' t a n ALE s e r v ic e , s o i t c a n a ls o b e u s e d f o r ID o c m o d u l e s f o r w h i c h ALE s e r v ic e s a r e d e a c t i v a t e d .

4.1.5

Rules

All p r e v i o u s c h a n g e s to t h e ID o c s a i m a t r e d u c i n g t h e s c o p e o f t h e d a ta t h a t is s u p p o s e d t o b e t r a n s f e r r e d . T h i s is u s u a l l y d o n e f o r p e r f o r m a n c e r e a s o n s a n d to r e d u c e t h e d a t a v o l u m e o n t h e d a t a b a s e i f t h e p a r t n e r d o e s n 't n e e d th e d ata. C h a n g in g the

O f t e n , h o w e v e r , y o u a l s o n e e d t o c h a n g e t h e a c tu a l c o n t e n t o f a n ID o c

co n te n t

to e n a b l e t h e r e s p e c t i v e c o m m u n i c a t i o n p a r t n e r t o p r o c e s s it. Typical e x a m p l e s a r c d i f f e r e n t field l e n g t h s o r a b b r e v i a t i o n s , s u c h a s a d d i n g / d eletin g lead in g z e ro s o r u sin g d iffe re n t c o m p a n y co d e s o r w a re h o u s e n u m b e r s . You c a n h a n d l e t h i s w i t h o u t d e v e l o p m e n t w o r k u s i n g a r u l e if

80

C u sto m iz in g

|

s i m p l e c o n v e r s i o n lo g ic is u s e d . F ig u r e 4 . 1 7 s h o w s h o w y o u c r e a t e t h e r u l e in T r a n s a c t i o n B D 6 2 b y a s s i g n i n g a n a m e t o i t first.

M aintain co n ve rsio n rules

C o n v e r s io n ru le __________ {D e s c rip tio n _________

ID O C s e g m e n t n a m e

POSTNET

PostNel

ZSM1

O ld M a te ria ln u m b e r

E1FIHDR E1HARAM

F ig u re

417

N a m i n g t h e R u le

W h e n a s s i g n i n g a n a m e to t h e r u l e , y o u a ls o d e f i n e to w h i c h s e g m e n t t h e r u l e a p p l i e s , s o t h e s y s t e m lists all fie ld s o f t h i s s e g m e n t i f y o u m a i n t a i n t h e a c tu a l r u l e in T r a n s a c t i o n B D 7 9 . T h e C r e a te P r o p o s a l f o r R u le f u n c ­ tio n e n a b le s y o u to p re d e fin e th e

MOVE

r u l e f o r all field s, w h i c h d e s c r i b e s

t h e p r o c e s s o f s i m p l y c o p y i n g t h e field c o n t e n t .

MOVE

is t h e d e f a u l t s e ttin g

a n y w a y . F ig u r e 4 . 1 8 s h o w s t h e in itia l s c r e e n o f t h e r u l e m a i n t e n a n c e .

ALE IDoc S e g m e n t s : M aintain C o n v e r s i o n R u le s fo r Z S M I Q bi* 9 ICll ?ec fie ld

|D escripl

Type Length (C h

Function

C

MATNR

M alerial

C

ERSDA

C reated On

C

ERfJAM

C reated By

c c c c c

MSGFN

-

C reate pro p o s a l fo r rule

LAE DA

__ L a s t Change

AENAM

C h a n g e d by

PSTAT

M aint

LVORM

OF c lie n t level

MBRSH

Industry sector

MATKL

status

3 18 8 12 8 12 15

IS e n d e rfld

□

jflSGFN

□

HATNR

D

ERSDA

□

ERNAH

□

LAEPA

□

AENAH

□

PSTAT

_

□ LYORfl

3

1

M alerial G roup

c

9

BISMT

O td m atl n u m b e r

c

MEINS

B a s e U n it

c

BSTME

O ld e r u n it

0

18 3 3

□ "BRSH □ "ATKL D

c

F ig u re

4.18

_

|

□

HEINS

n

BsrnE

S e nder (Id val

C o nsta nt

I___________ __________

*L E .M ATER IAL

R u le M a i n t e n a n c e — O v e r v i e w

F o r e a c h field, y o u c a n d e f i n e h o w i t ’s d e t e r m i n e d f r o m t h e s o u r c e field. F ig u r e 4 . 1 9 d i s p l a y s t h e m a i n t e n a n c e m e n u u s i n g t h e M A T K L field as an exam ple.

81

C re a tin g a ru le

4 .1

4

|

C h an g e s to ID o cs

A L E IDoc Segm ents: Maintain Co nversion R ules for ZSM 1 9 | f w ] f < l [► I W R e c e rv e r field

R * l f M o v e g e n e r a l ru le s M A TK L

S e le c t a r u le type

® C o p y s e n d e r fie ld

M a te ria l O ro u p

R u le d e ta ils R u le type

C o p y s e n d e r fie ld

O S e t c o n s ta n t O S e t v a ria b le

S e n d e r F ie ld to b e T r a n s fe r r e d

O C o n v e rt s e n d e r fie ld s

S e n d e r field

O C o n v e rV c o p y

O ffset

O U s e g e n e r a l rule

L en g th S p e c ia l c o n v e rs io n routin e

S e n d e r f ie ld s fo r co n d itio n s S e n d e r fid

[O ffs e t

fLngth

JC on

J 0

E W h a t h a p p e n s w ith th e n o n a s s ig n e d /n o n -c o n v e r te d field ® S e t at in itia l v a lu e

F ie ld w ill b e s e t to in itia l v a lu e (b la n k o r ’ 0*)

O C la s s ify a s erro r O S e t c o n s ta n t O

C o p y s e n d e r fie ld

S p e c ia l c o n v e rs io n routin e

U s e ru le d e fin e d h e r e a s g e n e r a l rule G e n e r a l rule

F i g u r e 4.19

Rule t y p e s

The

R u le M a i n t e n a n c e — D a t a f o r a F ie ld

fo llo w in g ru le ty p e s c a n b e selected :

► C opy S e n d e r F ie ld T h e C o p y S e n d e r F ie ld r u l e t y p e is t h e MOVE c o p y r u l e a n d t h u s c o r ­ r e s p o n d s t o t h e d e f a u l t s e t t i n g . In t h e d e t a i l s m e n u in t h e l o w e r t r a n s ­ a c t i o n a r e a , h o w e v e r , y o u c a n d e p l o y o n l y a p a r t o f t h e s e n d e r field u s in g th e o ffset a n d len g th . ► Set C o n s ta n t I f y o u s e t a c o n s t a n t , t h e s y s t e m a l w a y s o v e r w r i t e s a n e x i s t i n g v a lu e w ith th e s a m e n e w value.

82

C u sto m iz in g

|

4 .1

► Set V a ria b le H e r e , y o u c a n u s e a p r e d e f i n e d v a r i a b l e a s t h e t a r g e t v a l u e . I f t h e ID o c is c o p i e d f r o m a file in t h e in itia l s c r e e n , y o u c a n s p e c i f y t h i s v a r ia b l e s e p a r a t e l y f o r e v e i y t r a n s f e r o f I D o c s . I f y o u d o n ’t w o r k w i t h files, y o u can use th e

KKCD0001

SA P e n h a n c e m e n t t o s e t t h e v a r ia b l e s .

► C o n v e rt S e n d e r F ie ld s To c o n v e r t fields, s p e c i f y a n e w v a l u e w i t h r e g a r d to t h e in itia l v a l u e o f t h e field. H e r e , i n d i v i d u a l field v a l u e s o r i n t e r v a l s c a n b e c o p i e d to a t a r g e t v a l u e . You c a n d e f i n e , f o r e x a m p l e , t h a t t h e v a l u e “1 0 " b e c o m e s v a l u e " 1 0 0 " o r t h a t e v e r y v a l u e f r o m " 2 0 " to " 4 0 " b e c o m e s v a l u e “2 0 0 " . ► C o n v e rt/C o p y T h is is a c o m b i n a t i o n o f t h e t w o r u l e t y p e s , C o p y S e n d e r F ie ld a n d C o n v e r t S e n d e r F ie ld , w h i c h w e r e a l r e a d y d e s c r i b e d . You c a n d e f i n e c o n d i t i o n s f o r t h e c o p y a n d f o r t h e c o n v e r s i o n . P r e v i o u s re le a s e s d i d n ' t i n c l u d e t h i s r u l e t y p e . You h a d t o u s e a c o n v e r s i o n r u l e in w h i c h t h e n e w v a l u e w a s i d e n t i c a l to t h e o l d v a l u e i n s o m e fields. ► Use G e n e ra l R u le T h e g en era l rule a l l o w s f o r s p e c if y in g r e c u r r i n g r u le s o n l y o n c e a n d r e f e r r i n g to t h i s s p e c if ic a t i o n f o r o t h e r field s. You c a n d e f i n e e v e i y r u l e i n t h e m e n u as a g e n e r a l r u l e b y a s s i g n i n g a u n i q u e n a m e to it. F o r o t h e r field s, t h e U s e G e n e r a l R u le r u l e t y p e is a p p l i e d t o u s e th e p r e v i o u s l y d e f i n e d g e n e r a l ru le. In a d d i t i o n t o t h e a c tu a l r u l e , t h e r e is r e c u r r i n g i n f o r m a t i o n , w h i c h is d i s p l a y e d in t h e b o t t o m a r e a o f t h e d y n p r o in F ig u r e 4 . 1 9 . T h is i n c l u d e s t h e S p ecial C o n v e r s i o n R o u t i n e , w h i c h r e f e r s t o t h e conversion e x it. C o n ­ v e rs io n ex its fo rm a t d ata fo r t h e screen . T h ey u su ally s u p p re ss lead in g zeros. A c o n v e rsio n e x it alw ay s c o n ta in s th e n a m e o f th e c o n v e rsio n r o u t i n e , f o r e x a m p l e , A LPH A . F o r fie ld s t h a t c a n c o n s i s t o f b o t h n u m b e r s a n d tex t, t h e

ALPHA

e x i t m a p s n u m b e r s a s r i g h t a l i g n e d a n d t e x t a s left

a l i g n e d . E ac h e x i t a ls o h a s t w o f u n c t i o n m o d u l e s w h o s e n a m e s a lw a y s fo llo w th e

C O N V E R S IO N _ E X IT _ < N A M E > _ < F U N C T IO N >

C O N V E R S I O N _E X I T _ A L P H A _ O U T P U T

alpha

p a tte rn , fo r ex a m p le ,

f o r t h e m a p p i n g o n a d y n p r o in o u r

s a m p l e exit.

83

C o n v e rs io n e x its

4

|

C h an g e s to ID o cs

In a d d i t i o n , f o r all ru le s , y o u c a n d e f i n e t h e b e h a v i o r i f fie ld s c a n ' t be a s s i g n e d . You c a n c i t h e r c o p y a c o n s t a n t o r a s e n d e r field o r a l t e r n a t i v e l y trig g er an erro r. A s s ig n in g t h e rule

You d e c i d e w h e t h e r a r u l e is a c tu a l ly u s e d v i a T r a n s a c t i o n B D 5 5 , w h i c h e n a b l e s y o u t o a s s ig n t h e r u l e to a p a r t n e r . F ig u re 4 . 2 0 s h o w s h o w y o u d e f i n e f o r e a c h c o m b i n a t i o n o f s e n d e r a n d r e c e i v e r i f a r u l e is u s e d a n d w h i c h r u l e is u s e d . T h e u s e o f c o n v e r s i o n r u le s is a ls o a n ALE s e r v ic e .

M e ssag e Type

MATMAS

C o n v e rs io n R u le Ty

|S e n a e r

i s zsm Figure 4.20

iF u n c

|T y

|R e c e iv e r

Ls zsn2

( R o le

Is e g m e n t t y p e

C o n v e r s io n rule

E1MARAM

ZSM1

A s s i g n i n g t h e R u le t o t h e M e s s a g e T y p e a n d P a r t n e r

R estrictions fo r SAP ERP HCM Y o u c a n 't u se c o n v e rs io n ru le s in S A P ERP H C M . T h is d e p e n d s o n t h e c o m ­ m o n p ro c e s s in g m e t h o d f o r in fo ty p e s h e re . B e c a u s e t h e a c tu a l v a lu e s c a n 't be a d d re s s e d d ir e c tly b u t o n ly v ia in fo ty p e s f o r s e c u rity re a so n s, t h e m e c h a n is m s u s e d in t h e c o n v e rs io n ru le s d o n ’ t ta k e e ffe c t b e c a u s e t h e p r o p e r in fo ty p e s a r e n ’t k n o w n a t e x e c u t i o n .

4.1.6

Version Conversion

C o n v e rs io n to

ID o c s a r e a l s o s u p p o s e d t o e x c h a n g e i n f o r m a t i o n b e t w e e n t w o s y s t e m s

o ld e r s e g m e n t

w i t h d i f f e r e n t r e l e a s e v e r s i o n s . To a d a p t t h e ID o c s a c c o r d i n g l y , y o u c a n

v e rsio n s

u s e t h e version conversion o p t i o n (s e e a l s o S e c t i o n 4 .2 .2 , G e n e r a l Exits). F o r t h i s p u r p o s e , y o u c a n e n t e r a n ID o c t y p e o f a n o l d e r r e l e a s e in t h e p a r t n e r o u t b o u n d p r o c e s s i n g , w h i c h r e m o v e s all s e g m e n t s t h a t d i d n ' t e x i s t i n t h e r e s p e c t i v e r e le a s e . You c a n a ls o s p e c if y a n o l d e r r e l e a s e v e r ­ s i o n w i t h i n a se g m e n t version a n d c o n s e q u e n t l y e n s u r e t h a t t h e s y s t e m g e n e r a t e s t h e i n d i v i d u a l s e g m e n t s b a s e d o n t h i s r e le a s e . B y d e f a u l t , n o s p e c if ic a t i o n is m a d e in t h e s e g m e n t v e r s i o n ; s o t h e s y s t e m g e n e r a t e s t h e m o s t r e c e n t r e l e a s e v e r s i o n o f t h e i n d i v i d u a l s e g m e n t s f o r o l d e r IDoc ty p e s . T h e v e r s i o n c o n v e r s i o n is a ls o a n ALE se r v ic e .

84

C u sto m iz in g

|

Changes and ALE Services In t h e c o n t e x t o f th e I D o c f u n c t i o n

m o d u le C u s to m iz in g , y o u le a rn e d th a t

y o u ca n d e fin e f o r e v e ry fu n c tio n m o d u le w h e t h e r A L E s e rv ic e s a re a v a ila b le o r n o t. F ro m t h e p re v io u s ly d e s c rib e d c h a n g e o p tio n s , t h e f o llo w in g a re ALE se rvice s: ► F ilte r in g b y f ilt e r o b je c ts ( o u t b o u n d o n ly ) ► S e g m e n t filte rin g ► F ie ld c o n v e r s io n u s in g ru le s ► V e rs io n c o n v e rs io n You

c o n fig u re th e

v e rs io n c o n v e r s io n in t h e

p a r t n e r p r o file , a n d a ll o t h e r

o p t i o n s a r e s e t v i a C u s t o m i z i n g . F i l t e r i n g b y f i l t e r o b j e c t s is p o s s i b l e i n t h e s e n d in g s y s te m ( o u t b o u n d ) o n ly ; a ll o t h e r o p t io n s a re a ls o a v a ila b le o n th e re c e iv e r s id e ( in b o u n d ) . Y o u r s e ttin g s a re o n ly u s e d , h o w e v e r, if t h e c o rre ­ s p o n d in g fu n c tio n

m o d u le

s u p p o r ts A L E s e rv ic e s ( w h ic h f o r t u n a t e ly h o ld s

tru e fo r m o s t o f th e m ).

4.1.7

Special C o nversions in SAP ERP Financials

F in a n c ia l A c c o u n t i n g i n c l u d e s c o m p a n y c o d e s a n d b u s i n e s s a r e a s , w h i c h

Global

c o v e r s p e c if ic c o n t r o l l i n g f u n c t i o n s . It's p a r t i c u l a r l y c ritic a l t h a t d a t a is

organizational

d e liv e re d to th e a p p r o p ria te area w h e n b e in g tra n sfe rre d . O ften , th e v a r i o u s s y s t e m s u s e t h e s a m e o r g a n i z a t i o n a l u n i t s (e .g ., t h e S A P -p rov i d e d c o m p a n y c o d e , 0001) w i t h a d i f f e r e n t m e a n i n g . F o r t h e r e s u l t i n g c o n v e r s i o n s t h a t a r e f r e q u e n t l y r e q u i r e d , SAP h a s d e v e l o p e d a sp ec ific a p p r o a c h : cross-system co m p a n y codes o r cross-system business areas. You can a c c e s s t h e s e s e t t i n g s v i a t h e ALE C u s t o m i z i n g o n l y b u t n o t v ia a n y t r a n s ­ a c t i o n c o d e . F ig u r e 4 .2 1 s h o w s t h i s u s i n g T r a n s a c t i o n SALE in SAP ERP.

D isplay IMG E x istin g B C S e ts

B C S e ts fo r Activity

A c tu a te d B C S e ts fo r Ac tw it/

S tructure_____________________________________________________ ID o c in te rfa c e /A p p lic a tio n L in k E n a b lin g (A L E ) I-

B a s ic Settin gs

l>

C o m m u n ic a tio n

•3*

M o d e llin g a n d Im p le m e n tin g B u s in e s s P ro c e s s e s G lo b a l O rg a n iz a tio n a l U n its Q

( 5 » C r o s s -S y s te m C o m p a n y C o d e s (^

F ig u re 4-21

C r o s s -S y s te m B u s in e s s A re a s

M e n u Path fo r G lo b a l O rg a n iz a tio n a l U nits

85

units

4 .1

4

|

C h an g e s to ID o cs

T he ID oc Im

In t e r f a c e / A

plem en tin g

pplication

Business P

Li n k E n a b l i n g (A L E ) • M

rocesses

• G

lobal

O

o d elin g a nd

rg an iza tio n al

U

nits

path

e n a b l e s y o u to c o n f i g u r e c r o s s - s y s te m c o m p a n y c o d e s a n d c r o s s - s y s te m b u s i n e s s a r e a s . F ig u r e 4 . 2 2 d i s p l a y s t h e s t e p s t h a t y o u n e e d t o p e r f o r m f o r c r e a t i n g a c r o s s - s y s te m c o m p a n y c o d e : c r e a t i n g c r o s s - s y s t e m u n i q u e c o m p a n y c o d e s , a s s i g n i n g a c r o s s - s y s t e m c o m p a n y c o d e to t h e c h a r t o f a c c o u n t s , a n d a s s i g n i n g t h e lo cal c o m p a n y c o d e t o t h e c r o s s - s y s te m c o m ­ p a n y code.

A c tivities P e rf

'l a m e o f Activity C ro s s -S y s te a

C o npany Codes

A s s ig n

C ro s s -S y s te n

A s s ig n

Conpany Code t o

F i g u r e 4-22

C o n p an y Code t o C ro s s -S y s te n

C h a rt o f

A c c o u n ts

C o n p an y Code

Settings for Cross-System C o m p a n y Codes

Cross-system

E ac h c r o s s - s y s t e m c o m p a n y c o d e is a s s i g n e d w i t h a u n i q u e n a m e . It

com pany code

c a n c o n t a i n six c h a r a c t e r s a n d c a n b e l o n g e r t h a n t h e n o r m a l c o m p a n y c o d e ( f o u r c h a r a c t e r s ) s o t h a t a d d i n g t h e p r e f i x "GL" f o r “g lo b a l'' m a k e s se n s e h e re . T h e re are n o ru les for n a m e s o f g lo b al c o m p a n y codes, h o w ­ e v e r . F ig u re 4 . 2 3 s h o w s a n e x a m p l e f o r t h e s t r u c t u r e o f t h e n a m e o f a g l o b a l c o m p a n y c o d e . I t c o n s i s t s o f t h e p re fix "GL," t h e l e t t e r "Z," t h e c o d e “S M ," a n d t h e d i g i t “1.” T h e fin a n c ia l d e p a r t m e n t o f y o u r e n t e r ­ p r i s e is r e s p o n s i b l e f o r p u b l i s h i n g t h e r e q u i r e d i n f o r m a t i o n o n c h a r t s o f a c c o u n t s , c o m p a n y c o d e s , a n d g l o b a l c o m p a n y c o d e s t h a t m a y h a v e to b e u s e d . You s h o u l d n o t m a k e t h i s d e c i s i o n y o u r s e l f b e c a u s e i t c a n affect o p e r a t i o n s t h a t a r e r e l e v a n t t o t h e fin a n c ia l s t a t e m e n t .

N e w E n trie s : O v e rv ie w o f A d d e d E n trie s

G lobal C oC de GIZSM1

Figure 4.23

Creating a Global C o m p a n y C ode

Chart o f account

You m u s t a s s ig n a c h a r t o f a c c o u n t to e v e r y g l o b a l c o m p a n y c o d e . This

assignm ent

c h a r t o f a c c o u n t is t h e n u s e d w h e n t h e I D o c s a r e u p d a t e d . T h e c h a r t s

86

C u sto m iz in g

|

o f a c c o u n t s in t h e s e n d i n g a n d r e c e i v i n g s y s t e m s m u s t c o r r e s p o n d w i t h r e g a r d to t h e i r a c c o u n t s . In t h e e x a m p l e , t h e t a r g e t c h a r t o f a c c o u n t , INT, h a s b e e n a s s i g n e d to t h e g l o b a l c o m p a n y c o d e , GLZSM1 ( s e e F ig ure 4 .2 4 ) .

C h a n g e V ie w " A s s ig n c ro s s -s y s te m c o .c d e -> c h r t o f a c c ts " : O v e rv ie w

B E IB H II G lo b al C o C d e

|Tar.chrtfacct$

6LZSH1

IN I

E

E

EJ Figure 4 24

Assigning the Chart of Accounts to the Cross-System Company Code

N o w , y o u a s s i g n t h i s g l o b a l c o m p a n y c o d e t o o n e o f t h e lo cal c o m p a n y

Assigning the

c o d e s in y o u r c l i e n t . T h e s e n d i n g s y s t e m t h e n g e n e r a t e s t h e g l o b a l c o m -

Slobal company

p a n y c o d e e v e i y w h e r e in t h e ID o c w h e r e t h e a s s i g n e d lo cal c o m p a n y c o d e w o u l d b e s p e c if ie d ; t h e r e c e i v i n g s y s t e m , in t u r n , r e p l a c e s e a c h g l o b a l c o m p a n y c o d e in t h e ID o c w i t h t h e a s s i g n e d lo cal c o m p a n y c o d e . B ecause this re p la c e m e n t m u s t w o rk o n b o th sid es, each g lo b al ob ject m u s t b e a s s i g n e d t o e x a c t l y o n e lo cal o b j e c t o n l y . In t h e e x a m p l e in F ig u r e 4 . 2 5 , t h e g l o b a l c o m p a n y c o d e , GLZSM1, w o u l d c o n s e q u e n t l y be a s s i g n e d to t h e CPFO c o m p a n y c o d e o f C o m p a n y Good Food.

C hange V ie w "A s s ig n c o m p a n y c o d e -> C ro s s -s y s te m c o m p a n y code* a fM fc i b ;o

3

IC o m p a n y N a m e

Icity

G lobal C o C d e GLZSN1

:PF0 O o o d Food____________________ Chicago

Figure 4.25

Assigning t h e Cross-System C o m p a n y C o d e to t h e C o m p a n y Code

In a s i m i l a r w a y , y o u c a n f o l l o w t h e I D o c E n a b l in g (ALE) • M G

lobal

O

o d elin g

rgan iza tio n al

U

a n d

n its

Im

In t e r f a c e / A

plem en tin g

pplication

Bu sin ess P

L in k

rocesses

•

m e n u p a t h i n T r a n s a c t i o n SALE to c o n ­

fig u re c r o s s - s y s te m b u s i n e s s a r e a s . F ig u r e 4 . 2 6 s h o w s t h e t w o s t e p s t h a t y o u n e e d t o p e r f o r m f o r t h i s p u r p o s e . As w i t h t h e c o m p a n y c o d e , th e first s t e p is t o s p e c i f y t h e n a m e o f t h e c r o s s - s y s t e m b u s i n e s s a r e a . T h e n y o u m u s t a s s i g n it to t h e b u s i n e s s a r e a in t h e c lie n t.

87

Cross-system business areas

4 .1

4

|

C h an g e s to ID o cs

D is p la y IMG E x is t in g B C S e lS ~ | | - .

El

B C S e t s lo r A t l r . f r |

OE Activities P e rf j N a m e o f Activity C r o s s - s y s t e m b u s in e s s a r e a s A s s ig n B u s in e s s A r e a t o

Figure 4.26

C r o s s - S y s t e n B u s in e s s A re a

Configuring Cross-System Business Areas

Creating the

In c o n tra s t to th e c ro ss-sy ste m c o m p a n y co d e , th e n a m e o f th e cro ss­

cross-system

s y s t e m b u s i n e s s a r e a c o n s i s t s o n l y o f f o u r c h a r a c t e r s ( h e r e : GLZS, s e e

business area

F ig u re 4 . 2 7 ) . I n t h i s c a s e , t o o , o n l y t h e c r o s s - c o m m u n i c a t i o n u n i q u e n e s s is critic a l, a n d n o n a m i n g r u l e s a p p ly .

N ew E n trie s : O v e rv ie w o f A d d e d E n trie s S B E B H X -sys t b u s in e s s area GLZS

Figure 4.27

S a b in e s G lo b al B u s A /e a

S I

Cre atin g a C ross -Syste m Business Area

A f t e r w a r d , y o u m u s t a s s i g n t h e c r o s s - s y s t e m b u s i n e s s a r e a to a local b u s i n e s s a r e a . I n o u r e x a m p l e , t h e c r o s s - s y s te m b u s i n e s s a r e a , GLZS, is a s s i g n e d to t h e lo cal b u s i n e s s a r e a , 0001 (s e e F ig u r e 4 . 2 8 ) . H e r e , to o, e v e i y g l o b a l o b j e c t m u s t b e a s s i g n e d to e x a c t l y o n e lo cal o b j e c t .

C hange V ie w "A s s ig n B u s in e s s A re a to C ro ss-S yste m B u s in e s s A re a'

B u s A rea

[DescriptionB u sin ess a r e a 0001

F i g u r e 4*2 8

Description GLZS________ B u sin ess a r e a 1

A s si gn in g t h e C ro ss -S ys te m Business A r e a t o t h e Local Business Are a

T h e se ttin g s d e s c rib e d p re v io u sly fo rm th e p re re q u is ite fo r c o n v e rtin g g l o b a l o r g a n i z a t i o n a l u n i t s . T h e a c tu a l e x e c u t i o n , h o w e v e r , d e p e n d s o n th e co m m u n icatio n p artn e rs a n d o n th e m essage ty p es used. F o r e x a m ­ p l e , y o u c a n o n l y u s e t h e lo cal c o m p a n y c o d e i f y o u s e n d d a t a t o y o u r o w n w a re h o u s e , a n d y o u can o n ly u se th e g lobal c o m p a n y c o d e i f y o u s e n d d a t a to a FI (F in a n c ia l A c c o u n t i n g ) c o n s o l i d a t i o n s y s t e m .

88

A d a p tin g E x istin g ID o c T yp e s

|

4-2

F ig u r e 4 . 2 9 s h o w s h o w T r a n s a c t i o n B D 5 8 c o n v e r t s t h e c o m p a n y c o d e

A c t i v a t i n g for e a c h

a n d t h e b u s i n e s s a r e a in all i n v o l v e d s e g m e n t s f o r t h e

s e g m e n t a n d fi el d

FIDCMT

m essage

t y p e . F o r t h i s p r o c e s s , i t ’s c ritic a l t h a t y o u s p e c i f y t h e field in F ield N a m e t h a t y o u w a n t to c o n v e r t b e c a u s e a n I D o c c a n c o n t a i n s e v e r a l a p p r o p r i ­ a t e field s. T h e

FIDCMT

ID o c t r a n s f e r s l i n e i t e m s f o r t h e g e n e r a l l e d g e r in

SAP ER P F in a n c ia ls .

C h a n g e V ie w "C o n v e rs io n o f O rg a n iz a tio n a l U n its in to ID o c s ": O ve rvie w N e w E n n .e s

*

M e s s a g e Type

«

3

^

'

i

3

Q

F1DCHIT

Conversion o f O rganizational U nits into ID ocs S e g m e n t type E1FIH DR

:ie ld N a m e 8UKRS

□ jD o m a in

|Offset

8UKRS

0

E 1 F IP 0 S

6SBER

6SBER

[7

E 1 F IP 0 S

PARGB

GSBER

fii

E1FITA X

GSBER

GSBER

0

Figure 4.29

4 .2

ntLength

□ A

A c t iv a t in g t h e G l o b a l C o n v e r s i o n for Each M e s s a g e Type

A d a p t in g E x is tin g ID oc Types

C u sto m e rs w h o have im p le m e n te d th e ir o w n d e v e lo p m e n ts w ith in the SAP s y s t e m o f t e n a l s o w a n t t o u s e t h e s e m o d i f i c a t i o n s f o r t h e ID ocs t h a t b e l o n g t o t h e m o d i f i e d o b j e c t s . As w i t h i n t h e m o d u l e s , SA P m e e t s th i s r e q u i r e m e n t b y p r o v i d i n g a n e n h a n c e m e n t c o n c e p t . In a d d i t i o n to a d a p tin g ID ocs to th e c o m m o n e n h a n c e m e n t te c h n o lo g ie s , y o u m u s t a ls o a d a p t t h e m t o y o u r o w n d e v e l o p m e n t s b y s p e c i f y i n g w h i c h a d d i ­ t i o n a l fie ld s a n d s e g m e n t s a r e r e q u i r e d . T h e f o l l o w i n g s e c t i o n first i n t r o d u c e s t h e d i f f e r e n t t y p e s o f e x i t s p r o -

Adapting through

v i d e d b y SAP a n d t h e n u s e s t h e m a t e r i a l m a s t e r a s a n e x a m p l e b e c a u s e i t

programming

c o n t a i n s a l o t o f e x i t s . Y ou'll a ls o l e a r n m o r e a b o u t t h e s p e c if ic e x its t h a t a p p l y t o all ID o c s . T h e s e c t i o n c o n c l u d e s b y d e s c r i b i n g I D o c - i n d e p e n d e n t e n h a n c e m e n t s o f I D o c t y p e s , w h i c h is i n t e r e s t i n g b e c a u s e i m p l e ­ m e n t i n g c h a n g e s to t h e s e n d o r u p d a t e p r o c e s s f o r ID o c s u s u a l l y also i n v o l v e s a r e q u i r e m e n t f o r s p e c if ic fields.

89

4

|

C h an g e s to ID o cs

4 .2 .1

D if f e r e n t E x it T y p e s o n t h e B a s is o f t h e M a t e r ia l M a s t e r E x a m p le

SAP d i s t i n g u i s h e s b e t w e e n d i f f e r e n t t y p e s o f s y s t e m a d a p t a t i o n . C u s t o m ­ iz in g a n d p e r s o n a l i z a t i o n a r e c u s t o m e r - s p e c i f i c o r u s e r - s p e c i f i c a d j u s t ­ m e n t s . F o r e x a m p l e , y o u d e f i n e in C u s t o m i z i n g h o w m a n y a n d w h i c h p l a n t s y o u u s e in y o u r SAP s y s t e m a s w e ll a s t h e i r p r o p e r t i e s . T h e p e r s o n ­ a l i z a ti o n a d j u s t m e n t c o m p r i s e s s p e c if ic a t i o n s o n t h e d e f a u l t p r i n t e r a n d t h e like. S u c h s y s t e m a d j u s t m e n t s d o n ' t i n v o l v e p r o g r a m m i n g w o r k . Exits

H o w e v e r , y o u c a n a l s o c h a n g e t h e SAP c o d e , w h i c h e n a b l e s y o u to c h a n g e s e t t i n g s d i r e c t l y in t h e o r i g i n a l SAP p r o g r a m . T h e s e m o d ifica tio n s c a n l e a d to m a j o r p r o b l e m s i n t h e c a s e o f r e l e a s e c h a n g e s , s o t h e y a re f r o w n e d u p o n a n d m u s t b e m a d e k n o w n t o SAP v i a t h e O n l i n e S erv ic e S y s te m . M a n y e n t e r p r i s e s d o n ’t a l l o w f o r m o d i f i c a t i o n s a t all f o r t h e s e reasons.

Properties of exits

To a v o i d t h e m o d i f i c a t i o n p r o b l e m , SAP p r o v i d e s e x i t s in p la c e s t h a t a re s u p p o s e d t o b e u s e d w i t h c h a n g e s c o m p a r e d to t h e s t a n d a r d . F o r s u c h a n e x it, SAP is r e s p o n s i b l e f o r a c t u a l l y p r o v i d i n g a n e x i t in a s t a n d a r d SAP p r o g r a m b y d e f i n i n g w h e t h e r a n e n h a n c e m e n t in t h e p r o g r a m e x is ts a n d w h e r e i t ’s c a lle d . SA P a ls o d e t e r m i n e s w h i c h d a t a is p r o v i d e d f o r t h e c u s t o m e r w i t h i n t h e e x i t a n d w h e t h e r t h e c u s t o m e r is a l l o w e d to c h a n g e a n d w r i t e b a c k c e r t a i n d a ta . T h e s e c o n d s t e p is i m p l e m e n t e d o n t h e c u s t o m e r s i d e . H e re , t h e exits t h a t w e r e d e l i v e r e d e m p t y c a n b e filled w i t h y o u r o w n c o d e . SAP p r o ­ v i d e s d i f f e r e n t t y p e s o f exits:

Exit types

► C u s to m e r e x its C u s t o m e r e x its h a v e b e e n p r o v i d e d s i n c e R e le a s e 3 . 0 . T h e y c a n be u s e d o n l y o n c e , a r e u s e d c r o s s - c lie n t, a n d a r e d e l i v e r e d b y SAP in a n e n h a n c e m e n t a n d i m p l e m e n t e d a n d a c t i v a t e d b y c u s t o m e r s in a n e n h a n c e m e n t p r o j e c t . A f t e r a c h a n g e o f re le a s e , t h e y h a v e to b e r e a c ­ ti v a t e d . ► B u sin e ss tra n s a c tio n e ven ts B u s in e s s t r a n s a c t i o n e v e n t s (BTE) h a v e b e e n d e l i v e r e d s i n c e R elea se 4 . 0 . O rig in a lly , t h e y w e r e j u s t u s e d in FI; n o w , m a n y o t h e r a p p l i c a ­ t i o n s a ls o c o n t a i n BTEs in t h e s t a n d a r d SAP p r o g r a m s . You c a n u s e

90

A d a p tin g E x istin g ID o c T yp e s

|

BTEs c lie n t-sp e cifically . A d i s t i n c t i o n is m a d e b e t w e e n t w o t y p e s o f BTEs: P u b lis h & S u b s c rib e in te rfa c e s P u b l i s h & S u b s c r i b e o r P /S

in terfa ces are s u p p o s e d

to

in fo rm

c o m p o n e n t s o t h e r t h a n t h o s e in w h i c h y o u r p r o c e s s is c u r r e n t l y e x e c u t e d t h a t a p a r t i c u l a r p r o c e s s h a s b e e n c a r r i e d o u t in t h e SAP sy ste m a n d tran sfer d a ta to th ese c o m p o n e n ts . A re tu rn tra n sp o rt o f d a t a i s n 't p r o v i d e d fo r . P /S i n t e r f a c e s c a n t h e r e f o r e h a v e s e v e ra l a c tiv e i m p l e m e n t a t i o n s a t t h e s a m e t i m e . Process in te rfa c e s P ro c e s s i n t e r f a c e s r e p l a c e s t a n d a r d p r o c e s s e s . D a t a is t r a n s f e r r e d to a n d r e t u r n e d f r o m t h e p r o c e s s m o d u l e t h a t is e x e c u t e d i n s t e a d o f t h e s t a n d a r d . P ro c e s s i n t e r f a c e s c a n o n l y h a v e o n e a c ti v e i m p l e ­ m en tatio n . ► B A d ls (B u s in e s s A d d -In s ) B A dls h a v e b e e n p r o v i d e d s i n c e R e le a se 4 . 6 in t h e c o m m o n v a r ia n t; t h e y h a v e a ls o b e e n d e l i v e r e d in a n e w v e r s i o n b o u n d to en h a n cem en ts s i n c e SAP N e t W e a v e r 7 . 0 . B A d ls a r c o b j e c t - o r i e n t e d e n h a n c e m e n t s . SA P p r o v i d e s a B A dl i n t e r f a c e , a n d t h e c u s t o m e r g e n e r a t e s t h e c o r r e ­ s p o n d i n g i m p l e m e n t a t i o n . T h e SAP d e v e l o p e r w h o d e l i v e r s t h e BAdl c a n d e c i d e i f i t c a n b e u s e d m u l t i p l e t i m e s a n d i f i t w i l l b e filterd ep e n d en t. ► E n h a n c e m e n ts E n h a n c e m e n t s a r e t h e n e w c o n c e p t t h a t h a s b e e n r e c e n t l y a d d e d to SA P N e t W e a v e r 7 . 0 . You c a n w o r k w i t h e x p l i c i t e n h a n c e m e n t s , w h i c h a r e p r o v i d e d b y SA P t h r o u g h e n h a n c e m e n t s p o ts; h o w e v e r , im p li c i t e n h a n c e m e n t s a r e a ls o a v a il a b le , w h i c h c a n b e i m p l e m e n t e d a t s p e ­ cific l o c a t i o n s o f e v e r y p r o g r a m t h a t d o e s n ' t d i r e c t l y b e l o n g to t h e SA P Basis w i t h o u t a n y i n t e r f e r e n c e o f t h e SAP d e v e l o p e r . T r a n s a c t i o n S E 8 4 (s e e F ig u r e 4 . 3 0 ) p r o v i d e s a n o v e r v i e w o f e x i s t i n g e x its

Development

a n d p o te n tia lly ex istin g in fo rm a tio n .

environm ent

W h e n im p le m e n tin g a n y o f th e s e exit tech n o lo g ies, y o u m u s t c o n s id e r s p e c if ic a s p e c t s b e c a u s e t h e g e n e r a l p r o g r a m f l o w m u s t n ' t b e c h a n g e d b y t h e exit.

91

4-2

4

|

C h an g e s to ID o c s

Object Navigator

^11H W lW eoitooiert] 5tR«po$itwi tformtbonSysww •g|^|Qo*1«/chr- | n |

H

O b je c ts ~

C J R e p o s ito ry inlo
I- CD B u s in e s s E n ^ n e e n n g l> CD ABAP D it»onary I- CD P r o l a n lib ra r y I

CD C l a s s

5

r i n

w

M

Library

II C D w e o C w p r o

P

' 1 A

CD D o e to p m o n t C o o rd in atio n

CD B S P Library

► CD E ra e rp n s o S e r o c e s

^

CD E n h a n c e m e n ts ^

ABAP DEVELOPMENT WORKBENCH

[ 3 B u s in e s s A dd-ins 0

O e*nit»ons

0

Im p le m e n ta a o n s

*=* C 3 C u s to m e r Exits 0

E n h a n c e m e n ts

0 Projects 0

E n h a n c e m e n t iro p le m e n ta o o n s

0

C o m p o s ite E n h Im p a e m e n u tio n

0

E n h a n c e m e n t S p o ts

0

C o m p o s ite E n h a n c e m e n t S p o ts

F i g u r e 4- 30

Exit s in t h e R e p o s i t o r y I n f o r m a t i o n S y s t e m

P ro g ra m m in g G u id e lin e s f o r E xits A n y t h i n g t h a t a f fc c ts t h e f l o w o f t h e o r i g i n a l p r o g r a m i s n ’t a l l o w e d in e x i t s . In o t h e r w o r d s , y o u m u s t n ' t c r e a t e e v e n t s , s u b r o u t i n e s o r m o d u les

( MODULE)

( FO RM) ,

h e r e . I n s t e a d , y o u m u s t c r e a t e t h e m in s e p a r a t e

in clu d es. D a ta d e c la ra tio n s th a t h a v e b e e n ag re e d u p o n w ith th e

DATA

s t a t e m e n t a p p l y locally. C onsistency

F o r c o n s i s t e n c y r e a s o n s , y o u m u s t a ls o e n s u r e t h a t t h e c u s t o m e r d a t a is o n l y u p d a t e d o r r e s e t i f t h e s a m e is d o n e w i t h t h e SAP d a t a . S t a t e m e n t s , su ch as

COMMI T

or

ROL L BACK,

a r e th e re fo re n o t p e r m itte d . P o stin g s can

o n ly b e im p le m e n te d w ith u p d a te tech n o lo g ies a n d are th e n pro cessed b y th e

COMMI T

or

ROLLBACK

o p e r a t i o n o f t h e SAP p r o g r a m .

C o n s id e rin g th e d etails, th e d if f e r e n t e n h a n c e m e n t te c h n o lo g ie s this c h a p te r in tro d u c e s re q u ire d iffe re n t a p p ro a c h e s fo r g e n e ra tin g y o u r o w n c o d e , s o t h e s e t e c h n o l o g i e s a r e d e s c r i b e d in g r e a t e r d e ta il u s i n g th e m a t e r i a l m a s t e r a s a n e x a m p l e . T h e d e s c r i p t i o n s o n l y r e f e r to t h e e x i t t y p e s t h a t y o u c a n a c t u a l l y u s e in ID o c s . W h e r e s c r e e n a n d m e n u exits a r e p o s s i b l e , n o d e s c r i p t i o n is p r o v i d e d b e c a u s e ID o c s n e v e r w o r k w i t h m en u s o r dynpros.

92

A d a p tin g E x istin g ID o c T yp e s

|

T h i s s e c t i o n a ls o d o e s n ' t i n c l u d e c o d e . C o d e r a t h e r d e p e n d s o n w h e t h e r y o u w a n t t o s e n d o r r e c e i v e ID o c s a n d n o t o n t h e t y p e o f t h e e x it. T h e c o d e is d i s c u s s e d s e p a r a t e l y f r o m t h e d e s c r i b e d p r o p e r t i e s o f t h e v a r io u s e x its in S e c tio n s 4 . 2 . 2 , G e n e r a l E x its, a n d 4 . 2 . 3 , C u s t o m S e g m e n t s .

C u s to m e r E xits SAP c r e a t e s c u s t o m e r e x i t s i n T r a n s a c t i o n S M O D ; t h a t is, y o u c a n u s e th i s t r a n s a c t i o n to o b t a i n i n f o r m a t i o n o n w h i c h c u s t o m e r e x its a r e a v a il­ ab le . H e re , s e v e r a l e x its c a n b e c o m b i n e d in o n e e n h a n c e m e n t . I n t h e ID o c a r e a , t h e e x i t s f o r g e n e r a t i n g ID o c s in o u t b o u n d p r o c e s s i n g a n d f o r u p d a t i n g t h e s a m e m e s s a g e t y p e s in i n b o u n d p r o c e s s i n g o f t e n b e l o n g to th e sam e e n h a n c e m e n t. T h e SAP p r o g r a m calls a c u s t o m e r e x i t u s i n g t h e TION ‘ n n n ’

CALL

CUSTOMER-FUNC­

c o m m a n d . T h e " n n n " a d d i t i o n is a n y t h r e e - d i g i t n u m b e r t h a t

is u n i q u e w i t h i n t h e e n h a n c e m e n t . S o i f y o u w a n t t o k n o w w h e t h e r a p r o g r a m p r o v i d e s a c u s t o m e r e x it, y o u c a n s e a r c h f o r TION.

"CALL CUSTOMERFUNCTION" command

CUSTOMER-FUNC­

T h i s i n d i c a t e s w h i c h e x its a r e c a lle d , w h i c h s i g n a t u r e t h e u s e d e x i t

f u n c t i o n m o d u l e s h a v e , a n d w h e r e in t h e p r o g r a m t h e y a r e c a lle d . If y o u b ro w s e th e a lre a d y -k n o w n fu n c tio n m o d u le , ATE _ MAT MAS

M A S T E R I D0 C _ C R E -

( F i g u r e 4 . 3 1 ) , y o u s e e t h a t a n e x i t w i t h n u m b e r " 0 0 2 " is

a v a ila b le a n d t h a t i t h a s b e e n c a ll e d s e v e r a l t im e s , n a m e l y , e a c h t i m e a n e w s e g m e n t h a s b e e n g e n e r a t e d . You c a n a ls o s e e w h i c h d a t a h a s b e e n t r a n s f e r r e d . I n f o r m a t i o n is p r o v i d e d o n t h e m e s s a g e t y p e , t h e n a m e o f t h e c u r r e n t l y g e n e r a t e d s e g m e n t , a n d all p r e v i o u s l y g e n e r a t e d ID o c d a t a . You c a n c h a n g e t h e u s e r d a t a a n d r e t u r n t h e r e f e r e n c e f o r y o u r e n h a n c e ­ m e n t o f t h e ID o c ,

CIMTYP.

S ectio n 4 .2 .3 , C u s to m S e g m e n ts, d esc rib es

t h i s in m o r e d e ta il. W h e n y o u k n o w t h e c a llin g p r o g r a m a n d t h e e x i t ID , y o u a ls o k n o w t h e n a m e o f th e ex it m o d u le , w h ic h fo llo w s th e

EXIT__nnn

p a t t e r n . In o u r e x a m p l e , t h e e x i t m o d u l e is c a lle d

EXIT_SAPLM V01_002.

D o u b l e - c l i c k i n g o n t h e t h r e e - d i g i t n u m b e r (002) o f t h e n a m e in t h e s e a r c h r e s u l t d i r e c t l y n a v i g a t e s y o u t o t h e f u n c t i o n m o d u l e (s e e F igu re 4 . 3 7 l a t e r in t h i s c h a p t e r ) .

93

Material master example

4-2

4

|

C h an g e s to ID o cs

G lo b a l S e a rc h in P ro g ra m s

0 @1

IH O

19 1B S B I S

P r o g r a n /E n h a n c e a e n t □

281

LM V01U06

CALL CUSTOMER-FUNCTION

•002*

EXPORTING MESSAGE TYPE = MESSA6 E .T Y P E SEGMENT_NAME = C_SE6NAM_E1MARAM F MARA

= MARA

IMPORTING ID 0C _C IM TYPE

= ID0C _CIM TYPE

TABLES I D0C_DAT A 334

CALL CUSTOMER-FUNCTION

= T_IDOC_OATA

•002'

EXPORTING MESSAGE_TYPE = MESSA6 E_TYPE SE6MENT_NAME = C_SE6NAM_E1MAKTM F_MAKT IMPORTING ID O C .C IM T Y P E

= MAKT = IDOC_CIMTYPE

TABLES ----------------------------------------- l . D 0 C _ D A T A _ 5 -T _ iP -Q C -D A T A .-----------

F i g u r e 4.31

F u n c t i o n M o d u l e Ex i t s W h e n G e n e r a t i n g M A T M A S I D o c s

Customer

W h e n y o u k n o w w h i c h c x i t y o u w a n t to i m p l e m e n t , y o u c a n c r e a t e y o u r

enhancement

o w n p r o j e c t u s i n g T r a n s a c tio n C M O D (s e e F ig u r e 4 . 3 2 ) . U s e t h e m a tc h

project

i c o n a t t h e left o f t h e t o o l b a r to a c ti v a te t h e p r o j e c t a t t h e e n d o f y o u r d e v e l o p m e n t w o r k . O n l y t h e n w ill y o u r e x i t b e a c tu a lly e x e c u t e d . First, a s s i g n a n a m e t o y o u r p r o j e c t . B e c a u s e SAP d o e s n ’t d e l i v e r p r o je c ts , y o u c a n th eo re tic ally u se th e e n tire n am esp a ce.

P ro je c t M a n a g e m e n t o f SAP E n h a n c e m e n ts S

f f l S

Project

« * >

ZSM

□

C re a te

© A ttrib u te s O E n h a n c e m e n t A s s ig n m e n t 0 C o m p o n e n ts 0 D o cu m e n ta tio n

Disp lay

F ig u re 4 .3 2

94

i?

C hange

C re a tin g a C u s to m e r Project

A d a p tin g E x istin g ID o c T yp e s

|

4 .2

A f t e r c l i c k i n g t h e C r e a te b u t t o n , y o u c a n d e f i n e t h e a t t r i b u t e s o f y o u r p r o j e c t . T h e f o l l o w i n g s a m p l e c u s t o m e r p r o j e c t (s e e F i g u r e 4 . 3 3 ) is a v e r y c o m m o n d e v e l o p m e n t o b j e c t . As s u c h , i t i n c l u d e s all g e n e r a l d a ta o f d e v e l o p m e n t o b j e c t s , f o r e x a m p l e , s p e c if ic a t i o n s o n t h e p e r s o n w h o c r e a t e d t h e o b j e c t a n d w h e n it w a s c r e a t e d , a s w e ll a s a p a c k a g e . You m a n a g e t h e o b j e c t v ia a t r a n s p o r t r e q u e s t , w h i c h y o u c a n u s e to t r a n s p o r t it t o t h e liv e s y s t e m .

A ttrib u te s o f E n h a n c e m e n t P ro je c t ZS M E n h a n c e m e n t a s s ig n m e n ts

[C o m p o n e n ts

P ro je c t

ZSM

S hort text

S a b in e s ID oc E n h an cem en ts)

A d m in istra tio n data Package O rig in al la n g u a g e

EN

C re a te d by

NAISELSA

0 8 /1 7 /2 0 0 9

L a s t c h a n g e d on/by

A ctuation Pro tect Status C hanged

Figure 4.33

A ttrib u tes o f t h e C u s to m e r Project

N o w y o u c a n a s s ig n o n e o r s e v e r a l e n h a n c e m e n t s t o y o u r c u s t o m e r p r o j ­

Assigning the

e c t u s i n g t h e E n h a n c e m e n t A s s i g n m e n t s b u t t o n . E v e r y e n h a n c e m e n t can

enhancement

o n l y b e l o n g t o o n e p r o j e c t . F i n d i n g t h e e n h a n c e m e n t t h a t y o u w a n t to i m p l e m e n t t o c h a n g e t h e m a t e r i a l m a s t e r I D o c is e a s i e r h e r e b e c a u s e y o u c a n e n t e r t h e n a m e o f t h e p r e v i o u s l y i d e n t i f i e d e x i t m o d u l e to d e t e r m i n e t h e e n h a n c e m e n t i t b e l o n g s t o . A s s h o w n in F ig u r e 4 . 3 4 , t h i s i s n ’t p r o ­ v i d e d b y SAP b y d e f a u l t s o y o u n e e d t o s e l e c t t h e c o r r e s p o n d i n g o p t i o n s in t h e A d d i t i o n a l S e l e c t i o n s t a b first. T h e e n h a n c e m e n t f o u n d in t h e e x a m p l e is c a lle d MGV00001, a n d y o u can

E n h a n c e m e n t for

n o w a s s ig n it t o y o u r c u s t o m e r e n h a n c e m e n t p r o j e c t b y s p e c i f y i n g i t in

material m as te r IDoc

E n h a n c e m e n t ( F i g u r e 4 .3 5 ) .

95

4

|

C h an g e s to ID o cs

S A P E n h a n c e m e n t s in E n h a n c e m e n t P r o je c t Z S M §

e

l ^ j ^ l H

Enhancem ent 1 C o m p o n en t

0.

:

L a s t O b je c t S e le c te d

IS E x it

Standard selections S A P -E IS : U s e r

KKCD0001

e x its

fo r

d a ta

tra n s fe r

Exit n a m e S h o r t text

✓

3 f l i n f o r m a ti o n S y s t e m

a"0

sa p

A o o iic a t o o s

h i

X

P ackage A p p lic a tio n C o m p o n e n t

Adoiionai selections S fm o d o le e n ts

E S c re e n a re a s

C om ponent n am e

0 M e n u E n tn e s E X IT S a p l h v o i

002

C r e a t e d by C re a te d on L ast c h a n g e d by C h a n g e d on

M a n m u m N o o f H its

Figure 4.34

Finding t h e E n h a n c e m e n t

S A P E n h a n c e m e n ts in E n h a n c e m e n t P r o je c t Z S M V

a

g

a

U

Enhancem ent

C o m p o n e n ts

Enhancem ent

Text

M 6V000O 1

M a te ria l M a s te r (In d u s try ): A L E D is trib u tio n

Figure 4.35

MGV00001

Assigning t h e E n h a n c e m e n t

is a n e n h a n c e m e n t t h a t a l r e a d y c o n t a i n s t w o f u n c t i o n e x its .

You c a n a l s o i m p l e m e n t o n l y o n e o f t h e m i f y o u d o n ' t n e e d t h e o t h e r . T h e c r o s s e d - o u t c irc le s in F i g u r e 4 . 3 6 i n d i c a t e t h a t t h e e n h a n c e m e n t h a s n ' t b e e n a c t i v a t e d y e t . T h e e m p t y c o l u m n in f r o n t o f t h e t w o exits s h o w s t h a t t h e y a ls o h a v e n ’t b e e n i m p l e m e n t e d y e t . The

EX I T _ S A P L M V 0 1 _ 0 0 2

e x i t n o w c o m p r i s e s t h e c o m p l e t e s i g n a t u r e , as

y o u c a n s e c i n F ig u r e 4 . 3 7 . N e a r l y a ll i m p o r t p a r a m e t e r s a r e o p t i o n a l , w h i c h is w h y o n l y v e r y f e w w e r e d i s p l a y e d d u r i n g t h e call.

96

A d a p tin g E x istin g ID o c T yp e s

|

4-2

D is p la y ZSM En h an cem en t ass ig n m en ts

P r o je c t

D

ZSM

Enhancem ent

Iip l

1

Exp

F u n c t io n e x i t

Enhancem en t

S a b in e s IO o c Enhancem en ts

H 6V00001 M a t e r i a l

M a s te r

(In d u s tr y ):

ALE D i s t r i b u t i o n

EXIT_SAPLM V01_002 EX IT_SA PLM V02_002

C o m p o n e n ts o f th e E nhancem ent

F ig u r e 4 .3 6

F u n c tio n B u ild e r: D isp la y EXIT_SAPLM V01_002 a

I 3 9 llk s ] 3 g ia [

Function m o d u le

EXIT_SAPLMVO1_O0 2

Attributes

r m

Q

Im port

m

i a

E ip o rt

C h anging

Active T a b le s

Exceptions

a

FUNCTION EXIT_SAPLHV01_0O2 ■ • • • L o k a le S c h n it t s t e ll e IMPORTING VALUE(HESSAGE.TYPE) LIK E EDMSG-HS6TYP EDIDD-SE6NAH VALUE(SE6HENT_NAnE) LIK E VALUE (F_MARA) LIK E HARA STRUCTURE HARA HAKT STRUCTURE HAKT VALUE(FJ1AKT) LIK E VALUE (F MARC) LIK E MARC STRUCTURE MARC VALUE(F_HAR0) LIK E MARD STRUCTURE HARD VALUE(F_MFHM) LIK E MFHfl STRUCTURE MFHH VALUE (FJ1P G 0) LIK E MP6D STRUCTURE MPGD VA LUE (FJ1P0P) LIK E HPOP STRUCTURE "POP VALUE(F_HPRW) LIK E MPRW STRUCTURE HPRW VA LUE (FJ1VE 6) LIK E MVEG STRUCTURE HVEG VALUE(FJ1VEU) LIK E MVEU STRUCTURE h veu VALUE(FJ1KAL) LIK E MKAL STRUCTURE HKAL HARM VALUE(F_MARM) LIK E STRUCTURE HARM VALUE(FJ1EAN) LIK E MEAN STRUCTURE MEAN VALUE(F_MBE«) LIK E MBEW STRUCTURE M8EW VALUE(FJ1LGN) LIK E MLGN STRUCTURE HLGN VALUE(F_HVKE) LIK E MVKE STRUCTURE HVKE VALUE(F.M LAN) LIK E ULAN STRUCTURE HLAN VALUE (F HLGT) LIK E MLGT STRUCTURE HL6T EXPORTIN6 VALUE(IOOC_CIMTYPE) LIK E ED ID C -C IH T Y P TABLES IDOC.DATA STRUCTURE EDIDD ft •

OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL

INCLUDE ZXM6VU03

tuntiinr.niui-------F ig u r e 4 .3 7

C o n t e n t o f t h e S A P E x it s

T h e e x i t b e l o n g s t o t h e SAP s y s t e m a n d is l o c a t e d i n t h e SAP n a m e s p a c e .

C u s to m e r in c lu d e s

In a d d i t i o n , t h e c o n t e n t o f t h e e x i t m o d u l e c o n s i s t s o f o n l y o n e i n c l u d e

in t h e e x it

(ZXMGVU03). T h is i n c lu d e , in t u r n , is lo c a t e d in t h e c u s t o m e r n a m e s p a c e a n d d o e s n ' t e x i s t in t h e SAP s y s t e m u n t i l t h e e x i t h a s b e e n i m p l e m e n t e d .

97

4

|

C h an g e s to ID o cs

C re a tin g th e

If y o u d o u b le-c lic k o n (h e in c lu d e n a m e , y o u c a n c r e a te th e in clu d e

in c lu d e

v i a f o r w a r d n a v i g a t i o n , a s s h o w n in t h e C r e a t e O b j e c t d i a l o g in F ig u re 4 .3 8 .

F u n c tio n B u ild e r^ D is p la y E X IT _ S A P L M V 01 _ 0 02 w ra iiw io iH iiiiiig iF P iH g iis iia n iiiiB iin F u n ctio n m o d u le A ttributes

EX IT_S A P LM V O 1_O 02 Im p o rt

Export

^

iiB i

Active

C h a n g in g

T a b le s

E xceptions

urce code

i i innsai i iai FUNCTION E X IT SAPLMV01 0 0 2 . " L o k a le S c h n it t s t e lle : IMPORTING VALUE (HESSAGE_TYPE) VALUE(SEGMENT NAME)

L IK E L IK E

EDMSG-MSGTYP EPIDD-SE6NAM

're

0

/

In c lu d e Z X M G V U 0 3 d o e s n o t e x is t C r e a te O b jec t’

Yes

II

« M l. . VALUk VALUE (FJ1E A N ) VALUE(FJ1BEW ) V A LU E (F _H L6 N ) V A LUE (F_HV KE) VALUE (F J1L A N ) V A L U E (F MLGT)

NO

IX

Cancel

I

■ L IK E L IK E L IK E L IK E L IK E L IK E

MEAN MBEW HLSN HVKE MLAN HLBT

STRUCTURE STRUCTURE STRUCTURE STRUCTURE STRUCTURE STRUCTURE

I MEAN MBEW HL6N HVKE MLAN ML6T

IIV * OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL OPTIONAL

EXP0RT1N6 E D ID C -C IM T Y P V A L U E (I0 0 C _ C IH T Y P E ) L IK E TABLES E 0 I0 D ID0C _DA TA STRUCTURE

INCLUDE ZXMGVU03.

ENDFUNCTION

F ig u r e 4 .3 8

C r e a tin g a n In c lu d e in t h e C u s to m e r N a m esp a ce

T h e s y s t e m t h e n p r o v i d e s t h e e m p t y i n c l u d e (s e e F ig u r e 4 . 3 9 ) i n w h i c h y o u can in s e rt y o u r o w n c o d e . M a k e s u re y o u s a v e y o u r e n trie s alread y w h e n e d itin g th e in c lu d e . I f y o u a c tiv a te th e in c lu d e w i t h o u t h av in g s a v e d y o u r e n trie s a n d a n e r ro r occurs, y o u m ay h a v e to e n te r th e code all o v e r a g a in .

98

A d a p tin g E x istin g ID o c T yp e s

|

A B A P E d ito r: C h a n g e In c lu d e ZX M G V U 03 ■© £■- • @ * In c lu d e

„•

n i a s i

Z1HGVU83

P a tte rn

P retfr Pu nter

Inactive (R e v is e d )

liw n 'B la l ZX M G V U 03

F ig u r e 4 .3 9

I n c l u d e t o B e F ille d

You m a y w a n t t o g r o u p y o u r c o d e f o r g r e a t e r cla rity . T h is c a n b e d o n e b y c r e a t i n g a d d i t i o n a l i n c l u d e s . T h e i n c l u d e s t h e n b e g i n w i t h "Z"; t h a t is, t h e y a r e l o c a t e d in t h e c u s t o m e r n a m e s p a c e b u t still b e l o n g to t h e SAP e x i t f u n c t i o n g r o u p t h a t a l w a y s b e g i n s w i t h "X.” SA P p r o p o s e s ZXMGVF01 f o r its n a m e (s e e F ig u r e 4 .4 0 ).

A B A P E d ito r: C h a n g e In c lu d e ZX M G V U 03 M

l^ l I

IfrllttlB IIIl I P

inclu de

I

1

H T H B I fiS 1

ZXH6VU03

8 1 P a ttern | | Pretty Printer

Inactive (R e v is e d )

FILL.Z1M AR A

S u broutine

IN C L U D E Selection ZXKGVF01

Ne*

In c lu d e

3 3

F ig u r e 4 4 0

C u s to m e r In c lu d e

Business T ra n sa ctio n Events B u s in e s s t r a n s a c t i o n e v e n t s (BTEs) a r e a ls o h a n d l e d v i a f u n c t i o n m o d u l e s b u t i n a d i f f e r e n t w a y t h a n c u s t o m e r e x i t s . F o r BTEs, SAP calls i n t h e d eliv ered c o d in g a fu n c tio n m o d u le u sin g th e P E R F O R M_ X X X X X X X X _ E ’

c o m m a n d ; here,

CALL F U N C T I O N

XXXXXXXX

*0 P E N _ F I _

is t h e ev en t ID .

99

G ro u p in g code

4-2

4

|

C h an g e s to ID o cs

Determining b te s

You c a n s e a r c h f o r

0PEN_F

I * in t h e d e s i r e d c o d e t o f in d t h e e x i s t i n g BTEs

(sec F ig u r e 4 .4 1 ) . T h e s p e c i f i c a t i o n s in t h e r i g h t fie ld i n d i c a t e i f a BTE e x ists, w h e r e i t's c a lle d , a n d w h i c h s i g n a t u r e it p r o v i d e s . T h e BTE f o u n d h e r e h a s ID

MGV00100,

is c a ll e d o n l y o n c e , a n d p r o v i d e s all ID o c d a t a

to g e th e r w ith th e c o n tro l record.

G lobal S e arch in P ro g ra m s o n iF ira

a n

a

P ro g ra » /E n h a n c e a e n t

m m xm ------------------------------------------------------------------------------------------------------- P t ------------------------

□ LHV91UG6

2099

c a ll

fu n c tio n

ta b le s id o c _ d a ta

•O P E N J M .P E R F O R M J IG V O O IO O .E 1 = t _ id o c _ d a t a

c h a n g in g id o c _ h e a d e r = f _ id o c _ h e a d e r e x c e p t io n s

=1.

o th e rs

Figure 4 4 1

finding BTEs

Sample function

In T ra n s a c tio n B F01, y o u can fin d th e s a m p le f u n c tio n m o d u le s th a t

module

b e l o n g t o P/S i n te r f a c e s . T r a n s a c t i o n B F0 5 s p e c if ie s t h e s a m p l e f u n c t i o n m o d u le s th a t b e lo n g to p ro c ess in terfaces. T he s a m p le fu n c tio n m o d ­ u le th a t b elo n g s to th e

MGV00100

BTE is t h e

SAMPLE_INTERFACE_MGV00100

f u n c t i o n m o d u l e (s e e F ig u r e 4 .4 2 ) . A lw a y s c h e c k b o t h BTE ty p e s i f y o u d o n 't k n o w w h ic h ty p e th e d e v e lo p e r used.

Change View "L ib ra ry o f th e Publish& S ubscribe B usiness Transaction ffifgflfNew Entries Event

—

|Te»t

module for BTEs

C

SA flP lE JN T E R F A C E J ievO O lO O

0

H6VO02O0 MATMAS : Inboun d P rocessing fo r ALE Distribn Unit

SA HP LEJN TER FAC EJ16V00200

El

Figure 4.42

Creating your own

S a m p le Function M odule

H6VO01O0 MATMAS : O utbound processing fo r ALE Distribn Unit

Event with Sample Function Module in Transaction BF01

T h e s a m p l e f u n c t i o n m o d u l e c o n t a i n s t h e s i g n a t u r e e x a c tly in a f o r m a t ex p ected by th e

0PEN_FI_PERF0RM

A B A P s t a t e m e n t o f t h e c a llin g p r o g r a m

s o t h a t y o u c a n u s e it a s a t e m p l a t e . C o p y th is f u n c t i o n m o d u l e to y o u r o w n n am esp a ce, a n d in se rt th e d esire d c o d e (in d ica te d b y * s ta rts

10 0

here

in F ig u r e 4 .4 3 ).

My o w n c o d e

A d a p tin g Ex istin g ID o c T yp e s

|

4 .2

F u n c tio n B u ild e r: C h a n g e Z _ E V E N T _ M G V 0 0 1 0 0

F I R I W R I B I f S l I P lf f l H F f r l I B S m n iP l I M W I Function m o d u le

Z _E V E N T _ H 6 V 0 0 1 0 0

A ttributes

Im p o rt

_ u

l m

Export

s o

II Pre«rPrinie7

Active

C h a n g in g

T a b le s

Exceptions

m m

FUNCTION Z_E VEN T_H 6VO 010 0 . •"L o c a l In te rfa c e TABLES ID O C .D A T A STRUCTURE EOIDD CHANGING REFERENCE( IDOC_HEADER) L IK E EXCEPTIONS

E01DC STRUCTURE

ED ID C

ERROR

E v en t r ls s e n by th e

ALE o u tb o u n d p r o c e s s f o r

HATHAS.

I t a l lo » s t o n o d if y t h e ld o c 's c o n tr o l h e a d e r t h e id o c d a ta a s » e l l a s s e r i a l i z a t i o n i n f o r m a t i o n c r e a t e d b y t h e s t a n d a r d SAP o u tb o u n d p ro c e s s . R a i s i n g t h e EXCEPTION ERROR w i l l s u b m i t t e d t o t h e ALE l a y e r .

p re v e n t th e

BE CAREFUL W ITH ANY CHANGES TO ID O C .C O N TR O L. ALE-SCENARIO

IDOC f r o *

IT

b e in g

HAY EFFECT YOUR WHOLE

■ My o « n c o d e s t a r t s h e r e ENDFUNCTION.

C o p y o f t h e S a m p le M o d u l e

F ig u r e 4 - 4 3

To a c t u a l l y e x e c u t e t h e c o r r e s p o n d i n g f u n c t i o n m o d u l e , y o u h a v e t o a c ti v a te it. H o w e v e r , t h i s is d o n e i n a c o m p l e t e l y d i f f e r e n t w a y t h a n fo r c u s t o m e r e x i t s . T h e t r a n s a c t i o n f o r m a n a g i n g BTEs is T r a n s a c t i o n FIBF. F ir s t o f all, y o u h a v e t o c r e a t e a c u s t o m e r m a n a g e m e n t o b j e c t b y f o l l o w ­ in g th e

Se

t t in g s

• Pr

o d u c ts

• ...

o f a

c u sto m e r

m e n u p a t h (s e e F ig u re

4 .4 4 ).

asm Events

E d it

G o to

S e ttin g s

SAP B u s in e s s I

F ig u r e 4 . 4 4

E n viro n m en t

S y ste m

H e lp

*

. . . o f a partn er

P /S M o d u le s

•

... o f a cu s to m e r

P r o c e s s M o d u le s

*

»

M e n u Path f o r t h e C u s to m e r P ro d u c t

10 1

C u sto m e r p ro d u ct

4

|

C h an g e s to ID o cs

T h e e n t r i e s f o r t h e p r o d u c t m a i n l y c o n s i s t o f t h e n a m e (s e e F ig u r e 4 .4 5 ) . B e c a u s e SAP d e l i v e r s p r o d u c t s f o r p a r t i c u l a r ta s k s , a n d SAP p a r t n e r s u s e t h e s e BTEs in s o m e p r o d u c t s , y o u s h o u l d b e c a r e f u l w h e n a s s i g n i n g t h e nam es. A c tiv a tin g the

T h e last fie ld , w i t h "A" a s t h e h e a d i n g , p l a y s a p a r t i c u l a r l y critical role

c u s to m e r p ro d u c t

b e c a u s e it ’s t h e a c ti v a ti o n c o l u m n . T h e c o r r e s p o n d i n g c h e c k b o x in d ic a te s

f o r each c lie n t

w h e t h e r t h e p r o d u c t in t h e c u r r e n t c l i e n t is a c ti v e (BTEs c a n b e a c ti v a te d c l i e n t - i n d e p e n d e n t l y ) s o t h a t t h e r e s p e c t i v e BTEs c a n b e e x e c u t e d .

C h a n g e V ie w " C u s to m e r P ro d u c ts " : O v e rv ie w y

N e w E n trie s

lj? S

P ro d u ct

[Text

ZSH1

ID o c s

F ig u re 4 -4 5

i

. i

l l

E R F C des tin atio n

A 0

C re a tin g a C u s to m e r P ro d u ct

T h e RFC D e s t i n a t i o n field r e m a i n s e m p t y i f y o u r e m a i n in t h e s a m e s y s ­ t e m t h a t e x e c u t e s t h e c a llin g p r o g r a m . I f y o u e n t e r a v a l i d d e s t i n a t i o n f r o m T r a n s a c t i o n S M 5 9 in t h i s field, t h e e v e n t s t h a t a r c a s s i g n e d t o th is p r o d u c t a r e e x e c u t e d o n t h e s y s t e m t h a t b e l o n g s to t h i s d e s t i n a t i o n . A s s ig n in g an e v e n t to th e p ro d u c t

You a s s i g n y o u r e v e n t s to t h e p r o d u c t ( c o m b i n e d a c c o r d i n g t o w h e t h e r all o r n o n e o f t h e s e e v e n t s a r e a c tiv e ) v i a t h e or

Process

M

o d u le s

Se

t t in g s

• P /S M

o d u le s

m e n u p a t h . F i g u r e 4 . 4 6 d i s p l a y s a ll r e q u i r e d

s p e c if ic a t i o n s .

C h a n g e V ie w "P u b lis h & S u b s c r ib e B T E : C u s to m e r E n h a n c e m e n ts ": N e w Entries

Event

IP roduct

H6VOO10OZSM1

jctr |Appl

f u n c t io n M odule

n

|Z_EVENT_HG V00100

id id

n F ig u re

4.46

A s s ig n in g Events t o P ro d u cts

D e p en d in g o n th e e n v iro n m e n t, y o u can use th e en trie s m a d e fo r count i y (C tr) a n d a p p l i c a t i o n (A p p l.) a s t h e filte r c r it e r i a ; f o r ID o c s , h o w e v e r , t h e s e r e s t r i c t i o n s d o n ’t h a v e a n y e ffec t, s o t h e fie ld s r e m a i n e m p t y .

10 2

A d a p tin g E x istin g ID o c T yp e s

|

C lassic B A dls C lassic B A d ls a r e h a n d l e d v i a a h a n d l e r class. T h e n a m e o f th i s c lass is CL.EXITHANDLER,

a n d its c lass m e t h o d ,

GET.INSTANCE,

is c a lle d o n c e f o r

e a c h B A d l. I f y o u w a n t t o k n o w i n a p r o g r a m i f y o u c a n u s e a BAdI, s e a r c h f o r "C L .E X IT H A N D L E R ." You c a n fin d t h e r e q u e s t e d BAdI in t h e EX I T_NAME

e x p o r t v a r ia b l e . A c o r r e s p o n d i n g i n s t a n c e v a r i a b l e c a lle d

LF_

EXIT is s p e c if ie d h e r e (s e e F ig u r e 4 .4 7 ).

G lo b a l S e a rc h in P r o g r a m s

*W .

S

a

*

F

2674 2080

□invotuee

F ig u r e 4 - 4 7

1 1- D-

CLASS Cl.EXITHANOlER DEFINITION 10A0 CALL REIMOD cl_exUhanoet_1nstance EXPORTING EXIT_NANE ■ 'B*t>t_NATI1AS_AlE_CR‘ INPORTIN6 ACT_1NP_EX1STIK6 i IF_EXII_AKT CHANGING tnstance = IF.EXIT

I d e n t i f y i n g a C la s sic B A d I

T h e n a m e o f th e in s ta n c e v a ria b le n o w e n a b le s y o u to d e te r m in e w h ic h

C a llin g t h e BAdI

m e t h o d s o f t h e BAdI a r e c a ll e d a n d w h e r e t h e y a r e c a lle d . H e re a s w e ll, SAP d e f i n e s w h i c h d a t a is t r a n s f e r r e d , w h i c h m e a n s t h e

CHANGE_MATMAS

m e t h o d is c a ll e d o n c e , t r a n s f e r s all ID o c d a t a a n d t h e c o n t r o l r e c o r d , a n d b o t h c a n b e c h a n g e d . F ig u r e 4 . 4 8 s h o w s t h e c o d e p r o v i d e d b y SAP f o r c a llin g t h e c la ssic BAdI. B A d ls h a v e to b e d e l i v e r e d b y SAP, s o SAP c r e a t e s t h e B AdI a n d t h e

C re a tin g a BAdI

m e t h o d s w i t h y o u r s i g n a t u r e a n d calls t h e m in t h e SAP p r o g r a m . C o n s e ­

im p le m e n ta tio n

q u e n tly , y o u o n l y h a v e to d e f i n e w h a t is s u p p o s e d t o b e d o n e in t h e BAdI. T h e B AdI is c r e a t e d in T r a n s a c t i o n S E 1 8 . You c a n u s e T r a n s a c t i o n S E 1 9 to c r e a t e a n i m p l e m e n t a t i o n f o r t h e BAdI w h e r e y o u d e f i n e w h a t y o u w a n t to d o w i t h t h e p r o v i d e d d a t a w i t h i n t h e m e t h o d . F ig u r e 4 . 4 9 d i s p l a y s t h e in itial s c r e e n o f t h e t r a n s a c t i o n in SAP N e t W e a v e r 7 .0 . In o l d e r re le a se s , t h e N e w BAdI o p t i o n w a s m is s in g ; e v e r y t h i n g e ls e s t a y s t h e s a m e .

10 3

4 .2

4

|

C h an g e s to ID o cs

F u nctio n B uild e r: D isp la y MASTERIDOC_CREATE_MATMAS Pattern Function m odule Attributes

MASTERIDOC_CREATE_MATMAS import

m

Export

loal |

C hanging

Active T a b le s

Exceptions,

ja j

HATMAS-IDOCS s e n a e n : s s s = i= = :s = i: i= = s = = s s = = : = ’ 1 I n s t a n z v a n a b l e z u n e is e n CLASS CL.EXITHANDLER D E F IN IT IO N LOAD STATICS L F _ E X IT TYPE REF TO IF_EX_BADI_HATMAS_ALE_CR STATICS: LF_EXIT_A K T( 1 ) TYPE C VALUE # \

sssssssssssss

' 2 In s ta n z e r o tfn e n I F l f . e x l t IS IN IT IA L CALL METHOD c l_ e x i t h a n d l e r « > g e t in s t a n c e EXP0RTIN6 EXIT_NAHE = 'BADI_MATnAS_ALE_CR' IHPORTINS ACT IMP E X IS TIN G = LF E X IT AKT CHAN6IN6 in s t a n c e = L F .E X IT . e n d lf . ' 3 S ta rte n I F NOT LF_EXIT_AKT IS IN IT IA L CALL METHOD L F _ E X IT • >CHAK6E_MATHAS CHAN6IN6 T_I00C_DATA = T_IDOC_DATA[] F_I00C_HEADER = F_!DOC_HEADER E N D IF . ■========= b a o I n a t h a s -IDOC s s e n d e n - - - - - - -

C a l l i n g t h e C la s s ic B A d l

F ig u r e 4 4 8

B A d l B u ild e r: In itia l S cre e n f o r Im p le m e nta tion s d Edil im plem entation

<$ N e w BAdl En h an cem en t Im plem entation

O C la s s ic 8Adi Im plem entation

O N e w BAdl

® C la s s ic BAdl BAdl N a m e

□

C rea te Im p!

F ig u re 4 .4 9

10 4

f f l l Z E

]

In itia l S creen fo r C re a tin g a n Im p le m e n ta tio n

E

A d a p tin g E x istin g ID o c T yp e s

|

4 .2

S p e c ify y o u r c la ssic BAdl in t h e C r e a te I m p l e m e n t a t i o n ta b , a n d click o n t h e C r e a t e I m p l e m e n t a t i o n b u t t o n to n a v i g a t e t o t h e n e x t i n p u t s c r e e n . F irst, y o u n e e d a n a m e f o r y o u r i m p l e m e n t a t i o n (s e e F ig u re 4 .5 0 ) . T h e u s u a l n a m i n g r u l e s (Z, Y, o r c u s t o m e r n a m e s p a c e as a p re fix ) a p p ly . In a d d i t i o n , y o u s h o u l d n a m e t h e i m p l e m e n t a t i o n lik e a class, f o r e x a m p l e , ZCL_SM_IMP1, b e c a u s e i t's a ls o d i s p l a y e d i n t h e c lass l i b r a r y in T r a n s a c ­ t i o n S E 2 4 . T e c h n ic a lly , i t ’s j u s t t h e i m p l e m e n t i n g c lass o f a n in t e r f a c e w i t h SAP c r e a t i n g t h e i n t e r f a c e a n d y o u c r e a t i n g t h e i m p l e m e n t a t i o n . H e r e , i t ’s a l s o i n d i c a t e d w h e t h e r t h e B A d l is o r i s n ’t F i l t e r - D e p e n d e n t

A ttrib u te s o f th e

o r i n t e n d e d f o r M u l t i p l e u s e (s e e F ig u r e 4 . 5 0 ,

im p le m e n ta tio n

A

t t r ib u t e s

• Typo). T h e

classic B A dl s h o w n h e r e (BADI_MATMAS_ALE_C R) h a s b e e n m i g r a t e d i n t o a n e w B A d l in t h e m e a n t i m e s o t h a t i t w o u l d n o l o n g e r b e u s e d in a n e w r e le a s e . A s a n e x a m p l e , i t's a s g o o d a s a n y o t h e r , s o w e 'l l s tic k to t h e m a t e r i a l m a s t e r f o r t h e s a k e o f clarity. U s e t h e m a t c h i c o n ( w h i c h is lit t h i s t i m e ) to a c t i v a t e t h e B A dl a t t h e e n d o f y o u r d e v e l o p m e n t w o r k .

B usine ss Add-In B uilder: Change Im plem entation ZCL_SM_IMP 1 R U D B

I O W tntionO ocum enta

Documentatton |

implem entation N am e

z c L _ s r ijn P i

Implem entation Short Text

SaDines 8 adi Im plem entation

Definition Nam e

B A D IJM T H A S _ A L E _ C R

Inactive

interface

General Data Package Language

EN English

Last changed by Last change

00 00 00

TVpe BAdl migrates to enhancem ent spot

F

BADI_MAT MAS_ALE _C R

Multiple use

C Fiiter-Depen<

F ig u re 4 -5 0

C re a tin g t h e I m p le m e n ta tio n -

D e ta ils

105

4

|

C h an g e s to ID o cs

M e th o d s of th e BAdl

T h e I n t e r f a c e s t a b (s e e F ig u r e 4 . 5 1 ) p r o v i d e s i n f o r m a t i o n o n t h e m e t h ­ o d s o f t h e B A dl. D o u b l e - c l i c k i n g o n a m e t h o d t a k e s y o u t o t h e l o c a t i o n w h e r e y o u c a n c r e a t e y o u r o w n c o d e (s e e F ig u re 4 .5 2 ) .

B usine ss Add-In B uilde r: Change Im plem entation ZCL_SM_IMP 1 *1 ?

a’o

;

a

oBo S

O

Definition Docum enta

Documentation

Implem entation Nam e

ZCL_SH_IMP1

Implem entation Short Text

Sabines m a t m a s BASl implementation

Inactrve

Definition Nam e

BADI HATHAS ALE_CR

Attributes

interface nam e

1F_EX_BADI_HATHAS_ALE_CR

N a m e of implem enting class:

ZC L_[«_CL_SH _ im p i

Method

m piem entation r»p©

CHANGEJ1ATHAS

ABAPABAPCode

iDescnption

□

3 B ase Method

I

□

a □ 3

a a • m

:

F ig u re

4 .51

M e th o d V ie w o f th e Im p le m e n ta tio n

Class B u ild e n C la ss ZCL_IM _CL_SM J M

0

*1

P

1[Change

@ IB §168 IS I@ 0 ®® IE ® O B I

Method

IF_EX_BADI_HATHAS_ALE_CR~CHAK6E_HATHAS

I InaclNe

~nwi □□amj leiai______________________ ■ e th O d

1 F _ E X _ B A D IJ 1 A T IU S _ A IE _ C R - C H A N 6 E J 1 A T H A S

e n d ie th c d

F ig u re 4-52

D e v e lo p in g a C u sto m M e th o d

N o t e t h a t y o u m u s t e n a b l e y o u r c o d e h e r e . To a c tu a l ly e x e c u t e t h e ex it, y o u h a v e to a c t i v a t e t h e i m p l e m e n t a t i o n in t h e m a i n s c r e e n o f T r a n s a c ­ tio n SE19. T h e B A dl is c r o s s - c lie n t; t h a t is, y o u r c h a n g e s t a k e e f f e c t in t h e e n t i r e SAP s y s t e m .

10 6

A d a p tin g Ex istin g ID o c T yp e s

|

4-2

E x p lic it E n h a n ce m e n ts as o f SAP ERP 6 .0 w it h Basis 7.0 S in c e S A P N e t W e a v e r R e le a s e 7 . 0 , y o u c a n u s e a n e w e n h a n c e m e n t t e c h n o l o g y . L e t's h a v e a l o o k a t t h e e x p lic it e n h a n c e m e n ts first ( i m p l ic i t e n h a n c e m e n ts are d e s c rib e d la te r in th e sec tio n title d Im p licit E n h a n c e ­ m e n t s a s o f SA P ERP C e n t r a l C o m p o n e n t 6 . 0 w i t h Basis 7 . 0 ) . SAP p r o ­ v i d e s t h e s e e n h a n c e m e n t s a t s p e c if ic l o c a t i o n s in t h e c o d e s o t h a t y o u can u s e th em . E x p lic it e n h a n c e m e n t s a r e c o m b i n e d in e n h a n c e m e n t s p o ts. E n h a n c e m e n t

Enhancem ent spot

p o in ts a n d e n h a n c e m e n t sections a r e a ls o a v a il a b le . T h e r e is n o d e f a u l t c o d e f o r e n h a n c e m e n t p o i n t s . You s i m p l y i n s e r t y o u r d e s i r e d a d d i t i o n s w h e r e t h e e n h a n c e m e n t p o i n t is lo c a t e d . F o r e n h a n c e m e n t s e c ti o n s , SAP d e l i v ­ e r s a c o d e t h a t is e x e c u t e d a s l o n g as y o u d o n ' t c r e a t e a n i m p l e m e n t a ­ t i o n ; h o w e v e r , y o u c a n r e p l a c e it w i t h y o u r o w n i m p l e m e n t a t i o n . You c a n e a s il y f i n d e x p l i c i t e n h a n c e m e n t s b y s e a r c h i n g f o r t h e t e r m

S e a rc h in g for

" e n h a n c e m e n t - . " T h e h y p h e n is i m p o r t a n t ; o t h e r w i s e , t h e s e a r c h r e s u lt s

e n h a n c e m e n ts

w o u l d a ls o c o n t a i n i m p l e m e n t a t i o n s b e c a u s e SA P o f t e n a l r e a d y d e l i v ­ e r s i m p l e m e n t a t i o n s , f o r e x a m p l e , f o r i n d u s t r y s o l u t i o n s . F ig u r e 4 . 5 3 d isp lay s th e sea rch re s u lt f o r th e e n h a n c e m e n ts o f th e ATEJ - 1 ATMAS

MASTERIDOC_CRE-

fu n c tio n m o d u le.

G lobal Search in P rogram s

P r o g r a i/ E n h a n c e ie n t

□

LMY01U06

1 2 2 E N H A N C E M E N T •P O I N T M A S T E R I D O C _ C R E A T E _ M A T M A S _ 0 1

S P O T S ES_SAPLMV01

279 ENHANCEMENT-POINT MASTER 1D0C_CREATE_MATMAS_09 SPOTS ES_SAPLHV01. 291

ENHANCEMENT.POINT M A STER IOOC_CREATE_MATMAS_02 S P O T S ES.SAPIMV01

293 ENHANCEMENT-POINT EHP_MASTERID0C_CREATE_MATMA_01 SPOTS ES.SAPLMV01 297 ENHANCEMENT-POINT MASTER IOOC_CREATE_MATMAS01

S P O T S ES.SAPLMVOI

473 ENHANCEMENT.POINT M A STER IDOC_CREATE_MATMAS_03 S P O T S ES_SAPIMV01 475 ENHANCEMENT-POINT M A STER ID0C_CREATE_MATHAS02 S P O T S ES.SAPIMVOI 477 ENHANCEMENT.POINT M A STER ID0C_CREATE_MATMAS_06 S P O T S ES_SAPLNV01 6 3 2 ENHANCEMENT.POINT M A STER IOOC_CREATE_MATMAS_10 S P O T S ES.SAPLMV01 1111

ENHANCEMENT-POINT M A STER ID0C_CREATE_MATHAS_11 S P O T S ES_SAPLMV01

1156 ENHANCEMENT-POINT E H P _ M A S T E R I D 0 C_CREATE_HATMA_02 S P O T S ES_SAPIMV01 1445 ENHANCEMENT.POINT M A STER IDOCJCREATE_MATHAS_04 S P O T S ES_SAPLMV01 1675 ENHANCEMENT.POINT M A STER 100C_CREATE_MATMAS_12 S P O T S ES_SAPLNV01 1687 ENHANCEMENT-POINT M A STER IDOC_CREATE_MATMAS_07 S P O T S ES_SAPIMV01 2 0 4 4 ENHANCEMENT.POINT M A STER IOOC_CREATE_MATMAS_05 S P O T S ES_SAPLMV01 2 0 4 6 ENHANCEMENT.POINT M A STER IOOC_CREATE_MATMAS_08 S P O T S ES_SAPLMV01 2 0 5 6 ENHANCEMENT.POINT M A STER 100C_CREATE_MATMAS_13 S P O T S ES.SAPLHV01 2 1 0 9 ENHANCEMENT.POINT M A STER 1 0 0 C C R E A T E _ M A T M A S _ 6 2 S P O T S ES_SAPLMV01

F ig u re 4 .5 3

F in d in g E x p licit En h an ce m e n ts

107

4

|

C h an g e s to ID o cs

C a llin g th e BAdl

T h e c o d e its e lf in d ic a te s th e ca llin g p o in t a n d th e n a m e o f th e c o rre ­ s p o n d i n g e n h a n c e m e n t p o i n t ( s e c F ig u r e 4 .5 4 ) . E n h a n c e m e n t p o i n t s a n d e n h a n c e m e n t se c tio n s d o n 't h a v e a s ig n a tu re fo r th e tra n s f e r o f data. T h a t m e a n s y o u c a n a c c e s s all v a r ia b l e s w i t h i n t h e e n h a n c e m e n t t h a t a re a v a il a b le a t t h i s l o c a t i o n in t h e c o d e o f t h e c a llin g p r o g r a m . F lo w ev er, t h i s a ls o m e a n s t h a t i t c a n b e c o m p l i c a t e d to d e t e r m i n e t h e n a m e s o f t h e r e s p e c t i v e v a r ia b l e s a n d w h i c h d a t a is a v a ila b le .

F u n c tio n B u ild e r: D is p la y M A S T E R ID O C _C R E A T E _ M A T M A S

s u n in wmn ^ isai F u n ctio n m o d u le

(1A S TE R ID 0C_CREATE_HATHAS

A ttributes

Im p o rt

Export

C h a n g in g

In s e rt

Active T a b le s

E x cep tio n s,

i m m r iai f ENHAMCEHENT-P01NT MASTER ID0C_CREATE_M ATHAS_62 SPOTS ES_SAPLHV81

F ig u re

4 .54

E n h a n c e m e n t in t h e S o u rc e C o d e

E n h a n ce m e n ts:

I f y o u n o w w a n t t o i m p l e m e n t a n e x p lic it e n h a n c e m e n t , y o u c a n ’t u s e t h e

a c tiv a tin g the

s t a n d a r d e d i t i n g f u n c t i o n . You h a v e t o i n f o r m t h e s y s t e m t h a t y o u d o n ’t

e d itin g fu n c tio n

w a n t t o e d i t t h e o r i g i n a l b u t i n s t e a d w a n t to e d i t y o u r o w n i m p l e m e n t a ­ t i o n . F ig u r e 4 . 5 5 s h o w s t h e i c o n t h a t y o u c a n u s e f o r t h i s p u r p o s e .

F u n c tio n B u ild e r: D is p la y M A S T E R ID O C _C R E A T E _ M A T M A S

Function m o d u le A ttributes

F ig u re

4.55

✓

MASTERIDOC_CREATE_HATHAS

Im p o rt

Export

C h a n g in g

Active T a b le s

Exceptions

A c tiv a tin g t h e E n h a n c e m e n t E d itin g F u n c tio n

Enhancement

A fter en a b lin g th e ed itin g o f e n h a n c e m e n ts , y o u c a n s e t th e m o u s e p o in te r

fu n c tio n s

to " e n h a n c e m e n t " in t h e c o d e a n d o p e n t h e c o n t e x t m e n u b y r ig h t-c lic k ­ in g o n it. N o w , y o u c a n c r e a te , c h a n g e , o r u n d o i m p l e m e n t a t i o n s u s in g t h e E n h a n c e m e n t I m p l e m e n t a t i o n m e n u i t e m (s e e F ig u re 4 .5 6 ). F o llo w th e

En

h a n c e m e n t

Im

p l e m e n t a t io n

• C

reate

m e n u p a t h . B ecause

SAP a l s o i m p l e m e n t s e n h a n c e m e n t s p o t s , i t's p o s s i b l e t h a t t h e SAP n a m e s p a c e a lr e a d y d is p la y s i m p le m e n t a t i o n s (F ig u re 4 .5 7 ). F o r th e

10 8

A d a p tin g E x istin g ID o c T yp e s

n a m e s o f t h e i m p l e m e n t a t i o n s , t h e r u l e t h a t t h e y m u s t b e g i n w i t h “Z," "Y," o r t h e c u s t o m e r n a m e s p a c e a p p l i e s a g a in .

UIUities(M )

E n viro n m en t

S y ste m

H e lp

a 08 F u n c tio n B u ild e r: C h a n g e E n h a n c e m e n ts M A S T E R ID O C _C R E A TE _M A TM A S

Function m o d u le ________ A ttributes

0

&

H II3 G i

MASTER I OOC_CREATE_MAThAS

Im p o rt

Export

CO

C h a n g in g

P

l S

Pattern

Pretty Printer

Function M odule D o cum entation

| Active T a b le s

Exceptions

"lal

• D i s t r i b u t e IOOC ENHANCEMENT-POINT MASTERIDOCi ■ S ’ S - S t a r t : MASTERIDOC_CREAT| ENHANCEMENT 2 5 MGVJJENERATE; ’ {A LE B e g in } g e n e r a t i o n h t t p ■Do n o t c h a n g e c o d in g b e t » e d CALL FUNCTION 'M6 V_ALE_ADD_E| TABLES id o c _ d a ta = T _ID O q CHANGIN6 id o c _ h e a d e r = FJD O d

G o to line N e x t id e n tic a l structure level P rev io u s identical structure level

h13

BlocW Butfer

‘ {A LE E n d } g e n e r a t i o n ENDENHANCEMENT. •S * $ -E n d : MASTERIDOC_CREAT CALL FUNCTION ’ MASTER_IDOC; EXPORT IN 6

F ig u re

4.56

E n h a n ce m e n t Im p le m e n ta tio n (C o n te x t M e n u )

■ —

/SAPHT/DRM_LOTMGMT_SAPLMV01

’ aCk /SAPHT/DRM_LOTMGMT

/NFM /C A.SA PLM VG 1

/N FM /C A

/SAPMP/MATMASTER_DRUM_SAPLMVG1 /SAPMP/MATMASTER.DRUH DIMP_GENERAL_SAPLMV01

OIM P.GENERAL

ISM .SAPLM VOI

JM DG EH J10D IF

«IM I

□

U s e th is e n h a n c e m e n t im p le m e n ta tio n w ith o u t query in future

* ll*

0

E n h a n c e m e n t Im p lem en tatio n

ZSM1

S h o rt Text

ZSM1

C o m p o s ite E n h a n c e m e n t Im p lem en tatio n

F ig u re 4-57

1

C re a tin g a n Im p le m e n ta tio n

10 9

/

|

4-2

4

|

C h an g e s to ID o cs

BAdi

E n t e r t h e n a m e ( h e r e : " Z S M 1 " ) in t h e E n h a n c e m e n t I m p l e m e n t a t i o n

implementation

fic ld a s w e l l a s a d e s c r i p t i o n in t h e S h o r t T e x t fie ld , a n d c o n f i r m y o u r in p u t. A fte r th e im p le m e n ta tio n has b e e n created , y o u ca n e n t e r code w i t h i n a d e f i n e d a r e a (F ig u re 4 .5 8 ) .

F u n c tio n B uild er: E n h a n c e m e n t ZSM2 C h a n g e MASTERIDOC_CREATE_MATMAS *

n

y

•

F u n c tio n m o d u le

L

.

a

N A STER ID O C_C R EA TE_M A TH A S

At t r i b u t e s

i _

a

m

im o o rt

I

I

ENHANCEMENT 3 7

E x o o rt

: s a l ZSN2

C h a n a in a

l a i ’ a c tiv e

v e r s io n

®

S

P a tte rn

Ac tiv e T a b le s

F x c e s i '.m n s

■ ■

P ie tty P n n :e r

F u n c tio n M o d u le D o c u m e n ta tio n

b re a k a a is e ls a ENOENHANCEHENT

F ig u re 4 -5 8

im p le m e n ta tio n code

E d itin g a n E n h a n c e m e n t Im p le m e n ta tio n

B e a r in m i n d t h a t t h e a c t i v a t i o n i c o n s h o w n h e r e o n l y a c tiv a te s y o u r p a rt 0 f thc

coc| c> x h e b re a k p o in t, w h i c h w a s e n t e r e d a s t h e o n l y c o m m a n d in

t h e e x a m p l e , h e l p s y o u d e t e r m i n e w h i c h v a r ia b l e s a r e a v a il a b le , b u t it s h o u ld alw a y s be re m o v e d o r re p la ced b y th e d esire d p ro g ra m b e h a v io r a s s o o n a s p o s s i b le .

N e w B A d ls as o f SAP ERP 6 .0 w it h Basis 7.0 T h e b e n e f i t o f n e w B A d ls, w h i c h h a v e b e e n p r o v i d e d s i n c e SA P ERP 6 .0 , is t h a t t h e y h a v e a h i g h e r p e r f o r m a n c e t h a n c lassic B A dls a n d t h a t t h e y a r e c o n n e c t e d t o e n h a n c e m e n t s p o t s . T h e i r s t r u c t u r e , h o w e v e r , is s o m e ­ w h a t d i f f e r e n t f r o m t h e s t r u c t u r e o f c la s s ic B A d ls. T h e r e a r e t w o o p t i o n s f o r u s i n g n e w B A d ls. T h e first o p t i o n w a s i l l u s t r a t e d i n t h e m a t e r i a l m a s ­ t e r e x a m p l e : A n e w B A d i w a s m a d e f r o m m i g r a t i n g a classic B A di. I n th is case, t h e c lassic B A di calls t h e n e w B A di d y n a m i c a ll y . You c a n n o l o n ­ g e r fin d t h e B A di n a m e b y b r o w s i n g t h e s o u r c e c o d e . T h e classic BAdi, h o w e v e r , i n d i c a t e s t h e n a m e o f t h e n e w BAdi n e x t t o B A d i M i g r a t e s to E n h a n c e m e n t S p o t (s e e F ig u r e 4 . 5 0 ) . C o n s i d e r i n g t h i s n e w n a m e , n a v i ­ g a t e t o T r a n s a c t i o n S E 1 9 t o i n i t i a t e t h e a c tu a l i m p l e m e n t a t i o n . im p le m e n tin g

T h e s e c o n d o p t i o n is t h a t t h e n e w B A di h a s a c tu a l ly b e e n c r e a t e d . You

BAdls

c a n fincj j t b y s e a r c h i n g f o r t h e GET*BADI c o m m a n d . T h e n e w BAdi is also

new

im p le m e n te d in T ran sactio n SE19, b u t th e n e x t screen s are c o n sid erab ly d i f f e r e n t f r o m t h e s c r e e n s o f t h e i m p l e m e n t a t i o n o f c lassic B A d ls. C o n -

110

A d a p tin g E x istin g ID o c T yp e s

|

s e q u e n t l y , a n e x a m p l e o f t h i s is a ls o p r o v i d e d n e x t . It's c ritic a l t h a t y o u s p e c if y t h e n a m e o f t h e e n h a n c e m e n t s p o t , a n d n o t t h e B AdI n a m e f o r n e w B A d ls (F ig u re 4 .5 9 ) .

BAdI B uilder: Initial S c r e e n f o r Im p le m e n ta tio n s

is

O i » . B

E d it im p le m e n ta tio n

® N e w BAdI E n h a n c e m e n t im p le m e n ta tio n

O C l a s s i c B A di I m p le m e n ta tio n

&

D is p la y

|

#

C hanoe

C r e a t e im p le m e n ta tio n

E nhancem ent Spot

O C l a s s i c B A di B A di N a m e

□

C r e a t e im p i

F ig u re

4.59

|

I n i t i a l S c r e e n o f t h e B A d i B u i l d e r ( T r a n s a c t i o n S E 1 9)

N e x t, e n t e r t h e n a m e o f t h e e n h a n c e m e n t i m p l e m e n t a t i o n in T ra n s a c ­

N a m e o f th e

t i o n SE19. T h is n a m e e n a b l e s y o u t o a lw a y s e a s ily fin d t h e e n h a n c e m e n t

im p le m e n ta tio n

in T ra n s a c tio n SE80, t h a t is, t h e d e v e l o p m e n t e n v i r o n m e n t . F ig u r e 4 .6 0 s h o w s t h a t c o m p o s i t e e n h a n c e m e n t i m p l e m e n t a t i o n s a r e a ls o p o s s ib le i f y o u w a n t to c o m b i n e in d iv id u a l o b je c ts . You c a n t h e n t r a n s p o r t o r e n a b l e t h e s e c o m p o s i t e e n h a n c e m e n t s t o g e t h e r in SAP's s w i t c h f r a m e w o r k . You w o u l d c o m b i n e i t e m s t h a t a r e lo c a te d in d i f f e r e n t SAP e n h a n c e m e n t s b u t b e l o n g to o n e c u s t o m e r d e v e l o p m e n t . T h e y a r c so le ly c lassification item s.

0

C r e a t e E n h a n c e m e n t Im p le m e n ta tio n

E n h a n c e m e n t I m p le m e n ta tio n

Z S M _E N H 1

S h o rt T ext

S a b i n e s ID o c E n h a n c e m e n t

C o m p o s ite E n h a n c e m e n t im p le m e n ta tio n

F ig u re 4 .6 0

A s sig n in g a N a m e to th e Im p le m e n ta tio n

©in

/

4 .2

4

|

C h an g e s to ID o cs

implementing class

F o r n e w B A dls, t o o , y o u m u s t first a s s ig n a n a m e to t h e e n h a n c e m e n t i m p l e m e n t a t i o n in T r a n s a c t i o n S E 1 9 . U s i n g t h i s n a m e , y o u c a n a ls o m o d ­ ify y o u r e n h a n c e m e n t s in t h i s t r a n s a c t i o n a t a l a t e r s t a g e ( h e r e : ZSM_ I D0C_IMPJ1ATMAS). You a l s o n e e d t h e s p e c if ic a t i o n f o r t h e i m p l e m e n t a ­ t i o n c la s s (ZCL_SM_IMP1), w h i c h s h o u l d c o r r e s p o n d t o t h e c lass n a m e r u le s i f p o s s i b l e (s e e F ig u r e 4 .6 1 ) .

^

■■ C r e a t e B A di I m p l e m e n t a t i o n s fo r E » is D n g BAdl D e fin itio n s

>Adl i m p l e m e n t a t i o n Z S M _ I0 0 C _ M P J 1 A T H A S

[im p le m e n ta tio n C la s s

B « a i D e fin itio n

|Z C l_S M _IM P 1

B A D I_H A TH A S_A IE_C R

Figure

Activating the implementation

[S h o rt T e il 3 O a t e n M a t m a s - l d o c O e im E r c e u g e n e i n e s l O O C s v e r a n d e r n

4 61 Name of the Implementing Class

T he n e x t screen n o w d isp lay s th e p ro p e rtie s o f y o u r n e w im p le m e n ta t jo n

(s e e

F ig u re

4 .6 2 ) .

I f e v e r y t h i n g is d o n e , y o u c a n e n a b l e it u s i n g

t h e I m p l e m e n t a t i o n Is A c ti v e c h e c k b o x . N e w B A d ls a ls o a l l o w y o u to first c o m p l e t e t h e d e v e l o p m e n t w o r k a n d t h e n e n s u r e t h a t t h e c o d e is executed.

E n h a n c e m e n t Im p le m e n ta tio n ZSM_ENH1 C h a n g e

s a iM M M M M M s iM S S n iM M M S E n h a n c e m e n t im p le m e n ta tio n

P ro p e r tie s

H is to ry

Z S H _E M H l in a c tiv e

T e c h n ic a l D e ta ils

r

E n h Im p le m e n ta tio n E le m e n ts

B a d l im p le m e n ta tio n 0 B A d l I m p le m e n ta tio n s I'

±

| D e s c rip tio n

|

Z S M _ iD O C _ IM P _ M A T > i m p i e m e n t a t i c

D e s c n p tio n

Z S n _ IO O C _ lH P _ H A T H A S

□

D e f a u lt im p le m e n ta tio n

□

E x a m p le Im p le m e n ta tio n

□

' A c t * ' n o t s w i t c h a b l e t h r o u g h C u s t o m (IM G )

R u n tim e B e h a v io r K

|[3

D o c u m e n ta tio n

7~

i m p l e m e n t a t i o n i s a c tiv e

E f f e c t i n C u r r e n t C li e n t

Im p le m e n ta tio n

is

c a lle d

P r o p e r t i e s o f B A d i D e fin itio n

1

C l

*1 * 1

1

1 «

Figure

112

*1

|

___ I m p l e m e n t a t i o n D a t e n M a t m a s - l d o c B e i m E r z e u g e n e r n e s i D O C s v e r a n d e i

B A d l D e f in itio n N a m e

B A Q j H A IH A $ A U

D e s c n p tio n

D a te n M a tm a s - ld o c b e im E r c e u g e n e r n e s iD O C s v e r a n d e r n

in te rf a c e

L r _ L ‘ —C J l11 n A i i i A ^ A L t 1 *

4 62 Properties of the Implementation

CR

A d a p tin g E x istin g ID o c T yp e s

|

4-2

To v i e w t h e i m p l e m e n t i n g class, d o u b l e - c l i c k o n I m p l e m e n t i n g C lass

M a in ta in in g the

(o n t h e l e ft in F ig u r e 4 . 6 3 ) . O n t h e r i g h t , t h e s y s t e m t h e n d i s p l a y s t h e

i m p l e m e n t i n g c la ss

i m p l e m e n t i n g m e t h o d t h a t is c o p i e d b y t h e BAdI i n t e r f a c e ( h e r e : IF _ EX_BADI_MATMAS_ALE_C R~CHANGE_MATMAS). C lic k in g t h e c h a n g e ic o n (p e n ) ta k e s y o u to t h e v i e w o f y o u r class.

E n h a n c e m e n t Im p le m e n ta tio n ZSM_ENH1 C h a n g e

H S IB S IH II0 D 1

-r A

E n h a r ^ ^ ^ n t Im p le m e n ta tio n

P ro p e rtie s

B B

ZSH_ENH1

H isto ry

T ec h n ic a l D e t a i l s ^

inaclive

E n h . im p le m e n ta tio n E le m e n ts

Im p le m e n tin g C la s s E ^ B A d l Im p le m e n ta tio n s ^

*

| D e s c rip tio n "|

Z S M J D O C J M P _ M A T » Im p iem en talic ©

im p le m e n tin g C las

in te rlace

IF £X BAPI

HAW S

4.63

CR

S h o rt descnption

M ethod el O i F _ E X _B A D I_ M A T M A S _ A L E _ C R 'C H A N G E _ M A T M A S

F ig u re

ale

Im p le m e n tin g C la s s

B a s e M ethod

N a v i g a t i o n t o t h e I m p l e m e n t i n g Class

N e w B A d ls e n a b l e t h e d e v e l o p e r o f t h e BAdI

10 p r o v i d e a s a m p l e class.

T h i s w a y , h e c a n e a s il y i n d i c a t e t h e i n t e n d e d u s a g e o p t i o n s f o r his BAdI.

S a m p l e c la s s f o r n e w B A d ls

T h i s f u n c t i o n is o p t i o n a l ; t h a t is, i t i s n 't p r o v i d e d b y all B A d ls. To illu s­ tr a t e t h i s f u n c t i o n , t h e e x a m p l e in F ig u r e 4 . 6 4 d i s p l a y s t h e c o r r e s p o n d ­ i n g s c r e e n s h o t o f a d i f f e r e n t BAdI. T h e fig u re s h o w s t h e r e s p e c t i v e q u e r y as w e l l a s t h e a v a il a b le o p t i o n s . You c a n b a s ic a lly d e c i d e i f y o u w a n t to u s e a n e m p t y class, u s e t h e s a m p l e c lass a s a t e m p l a t e , o r h a v e a class i n h e r i t f r o m t h e s a m p l e class. T h e b e n e f i t o f h a v i n g y o u r BAdI i n h e r i t f r o m t h e s a m p l e c lass is t h a t y o u ’re a u t o m a t i c a l l y p r o v i d e d w i t h p o t e n ­ tial c h a n g e s i n r e c e n t re le a s e s . W h e t h e r y o u q u e r y t h e s a m p l e m e t h o d o r n o t — t h e n e x t s t e p a lw a y s

S a m p le m e t h o d for

ta k e s y o u t o t h e c lass m a i n t e n a n c e ( s e e F ig u r e 4 . 6 5 ) f r o m w h e r e y o u can

n e w B A d ls

n a v i g a t e to t h e s o u r c e c o d e o f y o u r m e t h o d b y d o u b l e - c l i c k i n g o n th e m e t h o d i n t h e M e t h o d s tab.

11 3

4

|

C h an g e s to ID o cs

0/

C r e a te Im p le m e im p le m e n ta tio n e x a m p le c la s s e s a lre a d y exist Y o u have the follow ing options: C re a te a n e w e m p ty c la s s C opy o n e o f th e e x a m p le c la s s e s nh e rrt fro m a n e x a m p le c la s s no t d e c la re d a s "tin a f

im p le m e n ta tio n E x a m p le C la s s e s C la s s

Origin

CL_0NU 7AW _B AD I_IM PL_EXA HPLE

:mal

BAdI O e f.

j

viame B A d! E x a a p le

□

l a p le n e n t a t lo n C la s s

Q S □ E 0


i £

E m p ty C la s s

F ig u re

4 64

□

C o p y S a m p le C l a s s J I D

inherit fro m S a m p le C l a s s J X

O p tio n a l S a m p le M e t h o d

C la s s B u ild e r : C h a n g e C la s s Z C L _ S M _ IM P 1

0 E H I S H E I I S U B ® I I S I S □ H D I M .L o c a l T y p e s C la s s in te rfa c e P ro p e rtie s

□ P a ra m e te rs !»

Z C L _ S M _ IH P 1 In te rfa c e s

Fnends

E v e n ts

E x c e p t io n s p jjj] l B | ^ | « ^ | [ B j B | l X W |L e v e l

IF_EX_BADI_M ATM AS_ALE_CR~CHANGE_HATNAS

4.65

IE

M a c ro s ^

□

C o n s tru c to r

Im p le m e n te d / Inactive A ttributes

M eth o d

F ig u re

Im p le m e n la lio n

In s t a n c e

Typ es

I f f l [M |M [vis ib ility | m

N e t r P u b l 1c

F T

A lia s e s

□

Filter

|D e s c rip tio n B a s e M eth o d

N a v i g a t i o n t o t h e I m p l e m e n t i n g Class

Class and method

F ig u re 4 . 6 6 d i s p l a y s a fie ld in w h i c h y o u c a n e n t e r y o u r s o u r c e c o d e , t h a t

maintenance

jS( t h e c o m p l e t e f u n c t i o n s , f o r e x a m p l e , to p o p u l a t e t h e c u s t o m s e g m e n t (in o u r e x a m p l e , o n l y a c o m m e n t , * Your Implementation, w a s i n s e r t e d f o r t h e s a k e o f clarity).

114

A d a p tin g E x istin g ID o c T yp e s

|

4 .2

C la s s B u ild e r: C la s s Z C L _ S M _IM P 1 C h a n g e

M eth o d r

r

i

B

I F E X 8 A D I HATMAS ALE CR-CHAN6 E HATHAS i

5 >

i

m

r

m

'

i

i

a

a

i

________________________________________________________

■ e t h o d IF _ E X _ B A D 1_MATHAS_ALE_CR-CHANSE_HATHAS •

Y our

In p le n e n ta tio n

.

e n d n e th o d .

F ig u re

4.66

Im p le m e n tin g th e B A d l M e th o d

I m p lic it E n h a nce m e n ts as o f SAP ERP 6 .0 w it h Basis 7.0 In a d d i t i o n to t h e e n h a n c e m e n t s d e s c r i b e d s o far, t h e n e w e n h a n c e m e n t o p t i o n s a l s o i n c l u d e im p lic it en h a n c em e n ts. T h e s e a r e e n h a n c e m e n t s t h a t a r e n ' t p r e d e f i n e d b y t h e SA P d e v e l o p e r . I n s t e a d , t h e y a r e a v a il a b le a t sp ec ific l o c a t i o n s in all p r o g r a m s t h a t a r e n ' t p a r t o f t h e a c tu a l SAP Basis. F o r f u n c t i o n m o d u l e s a n d i n c l u d e s a s t h e y a r e p r o v i d e d in I D o c p r o c e s s ­ in g, t h e s e a r e t h e f o l l o w i n g lo c a tio n s : ► A t t h e e n d o f a n i n c l u d e ( r e p o r t s a r e c o n s i d e r e d i n c l u d e s as w e ll) ► In th e s ig n a tu re o f fu n c tio n m o d u le s ► At th e e n d o f s tru c tu re ty p e d e fin itio n s (b e fo re

end

o f)

► At th e b eg in n in g a n d e n d o f form s T h e r e a r e s o m e m o r e l o c a t i o n s , p a r t i c u l a r l y in t h e c o n t e x t o f c lasse s, b u t th e y a r e n 't re le v a n t for ID oc processing. I m p l i c i t e n h a n c e m e n t s a r e a v a i l a b l e in e v e r y p r o g r a m a n d a r e h i d d e n

D is p la y in g im p lic it

a t firs t. O n l y i f y o u i n f o r m t h e s y s t e m t h a t y o u w a n t t o u s e i m p l i c i t

e n h a n c e m e n ts

e n h a n c e m e n ts d o e s th e sy stem d isp lay th e e n h a n c e m e n ts s o th a t y o u c a n e d i t t h e m . F irs t, c lick t h e e n h a n c e m e n t ic o n n o w o p e n s (s e e F ig u r e 4 .6 7 ) , f o l l o w t h e t io n s

• Snow

Im

p l ic it

En

h a n c e m e n t

O

Ed

it

p t io n s

HI. In

• En

th e sc re e n that

h a n c e m e n t

O

pera

­

m e n u p a t h to d i s p l a y th e

im p licit e n h a n c e m e n ts .

115

4

|

C h an g e s to ID o cs

P ro g ra m

E d it

G o to

U tilities(M )

E n v iro n m e n t

S y s te m ©

P a ttern A B A P E

* eport I

a o a i »

C tr l* F 6

C lip b o a rd

»

F in d /R e p la c e

C trl*F

F in d N e x t

C trl*G

m e n ts

fo r R B D M ID O C

n h a n c e m e n ts

®

a° Q g

3

C!h G l

P a ttern

Pretty Prin ter |

Active I

I

■

F0

to rt

H e lp

M ore functio ns

*

M odification O p e ra tio n s

•

E n h a n c e m e n t O p e ra tio n s

•

T4ne1

d a ta :

Da

d a ta

end o f t_ h e lp _ v a lu e .

d a ta

b e q in o f v a l u e s

C ancel

Ft 2

C re a te Undo R e p la c e

o c c u rs 0 .

s tr in .

C hange S h o w im p lic it E n h a n c e m e n t O p tio n s

t

h e l p . v a l u e - t a O n a n e = , E D IH S G \ h e l p . v a l u e - f i e l d n a n e = 'N E S T Y P '.

F ig u re 4 -6 7

H id e Im p licit E n h a n c e m e n t O p tio n s

D is p la y in g I m p li c it E n h a n c e m e n ts

Im p lic it

T he p ro g ra m te x t t h e n d isp lay s a d d itio n a l lin es th a t c o n sist o f q u o ta tio n

e n h a n c e m e n ts

m a r k s a n d n a m e s . T h e s e a r c t h e i m p l i c i t e n h a n c e m e n t s . B e c a u s e t h e y a rc

in th e "R B D M ID O C " report

a v a ila b le i n all p r o g r a m s , y o u n e e d to g e n e r a t e t h e i r n a m e s . T h e i r n a m e s a lw a y s c o n s i s t o f a s e q u e n t i a l n u m b e r a n d a d e s c r i p t i o n t h a t i n d i c a t e s t h e l o c a t i o n t o w h i c h t h e y b e l o n g (e .g ., a t t h e e n d o f a f o r m ) . F ig u re 4 .6 8 d isp la y s im p licit e n h a n c e m e n t b o th a t th e b e g in n in g a n d e n d o f a f o r m a n d i n a d a t a s t a t e m e n t a s w e ll as a t t h e e n d o f t h e i n c l u d e (th e RBDMI DOC

r e p o r t h e r e ) . T h is is i n d i c a t e d b y q u o t a t i o n m a r k s , w h i c h r u n

a c r o s s t h e e n t i r e lin e. Im p le m e n tin g

A n im p li c i t e n h a n c e m e n t is i m p l e m e n t e d in t h e s a m e w a y a s a n e x p lic it

an im p lic it

e n h a n c e m e n t. A n im p le m e n ta tio n th a t h a s a lre ad y b e e n c arried o u t

enhancem ent

r e m a i n s v i s i b le ( s e e F ig u r e 4 . 6 9 ) e v e n i f t h e d i s p l a y o f i m p l i c i t e n h a n c e ­ m e n t s is d i s a b l e d a g a in , f o r e x a m p l e , a f t e r T r a n s a c t i o n S E 3 8 h a s b e e n r e c a lle d .

116

A d a p tin g E x istin g ID o c T yp e s

|

4-2

A B A P E d it o r : C h a n g e E n h a n c e m e n ts f o r R B D M ID O C

«•»>»*»»ISB| gqiy &*>»ftMiw>M«iWR^iBB33nPlllBW|p«B»»"lF^ SSWIOOC

I I I

I I Ml

‘jlrrt

I

la i

M h « ip _ ft> n a a e _ c r*< « t a e ie s t t M a e

ctta

s tru c tu re to o **

oe o l n o ' t_r>elp_valu8 o cc u r s 6 i nc l u a e st ru c t u r e ne l p vain*

H U

o i d o f t _ h * lp _ v a lu e

n il

B e g in o f - i l u H

o c c u rs

0,

s t r ir > g ( K • n o of values

, -C D iH S C * » w i o m > * C D I « $ 6 - i « t »p t _ r « i p _ v a i u e - f i e i ^ w » . ‘H f $ T Y P ‘ > > ■ “ ‘X' t o t _ h * i p _ « a i u « s * l e c t f l a a a p p e n d t.help.value t (i«lp _ v al u o •t • ’E D I " 6 6 1 ' • field tit l e EO t f t S S T K S C S P t . f e l p . v a l u e - f l e l d r i M e ■ -DESCfiP’ B O V * ’ • to t_hBlp_ue l o o p a t t_tt>0 »e ■ove t.tooae-aestip t o values jppeno values d e a r ediasgt S « 1 « C t Slnflle ’ f r e * « d 1 » 4 9 t Bh#re «est«p • t _ t b d a e » e s t » p *<> largua • sy-1»njj iovo e dl as s t - o e s c r p t o valuBS appond valuBS

c a ll

f u n c t io n -M U P _ v « lJ £ S _ 0 (T _ y |T M _ T > & r l a p o r t in B sel*ct_v»lu* : aestyp tallies fields • t_nelp_value v a luetafc • values

F ig u re

4.68

I m p lic it E n h a n c e m e n ts in t h e " R B D M I D O C " R e p o rt

ABAP E dito r: Change E nhancem ent ZS M 1 _IMPL_ERW f ^ l R I I f y | [ Acttve« - » Inactive | f c j | 1 [ f l l | # Report

E n h a n c e m e n tT H j ] ^ ] 1 E j ] [ j £

RBDHIOOC

□

© I ®

Pattern

A c tr*

FORM F4HELP_FBNAME_CHECK fo r a f4 h e ip _ fb n a a e _ c h e c k t a b l e s t _ t b d a e s t r u c t u r e tb d » e

d a t a : b e g in o f t _ h e l p _ v a l u e o c c u rs 0 I n c lu d e s t r u c t u r e h e lp _ v a lu e • S ' J - S t a r t : ( 2 ) ................................................................................................ ENHANCEMENT 1 ZSM1_IHPL_ERW ‘ a c t i v e v e r s io n ■ I c a n add F i e l d s t o S t r u c t u r e t _ h e lp _ v a lu e s f r o > h ere ■ 8u t I h a v e t o u s e an a d d i t i o n a l DATA co««and O a ta : z s n v a lu e t y p e n a r a - e a t n r . ENDENHANCEMENT •S 'S -E n d ( 2 ) ................................................................................................ d a t a : end o f t _ h e l p _ v a i u e d a ta :

b e g in o f v a lu e s o c c u rs 0 . s t r 1 n g > 5 8 ) . en d o f v a lu e s

F ig u re

4-69

Im p le m e n te d Im p lic it E n h a ncem ent

T h e s a m p l e i m p l e m e n t a t i o n o f a n i m p li c i t e n h a n c e m e n t w a s d e l i b e r a t e l y

S p e cia l a s p e c ts o f

s e l e c t e d f o r a s t r u c t u r e d e f i n i t i o n h e r e . F o r im p li c i t e n h a n c e m e n t s , t h e

stru ctu re s

117

4

|

C h an g e s to ID o cs

o r i g i n a l SAP c o d e a n d y o u r e n h a n c e m e n t c o d e a r e a v a il a b le a s sp ec ific p r o g r a m m i n g o b j e c t s a n d m u s t a ls o b e v a l i d a n d c a n b e a c ti v a te d a s s p e ­ cific p r o g r a m m i n g o b j e c t s . T h e r u n t i m e e n v i r o n m e n t d o e s n ’t i n s e r t t h e m at th e a p p r o p ria te lo c atio n u n til th e m a in p ro g ra m h a s b e e n ex e cu te d . B e c a u s e o f th is , t h e i m p l e m e n t a t i o n r e q u i r e s a s e c o n d D ata s t a t e m e n t . E n h a n c e m e n t in

You c a n v i e w all e n h a n c e m e n t s t h a t b e l o n g t o t h e n e w e n h a n c e m e n t t e c h ­

th e ru n tim e

n o l o g y in T r a n s a c t i o n S E 8 0 . F ig u r e 4 . 7 0 d i s p l a y s o u r i m p l i c i t e n h a n c e ­

e n v iro n m e n t

m e n t , ZSM1_IMPL_ERW, w i t h r e f e r e n c e t o t h e r e p o r t n a m e o r t h e i n c l u d e n a m e in t h e P r o g r a m c o l u m n a n d t h e l o c a t i o n o f t h e e n h a n c e m e n t s in t h e c o d e ( in t h e E n h a n c e m e n t P o i n t / S e c t i o n c o l u m n ) . S ta tic e n h a n c e m e n t s r e f e r t o c o d e f o r t h e d a t a d e c l a r a t i o n ; all o t h e r e n h a n c e m e n t s a r e d yn a m ic.

E n h a n c e m e n t I m p le m e n t a t io n Z S M 1 D i s p l a y

> < y

•

K-

o u 2811

€

11*1 Ettl

A\m '« w U K (*

EWOWIN

|B jE r "y<«fr «nsco(i P o j r i m neoncoc

|o*rr-*fr Enh»r<«ni«nt P o f t


i C3 F ig u re 4 - 7 °

S p e cia l a s p e c ts o f ALE se rvices

E n h a n c e m e n t in T ra n s a c tio n SE80

Enhancements and ALE Services irre s p e c tiv e o f t h e te c h n o lo g y y o u im p le m e n t y o u r e n h a n c e m e n ts w it h , n o te t h a t t h i s is a l w a y s d o n e d u r i n g t h e g e n e r a t i o n o f t h e I D o c i n t h e o u t b o u n d p ro c e s s in g . In g e n e r a l, a ll A L E s e rv ic e s a r e n ’ t e x e c u te d

u n til th e

ID o c has

b e e n e n tire ly g e n e ra te d , in c lu d in g y o u r e n h a n c e m e n ts , so p o te n tia l filte r­ i n g p r o c e s s e s o r c h a n g e s a r e n ’t i m p l e m e n t e d u n t i l y o u r e n h a n c e m e n t s h a v e b e e n c re a te d . T h e ID o c m a y s till c o n ta in v a rio u s p la n t s e g m e n ts d u r in g th e r u n tim e o f y o u r e x it e v e n i f th e s y s te m — d u e t o th e o b je c t filte rin g — g e n e r­ a te s o n l y o n e p la n t s e g m e n t o n t h e d a ta b a s e a t t h e e n d o f t h e I D o c c re a tio n . C o n s id e r th is w h e n im p l e m e n t i n g y o u r e x its .

118

A d a p tin g E x istin g ID o c T yp e s

4 .2 . 2

|

4-2

G e n e ra l E x its

S o m e o p e r a t i o n s a r e h a n d l e d in t h e s a m e w a y f o r m o s t o f t h e ID o c s . T h i s a ls o a p p l i e s to t h e v e r s i o n c o n v e r s i o n , w h i c h c a n b e c o n f i g u r e d in T r a n s a c t i o n W E 2 0 . F o r m a s t e r d a t a ID o c s , t h e s e o p e r a t i o n s a l s o i n c l u d e th e w ritin g o f c h a n g e p o in te rs . T h e n e x t sec tio n in tro d u c e s th e e n h a n c e ­ m e n t o b j e c t s t h a t SAP p r o v i d e s f o r t h i s p u r p o s e .

V ersio n C onversion D e p e n d i n g o n t h e r e l e a s e o f t h e SAP s y s t e m , t h e r e c a n b e a s p e c if ic v e r ­

" A L E 0 0 0 0 1 " SAP

s i o n f o r e a c h s e g m e n t . F o r t h e c o m m u n i c a t i o n w i t h p r e v i o u s re le a s e s,

enhancem ent

it m a y b e n e c e ssa ry to g e n e ra te th e s e g m e n ts w ith a re le ase v e rs io n th at y o u c a n f r e e l y d e f i n e in T r a n s a c t i o n W E 2 0 (s e e a ls o S e c t i o n 4 . 1 . 6 , V e r­ s i o n C o n v e r s i o n ) . T h i s c a n b e d o n e w i t h o u t a n y d e v e l o p m e n t w o r k . In a d d i t i o n , h o w e v e r , SA P p r o v i d e s a n S A P e n h a n c e m e n t in T r a n s a c t i o n S M O D t o e n a b l e c u s t o m e r s t o i m p l e m e n t t h e i r o w n f u n c ti o n a li t y . The

EX I T _ S A P L B D 1 1 _ 0 0 1

e x i t in t h e

ALE00001

e n h a n c e m e n t is c o n t i n u ­

o u s l y e x e c u t e d e v e n i f n o v e r s i o n c o n v e r s i o n is s p e c if ie d i n T r a n s a c t i o n W E 2 0 . It's o n e o f t h e f e w e x i t s t h a t a ls o d e l i v e r h e a d e r a n d s t a t u s d a t a o f t h e ID o c a n d c a n b e c h a n g e d i f r e q u i r e d . T h e c u s t o m e r i n c l u d e i n w h i c h y o u i n s e r t y o u r c o d e is c a ll e d

Z XS BD U 01

a n d is a n e x i t i n a n SAP e n h a n c e ­

m e n t . T h e s a m p l e c o d e s h o w s h o w y o u c a n d e t e r m i n e t h e c u s t o m e r ID in t h e SAP s y s t e m f r o m t h e ILN ( I n t e r n a t i o n a l L o c a t io n N u m b e r ) in t h e I D o c (s e e L is tin g 4.1 ). I n g e n e r a l, th is e x i t c a n b e e x e c u t e d in t h e i n b o u n d a n d o u t b o u n d p ro c e s s ­ ing , w h i c h m e a n s y o u h a v e t o d e f i n e t h e d i r e c t i o n o f t h e c o m m u n i c a t i o n first. In t h e n e x t s t e p , y o u c a n m a k e t h e r e q u i r e d c h a n g e s ( t o t h e c o n t r o l r e c o r d o r t h e ID o c data). Finally, y o u m u s t c h a n g e t h e f o l l o w i n g fields: ►

id o c _ c o n tr o l_ o u t- id o c tp

►

id o c _ c o n tr o l_ o u t- u p d d a t

►

id o c _ c o n tro l_ o u t-u p d tim

R e tu rn changes

T h e p r o g r a m t h a t c a lls t h e e x i t c h e c k s w h e t h e r t h e s e fie ld h a v e b e e n c h a n g ed . O n ly th e n d o e s th e sy stem c o p y the o th er, p o te n tia lly ch a n g ed v alu es fro m th e

id o c _ c o n tro l_ o u t

t h e fields; t h a t is,

IDOCTP

s t r u c t u r e . It's s u ffic ie n t h e r e to a d d r e s s

e n a b l e s y o u t o c o p y t h e in itia l v a l u e , w h i c h is

u su ally d esired . 119

4

|

C h an g e s to ID o cs

S a m p le c o d e

* & ..............................................................................................................................................................................* *&

Z X S B D U 01

In c lu d e

*&............................................................................................................................................ * *

Check

check *

I f

w h e th e r

ID o c

is

re c e iv e d ,

id o c _ c o n tr o l_ in -d ir e c t yes,

check

w h ic h

ID o c

and

o th e rw is e

do

n o th in g !

*2 '.

eq

change

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

*

Local

v a ria b le s

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * d a ta :

wa_kunnr

DATA:

w a _ id o c _ d a ta

DATA:

w a _ e le d k a l

ty p e

e le d k a l

.

DATA:

w a _ e le d k l4

ty p e

e le d k l4

.

d a ta :

w a _ v k o rg

DATA:

XBBBNR

L IK E K N A 1 -B B B N R .

DATA:

XBBSNR

L IK E K N A 1 -B B S N R .

DATA:

m essage

k n a l-k u n n r ty p e

ty p e

XBUBKZ L IK E

Check case

ty p e

e d id d

tv k o -v k o rg .

K N A 1 -B U B K Z

.

ty p e

id o c _ c o n tro l_ in -s td m e s

when

. .

'O R D E R S ’

.

.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

*

F ill

vendor

num ber

and

c u s to m e r

num ber

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

F ill

v a lu e s lo o p

a t

w h e re

id o c _ d a ta

in to

segnam

‘ E1EDKA1’

w a _ E lE D K A l i f

eq

-

.

w a _ id o c _ d a ta -S D A T A

w a _ e le d k a l-p a rtn

is

in itia l

. .

“

XBBBNR -

w a _ E lE D K A l- 1LNNR+0( 7 )

.

XBBSNR =

w a _ E lE D K A l-IL N N R + 7 (5 )

.

w a _ E lE D K A l- 1 L N N R + 1 2 (1 )

XBUBKZ

-

CHECK:

NO T

CHECK:

XBBBNR

SELECT

kunnr

WHERE

E X IT

IF

XBBBNR

BBBNR

NE

IS

IN IT IA L

SPACE

FROM

KNA1

wa_kunnr

EO X B B B N R BBSNR

EQ X B BS N R

AND

UBKZ

EO X B U B K Z

.

w a_kunnr

.

.

S Y -S U B R C

-

0

. =

.

. in to

AND

w a _ e le d k a l-p a rtn

O n ly

.

.

ENDSELECT

12 0

w a _ id o c _ d a ta

i f

i t

is

m is s in g

A d a p tin g E x istin g ID o c T yp e s

|

4-2

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

*

R e tu rn

d a ta

to

ID o c

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

R e tu rn

to

ID o c w a _ id o c _ d a ta -s d a ta m o d ify

e n d if e n d if

.

e n d lo o p

.

when *

id o c _ d a ta

when

you

o th e rs

endcase

w a _ e le d k a l

fro m

.

w a _ id o c _ d a ta

.

.

•A N Y O T H E R T Y P E ’

W h a te v e r

=

want

.

to

do

w ith

th is

m essage

ty p e ,

.

.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

*

Change a re

c o n tro l

im p le m e n te d

th is

a p p lie s

to

re c o rd a fte r a ll

so th e

th a t

th e

changes

e x it:

changed

s e g m e n ts

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * m ove

id o c _ c o n tro l_ in

to

id o c _ c o n tr o l_ o u t

.

id o c _ c o n tr o l_ o u t- ID O C T P

-

id o c _ c o n tro l_ in -ID O C T P

id o c _ c o n tr o l_ o u t- u p d d a t

=

s y -d a tu m

.

id o c _ c o n tro l_ o u t-u p d tim

-

s y - u z e it

.

L is tin g

4.1

.

S a m p le C o d e f o r t h e " A L E 0 0 0 0 1 " E n h a n c e m e n t

B A d l f o r th e G e n e ra tio n o f C hange P o in te rs A s d e s c r i b e d in C h a p t e r 2 , S e c t i o n 2 . 1 . 1 , S h a r e d M a s t e r D a t a Tool, c h a n g e p o i n t e r s a r e g e n e r a t e d in t h e C H A N G E _ P O I N T E R S _ C R E A T E _ D I REC T

C H A N G E _P O IN T E R S _ C R E A T E _ L O N G

or

f u n c t i o n m o d u l e . SAP a l s o p r o v i d e s an

e x i t — a c lassic BAdl — f o r t h e g e n e r a t i o n o f c h a n g e p o i n t e r s . T h e e x it h a s o n l y b e e n a v a ila b le a s o f SAP N e t W e a v e r 6 . 2 0 . The

B D C P _ B E F O R E _ W R IT E

BAdl is a f i l t e r - d e p e n d e n t BAdl w i t h t h e m e s s a g e

t y p e a s t h e filter. T h e p r e r e q u i s i t e s f o r u s i n g t h i s e x it a re t h a t c h a n g e p o i n t e rs a r e g e n e r a l l y e n a b le d , t h a t t h e y a r e e n a b l e d f o r t h e c o r r e s p o n d i n g m e s ­ s a g e ty p e , a n d t h a t t h e fields t h a t a r e s u p p o s e d to b e r e le v a n t t o t h e c h a n g es a re m a i n t a i n e d f o r t h e m e s s a g e ty p e . In t h e s t a n d a r d v e r s io n , t h e s e s e ttin g s e n a b l e t h e SAP s y s t e m to c r e a t e all r e q u i r e d c h a n g e p o i n t e r s . T h e BAdl is t h e n calle d b e f o r e it c r e a te s t h e c h a n g e p o i n t e r s o n t h e d a t a b a s e a n d allow s f o r m o r e r e s tr ic tio n s o n t h e g e n e r a t i o n o f c h a n g e p o i n t e r s th a n t h e C u s­ t o m iz in g s e ttin g s . T h e BAdl c o n t a i n s s a m p l e c o d e f o r t w o cases:

12 1

"BDCP_BEFORE_ w r i t e " BAdl

4

|

C h an g e s to ID o cs

► T h e s y s t e m w ill w r i t e c h a n g e p o i n t e r s f o r p a r t i c u l a r m a t e r i a l s o n ly . ► T h e s y s t e m w ill w r i t e c h a n g e p o i n t e r s f o r p a r t i c u l a r u s e r s o n ly . I f y o u w a n t to u s e t h i s BAdI, y o u c a n c o p y t h e s a m p l e c o d e a n d a d a p t it t o y o u r r e q u i r e m e n t s . H e r e , y o u m u s t t a k e i n t o a c c o u n t s o m e sp ec ific a s p e c ts . " O B J E C T ID ” fie ld

F irst o f all, t h e s a m p l e c o d e p r o v i d e d b y SAP a s s u m e s t h a t t h e TID

OBJEC­

field c o n t a i n s t h e c l i e n t a t t h e b e g i n n i n g 3 d ig its . T h is i s n 't t h e case.

S o p l e a s e d o n ' t r e m o v e t h e t h r e e a d d i t i o n a l fie ld s f o r t h e c l i e n t in y o u r i m p l e m e n t a t i o n i f y o u w a n t to filte r b y o b j e c t IDs. " C P I D E N T " fie ld

In a d d itio n , th e h a v e in t h e

BDCP

CPIDENT

and

BDCPS

field d o e s n ' t c o n t a i n t h e n u m b e r t h a t it w ill t a b l e s a t a l a t e r s ta g e . I n s t e a d , it o n l y c o n t a i n s

a t e m p o r a r y n u m b e r u n t i l t h e s y s t e m a s s i g n s t h e a c tu a l n u m b e r d u r i n g th e u p d ate. In s e rtin g d a ta

I n t h e e x i t h e l p , SAP s t a t e s t h a t y o u c a n a ls o i n s e r t c h a n g e p o i n t e r s ; t h e s a m p l e c o d e , in t u r n , s a y s t h a t y o u c a n ' t u s e t h e e x i t f o r t h i s p u r p o s e . T ec h n ically , h o w e v e r , y o u c a n i n s e r t t h e m , b u t y o u m u s t e n s u r e t h a t t h e tem p o ra ry

CPI DENT

field o f y o u r i n t e r n a l t a b l e c o n t a i n s s e q u e n t i a l n u m ­

b e r s w i t h o u t d u p l i c a t e v a l u e s ; o t h e r w i s e , t h e u p d a t e is c a n c e l e d . You s h o u ld b e careful w h e n in se rtin g ch a n g e p o in te rs . I f y o u w a n t to d e b u g y o u r e x it, u p d a t e d e b u g g i n g u s u a l l y n e e d s t o b e e n a b l e d . M o s t m a s t e r d a t a p o s t s its c h a n g e s u s i n g t h e u p d a t e t e c h n o l o g y o n t h e d a t a b a s e , so w r i t i n g c h a n g e p o i n t e r s a ls o t a k e s p l a c e d u r i n g u p d a t e p r o c e s s e s .

4 .2 .3

C u s to m S e g m e n ts

B o th w h e n e n h a n c i n g e x i s t i n g I D o c t y p e s a n d w h e n c r e a t i n g c u s t o m ID o c t y p e s , a p r e r e q u i s i t e is t h e g e n e r a t i o n o f s e g m e n t s t h a t c o n t a i n t h e a p p lic a tio n data. S uch a s e g m e n t can in c lu d e u p to 1 ,0 0 0 a lp h a n u m e ric c h a r a c t e r s . All i n f o r m a t i o n o n t h e g e n e r a t i o n o f c u s t o m s e g m e n t s is d i s ­ c u s s e d a g a i n in S e c t i o n 4 . 4 . 1 , C r e a t i n g C u s t o m ID ocs.

C re a tin g S eg m e n ts C u sto m e r

B e fo r e y o u c a n u s e c u s t o m s e g m e n t s , y o u u s u a l l y h a v e to m o d i f y t h e

se g m e n ts

b u s i n e s s d a t a . N o r m a ll y , y o u c a n e x p e c t t h a t t h i s h a s a l r e a d y b e e n d e v e l ­ o p e d b y y o u r co lleag u es fro m th e a p p lic a tio n d e p a r tm e n t. T h e fo llo w ­

12 2

A d a p tin g E x istin g ID o c T yp e s

|

i n g e x a m p l e , h o w e v e r , a ls o i n c l u d e s t h e d a t a in t h e m a t e r i a l m a s t e r t h a t w ill b e u s e d in t h e e n h a n c e m e n t . F ig u re 4 .7 1 s h o w s h o w y o u can a p p e n d a d d i t i o n a l c u s t o m e r - s p e c i f i c fie ld s to t a b l e s ( h e r e : m a r a ) u s in g t h e A p p e n d S t r u c t u r e b u t t o n ( o n t h e t o p r i g h t in t h e fig u re ) in T r a n s a c ­ ti o n S E 1 1 . F o r t h i s p u r p o s e , a s s ig n a n a p p e n d n a m e first, w h i c h m u s t b e w ith in th e c u s to m e r n a m e s p a c e (here: ZSM MARA).

Dictionary: Display Table

0 0 im m m i a s e im m n m i Transp Table

KARA

^Technical Settings ] | indexes

A p p e n d Structure

Active

S.

_

e iQ ia n i | Short tea

O bject Nam e

Status

ISH_MAPA_AP P

New

is - h m m

IST_MAT_FIELDS

New

IS-T: U ser-Specific Material M aster Fields

JPAMARA

New

OllM ARA

New

H o s p i^ S p e d fie Fields

| ISM Append to M flflA M edia-Specific Fields lS-OilA|pen«|

ZSHHARA

Append Nam e

reated the Obiect

0 ® han ged O biect o m ple te m aterial

F i g u r e 4-7 1

C r e a t i n g a n A p p e n d t o t h e " M A R A ” T a b le

In t h e n e x t s t e p , y o u c a n — a s s h o w n in F ig u re 4 . 7 2 — s p e c if y in t h e C o m p o n e n t s t a b w h i c h n e w fie ld s y o u w a n t to u s e . T h e n a m e s o f t h e s e fie ld s s h o u l d a ls o c o r r e s p o n d t o t h e c u s t o m e r n a m i n g r u l e s b e c a u s e p r o ­ g r a m s t r e a t t h e m a s fie ld s t h a t a r e d i r e c t l y i n c l u d e d in t h e m a r a t a b l e a n d b e c a u s e y o u c a n n e v e r b e s u r e w h i c h fie ld s SAP w ill a d d .

D ictionary: M aintain A ppend S tructure 4.

V

■■ £

A p pend Structure

ZSHHAPA

S h o rt D e scription

S a b in e s A p p e n d to HftPA

O

; H ie ra rc h y D is p la y Actwe

E n try h e lp /c h e c k

C u rre n c tfq u a n tity fields

t

/ 2

Short Description

ZSHFELD2

F ig u re

4.72

□

CHAR20

CHAP

20

□

C-HAILt1

CHAR

1 0 8 C h a ra c te r F le ld L e n g th = 1 0

0 C h a r 20

C u s t o m F ie ld s

12 3

S e g m e n t fie ld s

4 .2

4

|

C h an g e s to ID o c s

Custom segment

N o w y o u c a r r y o u t t h e first I D o c - r e l e v a n t s t e p f o r e n h a n c i n g ID o c ty p e s ,

tyPes

w h i c h is c r e a t i n g a c u s t o m s e g m e n t t y p e . You c r e a t e s e g m e n t t y p e s in T r a n s a c t i o n W E 3 1 . T h e y c a n h a v e n a m e s w i t h u p to 2 7 c h a r a c t e r s b e g i n ­ n i n g w i t h "Z" o r "Y" o r /< N A M E S P A C E > / i f t h e y a r e c u s t o m e r s e g m e n t s . T h i s is f o l l o w e d b y 1 ; t h e r e m a i n i n g p a r t o f t h e n a m e c a n b e fr e e ly d e f i n e d b y y o u (in o u r e x a m p l e , t h e n a m e is Z 1 M A R A ) . SAP s e g m e n t s o f t e n h a v e a n a m e t h a t d i r e c t l y r e f e r s t o t h e d a t a b a s e ta b le f r o m w h i c h t h e fie ld s a r e u s e d . B u t t h i s i s n ' t m a n d a t o r y . F i g u r e 4 . 7 3 d isp lay s o u r s a m p le s e g m e n t, w h ic h b e lo n g s to th e a p p e n d discu ssed earlier fo r th e

m a ra

ta b le .

D e v e lo p m e n t s e g m e n ts : D is p la y s e g m e n t d e fin itio n Z2M A R A 000

S e g m e n t type attributes S e g m e n t type

Z 1MARA

S h o rt D e s c rip tio n

Z lm a r a

S e g m definition

Z 2HARAO0 O

L a s t C h a n g e d By

M AISELSA

- ieid N a m e

2

Q u a lifie d s e g m e n t

|

CHAR20

ZZSHFELD2

CHARI 0

4.73

R e le a s e d

) a t a ele m e n t

ZZSHFEL01

F ig u re

□

S O CO

m 20

□

0

i± j

Ld

C re a tin g a C u s to m S e g m e n t Type

W h e n c r e a t i n g t h e s e g m e n t , t h e s y s t e m d e t e r m i n e s t h e l e n g t h s o f th e fields f r o m t h e d a t a b a s e . I f y o u m o d i f y t h e field l e n g t h s a t a l a t e r s ta g e , y o u m u s t m a n u a l l y c h a n g e t h e m in t h e s e g m e n t . S e g m e n t t y p e in

You c a n v i e w t h e s e g m e n t t y p e i n T r a n s a c t i o n S E 1 1 , t h e D a ta D ictio n a ry

T r a n s a c t i o n SE 11

(DDIC), w h e r e it's d e f i n e d a s a s t r u c t u r e . T h e s e g m e n t t y p e c o n t a i n s th e i n f o r m a t i o n i n a S A P -specific f o r m a t in w h i c h t h e d a t a b a s e a ls o s t o r e s t h e fields. T h e s y s t e m a ls o c r e a t e s a s e g m e n t d e f i n i t i o n f o r e v e i y s e g m e n t t y p e w i t h t h e s a m e n a m e p a r t s a s in t h e o r i g i n a l n a m e e x c e p t f o r t h e 1, w h i c h is r e p l a c e d b y a 2 h e r e (e .g ., Z 2 M A R A ) . T h is s e g m e n t d e f i n i t i o n c a n b e a v a il­ a b l e i n v a r i o u s v e r s i o n s , w h i c h is i n d i c a t e d b y a t h r e e - d i g i t n u m b e r a t

12 4

A d a p tin g E x istin g ID o c T yp e s

|

4-2

t h e e n d o f t h e n a m e . T h e s e g m e n t d e f i n i t i o n o f o u r e x a m p l e is t h e first v e r s i o n , s o i t ’s a s s i g n e d t h e "OOO" a d d i t i o n :

Z2M ARA000.

The segm ent

d e f in i t i o n i n d i c a t e s t h e e x t e r n a l f o r m a t , t h a t is, t h e f o r m a t t h a t is a c tu a lly e x c h a n g e d w ith th e p a r tn e r a n d th a t differs fro m th e in te rn a l f o r m a t o f t h e SAP d a t a b a s e f o r s o m e fields. To d e l i v e r a n e u t r a l f o r m a t , y o u m u s t p r o v i d e a ll i n f o r m a t i o n a s a tex t.

N e u tra l fo rm a t

T h e SAP d a t a b a s e s t o r e s n u m b e r s w i t h o u t d e c i m a l s e p a r a t o r s ; t h e d e c ­ im a l s e p a r a t o r , h o w e v e r , is a l w a y s t r a n s f e r r e d as a p o i n t . A p o s s i b le m i n u s s i g n is t r a n s f e r r e d i n t h e last fie ld . C o m p a r e d t o t h e i n t e r n a l p r e ­ s e n t a t i o n , t h e s e n u m b e r s a l w a y s c o n t a i n t w o a d d i t i o n a l p lace s. D a te s a re u s u a l l y t r a n s f e r r e d a s fo llo w s : f o u r d i g i t s f o r t h e y e a r , t w o d i g its f o r t h e m o n t h , a n d t w o d i g its f o r t h e day. You m u s t re le a s e t h e s e g m e n t b e f o r e y o u c a n u s e it. F o r t h i s p u r p o s e , fo llo w th e

Ed

it

•

Set

release

m e n u p a t h (s e e F ig u r e 4 .7 4 ).

&

□ Segm ent

Q

E d it

G o to

U b li!ie s (M )

E n v iro n m e n t

S e t re le a s e

D ev elo p

@

C a n c e l re le a s e

R e le a s e

S y s te m ©

0 3 0

bo

H e lp 33

£ ) \0

£ ) £ )

0

0

W

ial s c r e e n

O b je c t d ire c to ry entry

m m m

F12

C ancel Z1HARA

S e g m e n t type

Z 1 m a ra

S e g m definition 000

Z2HARAO00

I s t l f c f c l J J J - J f i U I A J I •" I □

30

0 8 /1 8 /2 0 0

E

F ig u re

4.74

R e le a s in g a S e g m e n t

A f t e r t h e r e le a s e , e v e r y c h a n g e r e s u lt s i n a n e w v e r s i o n o f t h e s e g m e n t . I n t h e V e r s i o n C o n v e r s i o n ALE s e r v i c e (s e e S e c t i o n 4 . 2 . 2 , G e n e r a l Exits), y o u c a n e n s u r e t h a t t h e s y s t e m u s e s t h e a p p r o p r i a t e o l d e r v e r s i o n o f th e s e g m e n t d e f i n i t i o n i f y o u r p a r t n e r u s e s a n o l d e r re le a s e .

C re a tin g an E n h a n ce m e n t Type A f t e r y o u c r e a t e all r e q u i r e d s e g m e n t s , y o u c a n c r e a t e t h e a c tu a l e n h a n c e ­

C r e a tin g an

m e n t t y p e . It a ls o f o l l o w s t h e c o m m o n c u s t o m e r n a m i n g r u l e s a n d can

e n h a n ce m e n t ty p e

125

4

|

C h an g e s to ID o cs

c o n t a i n u p to 3 0 c h a r a c te r s . T ra n s a c tio n W E 3 0 is t h e c o r r e s p o n d i n g t r a n s ­ a c t i o n . It's critical t h a t y o u s e l e c t t h e E x t e n s i o n c h e c k b o x (F ig u re 4 . 7 5 ) in t h e in itia l s c r e e n b e c a u s e t h e d e f a u l t s e t t i n g is B asic T y p e , w h i c h is o n l y r e q u i r e d f o r c o m p l e t e l y n e w ID o c ty p e s .

Develop IDoc Types: Initial Screen SW*?

□

0

C h a n g e R e q u e s ts (O rganizer)

ZSI1HARA

Ob) N a m e

D e v e lo p m e n t obiect C B a s ic type ® Extension

F ig u re 4-75

C re a tin g t h e E n h a n c e m e n t Type

P ro p e rtie s o f th e

I n t h e n e x t s t e p (s e e F i g u r e 4 . 7 6 ) , d e f i n e w h i c h b a s i c t y p e y o u w a n t

e n h a n c e m e n t typ e

y o u r e n h a n c e m e n t t y p e t o r e f e r to ; in o u r e x a m p l e , i t's t h e MATMAS05 b a s i c t y p e . You c a n a ls o c o p y a n d f u r t h e r p r o c e s s e x i s t i n g e n h a n c e ­ m e n ts o r create a n e n h a n c e m e n t as th e fo llo w -u p o b je c t o f a n existin g en h a n cem en t.

&

0

C r e a te e x te n s io n ZS M M AR A

N e w exte n s io n

®

C re a te n e w

L in k e d b a s ic type

O C reate a s copy

C o p y fro m e x te n s io n L in k e d w ith b a s ic type

O C reate s u c c e s s o r

S u c c e s s o r o r extension

A d m in is tr a tio n / M A IS E LS A

P e rs o n re s p o n s ib le P r o c e s s in g p e r s o n

H

m a is e l s a

D e s c rip tio n S a b in e s E n h a n c e d M a te ria l

F ig u re 4 .7 6

12 6

N ecessary S p e cifica tio n s

.

A d a p tin g E x istin g ID o c T yp e s

|

4 .2

T h e n e x t s c r e e n d i s p l a y s t h e b a s ic t y p e t h a t is d e f i n e d a s a t e m p l a t e (see

Enhancement o f

F ig u r e 4 .7 7 ) . You c a n c h o o s e t h e s e g m e n t f o r w h i c h y o u w a n t to c re a te

th e “M A T M A S "

y o u r c h i l d s e g m e n t s b y s e l e c t in g t h e s e g m e n t a n d c lic k in g o n t h e C re a te

b a s ic t y p e

ic o n . T h e s y s t e m t h e n o u t p u t s a m e s s a g e t h a t i n d i c a t e s t h a t c u s t o m s e g ­ m e n ts a r e o n ly p e r m itte d as child s e g m e n t ty p e s fo r e n h a n c e m e n ts .

Create extension: ZSMMARA

S a b in e s E nhanced M a t e r ia l M a s te r l a t e r l a l g e n e r a l d a t a (KARA)

E1MARAM

A d d it io n a l F i e ld s f o r E1 MARAM M a s te r ■ a t e r i a l s h o r t t e x t s (MAKT) M a s te r a a t e r t a l C segm ent (MARC)

E1MARA1 E1MAKTM —m e ih a r c m - 0 3 E1HARP1H E1H6EM" —
M a s te r

M a te r ia l

u n its

o f

M easu re

(H A R M )

M a s te r M a t e r i a l M a t e r i a l v a l u a t io n (MBEY) M a s t e r M a t e r i a l M a t e r i a l d a ta p e r t a r e h o u M a s t e r M a t e r i a l s a l e s d a t a (MVKE) M a s te r M a t e r i a l t a x c l a s s i f i c a t i o n (MLAH) M a s te r m a t e r i a l lo n g t e x t hea der CU: C o n f i g u r a t io n d a ta

e ih l a n h

—03 E1MTXHH - 0 3 E1CUCFG -E1UPSL1NK

R e fe re n c e Tro M O b je c t t o

nuM ber

(MLGH)

S u p e r io r UPS

0 /

I E * Inform ation U

se

E rte h s io n se g m e n t ?To e (s ) w iii be in serted as c h ild se g m e n t v p e (s ) o f E 1 MAPAM

F ig u re

4.77

In s e rtin g a C u s to m S e g m e n t

N e x t, y o u m u s t s p e c if y w h i c h s e g m e n t t y p e y o u w a n t t o u s e ( s e e F ig u re

O ccu rrence o f th e

4 .7 8 ). F u rth e rm o re , y o u n e e d to d e fin e th e o c c u rre n c e o f th e s e g m e n t

s e g m e n ts

w i t h i n t h e ID oc; t h e m i n i m u m n u m b e r m u s t a l w a y s b e " 1 ." “0 ” w o u l d b e c o n s id e r e d "b la n k " h ere, w h ic h ju stifie s th is u n c o m m o n e n try . T h e s e g m e n t ty p e o n ly b e c o m e s a M a n d a to r y s e g m e n t i f y o u select th e c o r ­ r e s p o n d i n g flag. In o u r e x a m p l e , t h e s e g m e n t is o p t i o n a l a n d c a n o c c u r o n l y o n c e . (T h e a p p e n d e n t i y in t h e

ZSMMARA

o n c e f o r e a c h m a t e r ia l; a c c o r d i n g l y , t h e

t a b le c a n b e p r o v i d e d o n l y

Z I MAR A

se g m e n t ca n o c c u r o n ly

o n c e f o r e a c h m a t e r i a l a s w e ll.)

127

4

|

C h an g e s to ID o cs

C re a te e x te n s io n : ZSMMARA □ ]fc x > * a S a b in e s E nhanced H a t e r ia l E1MARAM

M a s te r » a t e r i a l

-------- E1HARA1 -------- E1MAKTH

g e n e r a l d a t a (MARA)

c-M am tain Attributes

—£B E1MARCH — CD E1HARHM -------- E1M6CWI - 0 3 E1W.6KH -------- E1MVKEH -------- E1HLANM —03 E1MTXHH - 0 3 E1CUCF6

S e g m ty o e

M in im u m n u m b e r M axim um num ber

H ie ri» « e i

^

4.78

uber

(HLGN)

«

1

Parent segm eni

- E 1 U N IIN K

F ig u re

ZIMARA

□ Mandatory seg

0

S e gm e m e d ito r

U

S p e c ific a tio n s f o r a C u s to m S e g m e n t

E n h a n c e m e n t fo r

T h e s y s t e m i n d i c a t e s t h e c u s t o m e n h a n c e m e n t s e g m e n t s in w h i t e a n d

“ Z1M ARA"

t h e in itia l s e g m e n t s in b l u e . T h i s e n a b l e s y o u to d i r e c t l y i d e n t i f y w h i c h s e g m e n t s h a v e b e e n a d d e d . F ig u r e 4 . 7 9 d i s p l a y s t h e e n h a n c e m e n t re su lt, t h a t is, t h e a d d e d ( w h i t e ) s e g m e n t , ZIMARA.

C rea te e x te n sio n : ZSMMARA ; □

p

,

i

i

B

g

|

Z1HARA I HARA1 — 03 — O)

----— 03

tMARCH EtHARMH 1HBEYM 1HL6HM E1HVKEM IMLAMU

— m

1HTXHH E1CUCF6

n a s te r t a t e n a i

g e n e ra l d a t a (MARA)

Z ln a r a A d d it io n a l F i e ld s T o r E1 MARAH H a s te r a a t e r l a l s h o r t t e x t s (MAKT) M a s te r a a t e r l a l C s e g > e n t (MARC) M a s te r a a t e r l a l u n i t s o f m easure (HARM) H a s te r a a t e r l a l a a t e r l a l v a l u a t io n (HBEW) H a s te r a a t e r l a l a a t e r i a l d a t a p e r w a re h o u s e n u ib e r n a s t e r a a t e r l a l s a le s d a t a (HVKE) H a s te r a a t e r l a l t a x c l a s s i f i c a t i o n (H U H ) H a s te r a a t e r l a l lo n g t e x t hea der

(HL 6H)

----------E IU P S IIN K

F ig u re

R e le a s in g an enhancem ent

4.79

C o m p le te E nhancem ent

You m u s t a ls o r e l e a s e t h e e n h a n c e m e n t . F o r t h i s p u r p o s e , f o l l o w t h e E d i t • Se t

release

m e n u p a t h (s e e F ig u r e 4 . 8 0 ) . You c a n n o l o n g e r m o d ­

ify y o u r e n h a n c e m e n t a f t e r t h e r e le a s e .

12 8

A d a p tin g E x istin g ID o c T yp e s

|

4-2

D evelop IDoc Types: Initial Screen □

? i

^

0

&

a°

Obi N a m e

C h an g e R equests (Organcer)

zsh h apa

Sabines Enhanced Material Developm ent oDiect

c ’ R elease/cancei release

0

/

Extension types cannot be changed alter being released R e le a s e extension? Yes

F ig u re

4.80

~ I*

H

No

Cancel

|

R e le a s in g t h e E n h a n c e m e n t

N o w , y o u h a v e t o a s s ig n t h e r e l e a s e d e n h a n c e m e n t to t h e m e s s a g e ty p e

A s s ig n m e n t to

a n d t h e ID o c t y p e b e c a u s e y o u c a n o n l y u s e i t w i t h t h i s c o m b i n a t i o n .

m essage ty p e and

F ig u r e 4 . 8 1 s h o w s h o w t h i s is d o n e f o r t h e s a m p l e e n h a n c e m e n t , M ARA,

ID o c typ e ZSM-

in T ran sactio n W E 8 2 .

New E ntries: O verview o f A dded E ntries

M M M M 1 Output Types and Assignm ent to ID oc Types M essage Type

[Basic type

(Extension

HATHAS

HAIH AS05

jZSRHARA

i

F ig u re

4.81

jR e lea se j70O

A s s ig n in g t h e E n h a n c e m e n t t o t h e M e s s a g e Type

I f y o u ’re n o t s u r e w h e t h e r y o u ' v e c o n s i d e r e d all n e c e s s a r y a s p e c t s , y o u c a n c h e c k y o u r e n h a n c e m e n t . S u c h c h e c k f u n c t i o n s a r e a l s o p r o v i d e d fo r s e g m e n t ty p e s , b u t i t m a k e s m o r e s e n s e t o c a r r y o u t t h e c h e c k a f t e r e v e r y ­ th in g h as b e e n im p le m e n te d so th a t th e c h ild e le m e n ts are a lso checked. To c h e c k t h e e n h a n c e m e n t , u s e t h e

En

h a n c e m e n t

• C

h eck

m e n u o r th e

sca le s ic o n , w h i c h y o u c a n s e e in F ig u r e 4 . 8 0 , s h o w n ea rlie r. F ig u r e 4 . 8 2 s h o w s w h a t is c h e c k e d a n d h o w t h i s is d i s p l a y e d in t h e c a se o f s u c c e s s . I f a n e r r o r o c c u r r e d , y o u c a n c o r r e c t i t u s i n g t h i s log. A f t e r h a v i n g c o m p l e t e d t h e e n h a n c e m e n t , y o u n e e d t o fill t h e s e g m e n t s a n d t h e n a m e o f t h e e n h a n c e m e n t in t h e c o n t r o l r e c o r d i f y o u s e n d th e I D o c a n d r e a d t h e r e s p e c t i v e s e g m e n t s i f y o u u p d a t e t h e ID o c.

129

C h e c k in g th e enhancem ent

4

|

C h an g e s to ID o cs

L o g d is p la y N te lfllfc

a

®

0 j

< £ r Long Text

Check e x t e n s io n ZSMHARA E x te n s io n ZSMHARA e x i s t s E x te n s io n ZSMHARA 1s r e l e a s e d

9

E x te n s io n ZSMHARA 1s l i n k e d » l t h l o g i c a l a e s s a g e MATMAS Ho p r e d e c e s s o r s e x i s t E x te n s io n z s m m a r a i s a s s ig n e d t o b a s ic t y p e m a t m a $05 C heck seg m e n t Z 1MARA S e g a e n t Z 1HARA c o n s is t e n t

*.82

F ig u re

C h e c k in g th e E n h a n ce m e n t

F illin g S e g m e n t s You n o w s e l e c t a n a p p r o p r i a t e e x i t in t h e o u t b o u n d f u n c t i o n m o d u l e o f t h e ID o c a n d i m p l e m e n t y o u r c h a n g e s (L istin g 4 . 2 ) . T h e f u n c t i o n m o d ­ u l e f r o m t h e e n h a n c e m e n t s s e r v e s a s a n e x a m p l e h e r e . T h e p r o c e d u r e is i d e n t i c a l f o r all e n h a n c e m e n t t e c h n o l o g i e s , b u t t h e n a m e s o f t h e t r a n s ­ f e r v a r ia b l e s in t h e s a m p l e c o d e c o r r e s p o n d t o t h o s e o f t h e exit.

LMV0 1 _ 0 0 2 F illin g th e s e g m e n ts w i t h an

* ............................... . . . . . . . . . . .................................................................... i *

IN C LU D E

ZXMGVU03

* ............................................................................................... *

a p p r o p r i a t e e xit

♦ F i l l case

e n te rp ris e -in te rn a l

m e s s a g e _ ty p e

C h e c k in g fo r

*

Change

m essage o r ID oc

*

m essage.

typ e s *

i f

th is

when

'M A T M A S ’

o n ly

th e n

case Check is

*

c u s to m e r

o f

when

a p p e n d in g the

when

th o s e

to

th e

be

in s e rts .

is .

I f

it

enhanced,

.

fill_ z lm a ra

.

.

g e n e ra te d

id o c _ d a ta

o th e rs .

re q u ire d

. i t

is

* E1 MARAM-

exi t

th e

* ZSMMARA’

segm ent

ta b le s

13 0

-

segm ent

p e rfo rm

segment

MATMAS.

.

se g m e n t_ n a m e

*

G e n e ra tin g and

one

r e a lly

im p le m e n t

w h ic h

fo r

. is

id o c _ c im ty p e

*

s e g m e n ts

.

a

and

c o rre s p o n d in g appended.

E X IT _ S A P -

A d a p tin g E x istin g ID o c T yp e s

endcase when

endcase

.

. .

4 2

L is tin g

4-2

.

o th e rs

e x it

|

E n h a n c in g th e " E X IT _ S A P L M V 0 1 _ 0 0 2 "

I n L istin g 4 . 3 , y o u c a n s e e t h e f

fo rm ,w h ic h

i l l_ z lm a ra

is c a ll e d in th e

e x it m e n t i o n e d p re v io u s ly . O f c o u r s e ad iv i s io n i n t o s u b r o u t i n e s

i n th e

E x a m p le o f th e c a lle d fo rm

c o d e i s n 't n e c e s s a r y b u t m a k e s it e a s i e r t o r e a d p r o g r a m s . * _______________________ __ ____ ________________ ___________________ __ _____________ _____________ __________ _________________________________*

* * * IN C LU D E

ZXMGVF01

.

* _____________________________________________________________________________________________________________ *

*&

F orm

fill_ z lm a ra

*&.................................................................................................................................................... * FORM f i l l _ z l m a r a ta b le s : d a ta :

*

m a tn r

ty p e

rea d

ta b le

re a d

p o s s ib le ,

e lm a ra m m a tn r

-

=

s e le c t

m a ra -m a tn r

e lm a ra m -m a tn r

s y -su b rc

eq

0

eq

L is tin g

4 .3

segnam

segm ent

=

'E

1 MARAM'

.

o c c u rs

o n ly

once,

.

ZZSMFELD2 fie ld s

fro m o f

e lm a ra m -m a tn r

M ara

z lm a ra .

.

id o c _ d a ta - s d a ta append

.

.

c o rre s p o n d in g m a tn r

e d id d

.

key

th e

ZZSMFELD1

s in g le

id o c _ d a ta -s e g n a m

ENDFORM

w ith

because

s tru c tu re

.

id o c _ d a ta - s d a ta

in to

end i f

id o c _ d a ta

z lm a ra

id o c _ d a ta

w h e re i f

ta b le s

e lm a ra m ,

id o c _ d a ta

= =

' Z IM A R A ' z lm a ra

.

.

.

. .

-

f i 1 l_ z lm a ra

C o d e fo r t h e “ fill_ z 1 m a ra ” Form

You h a v e to le t t h e s y s t e m k n o w i f y o u w o r k w i t h a c u s t o m e r - s p e c i f i c

P a rtn er p ro file w ith

e n h a n c e m e n t ; o t h e r w i s e , t h e s y s t e m i d e n t i f i e s c u s t o m s e g m e n t s as

enhancem ent

i n c o r r e c t . F o r t h i s p u r p o s e , n a v i g a t e to t h e O u t b o u n d O p t i o n s t a b a n d t h e I D o c T y p e s u b t a b in t h e p a r t n e r p r o f il e o f t h e s e n d i n g s y s t e m (s e e F ig u r e 4 . 8 3 ) . H e r e , t h e ID o c is d e s i g n e d w i t h t h e c o r r e s p o n d i n g c o n t r o l r e c o r d , a n d t h e s e n d i n g s y s t e m c h e c k s f o r all s e g m e n t s w h e t h e r t h e y a re a l l o w e d in t h i s c o m b i n a t i o n o f I D o c t y p e a n d e n h a n c e m e n t .

13 1

4

|

C h an g e s to ID o c s

P a rtn e r p ro file s : O u tb o u n d p a ra m e te rs

P iitn e .N o

2SHTAR6EI

SaBines Target System

Partn.Type

PI

L o g *a l system

Partnei Role

g

WATfUS

M essaged

Message code Messagefonefcon

□Test

Message Control Recet/er port

P o tt Processing Permitted Agent

Teie

SUBSTSTEB6

O tfc u l Mode ® Transfer C o c Immed

O Start subsystem

O Collect lOocs

® Oo not tta r t subsystem

F ig u re

4-83

Output Mode

P artner P ro file w i t h E n h a n c e m e n t

C o n tro l reco rd fo r

T h e ID o c a d d i t i o n a l l y c o n t a i n s t h e n a m e o f t h e e n h a n c e m e n t in t h e c o n ­

th e enhancem ent

trol r e c o r d ; in o u r e x a m p l e , t h e e n h a n c e m e n t is ZSMMARA in t h e E x t e n s i o n field. Fin ally , y o u c a n g e n e r a t e t h e e n h a n c e d ID o c t h a t w ill b e s e n t (see F ig u re 4 .8 4 ) .

lOoc Display □

lO c c 0 0 0 0 0 0 0 0 0 0 7 6 8 7 6 8 Q

^

C o n tro l R ec

C U D a ta re c o rd s

Total num ber 000006

•=> D E 1 « R * M

Seamen! 000001

03

OuCDOl

B asK tfpe

im t im s m

rrm

Ertenston

ZSitn«»«

E'MARA!

Message tipe

HATIUS

0

E 'M A K T M

Segment 000004

Partner No

2SMTARGET

□

E 'M A K T M

Segment 000005

□

E1M ARM M

Segment 000006

2 1 M ARA

□

^D~03

Data passed to port OK

Q lO ot written to til# 30 □

IDoc ready (Or dispatch (ALE sei> Receiver fo u n d . No fillers

Q ot

F ig u re

1

Current slatus

Segment 000002 Segment 000003

0

C D S ta s is re c o rd s

□

Direclon

4 84

Partn Type

LS

Port

S18SYSTE"

C o m e n otselected segment

Fid name

Fid c o rt

ZSnFElDl

i EHOI

Z2SHFEID?

'EM .

E n h a n c e d ID o c t o Be Sent

Y o u 'v e n o w c o m p l e t e d all n e c e s s a r y ta s k s o n t h e s e n d e r s i d e . T h e n e x t s e c t i o n d e a ls w i t h u p d a t i n g a n e n h a n c e d IDoc.

13 2

A d a p tin g E x istin g ID o c T yp e s

|

4 .2

P o stin g S e g m e n ts To u s e a n e n h a n c e m e n t in i n b o u n d p r o c e s s i n g , y o u m u s t f ir s t a s s ig n t h e

A s s ig n in g an

c o r r e s p o n d i n g i n b o u n d f u n c t i o n m o d u l e t h a t c o n s i s t s o f m e s s a g e ty p e ,

in b o u n d fu n c tio n

ID o c t y p e , a n d e n h a n c e m e n t . You d o t h i s i n T r a n s a c t i o n W E 5 7 ( s e e Fig­

m o d u le

u r e 4 . 8 5 ) . D o n ' t g e t c o n f u s e d b y t h e n a m e o f t h e IDOC_INPUT_MATMAS01 f u n c t i o n m o d u l e ; it c a n p r o c e s s all m a t e r i a l m a s t e r ID o c s ( t h e n a m e w a s a s s i g n e d f o r h i s t o r i c a l r e a s o n b e c a u s e it w a s d e v e l o p e d w h e n o n l y t h e matmaSOI

ID o c t y p e w a s av a ila b le ).

C h a n g e V ie w " ID o c : A s s ig n m e n t o f F M to L o g . M e s s a g e a n d ID o c T y p e " :

Function module

IDOC.INPUTJIATMASOI

Function type

F Function m odule

8aslc type

HATMAS05

Extension

ZSHNARA

M e s s a g e Type

HATHAS

□

M e s s a g e Variant M ess, tancton O bject Type

D irection

BUS1001006

_ [ 2 inbound

D e scrip tio n

M atenal m aster

N am e

Standard material

F ig u re

4.85

3

A s s ig n in g t h e In b o u n d F u n c tio n M o d u l e fo r th e E n h a n c e m e n t

T h e p r o g r a m m i n g w o r k c o n s i s t s o f t w o p a r t s . First, y o u m u s t e n s u r e in t h e a p p l i c a t i o n t h a t t h e c o r r e s p o n d i n g u p d a t e m o d u l e s a ls o t r a n s f e r th e c u s t o m e r - s p e c i f i c fie ld s to t h e d a t a b a s e . U s u a lly , y o u ' r e n o t r e s p o n s i b l e f o r t h i s p a r t o f t h e d e v e l o p m e n t w o r k , a n d i t ’s t o o m o d u l e - s p e c i f i c to b e e x p l a i n e d in d e ta il h e r e . T h e s e c o n d p a r t o f t h e p r o g r a m m i n g w o r k is to e n s u r e t h a t t h e d a t a t h a t h a s b e e n a d d i t i o n a l l y t r a n s f e r r e d in t h e ID o c is r e a d a n d t r a n s f e r r e d to t h e t r a n s f e r p a r a m e t e r s o f t h e u p d a t e m o d u l e , w h ich m u st b e d o n e b y y o u . A g a in , t h e m a t e r i a l m a s t e r is u s e d a s a n e x a m p l e h e r e . L is tin g 4 . 4 s h o w s

U s in g d a t a fro m

t h e s a m p l e c o d e f o r t h e f ie ld s f r o m t h e c u s t o m e r - s p e c i f i c s e g m e n t ,

th e ID o c

ZIMARA.

133

4

|

C h an g e s to ID o cs

d a ta : i f

w a _ z lm a ra

m e s s a g e _ ty p e i f

ty p e eq

z lm a ra

‘ MATMAS’

f_ c u s t_ s e g m e n t-s e g n a m w a _ z lm a ra

-

end i f

. eq

' Z 1MARA'

f_ c u s t_ s e g m e n t- s d a ta

m o v e -c o rre s p o n d in g

end i f

.

w a _ z lm a ra

to

.

. f_ m a ra _ u e b

.

.

.

L is tin g 4 4

T ra n s fe rrin g t h e D a ta fr o m t h e " Z 1 M A R A " C u s to m e r S e g m e n t

T h e t r a n s f e r s t r u c t u r e is d e l i v e r e d b y SA P s o t h a t i t a l r e a d y i n c l u d e s p o t e n t i a l a p p e n d s to t h e

MARA

t a b l e a u t o m a t i c a l l y . T h i s is u s u a l l y t h e

case. If n o t, y o u ca n also a d d a n a p p e n d to th e tra n s fe r s tru c tu re that c o n t a i n s t h e s a m e fie ld s a s y o u r a p p e n d t o t h e d a t a ta b le .

W h e n d o ALE se rvices run ?

C o m b in a t io n o f A L E S e rv ic e s a n d E x its SA P g e n e ra lly p ro v id e s th e o p tio n

to

im p le m e n t changes t o

ID o c s v ia th e

s e ttin g s in C u s to m iz in g . T h e m a n ip u la tio n s , h o w e v e r, a re im p le m e n t e d a fte r y o u r ID o c has b e e n g e n e r a te d . Y o u r e x its , in c o n tr a s t, a re e x e c u te d w h i l e th e I D o c is g e n e r a t e d . T h i s m e a n s t h a t p o s s i b l e f i l t e r i n g p r o c e s s e s o r r u l e s m a y n o t b e d e p l o y e d w h e n y o u r e x i t is e x e c u t e d . Y o u s h o u l d c o n s i d e r t h i s f o r t h e im p le m e n ta tio n . F or e x a m p le , if y o u o n ly w a n t t o p ro ce ss a p la n t s e g m e n t fo r a s p e c ific p a rtn e r, y o u m u s t a s s u m e t h a t y o u r e x it

w o r k s w h i l e a ll p la n t s e g ­

m e n ts a re s till in c lu d e d . C o n s e q u e n tly , y o u m u s t m a k e s u re t h a t y o u r ch a n g e s a re m a d e t o t h e c o rr e c t p la n t s e g m e n t.

4 .2 .4

S p e c ia l R e q u ir e m e n ts f o r M a s t e r D a ta

You a l r e a d y k n o w t h a t t h e S M D p r o v i d e s s p e c i a l f u n c t i o n s f o r m a s t e r d a t a . S o m e t i m e s , h o w e v e r , t h e a v a ila b le s p e c ia l f u n c t i o n s a r e n 't w a n t e d . T he fo llo w in g sec tio n s d escrib e h o w y o u can m o d ify th em .

S e n d in g A ll D a ta A fte r C hanges W h e n u s i n g S h a r e d M a s t e r D a t a T o o ls a n d t h e c o r r e s p o n d i n g c h a n g e p o i n t e r s , SAP a s s u m e s t h a t I D o c s s h o u l d b e k e p t a s s m a l l a s p o s s i b le f o r p e r f o r m a n c e r e a s o n s . T h i s a ls o u s u a l l y c o r r e s p o n d s t o re a lity . But s o m e tim e s y o u c o llab o rate w ith p a rtn e rs w h o can o n ly p rocess co m p lete d a t a r e c o r d s . To still b e a b l e to u s e c h a n g e p o i n t e r s , y o u c a n i m p l e m e n t m in o r m o d ificatio n s fo r m a te ria l m asters.

134

A d a p tin g E x istin g ID o c T yp e s

|

4-2

T h e s e t t i n g t h a t o n l y t h e c o m p l e t e m a t e r i a l is s u p p o s e d to b e s e n t is

"S end co m p le te "

a l r e a d y a v a ila b le f o r t h e m a t e r i a l m a s t e r , f o r e x a m p l e , i f t h e c r o s s - p l a n t

m o d ificatio n

s t a t u s o f a v a l u e “w i t h d i s t r i b u t i o n lo c k " h a s b e e n c h a n g e d to a v a lu e " w i t h o u t d i s t r i b u t i o n lo c k ." F o r t h i s p u r p o s e , t h e

I D0C_CRE-

fu n c tio n m o d u le m a n a g e s a n in te rn a l tab le,

ATE_SMD_MATMAS p le x _ m a tn r,

MASTER

a _ t_ c o m -

w i t h t h e M A N D T , M A T N R , a n d M S G F N field s. I f y o u n o w

a p p e n d y o u r m a t e r i a l s t h a t a r e t o b e s e n t c o m p l e t e l y a s w e ll a n d s e t t h e M S G F N field to " 0 0 5 " f o r " m e s s a g e r e p la c e s p r e v i o u s m e s s a g e s ," t h e s y s ­ t e m s e n d s t h e c o m p l e t e m a t e r i a l . T h e c o r r e s p o n d i n g s a m p l e c o d e c o u ld b e s t r u c t u r e d a s s h o w n in L is tin g 4 . 5 . *

T h is

*

a re

*

The

*

is

change a lw a y s

th e

key

fo r

MESTYPE

LOOP A T s e le c t

in to MESTYPE

ty p e

s p e c ific

m essage

d e c is io n

m essages

ty p e

h e re ,

B D C PS-M ESTYPE

G e ttin g t h e c h an g e

.

p o in te r

.

MESTYPE

MESTYPE eq

th a t

re d u ce d

th e

A_T_CHGPTRS s in g le

e ffe c t

c o m p le te ly .

s e lf-d e v e lo p e d th e

d a ta :

i f

has sent

fro m

w h e re

‘ ZSMMAT*

BDCPS C P ID E N T

eq

A _ T _ C H G P T R S -C P ID E N T

.

T .M A R A K E Y -M A N D T -

S Y -M A N D T

T _M AR A KE Y-M A TN R =

A _ T _ C H G P T R S -C D O B JID

COLLECT

.

T_MARAKEY

A _ T _ C O M P LE X _M A T N R -M A N D T

=

.

S Y -M A N D T

.

.

A _T_C O M P LE X _M A T N R -M A T N R =

A _ T _ C H G P T R S -C D O B JID

A _T _ C O M P LE X _ M A T N R -M S G F N

C_MSGFN_R

COLLECT c le a r END I F ENDLO O P

=

A _ T _ C 0 MPLEX_M ATNR

MESTYPE

.

.

.

A p p e n d i n g t o SAP

.

tab le

.

. .

S e n d in g t h e C o m p le te M a te rial A fter M o d ific a tio n s

L is tin g 4 .5

T h is c o d e m u s t b e a d d e d b e fo re th e s y s te m f u r th e r p ro c esses th e d ata. B ecause th e m o d u le m ay c h a n g e , y o u s h o u ld se a rc h for the fo llo w in g co m m en t: D E S C R IB E C HE CK

TABLE h lin e s

t.m a ra k e y GT

0

L IN E S

h lin e s

.

.

T h e n , i n s e r t t h e c o d e d i r e c t l y b e f o r e t h i s in y o u r f u n c t i o n m o d u l e . N e x t,

L o catio n o f th e

i n s t e a d o f t h e f u n c t i o n m o d u l e p r o v i d e d b y SAP, a s s i g n y o u r o w n f u n c ­

m o d ificatio n

ti o n m o d u l e in T r a n s a c t i o n B D 6 0 . Be s u r e t o i d e n t i f y t h e c h a n g e s in th e

135

4

|

C h an g e s to ID o c s

o r i g i n a l m o d u l e f o r e a c h r e l e a s e c h a n g e a n d r e p r o d u c e t h e m in y o u r f u n c t i o n m o d u l e i f r e q u i r e d . A l t e r n a t iv e ly , y o u c a n c o p y t h e SAP m o d u l e a fte r th e re le ase c h a n g e a n d in te g ra te y o u r m o d ificatio n s. U n fo rtu n ately , a n a p p r o p r i a t e e x i t i s n 't y e t a v a ila b le a t t h e l o c a t i o n w h e r e t h e m o d i f i c a ­ tio n n e e d s to b e im p le m e n te d .

R educed ID o cs in C o m b in a tio n w it h C u s to m S eg m e n ts I f y o u ’v e a d d e d c u s t o m s e g m e n t s to t h e m a s t e r d a t a ID ocs, y o u m a y w a n t to w o rk w ith red u ctio n s — fo r reasons o f p e rfo rm a n c e o r b ecau se y o u r p a r t n e r d o e s n ’t w a n t to re ceiv e p a r ti c u la r d a ta . B e c a u s e y o u r e n h a n c e m e n t is a n ID o c ty p e b u t y o u r r e d u c t i o n a m e s s a g e ty p e , y o u c a n ' t s i m p ly use o n e o f t h e m a s t h e b a sis f o r t h e o t h e r o n e . I n s t e a d , y o u h a v e to g e n e r a t e a r e d u c e d ID o c t h a t d o e s n ' t k n o w y o u r c u s to m e r- s p e c ific s e g m e n t s a n d in w h i c h y o u c a n d e l e t e e v e r y t h i n g f r o m t h e s t a n d a r d v e r s io n t h a t y o u d o n ' t w a n t to s e n d . I n a d d i t i o n , y o u m u s t a ls o g e n e r a t e a n e n h a n c e m e n t t y p e th at c o n ta in s y o u r a d d itio n a l se g m e n ts w ith o u t k n o w in g th e red u ctio n . E n h a n c in g a n d

W h e n c re a tin g th e r e d u c e d m e ssa g e ty p e, T ra n sactio n W E 8 2 a u to m a ti­

re d u c in g

c a lly g e n e r a t e s a n e n t r y in w h i c h t h e b a s i c t y p e is a s s i g n e d t o t h e n e w l y c r e a t e d r e d u c e d m e s s a g e t y p e . T h i s is d o n e a u t o m a t i c a l l y w h e n y o u s a v e t h e r e d u c e d m e s s a g e t y p e s o t h a t y o u c a n u s e i t i m m e d i a t e l y . To n o w u s e t h e c o m b in a tio n fro m y o u r re d u c tio n a n d y o u r e n h a n c e m e n t, c o p y th e b a s i c t y p e , a n d i n s e r t t h e e n h a n c e m e n t in t h e c o p i e d e n t r y . F ig u r e 4 . 8 6 s h o w s th is fo r th e

Z SM 1

r e d u c t i o n (s e e C h a p t e r 2, S e c t i o n 2 . 1 . 1 , S h a r e d

M a s t e r D a ta Tool) a n d t h e

ZSMMARA

e n h a n c e m e n t f r o m t h i s s e c ti o n .

C h a n g e V ie w " O u tp u t T y p e s a n d A s s ig n m e n t to ID o c T y p e s ":

Output T n m ano A ssignm ent to IDoc Types

ZSH1

HATHAS05

ZStlMARA

64«

E

0

F ig u re 4 -8 6

A s s ig n in g t h e E n h a n c e m e n t t o t h e R e d u c e d M e s s a g e T ype

A p p ro p ria te

In t h e p a r t n e r p ro file , t h e e n h a n c e m e n t is c o m b i n e d w i t h t h e b a s i c ty p e ,

p a rtn e r p ro file

a n d t h e s t a n d a r d m o d u l e c a r r i e s o u t t h e r e d u c t i o n w h i l e y o u r e x i t fills t h e c u s t o m e r - s p e c i f i c field s. F ig u re 4 . 8 7 d i s p l a y s t h e a p p r o p r i a t e p a r t n e r p ro f ile in t h e o u t b o u n d p r o c e s s i n g f o r t h e r e d u c e d m e s s a g e t y p e ,

ZSM 1,

w i t h " M A T M A S 0 5 " s p e c if ie d in t h e B asic T y p e fie ld a n d “Z S M M A R A "

13 6

A d a p tin g Ex istin g ID o c T yp e s

in t h e E x t e n s i o n field. T h e i n b o u n d p r o c e s s i n g m u s t t a k e w h a t it g ets; h o w e v e r, e n h a n c e m e n ts a n d re d u c tio n s m u s t a lso be k n o w n there.

P a r tn e r p r o file s : O u tb o u n d p a r a m e te r s

P a rtn e r N o

SA LES

S a le s s y s t e m (c lie n t 8 1 0 )

P a rtn T y p e

LS

L o g ic a l s y s t e m

P a r t n e r R o le

jg

M e ssag e Type

Z S fli

S a b i n e s R e d u c e d M a t e r ia l

M e ssag e code M e s s a g e fu n c t io n

□

M e s s a g e C o n tro l

R e c e iv e r p o rt

T e st

p o s t p r o c e s s in g

T ra n s a c tio n a l R FC

SA L E S

P e r m itt e d A g e n t

T e le

L S S a le s

jo o

P a c k S iz e □ Q u e u e P ro c o ssm g O u tp u t M o d e / " O T r a n s f e r ID o c im m e d

O u tp u t M o d e

4

© C o lle c t ID o cs

ID O C T y p e

B a s i c ty p e

H A TW AS05

E n h a n c e m e n t D i s t r i b u t io n o f S

E rte n sio n

z s h h a r a

S a b i n e s E n h a n c e d M a te n a i

V ie w E

C a n c e l P ro c e s s in g

S e g r e l e a s e i n ID o c w o

F ig u re 4 .8 7

□

S e g m e n t A f ip i. R e !

P a r t n e r P r o f ile w i t h R e d u c t i o n a n d E n h a n c e m e n t

To t e s t t h e s e s e t t i n g s , g e n e r a t e y o u r ID o c ( s e e F ig u r e 4 .8 8 ) .

IDoc display V

□

IDOC 0000000000768770 □

^

□

D a ta r e c o r d s

03

O utbox

CCM

B a s i c ty p e

H A in « S 0 5

E x te n s io n

ZSniMRA

O E1HARA1

S egm ent 000003

M e s s a g e ty p e

ZSnt

O

e im a k t u

S e g m e n t 000004

P a rtn e r N o

SALES

□

E t MAKTM

S egm ent 000005

S ta tu s re c o rd s

^

Q 03 0 D

T o ta l n u m b e r 0 0 0 0 0 5

Z1M »R»

□

^

1

C u rre n t s t a t u s

segmem 0 0 0 0 0 2

□

^

D ire c tio n

Control Rec

Data passed to port OK IDoc sent lo

SALES

IDoc read* for dispatch (ALE service)

Content o*selected segment

Receiver fo u n d . No H e r * . No conversion .Version

D Ot

F ig u re 4 88

LS

P o rt

SAP system or external program

30 Q

P a r t n T ype

lOoc generated

n r r — -----------ZZSH FElO l

HEH01

E

ZZSHFELD2

•EM02

0

S am p le ID o c

137

4-2

4

|

C h an g e s to ID o cs

4 .3

C u sto m F u n ctio n M o d u le s fo r File G e n e ra tio n in F ile Ports

F o r file p o r t s , y o u n e e d to s p e c if y t o w h i c h file t h e c o r r e s p o n d i n g ID o c is s u p p o s e d t o b e w r i t t e n i f t h i s p o r t is u s e d . You d o t h i s in T r a n s a c t i o n W E 2 1 , t h e p o r t m a n a g e m e n t (s e e F ig u re 4 .8 9 ) . H e r e , y o u c a n a l w a y s w r i t e t h e ID o c t o a d e f i n i t e file b y s p e c i f y i n g t h e n a m e o f t h e c o r r e s p o n d i n g file in t h e O u t b o u n d File field in t h e t a b w i t h t h e s a m e n a m e .

C r e a tin g a file p o r t

g if ] I I 0 P£ Q i v

C D Ports

P c ft

2S H 1 _ 0 » T E I

D e s c rip tio n

S a b i n e s F ile P ort

I 1 d l T ra n s a c tio n a l R F C

__ 7 <3 f i i * ___________ CPFR2-VMI DSD.PORT

C o p » OfP O S S IM (for C PFR 2-V M I EDI)

EUPEXPORT POSSIM

D S D F ile -P o rt *0r M o v em en t d a ta W C P o rt Sor ID o c s o f m e s s a g e tn > e E U P E x P P o rt K a s s e n s im u la tlo n

SMFILE SUBSYSTEM

S a b i n e s T e s t p o d fo r F ile s P o rttU f e n E D I -S u b s y s te m v ia O a ie is c h n m s te ile

TICKETS

P o rlfu fV erk a u fsh ilfsm ffiel

v is io n

~7~

S y s te m Sctnr>g

O B o c rec hpes SAP Release 2 0/2 1

p ] Unicode formal

O C o c recftpes SAP Release 3.013 1

□ Continue despite comerslon err or

® lOoc record t»pes SAP Release

OCPt-C

*>

O u t b o u n d Tripper

C D ABAP.PI

Replacement ctiar

i n b o u n d file

S ta tu s m e

I1 O X M L F I I * □

O Logical directory

X M L HTTP

A c cess T est

® p f c r t * a l director*

Oirectory

Function module Descnpoon

E) Satnnes cr»-n Function Module

Outbound file

BBI F ig u re 4 .8 9

F ile P o r t w i t h C u s t o m F u n c t i o n M o d u l e

M o d u l e f o r file

M o r e f r e q u e n t l y , h o w e v e r , file n a m e s a re s u p p o s e d t o b e a s s i g n e d d y n a m ­

n a m e s in file p o rts

ically. I n t h e s e ca s e s , u s e a f u n c t i o n m o d u l e t h a t c o m p r i s e s t h e n a m e o f t h e file f r o m t h e ID o c d a t a , f o r e x a m p l e , f r o m t h e ID o c n u m b e r , t h e c u r ­ re n t tim e , o r s im ila r in fo rm a tio n . T h is way, y o u a v o id t h a t th e sy stem o v e r w r i t e s a n e x i s t i n g file, a n d y o u c a n a ls o f i n d t h e d a t a m o r e easily. F ig u r e 4 . 8 9 s h o w s t h e u s e o f a n a d d i t i o n a l f u n c t i o n m o d u l e t h a t is c r e ­ a ted w ith in the c u s to m e r n a m e s p a c e

(Z _ S M _ P A T H _ C R E A T E _ D A T E _ T IM E ).

M a in te n a n c e

It i s n 't s u ffic ie n t t o s i m p l y i m p l e m e n t t h e r e q u i r e d f u n c t i o n m o d u l e . To

t r a n s a c t io n f o r file

h a v e t h e s y s t e m d i s p l a y it in t h e s e l e c t io n list in t h e file p o r t , y o u m u s t

fu n c tio n m o d u le s

a d d i t i o n a l l y r e g i s t e r it f o r t h e file p o r t s a n d le t t h e s y s t e m k n o w w h e t h e r

13 8

C u sto m Fu n ctio n M o d u le s fo r F ile G e n e ra tio n in F ile P o rts

it u s e s logical o r p h y s ic a l p a t h s . In T r a n s a c t i o n W E 5 5 , y o u i m p l e m e n t th is a s s i g n m e n t b y a d d i n g a n e w e n t i y (see F ig u r e 4 . 9 0 ) . F u n c t i o n m o d u l e s m a r k e d w i t h "L" u s e logical p a t h s ; all o t h e r m o d u l e s u s e p h y s ic a l p a th s .

C h a n g e V ie w "ID o c : F u n c tio n M o d u le s f o r F ile N a m e s": O v e rv ie w ^

E x p a n d < -» C o ll a p s e

j

N e w E n trie i

2

0

D e lim it

Q

v a r ia b le U s t

£}

F o rm

ID o c : F u n c tio n M o d u le s ( o r F ile N a m e s ^ a m e o f fu n c tio n m o d u le

>aTh

>X PATH CREATE

ile n a m e d e t e r m in a t io n fo r th e D X W o r k b e n c h

M t f f l MOUERT -

A s c r ip tio n

3)

. o g i c a l d ire c to ry , file n a m e in f o r m a t T c lie n t d o c n u r r t E

E P I- L P A IH CREATE .USERHAHE

. o g i c a l d i r e c t o r y , f i l e n a m e i n S Y -U N A M E f o r m a t

E D I PATH CREATE C L IE N T DOCNUM

D ir e c t o r y * f i l e n a m e i n f o r m a t T _ C l i e n t _ D o c n u m

E P I PATH CREATE f»ATE TIME

D ir e c t o r y * f i l e n a m e i n f o r m a t T _ C C Y Y M M D D _ H H M M :

E P I PATH CREATE LENGTH LE 8

D ir e c t o r y • f i l e n a m e i n f o r m a t N T H H M M S S T

E P I PATH CREATE "ESTYP

D ir e c t o r y • - m e s s a g e t * p e » _ « l a s t 8 c h a r a c t e r s o f D O

E D I PATH CREATE POS U N IX DOS

D ir e c t o r y * f i l e n a m e ( n a m e l a s t 8 c h a r a c t e r s o f O O C f

E D I PATH CREATE R E T A IL .STORE

D ir e c t o r y * f i l e n a m e i n f o r m a t T _ S t o r e _ « D O C N U M 1 6

H L-P -4TH CREATE USERKM E

D ir e c t o r y • t i l e n a m e i n f o r m a t S Y -U N A M E

;p l

D ir e c t o r y * f i l e n a m e i n f o r m a t T _ S Y -U N A M E _ C C Y Y M I>

path

CREATE USER n a m e pT th

-

M

3 E M -P A E x p o r t F i l e N a m e s

EAP 6EJ. Q U .If.U l p 1LEH&HE

S a b i n e s o w n F u n c tio n M o d u le

[-

E < ] [► ][

F ig u re 4 . 9 0

F u n c t i o n M o d u l e s f o r File N a m e s

T h e s i g n a t u r e o f a f u n c t i o n m o d u l e t h a t w o r k s w i t h logical p a t h s loo k s

S i g n a t u r e for

lik e t h e o n e s h o w n i n L is tin g 4 .6 .

log ical p a t h s

* “ *"L o ca l

in te rfa c e : IM P O R T IN G

* ••

*••

V A LU E (D A T A T Y P E )

L IK E

E D IP O -A C T R IG

V A L U E (D IR E C T O R Y )

L IK E

E D IP O -O U T P U T D IR

V A L U E (F IL E N A M E )

L IK E

E D IP O -O U T P U T F IL E

VA LU E(C O N TR O L)

L IK E

E D ID C

L IK E

E D I_ P A T H -P T H N A M

STRUCTURE

E D I DC

E X P O R T IN G VA LU E (P A T H N A M E ) E X C E P T IO N S LOG I C A L _ P A T H _ E RROR

L is tin g 4 .6

S i g n a t u r e o f a F u n c t i o n M o d u l e U s i n g L o g ic a l P a t h s

139

|

4-3

4

|

C h an g e s to ID o cs

T r a n s a c t i o n FILE

F u r t h e r m o r e , y o u m u s t a ls o d e t e r m i n e t h e p h y s ic a l p a t h , w h i c h h a s b e e n a s s i g n e d in C u s t o m i z i n g in T r a n s a c t i o n FILE. F o r t h i s p u r p o s e , SA P p r o ­ v i d e s a s p e c if ic f u n c t i o n m o d u l e . T h e f o l l o w i n g s a m p l e c o d e (L istin g 4 .7 ) i n d i c a t e s its u se. DATA:

L O G IC A L .P A T H

LO G IC A L _ P A T H CALL

F U N C T IO N

-

L IK E

F IL E P A T H -P A T H IN T E R N .

D IR E C T O R Y .

' F IL E _ G E T _ N A M E _ U S IN G _ P A T H '

E X P O R T IN G *

C L IE N T

- S Y -M A N D T

L O G IC A L _ P A T H

=

L O G IC A L _ P A T H

*

O P E R A T IN G _S Y S T E M

- S Y -O P S Y S

*

PARAMETERS

= ‘

*

P A R A M E T E R .?

- *

USE_BUFFER

= ‘

F IL E _ N A M E

- S Y -U N AM E

U S E _ P R E S E N T A T IO N _S E R V E R

= *

IM P O R T IN G F IL E _ N A M E _ W IT H _ P A T H

=

PA TH NAME

E X C E P T IO N S P A T H _ N 0 T _ F 0 UND

- 1

M IS S IN G _ P A R A M E T E R

=

O P E R A T I N G _ S Y S T E M _ N 0 T _ F 0 UND -

L is tin g 4 .7

2 3

F IL E _ S Y S T E M _ N O T _F O U N D

= 4

OTHERS

= 5

.

S A P F u n c t i o n M o d u l e T h a t D e t e r m i n e s t h e P h y s ic a l F ile N a m e f o r a

L o g ic a l F ile N a m e

S ig n a tu r e for physical p a th s

I f y o u g e n e r a t e a f u n c ti o n m o d u l e t h a t w o r k s w i t h p h y sic a l p a t h s r ig h t fro m t h e b e g i n n i n g , y o u m u s t u s e t h e fo llo w in g s i g n a t u r e (see Listing 4.8 ).

* ” * ” Local *"

in te r fa c e : IM P O R T IN G

* ”

VALUE( DATATYPE)

L IK E

E D IP 0 -A C T R IG

* "

V A L U E (D IR E C T O R Y )

L IK E

E D IP O -O U T P U T D IR

* "

V A L U E (F IL E N A M E )

L IK E

E D IP O -O U T P U T F IL E

VA LU E(C O N TR O L)

L IK E

E D IO C

L IK E

E D IP A T H -P T H N A M

STRUCTURE

E X P O R T IN G V A LU E(PATH N A M E )

L is tin g 4 .8

14 0

S i g n a t u r e o f a F u n c t i o n M o d u l e U s i n g P h y s ic a l File P a t h s

E D I DC

C u sto m ID o c s

4 .4

C u sto m ID o cs

T h e p r e r e q u i s i t e f o r u s i n g c u s t o m ID o c s a r e c u s t o m t a b l e s f r o m w h i c h d a t a is r e t r i e v e d f o r s e n d i n g t h e ID o c s a n d s t o r e d in i n b o u n d p r o c e s s i n g . As a n e x a m p l e , t h e d e s c r i p t i o n s in t h e f o l l o w i n g s e c t i o n s u s e a s i m p le ca se w i t h o n l y a f e w fie ld s , w h i c h n e v e r t h e l e s s c o v e r s all a s p e c t s t h a t a re r e l e v a n t t o ID ocs. T h i s e x a m p l e u s e s a h ea d e r ta b le a n d a n ite m ta b le. T h e i t e m t a b l e c o n ­

D a ta fo r the

t a i n s s e v e r a l i d e n t i c a l fie ld s t h a t t h e ID o c p r o c e s s e s u s i n g a q u a l i f y i n g

c u s to m ID o c

s e g m e n t . D u e to t h e d iffic u lt r e u s a b ility , SA P d o e s n ' t r e c o m m e n d t h e u s e o f q u a lif ie r s . I n t h e s t a n d a r d v e r s i o n , h o w e v e r , q u i t e a lo t o f q u a lifie r s still e x is t s o t h a t y o u m a y n o t b e a b l e to a v o i d u s i n g t h e m . F ig u r e 4 . 9 1 d i s p l a y s t h e s t r u c t u r e o f a h e a d e r t a b l e . A n i n t e r f a c e p r o j e c t

H e a d e r ta b le

u s u a l l y a l r e a d y i n c l u d e s t h e s e t a b l e s s o t h a t y o u c a n u s e t h e m in y o u r ID o c . To i l lu s t r a te t h e r e l a t i o n s h i p b e t w e e n ID o c a n d d a t a r e c o r d , t h e a p p l i c a t i o n t a b l e s w e r e c r e a t e d a s w e ll a n d n o t c o n s i d e r e d a s e x is tin g .

Dictionary: Maintain Table fg

Rj

£0

I

T ra n s p T a b le

ZSHH

S h o rt D e scrip tio n

( s m H eader

A ttribute s

O r

00

n

ANDT j_ n

D e liv e ry a n a M aintenance

—

0

0

Entry h e lp /c h e c k

D a ta elem e nt

D a ta T y

HAND!

C IN T

■jr

CHAR

n

CHAR4Q

CHAR

□

□

: har- q

fH A P

□

□

0 □

:ELP2

F ig u re 4.91

1

S rc h H e lp Key mm

CL 0 1

T e c h n ic a l S e ttin g s

In d e x e s .

A p pend Structure

| Active

X p s iB iE jg Field

ftg if f l

0 '

vnon

C urrencyJQ uantity F ields

11 P re d e fin e d T ype |

Length D e c im

[S h o rtO e s c rip to n

0 C lien t

|

3 30

0 P a rtia l key o» SAP object

| {

40

O C haracter fie ld o f le n g th 40

u

m 1

iaio M 1aenn u^narauerrC ie L glh ui-— i1fut

S a m p l e H e a d e r Tab le

T he ite m tab le th a t b e lo n g s to th e h e a d e r ta b le c o n ta in s a n ite m n u m b e r as a n a d d i t i o n a l k e y field, t h r e e s i m i l a r fie ld s f o r t h e q u a l i f i c a ti o n , a n d a q u a n t i t y field w i t h a u n i t o f m e a s u r e m e n t f o r a s p e c ia l i m p l e m e n t a t i o n f o r s o m e u n i t s o f m e a s u r e m e n t . F ig u r e 4 . 9 2 d i s p l a y s t h e d e f i n i t i o n o f t h e i t e m ta b le in T r a n s a c t i o n SE11.

14 1

Ite m ta b le

|

4 -4

4

|

C h an g e s to I D ocs

D ic tio n a ry : M a in ta in T a b le C8

I 4&

;

< *

T ra n s p Table

ZSHP

S h o rt D escription

SM Position

A ltnbutes

A

a

Q jl

3 ^ !9

Entry help/check

E B B |K e y [in iii

Srch H e p

|p a ta elem ent

lPala Ty-

E B JMHOT 0. B * E Y FEID 0 E

1ANDT

KET1 J&NR

PELDA EIL&S

□

0 Client key o f SAP object

1e m n u m b e r o f the S O docum ent

CHAR

6

CHAR

6

0 C h a ra c te rfie ld o n e n g th 6

CHAR

6

0 C h a ra c te r fie ld o f le n g th 8

t5

JD

jHEKfilS

OUAN

1E1NA

□ '"E1NA -C- n

UNIT

□

30

NUtlC

,CH»B6

T^

Predefined

Length |D ecim [SM ort D escription

CHAR

1EN6E

F ig u re 4 .9 2

A p pend Stiucture

CurrencyfO uantity Fields

C IN T

□ □ CUM □ □ ia*£i

F£LP&

In d e ie s

A c tf*

D e l w r y and Maintenance

Field

Technical Settings

3;

0 Character fie ld o f le n g th 6

3 Quantity field, 15 characters

0 u n it o f m easure

S a m p l e I t e m T a b le

Q u a n t i t y fie ld s

F o r t h e M e n g e fie ld , y o u n e e d to s p e c i f y w h i c h r e f e r e n c e u n i t o f m e a ­

in t h e D a ta

s u r e is s u p p o s e d to b e u s e d . F ig u r e 4 . 9 3 d i s p l a y s it i n t h e R e f e r e n c e Table

D ic tio n a ry

a n d R e f e r e n c e F ie ld c o l u m n s .

D ic tio n a r y : M a in ta in T a b le Id

. - 5-

«a

0-0 :

*

Transp Table

zsup

S nort Description

$M Position

a

4

11

J ii [Ifl

Technical SetDngs

Fields

Fn'ryhPlp/rhcfk 1 / 8

Search Help ] _ Field

|D ata elem ent

iD ataT y [Reference table

HANOI

HANDT

C IN I

KEY.FELO

CHAR

POSNR ELDA -

hunc

(CWAR6 ___________

1

CHAR6

CHAR

ELDC

CHARS

CHAR

HEN815

QUAN

KE1NA

UNIT

EINA

F ig u re 4 .9 3

|R e f field

IShoct Description Client Partial keyotS A P obiect

■[ 1

ELDB

IIENGE

in p u t h e lp

POSNR

1

Append Structure

Active

Attributes

EY1

lnde»es

1— ........1. ■■■1■ ... ■!

nem num ber o f the SD document

1■ ■----- Character fie ld o f length 6 Character fie ld o f length 6

ZSHP

HE1NA

Quantity field. 15 characters Unit o f measure

R e f e r e n c e U n i t o f M e a s u r e i n t h e I t e m T a b le

You s h o u l d p r o v i d e a n i n p u t h e l p o r c h e c k t a b l e w h e r e v e r p o s s i b l e (see F ig u re 4 . 9 4 ) . In t h e

Z SMP

s a m p le table, th e in p u t h e lp s are e n a b le d for

t h e KEY1 fie ld , w h i c h s h o u l d r e f e r t o t h e h e a d e r ta b le , a n d f o r t h e u n i t o f m e a s u r e field (M E IN A ), w h i c h is c o p i e d f r o m C u s t o m i z i n g . In a d d i-

14 2

C u sto m ID o c s

|

t i o n , SAP d e l i v e r s a c h e c k t a b l e f o r t h e c l i e n t ( M A N D T field). T h i s ta b le is u s e d h e r e .

D ic tio n a ry : M a in ta in T a b le &

*9

0

«*r

T ra n s p T a b le

Z S "P

S h o d D e s c rip tio n

SM P o s itio n

A ttrib u te s

v fK

A

'|g

* £ [ S o a r c h H e lp

1 /

D a ta e l e m e n t

D a ta T y

HANDT

HANDT

vlN T


fCHAR 111 fv

P O S ttt

Nunc

!EY1

F o re ig n

FElD A

CHAR6

CHAR

FE108

JHATO

CHAR

FELOC

:h a m

CHAR

flEHSE

"E K 615

IUAH

S* n'F tI»nn

H F 1n K nl

INI T

4.4.1

iC h e c n a b ie

im

A p p e n d S tru c tu re

8

O rig in o f t h e in p u l h e lp

SWA la g iA

S r c h H e lp

h 9 lP 1 « o le » e n t# d f l t h

«hl H J M 3

h g .i g

cnt

iM ic » e n v r q

* u h

D

D o m a in HANDT rU N* r1M ' fit

----------

F ig u r e 4 . 9 4

In d e x es

F ie l d ' ■ ^ a r . T i C u r r e n c w o u a n t i t v f i e l d s

F ie ld

P0SH R

T e c h n ic a l S e t t in g s

A c ih «

D e liv e ry a n d M a in te n a n c e

l” t e l

§ £ jfl

t

T .H A I6 ;

T1O ‘ ‘M‘

n rviit h ^ l r

a i t h rh f

!vw y

h . ro

- 3LN .6.1.5 - ■QklZw

E n trie s f o r t h e I n p u t C heck

C r e a t in g C u s to m ID o c T y p e s a n d M e s s a g e T y p e s

To u s e t h e

ZSMH

and

ZSMP

s a m p l e t a b l e s in a n ID o c , y o u m u s t c r e a t e

th e c o r re s p o n d in g c u s to m s e g m e n ts . S ectio n 4 .2 .3 , C u s to m S e g m e n ts, a l r e a d y i n t r o d u c e d t h e c r e a t i o n o f s e g m e n t s in t h e c o n t e x t o f e n h a n c e ­ m e n t s f o r SAP I D o c s . A t t h i s p o i n t , h o w e v e r , s o m e g e n e r a l r e m a r k s c o n ­ c e rn in g s e g m e n ts n e e d to b e m a d e , w h ic h re fer m o re to d esig n g u id e ­ l in e s t h a n h a n d l i n g . In g e n e ra l, a s e g m e n t c a n c o n ta in u p to 1 ,0 0 0 ch a rac te rs. F or p e rfo rm a n c e re aso n s, y o u s h o u ld tra n s fe r as fe w s e g m e n ts as p o ssib le b ec au se e a c h s e g m e n t e n t a i l s a d d i t i o n a l c o n t r o l i n f o r m a t i o n . S o i t's u s e f u l to g e n e r a t e s e g m e n t s t h a t a r e a s l o n g a s p o s s i b l e . B ut y o u h a v e t o p e r f o r m a b a la n c in g act h e re : T h e e x te rn a l le n g th m a y b e g re a te r th a n th e len g th o n t h e d a t a b a s e : c o n s e q u e n t l y , y o u c a n ' t f u lly u s e t h e

1,000 c h a r a c t e r s

f o r t h e i n t e r n a l l e n g t h . I f t h e t a b l e t o w h i c h t h e s e g m e n t b e l o n g s is larg e r, y o u m a y w a n t t o a d d fie ld s t o t h e s a m e s e g m e n t d e f i n i t i o n a t a later stag e. T his s h o u ld a lso b e c o n s id e r e d w h e n d e fin in g th e le n g th o f t h e in itia l s e g m e n t .

143

S e g m e n t s iz e

4 -4

4

|

C h an g e s to ID o c s

R e u s a b ility

You s h o u l d a ls o t r y to g e n e r a t e r e u s a b l e s e g m e n t s f o r y o u r o w n i n t e r e s t (to r e d u c e y o u r w o r k ) . F o r e x a m p l e , i f y o u w a n t to h a v e d i f f e r e n t ta b le s w ith a d d re s s d ata, y o u o n ly g e n e r a te o n e s e g m e n t fo r th e m . In th is se g ­ m e n t , y o u c a n fill w h a t e v e r fie ld s a r e n e e d e d in a s p e c if ic case. T h e fields s h o u ld be lo n g e n o u g h so th a t y o u can also u s e th e m fo r t h e lo n g est e n t r i e s f r o m t h e t a b l e s . O f c o u r s e , y o u c a n a l s o r e u s e SAP s e g m e n t s . So i f y o u k n o w a s u i t a b l e SA P s e g m e n t , f ir s t c h e c k i f it m e e t s y o u r r e q u i r e ­ m e n ts b e fo re creatin g a c u s to m seg m en t. I f y o u a l r e a d y k n o w t h a t y o u w a n t t o i m p l e m e n t c o m m u n i c a t i o n v ia ED I, a ls o h a v e a l o o k a t t h e c o r r e s p o n d i n g EDI m e s s a g e . I f t h i s m e s s a g e f o r t h e E D I field t h a t c o r r e s p o n d s t o t h e SAP field a l l o w s f o r a g r e a t e r field l e n g t h , u s e t h e E D I field l e n g t h in y o u r s e g m e n t a n d n o t t h e s h o r t e r SAP fie ld l e n g t h . T h i s a l s o fa c i l it a t e s l a t e r c o n v e r s i o n s . It c a n a l s o b e u s e f u l to c h e c k w h i c h fie ld s a r e u s e d t o g e t h e r i n t h e EDI s t a n d a r d w h e n c o m b i n i n g fie ld s in a s e g m e n t d e f i n i t i o n . I f y o u t h e n a c t u a l l y c o m b i n e t h e s e fie ld s in a s e g m e n t , t h i s a l s o fa c i l it a t e s t h e c o n v e r s i o n to t h e EDI s t a n d a r d . To m e e t t h e E u r o p e a n s t a n d a r d , EDIFACT, r e f e r t o t h e i n f o r m a ­ t i o n p r o v i d e d o n h ttp ://w w w .e d ifa c to ry .d e .

S e g m e n t fo r

F o r t h e ZSMH a n d ZSMP ta b le s , t h r e e s e g m e n t s w e r e c r e a t e d a s e x a m p l e s :

th e header

o n e f o r t h e h e a d e r , o n e f o r t h e t h r e e s i m i l a r field s, a n d o n e f o r t h e r e m a i n i n g fie ld s o f t h e i t e m t a b l e . All s e g m e n t s a r e v e r y s h o r t b e c a u s e t h e y r e f e r to s a m p l e d a t a a n d n o t to real d a ta . F ig u r e 4 . 9 5 d i s p l a y s t h e h e a d e r s e g m e n t . T h e S e g m e n t f o r t h e P o s itio n e l e m e n t s o n l y c o n t a i n s t h e i t e m n u m b e r . B e c a u s e ID o c s h a v e a h i e r a r c h i ­ cal s t r u c t u r e , y o u d o n ' t h a v e t o r e p e a t t h e KEY1 k e y fie ld o f t h e h e a d e r tab le. T h is w o u ld o n ly p lace an u n n e c e s s a ry load o n th e system .

S e g m e n t fo r the

As y o u c a n s e e in F ig u re 4 . 9 6 , t h e c h e c k b o x f o r t h e ISO c o d e is s e le c te d

ite m ta b le

f o r t h e u n i t o f m e a s u r e (M EIN A ). You still h a v e to p r o g r a m th is i m p l e m e n ­ t a t i o n , a s t h e c h e c k b o x s e r v e s f o r i n f o r m a t i o n o n ly . A c h a r a c t e r d a t a e l e ­ m e n t w i t h a c h a r a c te r i s t ic t h a t h a s t w o c h a r a c te r s m o r e (CHARI 7) h a s b e e n s e l e c t e d f o r t h e M E N G E field, w h i c h h a s 1 5 c h a r a c te r s in t h e ZSMP table. As y o u recall, t h i s a d d i t i o n is n e c e s s a r y to t r a n s f e r t h e d e c i m a l p o i n t a n d a p o s s ib ly e x i s t i n g m i n u s sign to t h e p a r t n e r in t h e e x t e r n a l fo r m a t.

14 4

C u sto m ID o c s

|

D evelopm ent segm ents: D isp la y segm ent d e fin itio n Z 2ZSMH 000 B S e g m e n t ty p e a ttrib u te s S e g m e n ily p e

Z1ZSH H

S h o rt D e s c rip tio n

S a b in e s S e g m e n t fo r ZSM H

Segm definition

Z2ZSHH000

Last Changed By

"AISELSA

[~

)ata elem ent

|p o s (Field N am e i | KEY1

KEr_FEL0

2

FELD1

CHAR40

3

FEL02

CHAR10

F ig u re 4 .9 5

Qualified segment

S O c o jE x p .n

n

39

E

40

R

0J

S e g m e n t f o r t h e H e a d e r Tab le

Developm ent segm ents: D isplay segm ent definition Z2ZSMP000 9 Segm ent type attnbutes

—

r Qualified segment

S e g m en ir/p e

Z1ZSHP

Short Description

Sabines Segm ent for ZSMP

Segm definition

Z2ZSHPQ00

Last Changed By

HA1SELSA

|POS

■leidName

)ata elem ent

S O CO

t

POSNR

POSHR

□

2

HEN&E

CHARt7

n

3

HEINA

MEINA

F ig u re 4 . 9 6

Id 7

H

S e g m e n t f o r t h e I t e m T a b le

F in a lly t h e r e is t h e t h i r d s e g m e n t , w h i c h w ill b e c a lle d Z1ZSMQ. A q u a lify ­

Q u a lif ie r in th e

in g s e g m e n t is s u p p o s e d t o b e u s e d h e r e . You c a n t r a n s f e r v a r i o u s fields

D D IC

to a q u a l i f y i n g s e g m e n t . A c o n t r o l l i n g fie ld , c a ll e d t h e q u a lifier, t h e n i n d i c a t e s w h i c h field is m e a n t . You u s e t h e s e fie ld s i f y o u d o n ' t k n o w h o w m a n y o f t h e fie ld s t h a t a r e i d e n t i c a l w i t h r e g a r d to t h e p r o p e r t i e s w i l l b e t r a n s f e r r e d . In o u r e x a m p l e , t h e field c a n o c c u r z e r o to t h r e e tim e s, a n d y o u d e c id e d e p e n d in g o n th e q u alifier in to w h ic h o f th e th ree field s, FELDA, FELDB, o r FELDC, t h e r e s p e c t i v e v a l u e is s u p p o s e d t o be e n t e r e d . You a l r e a d y k n o w t h i s p r o c e d u r e f r o m p a r t n e r r o l e s in Sales a n d D i s t r i b u t i o n (SD) o r M a t e r i a l s M a n a g e m e n t ( M M ) in SAP. T h e p r e ­ r e q u i s i t e h e r e , h o w e v e r , is a s p e c if ic d o m a i n f o r t h e q u a lifie r , w h i c h has a l r e a d y b e e n c r e a t e d a s y o u c a n s e e in F ig u r e 4 .9 7 .

145

4 -4

4

|

C h an g e s to ID o cs

D ictionary: M aintain D om ain

D o m a in

ZSfiOUAL

Short Description

ZSMQUAL

Properties

Actr^e

V a lu e Range

F o rm a l D a ta Type

CHAP

N o C h ara cters

C h a ra c te r String «

0

D e c im a l P laces

O utput Characteristics O utpu t Length Convers Routine

□

L o w e rc a s e

F ig u re 4 .9 7

D o m a in fo r the q u a lifie r

D o m a in fo r t h e Q u a lifie r

You t h e n d e f i n e t h e p o s s i b l e i n p u t v a l u e s in t h e V a lu e R a n g e t a b o f t h e d o m a i n . In o u r e x a m p l e , t h i s is "A" o r "B" o r “C ” (s e e F ig u re 4 . 9 8 ) . If y o u u s e o n l y o n e v a l u e r a n g e in t h e d o m a i n , t h e I D o c d o c u m e n t a t i o n d i s p l a y s w h i c h s e l e c t i o n o p t i o n s a r e a v a il a b le f o r t h i s field.

D ic tio n a r y : M a in ta in D o m a in

0 E

g

«a; ■To • *

D o m a in

ZSH0UAL

Short Description

ZSMOUAL

Properties

o% b

a Active

Definition

iKltalBlB lB H I Sin g le Vais Fw Val *

|Short Descript

B elon gs to FELDA

3

B elon gs to FELDB

:

B elon gs to FE LDC

F ig u re 4 *9 8

L i s t o f t h e I n p u t V a lu e s

D a ta e le m e n t fo r

You t h e n u s e t h i s d o m a i n t o c r e a t e t h e a p p r o p r i a t e d a t a e l e m e n t in t h e

th e q u a lifie r

n e x t s t e p in T ra n s a c tio n SE11. F o r th is p u r p o s e , as s ig n a m e a n i n g f u l n a m e w i t h i n t h e c u s t o m e r n a m e s p a c e , a n d r e f e r to t h e n e w l y c r e a t e d d o m a i n . F igu re 4 . 9 9 illu s tra te s th is u s i n g t h e

ZSM OUAL

d a ta e l e m e n t a s a n e x a m p l e .

C u sto m ID o c s

D ic tio n a ry : M a in ta in D a ta E le m e n t □

Qr Data e le m e n t

ZSHQUAL

S hort D e scrip tio n

ZSMQUAL

Attr.buies

|

D o cum entation

S u pple m entary D ocum entation

Actwe

Further C h aracteristics

F ie ld Label

® E lem entary Type ® Dom ain

ESHQUAL

O P redefined T*pe

g tM Q U A L

Data Type

CHAR

C h a ra c te r String

Length

1

D e c im a l P la c e s

0

Data Type

0

Length

D e c im a l P la c e s

0

O R eference Type

Data Type

0

Length

F ig u re 4 . 9 9

D e c im a l P la c e s

0

D ata E le m e n t fo r th e Q u a lifie r

T h e ( a d m i t t e d l y r a t h e r s m a ll) s e g m e n t in o u r e x a m p l e n o w m e r e l y c o n ­

Q u a lify in g

t a i n s a fie ld f o r t h e q u a l i f i e r a n d a n a d d i t i o n a l fie ld . T h i s field h a s t h e

segment

p r o p e r t i e s o f t h e field t h a t t h e t a b l e c o n t a i n s t h r e e t i m e s in a n id e n tic a l f o r m a t , FELDA, FELDB, o r FELDC. F ig u r e 4 . 1 0 0 d i s p l a y s t h e t h i r d , q u a l i ­ f y i n g s e g m e n t o f o u r e x a m p l e as Z1ZSMQ.

D e v e lo p m e n t s e g m e n ts : D is p la y s e g m e n t d e fin itio n Z 2 Z S M Q 0 0 0

S e g m e n t ty p e a t t r ib u t e s S e g m e n tfrp e

212SH0

S h o rt D e scription

S e g m e n tto r q u a litn n g Fields

S e g m d efin ition

Z2ZSKQ 0D 0

L a s t C h a n g e d By

H A 1SELSA

Po s

E R eleased

F ie ld N a m e

D a t a e le m e n t

Q U «L

2SHQ U AL

FELD

CHAR6

F ig u re 4.100

('S O c o jE x p jg

n

a a

Q u a lify in g Segm ent

D o n 't f o r g e t t o r e le a s e all s e g m e n t s a s d e s c r i b e d in S e c tio n 4 . 2 .3 , C u s to m

C u s to m ID o c

S e g m e n t s . A f t e r th a t, t h e s y s t e m b u i l d s t h e I D o c t y p e f r o m t h e s e g m e n t s .

b a s ic t y p e

147

|

4 -4

4

|

C h an g e s to ID o c s

T h is is a g a i n i m p l e m e n t e d in T r a n s a c t i o n W E 3 0 ; t h i s t i m e , h o w e v e r , y o u c r e a t e a s p e c if ic b a sic t y p e . T h e a l r e a d y k n o w n n a m i n g r u l e s ("Z," “Y," o r /< N A M E S P A C E > / a t t h e b e g i n n i n g o f t h e n a m e ) a p p l y h e r e a s w e ll. F ig u re 4 . 1 0 1 d i s p l a y s t h e s c r e e n w i t h t h e g e n e r a l s p e c if ic a t i o n s f o r t h e ID o c t y p e .

N e w bas ic ID oc type ® C re a te n e w

O C re a te a s co p y

O C re a te s u c c e s s o r

C o p y fro m

S u c c e s s o r of

A d m inistration P e rs o n re s p o n s ib le

MAJSELSA

P ro c e s s in g p e rs o n

MAJSELSA

D e scrip tion_______ | S a b in e s ID o c i y p

UBl

0 0 ________________________ F i g u r e 4.101

C re a tin g a C u s to m ID o c Type

S p e c ific a tio n s fo r

First, e n t e r t h e m a i n o r r o o t s e g m e n t in t h e S e g m e n t T y p e field (in o u r

th e ro o t segm ent

e x a m p l e , t h i s is

t h e s e g m e n t f o r t h e h e a d e r t a b l e , Z1ZSMH). It c a n o c c u r

o n l y o n c e b u t h a s to o c c u r, w h i c h is w h y t h e M a n d a t o r y S eg. c h e c k b o x is s e l e c t e d (s e e F ig u r e 4 .1 0 2 ) . In s e rtin g s e g m e n ts

A f t e r w a r d , c r e a t e t h e i t e m s e g m e n t ( h e r e : Z1ZSMP), w h i c h c a n o c c u r a n y n u m b e r o f t i m e s (s e e F ig u r e 4 . 1 0 3 ) . E v e n t h o u g h i t's o p t i o n a l , y o u m u s t s e t t h e m i n i m u m n u m b e r o f o c c u r r e n c e f o r t h i s s e g m e n t t o “1." B e c a u s e t h e M a n d a t o r y S eg. c h e c k b o x i s n ' t s e l e c t e d , t h e s e g m e n t c a n a l s o be m i s s i n g . B e fo r e y o u n a v i g a t e to t h e a t t r i b u t e m a i n t e n a n c e , t h e s y s t e m a s k s y o u a t w h i c h lev el y o u w a n t t o a d d t h e s e g m e n t .

A d d itio n a l

In o u r e x a m p l e , t h e q u a lify in g s e g m e n t , Z1ZSM0, w a s also a d d e d a t t h e child

segment

lev el b e c a u s e it w ill b e g e n e r a t e d f r o m t h e s a m e ta b le r e c o r d a t a l a t e r stage (see F ig u re 4 .1 0 4 ) . You c a n n o w b u i l d y o u r e n t i r e ID o c t h i s w ay.

14 8

C u sto m ID o c s

C re a te b a s ic ty p e : ZSM TYP01

Its - M ain tain A ttributes

S e g m .ty p e 0

0

/

Z1ZSMH

M andatory seg

M in im u m n u m b e r

1

M a x im u m n u m b e r

1

P a re n t se g m e n t H ie r level

0

S )

F ig u re 4 1 0 2

D e fin in g th e R o o t S egm ent

C re a te b a s ic ty p e : Z S M T Y P 0 1

H

S a b in e s

Z1ZSH H

IO o c

T yp

S a b in e s Segm ent f o r ZSHH

| [ e * S e g m e n t H ie r a r c h y

0

/

® A d d s e g m e n t type a s c h ild O A d d s e g m e n t type a t s a m e level

0

[* & M a in ta in A ttributes

S e g m ty p e

0

/

Z1ZSMP

□ M an d a to ry s e g . M in im u m n u m b e r

1

M a x im u m n u m b e r

99

P a re n t s e g m e n t H le r.le v e l

^

F ig u r e 4.103

|8

S e g m e n t ed ito r

[

%

S p e c ific a tio n s fo r th e Ite m S e g m e n t

149

|

4 -4

4

|

C h an g e s to ID o cs

C re a te b a s ic ty p e : Z S M T Y P 0 1

S a b in e s !0 o c Typ ZIZSflH

S a b in e s Segment f o r ZSHH

Z1ZSNP

S a b in e s Segm ent f o r ZSHP

E * Segm ent Hierarchy

0 /

® A d d s e g m e n t t ip e a s child O A d d s e g m e n t type a t s a m e level ✓

X

0/

| [ g M aintain A ilnDutes

z iz s n o

S e g m trp e □ Mandatory seg Minimum number

1

Maximum num ber

99

Parent segment Hierievei

* F i g u r e 4 *1 0 4

S p e c ific a tio n s f o r t h e Q u a lif y in g S e g m e nt

D o c u m e n t a t i o n in

T r a n s a c t i o n W E 6 0 e n a b l e s y o u to h a v e t h e s y s t e m d i s p l a y t h e d o c u m e n ­

T ra n s a c tio n W E 6 0

t a t i o n f o r y o u r ID o c t y p e . T h e s y s t e m a u t o m a t i c a l l y g e n e r a t e s t h e d o c u ­ m e n ta tio n fro m th e d a ta th a t y o u sp ec ifie d . T h e s tr u c tu r e d e s c rip tio n (see F ig u r e 4 . 1 0 4 ) t h e n m i g h t l o o k a s s h o w n in T a b le 4 . 1 . Basic Type

ZSMTYP01

Z S M T Y P 01

S a b i n e s I D o c Ty p e

Z1ZSM H

Sa b i n e s S e g m e n t

for

ZSMH

S ta tu s : m a n d a to ry , m in im u m n u m b e r : 1, m a x im u m n u m b e r: 1 Z1ZSM P

Sa b i n e s S e g m e n t

for

ZSMP

S t a t u s : o p t i o n a l , m i n i m u m n u m b e r : 1, m a x i m u m n u m b e r : 9 9 Z1ZSM Q

Se g m e n t

for

Q

u a l if y in g

F ie ld s

S t a t u s : m a n d a t o r y , m i n i m u m n u m b e r : 1, m a x i m u m n u m b e r :

3 T a b le 4-1

150

Z S M T Y P 0 1 B asic Type

C u sto m ID o c s

|

4 -4

T h e r e m a i n i n g p a r t o f t h e d o c u m e n t a t i o n i s n ’t d e s c r i b e d h e r e b e c a u s e y o u c a n o b t a i n t h e c o r r e s p o n d i n g i n f o r m a t i o n f r o m t h e p r e c e d i n g figures. W h e n t h e ID o c t y p e is c o m p l e t e , y o u h a v e to c r e a t e t h e m e s s a g e ty p e .

C u s to m m essage

T h i s is d o n e in T r a n s a c t i o n W E 8 1 ( t h e m e s s a g e t y p e is c a ll e d "log ical

typ e

m e s s a g e " h e r e ) . F ig u re 4 . 1 0 5 s h o w s t h e ZSMNACH s a m p l e m e s s a g e t y p e .

N e w E n trie s : O v e rv ie w o f A d d e d E n trie s I s B

l P

E D I: L o g ic a l M e s s a g e Types _

M e s s a g e Typ e

[S h o rt text

ZSHNACH

jS a b in e s M e s s a g e Type)

F i g u r e 4 -1 0 5

C re a tin g t h e M e s s a g e Type

In T r a n s a c t i o n W E 8 2 , t h e m e s s a g e t y p e a n d t h e ID o c t y p e t h a t h a s b e e n

M essage

c r e a t e d as t h e b a s i c t y p e a r e a s s i g n e d t o e a c h o t h e r . F ig u r e 4 . 1 0 6 d i s ­

ty p e -

p l a y s t h i s a s s i g n m e n t f o r t h e p r e v i o u s l y c r e a t e d o b j e c t s , ZSMNACH a n d

ID o c typ e

ZSMTYP01. N e w E n trie s : O v e rv ie w o f A d d e d E n trie s Q. IE SI DO utp ut T y p e s a n d A s s ig n m e n t to ID o c Types M e s s a g e Typ e

[Basic type

ZSHNACH

jZSHT YP01

IS F ig u re 4 1 0 6

lE n le n s io n

(R e le a s e

r f

700

I

B

R

Bl

A s s ig n in g t h e ID o c T ype t o t h e M e s s a g e Type

A f t e r y o u ' v e c o m p l e t e d e v e i y t h i n g , y o u c a n a g a i n c h e c k y o u r r e s u l t s . As y o u c a n s e e in F ig u re 4 . 1 0 7 , e v e r y t h i n g is o k a y f o r o u r s a m p l e IDoc. I f y o u n e e d a d d i t i o n a l f u n c t i o n s , s u c h a s r e d u c t i o n s o r lin k s t o b u s i n e s s o b j e c t t y p e s , y o u c a n c o n f i g u r e t h e m in T r a n s a c t i o n B D 6 0 . T h is t r a n s ­ a c t i o n is o p t i o n a l b e c a u s e a " n o r m a l " ID o c d o e s n ' t n e e d t h e s e s e t t i n g s . H o w e v e r , y o u a l r e a d y k n o w t h e m f r o m o t h e r S M D f u n c ti o n a li t i e s .

15 1

C h e c k lo g

4

|

C h an g e s to ID o cs

L o g d is p la y ^

fc-

**

a

Ifi] [m il

L o n g Text

C h eck b a s i c t y p e ZSMTYP01

9 9

B a s ic t y p e

ZSHTYPOi e x i s t s

B a s ic t y p e

ZSHTYPOI 1 s r e l e a s e d

B a s ic t y p e

ZSNTYP01 i s

lin k e d t o

lo g ic a l

a e s s a g e ZShHACH

No p r e d e c e s s o r s e x i s t C h eck s e g m e n t Z1ZSHH S e g t e n t Z1ZSMH c o n s i s t e n t C h eck s e g m e n t Z1ZSHP S e g » e n t Z1Z S H P c o n s i s t e n t C h eck s e g m e n t Z1ZSHQ Se g m en t Z1Z S M 0 c o n s i s t e n t

F ig u re 4 1 0 7

C h e c k L o g f o r Su ccess

P ro p e rtie s o f th e

F ig u r e 4 . 1 0 8 s h o w s p o s s i b l e R e f e r e n c e M e s s a g e T y p e , F o r m a t F u n c t i o n

m essage typ e

M o d u le , a n d R ed u cab le M essag e Type p ro p e rtie s fo r o u r s a m p le m essage t y p e . O b j e c t t y p e s a n d c la s s ific a tio n d a t a h a v e n ' t b e e n c r e a t e d b e c a u s e t h i s h a s to b e d o n e b y t h e d e v e l o p e r s o f t h e a p p l i c a t i o n . T h e o b j e c t ty p e s s e r v e t o c r e a t e lin k s , a n d t h e c la s s ific a tio n d a t a is r e q u i r e d i f y o u w a n t to s e n d m a s t e r d a t a v i a d i s t r i b u t i o n c lass ty p e s .

N e w E n trie s : D e ta ils o f A d d e d E n trie s

M e s s a g e Typ e

ZSH n a c h

A dditional D a ta fo r M e s s a g e T y p e / A dditional D ata R e fe re n c e M e s s a g e Type F o rm a t Function M odule E

R e d u c a b le M e s s a g e Type

C la s s ific a tio n D a ta C la s s ifia b le O b jec t A L E O b je c t Type

□

C h a n g e P o in te r. M e s s a g e Typ e S u p p o rts T a b le B D C P 2

F ig u r e 4.108

152

S M D S e ttin g s fo r t h e " Z S M N A C H " M e s s a g e T ype

C u sto m ID o c s

|

4 -4

You c a n n o w b e g i n g e n e r a t i n g a n d p r o c e s s i n g t h e a p p r o p r i a t e ID o c s fo r th i s m e s s a g e a n d ID o c ty p e .

4 .4 .2

G e n e r a t in g a n ID o c

W h e n c r e a t i n g a n ID o c , y o u s h o u l d o b s e r v e s o m e r u l e s i n a d v a n c e : ► T h e p r o g r a m s h o u l d o n l y g e n e r a t e s e g m e n t s t h a t c o n t a i n fie ld s t h a t

P ro g ra m m in g g u id e lin e s

a r e n ’t initial. ► T h e s e g m e n ts m a y o n ly c o n ta in a lp h a n u m e ric ch a rac te rs b ec au se th e f o r m a t is s u p p o s e d t o b e g e n e r a l l y c o m p r e h e n s i b l e . ► F o r all l a n g u a g e s , c u r r e n c i e s , a n d u n i t s o f m e a s u r e m e n t , u s e t h e c o r ­ r e s p o n d i n g ISO v a l u e s a s t h e s t a n d a r d v e r s i o n d o e s . SAP p r o v i d e s f u n c t i o n m o d u l e s f o r c o n v e r s i o n s , w h i c h y o u c a n a l s o u se. ► A s c o m m o n f o r a l p h a n u m e r i c c o n t e n t , a ll fie ld s s h o u l d b e filled lefta l i g n e d . You c a n u s e t h e CONDENSE c o m m a n d f o r t h i s p u r p o s e . ► F o r d e c i m a l n u m b e r s , t h e s y s t e m a l w a y s u s e s a p o i n t a s t h e d e c im a l s e p a r a t o r ; t h e p o s s i b l y e x i s t i n g m i n u s s ig n is i n d i c a t e d a t t h e e n d . T h o u san d s se p a ra to rs are n e v e r used. ► A f l o a t i n g p o i n t n u m b e r is d i s p l a y e d w i t h a p o i n t as t h e d e c i m a l s e p ­ a ra to r a n d w ith o u t a th o u s a n d s sep arato r. A p o ssib le ex istin g m in u s s ig n is i n d i c a t e d a t t h e b e g i n n i n g t h i s t i m e ; t h e e x p o n e n t is a l w a y s a t th e end. ► D a te fie ld s a r c d i s p l a y e d in t h e s a m e w a y a s o n t h e d a t a b a s e , t h a t is, in t h e y y y y M M d d fo r m a t. ► T i m e s a r e a l s o d i s p l a y e d in t h e s a m e w a y a s o n t h e d a t a b a s e , t h a t is, in t h e H H m m s s f o r m a t . T h e r e a r e t h r e e o p t i o n s f o r g e n e r a t i n g a n ID o c : You c a n g e n e r a t e a d i r e c t tran sa ctio n o r a direct s e n d re p o rt, u se m essag e contro l, o r w o rk w ith ch an g e p o in ters. T h e resp ectiv ely re q u ire d C u sto m izin g fo r th e n ecessaiy t r a n s a c t i o n c o d e s a n d a s s i g n m e n t s o f t h e f u n c t i o n m o d u l e s is d e s c r i b e d in C h a p t e r 2 , S e c t i o n 2 . 1 , S t a n d a r d M e t h o d s f o r t h e ID o c G e n e r a t i o n . T h i s e x a m p l e t h e r e f o r e w o r k s w i t h a f u n c t i o n m o d u l e . In g e n e r a l , y o u c a n u s e t h i s f u n c t i o n m o d u l e , w h i c h w e ’ll call Z_MASTERIDOC_CREATE_ ZSMNACH, f o r a ll o p t i o n s m e n t i o n e d e a r l i e r f o r t h e g e n e r a t i o n o f ID ocs. It's c a ll e d in a r e p o r t (s e e L is tin g 4 .9 ).

153

ID o c g e n e ra tio n

4

|

C h an g e s to I D ocs

F u n c tio n m o d u le

T his fu n c tio n m o d u le c o v e rs th e m a in p ro g r a m a sp e c ts. It tra n s fe rs a v a r i a b l e t h a t y o u c a n u s e t o d e t e r m i n e t h e d a t a t h a t is s u p p o s e d t o b e s e n t . I n t h i s c a s e , it's t h e O B J K E Y v a r ia b l e . To k e e p it s i m p l e , t h e v a r ia b l e re fe rs t o t h e Z S M H t a b le ; i f y o u u s e la r g e r ta b le s , y o u s h o u l d c r e a t e a s t r u c ­ t u r e t h a t o n l y c o n s i s t s o f t h e k e y field s. T h is is f o l l o w e d b y t h e v a r ia b le s f o r t h e s e n d e r ( s e n d e r p a r t n e r ID S N D P R N , s e n d e r p a r t n e r t y p e S N D P R T , a n d s e n d e r p a r t n e r fu n c tio n S N D P F C ) a n d t h e re c e iv e r (re c e iv e r p a r tn e r ID R C V P R N a n d r e c e i v e r p a r t n e r t y p e R C V P R T ) . T h e s y s t e m r e t u r n s t h e n u m b e r o f t h e g e n e r a t e d ID o c s s o t h a t y o u ’re p r o v i d e d w i t h a n i n t e r n a l t a b l e f o r t h e c o n t r o l re c o r d s .

G e n era tin g an ID oc: s ig n a tu re

Basically, a f u n c t i o n m o d u l e l i k e t h i s o n e c a n g e n e r a t e m u l t i p l e ID ocs, b u t o u r e x a m p l e is l i m i t e d t o o n e . T h e s i g n a t u r e o f t h e f u n c t i o n m o d ­ u l e is f o l l o w e d b y d a t a d e c l a r a t i o n s a n d t h e i n i ti a l i z a t io n p r o c e s s o f all structures. FUNCTION z m a s t e r i d o c _ c r e a t e _ z s m n a c h . "Local

interface:

IMPORTING VALUE(OBJKEY)

TYPE

Z S MH

V A LU E ( R C V P F C )

TYPE

BDALEDC-RCVPFC DEFAULT SPACE

* •’

V A LU E (R C V P R N ) TYPE

BDALEDC-RCVPRN

V A LU E ( R C V P R T ) TY PE

BDALEDC-RCVPRT

VALU E ( SNDPFC) TYPE

BDALEDC-SNDPFC DEFAULT SPACE

*”

V A LU E (S N D P R N ) TYPE

BDALEDC-SNDPRN

* •'

VALUE(SNDPRT)

BDALEDC-SNDPRT

TYPE

EXPORTING V A L U E ( C R E A T E D _ _COMM_ . I D O C S )

LIKE

SY

CHANGING REFERENCE(TE_ID0C_C0NTROD D a ta de fin itio n s

TYPE

DATA:

BEGIN OF f _ i d o c _ h e a d e r

DATA:

END OF f _ i d o c _ h e a d e r

.

DATA:

BEGIN OF t _ i d o c _ d a t a

OCCURS

DATA:

END OF t _ i d o c _ d a t a

DATA:

BEGIN OF t _ id o c _ c o m m _ c o n t r o l

INCLUDE

INCLUDE

INCLUDE

15 4

EDIDC_TT

.

STRUCTURE e d i d c

STRUCTURE e d i d d

. 10

.

.

.

STRUCTURE e d i d c

.

OCCURS

10

.

C u sto m ID o c s

*

DATA:

END O F t _ i d o c _ c o m m _ c o n t r o l

DATA:

com m _control_lines

DATA:

idoc_must_be_sent

DATA:

wa_zlzsmh

DATA:

wa_zsmh

DATA:

wa_zlzsmp

DATA:

wa_zsmp TYPE zsmp it_zsm p

DATA:

wa_zlzsmq

.

sy-tabix

.

.

.

TYPE z lz s m p

.

.

TYPE TABLE OF zsmp TYPE

4 -4

.

TYPE zlz s m h

TYPE zsmh

DATA:

LIKE

|

zlzsmq

.

CLEAR

t_idoc_com m _control

.

REFRESH

t_idoc_com m _control

.

.

In itia lize

CLEAR

t_idoc_data

.

REFRESH

t_idoc_data

.

* Check

ALE d i s t r i b u t i o n

L is tin g 4 .9

model

D a ta D e c la ra tio n s

I f y o u w o r k w i t h ALE d i s t r i b u t i o n , c h e c k — b e f o r e y o u g e n e r a t e t h e

R e a d in g th e

ID o c — w h e t h e r t h e p r e d e f i n e d c o m b i n a t i o n o f s e n d e r , r e c e i v e r , a n d

d is trib u tio n m odel

m e s s a g e t y p e is a l l o w e d , t h a t is, w h e t h e r it's m a i n t a i n e d in t h e c u s t o m e r d i s t r i b u t i o n m o d e l . You c a n u s e t h e s t a n d a r d m o d u l e A L E _ M O D E L _ D E T E R M I N E _ I F _ T 0 _ S E N D p r o v i d e d b y SAP f o r t h i s p u r p o s e (s e e L is tin g 4 . 1 0 ) . CALL

FUNCTION

‘ALE_MODEL_DETERMINE_IF_T0_SEND’

EXPORTING ' ZSMNACH

message_type *

sending_system receiving_system receiving_system

-

VALIDDATE

rcvprn

SY-DATUM

IMPORTING idoc_m ust_be_sent

idoc_must_be_sent

EXCEPTIONS own_system_not_defined = OTHERS IF

idoc_must_be_sent EXI T

ENDI F L i s t i n g 4 .1 0

IS

INITIAL

.

.

. D e te rm in in g th e D a ta o f th e D is trib u tio n M o d e l

15 5

4

|

C h an g e s to I D ocs

G e n e ra tin g se g m e n ts

I f y o u g e t a p o s i t i v e r e s u lt , t h e r o o t s e g m e n t is g e n e r a t e d n e x t (s e e List­ in g 4 .1 1 ). U sin g th e M o v e - C o r r e s p o n d i n g o r C o r r e s p o n d i n g

Fields

s t a t e m e n t s a l w a y s h a s t h e b e n e f i t t h a t p o t e n t i a l n e w fie ld s d o n ’t l e a d to changes in th e program . * Z S M H ==> G e n e r a t e SELECT SINGLE

E1ZSMH HEADER s eg m en t

* FROM z s m h

INTO CORRESPONDING WHERE k e y l

F I E L D S OF w a . z s m h

= objkey-keyl

.

MOVE-CORRESPONDING w a_zsm h TO w a _ z l z s m h L i s t i n g 4-11

F illin g t h e H e a d e r S e g m e n t -

.

A p p lic a tio n D ata

T h e s e g m e n t g e n e r a t e d s o f a r is n o w t r a n s f e r r e d t o t h e d a t a r e c o r d ta b le (see L is tin g 4 . 1 2 ) . O n l y t h e s e g m e n t n a m e f r o m t h e c o n t r o l a r e a n e e d s t o b e t r a n s f e r r e d , e v e r y t h i n g e l s e w ill b e g e n e r a t e d a t a l a t e r stag e. CLEAR

t_idoc_data

.

t_idoc_data-segnam

=

‘ ZIZSMH*

t_idoc_data-sdata

-

wa_zlzsmh

L i s t i n g 4.12

. .

F illin g t h e H e a d e r S e g m e n t — C o n tr o l D a ta

R e d u c tio n

I f r e d u c t i o n is e n a b l e d f o r y o u r m e s s a g e t y p e , t h e f o l l o w i n g f u n c t i o n

a c tiv a te d ?

m o d u l e c h e c k s w h i c h fields a r e a c tiv e f o r t h e s e g m e n t t h a t is s u p p o s e d to b e p r o c e s s e d in t h e r e d u c e d t y p e (s e e L is tin g 4 . 1 3 ) . T h e Z S M N A C H t y p e in o u r e x a m p l e is n o r e d u c t i o n , s o i t w ill b r i n g b a c k all f ie ld s a n d s e g m e n t s as r e le v a n t ; n e v e r t h e l e s s , t h e call h a s b e e n e x e c u t e d h e r e f o r i l lu s t r a ti o n purposes. *

Reducing CALL

segments

FUNCTION

' IDOC_REDUCTION_FIELD_REDUCE'

EXPORTING message_type =

‘ ZSMNACH'

segment_type =

'Z1ZSMH'

segment_data

= t_ id o c _ d a ta -sdata

IMPORTING segment_data L i s t i n g 4.13

= t_idoc_data-sdata

.

C h e c k i n g i f t h e F u n c t i o n M o d u l e Is S u p p o s e d t o B e R e d u c e d

T h e a p p e n d to t h e ID o c d a t a t a b l e is i m p l e m e n t e d in t h e n e x t s te p : APPEND

15 6

t_1doc

data

.

C u sto m ID o c s

A f t e r w a r d , t h e s y s t e m i m m e d i a t e l y c r e a t e s t h e n e x t s e g m e n t ( s e e List­

|

4 -4

Ite m se gm en t

i n g 4 .1 4 ) . *

Z SM P

==>

SELECT

*

IN T O

FROM z s m p C O R R E S PO N D IN G

WHERE LOOP

E 1 ZSMP

AT

keyl

=

it_ z s m p

F IE L D S

o b jk e y -k e y l IN T O

OF

wa_zsm p

M O V E -C O R R E S P O N D IN G w a . z s m p L i s t i n g 4.14

TABLE

it_ z s m p

. . TO w a . z l z s m p

G e n e ra tin g th e Ite m S e g m e n t -

.

A p p lic a tio n D ata

T h i s is t h e f ir s t field w i t h d i g its t h a t a r e s u p p o s e d t o b e t r a n s f e r r e d as a lp h a n u m e ric ch a rac te rs. A C O NDE NSE

Condense

w a _ z lz s m p -m e n g e

is e x e c u t e d :

.

A ls o a field e x i s t s t h a t is s u p p o s e d t o b e s e n t in t h e ISO c o d e a n d n o t in

C o n v e rtin g u n its of

t h e SAP u n i t (s e e L is tin g 4 . 1 5 ) . It's t h e u n i t o f m e a s u r e . T h e SA P f u n c ­

m easurem ent

ti o n m o d u l e f o r t h e c o n v e r s i o n d i r e c t i o n f r o m SAP u n i t t o ISO c o d e is U N I T _ O F _ M E A S U R E _ S A P _ T O _ I SO. CALL

F U N C T IO N

‘ U N IT _ O F _ M E A S U R E _ S A P _ T O _ IS O ’

EX PO R T IN G sap_code

=

w a _ z lz s m p -m e in a

=

w a _ z lz s m p -m e in a

n o t_ fo u n d

=

01

n o _ is o _ c o d e

-

02

IM P O R T IN G is o _ c o d e E X C E P TIO N S

CLEAR

t_ id o c _ d a ta

.

.

t_ id o c _ d a ta - s e g n a m

-

‘ Z1ZSM P'

t_ id o c _ d a ta -s d a ta

=

w a _ z lz s m p

L i s t i n g 4 .1 5

. .

D e t e r m i n i n g t h e ISO U n its o f M e a s u r e

H e re , t h e r e d u c t i o n is m i s s i n g , w h i c h is a l r e a d y c o n t a i n e d in t h e c o d e f o r t h e h e a d e r s e g m e n t in L is tin g 4 . 1 3 . T h e a p p e n d i m m e d i a t e l y fo llo w s : APPEND

t_ id o c _ d a ta .

In a d d i t i o n , a n o p t i o n a l q u a l i f y i n g s e g m e n t is p r o v i d e d t h a t is d e r i v e d

Q u a lify in g

f r o m t h e s a m e d a t a r e c o r d (see L is tin g 4 . 1 6 ) . T h e s y s t e m c h e c k s t h e t h r e e

segment

p o s s i b l e c a se s , FELDA, FELDB, o r FELDC, a n d g e n e r a t e s t h e s e g m e n t s i f t h e c o r r e s p o n d i n g d a t a is a v a ila b le .

157

4

|

C h an g e s to I D ocs

IF

NOT w a _ z s m p - f e l d a

IS

INITIAL

wa_zlzsm q-qual

-

w a_zlzsm q-feld

= wa_zsm p-felda

CLEAR

‘A ’

.

.

t_idoc_data.

t_idoc_data-segnam

= 'Z1ZSMQ'

t_ id o c_ d a ta -sdata

-

APPEND ENDIF IF

t_idoc_data

.

wa_zlzsmq

. IS

INITIAL

wa_zlzsm q-qual

= *C*

w a_zlzsm q-feld

-

CLEAR t _ id o c _ d a t a

.

.

w a_zsm p-feldc -

t_idoc_data-sdata

= wa_zlzsmq

APPEND ENDIF

.

.

t_idoc_data-segnam t_idoc_data

'Z1ZSMQ'

. .

.

.

NOT w a _ z s m p - f e l d b wa_zlzsm q-qual t_idoc_data

IS -

w a_zlzsm q-feld CLEAR

INITIAL

*B'

= wa_zsm p-feldb = *Z1ZSMQ* -

t_idoc_data

ENDIF

.

ENDLOOP

.

.

.

t_idoc_data-sdata APPEND

.

.

t_idoc_data-segnam

L i s t i n g 4 .1 6

.

.

NOT w a _ z s m p - f e l d c

IF

.

.

wa_zlzsmq

.

.

G e n e ra tin g th e O p t io n a l Q u a lify in g S egm ents

C o n tro l reco rd —

N e x t, y o u n e e d y o u r c o n t r o l r e c o r d ; h o w e v e r , t h e r e a r e o n l y a f e w fields

r e q u ir e d fie ld s

t h a t y o u n e e d t o fill in y o u r s e l f . In o u r e x a m p l e (s e e L is tin g 4 . 1 7 ) , t h e s e m a n d a t o i y f ie ld s a r c filled f o r s e n d e r i n f o r m a t i o n , r e c e i v e r i n f o r m a ­ tio n , a n d p o s s i b l y r e q u i r e d s e r i a l i z a t i o n i n f o r m a t i o n . T h e s y s t e m a u t o ­ m a t i c a l l y s p e c if ie s t h e t i m e s t a m p , t h e c r e a t i n g o r m o d i f y i n g p e r s o n , a n d t h e like. * Design CLEAR

control

record.

f_idoc_header

f_ i doc_header-mestyp

. = ‘ ZSMNACH'

f_idoc_header-idoctp

= 'ZSMTYPOr

f_1doc_header-sndpfc

= sndpfc

.

f_idoc_header-sndprn

-

sndprn

.

f_1doc_header-sndprt

= sndprt

.

15 8

. .

C u sto m ID o c s

f_idoc_header-rcvpfc

= rcvpfc -

rcvprn

.

f_idoc_header-rcvprt

= rcvprt

.

f_idoc_header-serial

-

L i s t i n g 4 .1 7

.

F i l l i n g t h e M a n d a t o r y F ie l d s i n t h e C o n t r o l R e c o r d

T h e s y s t e m t r a n s f e r s t h e fin a lly c o m p l e t e m a s t e r ID o c to t h e c o m m u n i ­

T ra n sfe r t o th e

c a t i o n l a y e r ( s e e L is tin g 4 . 1 8 ) . D u r i n g t h i s p r o c e s s , t h e h i e r a r c h y f o r th e

c o m m u n ic a tio n la y e r

i n d i v i d u a l s e g m e n t s is s e t u p a c c o r d i n g t o t h e ID o c t y p e d e f i n i t i o n . * Transfer CALL

4 -4

.

f_idoc_header-rcvprn

space

|

IDoc

FUNCTION

to

com m unication

layer

'MASTER_IDOC_DISTRIBUTE'

EXPORTING m aster_idoc_control

-

f_idoc_header

TABLES com m unication_idoc_control

- t_idoc_com m _control

m aster_idoc_data

= t_idoc_data

EXCEPTIONS error_in_idoc_control

= 01

error_w riting_idoc_status

= 02

error_in_idoc_data

- 03

sending_logical_system _unknown DESCRIBE

TABLE

= 04

.

t_idoc_com m _control

LINES c o m m _ c o n tro l_ lin e s . created_com m _idocs

- com m _control_lines

te _ id o c _ c o n tro l[]

= t_idoc_com m _control[]

ENDFUNCTION L i s t i n g 4 .1 8

. .

.

S e n d in g t h e G e n e ra te d ID o c s

N o t e t h a t, f o r b e t t e r r e a d a b ility , t h i s c o d e d o e s n ’t i n c l u d e s o m e r e c u r r i n g asp e cts w ith w h ic h d e v e lo p e r s a r e u su ally fam iliar. F o r e x a m p le , y o u m a y w a n t to u s e m o r e v a r ia b l e s w h e r e h a r d c o d e w a s u s e d in t h i s e x a m ­ p le . T h i s e x a m p l e a l s o d o e s n ' t c h e c k i f t h e s e g m e n t s a r e filled b e f o r e th e y are a p p e n d e d , w h ic h y o u s h o u ld alw ays do. Y o u’v e n o w c r e a t e d t h e d a t a r e c o r d s f o r y o u r t a b le s . T h e q u i c k v i e w in

C o m p le te cu s to m

F ig u r e 4 . 1 0 9 d i s p l a y s t h e d a t a o b j e c t t h a t is s u p p o s e d to b e s e n t a s an

ID o c

ex a m p le here.

15 9

4

|

C h an g e s to I D ocs

M

a b i n e s O b jec t List Partial le v C h a r

|F E L D 1 |F E L D 2

4711

F E L D ! FEL:>2

|471 4 711

10 0 0 0 1 O F E L Q A | F E L 0 8

|FE L D C

0 0 0 0 2 0 FE LDA 1 F E L D 91 F E L D C l

10

PC

PC I

ICO

°C

PC

Data Object to Be Sent

F ig u re 4 1 0 9

individual display

Item | R e serve | R e serve Reserve t Quantity| U o m ; U o m |

2 S M H -F E L 0 2 Partial keyi

4711

T r a n s a c t i o n B D 8 7 lists t h e ID o c t h a t h a s b e e n g e n e r a t e d f r o m t h e d a ta o b j e c t ( s e e F ig u re 4 . 1 1 0 ) .

ID o c d is p la y ^

□

Q “

I

T e c h n ic a l s h o rt in fo 7

C o n tro l R e c

C D D a ta reco rd s

T o ta l n u m b e r. 0

^

D irectio n

1

C u rr e n t status

03

B a s ic type

ZSMTYP01

D

Z1ZSM H

S e g m en t 00000

^

D z iz s M P

S e g m en t 00000

E x te n s io n

^

P

i

ID o c 0 0 0 0 0 0 0 0 0 0 7 6 8 7 9 6

□

O utb ox CCO

0

Z1ZSM Q A

S e g m en t 00000

M e s s a g e type

ZSMNACH

D

Z1ZSM O C

S e g m en t 00000

P a rtn e r No.

PRODUCTION

D

Z1ZSM Q 0

S e g m en t 00000

P a rtn .T y p e

LS

P o rt

A 000000003

Z1ZSM P

S e g m en t 00000

□

Z1ZSM O A

S e g m en t 00000

□

Z1ZSM O C

S e g m en t 00000

D

Z1ZSM Q B

S e g m en t 00000

C o n te n t o f s e le c te d s e g m e n t

C i S ta tu s re c o rd s F id n a m e

F id cont

POSNR

D 00010

1EN6E^ 1 E IN A

F i g u r e 4.110

Control record

PCE

Sample IDoc in Transaction BD87

T h e c o n t r o l r e c o r d (s e e F i g u r e 4 . 1 1 1 ) i n d i c a t e s t h a t y o u r ID o c t y p e (h e re : S a b i n e s IDoc Type) a n d y o u r m e s s a g e t y p e ( h e r e : ZSMNACH) w e r e a c tu a lly used.

E D lD C

| Control R e co rd

D IR E C T

D irection

1 : O utbound

DOCREL

R e le a s e

700

O UTM OD

O u to u tM o d e

2

STATUS

Status

3 0 ID oc reactyfor disp atch (ALE service)

DOCTYP

B a sic Type

3 0 S a b in e s ID oc Typ

CIM TYP

Enhancem ent

30:

M ESTYP

M e s s a g e Type

ZSMNACH

F ig u re 4 .111

16 0

S e ctio n Taken from th e C o n tro l Record

C u sto m ID o c s

T h e d a t a o f t h e i n d i v i d u a l s e g m e n t s n o w a ls o c le a rly s h o w s t h e c o n v e r ­ s i o n o f t h e d a t a f r o m “PC," as t h e i n t e r n a l u n i t o f m e a s u r e p ie c e , t o "PCE" as t h e c o r r e s p o n d i n g ISO u n i t o f m e a s u r e in t h e M E I N A field (s e e F ig u re 4 . 1 1 2 ) . T h e lis t a d d i t i o n a l l y i n c l u d e s t h e q u a l i f y i n g s e g m e n t , Z1ZSMQ, w h ic h h as b e e n created as an exam p le.

T ec h n ic a l N a m e

D e scrip tion

v a lu e

SEONUM

Segm ent Num ber

000001

SEGNAM

Segm ent Nam e

Z1ZSM H

KEY1

P a rtia l key o f SA P oblect

471 1

FE LD 1

C h a ra c te r field o f len g th 40

FE LD 1

FELD2

C h a ra c te r F ie ld L en g th = 10

FELD2

SEGNUM

Segm ent Num ber

000002

SEGNAM

Segm ent Nam e

Z1ZSM P

POSNR

Ite m n u m b e r o f th e S D do c u m en t

000010

M ENGE

1 7 -C h a r F ield

1 0 000

M E IN A

U n it o f m e a s u re

PCE

SEGNUM

Segm ent Num ber

000003

SEGNAM

Segm ent Nam e

Z1ZSM Q

QUAL

ZSMQUAL

A

FELD

C h a ra c te r field o f len g th 6

FELDA

SEGNUM

Segm ent Num ber

000004

9GONAM

Segm ent Nam e

Z1ZSM 0

GUAL

ZSMQUAL

C : B e lo n g s to F E L D C

: ELD

C h a ra c te r field o f len g th 6

FELDC

SEGNUM

Segm ent Num ber

000005

C -J -L

ZSMQUAL

B

FELD

C h a ra c te r field o f len g th 6

FELDB

B e lo n g s to F E L D A

B e lo n g s to F E L D B

SEGNUM

Segm ent Num ber

000006

SEGNAM

Segm ent Nam e

Z1ZSM P

POSNR

Ite m n u m b e r o f th e S D do c u m en t

000020

M ENGE

1 7 -C h a r F ield

1 0 0 .0 0 0

M E IN A

U n it o f m e a s u re

PCE

SEGNUM

Segm ent Num ber

000007

SEGNAM

Segm ent Nam e

Z1ZSM Q

GUAL

ZSMQUAL

A

=E L D

C h a ra c te r field o f len g th 6

FE LDA 1

3EG N JV

Segm ent Num ber

: 0 1 0 os

SEGNAM

Segm ent Nam e

Z1ZSM Q

C-U.-l

ZSM Q UA L

C

FELD

C h a ra c te r field o f len g th 6

'E L D C 1

F i g u r e 4.112

4 .4 .3

B e lo n g s to FE LDA

B e lo n g s 10 F E L D C

D a ta R ecords

U p d a t in g a n ID o c

T h e i n b o u n d p r o c e s s i n g is n o w s u p p o s e d t o p r o c e s s t h e m e s s a g e a n d ID o c ty p e s . F o r t h i s p u r p o s e , y o u n e e d t h e a p p r o p r i a t e f u n c ti o n m o d u l e again.

16 1

|

4 -4

4

|

C h an g e s to I D ocs

T h e s a m p l e m o d u l e o n l y c o n t a i n s t h e d a t a t h a t is n e c e s s a r y f o r I D o c p r o ­ c e s s i n g . U s u a l l y , t h e s y s t e m is s u p p o s e d t o e v a l u a t e a l l r e t u r n c o d e s , c h e c k th e u s e r a u th o r iz a tio n s , a n d s e t lo c k e n trie s . F u r th e rm o re , th e e x a m p le uses o n ly o n e ID o c p e r c a ll (th e o r e tic a lly , m u l t i p l e

ID o c s a r e fe a s ib le ) a n d n o n e

o f t h e A L E s e r v i c e s is d e p l o y e d . C o m p r e h e n s i v e c h e c k s f o r t h e c o m p l e t e n e s s a n d c o r r e c tn e s s o f t h e d a t a a r e m is s in g as w e l l . B e c a u s e th e s e c h e c k s are a p p lic a tio n - s p e c ific , y o u m u s t c o n s u lt t h e p e rs o n r e s p o n s ib le f o r t h e m o d u le a n d in te g ra te t h e m y o u rs e lf. Y o u c a n o b t a in th e v a ria b le s t h a t r e c u r in th is s a m p le m o d u le b y m a k in g th e f o llo w in g e n tr y in t h e T O P in c lu d e o f y o u r f u n c t io n g ro u p : in c lu d e

m b d c o n w f.

"R e p o rt

c o n ta in in g

th e

ALE

c o n s ta n ts .

A m o n g o t h e r t h in g s , t h e m b d c o n w f in c l u d e c o n t a i n s t h e c o n s t a n t s t h a t are l i s t e d i n T a b l e 4 . 2 a n d u s e d l a t e r . T h i s is m e r e l y a s u b s e t o f t h e v a r i a b l e s f r o m m b d c o n w f.

F ix e d v a l u e s i n t h e SAP in c lu d e

V a ria b le

F ix e d V a lu e

C_W F_RESULT_ERROR

99999

C _ W F _ R E S U L T _ D E L E T E _ ID O C

99998

C _ W F _ R E S U L T _ W I_ C O M P L E T E

99997

C_W F_RESULT_OK

0

C _ W F _R E S U L T _ R E T R Y _ ID O C

1

C _ W F _ R E S U L T _ C O N T IN U E _ ID O C

2

C _ ID O C _ S T A T U S _ O K

53

C _ ID O C _ S T A T U S _ E R R O R

51

T a b le 4.2

in b o u n d fu n c tio n m o d u le : S ig n a tu re

W h ile

F ix e d V a l u e s f r o m t h e “ m b d c o n w f I n c l u d e

th e fu n c tio n

o u tb o u n d

\

m o d u le s a re n ’ t s u b je c t to fu r t h e r re s tric tio n s in th e

p ro c e s s in g , in b o u n d

fu n c tio n m o d u le s m u s t h a v e a u n ifo r m

s ig n a tu r e b e c a u s e t h e y a re a u t o m a t ic a lly c a lle d b y th e A L E c o m m u n ic a ­ tio n

la y e r. F ig u r e 4 .1 1 3 s h o w s th e n e c e s s a ry p a r a m e te r s a n d

th e ir ty p ­

in g . P a ra m e te rs o f th e T a b l es ty p e a rc n o lo n g e r c o m m o n in m o r e re c e n t

16 2

C u sto m ID o c s

|

4 -4

r e le a s e s ; h o w e v e r , h e r e t h e y h a v e to b e u s e d t o m e e t t h e r e q u i r e m e n t s o f t h e ALE c o m m u n i c a t i o n lay er. I f r e q u i r e d , y o u c a n c o p y o n e o f th e e x i s t i n g ID o c i n b o u n d f u n c t i o n m o d u l e s .

FUNGI ION Z_IOOC_INPUT_ZSHNACH • • • • L o c a l In te r f a c e : ■• IMPORTING V A LUE (INP UT.HE THO D) L IK E BDVFAP_PAR-INPUTHETHD VALUE(HASS_PROCESSIN$) L IK E BDWFAP.PAR-flASS.PROC VA LU E (N O .APPLICA TIO N L 0 6 ) L IK E SV-DATAR OPTIONAL VALUE(MASSSAVEINFOS) L IK E HASSSAVINF STRUCTURE MASSSAVINF OPTIONAL •EXPORTING VALUE(YORKFLOW_RESULT) L IK E BDWF_PARAM-RESULT VA LU E (A P P LIC A TI0N JV A R IA 8LE ) L IK E 8DWF_PARAH-APPL_VAR VALUE( IN_UPDATE_TASK) L IK E BDWFAP_PAR- UPDATETASK VALUE(CALL_TRANSACTION_OONE) L IK E BD¥FAP_PAR-CALLTRANS '■ TABLES IDOC.CONTRL STRUCTURE EOIDC IDOC_DATA STRUCTURE E 0 I0 D IOOC.STATUS STRUCTURE BDIDOCSTAT RETURN_VARIABLES STRUCTURE BDWFRETVAR S E R IA L IZ A T IO N INFO STRUCTURE B D I.S E R EXCEPTIONS k)RONG_FUNCTION_CALLEO — ------------------------------------------------------------------------------------------------------------------------------------------

F i g u r e 4-113

S ig n a tu re o f an I n b o u n d F u n c tio n M o d u l e

To n o t u s e r e s o u r c e s u n n e c e s s a r i l y , y o u m u s t first c h e c k i f t h e f u n c ti o n

C h e c k in g th e

m o d u l e c o r r e s p o n d s t o t h e ID o c t h a t is s u p p o s e d to b e p r o c e s s e d . F o r

v a lid ity o f th e

t h i s p u r p o s e , y o u c a n c h e c k t h e m e s s a g e t y p e i f t h e m e s s a g e t y p e s a re n o n - r e d u c i b l e (s e e L is tin g 4 .1 9 ) . IF

idoc_contrl-m estyp

<> ‘ Z S M N A C H ’

RAISE w r o n g _ fu n c t io n _ c a lle d ENDIF

.

.

L i s t i n g 4 .1 9

C h e c k in g t h e M e s s a g e Type

F o r r e d u c i b l e ID o c s , a d i f f e r e n t m e s s a g e t y p e c a n b e u s e d s o t h a t y o u h a v e to c h e c k t h e ID o c ty p e (s ) t h a t a r e p e r m i t t e d f o r t h e r e d u c i b l e m e s ­ s a g e t y p e i n t h i s c a s e (s e e L is tin g 4 .2 0 ). IF

idoc_contrl-idoctp

<> ' Z S M T Y P O r

RAISE w r o n g _ fu n c t io n _ c a lle d

.

.

ENDIF. L is tin g 4 .2 0

C h e c k in g th e ID o c Type

16 3

fu n c tio n m o d u le s

4

|

C h an g e s to I D ocs

T h is is f o l l o w e d b y t h e v a r i a b l e d e f i n i t i o n s (s e e L isting 4 .2 1 ) . DATA:

subrc

* Structure DATA:

LIKE

for

wa_zsmh

* Variables DATA:

.

header

data

TYPE zsmh

for

the

it_zsm p

L i s t i n g 4-21

sy-subrc

the

.

items

TYPE

T A B L E OF z s m p

.

D e c la r a tio n o f t h e R e q u ire d V a ria b le s

S ta rtin g the

T h en , th e s y s te m read s th e ID oc a n d c o p ies th e d a ta to tra n s fe r th e stru c ­

s u b ro u tin e

t u r e s (s e e L istin g 4 .2 2 ) . I n t h i s e x a m p l e , t h e f u n c t i o n m o d u l e c a n p r o c e s s o n e I D o c o n ly , s o t h e t r a n s f e r r e d t a b l e , w h i c h c o n t a i n s m e r e l y o n e d a ta r e c o r d , is a l w a y s r e a d u s i n g I n d e x 1 . I f y o u w a n t t o u s e a m a s s - c o m p a t ib lc m o d u l e , t h e p r o c e s s i n g t a k e s p l a c e in a lo o p . READ T A B L E PERFORM

idoc_contrl

INDEX

1 .

idoc_process_zsm nach

idoc_status USING

TABLES

idoc_data

it_zsm p

idoc_contrl

CHANGING s u b r c L i s t i n g 4.22

wa_zsmh

.

R e a d in g th e C o n tr o l Record

T h e c o n t e n t o f t h e f o r m is s t r u c t u r e d a s il lu s t r a te d i n L istin g 4 . 2 3 . To p ro v id e an e x a m p le th a t c o n sid e rs th e n e w tech n o lo g ies fo r th e tab le dec­ la ra tio n , w h i c h a r e a v a ila b le a s o f R e le a se 4 . 0 , t h e ta b le ty p e is i n c l u d e d here. T ra n s fe rrin g th e ID o c d a ta

FORM

idoc_process_zsm nach

TABLES

t_idoc_data

STRUCTURE e d id d

t_idoc_status i t_zsmp

structure

STRUCTURE

bdidocstat

zsmp

USING f _ i d o c _ c o n t r l

STRUCTURE e d i d c

CHANGING

sy-subrc

subrc

V a ria b le s f o r th e

wa_zsmh

a p p lic a tio n d a ta

* Structure DATA:

like

zsmh. for

keyl

* Variables

LIKE the

TYPE for

header

the

wa_zsmp TYPE zsmp

DATA:

posi

DATA:

tabix

16 4

TYPE

.

items

DATA:

TYPE

data

zsmh-keyl .

zsmp-posnr sy-tabix

. .

C u sto m I D o cs

*

*

D a ta

fo r

th e

ID o c

w a _ z lz s m h

TYPEz lz s m h .

DATA:

w a _ z lz s m p

TYPEz l z s m p .

DATA:

w a _ z lz s m q

TYPEz lz s m q .

LOOP

AT

CASE

ID o c

R e trie v in g d a ta

t_ id o c _ d a ta

‘ Z 1 ZSMH*

CLEAR

s e g m e n ts

d a ta WHERE d o c n u m

t_ id o c _ d a ta - s e g n a m

WHEN

-

keyl

=

. =

t_ id o c _ d a ta -s d a ta

w a _ zsm h -ke yl

' Z1 ZSMP‘

CLEAR

posi

w a _ z lz s m p

. TO w a _ z s m h

.

.

. .

-

t_ id o c _ d a ta -s d a ta

M O V E -C O R R E S P O N D IN G w a . z l z s m p w a _ zsm p -ke yl L i s t i n g 4 .23

.

.

M O V E -C O R R E S P O N D IN G w a _ z l z s m h

WHEN

f_ id o c _ c o n trl-d o c n u m

fr o m th e ID o c

.

key 1

w a _ z lz s m h

4 -4

V a ria b le s f o r t h e

s e g m e n ts :

DATA:

T ra n s fe r

|

=

keyl

. TO w a _ z s m p

.

.

T ra n s fe rrin g t h e U s e r D a ta f r o m t h e ID o c S e g m e nts

I n t h i s e a s e , t h e u n i t o f m e a s u r e is a ls o c o n v e r t e d , t h i s t i m e f r o m t h e ISO c o d e t o t h e SAP u n i t . Im p o r tin g p a r a m e te r u n iq u e, w h i c h i s n 't e v a l u a t e d h e r e , is r e t u r n e d to X i f e x a c t l y o n e a p p r o p r i a t e v a l u e h a s b e e n f o u n d

C o n v e rtin g the u n it o f m easure fr o m IS O t o SAP

( s e e L is tin g 4 .2 4 ). CALL

F U N C T IO N

‘ U N IT _ O F _ M E A S U R E _ IS 0 _ T 0_ S A P ’

E X P O R T IN G is o _ c o d e

-

w a _ z s m p -m e in a

-

w a _ z s m p -m e in a

IM P O R T IN G SAP_C0DE *

U N IQ U E E X C E P T IO N S N O T .F O U N D

=

OTHERS

=

APPEND w a _ z s m p posi L is tin g 4 .2 4

1 2

.

TO

it_ z s m p

.

=

w a _ zsm p -p o sn r

.

C o n v e rtin g fr o m IS O U n its o f M e a s u r e t o I n te rn a l U n its o f M e a s u r e

T h i s is f o l l o w e d b y t h e e v a l u a t i o n o f t h e n e x t s e g m e n t , t h e q u a l i f i e d s e g ­

Q u a lifie d s e g m e n t

m e n t (s e e L is tin g 4 .2 5 ) .

in in b o u n d p ro c e s s in g

16 5

4

|

C h an g e s to ID o cs

- Z 1 ZSMQ-

WHEN

w a _ z lz s m q READ T A B L E

.

-

t_ id o c _ d a ta - s d a ta

it.z s m p

posnr

-

posi

ta b ix

=

s y - ta b ix

W IT H

IN T O

w a _ z lz s m q -q u a l

WHEN

‘ A*

-B ’

*C *

EN DLO O P ENDFORM

.

=

w a _ z lz s m q -fe ld

.

=

w a _ z lz s m q -fe ld

.

=

w a _ z lz s m q -fe ld

.

. it_ z s m p

CLEAR w a _ z s m p E N D C ASE

.

.

w a _ z s m p -fe ld c

M O D IFY

keyl

.

w a _ z s m p -fe ld b

EN D C ASE

=

.

w a _ z s m p -fe ld a

WHEN

wa_zsm p

.

keyl

.

CASE

WHEN

KEY

FROM w a _ z s m p

IN D E X

ta b ix

.

.

.

.

.

“ ID O C _P R O C E S S _Z S M N A C H

Listing 4.25 Processing of the Qualifying Segment, "Z1ZSAAQ" If th e d a ta c o n ta in s e rro rs , fo r e x a m p le , i f m a n d a to r y s e g m e n ts a r e m iss­ in g o r d a t a n e e d s t o b e c h e c k e d a g a i n s t C u s t o m i z i n g a n d d o e s n ’t m a t c h , m o d ify

t o t r i g g e r a n e r r o r i n t h e c a llin g m o d u l e .

s u b rc

Posting using the

A f t e r w a r d , i f t h e r e t u r n v a l u e is c o r r e c t , t h e s y s t e m t r a n s f e r s t h e d a t a

application module

t0 t |i e a c l u a ] u p d a t e m o d u l e , w h i c h is a l w a y s c a lle d in t h e u p d a t e m o d e (see L is tin g 4 . 2 6 ) . T h e ALE c o m m u n i c a t i o n l a y e r t h e n t r ig g e r s t h e mi t

W o rk

a n d e n s u r e s th a t th e ID oc statu s a n d th e ap p lic a tio n o b je c t are

u p d a te d o r d is c a rd e d sim u ltan e o u sly . *

E v e rth in g IF

s u b rc CALL

ok =

0

so

fa r?

Then

post

.

F U N C T IO N

* Z_ZSM _CREATE’

E X P O R T IN G header

=

wa_zsm h

p o s is

-

it_ z s m p

E X C E P TIO N S OTHERS

L is t in g 4 .2 6

16 6

Com-

-

1

.

C a llin g th e U p d a te AAodule o f th e A p p lic a tio n

C u sto m ID o c s

|

4 -4

N o w , t h e s y s t e m e v a l u a t e s t h e r e t u r n c o d e o f t h e u p d a t e m o d u l e a n d s e ts t h e s t a t u s v a l u e o f t h e ID o c a c c o r d i n g l y ( s e e L is tin g 4 . 2 7 ) . T h e e r r o r a n d s u c c e s s m e s s a g e s o f t h i s e x a m p l e a r e r a t h e r b a s ic , o f c o u r s e . You s h o u l d u s e a n i c e m e s s a g e c lass a n d a l s o t r a n s f e r t h e

and

t_ id o c _ s ta tu s -m s g id

v a l u e s , w h i c h a r e i n d i c a t e d b y a s te r is k s , a s c r e a t e d

t_ id o c _ s ta tu s -m s g n o

in y o u r m e s s a g e class. IF

sy-su b rc s u b rc

*

E rro r?

-

Then

U S IN G sy

copy

*

O k?

to

s ta tu s

S e ttin g the

te x t

e rro r sta tu s

s t a t u s _ f i1l_ s y _ e rr o r id o c _ s ta tu s

id o c .d a ta

'E r r o r ’

ELSE

.

.

PERFORM TABLES

0

<>

1

*M y

m o d u le ’

.

.

Then

success

S e ttin g the

s ta tu s

id o c _ s ta tu s -d o c n u m

=

id o c _ c o n trl-d o c n u m

id o c _ s ta tu s -s ta tu s

-

c _ id o c _ s ta tu s _ o k

id o c _ s ta tu s -m s g ty

=

‘ S’

.

.

*

t_ id o c _ s ta tu s * m s g id -

y o u r_ m s g id .

*

t_ id o c _ s ta tu s -m s g n o =

m s g n o _ s u c c e s s . " G 1o b a l

id o c _ s ta tu s -m s g v l APPEND E N D IF E N D IF *

F ill

.

-

id o c .s ta tu s “ i f

sy-su b rc

success sta tu s

.

‘o k ’

"G lo b a lv a r ia b le . v a ria b le .

.

. <>

0

.

. th e

L is tin g 4 .2 7

ALE

e x p o rt

p a ra m e te rs

C h e c k in g t h e S tatus o f t h e ID o c U p d a te a n d M e s s a g e A s s ig n m e n t

If successful, y o u m u s t n o w e n s u r e — i f a c o n n e c tio n to th e w o rk flo w is g i v e n — t h a t a n e v e n t u a l l y e x i s t i n g e r r o r w o r k f l o w is c a n c e l e d ; i f an e r r o r o c c u r s , t h e c o r r e s p o n d i n g w o r k f l o w n e e d s t o b e t r i g g e r e d . T h is is d o n e b y t h e ALE c o m m u n i c a t i o n lay er, w h i c h u s e s t h e v a l u e s t h a t a re t r a n s f e r r e d h e r e (s e e L is tin g 4 . 2 8 ) a n d t h e C u s t o m i z i n g s e t t i n g s t h a t a re d e s c r i b e d in S e c t i o n 4 . 4 . 5 , E r r o r W o r k f l o w f o r C u s t o m ID ocs. CLEAR

in _ u p d a te _ ta s k

.

CLEAR c a l l _ t r a n s a c t i o n _ d o n e IF

s u b rc

<>

0

.

“ E rro r

.

" C a ll

not

used

.

o c c u rre d

w o rk flo w _ re s u lt

=

r e tu rn _ v a ria b le s -w f_ p a ra m

-

re tu rn _ v a ria b le s -d o c _ n u m b e r APPEND

T ra n s a c tio n

r e tu r n _ v a r ia b le s

c _ w f_ re s u lt_ e rro r

.

c _ w f_ p a r_ e rro r_ id o c s =

id o c _ c o n trl-d o c n u m

. .

.

16 7

W o r k f lo w h a n d lin g

4

|

C h an g e s to I D ocs

ELSE

.

“ IDoc

processed

successfully

w orkflow _result

-

c_w f_result_ok

return_variables-w f_param

=

c_wf_par_processed_idocs

return_variables-doc_num ber APPEND r e t u r n _ v a r i a b l e s

ENDIF

return_variables

idoc_contrl-docnum

.

.

.

return_variables-w f_param APPEND

.

-

c_w f_par_appl_objects

.

.

.

L is tin g 4 .2 8

T ra n s fe rrin g t h e D a ta t o t h e Error W o r k f lo w

You u s u a l l y d o n ' t h a v e to p r o g r a m t h e a c tu a l u p d a t e m o d u l e y o u r s e l f b e c a u se th e a p p lica tio n m u s t alre a d y h a v e d e v e lo p e d s o m e th in g th a t cre­ a t e s t h e s a m e d a t a v ia d ia lo g t r a n s a c t i o n . To e n s u r e t h a t t h e d a t a re s u ltin g f r o m u p d a t i n g a n ID o c a n d t h e d a t a t h a t a u s e r h a s m a n u a l l y c r e a t e d is i d e n tic a l, y o u s h o u l d a l w a y s h a v e b o t h p r o c e d u r e s a c c e s s t h e s a m e f u n c ­ t i o n m o d u l e . H e r e , t h e c h e c k s , lo c k s, a n d a u t h o r i z a t i o n q u e r i e s d e f i n e d b y t h e a p p l i c a t i o n a r e a ls o c o d e d . A s s ig n m e n t to the

I n o u t b o u n d p r o c e s s i n g , y o u o n l y h a v e t o a s s ig n f u n c t i o n m o d u l e s to

p ro c e s s co d e

p ro c e s s c o d e i f y o u u s e o u t p u t d e t e r m i n a t i o n . In i n b o u n d p r o c e s s i n g , this a s s i g n m e n t is a lw a y s r e q u i r e d . F u r t h e r a c tiv itie s t h e r e f o r e i n v o l v e s p e c if y ­ in g t h e c h a ra c te ris tic s o f t h e f u n c t i o n m o d u l e in T ra n s a c tio n B D 5 1 . F ig ure 4 . 1 1 4 d i s p l a y s t h e s e l e c t io n o f t h e c h a r a c te r is tic s . O p t i o n 2 ( I n d iv id u a l I n p u t w i t h ID o c Lock in Call T r a n s a c tio n ) is r a r e l y s e l e c t e d d u e to p e r f o r ­ m a n c e r e a s o n s . O u r s a m p l e f u n c t i o n m o d u l e u s e s o p t i o n 1, I n d i v i d u a l I n p u t . T h e c o d e e x a m p l e s a l r e a d y i n d i c a t e d t h e r e q u i r e m e n t s f o r u s in g M a s s P ro c e s s i n g ( o p t i o n 0). Basically, i t's all a b o u t i n t e g r a t i n g e v e i y t h i n g t h a t h a s b e e n i m p l e m e n t e d o n l y o n c e i n t o a l o o p v ia a c o m p l e t e ta b le .

N e w E n trie s : O v e rv ie w o f A d d e d E n trie s

C h a r a c t e n s t i c s o f in b o u n d F u n c tio n

unctjon module ( nbcund)

□

IDOC INPUI ZSfK'CH

C & C od t: H o w a r* IDoc package* p r o c t ts t d ? (3) 3 E n tti* s * o ( 2 0 /

^ ■ iw Inpul ly

• •

1

i n d M O u a l in p u t

2

i n d M d u a l i n p u t w ith I D o c l o c k i n C A L L T R A N S A C T I O N

F ig u re 4 .1 1 4

16 8

'

S h w iD c s c n *.

P ro ce ssin g T y p e o f th e AAodule

C u sto m ID o c s

|

4 -4

A f t e r w a r d , y o u a s s ig n t h e f u n c t i o n m o d u l e t o its m e s s a g e t y p e a n d all

A s s ig n m e n t t o th e

p o s s i b l e I D o c t y p e s u s i n g T r a n s a c t i o n W E 5 7 (s e e F ig u r e 4 . 1 1 5 ) . I n t h e

a p p lic a tio n

O b j e c t T y p e field, e n t e r a n o b j e c t t y p e f r o m t h e B u s in e s s O b j e c t R e p o s i ­ t o r y (BOR), f o r e x a m p l e , BUS 1001006 f o r t h e m a t e r i a l . It's t h i s a s s i g n ­ m e n t t h a t e n a b l e s t h e s y s t e m t o w r i t e lin k s b e t w e e n t h e ID o c a n d th e b u s i n e s s o b j e c t t h a t h a s b e e n c r e a t e d a n d d i s p l a y t h e m in T r a n s a c t i o n BD 87. D escrib ing th e d e v e lo p m e n t o f b u sin e s s o b je c t ty p e s fo r ap p lica­ ti o n o b j e c t s is b e y o n d t h e s c o p e o f t h i s b o o k , h o w e v e r .

N e w E n t r i e s : D e t a ils o f A d d e d E n t r i e s

a a FuncSon rrwdjle

ZJ0CCJKPUT_2S»1N«CM

Functon m >o

F Functor rroflule

BMKtn>*

ZS1TTP01

a'

E«iens»on Me s s a g e Type

UlMACH

Me s s a g e vanar* M e s s furxBon CDWlTyp# 100c A s s - ; w ? . t o i i “ t>lo9 M e s s w

'vpe

3

Direction Oostrplon Nime

F i g u r e 4-115

A d d it io n a l C h a ra c te ris tic s o f t h e In b o u n d F u n c tio n M o d u l e

A f t e r a s s i g n i n g t h e f u n c t i o n m o d u l e , y o u c r e a t e t h e p r o c e s s c o d e in

C re a tin g process

T r a n s a c t i o n W E 4 2 . I n t h e O p t i o n ALE t a b , y o u c a n c h o o s e i f y o u w a n t to

code

w o r k w i t h o r w i t h o u t ALE s e r v ic e s , a n d t h e P r o c e s s i n g T y p e t a b e n a b le s y o u t o s e l e c t t h e p r o c e d u r e f o r t h e p r o c e s s c o d e (s e c F ig u r e 4 . 1 1 6 ) .

N e w E n t r i e s : D e t a ils o f A d d e d E n t r i e s [n ^

C S i t'i D o u r * ) p r o c e s s < 0 ®

P ro ce ss co s*

Z S11

D O S fr ® lo n

P o s t ID o i ZSM N A C H

lO e n b fc a b o n

3

O p lo n A iE

• Process^ -

w

,w ^

s

.

m c

.

Ptocessif>gwioa l e servtce Processing h e *

Processing b* task

O Processing crtprocess S'

r-n

^

F c * e n o y . a c c e s s T i x k O o o m o d u l e 'o r A i E - F W inbound processing1

F i g u r e 4.1 16

P ro c e s s C o d e i n I n b o u n d P r o c e s s in g

16 9

4

|

C h an g e s to I D ocs

C h a ra c te ris tic s o f

W h e n c re a tin g a n e w p ro cess c o d e , th e s y s te m a u to m a tic a lly nav ig ates

th e m o d u le

y o u to t h e i n p u t s c r e e n f o r a d d i t i o n a l c h a r a c te r i s t ic s i f y o u s e l e c t t h e P ro ­ c e s s in g b y F u n c t i o n M o d u l e o n the #

o p t io n

. L a te r, y o u c a n g o t h e r e b y c lic k in g

ic o n . F ig u re 4 . 1 1 7 s h o w s t h e s e a d d i t i o n a l c h a ra c te ris tic s . H e re ,

y o u a ls o s p e c i f y t h e o b j e c t s a n d e v e n t s f o r h a n d l i n g e r r o r s v ia w o r k f l o w . In o u r e x a m p l e , n o t h i n g is d e f i n e d h e r e , s o e r r o r s c a n c u r r e n t l y o n l y b e p r o c e s s e d v ia T r a n s a c t i o n B D 8 7 . M a x i m u m N u m b e r o f R e p e a t s sp e c ifie s t h e m a x i m u m n u m b e r o f a t t e m p t s f o r s u c c e s s f u l l y p o s t i n g a n ID o c to a n a p p l i c a t i o n . I f t h i s i s n ’t s u c c e s s f u l w i t h i n t h i s n u m b e r o f a t t e m p t s , m a n u a l e r r o r h a n d l i n g is r e q u i r e d .

N e w E n trie s : D e ta ils o f A d d e d E n trie s P r o c e s s code M o d u le (inb ound) Function M odule M a x im u m N u m b e r o f R e p e a ls ID o c p a c k e t / 7 O b je c t Type E n d Event ID oc O b jec t Type S tart Event E n d event S u c c e s s Event

A p p lic a tio n O b je c t O b je c t Type S tart event

F i g u r e 4.117

A s s ig n in g t h e In b o u n d F u n c tio n M o d u le

A s s ig n in g the

Finally, y o u c a n a s s ig n y o u r m e s s a g e t y p e t o a lo g ic a l m e s s a g e i n T r a n s ­

m essage ty p e t o a

a c t i o n W E 4 1 (s e e F ig u r e 4 . 1 1 8 ) , w h i c h c o n c l u d e s y o u r d e v e l o p m e n t

lo g ic a l m essage

w ork.

17 0

C u sto m ID o c s

|

4 -4

N ew E n trie s : D e ta ils o f A d d e d E n trie s

D ia lo g Structure

P ro c e s s c o d e

ZSH1

CD In b o u n d p ro c e s s co d e A s s ig n m e n t to logical m e s s a g e / / r— (•> M e s s a g e type

ZSHNACH

O All types

© M e s s a g e code O A ll co d es

® M e s s a g e function O A ll functio ns

F ig u re 4 1 1 8

A s s ig n in g t h e M e s s a g e Type

A ll y o u n e e d n o w is t h e a p p r o p r i a t e p a r t n e r p r o f il e i n T r a n s a c t i o n W E 2 0

P a rtn er p ro file w ith

t h a t u s e s y o u r p r o c e s s c o d e t o e n a b l e y o u t o r e c e i v e a n d u p d a t e ID o cs

c u s to m process code

( s e e F ig u r e 4 . 1 1 9 ) .

P artn e r p ro file s: Inbound param eters

P artner No.

PRODUCT I OH

P artn Type

LS

P roductive s y s te m (c lie n t 811 )

P artner Role

g

ZSHNACH

M e ssa g e type

M e ssa g e code

□ Test

M e ssa g e function

P o s tp ro c e s s in g pe rm itte d a g e n t

Process code 0

Telepho ny

E$m

Cancel Processing Alter Syntax Error

P ro c e s s in g By F u n c tio n M odule O Trigger by background program © T r ig g e r Im m ediately

F i g u r e 4.1 19

P a rtn e r P ro file — I n b o u n d Param eters

171

4

|

C h an g e s to ID o cs

S a m p le

IDocs

F ig u r e 4 . 1 2 0 s h o w s s o m e s u c c e s s f u l l y p o s t e d ID o c s w i t h a p r o p e r s u c ­ ce ss m e s s a g e .

Doc Selection IDoc number Slat

|statusTe«t

1Partner No.

|BasicT»pe

Segm e

53 [ZSM NACH

|S: 0 0 0 ok

P R O D U C T IO ZS M TY P0I

9

768801

53

[ZSMNACH

S: 0 0 0 O k

P R O D U C T IO ZSMTYP01

9

76880?

53

[ZSMNACH

IS 0 0 0 ok

P R O D U C T IO ZSMTYP0I

9

768803

53

ZSMNACH

|S: 0 0 0 ok

P R O D U C T IO ZSMTYP0I

9

768804

53

ZSMNACH

S 0 0 0 ok

P R O D U C T IO ZSMTYP0I

9

F ig u re 4 1 2 0

F a u lty ID o c s

|M e s s a g e Type

768800

S u c c e s s f u lly U p d a t e d I D o c s

F ig u r e 4 . 1 2 1 , in t u r n , s h o w s f a u lt y ID o c s . T h e s t a t u s t e x t, h o w e v e r , is s o m e w h a t b asic. You s h o u l d s p e c if y e r r o r s a s d e t a i l e d a s p o s s i b l e to facil­ i t a t e t h e w o r k f o r p e r s o n s w h o m o n i t o r t h e I D o c s i f e r r o r s o ccur.

Doc Selection id o c

num ber Slat [M essage Type

768805

51

Statu sTexl

ZSMNACH

M essages for input and oulbound processing — -

F i g u r e 4.121

4 .4 . 4

| Partner n o PR OD UC TIO N

BasicType ZSMTYP01

S egm e 9

I D o c s w i t h A p p l i c a t i o n Errors

G e n e r a tin g ID o c F u n c t io n M o d u le s

G e n e ra tin g

T h e r e a r e t w o o p t i o n s to h a v e t h e s y s t e m a u t o m a t i c a l l y g e n e r a t e m o d ­

s u ita b le ALE

u l e s f o r c r e a t i n g a n d u p d a t i n g a n ID oc. T h e f ir s t o p t i o n is t o g e n e r a t e

in te rfa c e s

s u i t a b l e ID o c i n t e r f a c e s t o BAPIs. In t h i s p r o c e s s , t h e m e s s a g e t y p e a n d t h e ID o c t y p e a r e g e n e r a t e d . T h e s e c o n d o p t i o n is b a s e d o n a f u n c t i o n m o d u l e . B o th m e t h o d s a r c d e s c r i b e d in t h e f o l l o w i n g s e c ti o n s .

H a v in g t h e S y s t e m G e n e r a t e ID o c A A o d u le s f r o m B A P I Segm ent

T he se g m e n ts are b u ilt fro m im p o rt a n d c h a n g e p a ra m e te rs o f th e sig n a ­

g e n e r a t i o n in

tu r e . (T h e e x p o r t p a r a m e t e r s a r e n ' t r e q u i r e d h e r e b e c a u s e ID o c s n e v e r

T ra n s a c tio n B D B G

r e s u l t in a r e s p o n s e . ) F o r t h i s p u r p o s e , a s m a n y i n d i v i d u a l v a r i a b l e s as p o ssib le b e c o m e a s e g m e n t, stru c tu re s are p ro v id e d w ith a se p a ra te seg ­ m e n t th a t o n ly occurs o n ce , a n d ta b le ty p e s o b ta in a se p a ra te s e g m e n t

17 2

C u sto m ID o c s

|

4 -4

t h a t o c c u r s m u l t i p l e t i m e s . T h e n , a m o d u l e is g e n e r a t e d r e s p e c t i v e l y fo r g e n e r a t i n g a s w e ll a s f o r u p d a t i n g t h e c o r r e s p o n d i n g ID o c. T r a n s a c t i o n BD B G g e n e r a t e s t h e c o r r e s p o n d i n g ID o c i n t e r f a c e to a BAPI, a n d in F ig u r e 4 . 1 2 2 , y o u c a n v i e w a n ALE i n t e r f a c e t h a t h a s a l r e a d y b e e n d e l i v e r e d b y SAP in t h e F u n c t i o n d is p la y .

G e n e ra te a l e I n te r f a c e f o r b a p i

Kessage ty p e ACC_EnPLOIEE_EXP ACC_E"PLOYEE_EXP a lre a d y e x i s t s IDoc ty p e ACC_E«PL0IEE_EXP02 ACC_E"PL0 YEE_EXP0 2 a lre a d y e x i s t s S e g ie n t E18PACHE84 E1BPACHE04 a lre a d y e x is t s E16PAC6L04 E1BPAC6L04 a lre a d y o x io ts EieP»CTX 6 l E IBPACIIO I a lre a d y e x is t s E18PACCR04 E1BPACCR04 a lre a d y e x is t s E1BPACTR00 E 1 BPACTROO a lre a d y e x is t s E18PACCRP0 E1 BPACCRP0 a lre a d y e x is t s E1BPEXTC E 1 BPEXTC a lre a d y e x i s t s F u n c tio n n o d u le f o r O utbound ALE K i t h O a ta F i l t e r i n g *IE_«CC_E"P10»EE_E XP_P0ST ALE_ACC_EHPIOYEE_EXP_POST a lre a d y e x i s t s F u n c tio n n o d u le f o r Inbound ALE W ith P a c k e t P ro c e s s in g ID 0 C_INPUI_ACC_EnPlOYEE_E XP IDOC_IKPl)I_ACC_EMPLOYEE_EXP a lre a d y e x is t s

F i g u r e 4.122

Display of an Already Existing Interface

T h e u p d a t e v i a a g e n e r a t e d m o d u l e is a l w a y s c a r r i e d o u t w i t h t h e s a m e p r o c e s s c o d e : BAPI f o r i n d i v i d u a l p r o c e s s i n g a n d BAPP f o r m u l t i p r o c e s s ­ i n g . S o, y o u d o n ' t n e e d a c u s t o m p r o c e s s c o d e .

H a v in g th e S ystem G en e ra te ID o c M o d u le s fro m F u n c tio n M o d u le s T h e s e c o n d o p t i o n t o a u t o m a t i c a l l y g e n e r a t e I D o c m o d u l e s is b a s e d o n a

ALE in te rfa c e fo r

f u n c t i o n m o d u l e t h a t h a s n ' t b e e n i m p l e m e n t e d a s a BAPI. M o r e r e s t r i c ­

fu n c tio n m o d u le s

tio n s a p p ly h ere. T he fu n c tio n m o d u le m u s t c o n ta in o n ly o n e im p o rt a n d o n e e x p o r t p a ra m e te r. H ow ever, th e im p o rt p a r a m e te r m a y be a c o m p l e x v a r ia b l e . T h e e x p o r t p a r a m e t e r m u s t b e o f t h e B A P I R E T M t y p e i f

173

4

|

C h an g e s to ID o c s

y o u h a v e a s i m p l e i m p o r t v a r ia b le , a n d i t m u s t b e o f t h e B A P I R E T S t y p e i f y o u h a v e a c o m p l e x t r a n s f e r v a r ia b l e . T r a n s a c t i o n B D F G is r e q u i r e d f o r t h i s p u r p o s e , a n d a l t h o u g h i t i s n ’t a BAPI, t h e r e f e r e n c e to a b u s i ­ n e s s o b j e c t t y p e f r o m t h e B O R is m a n d a t o i y . T h e n y o u c a n s p e c i f y t h e n a m e s , p a c k a g e s , a n d p r o p e r t i e s o f y o u r o b j e c t s u s i n g T r a n s a c t i o n BDFG (see F ig u r e 4 . 1 2 3 ) .

A L E In te r fa c e s f o r F u n c tio n M o d u le

Function Module that Processes Business Object Z.SH1 B usiness Obiect Type

BUS1001 006

a / IDoc interface M essag e Type

Z_sm

IDOC Type

Z.SH181 Z_SM*

Packet

zsni

ALE Outbound Processing Function Module

ZA IE__Shi

Function Group

ale

inbound Processing

Function Module

ZID0C_1NPUT_SH1

Function Group

ZSH1

✓

0

m u p d a te Task

□

M ass Processing AJlowed

X

F i g u r e 4*123

E n trie s in T ra n sa ctio n BDFG

T h e s y s t e m t h e n u s e s t h e s e s p e c i f i c a t i o n s to g e n e r a t e e v e r y t h i n g t h a t is r e q u i r e d a s i l l u s t r a t e d in F ig u re 4 . 1 2 4 . So i t c a n p a y o f f t o d e v e l o p a f u n c t i o n m o d u l e w i t h t h e r e q u i r e d p r o p e r t i e s a r o u n d t h e a p p l i c a t i o n ’s m o d u le a n d to s p a re th e rest o f th e w o rk .

174

C u sto m ID o c s

|

R e s u lts

^

C l) ALE Interface ^

O

M essage Type <3§ Z .S M l ©

Z_SM1 h a s bee n generated

•=* CD IDoc Type § !Z _ S M 1 0 1 0 Z _ S M 1 O 1 has bee n generaled O

C h eck basic tip e Z _S M 101

( D Basic type Z .S M 1 0 1 Is not released O

8 a s ic W e Z _ S M 1 0 I Is linked to logical m es s a g e Z_SM1

O

Mo predecessors exist

I* □ ^

Segm ents

CD Function M odule for Outbound ALE ZALE__SM1 O

^

ZALE__ SM1 has bee n generated

< 3 Function M odule (or inbound ALE € 8 ZIDO C J N P U T _ S M t O

Z ID O C _ IN P U T _ S M t h a s been generated

F i g u r e 4-124

4 .4 .5

G e n e ra te d O b je c ts in T ra n s a c tio n BDFG

E r r o r W o r k f lo w f o r C u s to m ID o c s

T h e e r r o r p r o c e s s i n g is b a s ic a lly i m p l e m e n t e d v i a w o r k f l o w ta s k s , a n d s o m e o f t h e p r o g r a m m i n g e x a m p l e s a l r e a d y e n s u r e t h a t w o r k f l o w tasks a r e s t a r t e d o r c o m p l e t e d o r t h a t t h e n e c e s s a i y e v e n t s a r e tr i g g e r e d . In e r r o r h a n d l i n g , a d i s t i n c t i o n is m a d e a m o n g e r r o r s o f t h e ID o c i n t e r ­

G eneral error:

face, e r r o r s o f t h e e x t e r n a l s y s t e m / E D I s u b s y s t e m , a n d e r r o r s o f t h e SAP

w o r k f l o w ta s k s

a p p l i c a ti o n . SAP p r o v i d e s e r r o r ta s k s f o r t h e ID o c i n t e r f a c e a n d t h e e x t e r ­ n al s y s t e m , w h i c h y o u c a n fin d in T r a n s a c t i o n W E 4 0 . F ig u r e 4 . 1 2 5 s h o w s t h e m f o r b o t h t h e i n b o u n d a n d t h e o u t b o u n d p r o c e s s i n g . H e r e , ED IS is t h e d e f a u l t e r r o r c o d e f o r t h e e x t e r n a l s y s t e m , b u t y o u c a n a l s o c re a te y o u r o w n e r r o r ta s k s . T h i s i n v o l v e s e r r o r h a n d l i n g t h a t is i n d e p e n d e n t o f t h e a p p l i c a t i o n a n d is t h e r e f o r e g e n e r a l l y v alid . F o r t h e e r r o r s in t h e a p p l i c a t i o n , a s e p a r a t e e r r o r w o r k f l o w e x i s t s f o r e a c h m e s s a g e t y p e . I f y o u p r o g r a m ID o c s y o u r s e l f , y o u m u s t c r e a t e th is e r r o r w o r k f l o w c o m p l e t e l y . T h i s is d e s c r i b e d h e r e f o r t h e ZSMNACH m e s ­ s a g e t y p e t h a t w a s c r e a t e d p re v io u s ly .

175

4 -4

4

|

C h an g e s to I D ocs

S e ttin g s : E r r o r a n d S ta tu s P ro c e s s in g

alT[&Maa| |s?alfT~TTi[al&a|ta’>Ti Process Codes for Error Processing CodejType ■denote aeon I

H

| E»pressjinact.ve|

TS745Q3411

utbound. irxompi

i conversion

:

0008068

ibound, “ rroi mes

ism with

EOILJ2

0008373

EOtc| ECU

0000020

EDIM|2 ECIM :

IDoc

>age Without IDoc

TS C303 0”

- document (outbound vrfo IDoc)

E W 0 I2

0007989

lulDOur

error handling wrthlDoc

EOtP|2

TS 0001307

lutbour

error m essage with IDoc packet

£O IS [3

ED .SIAPRC

ECK :

TS C303070

EC IV .'

C003074

ftl a M fla l

hM '

’ I T a ld J M a M a i

Process Codes for Status Inbound ::itiri: i t on Description of prccese

\2 2

|

7 S 7 0 0 0 3 ' ?S IDOC OWNSrOpOrtwilhOOC»:>
F ig u re 4 1 2 5

T e c h n ic a l E r r o r P r o c e s s C o d e s

F irst o f all, y o u m u s t c r e a t e a c u s t o m b u s i n e s s o b j e c t t y p e f o r t h e ID o c in T r a n s a c t i o n S W O l . T h i s b u s i n e s s o b j e c t t y p e m u s t i n h e r i t f r o m t h e I DO C A P P L t y p e s o t h a t all m e t h o d s r e q u i r e d a r e a v a il a b le . A g a in , t h e n a m e o f

t h e b u s i n e s s o b j e c t t y p e m u s t b e w i t h i n y o u r n a m e s p a c e . F ig u r e 4 . 1 2 6 s h o w s th e b u s in e s s o b je c t ty p e o f th is ex a m p le .

C o n te x t w i t h BOR

B usiness O b j e c t Types f o r IDocs N o t e t h a t th e r e c a n b e t w o b u s in e s s o b je c t ty p e s in t h e c o n t e x t o f I D o cs. O n e o f t h e m is m a n d a t o r y a n d is u s e d f o r t h e e r r o r w o r k f l o w . T h i s is t h e o n e th a t m u s t in h e rit fr o m

I D O C A P P L a n d p ro v id e s a fe w , a lw a y s id e n tic a l

m e th o d s . T h e s e c o n d b u s in e s s o b je c t t y p e re fe rs t o t h e a c tu a l o b je c t in th e a p p l i c a t i o n w h o s e d a t a is p a r t o f t h e I D o c d a t a . T h i s b u s i n e s s o b j e c t t y p e is o p t i o n a l . I t 's a s s ig n e d t o t h e m e s s a g e t y p e u s i n g T r a n s a c t io n B D A 4 , a n d if i t ’s m a i n t a i n e d a p p r o p r i a t e l y i n t h e i n b o u n d p r o c e s s c o d e , t h i s a s s i g n m e n t r e s u lt s in a n u p d a t e o f t h e o b j e c t lin k s .

17 6

C u sto m ID o c s

O b j e c t T y p e ZDOCSMNACH: E d it B a s ic D ata <%B f f t ^ O b je cn yp e

ZDOCSHNACH

O bject N a m e

ZSMNACH

ID O C ZS M N A C H

P rogram

ZSHZOOCSHNACH

O bj.type status

re v is e d

Saved

T ra n s p o rt D a ta

m o d e le d

C h a n g e D a ta

D e fa u lts

C u sto m izin g

Nam e Description

□ Organizational tine A p plication

F i g u r e 4 *126

Business Object Type for Error Workflow

T h e ID o c n u m b e r is a l w a y s t h e k e y f o r s u c h ID o c e r r o r o b j e c t s , a n d a d d i -

Attributes

t i o n a l a t t r i b u t e s a r e t h e m o s t i m p o r t a n t a t t r i b u t e s f r o m t h e h e a d e r tab le, w h i c h is i l l u s t r a t e d in F ig u r e 4 . 1 2 7 . T h e r e d h i g h l i g h t i n g i n d i c a t e s t h a t t h e ZDOCSMNACH ID o c h a s i n h e r i t e d f r o m t h e IDOCAPPL s u p e r t y p e .

O b je c t t y p e •Q

ZDOCSHNACH 0

ID o c

f o r S a b in e

In te r fa c e s IFSAP

SAP s t a n d a r d

In te rfa c e

K ey f i e l d s ■ Z S H N A C H .ID ocN unber o

A t t r ib u te s ------ 2SHNACH. O b je c t T y p e

O b je c t ty p e

------ ZSHNACH

A d d re s s o f se n d e r

S e n d e rA d d re s s

------ ZSHNACH S t a t u s

S ta tu s o f

------ ZSHNACH. S h o r t l n f o

D is p la y s h o rt

------ ZSHNACH C r e a t e D a t e ------ ZSHNACH H e s s a g e T y p e ------ ZSHNACH A p p lO b je c t s In b o u n d

ID o c C r e a t e d

------ ZSHNACH. T r a n s ld ------ ZSHNACH S h o r tn e s s a g e ■ZSHNACH. A p p l 1 c a t 1o n O b j e c t I D

F ig u re 4 .12 7

ID o c In fo

( ID o c n u n b e r a n d l o g i c a l

m es s a g e )

On

M e s s a g e T yp e

V aa

A p p lic a tio n o b je c ts c r e a te d o r changed i n T r a n s a c t i o n ID (tR F C )

text

S h o rt o f ID o c s t a t u s r e c o r d , A p p l i c a t i o n o b j e c t ID

In b o u n d p r o c e s s in g

p o s s ib ly t r u n c a t e d

A ttrib u te s

177

|

4 -4

4

|

C h an g e s to ID o cs

Methods

ZOOCSMNACH a ls o i n h e r i t s t h e n e c e s s a r y m e t h o d s a n d e v e n t s f r o m t h e

and events

s u p e rty p e , w h e re a s th e i n p u t F i n i s h e d e v e n t m u s t b e o v e rw ritte n . Ify o u d o n ’t h a v e a n y s p e c ia l r e q u e s t s , y o u c a n s i m p l y le a v e t h e c o d e a s i t is. F ig u re 4 . 1 2 8 d i s p l a y s o u r s a m p l e b u s i n e s s o b j e c t ty p e .

M e th o d s E x is t e n c e C h e c k

✓

C heck e x is te n c e

of

✓

D is p la y

s ta tu s

-ZSMNACH D i s p l a y ZSMNACH I n p u t A n a ly z e

✓ ✓

D is p la y F o r w a r d in g t o

-ZSMNACH .F o r w a r d

✓

F o r w a r d ID o c t o l o g i c a l s y s te m S u b s e q u e n t p r o c e s s in g f o r a s t a t u s

ZSMNACH D o c u a e n tP ro c e s s ZSMNACH D o c u a e n tP ro c e s s X M L

D is p la y

-ZSMNACH S t a t u s P r o c e s s -ZSMNACH E r r o r H e s s a g e -ZSMNACH

In p u tF o re g ro u n d

•ZSMNACH E r r o r P r o c e s s

and s e t

O

m

o b je c t

XML F o r * a t

» lth

XSL a n d S e t S t a t u s

in b o u n d p r o c e s s in g b y t h e

a p p lic a tio n

E r r o r m essage

✓

In p u t i n

✓

E r r o r h a n d li n g

d ia lo g

D is p la y O b je c ts

✓

D is p la y

In p u tB a c k g r o u n d

✓

In p u t » 1 th o u t d ia lo g

G e n e r a t e d O b je c t s

E v e n ts -ZSMNACH. p r o c e s s S t a t e R e a c h e d -ZSMNACH. e r r o r P r o c e s s C o t p l e t d -ZSMNACH. 1 n p u t E r r o r O c c u r r e d -Z S M N A C H .In p u tS u c c e s s ■ Z S N N A C H .in p u tF in is h e d

Figure

✓ ✓

ID o c c a n b e p r o c e s s e d b y a p p l i c a t i o n E r r o r h a n d li n g c o m p le te d

✓

E rro r in

i-

ID o c p o s t e d s u c c e s s f u l l y

a p p lic a t io n

in p u t,

f u r t h e r p r o c e s s in g r e q u i r e d

ID o c ZSMNACH In b o u n d c o m p le t e d v i a

« o r k flo *

4-128 Methods and Events

Assigning the

H ow ev er, y o u m u s t m a k e a m i n o r c h a n g e to th e A p p l_ O b ject p a ra m e te r

fields from the

(s e e F ig u re 4 .1 2 9 ) , t h a t is, r e f e r to t h e a p p l i c a t i o n . T h i s r e f e r e n c e m u s t

application

s p e c if ie d s e p a r a t e l y f o r e a c h o b j e c t ; i t c a n ' t b e i n h e r i t e d . In t h e D ata T y p e R e f e r e n c e ta b , y o u s p e c i f y t h e c u s t o m R e f e r e n c e T a b le ( h e r e : ZSMH) a n d t h e R e f e r e n c e F ie ld ( h e r e : KEY 1).

Workflow task

N e x t, y o u c r e a t e t h e a c tu a l w o r k f l o w t a s k . T r a n s a c t i o n P F T C J N S is r e q u i r e d h e r e ( s e e F i g u r e 4 . 1 3 0 ) . I n t h e i n p u t s c r e e n , s e l e c t t h e ta s k t y p e , a n d e n t e r a n a m e f o r y o u r w o r k f l o w ta s k . T h e ta s k in t h i s e x a m p l e is o f t h e TS typ e ( s t a n d a r d ta s k ) a n d t h e A b b r e v i a t i o n f o r t h e w o r k f l o w ta s k — in w h a t e v e r a b b r e v i a t e d f o r m — u s u a l l y c o n s i s t s o f y o u r m e s ­ s a g e t y p e a n d t h e t e r m " E rro r" ( h e r e ZSMNAC_Error). In O b j e c t M e t h o d i n t h e O b j e c t T y p e field, y o u r e f e r t o y o u r b u s i n e s s o b j e c t t y p e (h e re : ZDOCSMNACH) a n d in t h e M e t h o d fie ld t o t h e i n h e r i t e d m e t h o d ( h e r e : INPUTFOREGROUND). T h is is t h e t a s k t h a t is e x e c u t e d in t h e f o r e g r o u n d in ID o c s i n g l e p r o c e s s i n g o f a n ID o c h a s r u n o n a n e r r o r s t a t u s . L is tin g 4 . 2 8 in S e c t i o n 4 . 4 . 3 , U p d a t i n g a n ID oc, s h o w s h o w th i s e r r o r is t r i g g e r e d a n d tran sferred to th e w o rk flo w ru n tim e.

17 8

C u sto m ID o c s

O v e r v ie ® P a ra m e te r

O b ).

Typ e

F i r s t R e le a s e

A p p l O b je c t R e s u lt E x c e p t io n

ZOOCSnNACH 700 ZDOCShNACH 700

N o _ o f_ re tn e s

ZOOCSHHACH 700

ZDOCSHNACH 700

□/

LU P a ra m e ter

Appl_Ob)ect

O b jec t r,pe

Z O O CSnN A C H

R e le a s e

700

Texts Nam e Description P a ra m e te r attnbutes □

Multiline

D a ta r»pe reference (S A B A P Dictionary R e fe re n c e table R e fe re n c e field C O b jec t type

0 H ® F i g u r e 4-129

A d a p t i n g t h e O b je c t R eference

S ta n d a rd T a s k : C h a n g e

S ta n d a r d ta s k

971 00179

Name

ZSMNACH input error

Package

ZSMI

g Description

F ig u re 4-130

ZSMNAC.Error

Applicatn Component Container

» ) Triggering events

»?) Tertnmatmg events

W o rk flo w Task fo r E rro r H a n d lin g

179

|

4 -4

4

|

C h an g e s to I D ocs

Assigning the

T h e e v e n t t h a t t r i g g e r s t h e w o r k f l o w ta s k is t h e INPUTERROROCCURRED

start event

e v e n t t h a t is i n h e r i t e d b y IDOCAPPL in t h e b u s i n e s s o b j e c t t y p e (s e e Fig­ u r e 4 .1 3 1 ) .

S ta n d a rd T a sk : C h an g e

Standard task

97100179

Name

ZSMNACH input error

ZSMNAC_Enor

Packaoe

ZSM1

Applicatn Component

|£ Description

< 3 Basic data

Contawe*

A■

B S S r a i B E E I H

Default rules

*>) T«rm«iaang events

O SAPphone

x m M |

Standard events H » .Binding

■ r a

II

I

a

M l

Object Category

lObjectType

BO 808 O b je c t ly p e 3 ZOOCSittuCH ?

Name

[NPUURROROCCIMRED

ZSMNACH Applica#on Error

a|

F ig u re 4131

Binding

Event

S ta rt E v e n t

A w o r k f l o w ta s k r e q u i r e s a b i n d i n g t h a t y o u c a n u s e t o t r a n s f e r t h e d a ta o f t h e o b j e c t to t h e d a t a o f t h e ta s k . T h e s y s t e m c a n c r e a t e t h i s b i n d i n g a u t o m a t i c a l l y . F o r t h i s p u r p o s e , y o u m u s t c lic k o n t h e b i n d i n g v ie w . T h e b i n d i n g o f t h i s e x a m p l e e n s u r e s t h a t t h e w o r k f l o w is p r o v i d e d w i t h i n f o r m a t i o n f r o m t h e ID o c . E v c i y t h i n g is o k a y i f y o u r b i n d i n g a p p e a r s as s h o w n in F ig u r e 4 . 1 3 2 .

l [ ? C har>ai~Bin3ir ; For Task

17

V□

System Fields

JD _A0 hoc_Ob«cts

»j» Ni Hoc Objects ofW orH ow Instar

^ G t

Container © _EVT_OBJECT

J 8 _Macn_Ob)ects

k»

ZSMNACH

© _Wi_Group_ID © _W orklem

h»

0 _EVT_OBJKEY

Event o f a n Object _EVT_OBJKEY

© _Rule_Resu« □ Excepaon

IJ» R esult o f Agent Determination kj W ortfiowEicepdon

o

Agent

© _wi_ObjectJO

»□» C o e fo r Sabine

o _EVT_OBJTYPE

_EVT_CREATOR

Attachments o f Workflow instance

Grouping Characteristic for Workf »j > Slep Inslance

_EVT_RECENSRJC _EVT_RECEfV* R JD _EVT_CREATlON_D Current D a * o f A p p l ication Server _EVT_CR€ATiON_n Current lim e o f Appiicaion Server Result Exception

Finalva lu e o f Mettiod Workflow Eccepoon

MessageType

Message tfp e ( E .i.w . )

MessageNumber Messagevanamei

Message number Message variable 1

D 001

la a a B i

£1

IPIW PJ .p ja ja jp l

a a -

Binding Event •Application Error*-* Task

Task

6EXCEPT10N6

6 _V*_OBJECTJDR

&_EVT OBJECTi

F ig u re 4 .132

18 0

B in d in g for Start Even t

100

C u sto m ID o c s

T h e s u c c e s s fu l u p d a t e o f t h e ID o c is a l w a y s t h e e n d e v e n t , i r r e s p e c t i v e

|

4 -4

Terminating event

o f w h e t h e r i t c o m e s f r o m t h e e r r o r h a n d l i n g o f T r a n s a c t i o n D B 8 7 o r is c a r r i e d o u t v ia a p r o g r a m t h a t is s c h e d u l e d in t h e b a c k g r o u n d . INPUTFINI SHED is t h e n a m e o f t h e e n d e v e n t , w h i c h is t r i g g e r e d in t h e p r e v i o u s l y c r e a t e d p r o g r a m s f o r p r o c e s s i n g t h e ZSMNACH m e s s a g e t y p e (s e e Listing 4 . 2 8 in S e c t i o n 4 . 4 . 3 , U p d a t i n g a n ID o c ). As y o u c a n s e e in F ig u r e 4 . 1 3 3 , a b i n d i n g is n o t a v a il a b le f o r t h e T e r m i n a t i n g e v e n t .

S ta n d a rd T a s k : C h a n g e

S!*nc ate task

97100179

Nam*

Z S M N A C H In p u t e » ro r

Paetage

ZSM 1

Z S M N A C .t r r o r

*i>plksto Co»nponer4

dBas*.

T il

*L D e fa u lt ru le s

Q

S ta n d a rd e v e rt!

F i g u r e 4.1 33

T e rm in a tin g Event

F in a lly , y o u m u s t s p e c i f y w h o m a y c a r r y o u t t h i s ta s k f r o m t h e e r r o r w o r k f l o w . T h i s d e p e n d s o n h o w y o u r e n t e r p r i s e h a n d l e s w o r k f l o w s in g e n e r a l ; in t h e s t a n d a r d v e r s i o n , t h i s i n v o l v e s a G e n e r a l Task t h a t m a y b e p e r f o r m e d b y a n y e m p l o y e e (s e e F ig u r e 4 . 1 3 4 ) . T h e s e t t i n g s in T r a n s a c ­ t i o n W E 2 0 in t h e i n b o u n d p a r t n e r p ro f ile f o r t h e a g e n t w i t h p o s t p r o c e s s ­ i n g a u t h o r i z a t i o n s d e t e r m i n e t o w h o m t h e w o r k f l o w is a c t u a l l y s e n t .

S ta n d a rd ta s k : M a in ta in A g e n t A s s ig n m e n t

ȣ *

fv ** BJ Oig assignment ® a?

ZSMNACH input error

IS 97100179

E ly

P B -'a s k : ® 0 * n * a ' T a t k ........

O General forwarding allowed O General forwarding not allowed O

r orwar» n g n
C la s s t a t i o n

N O .C L A S S N o t c l Q

□ Locked tor instantiation □ Locked against eietution Transfer

F ig u re 4-134

K

A g e n t A ssig n m e n t

18 1

Agent assignment

4

|

C h an g e s to ID o cs

E x te n d in g the

Call T r a n s a c t i o n W E 4 2 a g a in . U p t o n o w , y o u u s e d t h i s t r a n s a c t i o n o n l y

p ro c e s s c o d e b y

f o r l i n k i n g t h e p r o c e s s c o d e a n d t h e f u n c t i o n m o d u l e . N o w y o u a s s ig n

e rr o r h a n d lin g

y o u r b u s i n e s s o b j e c t t y p e (s e e F ig u r e 4 . 1 3 5 ) a n d s p e c if y t h e e v e n t s to b e p r o c e s s e d . T h e ALE c o m m u n i c a t i o n l a y e r in c o m b i n a t i o n w i t h y o u r p r o g r a m t h e n e n s u r e s t h a t t h e c o r r e s p o n d i n g e v e n t s a r e u s e d ( s e e L istin g 4 . 2 8 in S e c t i o n 4 . 4 . 3 , U p d a t i n g a n ID oc).

C h a n g e V ie w " F u n c tio n m o d u le s f o r in b o u n d A L E -E D I" : D e ta ils

Process code

O bject Type Start Event End event Su ccess Event

A p p lic a tio n O bject Object Type Start event

F i g u r e 4-135

A s s ig n in g t h e E rro r H a n d lin g t o t h e Process C o d e

T r a n s a c t i o n SBW P, t h e c e n t r a l w o r k p l a c e , lists t h e f a u l t y I D o c s in t h e W o r k f l o w Tasks in t h e i n b o x . In F ig u re 4 . 1 3 6 u n d e r W

o r k f l o w

,

W

o rkplace

• In

b o x

•

y o u c a n f i n d t h r e e f a u l t y ID o c s f o r w h i c h I w a s s p e c if ie d as

t h e a g e n t in t h e p a r t n e r profile. A s s u m in g the

D o u b l e - c l i c k o n t h e t e x t o f t h e ta s k , a n d t h e s y s t e m n a v i g a t e s to t h e

w o r k f l o w task

a c tu a l p r o c e s s i n g m e n u w h e r e y o u c a n s e t , e d i t , a n d v i e w d e l e t i o n flags (see F ig u re 4 . 1 3 7 ) .

18 2

C u sto m ID o c s

4 -4

|

~ 9 'j\ Business W orkplace of MAISELSA T ? M ew m e s s a g e

j

M

roi<5ef

M

F in d d o c u m e n t

I Q A p p o in tm e n t c a l e n d a r

O istr*uO o*> fcsls

W o rk p la ce MAJSFLSA

" Qintxn *5

0

U n re a d D o c u m e n ts 2

0

D o cu m e n ts 2

H

W o rk flo w 3 T itle

W o r k fl o w 3

P P

C D G r o u p e d a c c o r d in g to c o n te n t □

G r o u p e d a c c o r d i n g t o c o r i e n t ty p e

^

□

G r o u p e d a c c o r d in g to s o r t hey

!• □

S ta tu s

| C re tto n D a

C re tto n

P jM t

' M e s s a g e s f i x in p u t a n d o u t t o u r i d p r o c e s s i n g *

0 8 /1 9 0 0 0 9

11 31 30

5

’ M e s s a g e s f i x i n p - jl a n d o u t b o u n d p r o c e s s i n g •

0 8 /1 9 *2 0 0 8

11 2 8 2 7

5

’ M e s s a g e s f i x m p«ji a n d o u t b o u n d p r o c e s s i n g •

0 8 /1 9 * 2 0 0 8

1 1 :2 8 :2 1

5

Co

[W

G r o u p e d a c c o r d in g to ta s k

[H Owidue errtrioi 0 B

D e a d lin e M e s s a g e s 0

E

in c o ir e c le n t r e s

0

* * “ M e s s a g e s f o r In p u t a n d o u t b o u n d p r o c e s s in g

I- i>Outbo» «■ c 9 P e s u b m i s s i o n

P

Private t o w s

Description

I- ( 9 S h a r e d *oldets

P

P le a s e S o t o P ro b le m

O b j e c t s dill a t t a c h m e n t s

. zsywcH-QQttmxm?6eft)5

in ID o c

c j* ' Wders suDscnoeo » 9

T rash

T J S h a re d tra s h

F i g u r e 4 *136

F a u lty ID o cs in t h e In b o x

D is p la y S ta tu s R e c o rd S3

P ro ce ss

M

D elete tlacj

4 1 I T ] I m I I ID oc D is p la y

ID o c n u m b e r

0000000000768805

D irectio n

2

S t a t u s _________________ M essage

4 = inboun d [51

A pplication d o c u m e n t n o t p o s te d

M e s s a g e s for in p u t a n d o u tb o u n d pro ce ssin g

S ts d e ta ils

Logging_________________________________

T im e o f log en tiy D a te

0 8 /1 9 /2 0 0 8

T im e

1 1 : 13 : S1

T im e o f d a ta b a s e c h a n g e ~7 D a te

0 8 /1 9 /2 0 0 8

T im e

1 1 :1 3 5 1

F i g u r e 4-137

V iew A fter Assuming the W orkflow Task

A g e n t A s s ig n m e n t

of

E rro r Tasks

Y o u a s s ig n a g e n ts t o e r r o r ta s k s in t h e p a r t n e r p r o f ile s . In i t ia l ly , y o u s e a rc h f o r t h e a c tu a l m e s s a g e in t h e i n d i v i d u a l d is p la y ; i f y o u c a n ’t fin d a n y t h i n g t h e r e , t h e s e tt in g s f o r t h e e n t ir e p a r t n e r a re s c a n n e d , a n d i f y o u c a n 't f i n d a n y t h in g t h e r e e it h e r , t h e e r r o r is s e n t to t h e ID o c

18 3

Agent assignment

4

|

C h an g e s to ID o cs

a d m i n i s t r a t o r . T h e s y s t e m c h e c k s w h e t h e r a s p e c if ic u s e r is d e f i n e d o r b e l o n g s t o t h e o r g a n i z a t i o n a l u n i t t h a t is s p e c if ie d t h e r e a n d w h e t h e r t h e u s e r is a l l o w e d t o e x e c u t e t h e ta s k . E v e i y u s e r m a y c a r r y o u t a ta s k o f t h e g e n e ra l ta s k t y p e o r a t a s k t h a t w a s a s s i g n e d to t h e u s e r v i a t h e o r g a ­ n i z a t i o n a l m a n a g e m e n t in SAP ERP H C M . T h e ta s k s a r e e i t h e r s p e c if ie d in t h e j o b d e s c r i p t i o n o r a s s i g n e d d ire c tly . C o o r d i n a t e t h e s e t t i n g s in th e o rg a n iz atio n al m a n a g e m e n t w ith th e e m p lo y e e s re s p o n sib le because t h e s e s e t t i n g s c a n a l s o i n f l u e n c e o t h e r e l e m e n t s in t h e SAP s y s t e m . IDoc administrator

U s e T r a n s a c t i o n O Y EA t o m a i n t a i n t h e ID o c a d m i n i s t r a t o r a n d s o m e o t h e r g e n e r a l s e t t i n g s . H e r e , y o u c a n a ls o e n t e r d e f a u l t s e t t i n g s f o r f r e ­ q u e n t l y r e q u e s t e d a s p e c t s , s u c h as t h e m a x i m u m n u m b e r o f s y n t a x e r r o r s p e r I D o c (s e e F ig u r e 4 . 1 3 8 ) .

G lo b a l P a ra m e te rs f o r ID o c In te rfa c e

B A W .H I-m W IJ M

U s e r Info____________________________________________

ID o c Administrator O ^ e t t Type'

0

Identification

□

50010120

Organizational unit E D I Department

G eneral ID oc Interface M ax Num ber of Syntax Errors

1

IDoc Inbound Processing using tRFC Server Group fo r ID oc inbound

Outbound IDocs U s ing tR F C ,

I

□

U s e Last C ode Page Found

IDoc inbound from File/ C l S y n chro nous P roc e s s in g E W arnings for Status Processing C o m m it M e r

Figure

4 .4 . 6

0

D ata Records

4138 Global Settings U s e fu l F u n c t io n A A o d u le s

Som e o f th e n ecessaiy fu n c tio n m o d u le s fo r p ro cessin g c u s to m -p ro ­ g r a m m e d ID o c s h a v e a l r e a d y b e e n i l l u s t r a t e d in t h e p r o g r a m m i n g e x a m -

18 4

C u sto m ID o c s

|

4 -4

p ie s . T a b le 4 . 3 lists t h e m o s t i m p o r t a n t f u n c t i o n m o d u l e s a g a i n f o r y o u r r e f e r e n c e . T h is lis t a ls o i n c l u d e s t h o s e c o n v e r s i o n m o d u l e s t h a t a r e n 't c o n t a i n e d in t h e e x a m p l e s .

F u n c tio n M o d u le

F u n c tio n

A L E _ M O D E L _ D E T E R M IN E _ IF _ T O _

C h e c k w h e t h e r a s p e c ific m e s s a g e m a y b e g e n e ra te d

SEND

a c c o rd in g t o th e d is tr ib u tio n m o d e l.

A L E _ S E R IA L _ K E Y 2 C H A N N E L

D e t e r m in e / s e t o b je c t c h a n n e l f o r s e ria liz a tio n .

C L O L C O N V E R S IO N _ P E R F O R M

C o n v e rs io n f r o m in te rn a l t o e x te rn a l fo rm a ts .

C L O I_ P U T _ S IG N _ IN _ F R O N T

P u t m in u s s ig n in f r o n t.

C U R R E N C Y _ A M O U N T _ ID O C _ T O _ S A P

C o n v e rt cu rre n c y a m o u n ts to SAP fo rm a t.

C U R R E N C Y _ A M O U N T _ S A P _ T O _ ID O C

C o n v e rt c u rre n c y a m o u n ts to e x te rn a l fo rm a t.

C U R R E N C Y _ C O D E _ IS O _ T O _ S A P

C o n v e r t c u rr e n c ie s f r o m IS O c o d e t o S A P fo r m a t.

C U R R E N C Y _ C O D E _ S A P _ T O _ IS O

C o n v e r t c u rr e n c ie s f r o m S A P f o r m a t t o IS O c o d e .

ID O C _ D A T E _ T IM E _ G E T

G e t s ta tu s i n f o r m a t i o n f r o m t h e re c e iv e r.

ID O C _ R E D U C T IO N _ F IE L D _ R E D U C E

D e t e r m in e a c tiv e fie ld s in t h e re d u c e d m e s s a g e ty p e .

ID O C _ S E R IA L IZ A T IO N _ C H E C K

C h e c k t im e s t a m p in t h e s e ria liz a tio n fie ld o f t h e ID o c header.

ID O C _ S E R IA L _ P O S T

U p d a te t h e s e ria liz a tio n ta b le .

ID O C _ S T A T U S _ W R IT E _ T O _ D A T A B A S E

C h a n g e I D o c s ta tu s .

L A N G U A G E _ C O D E _ IS O _ T O _ S A P

C o n v e r t la n g u a g e c o d e f r o m IS O c o d e t o S A P f o r m a t .

L A N G U A G E _ C O D E _ S A P _ T O _ IS O

C o n v e r t la n g u a g e c o d e f r o m S A P f o r m a t t o IS O c o d e .

M A S T E R J D O C .D IS T R IB U T E

T r a n s f e r I D o c t o t h e c o m m u n i c a t i o n la y e r .

M M O D E L _ IN T _ V A L ID _ G E T

D e t e r m in e in t h e d is t r ib u t io n m o d e l w h o s e n d s w h ic h m essage to w h o m .

O W N _ L O G IC A L _ S Y S T E M _ G E T

F in d th e c u s to m lo g ic a l s y s te m n a m e .

R F C _ D A T A _ D E T E R M IN E _ F O R _ C H E C K S

D e t e r m in e an RFC d e s t in a t io n o f a p a rtn e r.

U N I T _ 0 F _ M EA S U R E _ l S O _ T 0 _ S A P

C o n v e rt u n it o f m e a s u re f r o m IS O c o d e t o S A P fo r m a t.

U N IT _ O F _ M E A S U R E _ S A P _ T O _ IS O

C o n v e r t u n it o f m e a s u r e f r o m S A P f o r m a t t o IS O c o d e .

T a b le 4 .3

F u n c t i o n M o d u l e s f o r I D o c P r o c e s s in g

18 5

4

|

C h an g e s to ID o cs

4 .5

S u m m a ry

N o w y o u ' v e s e e n all t h e d e v e l o p m e n t ta s k s f o r m a n a g i n g c o m p a n y s p e ­ cialties in ID o c s . W e s t a r t e d w i t h t h e a d a p t i o n o f s t a n d a r d ID o c s w i t h C u s t o m i z i n g tasks, b e c a u s e t h i s is t h e e a s ie s t w a y . T h e n e x t s t e p is t h e d e v e l o p m e n t o f c h a n g e s to s t a n d a r d ID o c s w i t h t h e h e l p o f e n h a n c e m e n t t e c h n i q u e s . To d o so , w e r e v i e w e d t h e t e c h n i q u e s a v a il a b le f o r t h e n o n ­ i n t e r a c t i v e ID o c p r o c e s s i n g . At th e e n d w e w e n t th ro u g h th e c o m p le te p rocess o f d e v e lo p in g cus­ t o m e r ID ocs s ta rtin g w ith th e a p p lic a tio n tables a n d e n d in g w ith th e c o m p l e x p r o c e s s o f ID o c e r r o r h a n d l i n g .

18 6

ID o c c o m m u n ic a tio n is e s s e n tia lly a s y n c h ro n o u s — th e s e n d in g s y s te m d o e s n 't receive in fo r m a tio n a b o u t h o w th e ID o c is p r o ­ cessed in th e rec eivin g s y s te m . B u t, t h i s in fo r m a tio n c a n b e tr a n s ­ f e r r e d f r o m th e receiver to th e sender. T his c h a p te r w ill o u tlin e th e v a rio u s o p tio n s a v a ila b le here.

5

Confirmations

I D o c c o m m u n i c a t i o n is f u n d a m e n t a l l y a s y n c h r o n o u s . In o t h e r w o r d s , th e s e n d e r d o e s n 't receiv e a n y in fo rm a tio n a b o u t h o w th e re c e iv e r p r o ­ c e s s e s t h e ID o c . H o w e v e r , i f r e q u i r e d , t h e r e c e i v e r c a n a c ti v e ly s e n d th is i n f o r m a t i o n b a c k to t h e s e n d e r .

5.1

"A LE A U D " I D ocs

ALEAUD ID o c s a r e g e n e r a l l y d e p l o y e d w h e n t w o SAP s y s t e m s a r e in u se. T h i s s c e n a r i o (a s e n d e r s e n d s a n a p p l i c a t i o n ID o c a n d a r e c e i v e r s e n d s b a c k a n ALEAUD ID oc) is k n o w n a s A L E a u d it. In SAP N c t W e a v e r P ro c e s s I n t e g r a t i o n (SAP N e t W e a v e r PI), t h e ID o c a d a p t e r a ls o p r o c e s s e s t h e ALE­ AUD ID o c a s a n a p p lica tio n a ckn o w led g m en t. To u s e a n ALEAUD ID oc, y o u n e e d a s u i t a b l e d i s t r i b u t i o n m o d e l (s e e Fig­

D is trib u tio n m odel

u r e 5 .1 ) t h a t i n s t r u c t s t h e r e c e i v e r o f t h e o r i g i n a l ID o c to s e n d a n ALEAUD

fo r ALE a u d it

I D o c to t h e s e n d e r o f t h e o r i g i n a l ID oc.

*

g g .Z S M I ^

^

^

...

ZSM 1

0 X D O c lie n t 800 0

T90CLN T090

P rod uctive s y s te m (c lie n t 8 1 1 )

P R O D U C T IO N

f a ZSMNACH

S a b in e s M e s s a g e Type

@

Productive s y s te m (c lie n t 8 1 1 )

P R O D U C T IO N

^

0

XD O c lie n t 800

T90CLN T090

^

f a ALEAUD

A L E : C o n firm a tio n s for in b o u n d ID ocs

N o filter set

F i g u r e 5.1

P a rtn er M o d e l f o r th e " A L E A U D " ID oc

187

5

C o n firm a tio n s

I n it ia l s t a tu s va lu e s

The

ID o c c o n f i r m s t h e s t a t u s o f t h e ID o c in t h e t a r g e t s y s t e m .

ALEAUD

F ig u r e 5 .2 s h o w s s o m e p o s s i b l e s t a t u s v a lu e s . F o r e x a m p l e , a n ID o c is a s s i g n e d s t a t u s 5 3 i f i t's p o s t e d su c c e s s fu lly . I n a d d i t i o n , a d e l e t i o n flag c a n b e s e t t o p e r m a n e n t l y e x c l u d e a n ID o c f r o m p r o c e s s i n g ( s t a t u s 68) o r a n ID o c c a n h a v e a n i n t e r m e d i a t e p r o c e s s i n g s t a t u s (e .g ., s t a t u s 64: W a itin g a n d 5 1 : Incorrect processing).

^

1 3 Productive s y s te m (client 811)

P

G $ ID o c s in outb o u n d pro ce ssin g

^

[ £ | ID oc in in b o u n d pro ce ssin g l>

24 13

11

O A p p lic a tio n do cu m e n t n o t posted

61

3

53

^

Q E r r o r- n o fu r in e r pro ce ssin g

68

2 2

l>

&

64

4

I1 0

A p p lic a tio n do cu m e n t posted

ID oc re a d y to be tra n s fe rre d to app lica tion

F ig u r e 5.2

ID o c S tatus V a lu e s in R e c e iv in g S ystem

W e 'l l n o w u s e t h e r e p o r t

RDBSTATE

t o s e n d o u r c o n f i r m a t i o n s . T h is r e p o r t

m u s t b e s c h e d u l e d o n a r e g u l a r b a s i s . F ig u r e 5 .3 s h o w s t h e r e q u i r e d e n t r i e s , t h a t is, f o r w h i c h y o u w a n t

ALEAUD

ID o c s to b e g e n e r a t e d , f o r

w h i c h m e s s a g e t y p e , a n d f o r w h i c h p e r io d .

D a le ID o c c h a n g e d

F ig u re 5 .3

“ A L E A U D " ID oc

The

____________________18 8 / 0 1 / 2 8 8 8 |

to_____ [ 0 8 / 0 1 / 2 0 0 9

"R BD S TA TE" R e p o rt

ALEAUD

ID oc co n tain s a h e a d e r s e g m e n t, w h ic h p ro v id e s in fo rm a tio n

a b o u t t h e s e l e c t i o n m a d e b y t h e u s e r . I n o u r e x a m p l e , i t s t a t e s t h a t w e 'l l s e n d c o n firm a tio n s for th e m e ssag e ty p e

ZSMNACH

( s e e F ig u r e 5 .4 ). This

is f o l l o w e d b y o n e s e g m e n t f o r e a c h ID o c in t h e s e l e c t i o n p e r i o d , w h i c h p r o v i d e s i n f o r m a t i o n a b o u t t h e s t a t u s o f t h e ID o c in t h e r e c e i v i n g s y s t e m a s w e ll a s t h e ID o c n u m b e r i n b o t h s y s t e m s .

18 8

" A L E A U D " ID o c s

SEGNUM

S e g m en t Num ber

SEGNAM

v^p v uni m i i vpi rt i i iNam m i 1 ip v

c lADHD*

MESTYP_LNG i im w CAvmiiv n

M essag e Type

ZSMNACH

o c y i i i c i u iNum v u i i ihor uci

nn n n n i

SEGNAM

Se g m en t N am e

E1STATE

DOCNUM

ID oc number

C0 0 0 0 0 0 0 0 0 7 6 8 8 J7

STATUS

Status o f IDoc

S3

STACOD

Stalus code

STAPAI

000001

SAP0CC

[P aram eter 1

ok

STATVP

Type of system error m es s a g e (

S : Su ccess m essage

STAMQU

Stalus m e s s a g e qualifier

SAP

C T B H fJn

niirrthPr

nnn

STAPAI JJV O

Param eter i

86G N U M

S e g m en t Num ber

000003

SEGNAM

Se g m en t N am e

E1PRTOB

DOCNUM

ID oc number

0000000000135191

P FVfiN WW I I

W v U l l l v l l i lNi Uu ImI I hU Pv fl

000004

SEGNAM

Se g m en t N am e

E1STATE

DOCNUM

IDoc number

000 00 0 0 0 0 0 7 6 8 8 0 8

STATUS

Status o f IDoc

68

STACOD

Status code

SA P3CC

STAMOU

Stalus m e s s a g e qualifier

SAP

QTAMMO

oStatue w iu ®

SEGNUM

Se g m en t Num ber

SEGNAM

S e g m en t N am e

E1P=?"CB

iC C N U M

ID oc number

000 00 0 0 0 0 0 1 3 5 1 9 2

!M

F ig u r e 5.4

|

rn a c c a n o ini iim u i mh uo c ir

0k

inn 000005

S a m p le " A L E A U D " ID o c

T h e r e s u lt s h o w n in t h e s e n d i n g s y s t e m c o m p r i s e s t h r e e n e w s t a t u s v a l ­

S t a t u s v a l u e s in

u e s (3 9 , 4 0 , a n d 4 1 ), a s s h o w n i n F ig u r e 5 . 5 . S ta t u s v a l u e 4 0 : A p p lica tio n

s e n d in g syste m

d o c u m e n t n o t created in ta rg e t system is r e d b e c a u s e e v e n i f t h e s e n d e r n o lo n g e r n e e d s to ta k e ac tio n h ere, it s h o u ld b e c le a r th a t th e p a r tn e r d i d n 't p o s t t h e s e ID o c s b u t a s s i g n e d t h e m s t a t u s 68: E rror - no f u r t h e r process­ in g i n s t e a d . T h e f o l l o w i n g t w o s t a t u s v a l u e s a r e g r e e n : 4 7 , w h i c h , in th e se n d in g sy stem , m e a n s th a t th e receiving sy stem successfully pro cessed t h e ID o c ( a n d t h e r e f o r e o b t a i n e d s t a t u s 5 3 ), a n d s t a t u s 3 9 , w h i c h m e a n s t h a t t h i s ID o c is still in a n i n t e r m e d i a t e s t a g e . A ll ID o c s t h a t h a v e a v a l u e o t h e r t h a n 5 3 o r 6 8 in a p a r t n e r s y s t e m a r e a s s i g n e d s t a t u s 3 9 b e c a u s e it's a s s u m e d t h a t t h e p a r t n e r w ill c o n t i n u e t o p r o c e s s all ID o c s t h a t d o n ’t hav e statu s 53 o r 6 8 u n til th e y o b ta in statu s 53 o r 68.

~

@ X D 0 client 800

10

^

10

ID ocs in outbound processing ^

© Application docum ent n o t created in target system l>

^

□

40

ID oc is m the target sys tem (ALE service)

39

l> f a ZSMNACH ^

□ Application docum ent created in target system

P

F ig u re 5 .5

b

1 1

zsm nach

7 7

41

ZSMNACH

2 2

Status V a lu e s in S e n d in g System A fte r A L E A u d it

18 9

5-1

5

|

C o n firm a tio n s

ID o cs w it h a u d it m essages

I f t h e s t a t u s o f a n ID o c c h a n g e s in a p a r t n e r s y s t e m , a n d i f t h e r e p o r t RBDSTATE

5.2 W hen

is c x c c u t e d a g a in , a n e w e n t i y is s e n t w i t h i n a n

ALEAUD

ID oc.

“STA TU S" ID o cs ALEAUD

ID o c s a r e u s e d to s e n d c o n f i r m a t i o n s , all t h r e e s t a t u s v a l ­

u e s r e s u l t i n t h e s e n d e r n o l o n g e r b e i n g a b l e to p r o c e s s o r r e s e n d t h e ID o c . H e r e , i t ’s g e n e r a l l y a s s u m e d t h a t t h e r e c e i v e r w i l l r e s o l v e a n y e r r o r s t h a t o c c u r . H o w e v e r , i n t h e c a s e o f EDI s u b s y s t e m s , in p a r tic u la r, y o u m a y s e e a d d i t i o n a l s t a t u s v a l u e s i n t h e EDI s u b s y s t e m , o r y o u m a y w a n t t o r e s e n d a n ID o c b e c a u s e a n e r r o r o c c u r r e d in t h e EDI s u b s y s t e m . Y o u 'r e a l r e a d y f a m i l i a r w i t h s t a t u s p r o c e s s i n g f r o m C h a p t e r 3, S e c tio n 3 .3 , P ro c e s s i n g S ta t u s F iles. H e re , a n ID o c is u s e d to c r e a t e a n e w s t a t u s v a l u e f o r t h e o r i g i n a l ID oc. P ro c e ssin g by w o rk flo w task

F ig u r e 5 . 6 s h o w s p r o c e s s c o d e

STA1,

w h i c h is u s e d t o p o s t t h e

STATUS

ID o c. A s y o u c a n s e e , p r o c e s s i n g b y ( w o r k f l o w ) ta s k is s p e c if ie d u n d e r P ro c e s s i n g T y p e i f y o u r s y s t e m h a s n o t c h a n g e d s i n c e it w a s d e l i v e r e d b y SAP. F o r t h i s r e a s o n , y o u s h o u l d o n l y u s e

STATUS

ID o c s i f y o u re a lly n e e d

t h e o t h e r s t a t u s v a l u e . W o r k f l o w p r o c e s s i n g is m o r e p e r f o r m a n c e - i n t e n ­ s iv e t h a n p r o c e s s i n g b y f u n c t i o n m o d u l e . W h e r e p o s s i b l e , y o u s h o u l d w o r k w ith th e

ALEAUD

s c e n a r i o . You s h o u l d a ls o o n l y w o r k w i t h

ID o c s i f y o u w a n t t o p r o c e s s ID o c s a g a in .

19 0

STATUS

'S T A T U S " ID o c s

|

5-2

T h e STATUS I D o c d o e s n ' t t r a n s f e r t h e s t a t u s o f t h e ID o c in t h e r e c e i v ­

“STATUS" m essage

i n g s y s t e m . I n s t e a d , y o u s p e c i f y t h e n e w s t a t u s t h a t y o u w a n t t h e ID o c

typ e

to o b t a i n in t h e s e n d i n g s y s t e m , a l o n g w i t h a s u i t a b l e p i e c e o f t e x t . In o u r e x a m p l e , t h i s t e x t is a l w a y s h a r d - c o d e d i n t h e ID o c. You c a n a ls o r e f e r e n c e a m e s s a g e i n a m e s s a g e class, b u t t h i s m u s t e x i s t i n t h e o r i g i ­ n al s e n d i n g s y s t e m . T h e l a t t e r o p t i o n fa c i l it a t e s t h e u s e o f m o r e u s e r fr ie n d ly , la n g u a g e - s p e c if i c m e s s a g e s . F ig u r e 5 . 7 s h o w s t h e m a i n fie ld s in t h e STATUS ID o c , t h e r e f e r e n c e t o t h e ID o c t h a t is t o r e c e i v e a n e w s t a t u s v a l u e , t h e n e w s t a t u s v a l u e itself, a n d t h e c o m m e n t text.

ID oc disp lay “

T ec h n ic a l sh o rt info 7

C J IDOC 0 0 0 0 0 0 0 0 0 0 7 6 8 8 3 2 H ) C ontrol R e c.

^ <3 D a ta reco rd s □

E 1S TA TS

O lrection

2

C u rre n t status

53

B a sic fip e

SYSTATG1

Total n u m b e r 0 0 0 0 0 1 S e g m e n t 000 001

I 1 CD Status records

Inbox CC•

E xtension STATUS

M e s s a g e type P a rtn e r No.

PRODUCTION

P a rtn Type

LS

Pori

SUBSYSTEM

C o n te n t o f s e le c te d s e g m e n t

F id n a m e

Fid cont

MANDT

800

DOCNUn

0000000000768796

B

L080AT

20080801

L j

LOST IM STATUS

0

01010

6

UNAHE

MAISELSA

STATXT

STATUS CHANGE W ITH ST ATM 1

LI E 0

i || * ||

F ig u re 5 .7

1

j

«

! K

M

S a m p le "STATUS" ID o c

F ig u r e 5 . 8 s h o w s t h e r e s u l t o f p o s t i n g t h e SYSTAT ID o c . I n o u r case,

Im p le m e n te d

s t a t u s v a l u e 18, E D I su b sy ste m in itia liza tio n O K is a s s i g n e d . S im ila rly , th is

sta tu s

s t a t u s d o e s n ’t p e r m i t f u r t h e r p r o c e s s i n g .

19 1

5

C o n firm a tio n s

S ta tu s M o n ito r f o r A L E M e s s a g e s D is p la y ID ocs

D is p la y re la tio n s h ip s j

□QQECDE3EED

D is p la y s ta tu s lo n g text

®

O b jec t key

I@!SBE13[D3Q

Doc Selection ID oc n u m b e r|S la t 768796

18

|M e s s a g e Type

StatusText

P a rtn e r No.

[B asicT y p e

ZSM NACH

S T A T U S C H A N G E W IT H S T A T U S ID O C

P R O D U C T IO N

|ZSM TY P01

F ig u re 5 .8

5 .3

j

S e g m e n ts 9

M o d i f i e d ID o c in th e S e n d in g S ystem

S u m m a ry

Y o u 'v e s e e n n o w t h e d i f f e r e n t p o s s i b i l i t i e s f o r b r i n g i n g i n f o r m a t i o n a b o u t t h e ID o c b a c k t o t h e o r i g i n a l s e n d e r . T h is h e l p s y o u t o o v e r c o m e o n e o f the d isa d v a n ta g e s o f a sy n c h ro n o u s c o m m u n ic a tio n : n o t k n o w in g w h a t h a p p e n e d a t y o u r p a r t n e r 's s ite . A ls o , w i t h t h e h e l p o f t h e STATUS ID o c o r t h e S ta tu s File, y o u a r e a b l e t o r e s e n d a n ID o c t h a t w a s a l r e a d y s e n t successfu lly b efo re. In t h e n e x t c h a p te r , w e 'l l r e v i e w t h e m o r e c o m p l i c a t e d p r o c e s s e s , w h e r e t h e s e q u e n c e o f I D o c s b e c o m e s a n i m p o r t a n t f a c to r, t h e s e r i a l i z a t i o n m e t h o d s f o r ID ocs.

19 2

E ven th o u g h n o r m a l ID o c c o m m u n ic a tio n m a k e s p ro v isio n f o r th e u se o f tim e s ta m p s to s o r t s y s te m ID ocs in th e co rrect sequence b e fo re th e y a r e d is p a tc h e d o r p o ste d , ID ocs m a y " q u e u e j u m p " d u r in g p a r a lle l p ro c e ssin g a n d w h e n te r m in a tio n s occur. I f y o u d o n 't w a n t th is to h a p p e n , y o u m u s t e n su re t h a t ID ocs are a lw a y s p ro cessed in e x a c tly th e co rrect sequence.

6

Serializing IDocs

In s o m e s i t u a t i o n s , i t's n e c e s s a r y t o a d h e r e to t h e e x a c t p o s t i n g s e q u e n c e f o r ID o c s . O n e s u c h s i t u a t i o n i n v o l v e s g o o d s m o v e m e n t s . I f q u e u e - j u m p ­ in g o c c u r s a m o n g ID o c s t h a t h a v e g o o d s m o v e m e n t s f o r t h e s a m e m a te r ia l in t h e s a m e s t o r a g e b in , t h i s w ill r e s u l t in n u m e r o u s d i f f e r e n t p o s t i n g s , w h i c h a r e n o t d e s i r a b l e f r o m a fin a n c ia l a u d i t o r s y s t e m lo a d p e r s p e c t i v e . So, SAP s o f t w a r e s u p p o r t s s e v e r a l t y p e s o f ID o c s e r ia li z a t io n : ► S e r i a l i z a ti o n u s i n g s e r i a l i z a t i o n g r o u p s

S e ria liz a tio n o p tio n s

► S e r i a l i z a ti o n u s i n g t i m e s t a m p s ► S e r i a l i z a ti o n u s i n g b u s i n e s s o b j e c t s ► S e r i a l i z a ti o n u s i n g qR FC N o t all s e r i a l i z a t i o n t y p e s a r e a l w a y s p o s s i b l e . A lso, t h e y c a n h a v e v a r i ­ o u s d i f f e r e n t e f f e c ts . In t h e n e x t s e c t i o n , w e 'l l d e s c r i b e h o w t o u s e e a c h s e r i a l i z a t i o n t y p e , h o w to fin d t h e m e s s a g e t y p e s s u p p o r t e d , a n d h o w to co n fig u re th e e n tire process.

6.1

S e ria liz a tio n U sin g G ro u p s

W h e n u s i n g g r o u p s f o r s e r ia liz a tio n p u r p o s e s , y o u a s s u m e t h a t m o r e t h a n o n e ID o c is b e i n g d i s p a t c h e d f o r a p a r t i c u l a r p r o c e s s , s o n u m e r o u s d if ­ f e r e n t m e s s a g e t y p e s a r e u s e d . In t h e c a se o f a m a t e r ia l m a s te r, f o r e x a m ­ ple, y o u a ls o h a v e t h e o p t i o n o f m a k i n g a c la s s ific a tio n w h e n y o u c re a te

19 3

6

|

S e ria liz in g I D o cs

a m a t e r i a l . C la s s ific a tio n s a r e t h e n s e n t w i t h t h e m e s s a g e t y p e C L F M A S , w h ile m ateria ls are s e n t w ith th e alre a d y fa m iliar m e ssa g e ty p e MATMAS. P ro c e s s in g

A m a te r ia l m a s t e r is r e q u i r e d to s u c c e s sfu lly p r o c e s s t h e C L F M A S ID o c. I f a

sequence

m a te r ia l is c r e a t e d , p o s t i n g p r o b l e m s m a y o c c u r i f t h e C L F M A S ID o c q u e u e j u m p s a n d o v e r ta k e s t h e M A T M A S ID o c. E v e n t h o u g h t h e C L F M A S ID o c c a n be s u c c e s s fu lly p o s t e d i f t h e ID o c is r e s ta r t e d a f t e r t h e M A T M A S I D o c a r r i v e d a n d w a s p o s t e d succ essfu lly , i t ’s b e t t e r , in t e r m s o f s y s t e m p e r f o r m a n c e , i f s u c h q u e u e - j u m p i n g is p r e v e n t e d . F o r th is r e a s o n , y o u h a v e t h e o p t i o n o f g r o u p i n g t h e m e s s a g e t y p e s i n t o a s e r ia li z a t io n g r o u p in t h e s e n d i n g a n d re c e iv in g s y s t e m s as w e ll as s p e c if y in g t h e r e q u i r e d p r o c e s s i n g s e q u e n c e . A p r e r e q u i s i t e f o r t h i s p r o c e d u r e is t h e u s e o f a c h a n g e p o i n t e r to e v a lu a te t h e r e l e v a n t ID ocs, s o th is p r o c e d u r e c o n c e r n s m a s t e r d a ta .

E v a lu a tio n r e p o r t

In stea d o f u sin g th e re p o rt RBDMI DOC to e v a lu a te th e c h a n g e p o in te rs o r

"R B D S E R 0 1 "

T r a n s a c t i o n B D 2 1 , w h i c h e v a l u a t e s all o f t h e c h a n g e p o i n t e r s f o r a m e s ­ s a g e t y p e , y o u u s e t h e r e p o r t R B D S E R 0 1 , w h i c h s e le c ts all o f t h e c h a n g e p o i n t e r s f o r a g r o u p o f m e s s a g e t y p e s a n d e n s u r e s t h a t all I D o c s w i t h t h e first m e s s a g e t y p e a r e c r e a t e d first, f o l l o w e d b y all ID o c s w i t h t h e s e c o n d m e s s a g e t y p e , a n d s o o n . I f i n d i v i d u a l ID o c s c o n t a i n e r r o r s , t h e y a r e i g n o r e d a n d a d d e d later, in t h e u s u a l w a y , v ia e r r o r h a n d l i n g .

S e ria liz a tio n

To w o r k w i t h s e r i a l i z a t i o n g r o u p s , i t's i m p o r t a n t t h a t p r o c e s s i n g in b o t h

g ro u p s

t h e s e n d i n g a n d r e c e i v i n g s y s t e m s is s e t t o W a i t f o r B a c k g r o u n d P r o g r a m in t h e p a r t n e r p r o f ile s in T r a n s a c t i o n W E 2 0 . T h e f ir s t s t e p w h e n w o r k i n g w i t h s e r i a l i z a t i o n g r o u p s is t o u s e T r a n s a c ­ t i o n B D 4 4 t o c r e a t e t h e s e r i a l i z a t i o n g r o u p in t h e s e n d i n g a n d r e c e i v i n g s y s t e m s . F ig u r e 6.1 s h o w s t h e s e t t i n g s f o r o u r c la s s ific a tio n e x a m p l e . T h e m a t e r ia l m a s t e r s ( M A T M A S ) will b e p r o c e s s e d first, f o l l o w e d b y t h e c la s ­ s ific a tio n a s s i g n m e n t s ( C L F M A S ) .

Change V iew "A s s ig n m e n t o f lo g ic a l m e ssa g e s to se ria l, g ro u p ": N e w Entries

C ft y ,

g jL ©

Q

Dialog Structure ^

S erializat group

ZSH1

P i Serialization aroups £ 3 A s sig nm ent o f logical m e s s a g e s

A ssig nm ent o f logical m e s s a g e s to serial group rfessage ty p e CLFHAS J - m

F ig u re 6.1

19 4

m

C re a tin g a S e ria liz a tio n G ro u p

s e q . nu m b e r “

2

0l

S e ria liz a tio n U sin g G ro u p s

T h e s e s e t t i n g s m u s t b e c o n f i g u r e d in b o t h t h e s e n d i n g a n d r e c e i v i n g s y s ­

|

6.1

P a r a lle l p r o c e s s i n g

t e m s . In t h e r e c e i v i n g s y s t e m , y o u c a n a ls o s p e c i f y a d d i t i o n a l i n f o r m a ­ ti o n a b o u t p a ra lle l p r o c e s s i n g in C o l u m n P. In o u r e x a m p l e (s e e F igure 6 .2 ), h o w e v e r , t h e flag f o r p a r a lle l p r o c e s s i n g w a s n o t s e t b e c a u s e y o u w o u l d t h e n n e e d to s p e c i f y a s e r v e r g r o u p . It's b e s t t o l e a v e s u c h s p e c i ­ fic a tio n s to y o u r s y s t e m a d m i n i s t r a t o r .

In b o u n d p ro c e s s in g o f s e n a liz a tio n group G roup

Z8N1

F ig u re 6 .2

M e s s a g e Typ e

Is e n d in g sys t |Ob>fProc

P

MATMAS

T90CLN T090

100

□

CLFMAS

T90CLNTQ9O

50

R F C serve r group

□

P r o c e s s in g i n t h e R e c e i v i n g S y s te m

In t h e s e n d i n g s y s t e m , y o u t h e n u s e t h e r e p o r t RBDSER01 o r T r a n s a c t i o n

C re a tin g ID o c s fo r

B D 4 0 to c r e a t e I D o c s f o r a p a r t i c u l a r g r o u p . H e r e , y o u o n l y n e e d to

a g ro u p

s p e c if y t h e s e r i a l i z a t i o n g r o u p (s e c F ig u r e 6 .3 ). T h is is a ls o t h e c a se f o r t h e r e p o r t s d e s c r i b e d n e x t.

G e n e ra te ID o c s f o r S e ria liz a tio n G ro u p F ro m C h a n g e P o in te rs

I s Serializatio n G ro u p

F ig u re 6 .3

ZSf11|

©

C re a tin g ID o cs f o r a G ro u p

First, t h e s y s t e m g e n e r a t e s all o f t h e MATMAS ID o c s (s e e F ig u r e 6.4 ).

| [ & Info rm ation

E 3 /

3 m a s te r ID o c s .s ^

F ig u re 6 . 4

F irs t M e s s a g e T y p e C r e a t e d

T h e n , it g e n e r a t e s t h e classification ID o cs (see F igu re 6.5 ). In b o t h cases, th e c u s t o m e r d i s t r i b u t i o n m o d e l is r e le v a n t f o r d e t e r m i n i n g w h i c h p a r t n e r will re c e iv e t h e ID ocs. F o r e a c h c h a n g e , y o u c a n a ls o c r e a t e s e v e ra l ID ocs fo r v a r io u s d i f f e r e n t p a r tn e r s , i f t h e u s e o f m u l ti p l e re c e iv e rs is p e r m i t t e d .

19 5

6

|

S e ria liz in g ID o c s

l [ g

In fo rm a tio n

[* J/

ip .? ? ? .

H R to [ .m

s a g e ty p e C L FM A S

a s ___________________________________________ F ig u re

6 .5

S e c o n d M e s s a g e T y p e C r e a te d

S e ria liz a tio n g ro u p

In t h e s e n d i n g s y s t e m , all o f t h e s e n e w ID o c s o b t a i n s t a t u s SO: R ead y f o r

in o u t b o u n d

dispatch, a s s h o w n in F ig u r e 6 . 6 . To r e ta i n t h e s e q u e n c e , it's i m p o r t a n t

p ro c e s s in g

t h a t t h e s e ID o c s a r e n o t i n c l u d e d in c o n v e n t i o n a l d i s p a t c h j o b s ( r e p o r t R S E O U T O O ) . T h e v a r ia n t s h e r e m u s t b e s e l e c t e d s o t h a t t h e s e m e s s a g e s are

e x c lu d e d .

”

0 X D O client 800

5

GiJ IDocs in ouffiound processing ^

iS IDoc read y fa r dispatch (ALE serwee) ^

^

5 2 2

S .S .& .S

§3 MATMAS l> C D 0 1 (0 0 6 )

6 .6

30

CLFMAS r> H J 0 K O O 6 )

F ig u re

5

3 S.

3

C re atin g ID ocs B u t N o t D is p a tc h in g T h e m Yet

D is p a tc h in g

You c a n n o w s ta r t t h e r e p o r t R B D S E R 0 2 o r T r a n s a c tio n B D 41 to d is p a tc h

th e g roup

t h e ID o c s. You ca n u s e t h e flag A lw a y s S e n d C o n tro l M e s s a g e to d e t e r m i n e w h e t h e r o r n o t t o s e n d t h e c o n t r o l m e s s a g e d i r e c t ly (s e e F ig u r e 6.7).

D is p a tc h o f ID o c s o f S e ria liz a tio n G ro u p <&B S e n a iiz a tio n G roup

ZSm

L o g ic a l recew er sys tem

10

D a te o f la s t change

9 2 /1 2 /2 0 0 9

to

T im e o f la s t change

0 0 :0 0 :00]

to

0

C h e c k ID o c disp atch status W a itin g tim e un til check

0 0 0 5 00

Alw ays s e n d control m e s s a g e

□

F ig u re 6 .7

19 6

D is p a tc h in g ID o c s

« l

0 2 / 1 2 / 2 0 O S *g ) J 2 3 5 9 5 9

3

S e ria liz a tio n U sin g G ro u p s

W h e n t h e s e I D o c s a r r i v e in t h e t a r g e t s y s t e m , t h e i r s t a t u s is 6 4 : IDoc

In b o u n d

re a d y to b e tra n sfe rred to a p p lica tio n . O u r e x a m p l e s h o w s a l a r g e n u m b e r

p r o c e s s i n g in

o f u n p r o c e s s e d ID o c s b e c a u s e w e s e l e c t e d a l o n g p e r i o d o f t i m e in w h i c h t h e s y s t e m w o u l d c o lle c t c h a n g e p o i n t e r s (s e e F ig u re 6 .8 ).

•

O

P r o d u c t iv e s y s t e m

^

[ 2 lOoc in inboun d processing ^

&

t> I

F ig u re

6 .8

(c lie n t 8 1 1 )

5 5

ID oc read y to b e transferred to application

64

5

CLFM A S

2

§3 MATMAS

3

U n p ro c e s s e d ID o c s in T arg e t S ystem

To p o s t t h e ID o c s in a u s e f u l m a n n e r , y o u c a n s t a r t p r o c e s s i n g w h e n th e last ID o c in t h i s g r o u p a n d c h a n g e p o i n t e r e v a l u a t i o n h a s a r r i v e d . You, as th e s e n d e r, can u se th e re p o rt R B D S E R 0 3 o r T ran sactio n B D 42 to in stru ct t h e r e c e i v e r t h a t p o s t i n g c a n n o w c o m m e n c e . T h is i n f o r m a t i o n , w h i c h h a s its o w n m e s s a g e t y p e S E R D A T , is t h e n t r a n s f e r r e d to t h e s e n d e r i f y o u h a v e n ’t a l r e a d y u s e d t h e r e p o r t R B D S E R 0 2 t o g e n e r a t e a c o n t r o l m e s s a g e . T h e s e r i a l i z a t i o n i n f o r m a t i o n is t r a n s f e r r e d w i t h i n t h e S E R D A T ID o c. You g e t a l i n e i t e m s e g m e n t f o r e a c h m e s s a g e t y p e in t h e s e r i a l i z a t i o n g r o u p (s e e F ig u r e 6.9 ).

E C ID D

D a ta Records

SE G N U M

S e g m e n t N u m b er

000 001

SEGNAM

Segm ent Nam e

E1TB D 40

SERGROUP

Senalization group fo r sen al

ZSM1

SEQNUMBER

Application ID se q u e n c e nu m b e r

0001

M ESTVP

M e s s a g e Type

MATMAS

SE G N U M

S e g m e n t N u m b er

000002

S E G N -M

Segm ent Nam e

E1TB D 40

SERGROUP

Senalization group fo r senal

ZSM1

SEQNUMBER

Application ID se q u e n c e nu m b e r

000 2

M ESTYP

M e s s a g e Type

CLFMAS

F ig u re

6 .9

S E R D A T I D o c , W h i c h S t a r t s P o s t in g

You c a n a ls o s t a r t p o s t i n g w i t h o u t s e n d i n g a S E R D A T ID o c. To d o th is , u s e t h e r e p o r t R B D S E R 0 4 o r T r a n s a c t i o n B D 4 3 in t h e r e c e i v i n g s y s t e m .

197

|

p a rtn e r syste m

6.1

6

|

S e ria liz in g I D o cs

6.2

S e ria liz a tio n U sin g T im e sta m p s

S e r i a l i z a t i o n u s i n g t i m e s t a m p s , a l s o k n o w n a s " s e r i a l i z a t i o n a t ID o c level," e n s u r e s t h a t i f t w o ID o c s q u e u e - j u m p a n d c o n t a i n d i f f e r e n t d a ta f o r t h e s a m e o b j e c t , t h e o l d e r ID o c t h a t q u e u e - j u m p e d c a n n o l o n g e r be p o sted . S e ria liz a tio n w it h

F o r t h i s p u r p o s e , t h e la s t t i m e s t a m p p o s t e d is e n t e r e d f o r e a c h o b j e c t

ta b le “ BDSER"

in t h e t a b l e B D S E R . A n ID o c f o r t h e s a m e o b j e c t c h e c k s its t i m e s t a m p f r o m t h e SERIAL c o n t r o l r e c o r d field a g a i n s t t h e t i m e s t a m p in t h e a b o v e m e n t i o n e d t a b l e BDSER, a n d i t ’s o n l y p o s t e d i f its t i m e s t a m p is later. O t h e r w i s e , t h e ID o c o b t a i n s s t a t u s 5 1 , a n d it c a n b e fla g g e d f o r d e l e t i o n . T h is o n l y c o n c e r n s s e r i a l i z a t i o n in t h e r e c e i v i n g s y s t e m . ID o c s c r e a t e d u s i n g t h e g e n e r a t e d BAPI i n t e r f a c e d o n ’t s u p p o r t t h i s f u n c t i o n b e c a u s e th e g e n e ra tio n p ro g ra m d o e s n 't im p le m e n t th e c o r re s p o n d in g fu n c tio n m odules.

C u s to m iz in g fo r

I n T r a n s a c t i o n B D 9 5 , y o u a s s i g n ID o c fie ld s t o c e r t a i n fie ld s in t h e d a t a ­

tim e s ta m p

b a s e ( s e e F ig u r e 4 . 9 i n C h a p t e r 4 , S e c t i o n 4 . 1 . 3 , F i l t e r i n g S e g m e n t s ) .

s e ria liz a tio n

T h e s e f ie ld s a r e a l s o t h e b a s i s f o r d e t e r m i n i n g o b j e c t a s s i g n m e n t f o r t i m e s t a m p s e r ia li z a t io n . T ra n sa c tio n B D 57, s h o w n in F ig u re 6 .1 0 , c o n ta in s th e m e s s a g e ty p es d e l i v e r e d b y SAP, w h i c h s u p p o r t s e r i a l i z a t i o n u s i n g t i m e s t a m p s . T h is t r a n s a c t i o n a l s o s h o w s w h i c h fie ld is i m p o r t a n t f o r t h e s e q u e n c e . O n e e x a m p l e o f s u c h a fie ld is t h e d o c u m e n t n u m b e r E B E l . N in t h e m e s s a g e ty p e ORDCHG.

T i m e s t a m p in ta b le “ BDSER"

T a b le B D S E R (s e e F ig u r e 6 . 1 1 ) c o n t a i n s t h e a s s o c i a t e d e n t r i e s w i t h t h e ID o c s t h a t w e r e p o s t e d f o r a n o b j e c t a s w e ll a s t h e t i m e s t a m p i n d i c a t ­ i n g w h e n p o s t i n g t o o k p la c e . T h e SERIAL fie ld h e r e c o n t a i n s t h e t i m e ­ s t a m p f r o m t h e SERIAL field in t h e c o n t r o l r e c o r d f o r t h e last s u c c e s s fu lly p o s t e d ID o c . ID o c s t h a t a r c b a s e d o n t h e s a m e o b j e c t b u t h a v e a n e a r l i e r tim e s ta m p m u s t n o t b e po sted .

19 8

S e ria liz a tio n U sin g T im e sta m p s

C h a n g e V ie w " L in k T y p e a n d S e ria liz a tio n T y p e o f M e s s a g e T y p e " : l ^ l l New E ntries I ^ I B H ^ E I I B I I B I L in k Type a n d S e ria liz a tio n Type o f M e s s a g e Type M e s s a g e T yp e

[S e ria liza tio n o b je c t type

S b je c tty p e lin k

lAtriA'S

ATNR

-|

MATMAS_VHS

ATNR

t

MK_MYSTD

ATNR

MY MATHAS

ATNR

OILDEB

UNNR

OILORD

8ELN

0 1 LOTS

BELN

ORDCHG

: b eln

BELN BELN

ORDERS ORDRSP

BELN

PFS_HATHAS01

ATNR

PICKSD

BELN RCTR

PRCMAS QSMT

CMTB

F i g u r e 6 .1 0

ID o c s T h a t S u p p o r t T im e s ta m p S eria liza tio n

HANDT SNDPRT SNDPRN 800 800 - ■8 0 0

)

KU KU KU

F i g u r e 6.11

0000030099 0000030099 AG 0000030099 A 6

R fV P R T RCVPRN

LI LI LI

RCVPFC

0 0 0 0 0 10 0 9 9 LF 0 0 0 0 0 10 0 9 9 LF 0 0 0 0 0 10 0 9 9 LF

0B JVA IU E

EBELN EBELN EBELN

4 5 0 0 0 00 2 3 5 4 5 0 0 0 00 2 3 6 4 5 0 0 0 00 2 3 8

T a b l e ‘'B D S E R ”

You c a n u s e t h e r e p o r t R B D S R C L R to r e m o v e o b s o l e t e t i m e s t a m p s f r o m t h e T a b le BDSER.

Function Modules for Serialization SAP d e l i v e r s t w o f u n c t i o n m o d u l e s f o r t i m e s t a m p s e r i a l i z a t i o n : I D 0 C _ S E R I A L I Z A T I O N _ C H E C K fo r c h e ck in g tim e s ta m p s a n d I D O C _ S E R I A L _ P O S T

f o r u p d a t i n g t h e s e r ia li z a t io n ta b le a f t e r a n e w I D o c h a s b e e n s u c c e s s fu lly p o s t e d . I f y o u w a n t to u s e t h i s m e t h o d t o s e r i a l i z e ID o c s , g o to T r a n s a c ­ ti o n B D 5 7 , m a i n t a i n t h e field t o b e u s e d , a n d t h e n u s e t h e e n h a n c e m e n t tech n o lo g y to im p le m e n t th e tw o fu n c tio n m o d u le s in th e in b o u n d fu n c­ tio n m o d u le.

19 9

|

6 .2

6

|

S e ria liz in g ID o c s

6.3

S e ria liz a tio n U sin g B u s in e s s O b je c ts

F or seria liz atio n u s in g b u s in e s s o b je c ts, o n e c o m m o n c h a n n e l n u m b e r is a s s i g n e d t o all ID o c s f o r t h e s a m e o b j e c t t y p e . A ch a n n e l n u m b e r is a m essage a ttrib u te g e n e ra te d using th e fu n c tio n m o d u le

ALE_SERI AL_KEY -

2 C H A N N E L o r a s s i g n e d in t h e a p p l i c a t i o n p r o g r a m . O b je c t channel

T h is t y p e o f s e r i a l i z a t i o n is s o m e t i m e s a ls o k n o w n a s o b ject ch a n n e l serial­

s e ria liz a tio n

iza tio n . H e r e , s e r i a l i z a t i o n o c c u r s a t t h e o b j e c t t y p e le v e l (e .g ., b a s e d o n all B O M ID ocs). T h e b u s i n e s s o b j e c t t y p e f o r t h i s p u r p o s e is I DOCBOMMAT. B e c a u s e SA P d o e s n ' t d e l i v e r a n y o b j e c t c h a n n e l s e r i a l i z a t i o n f o r m a t e ­ rial m a s t e r s , w e ’ll u s e B O M s in o u r e x a m p l e h e r e . F i g u r e 6 . 1 2 s h o w s T r a n s a c t i o n B D 1 0 5 , w h i c h c o n t a i n s all o b j e c t s f o r w h i c h S A P d e l i v e r s s e r i a l i z a t i o n u s i n g b u s i n e s s o b j e c t s . You c a n m a i n t a i n t h i s t a b l e y o u r s e l f , b u t y o u m u s t u s e e x its t o b u i l d t h e a s s o c i a t e d i m p l e m e n t a t i o n i n t o t h e pro cessin g ro u tin es.

C h a n g e V ie w " A L E :O b je c t C h a n n e l S e r ia liz : S u p p o r t e d B u s in e s s O b je c t N e w E n trie s

CQ

EAlz& © © D

A L E O b ie c t C h a n n e l S e ria liz S u p p o rte d B u s in e s s O b ie d Types —

O biectType

(D e s c rip t

BUS2012

P u rc h a s e O rde r

BUS2013

P u rc h .s c h e d u lm g a g re e m e n t

BUS2015

in b o u n d delrvery

BUS2022

C le a rin g C a s e

BUS2032

S a le s O rde r

*

BUS2035

C u s to m e r s c h e d u lin g a g re e m e n t

BUS2054

W o r k b re a k d o w n structure

BUS2102

R e tu rn s

L

BUS6050

D e liv e ry P ro c e s s in g

r

ECH

E n g in e e rin g C h a n g e M a n a g e m e n t: C h a n g e m a s te r

ID0CB0H00C IDOCBOHHAJ ID O C fo r m a te ria l BOMs

Figure 6.12

O b je c ts C o n n e c te d t o O b je c t C h a n n e l S eria liza tio n

A s s ig n m e n t to

A m e s s a g e t y p e t h a t c a n b e s e r i a l i z e d is t h e n a s s i g n e d t o e a c h o f th e s e

m essage typ e

o b j e c t s . You u s e T r a n s a c t i o n B D 1 0 4 to a c c e s s t h i s a s s i g n m e n t . F o r o u r s a m p l e B O M , t h e m e s s a g e t y p e is

200

BO M M AT,

a s s h o w n in F ig u r e 6 .1 3 .

S e ria liz a tio n U sin g B u sin ess O b je c ts

C h a n g e V ie w "A L E : O b je c t C h a n n e l S e ria liz a tio n : £

N e w E n ln e s

-

&

^

S

3

0

ALE: O b ie c l C h a n n e l S e nalizatio n: M e s s a g e Typ e o f B u s . O b) Typ e

(M e s s a g e Typ e

B U S216 2

o|

tCUST0f1ERRETURN_C0NFIRnDELIVERY

"1 *

BUS6050

OELIVERYPROCESSIN 6 EXECUTE

*

ECU

ECHHAS

IDOCBOMDOC 80MD0C id o c b o h m a t b o h h a t

IOOCBOHORD 80M0RD IDOCDSPMAS OSPHAS IDOCPALHAT PALHAT io o c s t t m a t s t t h a t

L IK P

SDPACK

L IK P

SO PICK

L IK P

SHP_OBDLV_CONFIRH_DECENTRAL

L IK P

SHP_OBDLV_SPLIT_DECENTRAL

F ig u re

6.13

O b je c ts a n d T h e ir ID ocs

T h e f u n c t i o n s f o r a c ti v a ti n g o b j e c t c h a n n e l s e r i a l i z a t i o n a r e o n l y a v a il­

A c tiv a tin g

a b le in ALE C u s t o m i z i n g . S u r p r is in g ly , t h e y a r e l o c a t e d u n d e r t h e M a s ­

s e ria liz a tio n

t e r D a t a D i s t r i b u t i o n m e n u o p t i o n e v e n t h o u g h s e r i a l i z a t i o n is w h o l l y in d e p e n d e n t o f th e ty p e o f d ata used a n d has n o th in g to d o w ith th e S h a r e d M a s t e r D a ta t o o l (S M D ). F ig u r e 6 . 1 4 s h o w s a n e x t r a c t f r o m ALE C u s to m i z i n g .

Stiucture ID o c .In te rfa c e /A p p lic a tio n .L in k E n a b lin g (A L E ) t>

B a s ic Settin gs

1

C o m m u n ic a tio n M o d ellin g a n d Im p le m e n tin g B u s in e s s P ro c e s s e s !

G lo b a l O rg an iza tio n al Units

1^

\ X G > M a in ta in D istribu tion M o d el a n d D istrib u te V ie w s 1

C o n fig u re P re d e fin e d A L E B u s in e s s P ro c e s s e s a 1' [ J »

M a s te r D a ta Distribution R e p lic a tio n o f M o d ified D a ta

J f v

S erializatio n fo r S e n d in g a n d R e c e iv in g D a ta Q r

S erializatio n U s in g M e s s a g e Types [_£

D e fin e S erializatio n G ro u p s

[£

M ain tain D istn b u tio n M odel D e fin e In b o u n d P ro c e s s in g

l> B ^

L£

S erializatio n U s in g B u s in e s s O bjects B

F ig u re 6 .14

S e ria liz e d D istribu tion U s in g M e s s a g e Types

( £ » A c tu a te O u tb o u n d B u s in e s s O b lec ts

B

Actw ate Inboun d B u s in e s s O b jec ts

Q

C h e c k C o n s is te n c y S y ste m -W id e

Path to S e ria liz a tio n S ettin g s in A L E C u sto m iz in g

201

|

6 .3

6

|

S e ria liz in g ID o c s

To a c t i v a t e s e r ia li z a t io n , t h e s e r i a l i z a t i o n (lag SFLAG is s e t in t h e s e n d i n g s y s t e m f o r t h e r e c e i v e r (h e re : SALES) a n d t h e b u s i n e s s o b j e c t IDOCBOM MAT, as s h o w n in F ig u re 6 . 1 5 .

C h a n g e V ie w "A L E : O b je c t ty p e s e ria liz a tio n : O u tb o u n d c o n tro l' N e w E n trie s

f ; (jJ . c f

A L E : O b jec t type serializatio n

Recewpartn ?ec ’an S A IF S

©

0

O u tb o u n d control

O b) Type

Ser

DOCBOHHAT

LS

flag 0

H EJ 0

F ig u r e 6 .1 5

S e ttin g s in S e n d in g S ystem

T h e s e t t i n g s m u s t b e c o n f i g u r e d in t h e s a m e w a y in t h e r e c e i v i n g s y s t e m . I n o u r e x a m p l e , t h e s e n d e r is T90CINT090 (s e e F ig u re 6 .1 6 ) .

C h a n g e V ie w "A L E : O b je c t ty p e s e ria liz a tio n : In b o u n d c o n tr o l" : N e w E n tr .e s

A L E : O b je c t type s e r ia liz a tio n : In b o u n d control S e n d p a n no

Pan v

T90 C L N T 0 9 0

LS

Part

O b ) Type

Ser l a g

IDOCBONMAT

0

[M E F I

F ig u r e 6 .1 6

S e ttin g s in R e c e iv in g S ystem

Checking the

A f t e r y o u ' v e f i n i s h e d c o n f i g u r i n g t h e s e t t i n g s in b o t h s y s t e m s , y o u

settings

c a n p e r f o r m a c o n s i s t e n c y c h e c k in T r a n s a c t i o n B D 1 0 1 . H e re , y o u s e e w h e t h e r s e r i a l i z a t i o n u s i n g o b j e c t t y p e s is a c t i v a t e d . T h e s t a t u s traffic lig h ts in t h e Local S ta t u s a n d P a r t n e r S ta t u s fie ld s a ls o i n d i c a t e w h e t h e r C u s t o m i z i n g is o k a y a n d c o n s i s t e n t . T h e tra ffic l i g h t in t h e D i f f e r e n c e fie ld t h e n s h o w s w h e t h e r s o m e ID o c s q u e u e - j u m p e d . T h i s is t h e c a s e in o u r e x a m p l e in F ig u r e 6 . 1 7 . I f all o f t h e I D o c s i n b o t h s y s t e m s h a v e b e e n p o s t e d in t h e c o r r e c t s e q u e n c e , t h e v a l u e s in t h e C o u n t e r field s h o u l d a ls o c o r r e s p o n d h e r e . You c a n u s e T r a n s a c t i o n B D 1 0 0 to s p e c if ic a l l y v i e w o n l y t h o s e ID ocs th a t w ill b e p ro c e s s e d u s in g o b je c t c h a n n e l s eria liz atio n . F ig u re 6 .1 8 s h o w s t h e t h r e e ID o c s t h a t h a v e a l r e a d y b e e n d i s p a t c h e d in o u r p a r t i c u ­ la r ex a m p le .

202

S e ria liz a tio n U sin g B u sin ess O b je c ts

S e ria liz a tio n U sin g O b je c t T y p e s : C o n s is te n c y C h e c k

&V

Q

7

3

b lO o cs

Outbound and Inbound Serialization in This System

D ire c tio n

' Partner

In b o u n d

SALES

P

O u tb o u n d

F ig u re

6 .17

P

O D ie c t Type

L o c a l S ta tu s

P a r tn e r S ta tu s

LS

IO O C B O M MAT

cco

cco

LS

IOOCBOMMAT

cco

cco

C hannel

D iffe re n c e

Loc C

! P a rtn

M essages

cco 6278

cco

C h e c k F u n c tio n fo r O b je c t C h a n n e l S eria liza tio n

S e ria liz a tio n U sin g O b je c t T y p e s : D isp la y S e ria liz e d ID o cs

a 9

© 3

W&3I2*

ID o c s S e ria liz e d U s in g O b je c t T y p e s : iD o c n u m b e r | O b je c t Type

[C N

jC o u n te r jP

7 6 8 7 8 5 1IO O C B O M M A T

62781

768786 I O O C B O M M A T

6278

2 LS

7 6 8 7 8 7 IO O C B O M M A T

6278

3 LS

F ig u re

6.18

P a rtn no

[F

|P

I P a rtn n o .

R

| D S. ;M e s s a g e Type

1 lS |T 9 0 C L N T 0 9 0 I

|l|o 3 |B O M M A T

SA1.ES

L S T 9 0 C 1 .N T 0 5 0

1 0 3 BOMM.AT

S ALE S

L S tT 9 0C L N T 090

1 03 BOMMAT

1 L S jSALES~

ID o c s w i t h O b j e c t C h a n n e l S eria liza tio n

I n t h e r e c e i v i n g s y s t e m , i n d i v i d u a l p r o c e s s i n g o f s p e c if ic I D o c s e n s u r e s

W a it sta tu s

t h a t o u r s e c o n d I D o c is p o s t e d first. T h e s y s t e m " n o t i c e s " t h a t i t ’s n o t y e t

fo r ID o cs th a t q u e u e -ju m p

its o w n n u m b e r ’s t u r n in t h e r e l e v a n t c h a n n e l , s o i t c h a n g e s its s t a t u s to w a i t i n g s t a t u s 6 6 ( s e e F ig u r e 6 .1 9 ) . I f t h e f ir s t I D o c a r r i v e s a n d is s u c c e s s ­ fu lly p r o c e s s e d , i t c a n b e r e s c h e d u l e d a n d p r o c e s s e d a g a in .

Z

0

S a le s sys tem (client 810 )

9

^

[ £ ID ocs in outbound processing

1

^

| 0 ID oc in inbound processing

I-

□

D a ta p a s s e d to port OK

03

1

I-

0

Application docum ent not posted

51

1

1-

0

iD oc with en o rs added

56

1

^

A

ID oc is w aitin g for p redecessor lOoc (serialization)

66

^

l b BO M KA T ^

1 1

( B 0 1 ( 1 5 9 ) : ID oc m u s t b e pro ce ssed later. S . ID oc no & required

1

G D I D o c m u s t b e p r o c e s s e d la t e r . 0 0 0 0 0 2 . I D o c n o 0 0 0 0 0 3 r e q u ir e d

F ig u re

6.19

1

W a i t S tatus fo r ID o c T h a t Q u e u e - J u m p e d

O n c e a g a in , t h e SERIAL field in t h e ID o c c o n t r o l r e c o r d d e t e r m i n e s th e

" S e r i a l " f i e l d in

s e q u e n c e h e r e . H o w e v e r , t h i s field d o e s n ’t c o n t a i n a t i m e s t a m p , w h i c h

c o n t r o l record

is u s u a l l y t h e c a s e , b u t r a t h e r a c o m b i n a t i o n o f t h e o b j e c t n a m e , o b j e c t

203

6 .3

6

|

S e ria liz in g ID o c s

c h a n n e l n u m b e r ( o f t h e c h a n n e l u s e d f o r t h e tr a n s f e r ) , a n d t h e t r a n s f e r n u m b e r . T h i s is t h e v a l u e in t h e C o u n t e r field, w h i c h y o u c a n a ls o s e e in t h e I D o c d i s p l a y s c r e e n in T r a n s a c t i o n B D 1 0 0 . F ig u r e 6 . 2 0 s h o w s t h e c o n t r o l r e c o r d o f t h e s a m p l e ID o c t h a t q u e u e - j u m p e d a n d h a s t h e c o u n ­ t e r ''3." T h e ID o c s w i t h t h e c o u n t e r " I ” a n d " 2 " h a v e n ' t a r r i v e d y e t , so o u r ID o c h a s b e e n a s s i g n e d s t a t u s

66, w h i c h y o u c a n a ls o s e e h e r e .

D isplay C o n trol Record lOoc Oisplay Doc number

70014

Direction

2

Status

66

T v n in fn

4*

Inbound

02 0

ID oc is waiting for predecessor IDoc (serialization)

P a rtn e r

A rtro e sin Jn

O M aU t

info about I D o c / 700

SAP R e lea se Output Mode

[D 0C B 0H IU T6278000003

Serialization

Tim e of c r e a t i o n / Date

18 0 8 2008

Tim e

15 11 22

Last database update / 18 0 8 200 8

Date

[1 5 :1 1 :2 2

Tim e

F ig u re

Data channel registry

6 .20

C o n t r o l R e c o r d f o r a S e r ia liz e d I D o c

To g e t a n o v e r v i e w o f t h e s t a t u s e s o f t h e s e r ia li z e d ID o c s , y o u c a n v i e w t ji e

^ £ 4 ch a n n e l reg istry ( i n o u t b o u n d p r o c e s s i n g , y o u d o t h i s in T r a n s ­

a c t i o n B D 10 2 ). T h e r e s u l t is d i s p l a y e d in F ig u r e

6 . 2 1 . T h r e e ID o c s h a v e

a lre a d y b e e n sen t.

C hange V iew "A L E : O u tb o u n d C h a nn e l R e g is try ": O vervie w y

N e w E n tn e s

l . O

l S

B

U

H

A L E O utbound C h annel Registry ObiectType ID0C60HHAT

F ig u re 6 .2 1

204

(C h a n

|P art ty

R e c e iv p a rtn

LS

SALES

R e c p a rt

Date

T im e

IcounteH

0 8 /1 8 /2 0 0 8

H 5:11:22

|3

V ie w o f R eg istry in S e n d in g System

S e ria liz a tio n U sin g q R F C

|

6 .4

You c a n u s e T r a n s a c t i o n B D 1 0 3 to v i e w t h e s a m e p r o c e s s in t h e re c e iv in g s y s t e m a n d s e e t h a t , s o far, j u s t o n e ID o c h a s a r r i v e d (s e e F ig u r e 6 .2 2 ) . I t 's e x a c t l y t h i s s i t u a t i o n t h a t p r o d u c e s t h i s s t a n d b y p o s i t i o n in ID o c p r o c e s s i n g , in o t h e r w o r d s , d i f f e r e n t v a l u e s i n t h e C o u n t e r field in th e receiv ing a n d s e n d in g sy stem s.

C hange V ie w "A L E : In b o u n d C h a nn e l R e g is try ": O vervie w

HIMM

f f i l N e w Entries ALE: inbound C h a n n e l Registry 0 b ,e d T y p e

jC han n

ID0CB0HHAI [6278

F ig u re

6 .4

6.22

Part ty

S e n d part no. S e n d P a

LS

T90CLNTO9O

(D ate 1 8 .0 8 200 8

T im e

Counter]

1 4 :5 0 :4 6

1

V i e w o f R e g i s t r y i n R e c e i v i n g S y s te m

S e ria liz a tio n U sin g q R F C

S e r i a l i z a ti o n u s i n g q R F C (Q u e u ed RFC), in w h i c h t h e s e q u e n c e o f t h e ID o c s is a ls o r e t a i n e d , h a s o n l y b e e n a v a i l a b l e s i n c e SA P N e t W e a v e r 6 . 4 0 . I n s t e a d o f t h e f u n c t i o n m o d u l e ID0C_INB0UND_ASYNCHR0N0US, th e f u n c t i o n m o d u l e ID0C_INB0UND_IN_QUEUE is c a ll e d in t h e t a r g e t s y s t e m . T h i s t y p e o f s e r i a l i z a t i o n is p o s s i b l e f o r all ID o c s . I n SAP N e t W e a v e r PI, it c a n a ls o b e u s e d to i m p l e m e n t t h e Q u a lity o f Service E O I O (E q u a lly O nce In O rder) in t h e ID o c a d a p te r . You c o n f i g u r e s e r i a l i z a t i o n u s i n g qR FC in t h e o u t b o u n d p a r t n e r p ro file

S e ria liz a tio n u s in g

b y s e t t i n g t h e Q u e u e P r o c e s s i n g flag o n t h e O u t b o u n d O p t i o n s t a b p a g e

qRFC

( s e e F ig u r e 6 .2 3 ) . T h is o p e n s a n e w fie ld i n w h i c h y o u s p e c if y h o w y o u w a n t t h e q u e u e n a m e to b e c r e a t e d u s i n g r u le s t h a t r e f e r e n c e a f u n c ti o n m o d u l e . F ig u r e 6 . 2 3 s h o w s t h r e e o f t h e r u l e s d e l i v e r e d b y SA P ( b o t t o m rig h t). T h e r u l e I DOC_QUEUE_SUS_MM r e q u i r e s t h e u s e o f a n ID o c o f t h e t y p e ORDERS o r ORDRSP. T h e f u n c t i o n m o d u l e s f o r c r e a t i n g q u e u e n a m e s c a n b e a s s i g n e d a ru le

R u le s f o r q u e u e

n a m e i n T r a n s a c t i o n W E 8 5 . F ig u r e 6 . 2 4 s h o w s t h i s a s s i g n m e n t f o r t h e

names

t h r e e r u le s s h o w n in F ig u r e 6 . 2 3 : CONSTANT:EDIQUEUE, FIRST_16_0F_MESTYP, a n d IDOC_QUEUE_SUS_MM.

205

6

|

S e ria liz in g ID o c s

P artn e r p ro file s: O utbound param eters Wi SALES

Partner NO.___________

S a le s system (d ie m 810 )

_[18]

PartnType

Logical system

Partner Role

g

M essag e Type

"A T M S

M atenal master

M essage code M essage fijnction

□ Test

M essag e Control

Receiver port

0

Transacftonai RFC

r

P a ck Size

P o stprocessing Perm itted Agent

R u le N a m e

Queue Processing Output Mode

Tele

LS Sales

F .L « & U .6 J !0 L S IV P ■ O r R ule N a m e ( 4 )

3 Entries found

® Transfer IDoc Im m ed. C Collect IDocs

nnO C 3EIEEEl|lH

IDoc Type /

Rule

HATHAS03

Basic tfpe

[CO NSTAN T EDIO UEUE

Extension

FIRST_16_O F_M ESTVP

vie w

IOO C_O UEUE_SUS_M M 0

C a n c e l P r o c e s s i n g A fte r S y n ta x E rro r

F ig u re

6.23

P a r t n e r P r o f i l e w i t h Q u e u e P r o c e s s in g

Change V iew "ID oc: Rules fo r C reating Queue Names fo r qRFC IDoc": N e w Entries J l Q Q r fy H jl

Q

IDoc Ru les for Creating Q u eu e N a m e s for qRFC lOoc _ R ule N am e_________________________ [Function Module______________________ ( 3 ]lDOC_QUEUE_CONST_EDI QUEUE

B |

: IRST_16_0F_HESTYP

M

T f t lM

!00C_0UEUE_NAHE_HESTYP

B

I DOC_QUEUE_SUS_HH

!00C_QUEUE_SUSJ1H

F ig u re

6 .2 4

g E j

G e n e ra tin g Q u e u e N a m es

I f y o u 'r e w o rk in g w ith y o u r o w n fu n c tio n m o d u le s, th e se re q u ire a su it­ a b le m o d u l e s i g n a t u r e (s e e F ig u re 6 .2 5 ) . Q ue ue m o n ito r

F ig u re 6 . 2 6 s h o w s o u r e x a m p l e (a t t h e v e r y b o t t o m ) : T h e q u e u e h a s b e e n g i v e n a fix e d n a m e (SAP_ALE_ED I QUEUE), t h e RFC d e s t i n a t i o n a d d r e s s e d b y t h i s q u e u e is c a lle d SALES, a n d t h e t r a n s a c t i o n t h a t y o u c a n u s e to m o n i t o r t h e o u t b o u n d q u e u e is c a lle d W E O U T Q U E U E .

206

S e ria liz a tio n U sin g q R F C

FU NC TIO N

6 .4

IDQC_QUEUE_NAHE_HESTYP

• • lo k a le S c h n it t s t e lle : IMPORTING REFERENCE(CONTROL) L IK E E D ID C STRUCTURE EXPORTING VALUE(NAM E) TYPE C H A R I6 TABLES DATA STRUCTURE ED ID 4

F ig u re

|

6 .25

EOIOC

S ig n a tu re o f a F u n c tio n M o d u l e f o r C re a tin g Q u e u e s

qRFC M o n ito r (O u tb o u n d Q ueue) N u m b e r o f L U W Entries

Q u eu e

In fo ra a tio n e n 441

N u n b e r o f E n t r i e s D is p la y e d N u n b e r o f Q ueues D is p la y e d

10

1

=

■

800

FB 4C LN T800

am

DTZ_800

8 0 0 R3AD L E D E L IV 8UU R3AD H A T E R IA Z S M 0 0 8 0 0 R3AD HATERIAZSM 101

D TZ_800 t3 6 td c 0 0

T 3 6 50

1

t3 6 td c 0 0

T 3 6 50

1

800

t3 6 td c 0 0 _ T 3 6 _ 5 0

R3AD

MATER1AZSN102

496 1

794

1

8 0 0 R3A D .SA LES D 01001

D TZ_800

24

8 0 0 R 3AD_SALESD 01002

D TZ_800

24

8 0 0 R 3AD_SALESD 01033

D TZ_800

48

8 0 0 R3AD SA LESD01174

D TZ 800 D TZ 800

48 24

8UU R3AD SA LESD01460

DTZ_800 D TZ 800

8 0 0 SAP_ALE_EDIQUEUE

SALES

8 0 0 R3AD SA LES D 01175 8 0 0 R3AD_SALESD 01300

F ig u re

6 .26

48 24 3

O u t b o u n d SALES Q u e u e

So, i f y o u h a v e c r e a t e d t h e q u e u e , a n d , f o r e x a m p l e , a n ID o c in t h e

S to p p e d q u e u e in

re ceiv in g s y s te m n o w e n c o u n te r s a n e rro r, s u b s e q u e n t ID ocs ca n no

sta tu s m o n ito r

l o n g e r b e p o s t e d a n d e a c h o b t a i n s t a t u s 7 5 : ID oc is in in b o u n d q u e u e (see F ig u r e 6 .2 7 ).

^

11

[ 2 'D oc in inboun d processing !■

O A p plicatio n d o c u m e n t not posted

51

2

1'

O

56

1

I1

£ > ID oc is w a itin g (or p re d e c e s s o r lOoc (serialization)

66

1

I1

□

A p plicatio n d o c u m e n t posted

53

6

A

ID o c is in in b o u n d queue

75

1

^

ID oc w ith errors added

^

F ig u re 6 .2 7

MATMAS

1

CD E A (0 7 5 ) : ID oc received via q R F C

1

ID o c s in Target System

207

6

|

S e ria liz in g ID o c s

T h e e r r o r s c e n a r i o is a ls o s h o w n in t h e i n b o u n d q u e u e , w h i c h is m o n i ­ t o r e d u s i n g T r a n s a c t i o n W E I N B Q U E U E (s e e F ig u re 6 .2 8 ) .

ID o c In b o u n d Q ue u e

in b o u n d ID o c Q u e u e D is p la y

•7 U

(D esc rip tio n

ID o c In b o u n d Q u e u e

^

CD T90C LN T090

Sender

^

Q u eu e

□

SA P_A LE_M A TM A S

v f e e0 0.0 0 0 0 0 0 0 0 0 7 0 0 1 8 1 MATMAS

ID o c N o . IM e s s a g e Type

S ta tu s 51 M e s s a g e s h a v e b e e n is s u e d

F ig u re

C u rre n t S ta tu s w ith C u rre n t M e s s a g e

f a 0 0 0 0 0 0 0 0 0 0 0 7 0 0 1 9 1 MATMAS

ID oc N o . IM e s s a g e Type

f a 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 0 1 MATMAS

ID oc N o . IM e s s a g e Type

f a 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 1 | MATMAS

ID oc N o . IM e s s a g e Type

6.28

D is p la y in g ID o c s in a Q u e u e

E r r o r h a n d l i n g in

You c a n p o s t p r o c e s s t h e I D o c h e r e , i d e a l l y in s u c h a w a y t h a t i t c a n be

an in b o u n d queue

p o s t e d su c c e s s fu lly . H o w e v e r , y o u c a n a ls o u s e t h e " tr a s h c a n " ic o n to flag t h e ID o c b l o c k i n g t h e q u e u e f o r d e l e t i o n ( s t a t u s 6 8 ) (s e e F ig u r e 6 .2 9 ).

ID o c In b o u n d Q u e u e : fa B O

a

in b o u n d ID oc Q u e u e D isp lay ~

| D e scrip tion

C H ID oc In b o u n d Q u e u e Sender Q u e u e _______________________________ ID o c N o . IM e s s a g e Type S1atus:51 M e s s a g e s h a v e b e e n is s u e d

C u rre n t S ta tu s w ith C u rre n t M e s s a g e

(Q 0 0 0 0 0 0 0 0 0 0 0 7 0 0 1 9 | MATMAS

ID o c N o . IM e s s a g e Type

f a 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 0 | MATMAS

ID o c N o . IM e s s a g e Type

f a 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 1 I MATMAS

ID o c N o . IM e s s a g e Type

0

D o y o u w a n t to give ID o c '0 0 0 0 0 0 0 0 0 0 0 7 0 0 1 8 ' an e rro r statu s?

Ye s

F ig u re 6 .2 9

208

No

D e le tin g ID o c s from a Q u e u e

JJL

C ancel

S u m m a ry

A f t e r y o u ’v e p r o c e s s e d o r r e m o v e d t h e I D o c t h a t c o n t a i n s e r r o r s (see F ig u r e 6 .3 0 ) , y o u c a n r e s t a r t t h e q u e u e . All o t h e r ID o c s a r e n o w p o s t e d (F ig u re 6 .3 1 ).

ID o c In b o u n d Q ue u e tn

fa O 3

-

In b o u n d ID o c Q u e u e D isp lay ^

U

ID oc In b o u n d Q u e u e

^

(_J T 9 0 C L N T 0 9 0 ^7 U ^

O escnption

Sender

SAP_AJ_E_MATMAS

Q ueue


ID o c N o . IM e s s a g e Type

G

S ta tu s 7 5 ID o c re c e w e d v ia q R F C

C u rre n t S ta tu s w ith C u rre n t M e s s a g e

f e 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 0 | MATMAS

ID o c N o . IM e s s a g e Type

§ 3 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 1 | MATMAS

ID o c N o IM e s s a g e Type

S ’ IN F O R M A T IO N D

ID O C 0 0 6 6 0 0 0 6 0 0 0 7 0 0 1 8 W A S C H A N G E D T O S T A T U S W

0

/

AND

D E L E T E D F R O M IN B O U N D Q U E U E S A P .A L S .M A T M A S

C o n tin u e ^

F ig u re

^

R e s u lt o f D e l e t e O p e r a t i o n

[ £ ] ID o c in in b o u n d pro ce ssin g

11

I 9

A p p licatio n d o c u m e n t no t p o s te d

51

1

P

9

ID o c vwth e rro rs a d d e d

56

1

P

&

ID o c is w a itin g fo r p re d e c e s s o r ID o c (seria lizatio n )

66

1

P

□

A p p licatio n d o c u m e n t posted

53

6

P

□

E r r o r - n o further p ro c e s s in g

68

2

F ig u re

6 .5

6 .30

6 .3 1

R e s u lt A f t e r R e s t a r t i n g a Q u e u e

S u m m a ry

In th i s c h a p te r , y o u ' v e s e e n all p o s s i b il i t i e s f o r s e r ia li z a t io n o f ID o c s, a n d l e a r n e d a b o u t t h e p la c e s t o f i n d w h i c h s e r i a l i z a t i o n t y p e is i m p l e m e n t e d f o r y o u r ID o c . T h e d i f f e r e n t t y p e s o f s e r i a l i z a t i o n m a y l e a d t o a d d i t i o n a l w o r k i f th e y a r e o u t o f sync, s o m a k e s u r e y o u o n ly u s e seria liz atio n w h e r e it is r e a l l y n e e d e d f o r y o u r p r o c e s s .

209

|

6.5

R e s ta rtin g a q u e u e

T his c h a p te r d ea ls w ith a d m in is tr a tiv e issues, specifically, ID ocr e la te d in fo r m a tio n t h a t is w r itte n to th e d a ta b a s e a n d reg u la r b a c k g r o u n d jo b s .

7

Administration

T his c h a p tc r g iv es y o u a n o v e r v ie w o f th e a d m in is tr a tio n o p tio n s fo r ID o c s . O n e o p t i o n d i s c u s s e d in t h i s c h a p t e r is h o w t o l i n k ID o c s t o d i s ­ p l a y o r s e a r c h f o r i n f o r m a t i o n . A n o t h e r is t o i n c r e a s e t h e p e r f o r m a n c e o f y o u r s y s te m b y sc h e d u lin g re g u la r re p o rts th a t y o u w o u ld o th e rw ise h a v e to r u n m a n u a l l y . T h i s c h a p t e r a l s o s u m m a r i z e s I D o c f u n c t i o n a l ­ itie s a n d t h e a s s o c i a t e d t r a n s a c t i o n c o d e s , a n d e x p l a i n s h o w ID o c s a re arch iv ed a n d th e ir statu s co n v erted .

7.1

ID o c Lin ks

T h e r e a r e t w o t y p e s o f lin k s : lin k s b e t w e e n ID o c s a n d t h e a c tu a l b u s i n e s s o b j e c t s w h e n a b u s i n e s s o b j e c t t y p e is a s s i g n e d ; a n d lin k s b e t w e e n th e s e n d e r ' s I D o c a n d t h e r e c i p i e n t 's ID o c . T h e l a t t e r t y p e o f l i n k is k n o w n o n ly to th e recip ien t. I D o c l in k s h a v e t h e i r o w n d a t a b a s e t a b l e c a ll e d IDOCREL ( s e e T a b le 7.1). T h e ta b le c o n t a i n s b o t h d a t a i t e m s t h a t a r e r e l a t e d to e a c h o t h e r ; t h e y a re id en tified b y th e ir in te rn a l n u m b e r. T h e SRRELROLES t a b l e c o n t a i n s t h e o b j e c t s t h a t a r e a s s o c i a t e d w i t h t h e s e

"S R R E LR O LE S "

i n t e r n a l n u m b e r s . T h e r e a r c s e v e r a l d i f f e r e n t l i n k t y p e s in t h i s t a b l e .

ta b le

T a b le 7 . 2 s h o w s t h e e n t r y t y p e s t h a t a r e r e l e v a n t t o ID o c s .

211

7

|

A d m in istra tio n

L in k T ype

ROLE A

ROLE B

ID C O

OUTBELEG

O U T ID O C

ID C 1

IN ID O C

IN B E L E G

ID C 4

IN ID O C

O U T ID O C

ID C 8

IN ID O C

IN T ID

ID C 9

O U T ID O C

IN B E L E G

ID C A

O U T ID O C

O U T ID

ID C B

IN ID O C

OUTBELEG

T a b le

7.1

I D o c - R e l a t e d E n t r ie s i n t h e " I D O C R E L " D a t a b a s e T a b le

A b b r e v i a t i o n in t h e

D e s c rip tio n

R O L E T Y P E F ie ld IN B E L E G

R e c ip ie n t d o c u m e n t

IN ID O C

R e c ip ie n t ID o c

IN T ID

T ra n s a c tio n ID t h a t c a m e w i t h t h e ID o c

OUTBELEG

Sender docum ent

O U T ID

S e n d e r tr a n s a c tio n ID

O U T ID O C

S e n d e rID o c

T a b le

7.2

E n t r ie s i n t h e " S R R E L R O L E S ” T ab le

F o r a n e x a m p l e , le t's l o o k a t a n ID o c a n d a m a t e r ia l m a s t e r in t h i s tab le (see F ig u r e 7 .1 ). T h e O B J K E Y in e a c h c a s e is t h e u n i q u e o b j e c t key, f o r e x a m p l e , t h e m a t e r i a l n u m b e r o r t h e ID o c n u m b e r . F o r d o c u m e n t s , t h e O B J T Y P E is a l w a y s t h e a s s o c i a t e d b u s i n e s s o b j e c t ty p e ; f o r ID ocs, o n t h e o t h e r h a n d , i t's a l w a y s " ID O C " ; a n d f o r t r a n s a c t i o n ID s, i t ’s "TR A N SID ". I f a n I D o c is c r e a t e d f o r t h i s m a t e r i a l , t h e r e w i l l a l s o b e a n e n t r y f o r th is in t h e S R R E L R O L E S t a b l e ( s e e F ig u r e 7 . 2 ) . In b o t h o b j e c t s , t h e u n i q u e n u m b e r t h a t is r e f e r r e d to in t h e T a b le I D O C R E L is i n c l u d e d a t t h e field ROLE ID.

2 12

ID o c L in k s

|

7-1

Table SRRELROLES D isplay C h e c k T a b le

C L IE N T

800

O BJK EY

S H -1 0 0

08JTYPE

BUS10 0 1 0 0 6

LO O S Y S RO LETYPE

0UTBELEG

R O L E ID

tW o l1 lY S N V 6 jm m 0 Q lq s c c 0

U T C T IM E

2 0 . 0 9 0 . 3 0 9 .1 G O 6 5 9

Figure 7.1

E x a m p le o f a M a t e r i a l

Table SRRELROLES D isplay C h e c k T a b le

CUENT

800

O B JK EY

0000000000763765

O BJTVPE

IDOC

LOGSYS RO LETYPE

OUT I DOC

R O L E ID

NVrVtKRvHF 6jm m O Q IqsccO

U T C T IM E

2 0 0 9 0 .3 1 0 .1 0 4 .0 2 6

Figure 7 .2

E x a m p l e o f t h e I D o c t o B e I n c l u d e d i n a L in k

O u r e x a m p l e o b j e c t s , ID o c 763755 a n d m a t e r i a l SH-100, h a v e t h e link t y p e IDCO b e c a u s e w e ' r e o n t h e o u t b o u n d s i d e o f t h e lin k . F ig u r e 7.3 s h o w s t h e r e l e v a n t t a b l e e n t r y in T r a n s a c t i o n S E11.

T a b le ID O C R E L D is p la y C h e c k T a b le .

CUENT

800

RO LE A

IW oMIYSNVSjm m OQ lQSCcO

RO LE S

IW rVtKRvHF6]mm OOlQSCcO

R E L A T IO N ©

IW rV IK R vH VSjm m O Q IqsccO

B RELTYP

IDCO

U T C T IM E

2 0 0 9 0 3 1 0 1 0 4 .0 2 6

F ig u re 7 3

E n try in D atab a se Table "ID O C R E L "

213

O u t b o u n d m a te ria l

7

|

A d m in istra tio n

All o t h e r lin k s a r e m a n a g e d in a s i m i l a r w a y . T h e y c a n b e v i e w e d fr o m w i t h i n ID o c m o n i t o r i n g in T r a n s a c t i o n B D 8 7 o r in t h e i n d i v i d u a l ID o c d i s p l a y b y m e a n s o f t h e o b j e c t s e r v ic e s . Object key

T h e lin k to t h e o b j e c t t y p e c a n a ls o b e u s e d t o d i s p l a y t h e k e y v a l u e s o f t h e I D o c c o n t e n t s . To d o th is, u s e t h e O b j e c t K ey f u n c t i o n in T r a n s a c t i o n B D 8 7 (s e e F ig u r e 7.4).

S tatus M o n ito r fo r A LE M essages |& Display iP o c T l|< a Display relaPonshlpsl | @ Display status long lex! ||© 0D|ec» key |

F ig u re

7.4 Object Key in Transaction BD87

T h e o t h e r lin k s c a n b e d i s p l a y e d f r o m w i t h i n t h e i n d i v i d u a l d is p la y . You c a n a ls o v i e w a r e l a t e d o b j e c t in t h e i n d i v i d u a l d i s p l a y b y s i m p l y d o u b l e ­ c lic k in g it. I f y o u ' v e e d i t e d a n ID oc, y o u ' l l a ls o s e e t h e li n k t o t h e o r i g i n a l ID o c h e r e . T h is o r i g i n a l o b j e c t is r e t a i n e d f o r t h e s a k e o f c o m p l e t e n e s s . F ig u r e 7 . 5 s h o w s t h e r e c i p i e n t s y s t e m ( b e c a u s e t h i s s y s t e m c o n t a i n s a h i g h e r n u m b e r o f links). Deactivate link

A l s o B u s i n e s s o b j e c t s t h a t a r e p a r t o f lin k s c a n b e d i s p l a y e d d i r e c t l y f r o m h e r e . You c a n a c c e s s t h i s f u n c t i o n v i a t h e o b j e c t s e r v ic e s , as b e f o r e (to p a r r o w i n F ig u r e 7 .5 ). To g e t t o t h e a c tu a l lin k s f o r t h e ID oc, u s e t h e ID o c lin k s ic o n ( l o w e r a r r o w in F ig u r e 7 .5 ). I f y o u d o n ' t w a n t t o h a v e all lin k s w r i t t e n t o t h e d a t a b a s e T r a n s a c t i o n W E N O L IN K S is u s e d t o s p e c if y w h i c h lin k s a r c w r i t t e n f o r w h i c h m e s s a g e t y p e . T h e l o w e r p a r t o f F ig ure 7 . 6 s h o w s a d e a c t i v a t e d lin k f o r MATMAS.

2 14

ID o c L in k s

SAP

ID oc display

Technical short info

^ <3 ID oc 0 0 0 0 0 0 0 0 0 0 0 7 0 Q

Control Rec.

l> CDD ata records I1 CDStatus records

Total nu m b e r 0 0 0 0 0 3

Direction

2

C urren t status

53

Basic type

HATHAS03

inbox CCO

Ertension | [ g - IDoc IDoc 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 7 m e s s a g e frp e □ B E l /

'i a | < R3[§Er3|HB0l3fI3[^0[II

M essag e type

MATHAS

Partner No

T90CLNT090

Partn Type

IS

Port

SAPJ00

a.

I E * Service: Relationships ^ O v e r v ie w

BDemiview

C3^IE3|1HEE3®E30|IHE1I^0 to IDoc: 0 0 0 0 0 0 0 0 0 0 0 7 0 0 2 7 m e s s a g e tfp e MATMAS O ocum ent Type

lo r inbound IDoc

Description

Standard m aterial test

Application O b jec tfo r O utbound IDoc Standard m aten al ZSM11 O utbound IDoc

F ig u re

7.5

IDoc

| D a te

*|T im e

J

0 8 /1 9 /2 0 0 9 15 52:36 1 5 5 2 :3 4

0000000000768839

L i n k s i n R e c i p i e n t S y s te m

D e activate W ritin g o f ID o c L in k s (S e le ctively) □ U n k Types ^

a

"[Description

IDoc U n k Types

" CD N on-E xcluded L in k Types CD ID C 0

O utbound Doc. U n k e d w ith O utbound IDoc

OlOC1

Inbound ID oc Lin ked w ith inboun d D o cu m en t

CD IO C 2

inbound ID oc Lin ked w ith C o m m u n ica tio n IDoc

HJCC3

Inbound ID oc U n k e d w ith O nginal D o cu m en t A lter Edit

CD IO C 4 CD ID C 7 CD ID C 9

Inbound ID oc U n k e d w ith O utbound ID oc in S o u rc e System O utbound ID oc U n k e d w ith Original D o c u m e n t Arter Edit O utbound ID oc U n k e d w ith Inboun d Doc. in T a rg e t System

CD Excluded u n k Types CD Excluded for a ii M e s s a g e Types ^ CD Excluded for Specified M e s s a g e Types ^ CD IDCB ®

F ig u re

7.6

MATMA8

inbound ID oc Lin ked w ith O utbound Doc. in S o u rc e System M aterial m aster

D e a c t i v a t i n g L in k s

R e p o r t RSRLDREL is u s e d t o d e l e t e w r i t t e n l i n k s f r o m t h e s y s t e m .

2 15

|

7.1

7

|

A d m in istra tio n

7.2

R e g u la r Jo bs

D u r i n g t h e p r o c c s s o f s e t t i n g u p a n d t e s t i n g ID o c l i n k s , m a n y t h i n g s a r c d o n e m a n u a l l y t h a t a r e p r o c e s s e d b y m e a n s o f r e g u l a r j o b s in t h e p r o d u c t i o n s y s t e m . L ik e w is e , in te s t s y s t e m s , t h e p r o c e s s i n g m o d e f o r s e n d i n g a n d p r o c e s s i n g I D o c s is o f t e n s e t to P ro c c s s I m m e d i a t e l y in t h e p a r t n e r p ro f ile s . F o r p e r f o r m a n c e r e a s o n s , t h i s i s n ' t r e c o m m e n d e d in p r o d u c t i o n s y s t e m s a n d is l i s t e d b y SAP as i n c o r r e c t in g o - l i v e c h e c k s . Im p o r ta n t re p o rts

T a b le 7 .3 lists s o m e i m p o r t a n t r e p o r t s a n d t h e i r f u n c t i o n s . M o s t o f t h e s e r e p o r t s c a n b e r e g u la r l y s c h e d u l e d .

R e p o rt N am e

R e p o rt F u n c tio n

ID X _ D E L E T E _ ID O C T Y P _

D e l e t e I D o c t y p e f r o m S A P N e t W e a v e r PI

W IT H O U T J S

e x c e p tio n s ta b le ( o n l y a v a i l a b l e i n S A P N e t W e a v e r PI)

ID X _ S E L E C T _ ID O C T Y P _

C o p y I D o c t y p e t o S A P N e t W e a v e r PI

W IT H O U T J S

e x c e p tio n s ta b le ( o n l y a v a i l a b l e i n S A P N e t W e a v e r PI)

R B D A G A I2

Post ID o c s a fte r A LE e rro r

R B D A G A IN

S e n d ID o c s a fte r a n A L E e rro r

RBDAPP01

ID o c passed t o a p p lic a tio n

RBDAUD01

A L E a u d it : s ta tis tic a l a n a ly s e s

RBDAUD02

R e o rg a n iz in g t h e a u d it d a ta b a s e

RBDCPCLR

D e le te c h a n g e p o in te rs

R B D M A N IN

R e p o s tin g o f ID o c s (A L E )

R B D M ID O C

C re a te ID o c s f r o m c h a n g e p o in te rs

R B D M O IN D

C o n v e r t I D o c s ta tu s

RBDSER01

C re a te ID o c s o f a s e ria liz a tio n g r o u p fro m c h a n g e p o in te rs

RBDSER02

D is p a tc h ID o c s o f a s e ria liz a tio n g r o u p

RBDSER03

C h e c k th e se n d s ta tu s o f th e ID o c s o f a s e ria liz a tio n g r o u p

T a b le

2 16

7.3

P ro g ra m s f o r R e g u la r S c h e d u lin g

j

Tra n sa ctio n C o d e O v e rv ie w

R e p o rt N a m e

R e p o rt F u n c tio n

RBDSER04

I n b o u n d p ro c e s s in g o f ID o c s o f a s e ria liz a tio n

7 .3

g ro u p RBDSRCLR

D e le te s e ria liz a tio n d a ta

RBDSTATE

A L E a u d it: s e n d in g th e c o n firm a tio n s

RSARFCEX

R e s t a r t ‘’ f r o z e n " t R F C s

RSEOUOO

S e n d ID o c s in s ta tu s 3 0

RSRLDREL

D e le te I D o c lin k s

SAPLBDRC

A LE : d e te r m in e re c o v e ry o b je c ts

T a b le

7.3

7.3

P ro g ra m s f o r R e g u la r S c h e d u lin g (C o n t.)

T r a n s a c t io n C o d e O v e r v ie w

T a b le 7 . 4 c o n t a i n s t h e t r a n s a c t i o n c o d e s f o r all o f t h e f u n c t i o n a l i t i e s u s e d in t h i s b o o k . M e n u i n f o r m a t i o n h a s b e e n d e l i b e r a t e l y o m i t t e d f r o m t h i s list, w h e r e p o s s i b l e , a s t h e SAP m e n u s s o m e t i m e s c h a n g e f r o m o n e r e l e a s e t o t h e n e x t . T h e t e x t a ls o m a k e s d i r e c t r e f e r e n c e to t h e t r a n s a c ­ t io n , w h e r e p o s s i b le . T a b le 7 . 4 c o n t a i n s t h e g e n e r a l t r a n s a c t i o n c o d e s , w h i l e T a b le 7 .5 c o n t a i n s

G eneral tra n s a c tio n

t h e t r a n s a c t i o n c o d e s t h a t , w h i l e r e l a t e d to ID o c s, r e f e r d i r e c t l y t o t h e

codes

o b j e c t s o f a s p e c if ic m o d u l e a n d a r e n ' t f o r g e n e r a l u se. T ra n s a c tio n C o d e

F u n c tio n

BD20

ID o c passed t o a p p lic a tio n

BD21

S e le c t c h a n g e p o in t e r

BD22

D e le te c h a n g e p o in te r

BD23

D e le te s e ria liz a tio n d a ta

BD40

Read ch a n g e p o in te r fo r g ro u p

BD41

D is p a tc h ID o c s f o r g ro u p

BD42

C h e ck ID o c s fo r g ro u p

BD43

P o st ID o c s fo r g ro u p

T a b le 7-4

j

M a in G e n e ra l Tra n sa ctio n C o d e s

217

7

|

A d m in istra tio n

T ransactio n C ode

I F u n c tio n

I

BD44

A s s ig n m e s s a g e t y p e t o s e ria liz a tio n g ro u p

BD47

D e p e n d e n c ie s b e tw e e n m e th o d s

BD48

D e p e n de n cy m e th o d -

BD50

A c tiv a te c h a n g e p a ra m e te rs f o r m essage ty p e

BD51

M a in ta in fu n c tio n m o d u le s (in b o u n d )

BD52

A c tiv a te c h a n g e p o in te r p e r c h a n g e d o c u m e n t ite m

BD53

R e d u c e m essage ty p e s

BD54

M a i n t a in lo g ic a l s y s te m s

BD55

A s s ig n ru le t o m e s s a g e ty p e

BD56

F ilte r ID o c s e g m e n ts

BD57

M a in ta in lin k a n d s e ria liz a tio n ty p e

BD58

C o n v e rt o rg a n iz a tio n a l u n its

BD59

M a in ta in filte r o b je c ts

BD60

M a i n t a i n f u n c t i o n m o d u l e f o r a n a ly s is

BD61

A c t iv a t e c h a n g e p o in te r s g e n e ra lly

BD62

C re a te ru le

BD63

T ra n s p o rt A L E ta b le o f m essa ge ty p e

BD64

M a in ta in d is trib u tio n m o d e l

BD65

D e f in e m a n d a t o r y fie ld s

B D 66

A s s ig n I D o c fie ld t o c h a n g e d o c u m e n t

BD67

M a in ta in m e th o d s (in b o u n d )

B D 68

A s s ig n c la s s e s t o r e c i p i e n t lo g i c a l s y s t e m

BD69

A s s ig n m e n t o f m essage ty p e to ID o c

BD79

A L E I D o c s e g m e n ts : c o n v e r s io n ru le s

BD81

F ilte r o b je c ts : p a ra m e te r filte rin g

BD82

G e n e ra te p a r t n e r p ro file s

BD83

Send ID o c s a fte r a n A L E e rro r

BD84

P o st ID o c s a fte r A L E e rro r

BD85

R u le s f o r c r e a tin g q u e u e n a m e s f o r q R F C ID o c s

T a b le 7 .4

2 18

M a in G e n e ra l Transactio n C o d e s (C o n t.)

m essage

Tra n sa ctio n C o d e O v e rv ie w

T ra n s a c tio n C o d e

I F u n c tio n

I

BD87

S ta tu s m o n it o r

BD95

C h a n g e A L E o b j e c t t y p e , a s s ig n f i l t e r o b je c t s s e g m e n t ( ID o c ) a n d s e ria liz a tio n o b je c ts

BD96

F ilte r o b je c ts : r e c ip ie n t d e t e r m in a t i o n (B A P I)

BD97

D e t e r m i n e R FC d e s t i n a t i o n s f o r m e t h o d c a lls

BD99

M e s s a g e ty p e d e p e n d e n c ie s

BD100

ID o c d is p la y o b je c t c h a n n e l v ie w

BD101

C o n s is te n c y c h e c k

BD102

O u t b o u n d re g is try

BD103

I n b o u n d re g is try

BD104

A s s ig n ID o c s t o b u s in e s s o b je c t

BD105

M a i n t a in s u p p o r t e d b u s in e s s o b je c ts

BDA4

A s s ig n m e s s a g e t y p e t o o b je c t ty p e

BDBG

G e n e r a te A L E in te rfa c e

BDCCC

A L E B a s is C u s t o m i z i n g d a t a : c h e c k c e n t e r

BDCCV

M a in ta in ite m s to b e ch e cke d

BDLSM

C o n v e r t A L E B a s is C u s t o m i z i n g d a t a : c o n v e r s i o n m a trix C o n v e r t lo g ic a l s y s te m n a m e s a f t e r c lie n t is c o p ie d

BDLSS

( n o t in p r o d u c t io n sy s te m s ) BDLST

C o n v e r t A L E B a s is C u s t o m i z i n g d a t a : e x e c u t i o n ( n o t e : sta rts im m e d ia te ly w it h o u t w a rn in g )

BDM2

M o n it o r in g : r e c ip ie n t ID o c s ( ID o c tra c k in g )

BDM5

T e c h n ic a l c o n s is te n c y c h e c k

BDM7

A L E a u d i t : s ta tis t ic a l a n a ly s e s

BDM

8

A L E a u d it: s e n d in g th e c o n firm a tio n s

BDM9

R e o rg a n iz e t h e a u d it d a ta b a s e

BDMO

A L E C C M S g ro u p a d m in is tra tio n

B D M O N IC

M a in ta in A L E C C M S m o n ito r in g o b je c ts (d e fin itio n )

B D M O N IC 2

M a in ta in A L E C C M S m o n ito r in g o b je c ts (g ro u p d e fin itio n )

T a b le 7.4

M a in G e n e ra l Tra n sa ctio n C o d e s (C o n t.)

2 19

7 .3

7

|

A d m in istra tio n

T ransactio n C ode

I F u n c tio n

I

B D M O N IC 3

A L E C C M S m o n it o r b ra n ch

BDR1

D is p la y a p p lic a tio n lo g f o r re c o v e ry

BDR2

R e o rg a n iz e re c o v e ry d a ta

BDRC

A L E : d e te r m in e re c o v e ry o b je c ts

BDRL

A L E : p ro c e s s re c o v e ry o b je c ts

BDTP

B u s in e s s p ro c e s s -

BF01

m a in ta in te m p la te s

L ib r a r y o f " p u b lis h a n d s u b s c r ib e ” b u s in e s s tra n s a c tio n e v e n ts

BF05

L ib r a r y o f p ro c e s s b u s in e s s tr a n s a c tio n e v e n ts

CMOD

P ro je c t m a n a g e m e n t o f SA P e x te n s io n s

F IB F

S A P B u s in e s s F r a m e w o r k : b u s in e s s t r a n s a c t io n e v e n ts

OB72

C re ate g lo b a l c o m p a n y c o d e

OYEA

G lo b a l p a ra m e te rs f o r I D o c in te rfa c e

PFTCCHG

M o d i f y w o r k f l o w ta sk

P F T C .C O P

C o p y w o r k f l o w ta s k

P F T C .D E L

D e le t e w o r k f l o w ta sk

P F T C .D IS

D is p la y w o r k f l o w ta s k

PFTC JNS

C re a te w o r k f l o w ta sk

SALE

A L E C u s to m iz in g

SARA

A rc h iv e a d m in is tra tio n

SARI

A rc h iv e in fo rm a tio n s y s te m : c e n tra l a d m in is tra tio n

SARJ

A r c h iv e re trie v a l c o n fig u r a to r

SE11

A B A P D ic tio n a ry : in itia l screen

SE18

B A d l B u ild e r: d e f in it io n m a in te n a n c e in itia l screen

SE19

B A d l B u ild e r: im p le m e n t a t io n m a in te n a n c e in itia l scree n

SE38

A B A P E d ito r: in itia l screen

SE80

O b je c t N a v ig a to r

SE84

R e p o s ito ry in fo syste m

SMOD

SAP E n h a n ce m e n t M a n a g e m e n t

T a b le 7-4

220

M a in G e n e ra l Transactio n C o d e s (C o n t.)

Tra n sa ctio n C o d e O v e rv ie w

T ransactio n C ode

I F u n c tio n

WE02

Display IDocs

WE05

IDoc lists

WE06

Active IDoc m onitoring

WE07

IDoc statistics

WE08

Status of file interface

WE09

Search for IDoc based on business c o n ten t

WE10

Search for IDoc in d a ta b a s e release 4.6C a n d earlier

j

releases WE11

D elete IDocs (note: use only after obtaining ag reem ent)

WE12

Receipt of m odified o u tb o u n d file

WE14

O u tb o u n d processing from IDoc

WE15

O u tb o u n d processing from MC

WE16

Original in b o u n d file

WE17

Process statu s file

WE18

Create statu s file

WE19

Test tool

WE20

P artner profiles

WE21

Ports for IDoc processing

WE23

Verification of IDoc processing

WE24

Default values for o u t b o u n d param eters

WE27

Default values for in bound param eters

WE30

IDoc types

WE31

IDoc segm ents

WE32

IDoc views

WE34

Objects for display of XML IDocs

WE40

Settings for errors a nd statu s processing

WE41

Process codes, o u tb o u n d

WE42

Process codes, inbound

WE46

Error a nd status processing (like WE40)

T a b le 7.4

M a in G e n e ra l Tra n sa ctio n C o d e s (C o n t.)

221

7 .3

7

|

A d m in istra tio n

T ransactio n C ode WE47

M aintain status values

WE54

Function m o dules for changing file names

WE55

Create file names

WE57

Assign m essage fo r application object

WE58

Status o f process codes: texts

WE59

Status o f process codes: modify

WE60

D o c u m e n ta tio n for IDoc types

WE61

D o c u m e n ta tio n for IDoc record types

WE62

D o c u m e n ta tio n fo r segm ents

WE63

D o c u m e n ta tio n fo r IDoc types (like WE60)

W E64

D o c u m e n ta tio n fo r m essage types

W E70

Conversion: basic types

WE71

Conversion: extensions

WE72

Conversion: IDoc types

WE73

Conversion: logical messages

WE81

Logical m essage types

WE82

A ssignm ent of m essage type to IDoc type

WE84

A ssignm ent of IDoc fields a nd application fields

WEDI

IDoc basis an d EDI basis

WEINBQUEUE

M on itoring program for IDoc in bound q u e u e

WEOUTQUEUE

M onito rin g program for IDoc o u t b o u n d q u eue

WENOLINKS

Switch off links

WELI

M aintain status groups

T a b le

Applicationspecific transaction codes

I F u n c tio n

7.4

Main General Transaction Codes (Cont.)

A p p lic a tio n -S p e c ific T ra n sa ctio n Codes M o s t o f th e s e tra n sa c tio n c o d e s a re fro m SM D a n d a r e n 't m e n tio n e d e x p l i c i t l y in t h i s b o o k , b u t y o u ' l l lik e ly fin d t h i s t a b l e u s e fu l.

222

I

Tra n sa ctio n C o d e O v e rv ie w

T ransactio n C ode

I F u n c tio n

BD10

Send material

BD11

G et material

BD12

Send cu sto m er

BD13

G et custom er

BD14

Send v endor

BD15

G et v e n d o r

BD16

Send cost center

BD17

G et cost center

BD18

Send general ledger a c cou nt

BD19

G et general ledger ac coun t

BD24

Send cost elem ents

BD25

Send activity type

BD26

G et activity type

BD27

Send cost c e n te r activity prices

BD28

Send o b je c t/c o s t c e n te r ty p e control d ata

BD30

Distribute material object list

BD31

Distribute d o c u m e n t object list

BD32

Distribute plant allocations (material BOMs)

BD33

Distribute material variants (ALE)

BD34

Distribute o rder BOM

BD35

Send business process groups

BD36

Send business processes

BD37

Send business process prices

BD85

Consistency check for transfer

BD86

Consistency check for sales

BD91

Send characteristic

BD92

Send class

BD93

Send classification

BDA5

Distribute d o cum ents

T a b le 7.5

|

M a in M o d u le -S p e c ific Transactio n C od es

223

7 .3

7

|

A d m in istra tio n

I

T ra n s a c tio n C o d e

I F u n c tio n

BDD5

A p p l i c a t i o n c o n s i s t e n c y c h e c k (SD )

BDFDF

R equest fu n d

BDFDS

Send fu n d

BDMC

U p lo a d in fo s tru c tu re s

1

Table 7-5 Main Module-Specific Transaction Codes (Cont.)

7.4 GDPdu

A rch iv in g

ID o c s a r e d o c u m e n t s t h a t , u n d e r G e r m a n l a w a t le a st, m a y h a v e to b e a r c h i v e d i n a c c o r d a n c e w i t h t h e G D P d U ( G e r m a n P r i n c i p l e s o n D a ta A c c e s s a n d t h e E x a m i n a t i o n o f D ig ita l D o c u m e n t s ) . T h is leg al i n s t r u m e n t a l w a y s a p p l i e s i n c o m m u n i c a t i o n w i t h p a r t n e r s w h e n t h e ID o c is t h e first e l e c t r o n i c d o c u m e n t t h a t y o u r e c e i v e in a p r o c e s s . I f y o u ' r e r e a d i n g t h e ID o c s f r o m a file t h a t w a s s e n t b y a p a r t n e r , t h i s file, to o , m u s t be a r c h i v e d . L ik e w is e , in c o m p a n i e s t o w h i c h Good M a n u fa c tu r in g Practice (G M P ) a p p l i e s , all c h a n g e s to t h e s t a t u s o f w a r e h o u s e s t o c k h a v e t o be a r c h i v e d . T h u s , y o u c a n s e e t h a t in m o s t ca se s , ID o c s c a n n o t b e s i m p l y d e l e t e d f r o m t h e s y s t e m ; t h e y h a v e t o b e a r c h i v e d u s i n g S A P ’s p r o p r i e ta iy a rc h iv in g sy stem .

Archivabie

O n e ID o c -s p e c if ic r u l e is t h a t y o u h a v e t o s p e c i f y f o r e v e r y p o s s i b l e

status values

| q 0 c s t a t u s v a l u e w h e t h e r ID o c s w i t h t h i s s t a t u s a r e a r c h i v a b i e o r n o t . O f c o u r s e , SAP p r o v i d e s i n a r c h i v a b i e f o r m t h o s e v a l u e s t h a t n o r m a l l y i n d i c a t e t h a t a n ID o c h a s a " s u c c e s s " s t a t u s a n d t h e a s s o c i a t e d d o c u m e n t a l r e a d y e x i s t s (in i n b o u n d p r o c e s s i n g ) , o r t h a t t h e a s s o c i a t e d d o c u m e n t w a s s u c c e s s f u l l y t r a n s f e r r e d t o t h e r e c i p i e n t ( in o u t b o u n d p r o c e s s i n g ) . T h e t r a n s a c t i o n f o r m a i n t a i n i n g s t a t u s v a l u e s is W E 4 7 . F ig u r e 7 . 7 s h o w s t h e s t a t u s m a i n t e n a n c e s c r e e n f o r s t a t u s v a l u e 72, w h i c h i n d i c a t e s t h a t a n I D o c w a s s e n t s u c c e s s f u l l y v i a RFC in o u t b o u n d p r o c e s s i n g .

224

A rc h iv in g

|

7 .4

D is p la y V ie w "S ta tu s m a in te n a n c e ": D e ta ils

?»ass ID o c s ta tu s

12

D e scrip tion

D is p a tc h O K

P ro c e s s in g

7

D irectio n

1

P ro c g level

S

E x te rn a l sy s te rW E D l s u b s y s te m

O u tb o u n d

4

CCQ

E ffe c t/ P r o c e s s code Q u alification

O u tb o u n d : ID o c dis p a tc h e d

Archiving /

F i g u r e 7-7

S e ttin g A r c h iv in g O p t io n s p e r Status

T h e a c t u a l p r o c e s s o f a r c h i v i n g is c o m p l e t e d in T r a n s a c t i o n SARA, as

T ra n s a c tio n SAR A

w i t h all o b j e c t s t o b e a r c h i v e d . T h e a r c h i v i n g o b j e c t f o r I D o c s is also c a lle d IDOC a n d c o n t a i n s t h e u s u a l W r it e , R ead , M a n a g e m e n t , a n d D e le te f u n c t i o n s (s e e F ig u r e 7.8).

A r c h iv e A d m in is tra tio n : In itia l S c re e n $8

0

Logs

C u s to m iz in g

A jc h w in g O b je c t

|ID 0C

D a ta B a s e T a b le s

In fo rm a tio n S y ste m

[ 5 ) l D o c • in te rm e d ia te D o c u m e n t

A c tio n s . W rite B

D e le te

M /S

F ig u re

Read M anagem ent

7.8

A rc h iv in g O b je c t fo r ID ocs

W h e n i t c o m e s t o t h e a r c h i v i n g r e p o r t itself, w h i c h is s t a r t e d u s i n g

A r c h iv in g C rite ria

t h e W r i t e b u t t o n , y o u c a n s p e c i f y in g r e a t d e t a i l w h i c h ID o c s a r e t o b e

fo r ID o cs

a r c h i v e d (s e e F ig u r e 7 .9 ). W h e n te s t m o d e is a c ti v e ( s h o w n a s a flag o n th e

F

l o w

C

o n t r o l

t a b p a g e ) , y o u ' r e p r e s e n t e d w i t h a n a r c h i v e file, b u t

t h e d e l e t i o n r e p o r t d o e s n ' t d e l e t e t h e a r c h i v e d ID o c s f r o m t h e d a t a b a s e .

225

7

|

A d m in istra tio n

As a g e n e r a l r u le , y o u s h o u l d n ' t w a i t t o o l o n g t o a r c h i v e I D o c s . T h e f e w e r ID o c s y o u h a v e in t h e d a t a b a s e , t h e f a s t e r y o u r s e a r c h p r o c e s s e s w ill r u n , a n d v i e w i n g ID o c s o r s e a r c h i n g field c o n t e n t w ill b e j u s t a s e a s y afte r arch iv in g .

M a in tain V a ria n t: R e p o rt RSEXARCA, V a ria n t ZSM_ARCH

y

2 ? Attributes

Direction (1=outb. 2=inb) Curren t Status

Basic type Extension Log ical M essage

Port o f Sender Partner T yp e o f Sender Partner N u m b er o f Sender

Port o f Receiver Partner T yp e o f Receiver Partner N u m b er o f Receiver

P rocessing Options ® T e s t Mode O Production Mode

D e la il Log Log O u tp u l A rc h w in g S e s s io n N o te

F ig u re

7.9

C rite ria fo r ID o c A r c h iv in g

O u r e x a m p l e c o n t a i n s b o t h I D o c s w i t h a s u c c e s s f u l s t a t u s a n d ID ocs w i t h a n u n s u c c e s s f u l s t a t u s (s e e F ig u r e 7 .1 0 ) . T h e SAP s t a n d a r d s e t t i n g s f o r a r c h i v i n g s t a t u s v a l u e s s p e c i f y t h a t ID o c s w i t h e r r o r s r e m a i n a c tiv e b ec au se th e y c a n n o t b e archived.

226

A rc h iv in g

^

C l XD O c lie n t 8 0 0 ^

30

ID o c s in ou tb o u n d p ro c e s s in g

20

1'

0

E rro r p a s s in g d a ta to port

02

1

1'

□

D ata p a s s e d to p ort O K

03

19

© I D o c in in b o u n d p ro c e s s in g

10

I-

O

ID o c w ith e rro rs a d d e d

56

3

I'

□

A p p licatio n d o c u m e n t p o s te d

53

7

F ig u re

7.10

|

ID o c s Before A r c h iv in g

N o w , t h e a r c h i v i n g p r o c e s s is s t a r t e d w i t h t h e All I D o c s T h a t H a v e an A r c h i v a b l e S ta lu s W ill Be A r c h i v e d s e t t i n g ( t h i s h a p p e n s i f y o u h a v e n 't m a d e a n y s p e c if ic s e l e c t io n ) . F ig u r e 7 .1 1 s h o w s t h e re s u lt.

IlD o c Status

IDOCS ^

V

C h a n g e d on is in th e ra n g e ^

6i/bi/2066 io

12731/2009

XDO client 8 0 0 ^

Num ber I

ID o c selection

4563

698

G 3 ID o c s in outbou nd processing

02

©

Error p a s s in g d a ta to port

P

9

Error during syntax ch e c k o f ID o c (outbound)

P

©

Error in A L E service

l>

A

ID oc read y fo r disp atch (ALE service)

26 29 30

l>

□

ID oc is in th e targ et sys tem (ALE service)

39

©

P

5 139

51

350 8

9 . ID oc w th errors add ed

56

120

!•

9

Error during syntax ch e c k o f ID o c (inbound)

60

6

I-

©

Error in A L E service

65

2

P

A

ID oc re a d y to b e transferred to application

64

229

F ig u re

7.11

Application d o c u m e n t n o t posted

332 3m

| 0 ID oc in inboun d p r o c e s s in g _________________________________ I*

221 1

ID o c s A f t e r A rc h iv in g

As m e n t i o n e d p r e v i o u s l y , i t's a l s o p o s s i b l e t o s e a r c h a r c h i v e d ID o c s. A

A c t i v a t i n g in fo

p r e r e q u i s i t e f o r t h i s is t h a t y o u h a v e a c ti v a te d t h e i n f o s t r u c t u r e p r o v i d e d

stru ctu re

b y SAP, SAP_ I D 0 c _ 0 0 1 , o r y o u r o w n i n f o s t r u c t u r e , in T r a n s a c t i o n SARJ. T h e s e i n f o s t r u c t u r e s a r c u s e d to e s t a b l i s h t h e c o n t e x t f o r t h e d a t a in t h e a r c h iv e . F o r t h i s p u r p o s e , p a r t o f t h e d a t a , w h i c h s h o u l d b e k e p t as sm all as p o s s i b l e , is r e t a i n e d in t h e d a t a b a s e w h i l e t h e r e m a i n i n g d a t a is in t h e a r c h iv e . F o r ID o c s, i t's s u f f i c ie n t to r e ta i n a s m a l l a m o u n t o f d a t a fr o m t h e c o n t r o l r e c o r d in t h e d a t a b a s e ; t h e v a s t m a j o r i t y is t h e n d e l e t e d a f t e r a r c h i v i n g . F i g u r e 7 . 1 2 s h o w s t h e S A P -sp ecific s t r u c t u r e SAP_IDOC_001. F o r a c ti v e s t r u c t u r e s , t h e c o r r e s p o n d i n g d a t a r e c o r d s a r e c r e a t e d a u t o ­ m a t i c a l l y a f t e r a r c h iv in g .

227

7 .4

7

|

A d m in istra tio n

A rc h iv e R etrieval C o n fig u ra to r

Infostructure

$AP_lOOC_OOl

|nfo Structure for ID O C @

Arc hiving object

IDOC

Field catalog

Technical d a ta

|S A P_100C _881

| F i e l d C a t a lo g f o r

Info S tru c tu re fields

—

441l\% — C B E iin

E

L ] _E£M I

E

□ C r g a t f ll on m e ch?nq?d Changed on

n 0

-

IDoc num ber

F I

n n ts s ra

T m

Sender

Sender

FI FI

R e c e iv e r p o r t R f i c .P a r t n .I v p f i R p r0 1 vo r

□

-

□

E

D0CHUH

M

CIHTYP

E

R e c ip ie n t

RCVLAD

S ta n d a rd

m

£ P I s t f l y e rs .

STPVRS

M essage u s e

STDHES HESCOD

f u n c t io n

WESFCT OUTnOD

_ £ £ II£

-

n ?q

l£ ii

m m

S e n fle r

SKPLAP

SNDPRN

ip A e rth a n .a e F i l e

R EFINT RFFGRP

FI i M RCVPRT

□ m

le s s a a e

REFHES

—

QVPRN

r c h iv e

r* ■>

E l

7.12

0

OOCREL

ness,

—

F ig u re

DIRECT $AP

-

n

S e n d e r ty p e

—

m m m m

STATUS FI 100 TP □

-

-

IDOC

Optional fields m

—

-

|

ID oc - In term ed iate Docum ent

Key

R ? Q .P ? r tn .F n Q t.

ARCKET RCVPFC

* « r t n » r Ro le

SHDPFC

•x p re s s

EAPBSS

H o .d a ta r e c r f ls

HA»SE6HUH g

A rc h iv e In fo S tru c tu re “ S A P _ ID O C _ 0 0 1 "

Search fo r

You c a n u s e t h i s i n f o s t r u c t u r e in T r a n s a c t i o n SARI t o s e a r c h f o r a r c h i v e d

a rc h iv e d ID o cs

ID o c s . T h i s c a n b e d o n e f o r all a r c h i v e d o b j e c t s , a l t h o u g h t h e r e s u l t is s i m p l y a t a b u l a r v i e w o f t h e i n d i v i d u a l field s. F o r ID ocs, t h e n o r m a l ID o c s e a r c h in T r a n s a c t i o n W E 0 9 is s t r u c t u r e d s o t h a t y o u c a n c h o o s e w h e t h e r t o s e a r c h in t h e a r c h i v e , in t h e d a t a b a s e , o r in b o t h . T h e a d v a n t a g e o f t h i s is t h a t y o u c a n s e a r c h f o r a r c h i v e d ID o c s in t h e u s u a l m a n n e r , a n d t h e d a t a is d i s p l a y e d in t h e s a m e w a y f o r d a t a b a s e ID o c s a n d a r c h i v e d ID o c s . In o t h e r w o r d s , it d o e s n ' t m a k e a n y d i f f e r e n c e w h e r e t h e d a t a c o m e s f r o m . Click t h e S e le c t D a ta S o u r c e b u t t o n to s e l e c t t h e d a t a s o u r c e ( b o t t o m r i g h t in F ig u re 7 . 1 3 ) . T h e a l t e r n a t i v e o f s e l e c t in g files m a n u a l l y i s n ’t r e c o m m e n d e d b e c a u s e y o u h a v e to k n o w w h i c h ID o c s a r e lo c a t e d in w h i c h a r c h i v e file.

D is p la y ID ocs f r o m a rc h iv e

F ig u r e 7 . 1 4 s h o w s a n I D o c t h a t w a s f o u n d in W E 0 9 (517747). I t h a s s t a ­ t u s 5 3 , w h i c h s h o w s t h a t i t c o m e s f r o m t h e a r c h iv e .

228

ID o c S e a r c h fo r B u s in e s s C o n te n t

Criteria
to

24 00 00

O1 / O I / 20 OO

to

01/01/2009

Last Changed Al

to

24 OO 00

Last Changed On

to

Direcaon (1 ■O ut). 2* tab)

to

Created A l Created On

IDoc Number

to

Current Staftis

to ___

Basic Type

to

Enhancement

to

Lo»cai Message

to

Port <*Sender

to

Partner Type o f Sender

to

Partner Number o f Sender

to

I

PortofRecewer Partner Typ« o f Recewer

0 Database 0AKhf*

Partner Number o f Rece.ver Fast Search node

A / th w A c c e s s / ® A/cnve information System O Select flies manually

Criteria lor Search « Data Records Search in Segment Search in Field

F ig u re

7.13

✓ HO I D o c S e a r c h f o r F ie l d C o n t e n t

SAP

Doc oisoia*

^

Technical short irrfo

Q Coracr Rec CD Data records ^ 0 E1M»KTM Q ElfcWKTM □ E1M*KTM

t

Q E1HAKTM DEtfcW RCM

I

Q E1MARCM Q E1M»RCM

53

Basic ffpe

m i««S 03

In to .

Eitens’on

Segment 000004 Segment 000005

Partner No

I90CLNT090

PartnType

LS

Segment 000006 Segment 000027

Port

SAPL13

I' 0 0

E1M»RCM E1H»PMM

0 0

E1KWPMM ElMBEV/M

Segment 000038 Segment 000039

0 E1MBE.W O E1MBEV/M

Segment 000040 Segment 000041

O E1MBE’.WI O ElMvKEM 0 E 1MLANM

Segment 000042 Segment 000043

E 1MLANM

2

Current status

Segment 000002 Segment 000003

Segment 000031 Segment 000034 Segment 000037

0

1O

T ou t number 000045 Segment OOOOOl

Direction

HAIBAS

Message f*pe

Content o» selected segment

Id name

Id cont

Segment 000044 Segment 000045

Status record*

F ig u re 7.14

.

In d iv id u a l ID o c D is p la y in Tra n sa ctio n W E 09

1

7

|

A d m in istra tio n

T r a n s a c t i o n W E 10 in o ld e r releases

P r o c e d u r e in O l d e r R e le a s e s U p to

R e le a s e 4 .6 C , T r a n s a c tio n W E 0 9

rea d

d a ta fro m

t h e d a ta b a s e o n ly .

T h e re w a s a n a d d it io n a l tr a n s a c tio n , W E 1 0 , f o r re a d in g d a ta f r o m th e a rc h iv e . The tw o

fu n c tio n s have b e e n

c o m b in e d in o n e e a s y -to -u s e tra n s a c tio n

in

m o r e r e c e n t relea se s.

D e le te ID ocs

D e le tin g ID o c s Y o u 'll s o m e t im e s h a v e t o d e le te ID o c s . Y o u c a n d o s o in T ra n s a c tio n W E 1 1 . H o w e v e r, w h e t h e r o r n o t y o u s h o u ld b e p e r m it t e d t o d e le te ID o c s in a p r o ­ d u c t i o n s y s t e m is a m a t t e r t o b e c l a r i f i e d w i t h t h e p e r s o n w h o is r e s p o n s i b l e fo r G D P dU

( o r e q u iv a le n t le g is la tio n ) in y o u r o rg a n iz a tio n b e c a u s e d e le te d

d a ta c a n n o t be recovered.

7.5

S ta tu s C o n v e rsio n

T h e r e a r e t w o a u t o m a t i c o p t i o n s f o r s t a t u s c o n v e r s i o n i n t h e SAP s t a n ­ d a r d . B o th o p t i o n s u s e S A P -specific ID o c s , AUD

ALEAUD

and

SYSTAT.

The

ALE-

ID o c a s s i g n s t h e s t a t u s v a l u e s 3 9 , 4 0 , o r 4 7 , in a c c o r d a n c e w i t h t h e

r e c i p i e n t 's s t a t u s , w h i l e t h e

SYSTAT

ID oc can assig n a n y n e w statu s w ith

its o w n f a il u r e o r s u c c e s s t e x t . C h a p t e r 5, C o n f i r m a t i o n s , d e s c r i b e s t h e f u n c t i o n a l i t y o f b o t h o f t h e s e I D o c s in d e t a i l . I t ’s a ls o p o s s i b l e to s e t ID o c s t h a t still c o n t a i n e r r o r s to a s t a t u s t h a t p r e v e n t s t h e m f r o m a n y fu r­ t h e r p r o c e s s i n g , in b o t h i n b o u n d a n d o u t b o u n d p r o c e s s i n g . T h is s t a t u s also a l l o w s t h e a f f e c te d ID o c s to b e a r c h i v e d . T h e c o r r e s p o n d i n g s t a t u s is 3 1 in o u t b o u n d p r o c e s s i n g a n d 6 8 i n i n b o u n d p r o c e s s i n g . N o t e t h a t c o n s i s t e n c y is g u a r a n t e e d o n a s y s t e m - w i d e b a s i s o n l y i f t h e a c t i o n s t h a t s h o u l d h a v e b e e n e x e c u t e d b y t h e ID o c a r e e x e c u t e d in s o m e o t h e r w a y ( e i t h e r b y a n o t h e r ID o c t h a t d o e s n ' t c o n t a i n t h e e r r o r , o r m a n u a l l y ) . M a n u a l d e le te fla g

S e t t in g t h e s t a t u s v a l u e s to m e a n E rr o r , n o f u r t h e r p r o c e s s i n g is d o n e in t h e e r r o r w o r k f l o w u s i n g t h e D e l e t e F la g b u t t o n (s e e F ig u r e 7 .1 5 ). T h e s t a t u s c h a n g e i t s e l f is m a d e a f t e r a s e c u r i t y p r o m p t a n d f o r o n l y o n e ID o c a t a t i m e . T h e r e is n o f a c ility in t h e SAP s t a n d a r d f o r m a k i n g m a s s c h a n g e s to s t a t u s v a l u e s , n o r is t h e r e lik e ly to b e s u c h a facility. T h e n e x t se c tio n c o n ta in s a s a m p le p ro g ra m fo r m a k in g m ass changes.

230

Status C o n v e rsio n

|

s| D isp la y S tatus R ecord P I | P ro c ess

1 1 D e le te fla g 1[ h ] [71 [T1[ h ] 1 iD o c D is p la y ]

iDoc num ber!

0900900000768840

D irection

1

Outbound

S tatus

02

Error p as sin g d a ta to port

M essage

^

Co uld not find co d e pag e fo r receiving system

S ts details

F i g u r e 7 -15

Logging___________________________

Setting the Delete Flag in the Workflow

S am p le P rogram fo r M a s s C h anges I f y o u h a v e t h e p r o b l e m , p a r t i c u l a r l y in t e s t s y s t e m s , t h a t a la rg e n u m b e r

Mass changes

o f ID o c s c a n n o t b e p o s t e d , y o u c a n s e t a ll o f t h e s e ID o c s to a n a rc h iv a b le s t a t u s a t o n e t i m e . N o t e , h o w e v e r , y o u m u s t e n s u r e t h a t t h i s is d o n e u s i n g t h e o r i g i n a l SAP t o o l s a n d t h a t t h e a s s o c i a t e d e r r o r w o r k f l o w has b e e n c lo s e d . B e c a u s e t h e p r o g r a m c a n a ls o b e u s e d t o s e t a n o t h e r s t a t u s , i t m a y be n e c e s s a r y to t r i g g e r a n e r r o r w o r k f l o w . T h i s p r o g r a m r e p r e s e n t s a m a j o r i n t e r v e n t i o n i n t o t h e SA P s y s t e m , s o y o u s h o u l d a d d a l o t o f h i g h - q u a l ­ ity c o m m e n t s t o t h e c o d e a n d s e c u r e it w i t h a h i g h lev el o f a u t h o r i z a ­ t i o n c h e c k s . O u r s a m p l e p r o g r a m (s e e L isting 7 .1 ) u s e s a s t a t u s t e x t t h a t sh o w s w h ic h u s e r m a d e th e statu s change. N o t e s o n t h e C ode This c o d e is in ten d ed as an exam ple only a n d d o e s n 't contain authorization checks. Also carefully consider w h e th e r you really w a n t to m ak e every status change s h o w n in this exam ple. O n e alternative w ould be to change t o sta­ tuses 3 1 an d 6 8 only. In particular, n o t e t h a t resetting a successful IDoc to a statu s t h a t perm its further processing can lead t o duplicate postings and inconsistencies.

T h e p r o g r a m i t s e l f w a s p r o g r a m m e d u s i n g t h e n e w A B A P L ist V iew er (ALV). T h i s h a s t h e a d v a n t a g e t h a t t h e d i s p l a y d y n p r o a n d t h e G U I s t a t u s d o n ' t h a v e to b e c r e a t e d , w h i c h m a k e s i t m u c h e a s i e r f o r y o u t o w o r k w i t h t h i s e x a m p l e . F ig u r e 7 . 1 6 s h o w s w h i c h s e l e c t i o n fie ld s y o u c a n u se. H e r e , as b e f o r e , it's o f c o u r s e u p t o y o u w h e t h e r y o u i n c o r p o r a t e a d d i ­ tio n al re q u ire m e n ts .

231

Selection fields

7 .5

7

|

A d m in istra tio n

F ig u re

S e le c tio n lis t

7.16

In itia l D y n p ro o f t h e S a m p le P ro g ra m

T h e i n p u t f r o m F ig u r e 7 . 1 6 is u s e d t o lis t all o f t h e p o s s i b l e ID o c s (see F ig u re 7 .1 7 ). You c a n l i m i t t h e ID o c s b y p l a c i n g c h e c k m a r k s in t h e a p p r o ­ p r i a t e s e l e c t i o n c o l u m n . T h e n , w i t h o u t a b u t t o n , w h e n e v e r y a c t i o n is e x e c u t e d , t h e lis t o f s e l e c t e d I D o c s is c o n v e r t e d . You c a n a ls o a p p l y s p e ­ cial c o n t r o l s to t h i s c o n v e r s i o n — u s i n g a b u t t o n , f o r e x a m p l e . In g e n ­ eral, t h i s c a n b e d o n e w i t h b o t h t h e o l d a n d t h e n e w ALV.

232

Status C o n v e rsio n

S e l e c t e d

I D

o c s

mm iD o c n u m b e r

S

|P a r t n n o

P

7 6 8 /4 5

03

T90C LN T090 LS

768746

56

ZSM 2

LS

768747

68

ZSM 2

LS

768748

53

ZSM 2

LS

R

|M e ssa g e Type

|« «

T | s i a iu s m e s s a g e id

M

| s t a t u s te« t

|M A T M A S M ATM AS

1

m a tm a s

M ATM AS

> CO > <0

\z

768760 768751

68

LS

M ATM AS

ZSM 2

LS

M ATM AS

768752

68

ZSM 2

LS

M ATM AS

768753

53

ZSM 2

LS

M ATM AS

768754

37

ZSM 2

LS

M ATM AS

768755

3 7 |Z S H 2

LS

M ATM AS

768756

37

ZSM 2

LS

M ATM AS

768757

03

ZSM 2

LS

M ATM AS

768758

53

ZSM 2

LS

j M ATM AS

768759

12

ZSM 2

LS

M ATM AS

768760

5 3 |Z S M 2

LS

JM A T M A S

768761

51

SA LES

LS

M ATM AS

768762

51

SA LES

LS

M ATM AS

768763

64

SA LES

LS

M ATM AS

{

j -------------------------------

j

1

768765

F ig u re

7.17

0 3

T9 0 C LN T0 9 0 LS

M ATM AS

R e s u lt s o f t h e I D o c Search

T h e lis t s h o w n in F ig u re 7 . 1 8 s h o w s t h e re s u lts . I n o u r e x a m p l e , all o f t h e ID o c s w e r e c o n v e r t e d su c c e s s fu lly .

Z S M ID O C S T A T U S

iD o c n u m tm r S ta tu s

S o n f lK f u r t r - f n o

S * * . d o r ry p *

768761

61

SA LES

IS

• td

-1

iW .L t

LS

768763 64

SA LES

LS

W UAS

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 6 3

7 6 8 7 6 * *5 J

S .M .E S

S

H *T H *S

D O C 0 0 ( 0 0 0 0 0 0 0 7 6 8 7 6 4 N * w f . t f j s ‘ > i ID o c w « s e t

7 6 8 7 6 S jp 3

T 9 0 C IN T 0 9 0

LS

W M AZ

768 7 6 6 *5 1

SA LES

.8

H A tH * S

P

M o « *9 < » T y D . K A T IW S

I DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 6 1 DOC 0 0 0 0 0 0 0 0 0 0 7 6 8 7 6 2

0 0 (0 0 0 0 0 0 0 7 6 3 7 6 5 DOC 000

N e w S '.t y ii • » ID o c « M New b O O O M N e w SSIO Jt X * ID o c - « n e w

0001X 10765766 I . ' - S M

IS

D O C 0 0 ( 0 3 0 0 0 0 0 7 6 3 7 6 ' 1 ie w

T9C C LN T090

LS

D O C 0 0 ( J D 0 0 C < l 0 7 e 3 7 6 8 t . ? ~ S '.W j i

768771

12

T9C C L I « " J 9 0

7 6 8 77?*03

T90C LN T090

• la ;;* ,

J

a

.m H I

iD c c w j s i d i? C < w a s 5 f 1

LS

S - . r t j t ' * lD o < W M i r l

✓

*

V A T IA »S

D O C 0 0 0 0 0 0 0 0 0 0 7 6 8 7 7 ? N « w S J * j & S * ID o c w a s s * 1

✓

LS

V A 'W -i. H STH 4S

1 "VTV

ln o / rW . fUlfWlf W V W W V I v v r

f^

I’T "

i£. '*»?

> 3 VI

j

‘w

ID o c w w » * 1

✓

K )0 < w a * S (4

✓

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 7 6 N « w S U fc t DOC 0 0 0 0 0 0 0 0 0 0 7 6 8 7 7 3

New New

768773 II?

T 9 0 C U JT 0 9 0

LS

12

T 9 C C L IJT D 9 0

LS

768 7 8 1 *0 3

I9 0 C L N T 0 9 0

LS

M ATMAS

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 8 1 N * * 8 tlfe S fe (IO 0 < W M M 4

7 6 8 78?*03

T90C LN T090

s

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 7 5

SU U S

S a f e s S # ID o c w w

✓

M ATMAS

D O C 0 0 0 0 0 0 0 0 0 0 7 6 8 7 8 2 N iw S t tfe S IM D O C W M M I

T 9 0 C IM T 3 9 0

L S ______________

M ATMAS

DOC 0 0 (0 0 0 0 0 0 0 7 6 3 7 8 3

768784 03

T90C LN T090

LS

M »TM »S

DOC 0 0 0 0 0 00000763784

a

N e w S a f e s S * lD o < w a -. New S U fe S D tO K ttM N e w S ' . r t j i * » r ID o c w i t

li

1 9 C C IH T 3 9 0

LS

M ATMAS

DOC 0 0 (0 0 0 0 0 0 0 7 6 3 7 8 8

7 6 8 7 8 9 '0 3

T90C LM T090

LS

M ATMAS

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 8 9 N *w S !« J 5

> 6 8 .‘“ J

DOC 0 0 0 0 0 0 0 0 0 0 7 6 8 7 9 0

New New

I j

T 9 C C L N ?i9 0

LS

7 6 8 7 9 1 '0 3

T90C L M TQ 90

LS

M ATMAS

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 9 1

7 6 9 7 1* ? O

T 9 C < L K -T 3 9 0

LS

V .T U .,:

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 9 2 N ew

F ig u re 7.18

✓ ✓

DOC 0 0 (0 0 0 0 0 0 0 7 6 8 7 7 1

7697?$

* r ,3 r ? i

o '

w ~ y ~

W IK A 5

T•V «("■" W U 1 «»V T 90C LM T090

C . f ijt . * M ‘V

✓ ✓

IU D K IIM

T 9C C L N "J9 0

*7 6V V 0 71 7r 1■ v

M

*■ » i d o < - w

7 6 8 7 6 8 C3

New

5 *1

*x

✓ ✓

M sH

✓

>D 0< " « i t - t

✓

S a f e s W i 0 0 ( - S I 1M

tel 8 l a f e s t o * ID o c w i i i r t

S a fe s

✓

ID o c w a s

✓ ✓ o '

R esu lts L ist A fter Status V a lu e C o n v e rsio n

233

R e s u lts lis t

|

7 .5

7

|

A d m in istra tio n

In T r a n s a c t i o n B D 8 7 , i f t h e b a s i c v i e w is o p e n , y o u c a n s e e t h e g e n e r i c e r r o r t e x t w i t h p l a c e h o l d e r s (s e e F ig u r e 7 .1 9 ).

^

45

[ 2 IDoc in inbound processing I 1 O Application docum ent not posted

51

6

!■ 0 : IDOC Witn errors added

56

3

1

□ Application docum ent posted

53

7

^

□

E r ro r-n o further processing

68

29

^

53 MATMAS ^

29

U ] ZSM(OOO) IDoc Status w a s changed from S to S

29

( D IDoc Slatus w a s changed from M A SE LSA to 68

F ig u re

C o n v e rte d ID o c

7 19

29

M e s s a g e T e x t i n t h e B a s ic L is t

I n t h e i n d i v i d u a l v i e w o f a n ID o c , y o u c a n s e e e x a c t l y w h o m a d e t h e c o n v e r s i o n (s e c F ig u r e 7 .2 0 ) .

IDoc Selection I .......... ■ ■■■■■ IDoc num ber | Stat

M e s s a g e T y p e l StatusText

Partner No

768747

68

MATMAS

IDoc Status w a s changed from MAJSELSA to 68

ZSM2

BasicType________ | Extension MATMAS33

768752

68

MATMAS

IDoc Status w a s changed from MAJSELSA to 68

ZSM2

j MATMAS03

768762

68

MATMAS

IDoc status w a s changed from MAJSELSA to 68

SALES

MATMAS05

ZSMMAPA

768763

68

MATMAS

IDoc Slatus w as changed from MAiSELSAIo 68

SALES

MATMAS05

ZSMMAPA

768761

F ig u re

M e s s a g e c la s s

720

M e s s a g e T ext in t h e ID o c I n d iv id u a l V ie w

F o r t h e e x a m p l e p r o g r a m u s e d h e r e , a m e s s a g e c la s s w i t h t h e m o s t i m p o r t a n t m e s s a g e s h a s t o b e s e t u p . F ig u r e 7 .2 1 s h o w s t h e t e x t u s e d for this p u rp o s e .

M essage M a in tenance: C hange M essages *2 ? #

Selected entnes

M essag e c la s s

ZSn

^

aaa g

3

Long Text

N ext free nu m b e r

N e iiu s e d

<

Activ

Attributes

u

a

u

*

30 n

F l M e s s a g e M essag e short text |

|0 0 0

F ig u re

| l Doc

7.21

|Seif-explanaty 0

M e s s a g e C la ss o f t h e S a m p l e P r o g r a m

L isting 7.1 c o n t a i n s t h e b a s ic c o d e r e q u i r e d f o r t h e e x a m p l e s d e s c r i b e d in t h i s c h a p te r . A g a in , n o t e t h a t o n l y t h e c o d e t h a t is r e l e v a n t t o ID o c s is

234

Status C o n v e rs io n

|

g iv e n h e r e , a n d i h e c o d e s h o u l d n ’t b e u s e d in u n m o d i f i e d f o r m ; a u t h o r i z a ­ ti o n c h e c k s , f o r e x a m p l e , s h o u l d b e a d d e d . A lso, t h e p r o g r a m c o n t a i n s te x t e l e m e n t s t h a t y o u ' l l h a v e to a d d , s u c h as

te x t-b O l

f o r o n e o f t h e b locks

o n t h e s e l e c t io n s c r e e n . W h e r e t h e s e d o n ’t a p p e a r o n t h e s e l e c t io n s creen , t h e y a r e i n d i c a t e d in t h e c o d e in e a c h c a se — f o r e x a m p l e , not

be

‘ ID o c c o u ld

( 0 0 1 ) - a n d s o n o fu r th e r scre en sh o ts are used here.

lo c k e d *

*&.............................................................................................................................................* *8

R e p o rt

Z S M ID O C S T A T U S

* & ..............................................................................................................................................................................................* REPORT

Z S M ID O C S T A T U S

IN C LU D E

< ic o n >

TABLES:

e d id c

.

. .

TABLES: e d id s .

tb d 0 5

.

DA T A

w a _ tb d 5 2

TYPE

tb d 5 2

.

DA T A

wa_edp21

TYPE

edp21

.

DA T A

p a rtn e r

TYPE

e d id c -s n d p rn .

n r l i nes

TYPE

s y -ta b ix

D a ta

a lv

TYPE

REF

TO

c l_ s a lv _ . t a b le

DA T A

1r_ s e le c tio n s

TYPE

REF

TO

c l_ s a lv _ . s e le c t io n s

DA T A

i_ S e le c te d _ ro w s

ty p e

s a lv _ t_ ro w

DA T A

w a _ ro w

ty p e

lin e

D a ta

exc

TYPE

REF

DA T A

msg

TYPE

s tr in g

Types:

B E G IN

OF

o f TO

. . .

.

s a lv _ t_ .ro w c x _ ro o t

.

,

. Type d e fin itio n s

r_ e d id c ,

docnum

L IK E

e d id c -d o c n u m .

s ta tu s

L IK E

e d id c -s ta tu s .

sn d p rn

L IK E

e d id c -s n d p rn .

sn d p rt

L IK E

e d id c -s n d p rt.

s n d p fc

L IK E

e d id c -s n d p fc .

m e s ty p

L IK E

e d id c -m e s ty p .

m escod

L IK E

e d id c -m e s c o d .

m e s fc t

L IK E

e d id c -m e s fc t.

te s t

L IK E

e d id c -te s t.

s ta m id

L IK E

e d id s -s ta m id .

s ta m n o

L IK E

e d id s -s ta m n o ,

s ta tx t

L IK E

e d id s -s ta tx t.

m sg(80) , i con(4 ). b o x(1 ). END OF

r_ e d i dc

.

235

7 .5

7

|

A d m in istra tio n

DATA:

i_ e d id c

ty p e

ta b le

d a ta :

w a _ e d id c

ty p e

r_ e d id c

DATA:

id o c _ s ta tu s

DATA:

c _ e v e n t_ o b je c t_ ty p e _ id o c a p p l

L IK E

.

.

VALUE

O CCURS

0

W IT H

HEADER

L IN E

.

L IK E

’ ID O C A P P L '

.

c _ e v e n t_ e rr_ p ro c e s s _ c o m p le te d L IK E

CONSTANTS: VALUE

r_ e d id c

b d id o c s ta t

s w e ty p e c o u -o b jty p e DATA:

o f

s w e ty p e c o u -e v e n t

VALUE

' ERRORPROCESSCOMPLETD’

c _ w f_ re s u lt_ d e le te _ id o c

L IK E

b d w f_ p a ra m -re s u lt

L IK E

b d w f_ p a ra m -re s u lt

.

•9 9 9 9 8 ’ . c _ w f_ re s u lt_ w i_ c o m p le te VALUE

D a ta :

•9 9 9 9 7 ’

g _ re p id

.

L IK E

s y -re p id ,

g_save( 1)

TYPE

c

g _ v a ria n t

L IK E

d is v a ria n t

VALUE

* A \ .

DATA: $ id o c _ g e s (6 )

TYPE n .

$ id o c _ o k ( 6 )

* S e le c tio n screen stru ctu re

TYPE n .

$ id o c _ fe h le r (

6 ) TYPE

S e le c t

to

ID o c s

S E L E C T IO N -S C R E E N S E L E C T -O P T IO N S :

S E L E C T -O P T IO N S :

.

m o d ifie d

B E G IN

OF

docnum

S E L E C T IO N -S C R E E N

d a tu m

be

n

S K IP

w ith

p re -s e le c tio n

0 1 W IT H

BLOCK

FRAME

FOR e d i d c - d o c n u m 1

T IT L E

te x t-b O l

.

.

cre d a t

FOR e d i d c - c r e d a t

DEFAULT

c re tim

FOR e d i d c - c r e t i m

DEFAULT

s y -d a tu m

TO

000000’

TO

sy-

.

S E L E C T -O P T IO N S :

’

’ 235959' S E L E C T -O P T IO N S :

m e s t y p FOR

e d id c -m e s ty p .

S E L E C T -O P T IO N S :

m e s c o d FOR

e d id c -m e s c o d .

S E L E C T -O P T IO N S :

m e s f c t FOR

e d id c -m e s fc t .

S E L E C T -O P T IO N S :

d i r e c t FOR

e d id c d ire c t .

S E L E C T -O P T IO N S :

s n d p o r FOR

tb d 0 5 - s n d s y s te m

S E L E C T -O P T IO N S :

s n d p r t FOR e d i d c - s n d p r t

S E L E C T -O P T IO N S :

s n d p r n FOR

S E L E C T -O P T IO N S :

s n d p f c FOR e d i d c - s n d p f c

S E L E C T -O P T IO N S :

r c v p r t FOR

e d id c -rc v p rt .

S E L E C T -O P T IO N S :

r c v p r n FOR

e d id c -rc v p rn .

S E L E C T -O P T IO N S :

r c v p f c FOR

e d id c -rc v p fc .

S E L E C T -O P T IO N S :

s t a t u s FOR

e d i d c - s t a t u s DEFAULT

S E L E C T IO N -S C R E E N

END O F

S E L E C T IO N -S C R E E N

B E G IN

BLOCK OF

01

BLOCK

s _ s ta m id

FOR e d i d s - s t a m i d ,

s _ s ta m n o

FOR

e d id s -s ta m n o

.

.

.

e d id c -s n d p rn .

S E L E C T -O P T IO N S :

236

.

.

.

’

68’

.

. 02

W IT H

FRAME

T IT L E

te x t-b 0 2

.

Status C o n v e rsio n

S E L E C T I O N - S C RE E N END S E L E C T IO N -S C R E E N PARAMETERS:

S K IP

n e w s ta t

S T A R T -O F -S E L E C T IO N SELECT:

OF 1

02

.

.

L IK E

e d id c -s ta tu s

-68*

DEFAULT

.

.

docnum

s ta tu s

m e s fc t

te s t

IN T O

BLOCK

|

s n d p rn

c o rre s p o n d in g

fie ld s

WHERE

FROM e d i d c

s n d p rt

s n d p fc

ta b le

of

m e s ty p

D a ta se le c tio n

m escod

i_ e d id c

docnum

IN

docnum

AND

upddat

IN

c re d a t

AND

u p d tim

IN

c re tim

AND

m e s ty p

IN

m e s ty p

AND

m escod

IN

m escod

AND

m e s fc t

IN

m e s fc t

AND

sndpor

IN

sndpor

AND

s n d p rt

IN

sn d p rt

AND

s n d p rn

IN

sn d p rn

AND

s n d p fc

IN

s n d p fc

AND

di re ct

IN

d ir e c t

AND

rcv p rt

IN

d ir e c t

AND

rc v p fc

IN

d ir e c t

AND

rcvp rn

IN

d ir e c t

AND

s ta tu s

IN

s ta tu s

.

PERFORM g e t _ e d i d s E N D -O F -S E L E C T IO N PERFORM

*

Change

a lv

.

.

s ta tu s

* ............................ FORM s t a t u s _ c h a n g e i_ s e le c te d _ r o w s

*

lo o p

a t

rea d

ta b le

. =

L R _ S e l e c t i o n s-> G E T _ S E LE C T E D _ R O W S (

i_ s e le c te d _ r o w s i_ e d id c

ID O C

p ro c e s s in g

CALL

F U N C T IO N

in to

in to

w a _ ro w

w a _ e d id c

C hange sta tu s

)

.

in d e x

w a _ ro w

.

Set lock

* E N O U E U E _E S _E D ID O C E '

E X P O R T IN G m o d e _ e d id c

•E ’

m andt

sy-m a n d t

docnum

w a _ e d id c -d o c n u m

E X C E P T IO N S

1

fo re ig n _ lo c k s y s te m _ fa i1 u re O THERS

=

2

3 .

237

7 .5

7

|

A d m in istra tio n

IF

s y-su b rc

<>

0

CONCATENATE

.

'ID O C '(0 0 3 )

w a _ e d id c -d o c n u m

*ID o c

not

IN T O w a _ e d id c -ic o n ELSE

=

c o u ld

be

w a _ e d id c -m s g ic o n _ fa ilu re

lo c k e d ’

(0 0 1 )

SEPARATED

BY

space

.

.

CLEAR:

id o c _ s ta tu s

REFRESH:

.

id o c _ s ta tu s

MOVE w a _ e d i d c - d o c n u m

TO

id o c _ s ta tu s - d o c n u m

MOVE n e w s t a t

TO

id o c _ s ta tu s -s ta tu s

MOVE

‘S’

TO

id o c _ s ta tu s -m s g ty

.

MOVE

' ZSM’

TO

id o c _ s ta tu s -m s g id

.

MOVE

•0 0 0 ’

TO

id o c _ s ta tu s - m s g n o

.

MOVE

sy-un a m e

TO

id o c _ s ta tu s - m s g v l

.

MOVE n e w s t a t

TO

id o c _ s ta tu s -m s g v 2

.

MOVE

sy-un a m e

TO

id o c _ s ta tu s -u n a m e

.

MOVE

s y - re p id

TO

id o c _ s ta tu s - re p id

.

APPEND CALL

id o c .s ta tu s

F U N C T IO N

.

‘ ID O C _ S T A T U S _ W R IT E _ T O _ D A T A B A S E ’

E X P O R T IN G y ;a _ e d id c -d o c n u m

id o c _ n u m b e r TABLES

id o c _ s ta tu s

i d o c _ s ta tu s E X C E P TIO N S

IF

id o c _ fo r e ig n _ lo c k

1

i d o c _ n o t_ fo u n d

2

i d o c _ s ta tu s _ re c o rd s _ e m p ty

3

id o c _ s ta tu s _ in v a l id

4

d b _ e rro r

5

sy-su b rc

EO 0

CONCATENATE

* I DOC’ < 0 0 3 )

‘ New

s ta tu s

IN T O

w a _ e d id c -m s g

w a _ e d id c -ic o n ELSE

‘ S ta tu s

=

fo r

ID o c *(0 0 2 )

SEPARATED

ic o n _ c h e c k e d

IN T O

* ID O C * < 0 0 3 ) c o n v e rs io n

w a _ e d id c -m s g

w a _ e d id c -ic o n M O D IFY

i_ e d id c

C O N T IN U E

238

se t

w a _ e d id c -d o c n u m

BY

space

.

.

.

CONCATENATE

E N D IF

.

.

.

-

w a _ e d id c -d o c n u m

e rro r*(0 0 4 ) SEPARATED

ic o n _ fa ilu re fro m

w a _ e d id c

BY

space

.

. in d e x

w a _ ro w

.

Status C o n v e rsio n

CASE n e w s ta t WHEN *

IDoc was

*68'

set

* p ro c e ssin g ; * error

|

7 .5

. .

to

a status

th e refore,

that

does not

trig g e r

event

p e rm it

that

fu rther

ends

the

w o rk flo w .

SELECT SINGLE

* FROM e d p 2 1

INTO w a _ e d p 2 1

WHERE s n d p r n = w a _ e d i d c - s n d p r n AND s n d p r t = w a _ e d i d c - s n d p r t AND s n d p f c -

w a _ e d id c-sn d p fc

AND m e s t y p = w a _ e d id c - m e s t y p AND m e s c o d -

w a_ ed id c-m e sco d

AND m e s f c t = w a _ e d i d c - m e s f c t AND t e s t IF

sy-subrc

CONCATENATE

<> 0

-

w a _ e d id c-te st

'ID O C '(003)

w a _ e d id c - docnum

’ f o r ' (005)

'm e s s a g e '(008)

e d id c -sn d p rt 'n o

entry

e d id c -sn d p fc

found

in

INTO w a _ e d id c - m s g ELSE

*

FROM t b d 5 2

WHERE e v c o d e sy-subrc

<> 0

CONCATENATE ’process

-

e d id c-m e sty p

EDP21."(006 ) S E P A R A T E D BY s p a c e

.

INTO w a _ tb d 5 2

w a_edp21-evcode

.

.

' IDOC- (0 0 3 ) w a .e d id c-d o cn u m c o d e '(0 0 9 )

‘ no e n t r y

found

in

INTO w a _ e d id c - m s g ELSE

e d id c -sn d p rn

.

SELECT SINGLE IF

.

.

'fo r'(0 0 5 )

w a_edp21-evcode TBD52.'(0 0 7 )

SEPARATED BY s p a c e

.

.

PERFORM

sta rt_ e v e n t(sa p lb d 2 0 ) w a_tbd52- event_end

USING w a _ e d id c - d o c n u m

S ta rt w o r k flo w s ,

w a_tbd52- i docobj typ

c _ w f_ re s u lt_ d e le te _ id o c

if re q u ire d

.

C O M M I T WORK . PERFORM

sta rt_ e v e n t(sa p lb d 2 0 ) w a_tbd52-event_end

USING w a _ e d id c -d o c n u m

w a _ tb d 5 2 -id o c o b jty p

c _ w f_ re s u lt_ w i_ co m p le te

.

C O M M I T WORK . ENDIF

.

ENDIF

. WHEN

*31'

.

End w o rk flo w

PERFORM e v e n t _ f o r _ t a s k _ e n d _ c r e a t e ( s a p ! b d l 6 ) USING w a _ e d id c-d o c n u m C O M M I T WORK WHEN O T H E R S

.

.

.

239

7

|

A d m in istra tio n

EN D C ASE CALL

.

F U N C T IO N

‘ D E O U E U E _ E S _ E D ID O C E ’

E X P O R T IN G

E N D IF M O D IFY

IF

‘ E’

=

sy-m a n d t

docnum

=

w a _ e d id c -d o c n u m

i_ e d id c

sy-su b rc

fro m

0

in d e x

w a _ ro w

.

.

i_ e d id c

1 TO .

LOOP

i_ e d id c

AT

ADD

1 TO

END LO O P

and

p ro c e s s e d

$ id o c _ e rr o r

.

T R A N S P O R T IN G

NO

WHERE

ic o n _ c h e c k e d

$ id o c _ o k

END LO O P

E N D IF

w a _ e d id c

s e le c te d

S id o c _ o k .

AT

ADD

=

w e re

CLEAR:

ENDFORM

.

.

E n trie s

LOOP

-

.

EN DLO O P

*

m o d e _ e d id c m andt

ic o n

=

F IE L D S .

.

T R A N S P O R T IN G

NO

WHERE

ic o n _ fa ilu re

ic o n

$ id o c _ e rro r

-

F IE L D S .

.

.

. .

* ____________________________________________________________ *

R e trie v e

d a ta

*__________ ____________ . . . . ______________ . . . . . ______________ FORM g e t _ e d i d s DATA:

it_ e d id s

TYPE

w a _ e d id s

L IK E

e d id s

IS

IN IT IA L

.

w a _ e d id c

.

NO T AT

s _ s ta m n o

i_ e d id c

REFRESH G e t s t a tu s va lu e s

SELECT

IF

.

h _ s tr ( 1 5 0 ).

CH E C K LOOP

*

OF

e d id s .

.

A P P E N D IN G

TABLE =

w a _ e d id c -d o c n u m

AND

s ta tu s

=

w a _ e d id c -s ta tu s

AND

s ta m id

AND

s ta m n o

.

.

. i t_ e d id s

BY

it.e d id s

WHERE d o c n u m

0 .

i_ e d id c

C O N T IN U E E N D IF

NE

TABLE

.

FROM e d i d s

s y-su b rc

S O RT

in to

it.e d id s

DELETE

docnum lo g d a t

240

....

D E S C E N D IN G

IN IN

s _ s ta m id

s _ s ta m n o

.

Status C o n v e rsio n

DELETE

ADJACENT

it_ e d id s

D E S C E N D IN G

docnum

.

it_ e d id s

IN T O

w a _ e d id s

=

w a _ e d id s -s ta m id

.

=

w a _ e d id s -s ta m n o

.

h _ s tr

= •& ’

h _ s tr

REPLACE

REPLACE

h _ s tr *& *

C O NDE NSE REPLACE C O NDE NSE

EN D LO O P ENDFORM

h _ s tr

.

w a _ e d id s -s ta p a

2

IN T O

h _ s tr

.

w a _ e d id s -s ta p a 3

IN T O

h _ s tr

.

w a _ e d id s - s ta p a 4

IN T O

h _ s tr

.

.

h _ s tr

.

W IT H

h _ s tr

.

w a _ e d id c -s ta tx t M O D IFY

IN T O

W IT H

*& ’

.

1

.

W IT H

C O NDE NSE

w a _ e d id s -s ta tx t

Set te x ts

.

w a _ e d id s - s t a p a

W IT H

7 .5

.

1

IN D E X

FROM

w a _ e d id c -s ta m n o

C O NDE NSE

*

c o u n tr

w a _ e d id c -s ta m id

REPLACE

*

D E S C E N D IN G

D U P LIC A T E S

C O M PARING READ T A B L E

lo g tim

|

i_ e d id c

=

h _ s tr

fro m

.

w a _ e d id c

.

.

.

_________________________________________________________________ T itle

T itle ALV

ALV

* _______________________________________________________________ FORM

t it le

D ATA

U S IN G

s e ttin g s

s e ttin g s

=

t it le TYPE

TYPE REF

lv c . t it le

TO

c l_ s a lv _ d is p la y _ s e ttin g s

a lv -> g e t_ d is p la y _ s e ttin g s (

s e ttin g s * > s e t_ lis t_ h e a d e r( ENDFORM *

*

.

t it e l

)

)

.

.

.

.

................................................................................................................................... ALV

s e le c tio n

A L V se le c tio n o p tio n s

o p tio n s

* ....................................................................................................................................... FORM *

s e t_ s e le c tio n s

get

th e

S E L E C T IO N S

1 r _ s e le c tio n s *

set

th e

-

U S IN G

p _ a lv

TYPE

REF

o b je c t

p _ a lv -> g e t_ s e le c tio n s (

s e le c tio n

TO c 1_ s a 1 v _ t a b l e

)

.

m ode

1 r _ s e le c tio n s -> s e t_ s e le c tio n _ m o d e ( v a lu e ENDFORM

.

=

if_ s a lv _ c _ s e le c tio n _ m o d e = > c e l "

1

)

.

s e t_ s e le c tio n s

* _______________________________________________________________ *

ALV

o u tp u t

* ________________________________________________________________ FORM a l v TRY

.

G e t A L V reference

.

241

7

|

A d m in istra tio n

c l_ s a lv _ ta b le = > fa c to r y ( IM P O R T IN G r_ s a lv _ ta b le

=

a lv

=

i_ e d id c

C H A N G IN G t_ ta b le CATCH

c x _ s a lv _ m s g

m sg

=

M ESS AG E E N D TR Y

IN T O

e x c -> g e t_ te x t( msg

TYPE

*A ‘

PERFORM

t it le

s e t_ s e le c tio n s

1 v - > d is p 1 a y (

p e rfo rm

L is tin g

7 .6

7.1

U S IN G

)

.

.

.

)

'S e le c te d U S IN G

a lv

ID o c s

1

.

.

.

s ta tu s _ c h a n g e

a1 v - > d is p la y ( ENDFORM

)

.

.

p e rfo rm a

exc

)

.

.

. S ta tu s C o n v e rs io n o f S e le c te d ID ocs

S u m m a ry

T h i s c h a p t e r g a v e y o u a n o v e r v i e w o f a d m i n i s t r a t i v e ta s k s t h a t a re r e l a t e d to ID o c s . D e p e n d i n g o n t h e s t r u c t u r e o f y o u r c o m p a n y , s o m e o f th is w o r k m ig h t b e d o n e b y a sp ec ia l d e p a r tm e n t, b u t y o u s h o u ld k n o w w h i c h w o r k h a s t o b e d o n e . W e 'v e a l s o i n c l u d e d s o m e h i n t s f o r d a ily w o r k a n d e r r o r h a n d lin g .

242

T his c h a p te r p r o v id e s so m e tip s o n u s in g S A P N e tW e a v e r Process In te g r a tio n to s e n d o r receive ID ocs.

8

IDocs in Conjunction with SAP NetW eaver Process Integration

C o m m u n i c a t i o n in SAP N e t W e a v e r P r o c e s s I n t e g r a t i o n (SAP N e t W e a v e r PI) u s i n g ID o c s is i m p l e m e n t e d v i a t h e ID o c a d a p t e r . T h e r e q u i r e m e n t in t h e c r e a t i o n o f t h e ID o c a d a p t e r i n SAP N e t W e a v e r PI w a s t h a t n o d iffe ren c e m a y a rise fo r t h e b a c k e n d s y s te m s i f th e y c o m m u n ic a te w ith S AP N e t W e a v e r PI i n s t e a d o f w i t h a n o t h e r b a c k e n d s y s t e m . F o r ID o c d e v e l o p e r s , t h i s m e a n s t h a t a c tu a l ly n o t h i n g n e e d s t o b e d o n e — n ic e , r i g h t ? B u t it's i m p o r t a n t to k n o w w h a t h a p p e n s in SA P N e t W e a v e r PI so th is ru le c a n b e fo llo w ed . A s y o u ' v e l e a r n e d in t h e c o u r s e o f t h i s b o o k , ID o c s w o r k w i t h logical

B u s in e s s s y s te m s

s y s t e m s o r w i t h p a r t n e r r o l e s . In SAP N e t W e a v e r PI, y o u w o r k w i t h

in SAP N e t W e a v e r

b u sin ess sy ste m s th a t a p p ro x im a te ly hav e th e s a m e m e a n in g . O n e d if­

PI

f e r e n c e , h o w e v e r , is t h a t w h i l e p a r t n e r s a n d lo g ic a l s y s t e m s a r e lim i t e d to 1 0 c h a r a c t e r s , b u s i n e s s s y s t e m s c a n h a v e a l e n g t h o f 2 5 6 c h a r a c te r s . I n SAP N e t W e a v e r PI, a c o n v e r s i o n f r o m t h e lo g ic a l s y s t e m t o t h e b u s i ­ n e s s s y s t e m a n d v ic e v e r s a o c c u r s . T h e f o l l o w i n g s e c t i o n s d e s c r i b e th e c o n v e rsio n o p tio n s.

8.1

C o n v e rsio n o f Lo g ical S yste m s to B u sin e ss S yste m s

In t h e S N D P O R field o f t h e c o n t r o l r e c o r d o f a n ID oc, SAP s y s t e m s a lw a y s

" S N D P O R " f ie ld in

s e n d t h e c o m b i n a t i o n o f SAP, f o r e x a m p l e , SAPJOO f o r a n SA P s y s ­

SAP syste m s

t e m t h a t is c a ll e d J 0 0 . In t h e M A N D T field, y o u t h e n h a v e t h e c l i e n t f r o m w h i c h t h e ID o c w a s g e n e r a t e d .

243

8

|

ID o c s in C o n ju n c tio n w ith S A P N e tW e a v e r P ro cess In te g ratio n

SLD

In t h e SLD (System L andscape D irectory) o f SAP N e t W e a v e r PI, y o u in itially r e g i s t e r t h e SAP s y s t e m s a s a t e c h n i c a l s y s t e m w i t h t h e i r s y s t e m ID , o r t h e y a r e c r e a t e d m a n u a l l y . All a v a il a b le c l i e n t s a r e k n o w n t h e n , a n d t h e l o g ic a l s y s t e m n a m e f r o m t h e c l i e n t m a n a g e m e n t is a d o p t e d o r m a i n ­ t a i n e d f o r a ll c lie n ts .

R eference t o th e

W h e n y o u cre a te a b u s in e s s s y s te m , y o u t h e n re fe re n c e ex a ctly o n e

lo g ic a l s y s te m

c l i e n t s o t h a t t h e logical s y s t e m n a m e is a u t o m a t i c a l l y d e t e r m i n e d f o r e a c h b u s i n e s s s y s t e m . I f a n I D o c is r e c e i v e d , y o u u s e t h e s y s t e m ID f r o m S N D P O R t o d e t e r m i n e t h e SAP s y s t e m a n d t h e c l i e n t t o d e t e r m i n e t h e b u s i n e s s s y s t e m . T h i s c l i e n t is t h e n u s e d a s t h e s e n d e r f o r f u r t h e r p rocessing . T h e S N D P R N field f o r t h e n a m e o f t h e logical s y s t e m , w h i c h a ls o e x is ts i n t h e s e n d i n g s y s t e m , i s n 't c o n s i d e r e d . I f t h e s e n d i n g s y s t e m i s n ’t a n SAP s y s t e m , t h e v a l u e is r e a d f r o m t h e S N D P O R fie ld , t o o . In t h i s c a s e , a n a m e t h a t m a t c h e s S N D P O R is s e a r c h e d a m o n g t h e logical s y s t e m n a m e s t h a t a r c a s s i g n e d to t h e b u s i n e s s s y s t e m s , a n d t h e n t h e a s s o c i a t e d b u s i ­ n e s s s y s t e m is u s e d . T h i s m e a n s t h a t n o n - S A P p a r t n e r s m u s t p o s s i b l y p r e p a r e y o u r ID ocs d i f f e r e n t l y i f t h e y a r e p r o c e s s e d v ia SAP N e t W e a v e r PI. I f t h e s e n d i n g is d i r e c t l y to a n SAP s y s t e m , t h e S N D P R N field w o u l d b e r e le v a n t . Ideally, y o u r p a r t n e r s e n d s t h e s a m e n a m e in b o t h field s. F o r ID o c s t h a t le a v e SAP N e t W e a v e r PI, t h e S N D P R N field is p o p u l a t e d a c c o r d i n g to t h e p a r t ­ n e r 's re q u ire m e n ts .

8.2

C o n v e rsio n of ID o c P artn e r Roles

P a rtie s in SAP

I f y o u d o n ' t c o m m u n i c a t e w i t h a logical s y s t e m b u t w i t h a p a r t y o u t s i d e

N e t W e a v e r PI

y o u r e n te rp rise, fo r ex a m p le, w ith a c u sto m e r o r a v en d o r, th e s e n d e r a n d r e c e i v e r d a t a in t h e ID o c is a l s o c o n v e r t e d i n t o t h e p a r t i e s o f SAP N e t W e a v e r PI. T h i s is d o n e u s i n g t h e P a rty o b j e c t t h a t is a v a il a b le t h e r e (see F ig u r e 8.1 ).

P a rtn e r c o n v e rs io n

T h e a g e n c y is s p e c i f i e d a s h ttp : //s a p .c o m /x i/X I f o r t h e a c tu a l n a m e in SAP N e t W e a v e r PI. F o r E D I c o n v e r s i o n s i t ’s s p e c i f i e d w i t h t h e v a l u e s " 0 1 6 " a n d " 0 0 9 " a n d can b e se lec ted as su ch . F o r o t h e r v alues, y o u can

244

H e a d e r M a p p in g

|

a s s ig n t h e a g e n c y itself. I f a n ID o c is r e c e i v e d , t h e v a l u e f o r t h e s c h e m e is A L E # < p a r t n e r t y p e > # p a r t n e r r o l e > .

Edit P a rty Party

Status

In Process

Sabine

Description Comm unication Com ponents

as

Com m unication Channels

Agency *

Schem e*

Nam e'

rttpH sapcorrVciM

XIParty

Sabine 012345678901

>09

OLN

016

DUNS

123 456789

ALE

A LE*LS

LOGSYS

EDI

ALE#LI#LF

Vendornum

F ig u re

8.1

P a r t ie s i n S A P N e t W e a v e r PI

So f o r a lo g ic a l s y s t e m as t h e s e n d e r , "ALEtfLS" is s p e c if ie d in t h e S c h e m e field b e c a u s e n o p a r t n e r r o l e s a r e k n o w n t h e r e , a n d t h e N a m e field i n c l u d e s t h e lo g ic a l s y s t e m n a m e . I f y o u h a v e a v e n d o r in t h e r o l e o f t h e v e n d o r , "A LE#LI#LF" is e n t e r e d in t h e S c h e m e field, a n d t h e SAP v e n d o r n u m b e r f r o m T r a n s a c t i o n W E 2 0 is i n t h e N a m e fie ld . SA P N e t W e a v e r PI t h e n c o n v e r t s i t i n t o t h e SA P N e t W e a v e r P i-sp ecific p a r t n e r n u m b e r , in t h i s c a s e , "SABINE."

8.3

H e a d e r M a p p in g

In t h e o u t b o u n d p r o c e s s i n g , t h e ID o c a d a p t e r r e q u i r e s a c o m m u n i c a t i o n

C o m m u n ic a tio n

c h a n n e l , w h i c h is c a ll e d a receiver co m m u n ica tio n channel. T h e n a m i n g is

channel

f r o m t h e b u s i n e s s s y s t e m p e r s p e c t i v e a n d n o t f r o m t h e SAP N e t W e a v e r PI p e r s p e c t i v e w i t h r e g a r d to t h e d i r e c t i o n s . T h e c o m m u n i c a t i o n c h a n ­ n e l k n o w s h o w i t c a n r e a c h t h e r e c e i v e r o f t h e ID oc. A r e c e i v e r a g r e e ­ m e n t s p e c if ie s w h i c h c o m m u n i c a t i o n c h a n n e l is s u p p o s e d to b e u s e d f o r w h ic h m e ssa g e ty p e. In th e re ceiv er a g re e m e n t, y o u n o w hav e the o p tio n to h a v e th e system

R e ce ive r

p e r f o r m a header m a p p in g . F o r th i s p u r p o s e , a v a l u e f r o m SAP N e t W e a v e r

a g re e m e nt

PI is s p e c if ie d f o r t h e s e n d e r o r r e c e i v e r c o m p o n e n t s o r f o r p a r t n e r o r c o m m u n i c a t i o n c o m p o n e n t s . I n t h i s e x a m p l e (s e e F ig u r e 8 .2 ), t h i s w a s c o n v e r t e d f o r t h e t w o c o m m u n i c a t i o n c o m p o n e n t s . SAP N e t W e a v e r PI

245

8 .3

8

|

ID o c s in C o n ju n c tio n w ith S A P N e tW e a v e r P ro cess In te g ratio n

t h e n s e a r c h e s t h e a p p r o p r i a t e logical s y s t e m i n s t e a d o f t h e a c tu a l s e n d e r o r r e c e i v e r a n d w r i t e s i t t o t h e c o n t r o l r e c o r d o f t h e ID oc.

H e a d e r M apping D

S e n d e r C o m m u n ic a tio n Party

0

S e n d e r C o m m u n ic a tio n C o m p o n e n t

□

R e c e iv e r C o m m u n ic a tio n Party

0

R e c e iv e r C o m m u n ic a tio n C o m p o n e n t

F ig u re

xPath

8.2

O H ntegratio n _S erve r

r > ] [ >

Training

g g

H e a d e r M a p p i n g in t h e R e c e iv e r A g r e e m e n t

W h e n y o u c lick o n A d v a n c e d d u r i n g e d i t i n g , i n s t e a d o f a p r e d e f i n e d s e n d e r f r o m t h e SLD, y o u c a n s p e c i f y a n xP a th t h a t p o i n t s t o a sp ec ific fie ld in t h e p a y l o a d . T h e n , y o u m u s t a ls o s p e c i f y in t h e a s s o c i a t e d c o m ­ m u n i c a t i o n c h a n n e l h o w t h i s fie ld is s u p p o s e d t o b e s e n t . T h e s y n t a x c o r r e s p o n d s to t h e p a r t y d e f i n i t i o n . F ig u r e 8 .3 s h o w s a n e x a m p l e .

' V E d it C o m m u n ic a tio n C h a n n e l C o m m u n ic a tio n C h a n n e l

S ta tu s

In P ro c e s s

d o c .R e c e iv e r

Party C o m m u n ic a tio n C o m p o n e n t

Trainin g

D escrip tion P a ra m e te rs

M o d u le

Sender Agency

ALE

3

Schem a

A L E #LS

ale

5j|

Schem a

A L E #LS

R e c e iv e r Agency

F ig u re

8 .4

8 .3

S u ita b le Id e n tifie r s in t h e x P a th V a ria n t

H a n d lin g th e C o n tro l Record in S A P N e tW e a v e r PI

Control record in

I n SAP N e t W e a v e r PI, y o u c a n p r o c e s s t h e c o n t r o l r e c o r d in t h e m a p -

mapping

p i n g y o u r s e l f o r h a v e i t c r e a t e d b y SAP N e t W e a v e r PI. In m a p p i n g , y o u c a n la b e l t h e c o r r e s p o n d i n g n o d e a s i r r e l e v a n t f o r m a p p i n g (s e c F ig ure 8.4).

246

H a n d lin g th e C o n tro l R eco rd in S A P N e tW e a v e r PI

|

8 .4

E v e n i f t h e c o r r e s p o n d i n g n o d e is a m a n d a t o r y s e g m e n t o r c o n t a i n s

D e a c tiv a tin g nodes

m a n d a t o r y fie ld s , t h e m a p p i n g c a n n o w b e a c t i v a t e d w i t h o u t h a v i n g

in t h e m a p p in g

i m p l e m e n t e d a n a s s i g n m e n t . T h e c r o s s e d - t h r o u g h n o d e is d i s p l a y e d in g r e e n s o t h a t i t ’s a p p a r e n t t h a t e v e r y t h i n g is o k a y h e r e .

Q

ID o c O R D E R S O R D E R S Q 5

tzmi □ Miracs iive Structure

O ccu rren ces

M O R D ER S05

- M io o c

Type

1 .1 1 .1

O R D E R S .O R D E R S O 5

req u ired

* s d siring

N ED LD C 40

1 .1

E D L D C 4 0 O R D E R S .0 R D E R S 0 5

[ •]E 1 E D K 0 1

1 .1

O R D E R S 0 5 E 1 E D K 01

0 .1 2

O RDERS05 E l ED K 14

► M E1ED K 04

0 .1 0

O R D E R S 05 E l ED K04

► (« ]E 1 E D K 0 5

0 ..1 6

O R D E R S 0 5 .E 1E D K 0 6

► W E1EO K A1

0 99

O R D E R S 0 5 E l EDKA1

► M E1ED K 02

0 ..1 0

O R D E R S 0 5 .E 1 E D K 0 2

► M E 1 E D K I7

0 .4

O R DERS05 E l ED K 17

» W E 1 E O K I8

0 3

O R D E R S 05 E1EDK 18

► W E1EO K 35

0 99999

O R D E R S 05 E l ED K35

► M E1ED K 36

0 99

O R D E R S 05 E l ED K36

► I^JE IE O V C TI

0 99

O R D E R S 0 5 E 1E D K T1

► M E IE O P O I

0 .9 9 9 9 9 9

O R D E R S 0 5 E l ED P01

B E G IN

► W E 1 E D K I4

O R D E R S 05 E1ED K 03

► M E1ED K 03

► M E1C U C FO

0 99999

O R D E R S 0 5 .E 1 C U C F O

► (* ] E 1 E O L 3 7

0 999999

O RDERS05 E l ED L37

► W E1EDS01

0 .5

O R D E R S Q 5 E1EDS01

F ig u re

8 .4

Ig n o r in g t h e C o n tr o l R ecord in t h e M a p p i n g

You c a n a ls o m a k e s o m e s e t t i n g s in t h e r e c e i v e r c o m m u n i c a t i o n c h a n n e l

S e ttin g s in

( s e e F ig u r e 8 . 5 ) . F o r e x a m p l e , i f y o u w a n t t o u s e t h e ID o c s e r ia li z a t io n

th e ID o c

v i a qR FC , w h i c h h a s n o t b e e n a v a il a b le u n t i l SA P N e t W e a v e r 6 . 4 0 , y o u c a n s e t t h e Q u e u e P ro c e s s i n g flag. T h e t a r g e t s y s t e m t h e n calls t h e I D0C_ I NB0UND_I N_0UEUE f u n c t i o n m o d u l e i n s t e a d o f t h e IDOC_INBOUND_ASYNCHRONOUS f u n c t i o n m o d u l e .

O

Q u e u e Pro c e s s in g

□

Apply C o n tro l R e c o rd V a lu e s fro m Payload

□

T a k e S e n d e r fro m Payload

□

T a k e R e c e iv e r fro m Payload

□

R e s to re O rig in al P a rlie s fo r A c kn o w led g m en ts

F ig u re

8 .5

ID o c R e ce ive r C o m m u n ic a t io n C hannel

247

c o m m u n ic a tio n channel

8

|

ID o c s in C o n ju n c tio n w ith S A P N e tW e a v e r P ro cess In te g ratio n

C o n tro l record

You s e t t h e A p p l y C o n t r o l R e c o r d V a lu e s f r o m P a y l o a d flag i f y o u p o p u ­

f r o m p a y lo a d

la te t h e c o n t r o l r e c o r d in m a p p i n g y o u r s e l f . I f y o u d o n ' t p o p u l a t e t h e c o n t r o l r e c o r d in m a p p i n g a t all (as i n t h e p r e v i o u s e x a m p l e w i t h t h e c r o s s e d - t h r o u g h c o n t r o l r e c o r d ) , t h i s flag m u s t n e v e r b e s e t . H o w e v e r , i f y o u w a n t t o u s e p a r t s o f t h e p a y l o a d t o d e t e r m i n e t h e p a r ty , y o u m u s t s e t t h i s flag, a n d t h e c o n t r o l r e c o r d m u s t b e p o p u l a t e d a c c o r d i n g l y in m ap p in g . In stea d o f a c o n v e rs io n o f th e s e n d e r s a n d receiv ers, y o u c a n ta k e th e m d i r e c t l y f r o m p a y l o a d i f t h e c o r r e s p o n d i n g flag s a r c s e t . O f c o u r s e , th is s a v e s t i m e b e c a u s e t h e c o n v e r s i o n o f a n I D o c i n t o X M I. is t i m e - c o n s u m ­ ing. Finally, y o u c a n a ls o r e s t o r e t h e o r i g i n a l p a r ti e s f o r s e n d i n g a c k n o w l ­ e d g m e n t s i n s t e a d o f c o n v e r t i n g t h e m in SAP N e t W e a v e r PI.

8.5

U p d a tin g ID o c s D ire c tly in S A P N e tW e a v e r PI

S A P N e t W e a v e r PI

I f y o u w a n t to s e n d a n ID o c d i r e c t l y to SAP N e t W e a v e r PI a n d i f it's s u p ­

as t h e a c t u a l

p o s e d to b e u p d a t e d in t h e local d a t a b a s e , t h a t is, i f SAP N e t W e a v e r PI is

ID o c re c e iv e r

t h e a c tu a l d a t a r e c e i v e r a n d d o e s n ' t j u s t a s s u m e t h e ty p ic a l m e d i a t o r role, y o u c a n u s e t h e IDXIDOCINB t a b l e . All ID o c s t h a t a r e e n t e r e d in t h i s tab le a r e u p d a t e d b y SAP N e t W e a v e r PI i t s e l f i n s t e a d o f f o r w a r d i n g t h e m . You c a n i n s e r t ID o c s u s i n g t h e IDX_SELECT_IDOCTYP_WITHOUT_IS r e p o r t . You c a n r e m o v e a l r e a d y - e n t e r e d I D o c s u s i n g IDX_DELETE_IDOCTYP_ WITHOUT_IS.

8 .6

S u m m a ry

T his c h a p te r h a s d e s c r ib e d w h a t y o u h a v e to c o n s id e r w h e n y o u u se ID o c s in SAP N e t W e a v e r PI, a n d w h i c h s e t t i n g s f a c ilita te y o u r w o r k . H a v in g ID o c i n t e r f a c e s a l r e a d y in all SAP R e le a se s a s w e ll as t h e s t r u c t u r e o f ID o c s w h e r e c o n t r o l i n f o r m a t i o n is p a r t o f t h e m e s s a g e i t s e l f l e a d to s o m e s p e c ia l ID o c f u n c t i o n a l i t y i n s i d e o f SAP N e t W e a v e r PI.

The Author S a b i n e M a i s e l h a s w o r k e d a s a n SAP c o n s u l t a n t s i n c e 1 9 9 6 , h a v i n g g a i n e d h e r in itia l SAP R /3 e x p e ­ r i e n c e a s a n e m p l o y e e o f a b e t a c u s t o m e r o f SAP. S h e a ls o h o l d s t r a i n i n g c o u r s e s f o r SAP in S w i tz e r ­ la n d a n d G e r m a n y o n all a s p e c t s o f SA P N e t W e a v e r i n t e r f a c e t e c h n o l o g i e s a n d t h e SAP Basis. In a d d i ­ t io n , S a b i n e h a s u n d e r t a k e n d e v e l o p m e n t w o r k f o r t h e A FS (A p p a r e l a n d F o o tw e a r S o lu tio n ) i n d u s t r y s o l u t i o n a n d s u p p o r t w o r k f o r c u s t o m e r p r o je c ts . H e r s p e c i a l i z a t i o n s a r e i n t e r f a c e t e c h n o l o g i e s , SAP N e t W e a v e r PI/XI, ABAP d e v e lo p m e n t, a n d w a re h o u s e m a n a g e m e n t.

249

Index B A P I, 1 8 , 4 7

A

relea se, 19 A B A P L i s t V i e w e r - * A I.V . 1 3 4

B A P IJ D O C J N P U T l, 4 7

A c k n o w le d g m e n t, 187

B A P IJ D O C J N P U T P , 47

Agency, 244

B A P IR E T M , 174

A g e n t a s s ig n m e n t, 1 8 4

BA P IR E TS , 1 7 4

A L E , 15

B A P I_ T R A N S A C T IO N _ C O M M IT , 19

b u s in e s s p ro c e ss, 1 5 ,

18

B A P I_ T R A N S A C T IO N _ R O U .B A C K , 19

c o m m u n ic a tio n la yer, 3 5

BA PP, 4 7

C u s to m iz in g

B a s ic t y p e , 1 2 6

- >

S A L E , 31

sc e n a rio , 1 5 , 1 8

BD10, 40

service, 4 5 , 7 3 , 8 4 , 1 3 4

BD40, 195

A L E 0 0 0 0 1 ,119

BD41, 196

ALEAUD. 187, 230

BD42, 197

A L E in te rfa c e

BD43, 197

f o r B A P I, 1 7 3

BD44, 194

f o r f u n c t i o n m o d u le s, 1 7 4

BD51, 168

A L E _ M O D E L _ D E T E R M IN E _ IF _ TO _

B D 5 2 , 32

S E N D , 155

BD53, 38, 4 0

ALE _P R O C E S S IN G , 50

B D 5 4 , 25

ALEREQ 01, 42

BD55, 84

A L E _S E R IA L_ K E Y 2 C H A N N E L, 2 0 0

BD56, 77

ALV, 231

BD 57, 198, 199

A N S I ASC X 1 2 . 27

BD58, 89

A P I (A p p lic a tio n P ro g ra m m in g

B D 5 9 , 74

In te rfa ce ). 1 8

B D 6 0 , 3 4, 36 , 6 9 , 7 0 , 1 35, 151

A p p lic a tio n , 43

BD64, 2 6 ,4 1 ,6 7

A p p lic a tio n a c k n o w le d g m e n t, 187

BD65, 37

A p p l i c a t i o n L in k E n a b lin g - » A L E , 15

B D 66 , 3 4

A p p lic a t io n re c o rd , 21

B D 68 , 7 2

A r c h iv in g o b jc c t, 2 2 5

B D 7 9 , 81

A s y n c h r o n o u s in t c r f a c c , 17

BD87

a _ t_ c o m p le x _ m a tn r, 1 3 5

BD95, 73, 198

-*

ID o c -M o n ito r, 24

BD 97, 48 B D 1 0 0 ;B D 9 7 a , 2 0 2 , 2 0 4

B

B D l0 1 ;B D 9 7 b , 202

B A d I , 91

B D 1 0 3 ;B D 9 7 d , 20 5

B D 1 0 2 ;B D 9 7 c. 2 0 4

cla ssic, 1 0 3

B D 1 0 4 ;B D 9 7 e , 2 0 0

im p le m e n tin g cla ss, 1 1 3

B D 1 0 5 ;B D 9 7 f, 2 0 0

in te r fa c e , 9 1 , 1 1 3

BDA4, 176

n ew ,

110

BDBG, 24, 47, 173, 174

251

Index

BDCP, 3 6

C M O D , 94

BDCP2, 36

C O M M IT . 92

B D C P _ B E F O R E _ W R IT E , 121

C o m m u n ic a t io n c h a n n e l, 2 4 5

BDCPS, 3 6

C o m p a n y c o d e , c ro s s -s y s te m , 85

BDFG, 174

CONDENSE, 153. 157

BDSF.R, 1 9 8

C o n d it io n t e c h n iq u e . 43

BF01. 100

C o n v e r s io n e x it, 83

BF05. 1 0 0

C O N V F .R S IO N _ F X IT _ A I.P H A _ O U T P U T .

B in d in g . 181

83

BO M M AT, 200

C o n v e rs io n ro u tin e , 83

BOR. 18. 168

C r o s s - s y s t e m b u s i n e s s a re a , 8 5

B re a k p o in t,

110

C ro ss-syste m c o m p a n y co d e , 8 5

BTE, 9 0

C u s to m e r

d is tr i b u ti o n m o d e l, 2 6 , 6 7

BU S 1001006, 168 B u s i n e s s A d d - I n - ♦ B A d l . 91

m a n a g e m e n t o b je c t, 1 0 1

B u sin e ss A p p l i c a t i o n P r o g r a m m i n g

p r o je c t, 9 5

In te rfa c e

-*

s e g m e n t, 1 2 2

B A P I, 1 8

B u sin e ss O b je c t R e p o s it o r y - » B O R , 1 8

C u s to m e r e x it, 9 0 , 93

B u sin e ss o b je c t ty p e . 18 B u s in e s s -re la te d e rr o r ,

20

B u sin e ss s y s te m . 2 4 3

D

B u sin e ss tr a n s a c tio n e v e n t - » BTE, 9 0 B u sin e ss w o r k f l o w , 18

D a ta c h a n n e l re g is try , 2 0 4 D a ta D ic tio n a iy - * D D IC , 124 D a ta reco rd ,

c

21

D a ta Source, 22 8 D a te fie ld , 15 3

C A LI. C U S T O M E R - F U N C T IO N , 9 3

D D IC , 124

C file . 2 3

D e b u g g in g . 55

Change d o c u m e n t, 30

D e c im a l n u m b e r , 153

C H A N G E D O C U M E N T .C L O S E , 30

D e s c rip tio n

C H A N G E D O C U M E N T . O P E N , 30

s e m a n tic ,

C h a n g e p o i n t e r , 31

te c h n ic a l,

a c tiv a te g e n e r a lly , 3 2

16 16

D ia lo g ca ll, 4 8

f o r m e s s a g e ty p e , 3 2

D i s t r i b u t i o n c la s s t y p e , 7 0

f o r r e d u c e d m e s s a g e ty p e s , 4 0

D o c u m e n t n u m ber, 198

C H A N G E _ P O I N T E R S _ C R E A T E , 31

D T D ( D o c u m e n t T ype D e s c rip tio n ), 23

C H A N G E _ P O IN T E R S _ C R E A T E _ L O N G , 31 Channel n u m ber. 200

E

C IM TY P , 9 3 CL02, 72

E D I, 2 6

Class . 71

E D IF A C T . 2 2 . 2 7 . 1 4 4

C la s s ic B A d l , 1 0 3

E D I.P R O C E S S IN G , 44 , 50

C la s s ific a tio n , 6 9 . 72

E D IS , 6 5 , 17 5

C L .E X IT H A N D L E R , 103

E le c tro n ic D a ta In te rc h a n g e - * E D I, 26

252

Index

E n h a n c e m e n t, 91, 95. 1 0 7

G

ch eck, 1 2 9 d y n a m ic , 1 1 8

GDPdU. 224

e x p lic it, 1 0 7

G e n e r a l m e t h o d c a ll, 4 8

im p le m e n t.

108

G e n e ra l ru le , 83

im p le m e n ta tio n , 1 1 1

G e n e ra l task, 1 8 1 , 1 8 4

im p lic it, 1 1 5

G e n era te c o n tr o l re c o rd , 15 8

p a r t n e r p r o file , 1 3 1

G e rm a n P rin c ip le s o n D a ta Access a n d

p o in t , 1 0 7

the E x a m in a tio n o f D ig ita l D o c u m e n ts ,

p r o je c t, 9 0

224

release,

128

G E T 'B A D I, 110

se c tio n , 1 0 7 , 1 0 8

G M P ( G o o d M a n u f a c t u r i n g P r a c t ic e ) ,

s p o t, 9 1 , 1 0 7 , 1 0 8 , 1 1 0

224

s ta tic , 1 1 8 te c h n o lo g y , 6 7 ty p e , 1 2 5 F .O IO ( E q u a l l y O n c e I n O r d e r ) , 2 0 5 E rror

H e ader m a p p in g , 2 4 5

b u sin e s s -r e la te d ,

20

s ta tu s , 1 6 7 te c h n ic a l,

H H e ader record.

21

H e a d e r ta b le , 141

20

H T M L ( H y p e r t e x t M a r k u p Language),

E rro r w o rk flo w , 175, 176

c o n n e c tio n , 1 6 7

23 H T TP (H y p e r te x t T ra n s fe r P ro to c o l), 23

E x it, 9 0 E X IT .S A P L B D 1 1 .0 0 1 , 119 E x te n s ib le M a r k u p L a n g u a g e -» X M L , 23 E x te n s io n , 126

I ID o c , 18

a d a p te r , 2 4 3 a d m in is tr a to r , 1 8 4

F

m o n ito r , 2 4 , 1 6 0 , 1 6 8 r e q u e s t, 41

F etch ID o c , 41

s ta tu s file , 62

F IB F , 101

su p p r e s s , 6 8 , 7 6

F ID C M T , 8 9

tr a c k in g , 2 4

F ile , 2 3

ty p e , 2 2

F IL E , 1 4 0

ID O C A P P L , 176

F ile p o r t . 5 6 . 1 3 8 F ilte r g ro u p ,

ID O C B O M M A T , 2 0 0

68

F ilte r o b je c t, 6 7 ,

ID O C _ D A T E _ T IM E _ G E T , 24

6 8 , 73

ID O C J N B O U N D _ A S Y N C H R O N O U S , 23

F lo a tin g p o in t n u m b e r, 153

ID O C _ IN B O U N D _ IN _ Q U E U E , 205

F u n c tio n m o d u le

ID O C _ I N P U T _ M A T M A S 0 1 , 1 3 3

e v a lu a tio n o f c h a n g e p o in te r s , 3 4

ID O C _ R E D U C T lO N _ F IE L D _ R E D U C E ,

f i l e n a m e g e n e r a tio n , 1 3 8

156

f o r q u eu e nam es, 2 0 6

ID O C R E L , 2 1 1 , 212

te s t, 5 5

ID O C _ S E R IA L IZ A T IO N _ C H E C K , 1 9 9

253

Index

ID O C _ S E R IA L _ P O S T 19 9

m b d c o n w f,

ID X _ D E L E T E _ ID O C T Y P _ W IT H O U T _ IS ,

M essage

16 2

248

code, 4 4

ID X ID O C IN B , 2 4 8

c o n tr o l, 2 9 , 4 3 d e te r m in a tio n , 4 4

ID X _ S E I.E C T _ ID O C T Y P _ W IT H O U T _ IS , 248 Im p o r tin g p a ra m e te r u n iq u e , 165

fu n c tio n , 44 M essage typ e , 2 2 ,1 5 1

red u c ed , 3 7

I n b o u n d in te rfa c e , 15 In fo structu re , 2 2 7

M e ta in fo rm a tio n , 22

In itia l, 153

M e t h o d c a ll, 4 8

IN P U T E R R O R O C C U R R E D , 179

M G V 0 0 0 0 1 , 95

in p u tF in is h e d , 1 7 8 , 181

M G V 0 0 1 0 0 , 100

IN P U T F O R E G R O U N D , 179

M o d ific a tio n , 90

In te rfa c e

M O V E , 81

a sy n c h r o n o u s , 1 7 s y n c h r o n o u s , 16 In te rm e d ia te D o c u m e n t - > ID o c , 18

N

IS O c o d e , 1 4 4 , 1 5 3 I t e m t a b l e , 1 41

NAC E, 43 N a m in g rule, 148

c u s to m e r o b je c t, 4 7

K

o w n o b je c t, 3 9 N e w B A d I, 110

KEY, 3 3

N O _ D A T A character, 3 0

L

o

L in k , 211

0 1 CL. 70

L o g ic a l m essage, 151

O b je c t c h a n n e l s e ria liz a tio n , 2 0 0 , 201

L o g i c a l s y s t e m ( L S ), 2 5

O b je c t Key, 2 1 4 O b je c t services, 2 1 4 OBJTYPE, 212

M

O P E N _ F I_ P E R F O R M _ X X X X X X X X _ E ';O P E N _ F I_ P E R F O R M _

M a n d a t o r y fie ld , 3 7

XXXXXXXX_E, 99

M a n d a to ry s e g m e n t, 1 2 7 , 148

O R D C H G , 22, 198

M a s te r da ta, 29

ORDERS, 22

M A S T E R ID O C _ C R E A T E _ M A T M A S , 93,

O rg a n iz a tio n a l m a n a g e m e n t, 1 8 4

107

O u t b o u n d in te rfa c e , 15

M A S T E R ID O C_CR E A T E _ S M D _

O u tb o u n d p a rtn e r p ro file , 44

M A T M A S , 135

O u tp u t

M A S T E R J D O C _ D IS T R IB U T E , 159 M A T F E T , 2 6 , 41 M ATM AS. 22, 26

254

ty p e , 4 3 O Y E A ,184

Index

R e m o te F u n c t io n C a ll

P

-*

RFC, 1 6

R e q u e s t, 16 P a rtn er, 2 6

R e q u e s t I D o c s , 41

in b o u n d p r o file , 2 4

R e sponse, 16

o u tb o u n d p r o file , 2 4

RFC, 16

p r o file , 4 5 , 7 9

q u e u e d - * qR FC , 2 0 5

ro le, 4 3 , 1 4 5

syn ch ro n o u s

Part y. 2 4 4

- >

tr a n s a c tio n a l

sR F C , 19

- ♦

tR F C , 19

P FTC JN S , 178

R F M (R F C -e n a bled fu n c t io n m o d u le ),

PI - * S A P N e t W e a v e r PI. 1 8 7

18

P o ri m a n a g e m e n t, 138

R O L E ID , 212

Process c o d e , 1 6 8

ROLLBACK, 92

B A P I, 1 7 4

R o o t s e g m e n t, 78 , 79

BAPP, 1 7 4

RSEOUTOO, 5 9 , 1 9 6

P ro c e s s in g la y e r, 6 3

RSNAST00, 4 4 , 58

Process I n t e g r a t io n - » S A P N e t W e a v e r

RSRLDREL, 215

PI, 1 8 7

R u le , 6 7 , 8 0

g e n e ra l, 8 3

P r o c e s s i n t e r f a c e , 91 P ro p o s a l f o r ru le , 81 P ro x y in te rfa c e , 16 P/S i n t e r f a c e , 9 1

s

P u b l i s h & S u b s c r i b e - > P /S i n t e r f a c e , 91 S A L E , 2 5 , 31 S a m p le file . 5 6

Q

S A P _ A I.E _E D IQ U E U E , 2 0 6

qRFC, 205

SAP N e t W e a v e r PI, 2 0 5 , 2 4 3

Q u a lifie r, 1 4 4 , 1 4 5

S A P _ ID O C _ 0 0 1 , 2 2 7

ag en cy, 2 4 4

Q u a l i t y o f S e rv ic e , 2 0 5

h e a d e r m a p p in g , 2 4 5

Queue, 209

p a r tn e r ,

Q u e u e d RF C - ♦ q R F C , 2 0 5

26

p a r ty , 2 4 4 SARA. 225 SA RI. 2 2 8

R

SBWP, 1 8 3 S E 1 1 .124

R B D M I D O C , 35

SE18. 103

R B D S F .R 0 1 , 1 9 4 , 1 9 5

SE19. 1 0 3 . 110

RBDSnR02, 196

SE80, 111

RBDSER03, 1 9 7

S E 84. 91

RBDSER04, 197

Segm ent

RBDSRCLR, 199 RDBSTATE, 188

d e fin itio n , 1 2 4 filte r , 76

R e c e iv e r, 2 6

q u a lify in g , 1 4 5

R e c e iv e r c o m m u n ic a t io n c h a n n e l, 2 4 5 ,

relea se, 1 2 5

247

ty p e , 2 3 , 1 2 4

R e d u c e d m essage ty p e , 37 R e le a s e s e c u r i t y , 1 5 , 1 9

v e rsio n , 8 4 S ender, 2 6

255

Index

T e c h n ic a l s y s te m , 2 4 4

S e n d e r fie ld

c o n v e rt, 8 3

T e m p la te s , 4 5

copy, 8 2

Test

SERDAT. 1 9 7

f l a g , 54

S E R IA L, 1 9 8 , 20 3

f u n c t i o n m o d u le , 5 5 tr a n s a c tio n , 51

S e ria liz a tio n , 193

b u s in e s s o b je c ts, fla g ,

200

T im e , 153

202

T r a n s a c t i o n a l R F C - » tR E C , 1 9

g ro u p , 193, 194

T ra n s a c tio n data. 2 9

t im e s ta m p , 1 9 8

T ra n s a c tio n s e c u rity , 1 7

S h a r e d M a s t e r D a t a T o o l —> S M D , 2 9

T R A N S ID , 212

S ig n a tu re , 1 5 4

T ra n s m is s io n m e d iu m 6 , 4 3 , 44

in b o u n d f u n c t i o n m o d u le ,

162

T ra n s m is s io n m e d iu m A , 4 3 , 5 0

SLD, 244

T r a n s p o r t ID o c , 23

S M 5 9 , 102

tREC, 1 9

S M D , 29 SNDPOR, 243 SNDPRN, 244

u

SOAP, 16 S p e cia l m e t h o d c a ll, 4 8

U N / E D I F A C T - > E D I FACT, 22

sRFC, 1 9

U n ic o d e . 5 6

SR R E LR O I.E S , 211

U N I T _ 0 F _ M E A S U RE J S 0 _ T 0 _ S A P, 1 6 5

S ta n d a rd in b o u n d p ro c e s s in g , 5 4

U N IT _ O F _ M E A S U R E _ S A P _ T O _ IS O , 157

S ta n d a rd in te rfa c e , 15

U p d a te te c h n iq u e , 19

S ta n d a rd o u t b o u n d p ro c e s s in g , 5 7 S ta n d a r d task. 1 7 8 S tatus 4 2 < n o r m a l > , 5 7 S ta lu s 5 3 < n o r m a l> , 1 8 8

V

S tatus 6 6 , 2 0 4

V e rs io n c o n v e rs io n , 84 , 119

S tatus 6 8 < n o r m a l > , 1 8 8

V ie w . 77

S tatus 7 4 < n o r m a l> . 61 STATUS ID o c , 62, 1 9 0 S tatus r e c o rd , 21 Success s ta tu s, 1 6 7 S W 0 1 , 176 S y n c h ro n o u s in te rfa ce , 1 6 S y n c h r o n o u s R F C —> s R F C , 1 9 SY STAT, 6 2 , 2 3 0 S y s t e m L a n d s c a p e D i r e c t o i y —> S L D , 2 4 4 S y s te m n a m e , lo g ic a l, 2 5 S yste m , te c h n ic a l, 2 4 4

w W E 09 . 228 W F .14 , 5 8 W E 16 , 60 W E 17 , 65 W E 1 8 , 63 W E 1 9 , 5 2 , 65 W E 2 0 , 24, 50, 119, 194 W E 21 , 138 W E 24 . 45

T

W E 27 , 45 W E 3 0 , 126, 148

Task, g e n e r a l, 1 8 1 , 1 8 4

W E 31 . 124

T e c h n ic a l e rr o r , 2 0

W E 32 . 78

256

Index

W E 41, 44

W E IN B Q U E U E , 208

W E42, 169

W EN O U N KS, 214

W E 47 , 63. 224

W EOU TQ UEU E. 206

W E 55, 139

W M T O R D , 46

W F .57 , 1 3 3 . 168 W F .60 , 1 5 0 W F . 6 2 , 81

X

W E 8 1 , 151 W E 8 2 , 1 3 6 , 1 51

X M L , 23

W E 8 5 , 205

xP a th . 2 4 6

W E D I , 51

257