IDP MD070 SPEP Integration Hub v0.5

8/12/2019 IDP MD070 SPEP Integration Hub v0.5

1/42

Integration Hub 11g

IDPSPEP

4 November 2010


2/42

IDP MD0700.5

DocumentTitle

SPEP: Integration Hub TDDDate

!reate"2/11/10

!reate" #$ Mark MorrellMo"i%e"

Date4/11/2010

&er'ion 0.5()cial(r"er

(b*ect

The objective o thi! "ocu#ent i! to outline the high$levelarchitecture/"e!ign or the %racle S%& Suite/'MISco#(onent! o the SPEP integration (roject) It inclu"e!gui"ance or "evelo(er! *ho *i!h to i#(le#ent an

interace or the (roject+ inclu"ing !te(! re,uire" to u!e theIntegration Hub 11g Error 'ra#e*ork) It outline! variou!architectural con!i"eration! to #eet the architecture"e-ne" in the high$level "ocu#ent (rovi"e" b. IDP or theSPEP integration (roject)

(vervie+Thi! "ocu#ent (rovi"e! architectural an" "e!ign gui"eline!or the Integration Hub 11g co#(onent! or the SPEPintegration (roject)

212)"oc Commercial-InConfdencePage 2 o 42


3/42

IDP MD0700.5

,MENDMENT HIST(- #/(!

3er!ionu#be

rDe!cri(tion o 5hange

Per!onMaking5hange

Date

0)1 Initial 3er!ion Mark Morrell 06/10/10

0)2

3ariou! u("ate! a! a re!ult o"i!cu!!ion! "uring the7ighto*/IDP/5S8 *ork!ho(! "uring*eek o 04$06 %ct 2010+ an" variou!!ub!e,uent "i!cu!!ion! bet*een IDP+5S8 an" 7ighto*)

Mark Morrell 21/10/10

0) &"" a#ing 5onvention!+ #ore "etailon !ervice la.er!


0)45hange "ocu#ent na#ing+ 9e!h outService a.er !ection! an" a"""iagra#!


0);3ariou! u("ate!+ inclu"ing "etailingo the IDP (a.loa" hea"er


-E&IE ,PP-(&,/ 3 DIST-I#TI(N /IST

a#e%rgani!ation

Title7ole


4/42

IDP MD0700.5

Enter Table o !ontent' Here

Table o !ontent'1 Intro"uction)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))

1)1 Pur(o!e))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))1)2 Sco(e an" &((roach))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))1) 5onte>t an" S.!te# De!cri(tion))))))))))))))))))))))))))))))))))))))))))))))))))))

2 I#(le#entation &rchitecture)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))62)1 %racle 'u!ion Mi""le*are ? %racle S%& Suite 11g)))))))))))))))))))))))))62)2 %racle @Develo(er 11)1)1)2)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))2) Service 5o#(onent &rchitecture


5/42

IDP MD0700.5

)2)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))) Integrit.))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))2;))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))) &uthentication

2;)4 &uthori!ation))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))2

); BSM Securit.)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))2);)1 Setu( o ne*

Error 'ra#e*ork))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))0)1 Aa!ic 'lo*))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))0)2 Event Data)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))0) &ttach#ent 'or#at))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))1

))1 &TT&5HMET E>a#(le)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))1)4 5on-guration o Error &ction!))))))))))))))))))))))))))))))))))))))))))))))))))))))1

)4)1 Deault E#ail 7eci(ient))))))))))))))))))))))))))))))))))))))))))))))))))))))))))2)4)2 Setting o I logo i#age)))))))))))))))))))))))))))))))))))))))))))))))))))))))))2)4) Setting o Error oti-cation E#ail logo i#age))))))))))))))))))))))))

); @Develo(er In!truction!))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))6 'ault Manage#ent)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))

6)1 Sche#a 3ali"ation))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))46)2 'ault Manage#ent 'ra#e*ork)))))))))))))))))))))))))))))))))))))))))))))))))))))4

6)2)1 !e o 'ault Manage#ent 'ra#e*ork or 7etr. 5a(abilit.)))));

6)2)1 Au!ine!! 5ontinuit.)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))); &u"it/&ctivit. og)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))

)1 %racle Enter(ri!e Manager


6/42

IDP MD0700.5

1 Intro"uction

1.1 Pur6o'e

Thi! "ocu#ent "e-ne! the High$evel Integration &rchitecture a((licableto the %racle S%& Suite/'MIS co#(onent! o the SPEP integration (roject)

1.2 Sco6e an" ,66roac

The "ocu#ent cover! the ollo*ing area!:

1) &n overvie* o the un"erl.ing i#(le#entation technolog. u!e" to(rovi"e an integration !olution+ in thi! ca!e %racle 'u!ionMi""le*are 11g


7/42

IDP MD0700.5

2 Im6lementation ,rcitecture

Thi! !ection o the "ocu#ent (rovi"e! an overvie* o the Integrationi#(le#entation architecture tool! to be u!e"


8/42

IDP MD0700.5

Figure 1.1 $e%resentation o& racle S# Suite 11g 'ec(nology Stac)

2.2 (racle


9/42

IDP MD0700.5

racle *PE+ Designer: 5reate an" "e-ne APE (roce!!e!

racle !ediator Editor: 5reate an" "e-ne a #e"iator!ervice co#(onent)

,uman 'as) Editor: De-ne Hu#an Bork9o* Ta!k co#(onent!

*usiness $ules Designer: De-ne an" bin" to %racle Au!ine!! ruleco#(onent!)

C# #da%ter iards: 3ariou! *iCar"! an" I! or con-guring thevariou! a"a(ter!)

2.8 Service !om6onent ,rcitecture =S!,>

& S%& co#(o!ite i! an a!!e#bl. o !ervice co#(onent!+ !ervice! an"reerence! "e!igne" an" "e(lo.e" together in a !ingle a((lication) Biringbet*een the!e !ervice!+ !ervice co#(onent! an" reerence! enable!

#e!!age co##unication) Each !ervice co#(onent i! ho!te" in it! o*n!ervice engine containerJ #e!!age! !ent to the !ervice engine aretargete" at !(eci-c !ervice co#(onent!) 'or e>a#(le+ a #e!!age !ent toa APE (roce!! i! !ent to the APE runti#e engine)

In the conte>t o S5& *ithin %racle S%& Suite+ the ollo*ing !erviceco#(onent! are available)

*PE+ %rocesses(rovi"e (roce!! orche!tration an" !torage o!.nchronou! or a!.nchronou! (roce!!) Kou "e!ign a bu!ine!!(roce!! that integrate! a !erie! o bu!ine!! activitie! an" !ervice!into an en"$to$en" (roce!! 9o*

*usiness $ulesenable the "e!ign o bu!ine!! "eci!ion! ba!e" onrule!)

,uman tas)J (rovi"e! *ork9o* #o"elling that "e!cribe! the ta!k!or u!er! or grou(! to (eror# a! (art o an en"$to$en" bu!ine!!(roce!! 9o*)

!ediatorroute! event! ten!ion!

212)"oc Commercial-InConfdencePage o 42


10/42

IDP MD0700.5

%racle S%& Suite (rovi"e! the ollo*ing technolog. a"a(ter! tointegrate *ith tran!(ort (rotocol!+ "ata !tore!+ an" #e!!aging#i""le*are:

A&M 'ile 'TP @ava Me!!aging Service


11/42

IDP MD0700.5

2.? (racle #PE/ =#u'ine'' Proce'' E9ecution/anguage> Proce'' Manager

%racle! i#(le#entation o the APE (roce!!ing language) !e" a! a toolto orche!trate a nu#ber o !ervice! together into bu!ine!! (roce!!e!)&l!o a! (art o it! APE i#(le#entation+ %racle ha! a (ro(rietaril."evelo(e" Hu#an Bork9o* tool an" i! tightl. integrate" *ith the %racleAu!ine!! 7ule! tool)

Each arteact (ro"uce" i! it!el a Beb Service that can be con!u#e"b. e>ternal (artie!)

Provi"e! #ore co#(le> unctionalit. to create con"itional logicchoice! *ithin a bu!ine!! (roce!! E)g) oo(+ Bhile+ I$Then$El!e etc

&ll "evelo(#ent occur! via @Develo(er)

2.7 (racle #u'ine'' -ule'%racle! i#(le#entation o a 7ule! engine) Enable! the "e-nition+u("ate+ an" #anage#ent o "eci!ion! an" (olicie! governing bu!ine!!(roce!!e! an" a((lication!


12/42

IDP MD0700.5

Dea"line!+ e!calation!+ noti-cation!+ -ltering+ (rioritiCation+re(ort!+ rea!!ign#ent!+ loa" balancing+ an" other eature!re,uire" b. !u(ervi!or!+ bu!ine!! o*ner! an" en"$u!er! to

#anage their ta!k!) SD allo*ing r"(art. a((lication! to utiliCe al#o!t all eature! o

S%& Suite! Hu#an Bork9o* ca(abilitie!)

2.C (racle eb Service' Manager Polic$ Manager =SMPM>

%racle BSM Polic. Manager (rovi"e! the inra!tructure or enorcing!ecurit. an" au"iting (olicie! in the Service Inra!tructure)

A. !ecuring variou! en"(oint! an" !etting an" (ro(agating i"entit.+ it!ecure! a((lication !ervice! an" (rovi"e! a Fcentrali!e"!ecurit./#anage#ent o the!e !ervice! that are not !tore" or tie" to their

i#(le#entation

%racle BSM Polic. Manager (rovi"e! a !tan"ar" #echani!# or !igning#e!!age!+ (eror#ing encr.(tion+ (eror#ing authentication+ an"(rovi"ing role$ba!e" acce!! control) Policie! can be change" *ithouthaving to change the en"(oint! or client! or the!e en"(oint!) BebService!+ inclu"ing !ervice! "evelo(e" in APE Proce!! Manager+Me"iator an" %racle Service Au! can all be (rotecte" b. %racle BebService Manager agent! an"/or gate*a.!)

'or *eb !ervice! that "o not (rovi"e their o*n Beb Securit.i#(le#entation+ !tan"ar" te#(late!


13/42

IDP MD0700.5

2.12 (racle Meta"ata Service' -e6o'itor$ =MDS>

The %racle Meta"ata Service! 7e(o!itor. i! e!!entiall. the un"erl.ing"ata !tore or %racle S%& Suite 11g) It !tore! bu!ine!! event "e-nition!+

%racle Au!ine!! 7ule! rule$!et!+ SD !che#a -le!+ ault bin"ing! an"(olic. "e-nition!+ ST tran!or#ation #a((ing!+ BSD "e-nition -le!or u!e acro!! the variou! integration co#(onent! i)e) %racle APE+Me"iator+ Au!ine!! 7ule! an" Beb Service! Manager)

2.18 (racle #u'ine'' ,ctivit$ Monitor =#,M>

%racle Au!ine!! &ctivit. Monitoring i! a !olution or buil"ing real$ti#eo(erational "a!hboar"! to #onitor bu!ine!! (roce!!e! an" !ervice!+!ervice! level!+ an" track ke. (eror#ance in"icator! :u'ion Mi""le+are!ontrol

I! a !et o #anage#ent tool! (rovi"e" *ith %racle S%& Suite+ the!e tool!ai" in the abilit. to: #onitor activit. acro!! certain (ro"uct "o#ain! !ucha! S5&+ APE+ Au!ine!! 7ule!+ A&M+ Me"iator an" %racle Service Au!+con-gure a((lication! an" "e(lo.e" co#(onent!+ con-gure (ro(ertie!+auto#ate a"#ini!tration ta!k! !uch a! "e(lo.#ent an" e>(o!e a *i"evariet. o a"#ini!tration an" (eror#ance "ata to ai" a"#ini!tration)'u!ion Mi""le*are 5ontrol i! a Beb bro*!er$ba!e"+ gra(hical u!erinterace that .ou can u!e to #onitor an" a"#ini!ter a ar#)



14/42

IDP MD0700.5

8 Integration Point De'ign

8.1 Service /a$er' an" De'ign Pattern'

The ollo*ing "iagra# (rovi"e! a vie* o ho* !o#e o the conce(t!

outline" in thi! "ocu#entJ Design Patternsan" Service Layerscan bebought together to "e!ign integration co#(onent! a((licable to the SPEPintegration)

Figure 1.3 Sam%le Integration Flo"4 (ig(lig(ting - Serice +ayers and Design Patterns

Three ba!ic !ervice la.er! *ill be i#(le#ente" or each integration (oint)Each !ervice la.er *ill contain a !ingle S%& co#(o!ite *ith a #ini#u# oone S%& co#(onent


15/42

IDP MD0700.5

3.1.1Event Services

&n Event Service "e!cribe! a bu!ine!! (roce!! !tate) It i! thenoti-cation that !o#ething ha! occurre" *ithin the !.!te#) 'or e>a#(le+client create"+ client u("ate"+ etc)

It i! the re!(on!ibilit. o the event !ervice to tran!or# the inco#ing#e!!age into a co##on "ata #o"el or#at) 'or e>a#(le+ i a clientcreation event i! receive"+ the event !ervice #u!t tran!or# the "atainto a co##on "ata #o"el u!ing an M re(re!entation)

'or !ervice! (rovi"e" b. 'MIS ternall.$vi!ibleen"(oint+ that *ill conor# to the Service 5ontract agree" or thatintegration (oint) Ti' e96o'e" 'ervice +ill re6re'ent "ata in te

:MIS ormat'tructure' an" te main ma66ing +ill be acieve"b$ te 'ervice con'umer -NT.

'or !ervice! (rovi"e" b. 7T (o!e" a! a *eb !ervice) The bu!ine!! !ervice! are then catalogue"*ithin the Service! Portolio to re(re!ent a (ortolio o re$u!able an"in"e(en"ent F!tan"ar"! ba!e" !ervice!)

Each bu!ine!! !ervice *ill ocu! on an in"ivi"ual bu!ine!! (roce!! a#(le+ aP/S &PI *ill re,uire the #e!!age to inclu"e the correct (ara#eter!an" or#at it re,uire!) To achieve thi!+ the #e!!age i! tran!or#e" ro#the co##on "ata #o"el or#at to an a((lication !(eci-c or#at the

bu!ine!! !ervice re,uire!)

212)"oc Commercial-InConfdencePage 1; o 42


16/42

IDP MD0700.5

'or !ervice! (rovi"e" b. 'MIS


17/42

IDP MD0700.5

2) Event Service tran!or#!/enriche! (a.loa" to conor# to thecanonical "ata #o"el or the interace interace+ u!e! a APE Proce!! co#(onent to

orche!trate the (roce!!+ invoking Au!ine!! Proce!!e! a! nece!!ar.to achieve the re,uire" unctionalit.)

4) Au!ine!! Service then:4)1) tran!or#!/enriche! the (a.loa" to the or#at a((ro(riate to

the target a((lication ternal a((lication "irectl. u!ing the Beb

Service e>(o!e" b. 7T u!ing a APE Proce!! co#(onent to



18/42

IDP MD0700.5

ca(ture !(eci-c error!+ (eror#! retrie!+ etc)) Thi! !erviceconor#! to the #ain Service 5ontract (re(are" b. 7T)

) 7e!(on!e then ollo*! the return (ath+ right back to the initialEvent Service+ *hich:)1) 'or a !ucce!! !tatu!+ u("ate! an. !ource "ata a! a((ro(riate+

to en!ure that tran!action/recor" i! #arke" a! (roce!!e")2) 'or a ailure+ !i#(l. continue! an" ter#inate! *ithout

u("ating the !ource recor"/tran!action)



19/42

IDP MD0700.5

4 Feneral eb Service Fui"eline'

4.1 Me''age E9cange Pattern'

Several integration (oint! have been "e-ne" bet*een 7ighto* an"'MIS) Each o the!e *ill be covere" b. a Service 5ontract+ an" theun"erl.ing !ervice *ill be either:

$ (rovi"e" b. 7Ighto* an" con!u#e" b. 'MIS$ (rovi"e" an" 'MIS an" con!u#e" b. 7ighto*

The current *orking a!!u#(tion i! that all !uch !ervice! *ill be o a7e,ue!t$7e!(on!e #e!!aging (attern+ an" *ill be !.nchronou! in nature(o!e" !ervice *ill behi""en ro# the !ervice con!u#er+ an" #a. involve !.nchronou!#e!!aging+ a!.nchronou! #e!!aging+ u!e o the S%& Suite &"a(ter'ra#e*ork+ etc)

4.2 ,ttacment'

%ne or #ore integration (oint! have been "e-ne" bet*een 7ighto* an"

'MIS+ *hich #a. inclu"e attach#ent! !uch a! a PD' contract "ocu#ent)It i! a!!u#e" that:

$ The!e attach#ent! *ill be !#all in !iCe

$ 'or "ocu#ent! attache" *ithin the 7T a((lication+ there i! nore!triction on the "ocu#ent t.(e) Ho*ever+ a*aiting con-r#ation

ro# 7T/IDP a! to *hether "ocu#ent t.(e or "ocu#ent! (a!!e"through via the 5lient Invoice 5reate interace *ill be e>(licitl.re!tricte")

The !che#a to !u((ort !uch attach#ent! *ill nee" to (rovi"e or aor#at *hich can be !u((orte" at both the con!u#er an" (rovi"er) Maino(tion! con!i"ere" or the tran!er or#at are Aa!e4$enco"e" !tring+S%&P attach#ent+ MT%M) The cho!en o(tion i! Aa!e$4 enco"ing)

4.8 !u'tom eb Service' ; Me''age Structure



20/42

IDP MD0700.5

Beb !ervice 7e,ue!t an" 7e!(on!e #e!!age! Q(a.loa"Rele#ent *ill incor(orate the IDP !tan"ar" hea"er a! (er theollo*ing SD:

Thi! ele#ent i! an a((lication$level ele#ent+ an" *ill be containe" *ithinthe S%&P bo". o the #e!!age) The "etaile" "ata re,uire#ent! or the!eele#ent! *ill be !(eci-e" in the high$level IDP &rchitecture !(eci-cation+but are "e!cribe" here in ter#! o ho* thi! hea"er *ill be incor(orate" into the S%& Suite architecture)

".3.1#eader E$e%ent &na$ysis

ote ? the current a!!u#(tion i! that all 7T$(rovi"e" *eb !ervice! *illbe %%TA+ an" hence *ill not contain thi! hea"er+ thereore no (rovi!ion i!#a"e or the!e ele#ent! or 7T$ho!te" *eb !ervice!) The ollo*ingtable cover! *eb !ervice! ho!te" b. %racle S%& Suite)

Element &alue=-eGue't>

&alue=-e'6on'e>

organisationID Set b. 7T client

Set to O02

http://www.w3.org/2001/XMLSchemahttp://www.idp.com/messages/common/V1/commonHeaderhttp://www.idp.com/messages/common/V1/commonHeaderhttp://www.w3.org/2001/XMLSchemahttp://www.idp.com/messages/common/V1/commonHeaderhttp://www.idp.com/messages/common/V1/commonHeader


21/42

IDP MD0700.5

targetSystemID Set b. 7T client

messageIdentifer Set b. 7T client Set u!ing S%& Suitee>ten!ion unction+

generate$gui"correlationIdentifer Set b. 7T client eave blank


22/42

IDP MD0700.5

,66licationS$'tem Name ,bbreviation&ccount! 7eceivableStu"ent Place#ent E>(an!ion

ProjectSPEP

%racle APE Proce!! Manager APE

Service 5o#(onent &rchitecture S5&Event Deliver. et*ork EDAu!ine!! 7ule! 7

NoteI arteact! cro!! unctional boun"arie! then the FSPEP a((licationabbreviation !houl" be u!e")

".'.1S*& &rtefacts

a#ing convention! "e-nition! to "e!cribe the ollo*ing object!:$

S(, (b*ect Naming :ormat!onvention E9am6leTechnolog.'or#at

&"vance" ueue: &Databa!e: DA

@ava Me!!aging Service: @MS'ile Tran!er Protocol: 'TPBeb Service: BS

SD


23/42


24/42

IDP MD0700.5

'or "evelo(#ent (ur(o!e!+ to !ecure the S%& !erver runningin!i"e Bebogic Server+ the "eault ke.!tore

ba!ic cre"ential! ? "etail! in later !ection)



25/42

IDP MD0700.5

?.4 ,utori'ation

There i! no re,uire#ent or the *eb !ervice! to be authori!e" ?authentication i! con!i"ere" to be a"e,uate !ecurit.)

?.5 SM Securit$

%verall architecture/a((roach i! a! ollo*!:

$ Policie! are #anage" through a !ingle a"#ini!tration con!olet #echani!# i!!u((orte")

o Polic. oracle/*!!u!erna#etokenover!!l!ervice(olic.)Thi! (olic. u!e! the cre"ential! in the BS$Securit.!erna#eToken S%&P hea"er to authenticate u!er! again!tthe %racle Plator# Securit. Service! con-gure" i"entit.!tore) The (olic. veri-e! that the tran!(ort (rotocol (rovi"e!SS #e!!age (rotection) Aoth (lain te>t an" "ige!t#echani!#! are !u((orte") Thi! (olic. can be attache" toan. S%&P$ba!e" en"(oint) It i! likel. that thi! *ill be the

"eault (olic.+ a! it i! re,uire" that the *eb !ervice! are!ecure" over SS


26/42

IDP MD0700.5

The (lain te>t #echani!# i! !u((orte") The (olic. al!o u!e!SS or achieving tran!(ort la.er !ecurit.) Ti' +ill be te"eault 6olic$ a' it i' reGuire" tat te +eb 'ervice'are 'ecure" over SS/ =HTTPS>.

$ The onl. !ervice! *hich nee" to be (rotecte" are tho!e *hich

e>(o!e a S%&P en"(oint) It i! the!e en"(oint! *hich !houl" be!ecure"+ !o or tho!e S%& co#(o!ite! *hich are onl. in!tantiate"via the !ub!cri(tion to an (o!e a S%&P en"(oint nee" to be !ecure") To!ecure a !(eci-c !ervice:

$ 'ro# @Develo(er+ o(en u( the relevant co#(o!ite to be !ecure" (o!e" Service! *ithin @Develo(er

o Save+ re"e(lo. an" te!t WR


27/42


28/42

IDP MD0700.5

o To check (olic. i! enorce" correctl.+ #o"i. theba!ic)cre"ential! to (rovi"e incorrect (a!!*or"+an" rete!t theclient co#(o!ite) Thi! ti#e+ it !houl" ail) 7e#e#ber to re!etthe cre"ential! back to correct value!)))X

ote: the (olicie! con-gure" via @Develo(er !houl" be retaine" or both"irect "e(lo.#ent to the !erver via @Develo(er


29/42

IDP MD0700.5

7 Error :rame+orA

The Error 'ra#e*ork i! (rovi"e" to allo* a((lication! to log error!+ *hichcan then be noti-e" a#(le+ e#ail= to con-gure" reci(ient!)

7.1 #a'ic :lo+

The ba!ic 9o* i! a! ollo*!:$ 5lient a((lication (ubli!he! a BriteError event to the ED


30/42

IDP MD0700.5

e>a#(le

7.8 ,ttacment :ormat

The &TT&5HMET -el" allo*! or a 9e>ible nu#ber o:$ 5olu#n!$ 7o*!

In the e#ail attach#ent+ the!e are or#atte" into an HTM table)

To "e-ne the hea"er! or the table colu#n!+ (rovi"e the -r!t (art o the&TT&5HMET !tring ba!e" on the ollo*ing:

HE&DE71ZHE&DE72ZHE&DE7ZYE%YZ

Thi! *ill give a table *ith colu#n!+ *ith hea"ing! HE&DE71+ HE&DE72an" HE&DE7 re!(ectivel.)

'or the actual "ata+ thi! can be an. nu#ber o ro*!) 'or each ro* o "atain the table+ thi! re,uire! or#atting in the &TT&5HMET !tring ba!e" onthe ollo*ing:

3&E1Z3&E2Z3&EZYE%YZ

ote that the nu#ber o value! !(eci-e" !houl" #atch the nu#ber o

colu#n! a#(le+ =)

.3.1&00ME0 E4a%($e

I .ou re,uire an attach#ent table *ith colu#n!+ an" 4 ro*!+ lookingor e>a#(le like:

Message Type Ref Id

School Info ref001

then the &TT&5HMET !tring !houl" be:

Me!!age T.(eZ7eI"ZYE%YZSchool InoZre001ZYE%YZ

7.4 !on%guration o Error ,ction'

The Error &ction! can be con-gure" u!ing the Integration Hub I+ e)g)htt(://Qho!tna#eR:6001/integui/ogin)j!(

The login i! t.(icall.:$ integration/*elco#e1



31/42

IDP MD0700.5

Thi! u!erna#e/(a!!*or" i! #aintaine" in the !er!/8rou(! othe "eault real#) To #aintain thi! u!erna#e/(a!!*or":

$ ogin to BS 5on!ole$ Select Securit. 7eal#!+ an" then click on V#.real#V i!ting Error &ction recor"+ !elect the relevantSource/5ategor./T.(e co#bination+ an" #o"i. the relevant value! an"hit the O!ave button/i#age)

ote: the I i! !etu( to onl. allo* e"iting o e>i!ting co#bination! oSource/5ategor./T.(e) I a ne* co#bination i! re,uire" to be (rovi"e"+thi! #u!t be a""e" "irectl. into the ITE8PS "ataba!e !che#a+u!ing a S in!ert !uch a!:

In!ert into E77%7&5TI%S


32/42

IDP MD0700.5

.".2Setting of /I $ogo i%age

The I u!e! a logo on the #ain !creen

o )))ÎH11g^trunkÊrrorHan"lerÎntegrationÎ^(ublicht#lî#age!^5%MP&K$logo)gi

o 7ebuil" the Io 7e"e(lo. the I to the !erver

.".3Setting of Error oti5cation E%ai$ $ogo i%age

The error e#ail! (rovi"e" b. the Error 'ra#e*ork e#(lo. a logo in theto($let o the e#ail bo".) Thi! logo i! !ource" ro# the !a#e location a!

the I logo i#age)

7.5 !"

an" en!ure O5o(. To Project checkbo> i! "e!electe"$ 5lick %k$ 'ro# the T.(e 5hoo!er *in"o*+ !elect the

OBriteErrorProce!!7e,ue!t+ an" !elect %$ Double$click on the ne*l.$create" Me"iator+ an" a"" a ne* Static

7outing 7ule ecute o(eration=$ Select Event a! the Target T.(e$ 'ro# the Event 5hoo!er *in"o*+ bro*!e or Event De-nition -le!+

an" -n" the relevant "e-nition -le in the 7e!ource Palette:ErrorHan"lerEventDe-nition)e"l+ an" en!ure O5o(. To Projectcheckbo> i! "e!electe"

$ 5reate a ne* #a((er -le


33/42

IDP MD0700.5

!ent to the BriteErrorPubli!h #e"iator en"(oint) 'ore>a#(le+ ro# a APE co#(onent+ create an Invokeactivit. to the BriteErrorPubli!h (artner link+ an" a!!ign

"ata ele#ent! a! a((ro(riate)

@ :ault Management

In general+ ault!/error! *ill be (a!!e" bet*een 7ighto* an" S%& eithera! a S%&P ault or a! an e>(licit error co"e *ithin the !tan"ar" IDPHea"er

@.1 Scema &ali"ation

Bith %racle S%& Suite a! the !ervice (rovi"er+ !che#a vali"ation *ill

re!ult in a S%&P ault//sc(emas.oracle.com/9%el/extension?remoteFaultV= beingreturne" back to the con!u#er ce(tion:oracle)ti()#e"iator)inra)e>ce(tion)Me"iatorE>ce(tion: %7&MED$010:\Pa.loa" "eault !che#avali"ation error]SD !che#a vali"ation ail! *ith error Invali" te>t U1U in ele#ent: Uin(utUPo!!ible 'i>:'i>(a.loa" an" re!ub#it)Q/!u##ar.RQ/(artRQ(art na#eWV"etailVR

Q"etailRInvali" te>t U1U in ele#ent: Uin(utUQ/"etailRQ/(artRQ(art na#eWVco"eVRQco"eRnullQ/co"eRQ/(artRQ/re#ote'aultRQ/b(el'aultR

Thi! cannot be caught b. the S%& co#(o!ite it!el+ a! the !che#evali"ation i! achieve" b. the (lator# beore (a!!ing control to the S%&co#(o!ite+ !o thi! *ill not in the out$o$the$bo> ca!e (ro"uce an errornoti-cation) Ho*ever+ the re!(on!e back to the !ervice con!u#er


34/42

IDP MD0700.5

The S%& 11g 'ault Manage#ent 'ra#e*ork (rovi"e! (olic."riven ault han"ling) Thi! avoi"! the i#(licit error han"ling*hich ha" to be co"e" into+ or e>a#(le+ APE (roce!!e!+ in

(reviou! S%& Suite relea!e!)

6.2.1 /se of Fau$t Manage%ent Fra%e!or7 for Retrya(ai$ity

There i! a re,uire#ent to i#(le#ent a retr. ca(abilit. *ithin the IDParchitecture+ to allo* or te#(orar. unavailabilit. o re!ource! cee" theoverall ti#eout con-gure" or the !.nchronou! invocation o the !ervicero# the con!u#er #l -le or *ith the S.!te# MAean Aro*!er!etting o oracle)a!)!oainra)con-g:t.(eWAPE5on-g+na#eWb(el in%racle Enter(ri!e Manager 'u!ion Mi""le*are 5ontrol 5on!ole) I theAPE (roce!! !ervice co#(onent "oe! not receive a re(l. *ithin the!(eci-e" ti#e+ then the activit. ail!)

6.2.1Business ontinuity

The bu!ine!! nee"! to be (rotecte" an" able to continue in ca!e! *hereone or other o the !ource an" target !.!te#! are "o*n) 'or e>a#(le+*hen a !ervice i! being invoke" on a target *here the !ervice con!u#eri! u( but the !ervice (rovi"er i! currentl. "o*n)

'or e>a#(le+ or client relate" unctionalit.+ let! a!!u#e that 57M i!"o*n but 'MIS/S%& i! u() In thi! ca!e+ i the 57M i! te#(oraril.unavailable+ or client invoicing+ thi! invoicing *oul"/coul" be "eerre"

until the 57M beco#e! available) Ho*ever+ or the ca!e *here the-nancial !tatu! o a client ha! change"+ the ba!ic eAS unctionalit. *hich



35/42

IDP MD0700.5

re(re!ent! thi! change in !tate !houl" !till go ahea" ? eAS in thi!!en!e i! not a*are


36/42

IDP MD0700.5

C ,u"it,ctivit$ /og

&u"iting an" log! are available ro# the ollo*ing) 'or ull ca(abilitie!+!ee:

(racle :u'ion Mi""le+are&"#ini!trator! 8ui"e or %racle S%& Suite11g 7elea!e 1


37/42

IDP MD0700.5

C.2 :ileba'e" logging

S.!te# log -le! are *ritten auto#aticall. b. %racle S%& Suite) The levelo logging i! con-gurable) 8enerall.+ the!e log! are u!e" or trouble$!hooting+ an" *oul" not be u!e" or au"iting)



38/42

IDP MD0700.5

10Hig,vailabilit$

& clu!tere" %racle Bebogic Integration a((lication (rovi"e!!calabilit. an" high availabilit.) & highl. available "e(lo.#ent ha!recover. (rovi!ion! in the event o har"*are or net*ork ailure!+ an"(rovi"e! or the tran!er o control to a backu( co#(onent *hen a ailureoccur!)Aa!ic a!!u#(tion! are:

$ n"erl.ing "ataba!e! are 7&5$enable"$ !e o har"*are loa" balancer$ Share" Storage) The ED8


39/42

IDP MD0700.5

11S(, 11g ; 'e o MDS

The S%& MDS a#(le+ i .ou have aM.Project/>!"/M.Sche#a)>!" -le in the @&7 -le+ then thi! -le i! "e(lo.e"un"er the /a((! na#e!(ace on the !erver) Bhen .ou reer to thi! artiactin %racle @Develo(er u!ing an S%&$MDS connection+ the 7 beco#e!ora#"!:/a((!/M.Project/>!"/M.Sche#a)>!")

ote: it i! reco##en"e" that a !e(arate S%& (roject i! create" or the#aintenance/"e(lo.#ent o !hare" artiact!) The (roject *ill be u!e"!olel. or thi! (ur(o!e+ i)e) the (roject !houl" not contain an. S%&

co#(o!ite!)

Data *hich !houl" be co##on acro!! #ulti(le S%& (roject!/co#(o!ite!!houl" be a""e" e>(licitl. to thi! !e(arate (roject+ "e(lo.e"+ thenreerence" via the /a((! na#e!(ace on the !erver) E>a#(le! *oul"inclu"e co##on SD!+ an" co##on error (olicie!) De(en"ing onre,uire#ent!+ the!e coul" be "e(lo.e" to a /a((!/co##on na#e!(ace+or #ore !(eci-call. /a((!/co##on/>!"+ an" !o on)Data *hich i! !(eci-call./logicall. a!!ociate" *ith a (articular S%&(roject+ but nee"! to be reerence" b. a !#all nu#ber o other S%&co#(o!ite! !houl" be reerence" ro# tho!e (roject!+ but "e(lo.e" toMDS via the !e(arate MDS (roject *ith a conte>t re9ecting the !ource(roject+ e)g) /a((!/&A5Service/>!")



40/42

IDP MD0700.5

11.2.2 #o! to De($oy Shared Metadata

The general (roce!! i! a! ollo*!:

$ 5reate a @&7 (ro-le an" inclu"e the artiact! to !hare)See !ection 4)4)1)1 o E10224$01) ote ? thi! i! a !i#(le jar -le

containing the co##on artiact!+ organi!e" into na#e!(ace! to re9ectthe !ource o that arteact)

$ 5reate a S%& bun"le that inclu"e! the @&7 (ro-leSee !ection 4)4)1)2 o E10224$01) ote ? thi! i! a !i#(le jar -le

containing the co##on artiact!+ organi!e" into na#e!(ace! to re9ectthe !ource o that arteact)

$ De(lo. the S%& bun"le to the a((lication !erver

See !ection 4)4)1) o E10224$01) Thi! give! in!truction! on ho*to "e(lo. ro# @Develo(er+ 'or auto#ate" "e(lo.#ent+ once the relevantIP -le! ha! been create"+ thi! can be "e(lo.e" in e>actl. the !a#e *a.a! an. other S%& Aun"le) The target S%& Suite environ#ent *illauto#aticall. "e(lo. the #eta"ata to the DA$ba!e" MDS or that S%&!erver)

11.8 Ho+ to 'e Sare" Meta"ata

See !ection 4)4)2 o E10224$01+ %racle 'u!ion Mi""le*are Develo(er!8ui"e or %racle S%& Suite+ 11g 7elea!e 1


41/42

IDP MD0700.5

11.4 De6lo$ment Note

'or all S%& artiact! "e(lo.e" an" u!e" in thi! *a.+ the co##onS%& (roject #u!t be "e(lo.e" beore the "e(en"ent S%&

co#(o!ite!)



42/42

IDP MD0700.5

12(6en an" !lo'e" I''ue' or ti' Deliverable

12.1 (6en I''ue'

ID I''ue -e'olution -e'6on'ibilit$ Target Date Im6act

Date

1 &*aiting IDP&rchitecture "ocu#ent+to cro!!$reerence an"en!ure architecturalre,uire#ent! are #et)Thi! !houl" inclu"e

na#e!(ace na#ing!tan"ar"!)

2 &*aiting con-r#ationa! to t.(e o"ocu#ent! to be(a!!e" ro# 7T toeAS e" to PD'+ orgeneral binar."ocu#ent o an.or#at allo*e"_=

; &*aiting con-r#ationa! to *hether 7T$ho!te" Beb Service!*ill be %%TA or cu!to#

12.2 !lo'e" I''ue'

ID I''ue -e'olution -e'6on'ibilit$ Target Date Im6act

Date

&!!u#e" clu!tering oS%& Suite i! out o!co(e ? a*aitingcon-r#ation

%ut o !co(e

4 Heartbeat !ervice ?

a*aiting con-r#ationa! to *hether thi! i!re,uire"

%ut o !co(e

Documents

IDP MD070 SPEP Integration Hub v0.5