You are on page 1of 33

BDC

Intelligroup Asia Private Limited

BATCH DATA COMMUNICATIONS/BATCH INPUT/INBOUND-OUTBOUND

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 1 of 33

BDC
Intelligroup Asia Private Limited

TABLE O CONTENTS

BATCH DATA COMMUNICATIONS/BATCH INPUT/INBOUND-OUTBOUND..............1 TABLE OF CONTENTS....................................................................................................2 Step! for any data tran!fer""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""# Preparation for le$a%y data&a!e"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""# Con'ertin$ le$a%y data to t(e flat file"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""") *ettin$ t(e data into +/,""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""") FILE HANDLING IN SAP..................................................................................................8 Handlin$ of Se-.ential file""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""/ Handlin$ of lo%al file!""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""00 ile! 1it( 2.ltiple re%ord type!""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""03
Updated on - Apr 20, 2004 Created on - Apr 20, 2004 Proprietary & Confidential

Page 2 of 33

BDC
Intelligroup Asia Private Limited

BATCH DATA COMMUNICATION.................................................................................14 A&o.t Data Tran!fer In +/, Sy!te2"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""04 Analy5in$ data fro2 lo%al file""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""0# Analy5in$ tran!a%tion""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""0# De%larin$ internal ta&le"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""0) De%larin$ internal ta&le li6e BDCDATA"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""0) Pop.lation of BDCDATA""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""07 SESSION METHOD........................................................................................................19 BDC8OPEN8*+OUP""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""09 Para2eter! to t(i! f.n%tion are:"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""09 BDC8CLOSE8*+OUP"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""3; So2e additional infor2ation for !e!!ion pro%e!!in$"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""3; CALL TRANSACTION....................................................................................................21 A&o.t CALL T+ANSACTION""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""30 Step! for CALL T+ANSACTION 2et(od""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""33 DIRECT INPUT................................................................................................................24 A&o.t Dire%t Inp.t"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""34 Start t(e pro$ra2 dire%tly""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""34 Startin$ t(e pro$ra2 'ia t(e DI ad2ini!tration tran!a%tion"""""""""""""""""""""""""""""""""""""""""""""""""""34 Co22on &at%( inp.t error!"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""34 RECORDING A BATCH INPUT......................................................................................26 BACKGROUND PROCESSING.....................................................................................27 Need for Ba%6$ro.nd pro%e!!in$""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""37 Co2ponent! of t(e &a%6$ro.nd <o&!"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""3/ Definin$ Ba%6$ro.nd <o&!"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""3/
Updated on - Apr 20, 2004 Created on - Apr 20, 2004 Proprietary & Confidential

Page 3 of 33

BDC
Intelligroup Asia Private Limited

HANDLING OF POP UP SCREEN IN BDC....................................................................29 AN EXAMPLE AN EXAMPLE ITH SESSION METHOD.....................................................................!" ITH CALL TRANSACTION.................................................................!!

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 4 of 33

BDC
Intelligroup Asia Private Limited

ABOUT DATA T+ANS E+ Implementing a new software s stem ta!es ma"or effort# Ne1 i2ple2entation re-.ire! 2o'in$ data fro2 t(e pre!ent !y!te2 i"e"= le$a%y !y!te2 into t(e +, !y!te2" $%e produ&t, &omponents, &ustomers and vendors %ave to 'e availa'le in t%e new s stem# Initial data transfer is t%e pro&ess of populating our (3 data'ase wit% data from our lega& s stem# $o prepare for t%e data transfer t%ere are &ertain tas!s ou need to perform# )irst, understand our *AP s stem to !now w%i&% data needs to 'e transferred, e#g#, ou would not transfer an sales order if ou do not use t%e *ales and distri'ution module# *e&ond, ou need to !now t%e &ontents of e+isting data in our lega& s stem# ,ata transfer program, an effe&tive and effi&ient wa of transferring large amount of data into our new s stem, saves time and resour&es# B.t 2ore i2portantly it en!.re! t(at a%%.rate data i! tran!ferred into +/," T1o !tep! in'ol'ed in data tran!fer are CON>E+SION and SAP DATA T+ANS E+" CON>E+SION= data is &onverted from our lega& s stem into t%e re-uired flat file format# SAP DATA T+ANS E+= data is automati&all entered into t%e *AP s stem# A *AP data transfer program reads t%e prepared data from t%e flat file and moves it into (.3#

Step! for any data tran!fer Preparation for lega& data'ase


$%is is t%e first step of transfer t%oug% not asso&iated wit% *AP, pla s ver important role in data transfer# /efore data is e+tra&ted, delete o'solete data in t%e lega& s stem and fi+ in&onsisten&ies# It is easier t%is wa , t%an doing it during &onversion# $%e two steps involved in t%is are0 Data p.r$in$: /efore transferring data from lega& s stem, delete all t%e old and o'solete data, e#g#0 $o save &onversion time and dis! spa&e, ou ma delete all one-time &ustomers, vendors and all unused materials# Data %lean!in$: $%is pro&ess &orre&ts data in&onsisten&ies and ensures t%e integrit of t%e e+isting data during t%e transfer pro&ess# 1ista!es must 'e fi+ed 'efore t%e transfer#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 2 of 33

BDC
Intelligroup Asia Private Limited

Converting lega& data to t%e flat file


)or t%is se&ond step, *AP provides no spe&ifi& tools# In t%e A/AP.4 development wor!'en&%, write an A/AP.4 program to &onvert a file from our lega& s stem into t%e re-uired flat file stru&ture# Use ot%er programming language to write &onversion program# )or C, C3/3L, ou &an easil download t%e ta'le definition for spe&ifi& flat file stru&ture# Use t%ird part tools, su&% as format editors and &ode generators, w%i&% support mapping and &onversion 'etween different file formats# )or ot%er (,/1* li!e ora&le, * 'ase, 1* a&&ess, ou %ave 45P3($ utilit # / w%i&%, ou &an dire&tl e+port data to flat file#

)iles will 'e dis&ussed in detail in later part of t%e topi&#

6etting t%e data into (.3


$%is step a&tuall transfers data to *AP data'ase# After &onverting t%e data into t%e flat file ou are read to 'egin t%e t%ird step of t%e data transfer# ,ata transfer is an intera&tive pro&ess# 7ou ma often feel li!e ou are ta!ing two steps forward and one step 'a&!# )or e+ample, s%ort steps involved in w%ole pro&ess are as follows0 Convert t%e data from t%e lega& s stem into t%e flat file format# (un t%e data transfer program# C%e&! data for error# Is t%e transfer wor!ing as it was designed8 If not, ad"ust t%e data.&onversion program and start wit% step 1# 6o 'a&! to step one, if ou don9t get t%e desired result#

7ou %ave t%ree different options to enter our data into (.3# Automati&all , wit% *AP standard data transfer programs# Automati&all , ' &reating our own 'ran&% input programs 1anuall , ' entering t%e data via t%e &orresponding online transa&tion#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page : of 33

BDC
Intelligroup Asia Private Limited

A.to2ati% tran!fer 1it( a !tandard data tran!fer pro$ra2


$%is &an 'e done if0 A standard program e+ists for t%e data transfer of a 'usiness o'"e&t in (.3# $%e data is availa'le in ele&troni& form# $%ere is a signifi&ant num'er of re&ords ou want to transfer# $%e &ost of &onverting t%e lega& data into t%e re-uired flat file format is a&&epta'le#

Man.ally tran!ferrin$ &.!ine!! o&<e%t!


7ou s%ould manuall transfer data, if0 7ou %ave no lega& s stem# $%ere is onl small num'er of re&ords to enter# $ranslating lega& data into t%e (.3 stru&ture is more an effort t%an manuall entering t%e data#

U!in$ %.!to2er !pe%ifi% &at%( inp.t to tran!fer &.!ine!! o&<e%t!


Create 'at&% input program to transfer data if0 ;o standard program e+ists to transfer t%e 'usiness o'"e&t in (.3# $%e data is availa'le in ele&troni& form# $%ere is a signifi&ant num'er of re&ords ou want to transfer# $ranslating our lega& data into t%e stru&ture re-uired ' our &ustom program is easier t%an manuall entering data# /at&% input is a standard pro&edure for transferring large amount of data into t%e (.3 s stem# It simulates manual data entr # ,ata &onsisten& is ensured 'e&ause 'at&% input uses all t%e &%e&!s &ondu&ted on t%e normal s&reen# Using 'at&% input is li!e entering t%e data online# Anot%er advantage to 'at&% input is t%at ou do not %ave to &%e&! t%e data in advan&e# /at&% input is a two-step pro&edure# It involves a program t%at &reates t%e 'at&% input session# $%is session is t%e data file t%at in&ludes ever t%ing to 'egin t%e transa&tion and t%e data to 'e entered on t%e appropriate s&reens# $%e data is not et in t%e data'ase ta'les of (.3 appli&ation# $%e se&ond step is to pro&ess t%e session, w%i&% t%en a&tuall transfers t%e data to data'ase ta'le# 7ou &an transfer data dire&tl to data'ase ta'le ' using CALL $(A;*AC$I3; met%od also# Anot%er met%od - ,ire&t Input, is done for %ig% volume of data for t%e standard appli&ation# All t%ese met%ods are dis&ussed in detail in later part of t%e topi&# /asi&all t%ere are two steps involved in an transfer of data from lega& s stem to *AP s stem# - Creation of file and transferring file into *AP s stem - $ransferring data to data'ase file Page < of 33

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

BDC
Intelligroup Asia Private Limited

=%enever, ou &reate flat file following points s%ould 'e &onsidered0 - Provide t%e data in an A*CII.$e+t file format# - >now %ow ea&% line of t%e file is stru&tured# - >now %ow t%e re-uired flat file for t%e 'usiness o'"e&t must 'e stru&tured# - 3n&e our flat file is read , t%e data s%ould 'e transferred into *AP s stem#
ILE HANDLIN* IN SAP

Introd.%tion )iles on appli&ation server are !e-.ential file!" )iles on presentation server . wor!station are lo%al file!" A se-uential file is also &alled a dataset#

Handlin$ of Se-.ential file


$%ree steps are involved in se-uential file %andling 3P4; P(3C4** CL3*4 ?ere pro&essing of file &an 'e (4A,I;6 a file or =(I$I;6 on to a file# OPEN ILE /efore data &an 'e pro&essed, a file needs to 'e opened# After pro&essing file is &losed# Synta?: 3P4; ,A$A*4$ @file nameA )3( B3U$PU$.I;PU$.APP4;,I;6C I; B$45$./I;A(7C 13,4 $%is statement returns *7D*U/(C as 0 for su&&essful opening of file or E, if unsu&&essful# OUTPUT: 3pens t%e file for writing# If t%e dataset alread e+ists, t%is will pla&e t%e &ursor at t%e start of t%e dataset, t%e old &ontents get deleted at t%e end of t%e program or w%en t%e CL3*4 ,A$A*4$ is en&ountered# INPUT: 3pens a file for (4A, and pla&es t%e &ursor at t%e 'eginning of t%e file# O+ APPENDIN*: 3pens t%e file for writing and pla&es t%e &ursor at t%e end of file# If t%e file does not e+ist, it is generated# BINA+@ MODE: $%e (4A, or $(A;*)4( will 'e &%ara&ter wise# 4a&% time Fn99 &%ara&ters are (4A, or transferred# $%e ne+t (4A, or $(A;*)4( will start from t%e ne+t &%ara&ter position and not on t%e ne+t line#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page E of 33

BDC
Intelligroup Asia Private Limited

IN TEAT MODE: $%e (4A, or $(A;*)4( will start at t%e 'eginning of a new line ea&% time# If for (4A,, t%e destination is s%orter t%an t%e sour&e, it gets trun&ated# If destination is longer, t%en it is padded wit% spa&es# ,efaults0 If not%ing is mentioned, t%en defaults are )3( I;PU$ and in /I;A(7 13,4# P+OCESS ILE: Pro&essing a file involves (4A,ing t%e file or =riting on to file $(A;*)4(# T+ANS E+ State2ent Synta?: $(A;*)4( @fieldA $3 @file nameA# @)ieldA &an also 'e a field string . wor! area . ,,IC stru&ture# Ea%( tran!fer !tate2ent 1rite! a !tate2ent to t(e data!et" In &inary 2ode= it 1rite! t(e len$t( of t(e field to t(e data!et" In te?t 2ode= it 1rite! one line to t(e data!et" If t%e file is not alread open, T+ANS E+ trie! to OPEN file O+ OUTPUT BIN BINA+@ MODEC or .!in$ t(e la!t OPEN DATASET !tate2ent for t(i! file" I) )IL4 ?A;,LI;6, T+ANS E+ I* $?4 3;L7 *$A$414;$ =?IC? ,34* ;3$ (4$U(; *7-*U/(C +EAD State2ent Synta?: (4A, ,A$A*4$ @file nameA I;$3 @fieldA# @)ieldA &an also 'e a field string . wor! area . ,,IC stru&ture# Ea%( +EAD 1ill $et one re%ord fro2 t(e data!et" In &inary 2ode it read! t(e len$t( of t(e field and in te?t 2ode it read! ea%( line" CLOSE ILE: $%e program will &lose all se-uential files, w%i&% are open at t%e end of t%e program# ?owever, it is a good programming pra&ti&e to e+pli&itl &lose all t%e datasets t%at were opened# Synta?: CL3*4 ,A$A*4$ @file nameA# *7-*U/(C will 'e set to 0 or E depending on w%et%er t%e CL3*4 is su&&essful or not# DELETE ILE: A dataset &an 'e deleted#
Updated on - Apr 20, 2004 Created on - Apr 20, 2004 Proprietary & Confidential

Page G of 33

BDC
Intelligroup Asia Private Limited

Synta?: ,4L4$4 ,A$A*4$ @file nameA# *7-*U/(C will 'e set to 0 or E depending on w%et%er t%e ,4L4$4 is su&&essful or not# P!e.do lo$i% for pro%e!!in$ t(e !e-.ential file!: or readin$: 3pen dataset for input in a parti&ular mode# *tart ,3 loop# (ead dataset into a field# If (4A, is not su&&essful# 4+it t%e loop# 4ndif# ,o relevant pro&essing for t%at re&ord# 4nd t%e do loop# Close t%e dataset#

or 1ritin$: 3pen dataset for output . Appending in a parti&ular mode# Populate t%e field t%at is to 'e transferred# $(A;*)4( t%e filed to a dataset# Close t%e dataset#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 10 of 33

BDC
Intelligroup Asia Private Limited

Handlin$ of lo%al file!


Introd.%tion )iles on presentation server . wor!station are L3CAL )IL4*# Lo&al files are pro&essed using UPL3A, and ,3=;L3A, fun&tions# $%e lo&al files are 'roug%t into A/AP.4 memor using t%ese fun&tions# Unli!e dataset, all t%e re&ords of t%e file are UPL3A,4, into an internal ta'le in one s%ot# *imilarl , all re&ords are ,3=;L3A,4, in one s%ot from an internal ta'le to a lo&al file# DODNLOAD f.n%tion: Important 45P3($I;6 parameters for t%is fun&tion are0 )ilename H name of t%e lo&al file to w%i&% t%e internal ta'le is to 'e downloaded# )ilet pe H file t pe, default values are A*C, ,A$, /I; 1ode H =rite mode, overwrite IF FJ or append IFA9J Important I1P3($I;6 parameters are0 )ilename H a&tual file name entered $a'les to 'e passed to t%e fun&tion0 ,ataDta' H t%e internal ta'le t%at is to 'e downloaded# *imilar fun&tion &alled =*D,3=;L3A, is used to download t%e information from internal ta'le to lo&al file# $%e onl differen&e 'etween ,3=;L3A, and =*D,3=;L3A, is t%at, ,3=;L3A, does not re-uire t%e F)IL4;A149 and F)IL4$7P49 to 'e e+ported to t%e fun&tionK instead it will as! for t%e same at runtime# ?owever, for =*D,3=;L3A,, t%ese two parameters need to 'e passed#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 11 of 33

BDC
Intelligroup Asia Private Limited

UPLOAD f.n%tion

Upload fun&tion is used to upload t%e lo&al file to internal ta'le into *AP s stem# Parameters passed are similar to ,3=;L3A, fun&tion# )or uploading, ou %ave similar fun&tion &alled =*DUPL3A,#

)iles wit% multiple re&ord t pes


1an times t%e input files will %ave re&ords wit% different stru&tures# In all su&% &ases ea&% re&ord will %ave a field, Iusuall t%e firstJ w%i&% identifies t%e re&ord Ie#g#, F?9 for %eader, F,9 for detail or F19 L F29 et&J# $e+t tile wit% multiple re&ord t pes would 'e as mentioned 'elow0 ?++++ nnnnnnnnn ,aaaaaaaaaa'''''''''&&&&&&&& ,aaaaaaaaaa''''''''''&&&&&&&& ?++++ nnnnnnnnnnn ,aaaaaaaaaa''''''''''&&&&&&&& ,aaaaaaaaaa''''''''''&&&&&&&& Pro%e!!in$ Te?t file 1it( 2.ltiple re%ord type!: $o pro&ess su&% files, it is ne&essar to first read t%e re&ord into a &%ara&ter field t%at is a minimum of t%e lengt%s of t%e different stru&ture in t%e file# If F?9 t pe re&ord is 30 &%ar long Iin&luding t%e re&ord identifierJ and F,9 t pe is 40 long Iin&luding t%e re&ord identifierJ, t%en t%is &%ara&ter field s%ould 'e at least 40 &%ar long# P!e.do lo$i% for pro%e!!in$ t(e !e-.ential file! 1it( 2.ltiple re%ord type! Bte?t 2odeC: 3pen dataset# ,o#, (ead dataset into &%ara&ter field# If s -su'r& ne 0# 4+it# 4ndif# If re&ord id of t%e &%ar field Ior t%e first of fieldJ is F?9 ,o pro&essing for F?9 t pe of re&ords# 4lse# ,o pro&essing for d t pe of re&ords#
Updated on - Apr 20, 2004 Created on - Apr 20, 2004 Proprietary & Confidential

Page 12 of 33

BDC
Intelligroup Asia Private Limited

4ndif# 4nddo# P!e.do lo$i% for pro%e!!in$ t(e lo%al file! 1it( 2.ltiple re%ord type!: =*DUPL3A, into ita'# Loop at ita'# If ita'-re&id is F?9# ,o pro&essing for F?9 t pe re&ord# 4lse# ,o pro&essing for F,9 t pe re&ord# 4ndif# 4ndloop#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 13 of 33

BDC
Intelligroup Asia Private Limited

BATCH DATA COMMUNICATION

A'out ,ata $ransfer In (.3 * stem


=%en a &ompan de&ides to implement t%e *AP (.3 to manage 'usiness-&riti&al data, it usuall does not start from a no-data situation# ;ormall , a *AP (.3 pro"e&t &omes into repla&e or &omplement e+isting appli&ation# In t%e pro&ess of repla&ing &urrent appli&ations and transferring appli&ation data, two situations mig%t o&&ur0 $%e first is w%en appli&ation data to 'e repla&ed is transferred at on&e, and onl on&e# $%e se&ond situation is to transfer data periodi&all from e+ternal s stems to *AP and vi&e versa# $%ere is a period of time w%en information %as to 'e transferred from e+isting appli&ation, to *AP (.3, and often t%is pro&ess will 'e repetitive# $%e *AP s stem offers two primar met%ods for transferring data into *AP s stems# )rom non*AP s stems or lega& s stem# $%ese two met%ods are &olle&tivel &alled M'at&% inputN or M'at&% data &ommuni&ationN# 1# *4**I3; 14$?3, 2# CALL $(A;*AC$I3; 3# ,I(4C$ I;PU$ Advantages offered ' /A$C? I;PU$ met%od0 1# 2# 3# 4# Can pro&ess large data volumes in 'at&%# Can 'e planned and su'mitted in t%e 'a&!ground# ;o manual intera&tion is re-uired w%en data is transferred# ,ata integrit is maintained as w%atever data is transferred to t%e ta'le is t%roug% transa&tion# ?en&e 'at&% input data is su'mitted to all t%e &%e&!s and validations#

$o implement one of t%e supported data transfers, ou must often write t%e program t%at e+ports t%e data from our non-*AP s stem# $%is program, !nown as a Mdata transfer program must map t%e data from t%e e+ternal s stem into t%e data stru&ture re-uired ' t%e *AP 'at&% input program#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 14 of 33

BDC
Intelligroup Asia Private Limited

$%e 'at&% input program must 'uild all of t%e input to e+e&ute t%e *AP transa&tion# $wo main steps are re-uired0 $o 'uild an internal ta'le &ontaining ever s&reen and ever field to 'e filled in during t%e e+e&ution of an *AP transa&tion# $o pass t%e ta'le to *AP for pro&essing#
Prere-.i!ite for Data Tran!fer Pro$ra2

=riting a ,ata $ransfer Program involves following prere-uisites0

Anal Oing data from lo&al file Anal Oing transa&tion


Anal Oing transa&tion involves following steps0 $%e transa&tion &ode, if ou do not alread !now it# =%i&% fields re-uire input i#e#, mandator # =%i&% fields &an ou allow to default to standard values# $%e names, t pes, and lengt%s of t%e fields t%at are used ' a transa&tion# *&reen num'er and ;ame of module pool program 'e%ind a parti&ular transa&tion#

To analy5e a tran!a%tion:0 *tart t%e transa&tion ' menu or ' entering t%e transa&tion &ode in t%e &ommand 'o+# I7ou &an determine t%e transa&tion name ' &%oosing * stem P *tatus#J *tep t%roug% t%e transa&tion, entering t%e data will 'e re-uired for pro&essing our 'at&% input data# 3n ea&% s&reen, note t%e program name and s&reen Id nproJ num'er# Id npro H d n Q pro# , n H s&reen, pro H num'erJ ,ispla t%ese ' &%oosing * stem P *tatus# $%e relevant fields are Program Id nproJ and , npro num'er# If pop-up windows o&&ur during e+e&ution, ou &an get t%e program name and s&reen num'er ' pressing )1 on an field or 'utton on t%e s&reen# $%e te&%ni&al info pop-up s%ows not onl t%e field information 'ut also t%e program and s&reen# )or ea&% field, &%e&! 'o+, and radio 'utton on ea&% s&reen, press )1 I%elpJ and t%en &%oose $e&%ni&al Info# ;ote t%e following information0 - $%e field name for 'at&% input, w%i&% ou9ll find in its own 'o+#
Updated on - Apr 20, 2004 Created on - Apr 20, 2004 Proprietary & Confidential

Page 12 of 33

BDC
Intelligroup Asia Private Limited

$%e lengt% and data t pe of t%e field# 7ou &an displa t%is information ' dou'le &li&!ing on t%e ,ata 4lement field#

)ind out t%e identifi&ation &ode for ea&% fun&tion I'utton or menuJ t%at ou must e+e&ute to pro&ess t%e 'at&%-input data Ior to go to new s&reenJ# Pla&e t%e &ursor on t%e 'utton or menu entr w%ile %olding down t%e left mouse 'utton# $%en press )1# In t%e pop-up window t%at follows, &%oose $e&%ni&al info and note t%e &ode t%at is s%own in t%e )un&tion field# 7ou &an also run an fun&tion t%at is assigned to a fun&tion !e ' wa of t%e fun&tion !e num'er# $o displa t%e list of availa'le fun&tion !e s, &li&! on t%e rig%t mouse 'utton# ;ote t%e !e num'er t%at is assigned to t%e fun&tions ou want to run# 3n&e ou %ave program name, s&reen num'er, field name Is&reen field nameJ, ou &an start writing# ,A$A $(A;*)4( program#

,e&laring internal ta'le


ir!t Inte$ral Ta&le !i2ilar to !tr.%t.re li6e lo%al file"

,e&laring internal ta'le li!e /,C,A$A


$%e data from internal ta'le is not transferred dire&tl to data'ase ta'le, it %as to go t%roug% transa&tion# 7ou need to pass data to parti&ular s&reen and to parti&ular s&reen-field# ,ata is passed to transa&tion in parti&ular format, %en&e t%ere is a need for 'at&% input stru&ture# $%e 'at&% input stru&ture stores t%e data t%at is to 'e entered into *AP s stem and t%e a&tions t%at are ne&essar to pro&ess t%e data# $%e 'at&% input stru&ture is used ' all of t%e 'at&% input met%ods# 7ou &an use t%e same stru&ture for all t pes of 'at&% input, regardless of w%et%er ou are &reating a session in t%e 'at&% input -ueue or using CALL $(A;*AC$I3;# $%is stru&ture is /,C,A$A, w%i&% &an &ontain t%e 'at&% input data for onl a single run of a transa&tion# $%e t pi&al pro&essing loop in a program is as follows0 Create a /,C,A$A stru&ture =rite t%e stru&ture out to a session or pro&ess it wit% CALL $(A;*AC$I3; U*I;6K and t%en Create a /,C,A$A stru&ture for t%e ne+t transa&tion t%at is to 'e pro&essed#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 1: of 33

BDC
Intelligroup Asia Private Limited

=it%in a /,C,A$A stru&ture, organiOe t%e data of s&reens in a transa&tion# 4a&% s&reen t%at is pro&essed in t%e &ourse of a transa&tion must 'e identified wit% a /,C,A$A re&ord# $%is re&ord uses t%e Program, , npro, and , n'egin fields of t%e stru&ture# $%e s&reen identifier re&ord is followed ' a separate /,C,A$A re&ord for ea&% value, to 'e entered into a field# $%ese re&ords use t%e );A1 and )RAL fields of t%e /,C,A$A stru&ture# Ralues to 'e entered in a field &an 'e an of t%e following0 ,ata t%at is entered into s&reen fields# )un&tion &odes t%at are entered into t%e &ommand field# *u&% fun&tion &odes e+e&ute fun&tions in a transa&tion, su&% as *ave or 4nter# $%e BDCDATA stru&ture &ontains t%e following fields0 P+O*+AM: ;ame of module pool program asso&iated wit% t%e s&reen# *et t%is field onl for t%e first re&ord for t%e s&reen# D@NP+O: *&reen ;um'er# *et t%is field onl in t%e first re&ord for t%e s&reen# D@NBE*IN: Indi&ates t%e first re&ord for t%e s&reen# *et t%is field to 5, onl for t%e first re&ord for t%e s&reen# I(eset to F F I'lan!J for all ot%er re&ords#J NAM: )ield ;ame# $%e );A1 field is not &ase-sensitive# >AL: Ralue for t%e field named in );A1# $%e )RAL field is &ase-sensitive# Ralues assigned to t%is field are alwa s padded on t%e rig%t, if t%e are less t%an 132 &%ara&ters# Ralues must 'e in &%ara&ter format#

Tran!ferrin$ data fro2 lo%al file to internal ta&le ,ata is uploaded to internal ta'le ' UPL3A, of =*DUPL3A, fun&tion#

Population of /,C,A$A
)or ea&% re&ord of internal ta'le, ou need to populate Internal ta'le, w%i&% is similar to /,C,A$A stru&ture# All t%ese five initial steps are ne&essar for an t pe of /,C interfa&e# ,A$A $(A;*)4( program &an &all *4**I3; 14$?3, or CALL $(A;*AC$I3;# $%e initial steps for 'ot% t%e met%ods are same#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 1< of 33

BDC
Intelligroup Asia Private Limited

ir!t !tep for &ot( t(e 2et(od! i! to .pload t(e data to internal ta&le" ro2 Internal Ta&le= t(e data i! tran!ferred to data&a!e ta&le &y t1o 1ay! i"e"= Se!!ion 2et(od and Call tran!a%tion"

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 1E of 33

BDC
Intelligroup Asia Private Limited

SESSION METHOD

A&o.t Se!!ion 2et(od


In t%is met%od ou transfer data from internal ta'le to data'ase ta'le t%roug% sessions# In t%is met%od, an A/AP.4 program reads t%e e+ternal data t%at is to 'e entered in t%e *AP * stem and stores t%e data in session# A session stores t%e a&tions t%at are re-uired to enter our data using normal *AP transa&tion i#e#, ,ata is transferred to session w%i&% in turn transfers data to data'ase ta'le# *ession is intermediate step 'etween internal ta'le and data'ase ta'le# ,ata along wit% its a&tion is stored in session i#e#, data for s&reen fields, to w%i&% s&reen it is passed, t%e program name 'e%ind it, and %ow t%e ne+t s&reen is pro&essed# =%en t%e program %as finis%ed generating t%e session, ou &an run t%e session to e+e&ute t%e *AP transa&tions in it# 7ou &an eit%er e+pli&itl start and monitor a session or %ave t%e session run in t%e 'a&!ground pro&essing s stem# Unless session is pro&essed, t%e data is not transferred to data'ase ta'le#

BDC8OPEN8*+OUP
7ou &reate t%e session t%roug% program ' /,CD3P4;D6(3UP fun&tion# Parameters to t%is fun&tion are0 User ;ame0 User name 6roup0 ;ame of t%e session Lo&! ,ate0 $%e date on w%i&% ou want to pro&ess t%e session# >eep0 $%is parameter is passed as F59 w%en ou want to retain session after pro&essing it or F F to delete it after pro&essing#

BDC8INSE+T
$%is fun&tion &reates t%e session L data is transferred to *ession# Parameters to t%is fun&tion are0 $&ode0 $ransa&tion ;ame , nprota'0 /,C ,ata

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 1G of 33

BDC
Intelligroup Asia Private Limited

BDC8CLOSE8*+OUP
$%is fun&tion &loses t%e /,C 6roup# ;o Parameters#

So2e additional infor2ation for !e!!ion pro%e!!in$


=%en t%e session is generated using t%e >44P option wit%in t%e /,CD3P4;D6(3UP, t%e s stem alwa s !eeps t%e sessions in t%e -ueue, w%et%er it %as 'een pro&essed su&&essfull or not# ?owever, if t%e session is pro&essed, ou %ave to delete it manuall # =%en session pro&essing is &ompleted su&&essfull w%ile >44P option was not set, it will 'e removed automati&all from t%e session -ueue# Log is not removed for t%at session# If t%e 'at&%-input session is terminated wit% errors, t%en it appears in t%e list of I;C3((4C$ session and it &an 'e pro&essed again# $o &orre&t in&orre&t session, ou &an anal Oe t%e session# $%e Anal sis fun&tion allows to determine w%i&% s&reen and value %as produ&ed t%e error# If ou find small errors in data, ou &an &orre&t t%em intera&tivel , ot%erwise ou need to modif 'at&% input program, w%i&% %as generated t%e session or man times even t%e data file#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 20 of 33

BDC
Intelligroup Asia Private Limited

CALL T+ANSACTION

A'out CALL $(A;*AC$I3;


A te&%ni-ue similar to *4**I3; met%od, w%ile 'at&% input is a two-step pro&edure, Call $ransa&tion does 'ot% steps online, one after t%e ot%er# In t%is met%od, ou &all a transa&tion from our program ' Call tran!a%tion Et%odeF .!in$ EBDCTABF Mode EA/N/EF Update ES/AF Me!!a$e! into EMS*TABF" Parameter P 1 is transa&tion &ode# Parameter P 2 is name of /,C$A/ ta'le# Parameter P 3 %ere ou are spe&if ing mode in w%i&% ou e+e&ute transa&tion A is all s&reen mode# All t%e s&reen of transa&tion are displa ed# N is no s&reen mode# ;o s&reen is displa ed w%en ou e+e&ute t%e transa&tion# E is error s&reen# 3nl t%ose s&reens are displa ed w%erein ou %ave error re&ord# Parameter P 4 %ere ou are spe&if ing update t pe ' w%i&% data'ase ta'le is updated# S is for * n&%ronous update in w%i&% if ou &%ange data of one ta'le t%en all t%e related $a'les gets updated# And s -su'r& is returned i#e#, s -su'r& is returned for on&e and all# A is for As n&%ronous update# =%en ou &%ange data of one ta'le, t%e s -su'r& is returned# And t%en updating of ot%er affe&ted ta'les ta!es pla&e# *o if s stem fails to update ot%er ta'les, still s -su'r& returned is 0 Ii#e#, w%en first ta'le gets updatedJ# Parameter P 2 w%en ou update data'ase ta'le, operation is eit%er su&&essful or unsu&&essful or operation is su&&essful wit% some warning# $%ese messages are stored in internal ta'le, w%i&% ou spe&if along wit% 14**A64 statement# $%is internal ta'le s%ould 'e de&lared li!e BDCMS*COLL, a stru&ture availa'le in A/AP.4# It &ontains t%e following fields0 1# T%ode: 2# Dyna2e: 3# Dyn.2&: 4# M!$typ: 2# M!$!pra: :# M!$id: <# M!$'N:
Updated on - Apr 20, 2004 Created on - Apr 20, 2004

$ransa&tion &ode /at&% point module name /at&% input , n num'er /at&% input message t pe IA.4.=.I.*J /at&% input Lang, id of message 1essage id 1essage varia'les I; H 1 - 4J
Proprietary & Confidential

Page 21 of 33

BDC
Intelligroup Asia Private Limited

)or ea&% entr , w%i&% is updated in data'ase, ta'le message is availa'le in /,C1*6C3LL# As /,C1*6C3LL is stru&ture, ou need to de&lare a internal ta'le w%i&% &an &ontain multiple re&ords Iunli!e stru&tureJ#

*teps for CALL $(A;*AC$I3; met%od


1# 2# 3# 4# Internal ta'le for t%e data Istru&ture similar to our lo&al fileJ /,C$A/ li!e /,C,A$A UPL3A, or =*DUPL3A, fun&tion to upload t%e data from lo&al file to ita'# IConsidering file is lo&al fileJ Loop at ita'# Populate /,C$A/ ta'le# Call transa&tion @t&odeA using @/,C$A/A 1ode @A.;.4A Update @*.AA# (efres% /,C$A/# 4ndloop# I$o populate /,C$A/, 7ou need to transfer ea&% and ever fieldJ

$%e ma"or differen&es 'etween *ession met%od and Call transa&tion are as follows0 SESSION METHOD Data i! not .pdated in data&a!e ta&le .nle!! Se!!ion i! pro%e!!ed" No !y-!.&r% i! ret.rned" Error lo$ i! %reated for error re%ord!" Updation in data&a!e ta&le i! al1ay! !yn%(rono.! CALL T+ANSACTION I22ediate .pdation in data&a!e ta&le" Sy-!.&r% i! ret.rned" Error! need to &e (andled e?pli%itly Updation in data&a!e ta&le %an &e !yn%(rono.! Or A!yn%(rono.!"

0" 3" ," 4"

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 22 of 33

BDC
Intelligroup Asia Private Limited

Error Handlin$ in CALL T+ANSACTION


=%en *ession 1et%od updates t%e re&ords in data'ase ta'le, error re&ords are stored in t%e log file# In Call transa&tion t%ere is no su&% log file availa'le and error re&ord is lost unless %andled# Usuall ou need to give report of all t%e error re&ords i#e#, re&ords w%i&% are not inserted or updated in t%e data'ase ta'le# $%is &an 'e done ' t%e following met%od0 *teps for t%e error %andling in CALL $(A;*AC$I3; 1# 2# 3# 4# 2# :# Internal ta'le for t%e data Istru&ture similar to our lo&al fileJ /,C$A/ li!e /,C,A$A Internal ta'le /,C1*6 li!e /,C1*6C3LL Internal ta'le similar to Ist internal ta'le I$%ird and fourt% steps are for error %andlingJ UPL3A, or =*DUPL3A, fun&tion to upload t%e data from t%e lo&al file to ita'# IConsidering file is lo&al fileJ Loop at ita'# Populate /,C$A/ ta'le# Call transa&tion @tr#&odeA using @/d&ta'A 1ode @A.;.4A Update @*.AA 1essages @/,C1*6A# Perform &%e&!# (efres% /,C$A/# 4ndloop# )orm &%e&!# I) s -su'r& @A 0# ICall transa&tion returns t%e s -su'r& if updating is not su&&essfulJ# Call fun&tion )ormatDmessage# I$%is fun&tion is &alled to store t%e message given ' s stem and to displa it along wit% re&ordJ Append ita'2# ,ispla t%e re&ord and message#

<

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 23 of 33

BDC
Intelligroup Asia Private Limited

DI+ECT INPUT

A'out ,ire&t Input


In &ontrast to 'at&% input, t%is te&%ni-ue does not &reate sessions, 'ut stores t%e data dire&tl # It does not simulate t%e online transa&tion# $o enter t%e data into t%e &orresponding data'ase ta'les dire&tl , t%e s stem &alls a num'er of fun&tion modules t%at e+e&ute an ne&essar &%e&!s# In &ase of errors, t%e dire&t input te&%ni-ue provides a restart me&%anism# ?owever, to 'e a'le to a&tivate t%e restart me&%anism, dire&t input programs must 'e e+e&uted in t%e 'a&!ground onl # ,ire&t input &%e&!s t%e data t%oroug%l and t%en updates t%e data'ase dire&tl # 7ou &an start a ,ire&t Input program in two wa sK

*tart t%e program dire&tl


$%is is t%e -ui&!est wa to see if t%e program wor!s wit% our flat file# $%is option is possi'le wit% all dire&t input programs# If t%e program ends a'normall , ou will not %ave an logs telling ou w%at %as or %as not 'een posted# $o minimiOe t%e &%an&e of t%is %appening, alwa s use t%e &%e&! file option for t%e first run wit% our flat file# $%is allows ou to dete&t format errors 'efore transfer#

*tarting t%e program via t%e ,I administration transa&tion


$%is transa&tion restarts t%e pro&essing, if t%e data transfer program a'orts# *in&e ,I do&ument are immediatel posted into t%e *AP ,./, t%e restart option prevents t%e dupli&ate do&ument posting t%at o&&urs during a program restart Ii#e#, wit%out ad"usting our flat fileJ# ,ire&t input is usuall done for standard data li!e material master, )I a&&ounting do&ument, *, sales order and Classifi&ation for w%i&% *AP %as provided standard programs# )irst time ou wor! wit% t%e ,ire&t Input administration program, ou will need to do some preparation 'efore ou &an transfer data0 Create variant ,efine "o' *tart "o' (estart "o'

Common 'at&% input errors


$%e 'at&% input /,C,A$A stru&ture tries to assign values to fields w%i&% do not e+ist in t%e &urrent transa&tion s&reen#
Proprietary & Confidential

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Page 24 of 33

BDC
Intelligroup Asia Private Limited

$%e s&reen in t%e /,C,A$A stru&ture does not mat&% t%e rig%t se-uen&e, or an intermediate s&reen is missing# 3n e+&eptional o&&asions, t%e logi& flow of 'at&% input session does not e+a&tl mat&% t%at of manual online pro&essing# $esting t%e sessions online &an dis&over ' t%is# $%e /,C,A$A stru&ture &ontains fields, w%i&% are longer t%an t%e a&tual definition# Aut%oriOation pro'lems#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 22 of 33

BDC
Intelligroup Asia Private Limited

+ECO+DIN* A BATCH INPUT

A / re&ording allows ou to re&ord a (.3 transa&tion and generate a program t%at &ontains all s&reens and field information in t%e re-uired /,C-,A$A format# 7ou &an eit%er use *?,/ transa&tion for re&ording or *7*$41 *4(RIC4* /A$C? I;PU$ 4,I$ And from %ere &li&! re&ording# 4nter name for t%e re&ording# I,ates are optionalJ Cli&! re&ording# 4nter transa&tion &ode# 4nter# Cli&! *ave 'utton# 7ou finall &ome to a s&reen w%ere, ou %ave all t%e information for ea&% s&reen in&luding /,CD3>C3,4# Cli&! 6et $ransa&tion# (eturn to /I# Cli&! overview# Position t%e &ursor on t%e "ust re&orded entr and &li&! generate program# 4nter program name# Cli&! enter

$%e program is generated for t%e parti&ular transa&tion#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 2: of 33

BDC
Intelligroup Asia Private Limited

BACG*+OUND P+OCESSIN*

;eed for /a&!ground pro&essing


=%en a large volume of data is involved, usuall all 'at&% inputs are done in 'a&!ground# $%e (.3 s stem in&ludes fun&tions t%at allow users to wor! non-intera&tivel or offline# $%e 'a&!ground pro&essing s stems %andle t%ese fun&tions# ;on-intera&tivel means t%at instead of e+e&uting t%e A/AP.4 programs and waiting for an answer, user &an su'mit t%ose programs for e+e&ution at a more &onvenient planned time# $%ere are several reasons to su'mit programs for 'a&!ground e+e&ution# $%e ma+imum time allowed for online e+e&ution s%ould not e+&eed 300 se&onds# User gets $I143U$ error and an a'orted transa&tion, if time for e+e&ution e+&eeds 300 se&onds# $o avoid t%ese t pes of error, ou &an su'mit "o's for 'a&!ground pro&essing# 7ou &an use t%e s stem w%ile our program is e+e&uting# $%is does not mean t%at intera&tive or online wor! is not useful# /ot% t pe of pro&essing %ave t%eir own purposes# 3nline wor! is t%e most &ommon one entering 'usiness data, displa ing information, printing small reports, managing t%e s stem and so on# /a&!ground "o's are mainl used for t%e following tas!sK to pro&ess large amount of data, to e+e&ute periodi& "o's wit%out %uman intervention, to run program at a more &onvenient, planned time ot%er t%an during normal wor!ing %ours i#e#, ;ig%ts or wee!ends# $%e transa&tion for 'a&!ground pro&essing is SM,)" 3r Tool! Ad2ini!tration Ho&! Define <o&! 3r Sy!te2 !er'i%e! Ho&!

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 2< of 33

BDC
Intelligroup Asia Private Limited

Co2ponent! of t(e &a%6$ro.nd <o&!


A "o' in /a&!ground pro&essing is a series of steps t%at &an 'e s&%eduled and step is a program for 'a&!ground pro&essing# So' name# ,efine t%e name of assigned to t%e "o'# It identifies t%e "o'# 7ou &an spe&if up to 32 &%ara&ters for t%e name# So' &lass# Indi&ates t%e t pe of 'a&!ground pro&essing priorit assigned to t%e "o'# $%e "o' &lass determines t%e priorit of a "o'# $%e 'a&!ground s stem admits t%ree t pes of "o' &lasses0 A / L C, w%i&% &orrespond to "o' priorit # So' steps# Parameters to 'e passed for t%is s&reen are as follows0 Program name# Rariant if it is report program *tart &riteria for t%e "o'0 3ption availa'le for t%is are as follows0 Immediate - allows ou to start a "o' immediatel # ,ate.$ime - allows ou to start a "o' at a spe&ifi& name# After "o' - ou &an start a "o' after a parti&ular "o'# After event - allows ou to start a "o' after a parti&ular event# At operation mode - allows ou to start a "o' w%en t%e s stem swit&%es to a parti&ular operation mode#

Definin$ Ba%6$ro.nd <o&!


It i! t1o !tep pro%e!!: ir!tly= yo. define t(e <o& and t(en relea!e it" =%en users define a "o' and save it, t%e are a&tuall !%(ed.lin$ t%e report i#e#, spe&if ing t%e "o' &omponents, t%e steps, t%e start time# =%en users s&%edule program for 'a&!ground pro&essing, t%e are instru&ting t%e s stem to e+e&ute an A/AP.4 report or an e+ternal program in t%e 'a&!ground# *&%eduled "o's are not e+e&uted until t%e are released# =%en "o's are released, t%e are sent for e+e&ution to t%e 'a&!ground pro&essing s stem at t%e spe&ified start time# /ot% s&%eduling and releasing of "o's re-uire aut%oriOations#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 2E of 33

BDC
Intelligroup Asia Private Limited

HANDLIN* O POP UP SC+EEN IN BDC

1an times in transa&tion pop up s&reen appears and for t%is s&reen ou don9t pass an re&ord 'ut some indi&ation to s stem telling it to pro&eed furt%er# )or e+ample0 $%e following s&reen

*AR4 ,A$A )I(*$ 74* ;3


CA;C4L

$o %andle su&% s&reen, s stem %as provided a varia'le &alled /,CDCU(*3(# 7ou pass t%is varia'le to /,C,A$A and pro&ess t%e s&reen# Usuall su&% s&reen appears in man transa&tions, in t%is &ase ou are "ust passing information, t%at 74* ou want to save t%e information, t%at means 74* s%ould 'e &li&!ed# *o ou are transferring t%is information to /,C,A$A i#e#, field name of 74* w%i&% is usuall *P3$D3P$I3;# Instead of /,CD3>C3,4, ou are passing /,CDCU(*3(# /,CDCU(*3( is also used to pla&e &ursor on parti&ular field#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 2G of 33

BDC
Intelligroup Asia Private Limited

AN EAAMPLE DITH SESSION METHOD

)ollowing program demonstrates %ow data is passed from flat file to *AP transa&tion and furt%er to data'ase ta'le ' using *4**I3; met%od# $%e transa&tion is $)/A Ito &%ange &ustomerJ# A simple transa&tion w%ere ou are entering &ustomer num'er on first s&reen and on ne+t s&reen data is displa ed for t%e parti&ular &ustomer num'er# )ield, w%i&% we are &%anging %ere, are name and &it # =%en ou &li&! on save, t%e &%anged re&ord gets saved# Prere-uisite to write t%is /,C interfa&e as indi&ated earlier is0 1# $o find s&reen num'er 2# $o find s&reen field names, t pe of t%e field and lengt% of t%e field# 3# $o find /,CD3>C3,4 for ea&% s&reen 4# Create flat file# )lat file &an 'e &reated in our %ard dis! as follows0 1 2 3 Rinod >ris%na >avit%a >is%ore ? dera'ad *e&undera'ad ? dera'ad

I=%ere 1st &%ara&ter field is Customer num'er, 2nd field is Customer name and 3rd field is Cit #J $o transfer t%is data to data'ase ta'le *CU*$31 following interfa&e &an 'e used# (4P3($ ,4131# T )ollowing internal ta'le is to upload flat file# ,A$A0 /46I; 3) I$A/ 3CCU(* 0, I,I10J, ;A14I22J, CI$7I22J, 4;, 3) I$A/# T)ollowing internal ta'le /,C,A$A is to pass date from internal ta'le to session# ,A$A0 /,C$A/ LI>4 /,C,A$A 3CCU(* 0 =I$? ?4A,4( LI;4# T Raria'les ,A$A0 ,A$41 LI>4 *7-,A$U1# ,A$41 H *7-,A$U1 - 1# M $%is is for ?old ,ate T $o upload flat file to internal ta'le# CALL )U;C$I3; UPL3A, 45P3($I;6 )IL4 ;A14 H FC0U))#$5$9 )IL4 $7P4 H FA*CN $A/L4* Updated on - Apr 20, 2004 Proprietary & Confidential Page 30 of 33
Created on - Apr 20, 2004

BDC
Intelligroup Asia Private Limited

,A$AD$A/ H I$A/ 45C4P$I3;* C3;R4(*I3;D4((3( H1 I;RALI,D$A/L4D=I,$? H2 I;RALI,D$7P4 H3 ;3D/A$C? H4 U;>;3=;D4((3( H2 3$?4(* H :# If s -su'r& H 0# T Calling )un&tion to Create a *ession CALL )U;C$I3; F/,CD3P4;D6(3UP9 45P3($I;6 CLI4;$ H *7-1A;,$ 6(3UP H FP3$?U(I9 ?3L,,A$4 H ,A$41 >44P H F59 U*4( H *7-U;A14 45C4P$I3;* CLI4;$DI;RALI, H1 ,4*$I;A$I3;DI;RALI, H2 6(3UPDI;RALI, H3 6(3UPDI*DL3C>4, H4 ?3L,,A$4DI;RALI, H2 I;$4(;ALD4((3( H: VU4U4D4((3( H< (U;;I;6 HE *7*$41DL3C>D4((3( HG U*4(DI;RALI, H 10 3$?4(* H 11# If s -su'r& H 0# T-------------------------- 1AI; Logi&-----------------------------L33P A$ I$A/ P4()3(1 64;4(A$4D,A$A# M Populating /,C,A$A $a'le CALL )U;C$I3; F/,CDI;*4($9 45P3($I;6 $C3,4 H F$)/A9 $A/L4* ,7;P(3$A/ H /,C$A/ 45C4P$I3;* I;$4(;ALD4((3( H1 ;3$D3P4; H2 VU4U4D4((3( H3 $C3,4DI;RALI, H4 P(I;$I;6DI;RALI, H2 P3*$I;6DI;RALI, H : 3$?4(* H <# (4)(4*? /,C$A/ 4;,L33P#
Updated on - Apr 20, 2004 Created on - Apr 20, 2004 Proprietary & Confidential

Page 31 of 33

BDC
Intelligroup Asia Private Limited

I Callin$ f.n%tion to %lo!e t(e !e!!ion CALL )U;C$I3; F/,CDCL3*4D6(3UP9 45C4P$I3;* ;3$D3P4; H1 VU4U4D4((3( H2 3$?4(* H 3# 4ndif# 4ndif# TL--------------------------------------------------------------------T TL )orm 64;4(A$4D,A$A TL--------------------------------------------------------------------T T Create /,C ,ata TL--------------------------------------------------------------------T )3(1 64;4(A$4D,A$A T Passing information for 1st s&reen on /,C,A$A /,C$A/-P(36(A1 H F*AP1$)/A9# /,C$A5-,7;P(3 H 100# /,C$AP-,7;/46I; H F59# APP4;, /C,$A/#CL4A( /,C$A/# T Passing field information to /,C,A$A /,C$A/-);A1 H F*CU*$31-I,9 /,C$A/-)RAL H I$A/-I,# APP4;, /,C$A/#CL4A( /,C$A/# T Passing /,CD3>C3,4 to /,C,A$A /,C$A/-);A1 H F/,CD3>C3,49# /,C$A/-)RAL H F.29# APP4;, /,C$A/#CL4A( /,C$A/# T Passing s&reen information for ne+t s&reen to /,C,A$A /,C$A/-P(36(A1 H F*AP1$)/A9# /,C$A/-,7;P(3 H 200# /,C$A/-,7;/46I; H F59# APP4;, /,C$A/#CL4A( /,C$A/# T Passing s&reen information to /,C,A$A /,C$A/-);A1 H F*CU*$31-;A149# /,C$A/-)RAL H I$A/-;A14# APP4;, /,C$A/#CL4A( /,C$A/# T Passing s&reen information to /,C,A$A /,C$A/-);A1 H F*CU*$31-CI$79# /,C$A/-)RAL H I$A/-CI$7# APP4;, /,C$A/#CL4A( /,C$A/# T Passing /,CD3>C3,4 to /,C,A$A /,C$A/-);A1 H F/,CD3>C3,49# /,C$A/-)RAL H F*AR49# APP4;, /,C$A/#CL4A( /,C$A/# 4;,)3(1# M64;4(A$4D,A$A

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 32 of 33

BDC
Intelligroup Asia Private Limited

AN EAAMPLE DITH CALL T+ANSACTION

*ame steps to 'e repeated for CALL $(A;*AC$I3; $%e onl differen&e 'etween t%e two t pes of interfa&e is in *ession met%od, ou &reate session and store information a'out s&reen and data into session# =%en session is pro&essed t%e data is transferred to data'ase# =%ile in CALL $(A;*AC$I3;, data is transferred dire&tl to data'ase ta'le# (4P3($ ,4131# T )ollow a'ove Code till 1AI; Logi&# 4ven t%e *u'routine s%ould 'e &opied L33P A$ I$A/ P4()3(1 64;4(A$4D,A$A, MPopulating /,C,A$A $a'le Call transa&tion F$)/A9 using /C,,A$A 1ode FA9 Update F*9# (4)(4*? /,C$A/ 4;,L33P#

Updated on - Apr 20, 2004 Created on - Apr 20, 2004

Proprietary & Confidential

Page 33 of 33

You might also like