tath

E hnt'1.'.ttr P! t\t Ot,Li \t^ |

3.

Conlgur the endpont bindings for this scr\,ice rnd savc the concreteWSDL llc-

C,,ts,,z]ir

. a

trPr)(r,rrordeAenl.? rtsouroe; Selecl lhe fnrlp,i"r Btnlrgr uh Seect thc Errlp{)l,rr Nd/r? ()w whcre the intfssProcessordcrEndpoin) cnlf), is, rcli!rtirg rhc ?)rrryolr and .'OAP ,rtdlk ldN tlor rppea. below In rhe 7ialrs/,,7rab. seecr thc qcuc and lerify olhcr endpoinL birdins sctrinss: . JMS l)c\tinarion: USERXX. Procesotalr, Serwice (wilh your E\,IS Scrlcr.unnng. browsr to and sclecl rhis qucuc c.crtcd ir Excrcise 1)
l.rb of rhc

. . .

JMS DestinaLion Typc: Queue (detilur) JMS Messale Typc: Bytes Nlessge (delault)

Acknotlledgcmetrt Modc: Auro (deiauk)

4!91!
jltFc rdr<r&' s{
,.1tr'.g,q|G uws@|fu

l;---l
|fu l! -

tl

:,

lv5D1..l4f(e ub of thc inlF,?c?sodzr r"/rr.c fesourcc:

if Trgct a a

Nxrrcspace:

http: //r,,vl|- ibco. cor/br{p/6erwices/

Proc66aordfcoEcr!e
\rngs and Savc prcjcct

^pplJ concrcLr WSDL iilc tbr clienr u\e: Sve thc Cick Sov WSDL lrowsc to fbldef ondiskClhwpXX\BWP.Corc\Scr!i.cs\OrdefPrccess\Contrrt Filc Nanrc: Poces6OrdrSenice ConcreewsDL Selcct lhr /OrdcrProccsvconaract foldcr and press thc ky FS to Relresh Resourccs nnd veril] thar rhc concrcle WSDL itppcars

1I

lr / //ACr)nrv,L\.W,,(r rr iJl,r",!rirr

'1.

Compler thc conflgut.trit)\ ol

Prute\\lrtt(h0et.

4rrl0!j \r{ r'3}uuhJ\<,1.\.1 ncd rhc P,D.rrcOr.,J tt?-\rr'nI'! Ptn. c$Ba!.hO-1. t ,a no.crL i.. JUnfi!urdliul \u tra. i, Inroke. Ini. ,<r \:'<.

r Seect /ProccssDet-Ln il ion !/OrdcrPfoccss/ProccsslarchO rder c. .l\ ) r DJ.rr( ,(r\ J n f, ,r.,n/r'."llt. r ln ir! plact add and transirion a SOAP Rcqcst leply aoti!iL). configufed a \Jrn.: .Lnvoke P.oces6or<ler Servic a :ier\ icc: /B\\P.c|)rclscrriccs/OdefPfoce!s/Contract/
ProccssorderServicc ConcretewSDL

as li)llows

a r //, a

Tcst rhc lranspofl conrcction (EtvIS SeNer

musL bc

nrnnuS)

.-rlo,(1 \ll I
selcct lhc Ntakc

L P -."o,.1/\'!'i
C

.tr11J

in!LMcssage/Purchalcordcr:

$Parse FO-xMt/PurchaseOrder

opy-of 'PrchaseO.dcr' optir

Click !'inish to colrpLerc c nappng

5.

Vcfit-! rhe desigr of tour upda(ed P/...rJdr.rrorler deiinirion

l.-t-i=.t Ll,o
1/

lBaO tdtt ,1ti rt l't')\1,nr

lab E: lntpLhQat P@ess O.da Sa^,i..

Lab E - Exercise 4: Test Order Processing

Overview
ln rhis cxcrcise you test the P/rce.rro/dr Service implemcntadon using Pro.s$ Batcho submit ordcrs nd vcrify successful processing.

der to

Steps

l.

Validate your prujec and debug any ermrs associarcd wirh your proiecr. Note: Ignore the "talerord e tsrrbscti.ptian XX 'n les iDk' warning and all unassociated errors

2.

Ssrt the following TIBCO componcnts.

. r r

Cditcheckservice deploye/ BW engine using TIBCO Administrator

Solcsordersubscripiionxx adaptr service s;ng thc Dcsigner

Not: Your TIBCO EMS Scrvr should be runnins i$ well.

Ar./r?rdl" Teste

ltilily

tib,imsQunSender using script file CIBVr'EDL\BotchOrder\imsTrigger.bt

BCo sIwa.. tnc.

M BW!:'t tBCO Bu!neswa*st 5.4 tntesraLion

1.

esr

OftlerPtucessing using e Designef tesl utlity.

To view the testng as it progrcsses. place a b.cakpoinr:

Befof e acti!ity /BWP.Core/Seft ices/Ordef Conpute OrderID and Price

Pf ocess/ImplemeLaLion/ProcessOrder/

.l\tg!activity/PrccessDelintions/OrderProccss,?rocessBatchorde/ReceiveDatch

Order

Load AdJ lhe tbllowing processes into rhc Designer

Ter, (ebllll

then select exch):

a a

/BWP.Core/Serviccs/OrdcrProccss/lntcrface/intf ProccssOrder-service /PrccessDelinitions/OrderProcess/ProcessRatchOrder

Verify tesdng:

a a I it

ProcessRd.:ho er should feceive the message off o l e qucuc

Resume testing and PnressBatthorLl sharld Itlvoke Prccetsorder SerNi.e The view should switch io Proce rsorder whcrc thc tcster stops ai the breakpoint

Resune testing and Proczrrorler should conlple|c successllly to end

't

ttsCO E.lucdrion

PrcgrMs

Izh I:: Lntl.ht rt ]'h)krs O,rltr S?\iL.

Vcrily cxlrcctiid resu

t5.

Chcck dirccrory C:\BWEDU\Ordedlesult\ lor rhe Ordcr Rcsult tilcl

lbr each proccsscd ordtr. a uniq(cly nnmed reruf file (O.dcrfD +dmc- lrcslnnp) vltiltc r() rhc 9i%onle rOutpu Diredor\Acq,, tnr cxat]nplc:
id-r),1
cig."

is

*dd, htr

i- @,

e,

x9

:-

pcn this filc: irs contnts should conrrin Lhe fornrdrrd orclcfdclails, fbrcxample

i"ls Bee,tbar.r':= -:n s

t.dlfeG6',rfu*

r I

tlc Adapter Tcsicr Crrrrl? t.rb. vcrily thar dre adaplef servioc fcccivcd lhc pfocessed sole$ ordcr and nscrred the data in lhe drraf,nsr.
s

,,Inserted 1 ros inCo dalabase.' "TrtSEI! iNtO ORDER DETAILA

i-** t idr.6,r

-cceeoed

V B\vl:

TIR( O

lt^int\!\rrrlJ)\1 i I ItneCrdtir

r Verifl thc adaptef service by clrccking c databsc tables fir sales ordcr dalii . Log nto SQL:Plus using a colllnland pfompl:
C:

\>sq1plu6 uerxx/userxx@edusvr
lcrily an cntr] lrr ch ofdcr fron sl,Es oRDER where oRDER lD = from ORDER DETAIL where ORDER ID

Islue thesc conrnanls l()

SQL>

SQL> sIct *

s]ec *

'<ordr rD>'; = '<order

Tl BCO

E.la.urit)n t' n)rrur6

trh L: lnrleuenr Pn.e\t Olrl.rStrri t

Tesr

Or,l., P/n.r\{irj u

Ur

c ,ndit onq.

. . r

Eclil CIIIWEDU\Batch0{ems l rigger.b{t 1o sub ilorhcr ordcrs that contain life ilems (e.g.. BatchOrder02.xml. BatclOrder(l3.xn1, RatchOrdcr04.\ml)

dfLnnr

) a

You should feceve a Lrniquel) nrrcd Order Resull fie for each pfoccssed ordcr

Tcst thc Crcdit Chcck Rejected trxnsdon using

'Brtchordcr05.\'l
C

P, dc?r rar /. r should t.kc Lhc 'RclccLcd" paLh lt\ll lrrokc Ordcf Result filc should rcxd CrcdiL Chcck Rjectod'

rctlttc lt.t

kS

rrn?

and de

fo. r.ansitor b) srcfping re uscrxx Crcditchcckscrvicc engine tion TIBCO AdminisraLof and sul'rnuin: rn odef: a Ord./P/a.?rr lhould lake thc Failcd pr|1l:tt\ Itbk. Ctcdi Cllct 5r./!'1.. and the {)der Resulr llle should fc.d Failcd Lo do CrediL Check Please t|! a!,rin lateC
Tcsl thc Crcdit Check Failed

. ,.- E, !1 I-!l 'r,iflr-| -1,

----**,*1 rl
t'1' il
".),

" t.!0

,t

*g-u
{,&

a I

SLq) Dcsigncr

tcr

nrode and the Adaptef Tcstel

Opcn the C:\BWEDLI\Ba1Chordcr\imsTrisser.bat scrifr lilc xnd revort back to the Batchorder0l.rn fllc ($ rhar subscqucnt ordcn arc 'Acccprccl')

M-BW|: TIBCO Ebitusswh"ktrv 5.4

egmtioa

Troubleshooting

If you

have

no$ in yor pruce,\s(cs)! hcrc

ar some rips for making dcbugging easier:

a a o r . r

To test aclivity-by-adivly, in the Z?rter tab use the "Stcp lo next activty" oplion

From lhe Dcsigner met, sele{l Wittdew > Shore ConJor, !o view crrors comprehensively (use thc - al option for morc detailcd enor mcssages) Examinc\Documcnts a||dSettings\Mministrator\.TlBco\ogs\dsigner.tog

Verify that your JMS Queue shows the nessage as "pending" after e producer h!9 scnt [f an lctivity fsils, kcep the proccss ir debug m(de and exahine the error dialog

il

If processing continues to fail at a cenain activity, place a brekpoi[t bcfore (and pcrhaps aftr) at activity, rc-submit an order aod examine the data in thc activity's Inpt and Output labs to verily that the corecl dala is being passed

I'.qe 222

TIRCO Educaton Pngmds

ktb E: hnrl.tnant I'ftL!\s Ottut Seni.p

Notes

M B\vt: TIBCO uu\n1s\rorki

i 1 htesnlil

Notes

TIBCq Lduin n Prc Srant\

Unit T: E ?nlnt! BW Pn.estet

Unit 7

trxIenqtnq vv rrocesses

Thjs unit pfo!ides techniques fof extending BW proccss dcfntions using Java palette aotivites and olher Bw activities. ln the lab at 1)llow\ you dclclop lhc Procest Web O lcr ptoccss dcfnition thar will en,rble BwP operators t{r input turchasc ordcrs via ihc Wcb.

Topics

. Ohjectiws, pr.!.226 . Erte ing Bu'i e"Walkr pagc 227 . Jard C.de Actir ir. IJrge 228 . Jard Evnt So|rce, page22t) . Jdra Metho.lActiritr, pgc 230 . Ja to XML 10 J.tra, pale 231 . Cutton RW Pal.res, pa!.232 . Ct lttti4iS EEine Bea!r, page 233 . Exrotlng Eot Handlir.q, pagc l3,l . E\tendinC a BIY Ptoject, paee 235 . B\vP ltnplenentaion: Procett Web Onlc\ page 236 . Ptotz's Weh Orrler Inplententatun, pagc 23'7 . Procets wet:) Oftlet DeJinitior, ptle 238 . Quer)'Or.1ers Deflnition lnpo fted), paee 239 . Proccss \leb Otuler Seqence Diagran, pqe 21O . Qrery Oftlt^ Se.tuent'e Diaqrun, paee 241 . Iab lnpLenentdtion, p,lge 242 r Lb I lmplcmcnt Proccss Wcb Ordcr, page 2,15
(

Pge 225

tt.lJrvl. nBCU Brsi e$W'tL\ta :.J

lnt!*ti.t

Knowledge

. . . .

Explain how lo extend BW procss definitons using Java activitis ldentify the types of Java methods thal are supported by
BW Java activilies

Doscr be how lo exlend BW procosses using olher aclivrties

Skills
fmplment We Order Processing

Use Java Code aclivity

Obiectives
The gool ol Lhis nt is to prepare you lbr rhe tinaphasc ofthc BwP intcgration implemenhtio, Pncess Wel, Or.kt.'o lha( cnd aficr compleling this unit you willbe ablc to:

. r r

Dcscribe how to extcnd BWprccesscs using Jala palcLte ,ctivtics

Explain how to cxtcnd BW tft)cc$scs usinS olher activirics

Irlplcment the P,'o.?.rir W.b

Orz./er Froccss

dcfinition

Page 220

1-t

BCO E.lrcaion

Pnsnurl

lrtn

7:

l:.ttr.lit8

BW Ptu.es!es

. . , . .

Java activilies Custcm palettes

Engine commands

f rror handling
Plugins and add-ons

Extending Businessworks
uw prccellcs can bc cxtcndcd vafious ways. The most comnnm oplon is Lo usc thc acri!ties and resources prcvided by Lhc J.!a has cri!irics ard resoufces lof execuling .lavr flerre This code s well xs convcftng bctween Java objecls rnd XMI'rlcllc
Othef

rdi!iie! aLcrn rlso bc uscd ro cxtcnd BW processes incude thc lnspccrff activity. the Generare Ilrror nd thc Exccrtc Command dcLiviLies You crn l$ crcatc your own custom palcltes and lop|rLc Lhcsc paeLLcs \vith prc built processes rnd rcsorce! lo| feusc.

ltt-BWl: l lltco Businesttbrk\t\ 5.1

h .rniotl

BW generates Java class and skeleton code . Developer mplements irvo,ke /) method Supports simpie and complex objects

Primilrve data types, including repeating elements

Java Code Activity

The Java Codc aclit ily llows you Io errcrd thc furcrionality of a prmcss dtlnilrcn hy inrplcrncnting youl o$.n Jaln codc.-[his ilctivity cllotls you to \.ritc stndard Java c(xlc thrL can nripulare any oflhc pr occss dau or porlarln any action )ou chooro. Whcn )'ou confisufe the.lav! Codc acL!ity, you suffly infuL and output pnranrelc|!. BW goncrrtes rhe skelelon r(xlc ior Jou. includng the \rel lr thc rcquircd i,r!r.1) melhod. Youf cusron code rs cxeculed al runLinre li(n thc n!oke melhod. Yoo cnn compile each J:r!aCodc activity indi!idu.rll) using

''Compie btlor on (hr Code

rab,

orlou

cn

ft co rpile alJava Codc

:rclivit;cs in yourp.ojccr at once Conrplle Al Code rcnu iLc.

Si.i

*ilh

thc Tools > JavaCodc >

xlso. l'rssing Ja!, Objccl! Betweer

Jav. Codc

in tho

'fl BCO B usulesswo tk! Pal c11. Rcf. re L

e,j\tidc.

^ctvties

'l

l BCo

Ett.aio

Pttlui\

tin

7:

L.nl,ir B\l Ptu:sts

Java event source

. .

Cuslom starler fof pfocess Java code conlains onEvent{) mehod

Prccess slaned by onEvent0

Java Global lnstance

Spec ly java obiecl

Sharod across al proccss nstances

Java Event Source

you to cfeateI cusiom lrocess slafier wfilten in Jala Evcnr ^llows .hva. r era plc, a proccss rry bc rafcd rftcr a d arabasc rnscft. The cLrstor process startef rvould observc thc dalabasc lbf irscft even$, rhen ca lhe onEvent0 meLhod wih the desired crtr .rs inpur whcn an irscft occufs. Tle pfocess is crcared when the onEvcnl0 ncthod is nlokcd and thc object passed to the nrethod is passed to the pfoces! deiinirio.
Java Global lnstancc: when pfocess engjne ( flrrled- aD insL{nce of rhe specified Java cass is consLruclcd. At shtrt down. if' specitled, a cleanup melhod s in!okd on thc objr and thc obicct is rcleased bcforc thc cnginc shuts down. Any Java Method ol Java Code acti!ity can acccss lhc sharcd J ala Global lnstance by invoking the static metho.ls of thc conlgurcd Jiva cl.ss.

-Btvl : TIR( :O lt6i n.st\\brkit

t..t h,t.!tuit

. .

Invoke a method in a Java class

Create an instance of the class

Classpath must be referenced

. .

degrgnef.lra bwsng ne.lra

@m
1:_t:

:.:Jlti,;

It-l

,:;

i:::a-,,,* -

Java Method Activitv

a

The J.r!d Metlod activity .lllows you to in!okc a nerhod conlaincd in Java cl.$s. You can construcL ar instancc ofc spcified Java class. iI you choosc to inlokc rhc coltsrructor lbr rhe c,rss.

The Jovll class lb nust be locaLcd in rhe cllrlspath lor TIBCO Dcsgner and lhc TIBCO Bulincssworks prcccss cngine. LldaLc Lhc dcsigner.Lft and blvcrgine.tra filc to conlAn thc direcrcry whcrc youf Java chss llcs ar lo(alcd. Thc Choose a Class orChoose a Class and llhod dilog rppcaa when you click thc Show Cl{ss Browscr buLlon. This dialog !11!s you to pick aJa!a class (and cthod ofthat class for he Jalr Nlclhod acLivir)) fiom a lst of archivcs availahlc in rhc TIBCI) BusioessWorks CLASSPATH-

PdSe

).0

TlqCO It lu.ui Prcstuntt

thrjr 7: Etdulig ll\\' PnrLs!'\

, .

Schema

. .

Java class convefied to

Xl\,41

schema

Activities
Java to X[,4L

l1l -,"-!

Coflert oblecl nstance data lo Xlr'lL

l'::. l *;l

XML to Java

.- Creaie a oblect instance irom XVL

Java to XML to Java

Thefe afe two lctivities and an associated sohema fesource Lhrt cnn bc rlscd lo conlcd hct\yccn JaLa objccts and XIIL documcnts.

Thc Ja!.l Schra rcsourcc alloss )ou ro specity . Ja!a class thllr can b uscd Lo conligurc rJrva To XNIL or XML To Ja\a acti!t]. Thc Ja\a To XML:cririry allows you to conlert inlo xn XML clocu cnr.
a

Javr oblecl

drla

The XVIL to J:r: activty allows you to cfe,rte an instanoe ol a Java objcct bascd on dara liorn .n XML docuncnr. Thc XML schema tol p(Nding input to lhe Java obje.l i! crerled lrom lhe Java objccl of Java Schema speciled on the Coflguration lab of thi! rcLivily.

\l lt\ l l lltt () Rnsirj,,\r\,hr\

.i J

/rr.S"rr,

"

Usc to templatrze process de.in.lions. conf gured activites and resources

*-

'l aU

r.
i

::r.-'

l:::.-1Al

Custom BW Palettes
Custori lalctL.s rllow y(ru to sa\c. collecrion ofrcsources 10.r prcdctincd kraLion and eirler \hrc ir wirh rnhcr uscrs o. use rt yoursclfar a tire. To crcfltc a custorr (uscr dctined) palctrcl

'atcr

. r .

Choosc Paletres > My Palettes > Ncw Palette arrl cncr a nonle On trojccr s!. rbe ne\\' plctte is savcd lo thc localior spccilcd by rhe User Palcuc DB*tor! prctrence (r.mlpalctte tlc tyF)

No$. you can add (by drasging d dropping) .esourccs and proceises thc projecL Lrcc to the cusLor palcfte

r(n

Ih htld a lto|t tllctte: Place he palcrtc in the Uscr Palctrc Dircctory ard choose P.lcttes > My Prlrttcs > llelord Palctres

Pagt 2-t2

't

I BCO

E.lu.dtio I \v Uru

ht s

Ilni7: Eiln.lns BW Pcessa

Exlernal Command activity

. .

Execute an exlernal (OS) conrnand Wails for command io complete

Engine Command activity

. '

Gel engine slaUslcs

Process leve stalrsllcs

SLrspend/shudownengine

Controlling Engine Behavior

The ExLernrl Comnrand activit), allo\s you lo cxccutc an Opcrrlirg System conmand. This act\,ity waits tin the conrnrand to conrfeLe bclbrc Lftnsitionng to rlc ncxt acrivity. Optiorally. rhe command s ouLpur rnd any cn!trscan bc includcd in this aclilirt s ourpur schcma. written ro a fle, or both.

Thc Enginc

Con and activity allows you ro fetdeve statistcs and infonation abour proccss dcfnitions. prcccss nsrances, and acti!iti$ in thc currcntly running pfocess engne. This activilt aso lers you pcrli,rm engine nnirltenancc, such as suspending rd
rcsuning process irstances and shutting down the enginc

irl-Bw|: t IBCO Bnsi@srvl*sr

J.,r

r' lraln

. I .

Cateh

Catch allfor unhandled exceptions

lEt,rh Generate Error . Throw yo!r own exceptions Rethrow

. .

I'xi
I Genrdre I Error --r

-=-----t
I I

Propagal eror to higher level Fforn s!bprocoss io main process No np.ryoutput

l4#l I
e"tt,ro*

-l

Extending Error Handling

Catch: recei!s conl ftrl o I cxcculion whcn an unhndfcd cxccption occu|s. You can selcc( aspccific exceplion ry0c lo carch orlou c sp$iIy ar rhis acrivir!_ shouldcarch ll unhandlcd

Ccncfate Enofl Ccnerres cror lnd c0uses an imnredirrd rrnsition to any c of 1r0n$tions. Il thcrc afc no e||or lfansi!ion$i lhe pfocess lnrance h lts cxccuion

ReThro\,: Thfows c ciccption caught by thc c:ch c{i$iLy again. Use this aclivily whcn rou wish lo Fopaga{c c cxc'rption

Page 2.14

TIDCO EdudLtit r Ptustat

lr1t 7: tentln\ B\l

l'n..$.s

BW supports various plugins and add-ons, for example:

.
.

TIBCO Smafi[,4apper
flanage cross-r.ienced daia

TIBCO iProcess Corneclor

lnvoke BPi"{ lrom BW process

. ' .

TiBCO BusinessConnect

B2B integralion
[4a nirame plug n for TLBCO N4ainf.ame Server Srte

TIBCO lvlainframe Inlegralor

Inlegrolon with
N,,lQ

Seres

Jl,rls acv es {lBl,l .ll\.4s/vlo br dge) or T BCO [.4Q Adaplor

Exlending a BW Project
Btr\incs\Works leililrles workllow, B2B. fo rand mainlame intcgration hy ersily interfacing with othef TIBCO fr(flLrcts
slrpporting thcsc sc^,iccs.

itl B\\ t :

t ! B CO E

u s

it

\:Vb rk )t 5.1

I nr e exi

(,t

BWP lmplmentation: Process Web Order

l,tl-gw : T\BCO Busin,tssworks'tr 5.4 lntegft tion

DTIBCO
BWP lmplementation: Process Web

Order

IlBt't t Lh..|tu| Ph'ltntr

tlnLt 7: E\ta1hg B\Y

Pnn?\yt

Process Web Order lmolementation

Y.llrrl

tlBC ltst'.\\W tur! i., irrrlr.roa

lf incoming HTTP posl rs a purchas

. .

Parse ofder and submil ror procgssrng

Preset order result file tlack to Web browser

Process web Order Definition

Wcb oer processirs is initiated by Pro.e.$ [vs, Oftlcr. lt recilcs a Pun:hse Ord XML ilc or query for rcccnr ordeni vialho Wcb. The
Prchasc Ordcr is parsed lnd conrpcd and senr to Pocess Onletfol process;ng. Qucrics call fhc Qer- Onlet p\N-ess, urhich plls recenl salcs ordcrs fiom lhe d.rhbasc ind presenLs Lhcr back lo the brcwscr.

Notc the use ol the.fR!a Code acljvity in this process [o paNc thc incoming HTTI'Nsr contnDing ordr ilcms.

TIBC0 E.hturiut Pro9ruL'

rt, - Ilr.rJrrs Bil Pfr.$.r

lf incoming HTTP post is a query for all orders

. .

Query Orders subprocess s ca led lelr eves siored sales orders

, .

*::

&

Presented back lo browser Contims thal your adapler seruice is propeny vring I r-r.lorl-D io il-, d o

Query Orders

Def

inition (lmported)
0rcryi)/dcru is aprr defincd ptuccss aL tou impor into your projecl. lr queries all orders rccordcd in rhc salcs rlatlhase and pfesenrs this infomririon on rcqucr ro thc Wcb. It is callcd by

Il

Btr't: t tut:O Butil.ts\\'.)tk\ 5.1 Itn.3tu!itrj

Process Web Order Sequence Diagram

O et Scarence l)irgranr sbowr abole ls the same rs shown prcviouslr_ cxcept thrr whrL lou will lou nrpenrenL is highlighted. In lhe nexL lab ]ou build thc web Orde. I)rocessing componerr of the Bwl' PrcJocL.
Prc.ess lveb

't

tB( O E.!u.ntan

Pit

"ns

I',, -

,ft,,hrq

tslY

/ , .'\f\

Query Orders Sequence Diagram

l-BWl: TIBCO B$inessworksnt

4 htts3mtion

.
.

Develop Process Web Order

Test and Debug Process Web order

Lab lmplementation
Coorplele lhe lab crcises lhd iollow to inplemcnt W?/, Or./et

PaBa

2.t)

TI BCo

ljd ucaii P tugs

Unit 7: Enek.line Bw Ptu.est.t

Notes

M -B\r t: I |BCO

usinaswo.b'V

5..1

l4te8r4r,on

Notes

T I BC O

Elu.uti.n

P ro 3nn6

lab

f:

ltlglenent Pro.ess

Web

Order

Lab F

lmplement Process Web Order

Overyiew
ln this last pieoe of e ,npxx projcc! you implcmcnt web order Processing. This inoludes impo(ng ihe prcdefned OaeryOnde6 process deFrnition and calling it from Ptocesswebodar which you will huild. To conclude you wlldeploy yoursolution usinS TIBCO Adminstralor

Obiectives

. .

Implenent P.ocels Web Orclea page

Test Process web

U6

Onlet,

page 257

Prerequisites

. r

EDUSVR inslrcror scrvcr and ucrxx studcnt clicnl platform TTBCO Software installed and configurcd on youl userxx machine:

a a a a . a a

Ruotimc Agcnt (TRA) 5.5.0

Adminsktor 5.4.0 (userxx donrn crested) Businestworks 5.4,0

EMS 4.4.0 (added lo the userxx domain)

ADB 5.2.2
BWP Home Pa-.e
t

Conncctivity lo thc insuctor scrvcr for

btp

//.du.vr : 8o8o/bn/trdet . btrr

Omcle Database and Mercury Email srvers

r .

ClbwpXX project file C:\BWEDU lab liles

Directions
Complet the exercises that

lbllow

TIBCO Soltwrc Inc.

II

B\\'l: 1lBCO

lhttit(*\lot(t \tJ I

ltltelrun

Lab F - Exercise 1: lmplement Process Web Order

overview
Prrc(rrlt?b0l.fuf willrcccive etheran ordcr or qucry vi a \!eb pgc. (dcN have (heir linc itcns panied using Jtlr codc and lhen invokc Pm.".$Oders?rri.?. Weh qucrics will lhc cll lhe O{c^Ozlc,r pfocess (irporrcd). !\hich wil relfevo ordcrs iionr rhe databa\e and prcscnr rhcn
back t{r lhe hrowscr.

i-mnli]MJ

Steps

l.

ImNrL lhc prc{lelncd OrcDOr./.'r pfoccss inlo your proiccr.

. . t . . r r

Sclccr lblder /l'roccssDctinitions/orderP(rccss ,rs thc derlinaion for OuertOl1,a imporr

From rhe t)csgncr mc]Jbat,

\et*r

Pnje

> Inpor. Kesoutcesfro Fle, Foldet,URL

tzip) then browse ind sclccr C:\B\\:EDU\Impof\Querlo.ders.zip ^rchivc Chcck thc box "lidir Advanccd Srlinls and click OK In thc lrtp1 - Opions rab, select l)orol includc qlobrl lariablts \viLh inpo!t Ctjck Apply
Srlcct tbrmar
In thc ProJscl lree sclcct the pfocess icon Queryorders and

\eril)

ts inr)rtl

'..+

TIRCO Ltlttio, Pherns

Lob F: htlt',t,t Pr.t

tt

\+t b

OrL

2.

Confqure |esourcc /BwPcoru/Conncctions/H

l lP

Connection fof P/oae$llebord(r.

r r

Name:

webotderH'r1P

Hosli lr.dl,.!r (dclult) Notc: Yotr could crcat

a

global ladablc tbr ths poft vallre fyou d like

In your projcct. cfcilc a ncw cmpl) proccss dcfnition for ffocessng Wcb orders.

/I1)ccssDclnilions/OrdcrProccss/ProcessWebOrd

l. l,i..r.c

r,.,.ll. / 0, 1,,Ih

Jr HTTP Re.ri\er.., r..

r, . ..d(
f l'P

J.d.r (ri(.

. r r r

Name:Receive web Ordr

HTTP Connccron: /BWP.Cofc/Conneclions/WcbOrderH
a)uLpur

Sylc: String

Chcck Prs Post Method Dta

Pararnctcrs (all rrc oprional strings):

a 6hiplocaion

Leavc allothcr sctrings as dclull

M.Rwt: TIBCo Euttncssworki 5.4 Intetrution

5.

confrgure a Write to Log activity to log incoming web orders.

I .

Name:

log oder
tng Ordr Purcba6

Transitioo from Rceive Web Ordr ro

a a a r

Label:

Condition Type: Sccess wilh condition

XPalh:

SReceiws-lteb-Oder/groc.u6SartelouFr/RequcEURI
a

'/purchaE'
For thc fnput, build

conca ( rR.ciwed W.b Orde! floE accorlDt: ., $Recelv.-Wb-od!r/Proce6Slrrterouput/parnaters/account)

naag6

rhar logs rEeip( of the web order:

6.

Confgurc { Writ ao

lrg

activity to log inco ring web querics.

r .

Nams

log

Qury

Transition from Reccive lryeb Order to Log Query Label: Qu.ry

a a a

Coodition TyF:: Succcss with coodition

XlarJl lboolean):

SB.c.iv.-web-Ordsr/Eroc.EsgtaralctuDu/Rque6tuaI

'/qu.ryorders'
coEct ( "Rclval Web

ouly fro@ accouat: ., $&ecetvewbordr/ProcaaStrtroutf,utl9rr!6ters/rccoutt)

For thc Input, build ansrage that logs the receipt ofaquery:

Page 248

TIBCO E lrcatiott Pbstuns

Ldh

ltnttl.nt n lr1t..ss \\ih Otn.r

7.

Conlgure

Jara Code aclvitv to paAe lhc inoonig

pLrrchase

odcr.

Andbsir Thc incomnrg web ordcr

Jara Codc aclivit,r to do thc prJsnrg. When yo conlgorc this acrivity, the rcquircd 8els"t and n?rrte nelhods are genefaed fol you by BW. Youf code is exccuLcd n n?f,lef), whcrc il is callod L ruDrimc hy thc ngine.

HlPn, I n.dn\\41 'i1. . i. rhc :nc^ its \

needs to be parserl. Because this ofdef is an

c- tl-cn:r . ^rJr-,.$.u..

C onl! rat

a a it . a

nn tab: Namc:Parse POST Palaneter6 Inpt Parimolcr: postData whjch is a reqilr-ed slrrg
Outpul Prtunelef:

ilens

whch s a r.prdlir,g slfing

Copy rhe codc tioor C:\BWEDLNala\P:rsePOSTDatjavi i4woke ( ) ncthod (bcncarl "DO NOT NTODIFY r/')
Sclccr rle opton Shorv: fll Class Lo iuro-genef ared getset mcrhods

pasrc to thc

vics lhc cnrne cl.ss. incluclnS llc

a Apph and Compile rhc codc; lix anr crrors

Tr, do this: To dcmonsatc fcaturcs ofrhc c hcddcdJava cditor, this coclc has an inlended error (method gerpdrru l) oannot resolve slntrol'). To ix it:

r C o.c rhc, n.r onl^g JrJ. lr.l Ldil Cl\\ r Ch.,rg.rhci1\rlrd...r\, JrF?a/,\',r^rh.,., :dseEpoEEDala() r Add the code @suppf,esswarnings ( nunchecktlI') i
suF!reslt:!ningi ( rn.he.ked
)

l,a/rr;si \.inc IDK lRl .1!'.Ji. 1n^ - .,.r,tiRJ illRl l5 irc1 'u\.1 by TIBCO Busincssworks. You nrsL add rhc sraicmcnt @suppresswarnirg6 ( "unchecked" ) to spprcss thc wuning gcncralcd by thc compler.

. Apply dnd Compile \ote:T L.J,oLro$nJr\rcor'or.

lr^mrhe ncnu,el<t Ld;!' Ph L h Orsr and bro$,sc to i! (c.9., C:\P.ogranr Filcs\TcxtPad 4\TextPad.exel.

r.,\

M ts\L1: IBCO lr^ir1t\\\br].s)\

iI

h1k

!.1rr1

r .

Tfrnsiron rct\,ities: Log Ordr ro PIrs POST Prameters

htptttihttf Pa^t P.!t P at.tr1.te

rs,

mtp:

i:r! rCodeA cLi\

LlInpr t/postDala:

9Receiw_web-order/ ,rr /D-sEDaEa

llLt t) LJrLrtrti Pr.itdrtl

I.l r

ht'|,, t P,, .

'\ lli|, t1rd,

8.

Now Lhat l_ou have parsed thc ofter compulc lhc lne items using

llapper acli!ity.

/,rp!7

tl,.

tab. add rhe

ll

ving schena lbeneath foot ):

. Ien (fequfed stdrg) . Ouantily (fequircd iteger of |ii/e inl) . uri!Price (fcquircd dccimal of size double)
Transirion rctvitics: Parsc POST Parameters
1o

Compute Line Item

Gronp

]1e

C,rt)uc

t.i,. /rcd

nappef (you need to do this beforc you can nxp ts Inpuo

l} a a a a a a a a r a a

Croup Namc: Gfoup Action: Indcx

creale Line Item6

Iterae

Nrre: VafiableLst: $ParsePosParmeer6/ j avaCodeActiviEyOupu/iEehs

A.cumuxte oltL: (checked)
Icrarion Elcficnt:

currntRecord
(oannol have spacet

Outpul Acl!ity: Compte Lne ltem

()ttL Namer

LinrtehData

Complele the lfansirion to the gfoup end

Now rhar you havc an rcraor

i$il.fbfrhclnpurroContute

Line Ien n^p.

Icrn:

j avacodeciwityoulput/ itms
Quantty:

lib : lokeniz-aIlow-enpy ($Pa!6PoslPart.s/ I $ i 1 ,",") I1l

!ib:okeEiz-allo{-enpy($ParsePosTPardetrs/ .' , I$i L ") I4l a UnitPrce: lib: okenize-aIIow-eRpty ($ParsePosTPardeEerE/ j avacodec! iv youpu/ i ens t$il , ", ") t2l
j avacodec iviyouEpuE/ i Eem6

ttl.gWL l|BCO Bus

e:,$r'stx

51httPsttti"n

9.

Now that c rcb ordcr has been parscd and ils line ilcms compuled, Pncess)tler Scrrice a,rl submil the order lbr prccessing.

inlokt

lhe

Add

SOAP Request ReplJ acrvily

a a it r .

Nanrci

Invoke Processorder Serwic

Scrvice: ProcssOrdcrscr!ice-ConcrcteWSDL Tcst he lransport conneclion (EMS Scrvef nusl bc runninS)

Transition acli!itics: Crcate l-ine Items 8r!uP fbr the l,V)rt ro the S()AP invoca(n)n activit).

d lo Invoke Processordcr Srvi(e

a a a

CurtomcrlD: SReceiwe

neb-Orde!/PiocEESattroutPut/

'l:r0:

Paiameers/accout
()|dcrDrle:

s'rbsriEs { S Recelw -wb_ orAer/ P.ocessca rLroutPu!/ parametrE/orderdaer l, 10)

SbiOmerDarc: ubst!ing(SRcelve-web-order/ ProcessstarterouPu/Paraneer3/ordrdate, 1' 10) a Shipnclll "c,.run SRecive-web-Order/ProcesssLarLroutPur/

pardeters/sbiPLocatior

DlvervMcthod: mllrer { SRci.we -web - Order/ Procsssareroulpu/paraerE/detivery) a priorirv: SReciwe-web-ordr/ProcssStarteroupi/Pardl6tE/

a I . r

Lincltemi

SLineIlenData/Accuuladourput/root
/-it(?nr
using lhe Mapping Wizard:

To do this: To tnap the repcfing structure

Selecl thc oDtion For each... ald click Ncxt

ln lhe 'AteMap' dialog, a*ept lhe dclult Set for each elemenl Click Finish to conp'ete rhc napping

1 l

CO Ed u.at ion

P n' !!a'n

I4b F: Inplenlent Pr.els

Web

Oftler

10. Verily your completeL lnvoke Prccessorder Serric? activity input mapping.

Not: The XSL terlplare fof ihis napping can bc found at C:\BWEDL Mappings\ P rccesswebo rder - Inroke P tceslo rd? | Se n i. e.x|.

M BWI: l-IBCO Bsineswotkt

! 5l Integtlton

ll.

Configure a Read File actiliry Lo.etd the order resull llc so al il can be sent to the Web rcqueslor's browscr as the ordef confirnation reply.

r i r

Namc: Read

Resul FiIe

Read as: text (dcfult)

Transition acti!itcs: lnvoke Processorder Senicc to Read Reslt File

fleName: Shvok - Proce6 order- serwic/ outPutMs ag/ orderProc6ingResul!/FileNane

12. li thc inconing web ofdef

s aquery fof recet ordtrs, submil it to

C!?ry(rdcru

Lor

. r r

Dfag and drop

Oueryordr6

ito

Prrcerrll'ebolaf

Process Name:,?foccssDefl nitons/OrdefPfocess/QeryOrders

Transition ctvites: Log Query to Queryorders

TIBCO E.lucdt ion P rcgrcurt

Ldb lt: lnryl.tner l'tu.est w.h Ord.t-

ll.

Coniigrc

Send HTTP Response actvity to

|efly with lhc

ofLler or query resull.

A,a/r\ni

eirr(' dr or.lcr rrqu. J ^r:r qu. r) ,.r hllurJ(r\. )ou nc.J ^\'r up3(\l.Feacriv,r)|rarder<mine.uhi \ r)pc uf c:\fd and rctli. , $;rh rhc dtnfcnfiJte rcsr lr. rcqLe\r $ a\
'<.

S ncc,hr :nro I rg H fTP pu.r i.

. . r r

Narre:

send vreb Response

Rcply Fof: RccciYc lveb Order

Close Connection, (chcckcd)

Transton acliviles:

a a a

Rcad Reslt

liilc
Lo

to Send Web Responsc Send Web Response

Qucryorders

Scnd \Ycb Response to trnd

(use a

r /lrtrr trb Lfucli!ly 5e,.1Wel, neV,.a. . rsciicontcnl lchoo\el

Whei:

srngle Surround wilh Chocc stalcrcnt):

=

$ReciwwL,ordr/Processsarte.outpu!/RqustuRl "/purchase'

rsciicontent:

SRead Rsu I c /ReailAcE ivityou Lpu LTxcClass/ f il ecoEenl / texlconrent. "</PRE></BoDY></1rTML>')

concal

(', <IITML><BoDY><PRE>

",

Othcrwsc:

.\ciConrcnr:

concat('<IITML><BoDY fonl face='Aria1, Eetwetica. sans-6erifn>'. "<h1>411 orders</h1>", '<able bordr=n1'I celtspacing=0 cellpaddins=r2r Itordrcolor="*ddddff ' bgcoloi='+a0b8c8'>',

$Queryordrs. " </tabIe></BODY></HTML>

'r )

1t\\'1: TIBCO

Bsin.t\vtk\

rt 5.4

Int.ixit,t

1,1. Verf-v thc design

cflour completed Prr.prrlvlborlef dclintion.

l ltsCO

Edr.ntion l'ngn1s

L)t r hnt'lrnrr t\r..s\ t\rt O'J .

Lab F - Exercise 2: Tst Process Web Order Overview

ln rhis penullimale exercisc you
rcsL

youi cnrirc ryrXXprojcct.

Steps

VdlldJr(

'

{ r frojccf Jnd Ji'hL: an) (ro \.

Lhc

Note: Ignorc ar sink cnors rsr)cixtcrl $,ith

rdaptcf srrvcc as wcll xs any nrsr)cided

Shn

Lhc

l)llowing

_flBCO

componenLs.

r r r
3.

uscrXX - CrcditCheckService cngire usng TIBCO Admirisr|aro. SalesOrde.SubscriptionXX adaprcr scrvicc using rhc Dcsigncr ,l./dpiel 7.r/./ TIBCO EN{S Server usng TIBCO Adninisrrarof

lilitl

Scr up rhc HTML o(cr pagc 1rr subniuing wcb ordc.s nnd !ucfics to P,tcestwebOtuler.

llrlrucl lhe conLerls ol C:\BwgDu\Wetrofde^Wcbord$Pagcs.zip lo lhe TIBCO Admjnifr.r(r wcb scr er dreclory C:\tibco\admini!trrr(n\5..r\tnc.Ll\wcb.ptdROOT
Access the BW Web Odef page usng Inlerer nxporef at lhe iitkrwing URI-:

hlp

//localhos! : 8080/bvlorder. htrl

M B\ll: l ltsCO Rlintswotks

rt 5.1

|ttt.lxnir

:1.

Tcsl and dcbug W"bOrlPrut:(!!ing.

r .

To Jl].ke debugging cascf, set bfe.rkpoirts in P/ocesrOftler

ai.l Ptoccssweborder

L.,rd the iolowing conrponcnts inro the

ler?/:

a,A\\T.Corc/SeIa ices/Ordcf Process/tntef lce/inifProcessOrder-service

a a r r r a .

/Prcce$sDclirtions/OrdcrProccss/ProcessWebOrder
/Pf occssDctnitions/Odef Pf ocess/ProcessBatchOrder

To rcsL a wcb ofdef thar is REDY (allproducl\ ordcrcd arc Atdildrle): In rhe weh order p.g cnLcr
Choose

lL

lid accounr such as

333 33 33 33333 33 3

I tirc rnd I light and click Plnce Order To tcsr a web o er thal i! NOT READY (.Ln] ordcrcrl pfoduct on Ba.t Oflr/): a In rhe web odef trge enrer a lalid rccount nrch.s 33333 33 33333 33 33 . Choose I tire and,l50lighrs a d click Plrce Order
To test
a

web qucrt, in rhe Web Odef click

Q!9r!!ll-ol!!e\:

A quefy jfom rhc Wcb pagc nvokcs QacrOl?,it which tlche! all ordcrs in tht SAL-IS,ORDER tablc rnd fofmac r rcsponse back lo the brNvsel Note: Oa.,f nll O/./.fr resrs rhe adnprer service becruse t s puing lhc dala liom lhc SALES,ORIER rable lo whioh the adapter servi.e hrs \vfiLLD conrplctcd ordc.s.

r r .

Bclre p.oceeding wilh deplotrnenL n rhe ncxt cxcrcsc. vcrity that Pfr.ersBatchOrder wofks oonecty using rhc .imsTrisger.bat 1lc Stop test mode for

rll

conponcDrs. inclding Lhc adaprcr (do not iusr close thc sindow)

To updatc the invenlory with new quanlily, login to SQL'PIus and issuc this command:

sqlplus usrxx/userxx@eduvr updat inwnEory item 6E quantiy=100, r

To \'crily this issue the tnlowing colnm.rndi you shoukl sce
rcsct to 100:
Lhc

qanlt] lbr cach ilcm is

select * flon inventory iEen,

BCt )

Ld-tn,tt P@gt,In\

Iab

t:

In?letunt Pro.es!

web

Oftl.r

Notes

M I{r, | :

t. I BC O Bus

it

rs'Jl.): I u 5.1 rtlte !ttu"1

flBCo L.l. ti,nt l't 'itttn\

Ihtl \ Drtlr\rig 1l\\ trgrt.

Unit

Deploying BW Engine

This unit provides considcrarons fbr dcploying Bw pfoiects.

Topics

. . . I . . . . . . . .

Objectiret, pagc 262 Ew 5.4 Enqine, pa9e 263

Engine Pef.rtance TL'trrig, pagc 26.1 Engine Depla)"nent, p:19265

Mdno|enent & M,,'noftrg, page 266

TIRCO Lld\rk

4ent,

pagc 26'l

TIBCO Admi istftLiur.S"nea pagc 268 Lodrl

Bdla

ittg an.l

R?ri/i!,(..

page 269

:iecuritJ, pa9e 210

TIBCO Don.tin Bes PktLlces, pae211 Lab

Inplenc talion, p,\ge212

Lab F: Inplenettl Process W(b Oftlet, page245

M B\\t:TIBCO B\r?$\rorki

5I

tnLellatit

.
.

Knowledge

. .

Arlculate BW engine and deployment Describe monitoring infrastruclure

Skills

Deploy and monitor BWP solution

Objectives
The goa ofthis unt is to prcparj you for the fnal phase ofrhe BWP inte!rution imflenrenraron. Prcress Web Order.Ta hat end dltcr completing this unil you will bc ablc to:

. r r

Descrbe holr to exlend BW proccsscs using Ja!apaletle aclivties

Explain how to cxrend Bw prooesses using oLhcr acli!ilcs lmplement the Prd.crr lve, Ord.rproccss definition

f I Ba() l.lu.dt inn

l'

"lt

rn

IJn16: DtpLrrrin! Bw Lnlin?

BW 5.4 Engine
The TIBCO anginc (Bw 5.4) is bui11 for high pcrlirrancc xnd cxccurio. capablc ol handling a continuous strcan ofscr|iccs and

pro.( .,.,:.h

w.rl dJ/.n.of

..i\i ie.. r r, upcf i,g(1\irorn(

wh finirc cftcal resoufces (i.e.. nemory. CPUS. thfeads, connccrons, ctc.). Kcy lcalurcs ofrhe BW Enginc ncludc:

r ScrlrbiliLy

Tnc

Lhc

JVM, nurrbcr ol pagccl iobs, jobs iI

I Pc.formancc Conlrothe numbef ofthreads and JVM seltings r lJr.r ful<rJnJe JnJ R( u\crr (hr'kl"intrrg'r. 't . tna
dubase, configure cnginc and domain

lilovcf

\l

lttt

I flBaA BtvL\\\Iorls \ t.l

hit'

ltrrrtt

JVN,4

. .
. . .

settings

Heap Size

fhread Count

.
,

BW process tuninq
l\/laxJobs

Aclvation lml
MaxJobs F ow L mit

BW engine properties

. '

Eng neStepoouni Enab elvlemorySavngMode

Engine Performance Tuning

Yo can conl-igure lhe JVM nrcmofy seltings lor ctuh prccos! cngirc. For cxamplc. ifyou know rhaL a proccss cnginc is going to hrvc to handle a lot ofdatr you can ncfease the JVM settng when you configufe the process engine.

TIBCO El&in PtuSro"f

Lh|6: Dq ots Bw ErBirlt

.
. .

Scripted or GUI-based deployment configuralion

TIBCO Admnistfatof

Local or Server-based application dala

.
.

TIBCO Reposilory

Deployment configuration is versioned and revedible

Deploymenl hislory is kept

Set monitoring rules for each component

aTge ach ne receivos (for each component):

Slarlup (seruer) or H!nt me (locall scrpls l,4onitorirg ru es fof erfor recove y and aeils

Engine Deployment
When you configurc and dcploy conporents, thc pfoject'! conlgufaLon is sent fiom the BW repo,ji(try lo Lhc B cngrnc(s) and/of adaprer(s) insralle(l on Lhe targct machinc(s) in the donain.

M "B\y I :

llJCO

Brtip t \\vo*r

\ i.1 ltte grdtk)n

. .

TIBCO Hawk-generated alerls raised on failures

. .

Visrble in Admin stratof Can nollry admln {human)

e

g, Send ema l

B!s ress process exceptio's

'.

Handle inlLnc

ConfS!re srspend/ resune aclivites lo ale.l admin siralor and relry log.
lypicaly on resorce tmouts
Sel

d!i.g

deployment.onJlguralin

. TIBCO Hawk Console . Cusiom Console . f BCO Hawk Adapters

JMX
H ,

for:

ITP

lvo

Openview

Management & Monitoring

Wher you contigurc a deployncnt objcct in BW you ca lel moniloring rules for cach componcnt ]ou arc deploying (e.g. process engine. adaptef scrvicc). Kccp in n1ind rhat defdult nonit ing is
pfovided. You can conlgurc your defoymen( lo sSna aefis and/of orificarion! if deployment componcnts lil- pproachcs:

r .

Handlc lhc nloniro ng wiLhin rhe prooess itsef Enablc BW's sulFnd / rcsune capabillly lbf setiing up actvity relries (NoLe: Be sure to use the Checkponf acii\'iry p.ior to inplcmcnling suspend/ rcsume to save the state ofthe p.ocest

TIBCO Adminstrato. providcs a wcb bscd ullir) lr nanrgins and moniL(fing dcpoyed domain apllications. Using lhis tool you can
start and slop deployed corponenls (process engnes, rdaptef rervices). You can also monor standafd alers as well as any additional ales you establish drng deployment confguraton.

18C0 li.lu.arian PtuEt?s

Llni t: D?plo!uB BW Eutti44

Handles runtime communications for domain components

. .

Required for any machine in the domain TIBCO Hawk Agent (domain_name) Microagents to collect monitoring inlormalion Rulebases to lake aclion Slandard alsits and logs viewed in Adminislralor Ul

Uses:

. .

TIBCO Hawk Agent

ThcTIBCO tlwk Agenr is rerpons;blc foralldcsign and run-time
comnrunications among BusinessWorks componcnls in the donain. Thc TRA rcquircs no connguradon: il is in$allcd auromatically with any Busincsswofks componenr.

ln addtion |o scrving as lhc communicalions plafm among Ilusincsrworks conlponcnls. cach Hawk agent also collccts moniroring infonntion lbr irs domain host md forwards lhis intbfnration $ the Admini:itrtor Server.

tl-BWI: l|BCO Bt6ircssvo sttt

5-1

t'

egmion

.
I . . .

Administers the domain

Web-basod inlerface

Domain users

. . .

Creato ocally or synchronize wilh LDAP

Domain data repository

File or Database

Applicalion data repository

Server-based deployments only

Can be fault tolerant

Primary/secondary configuration

TIBCO Administration Server

Thc
Srver musL bc s(a(ed to suppo.tTIllCC) and server-bascd projcd connecrions. Sincc TIBCO ^dninistrator Ad inislralor is browscr-t ascd. ir can be launchc{ using a browser on any mahine on rhc ncrwofk that can connccr r0 c mahine runnng thc Adnistration Sener. The Adminhtmrion SeNer s also fcquifed Lo hrndle regslration ofBu!inessWorks components such a$ thc engine rnd olhcr Adaptcrs.

lII}CO,{d inisation

Using the Admini\tr(or, lou can only nanagc projccts thal are parr of thar :dministratioo domain. The user spcciticd on in5lallofthc Admin Scracr has full aurhori/.tion lo both deiign- and run limc uscr inlcrfaccs. If adding or rcmovirg projccts manually, you nccd lo
rcstart fte admin server.

Pqe

268

T ICO luetion

Pnettt

Uhit E: De|l\ng B\v

LBite

Domain

Prirnary and secondary Administralor serv ces

Provide lcad baancing and fau t tolerance

Engine

For resilence, deploy same nslance more lhan once

Engines acl as Faull Tolerani gfoup ;ndpendenl oi process slaner

For load balanclng, deploy many instances - Depends or process siarler

-JMS aue (n. ex.llsive) and RVDO ony

Load Balancing and Resilience

You can deploy proiect componcnrs Lo norc rhan onc ptuccss cngine and do sorrc load shafing by choosirg whe.e and how 1o depoy thtsc

It B\ll:

TIBCO Busine$\tor].s

\ j.1 httttttion

' . . . .

ObfL.rscalion oi all passwords in GUls, global variables,

and files Adm; r se.ver sJppo4s HTTP1

Common SSL usage for authentication for adapters and processes Can use domain user for authentrcatron
Server can use trusted cerlificate to authenlicale client . frusted cedficates files n PEl,"'l iorrnat stored rn prolect folder . Privale keys stofed separate y for ndependenl safe-keeplng

Security
Donlain use are also gistefed with the TTBCO Adminisl|aror,

prc!iding security o\'er the projeci donain.

l lt)(:O ladr.dinn

Pn|tun:

Unit ll: D.rla!n3 B\l Ensin.

Understand the environmenl

Dev > QA > Prod

Approacnes

-On

dma

n..ross lhe nt

pf.i.c lie cy.3

;A difrenl

doma n ior-ach envlronmenr

In an evironmel with many engines. for besl nrf^'mih.a,'<o

. . .

Scripts for clep oyment conl quration Local reposilory lor applcallon dala Database slorage for domain daia

TIBCO Domain Best Practices

Thc TIBC() Ilusincssworks a.lminr.aLon domain is estabished
usng thc Dom.1n uriliry.

Oncc rhe domin hls beerr establilhed ohef TIBCO Busincsswofks

cornponents and services canjoin the domair to coopcratc and sharc

TIBCO Sfl$drc Ittr.

rt

D\\'t: TIBCO Busitpstwn rr t.+ /rlegrdln,r

Lab lmolementation
Complcle rhc lab Lhr follows ro lalidate, deplo)r and lcsl your BWP 0 rde t P rccess ing t\)ltria.

Paee 2'2

TIB( () EJr',tri'n I't,'81alns

Unit S: D.tltitry BW EnEnr

Noles

TIBCO Sa\'dre

It

M-BWI: TIDCO Brttnle\Wrk)\ i.1 In.8tion

Notes

TIBCO Edur dtnn Ptuertr\

lab

G: Irerlo! !h. BWP Sotuli

Lab G

Deploy the BWP Solution

Overview
ln this luslpiccc oi
the rF?tXX pm.icct you deploy your solurio[ usiog TIBCO Administfltror and monilor it using TIBCO Hawk Agcnr.

Objectives

. . .

Deplo:- the BWP Solulion. page276

Prerequisites
EDUSVR nscror scrvcr and userxx s(udenrclicnL plartbrn

IIBCO Sotiware insullcd and conligurcd on your userxx mtchinc: a lluntinc Agcnt (TR^) 5.5.0 t Administraro. 5.4.0 (uscrxx domain creatcd)

a a a . r r a
O

Businessworks 5.,1.0 EMS 4.4.0 (added to rhe userxx doman)

ADB 5.2.2 BwP Homc

Pagc at

Conncctivily lo lhe inslrucrorscner for

hp:

//duswr | 808o/bwltndx. hInt

Oraole Darabase und Mercury Emait sel\erc

C:\bwpXX projet file C:\BWEDU

llb filcs

Directions
Complctc the exercise rhar lblhws.

TIBCO

lh[Mre In..

ill-ll\ll:

TIBCO B!ness\Vrk tt 5.1

lnegdti,t

Lab G - Exrcise 1: Deploy the BWP

Solution
Overview
wo.ks.IlIou runinlorroublereicfrothc'Troublcshooring'sccrionsattlccndofpalofthccxcfcise.
Now thrt ]ou hrlc conplcrcd tcsting t s iinrc ro dcploy thc projcct and vcfif,v thllr t

Steps

l.

UpdrLe the Cr\bwpxx.ear trlc to includc all projcct conponcnts.

t r

Validare JoLl| brvpxx pfoject ifdeploynenl and debug any crrors In the pfoject lrce, seecl the /Detloymenrs/brvpxx enLertrisc .rchivc rcsorcc and conligure t as lllowsl

Add xnd contigurc Nrme:

new Pfocess Archive resource:

Processorde.serwice

Proccss Dcfioition:

.,tsWP.Cof e/SeNice!/Oref ProcesVlnlef l ace/irtfProcessOrdcr-seryice

Add and configurc anolher new Proccss Arch\'e:

Nrmc:

Receiweordrs

Proccss Dcfinhions:

. a

/ProcessDetnitions/Ordef Pf ocess/ProccssIatchO.der

.,?roccssDclnitors/Of defProcess/l'rocessWebOrdcr
Add rnclconligure an Adaptef Arch\,e: Nanrc:

salsord.subsrwice

AdaPtcri

. r r r
Save you |

Bfowse !o and selecL /AdapLrScr!ccs/S.lesOrdersutscriptionXX

,,|?.{X projccl tsuild thc updcd C:\t'pXX.ar tile (rveNfiLe exisrng) Save your rrl,pxx proleol and exil Designer

'tItt(O Etlk ti, Pragtt

t-ab C:

Dtrl.!

th? BWP S.lu1i/,t

2.

Upload thc ufdeLed

Clbwpxx.ef applicalion lo TIIJCO Adnrnistfirtof.

r . .

ln Adminislrrlor. sclccrfoldct Atlplicatt)1 Mdnageme t >

l)ttXX

> h\tpxx >

ttl thc Con\ura!on Bril./.r panel click Lhc lrwrXI h],perlnk Click Upload Ncw E-{R File, rrowsc to md sclecr the updlted c:tirpxx.ear,lhen click OK and OK.rsain

4rlrisr | :r.l- tr'.e* JLh:\J JrJ JLLprcr dr.hr\c crr hedepo\edr"5<t,r: n r< | r:rl-i e. i1i .lunrJ n F ! ..ur nL-nc.c' c.,ch . oer e J(plJ)(J lJ.-ll)

. r

Confirm the EAR iile upload delais end click Savc

Alcr clckins Salc. lcrif,v

rhat each

rhat each seNce conrponent ha\

r corcslr(diDg contxicr and

are Deployabc a! sho$n hcrc:

irlerl ..

1:e a+.-.

lF +* L" *.J ." i"",,",

n1-

--- *.---r"-,5

1! nE-rhr6

",

Troubleshoot Applicaton upload

IlJou don

t sce

r sc|\icccontaincf

rrf each defloyrblc corrponcnt. conplctc rhc lbllowing

\tcps ro cfeare n conpletely tiesh repositor]:

Click Ncx pplicatidr. md rctLrn to bullet 3 rbolc lo uf'load thc Er\R again A1 uti\ely you can Inanually click exch .par and .aar link lbllorved bl Add lo additionaL M.chincs' and sclccl your userxx nachine as thc cont:incr lbr dePovment

a . a a

In TBC() AclnrinisLfttor, scltct hc r?XX loldef Configuration fane

Click Undeploy irn.l OK Nrvigatc up ro

Lhc

r'pXX foldcr and deele

Lre

bwpxx pplicaon

M BWt: TIR(:O Br:itur\lrk.t tl

5l

ltntCrdian

3.

Deploy the b$pXX npplcarion corponenN using TIBCO Adminstralor.

. r

ln hc Canfigurdtan Brlldar pmcl tor rhc blgxI rpplicalion. click DephJ .nd thcn OK Orrce dcplolcd. vew tle Deploled Conlg.liion dcrals turd verify lh.rl the Deploynrenr
Status ndicarcs 'Syochfonized and Suocess lor alI con poncnts as showr belo$:

Troubleshoot Applicaion Deployment

r lf (he deploymcnt strtus is not \cccssi|, click Redeploy r IfrhlL docs nor wofk, tfy upoading thc EAR flc agan and the rcdcpoy I lfthal does nor work. use Designer lo validrlc thc proicct and rcbuild lhc EAR
rcupload the

filc. thcr

IAR

Lo

Adnnisrfatof and tfy deploying tht applcation agrin

flBC() Ldr. uin

t','t'rB

tab G: t)e\

ltk tt\rP \latioa

,1.

Vcrify bupXX appication conponcnl snrtup.

r l Admnisrntof.
e.Lch

go to AppLi.alon

>

ol

Lhc

^lanag.rrcn lbllowng rr".XX components arc Rerrirg (i not. stx|t thcn nrdlly):
- Crcditcheckservice - I'rocessorderservicc

Serrice Insta tes

1nd

vefily lhat

a . a . r .

uscrxx userxx us$XX

- Rereiveorders

userXX-SalcsOrderSubscriptionXX

Troubleshool Component Startup

la ler'ce

conuoncnL

coresponding

$ll norsL.ft ".tlrd filc locaLcd aL:

usng thcTIBCO Adninistmlof GUt, fun lhe

Afchive>.orrc C:\tibco\tra\doranscr\X\ap plication\b\rpXX\<Pmccss of ^daptef If rhc rdaplcr seNce compone.r wi nor sn|1 using thc conlnanc lilc: a U!ing a text cclilof. opcn iiic C:\ribco\rr\doran\uscfxx\application\bwtXX\

t
5.

SalcsOrdersubscriptid.t.r -ocatc Lhc tibco.env.CUSTOI-PATH entfy ard lerjty thal jr jncudes the l)llowing , c\: /o! dc 1e /P!duc L/ 10.2 , O /cIienE I/BIN

Subnrt ofdeh foffroccssing ard tcsl dcployncnl.

r r I

Submit a baLch order using LhcjnsTrisser.bt

a a a

Confin ircomng O.der Remlt filcs Conirm|.cccipl ofthe ordcf reslr in

a

lr
Lhe

each pfocessed

odel

StrbmiL a wcb ordcr uslngthc

Bw w.b Otd.j Page:

btrtrvser

Subrrit

qucfy usng lhe Ouefy A ofders link in rllc BW tveb Olet

Pqe.

Conlrm rcccipt ofrhe oder resut in the brcwscr Note: Thi! irdirectl)
LesLs Lhc adaptcr scrvice since this is he oonponenL aL wrLcs complered ofdeN to (he OfderDB.

Troubleshoot Runtime rrors

Check the TIBCO Adminislralor onlire log rccord\:

a a

?rd.ir8 ab perirnr a Search Since thc co po cnts arc now deployed, you will be ablc to ricw lhe delais ol rny furtine e|rols that rnay halc occ nd usin-lr thc 4r4.tu8 utlily
For each component, selecl and n the

il! serlicc link

BJ{I: TlCO Busitless\\ntk! tl

5l

lnkgrit)n

Notes

TIBCO E lu.ation Prcerdmt