8/12/2019 IDP MD070 SPEP Integration Hub v0.5
1/42
Integration Hub 11g
IDPSPEP
4 November 2010
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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!
Mark Morrell 2/10/10
0)45hange "ocu#ent na#ing+ 9e!h outService a.er !ection! an" a"""iagra#!
Mark Morrell 02/11/10
0);3ariou! u("ate!+ inclu"ing "etailingo the IDP (a.loa" hea"er
Mark Morrell 04/11/10
-E&IE ,PP-(&,/ 3 DIST-I#TI(N /IST
a#e%rgani!ation
Title7ole
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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/12/2019 IDP MD070 SPEP Integration Hub v0.5
8/42
IDP MD0700.5
Figure 1.1 $e%resentation o& racle S# Suite 11g 'ec(nology Stac)
2.2 (racle
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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!
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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!
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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#)
212)"oc Commercial-InConfdencePage 1 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
16/42
IDP MD0700.5
'or !ervice! (rovi"e" b. 'MIS
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
212)"oc Commercial-InConfdencePage 1 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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)
212)"oc Commercial-InConfdencePage 16 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
212)"oc Commercial-InConfdencePage 1 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
212)"oc Commercial-InConfdencePage 20 o 42
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/commonHeader8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
23/42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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)
212)"oc Commercial-InConfdencePage 24 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
27/42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
212)"oc Commercial-InConfdencePage 0 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
32/42
IDP MD0700.5
.".2Setting of /I $ogo i%age
The I u!e! a logo on the #ain !creen
o )))^IH11g^trunk^ErrorHan"ler^Integration^I^(ublicht#l^i#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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
212)"oc Commercial-InConfdencePage 4 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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)
212)"oc Commercial-InConfdencePage o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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/>!")
212)"oc Commercial-InConfdencePage o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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!)
212)"oc Commercial-InConfdencePage 41 o 42
8/12/2019 IDP MD070 SPEP Integration Hub v0.5
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