Business Services Service Consumer RI_AdressBookManager

Configuration
You should have a functioning WebDev setup. The E1 Client installation path should have a directory as follows:
C:\b\dv!1"\ini\sbf.
This directory contains a nu#ber files which should be configured correctly. $f your WebDev feature is functioning% your &db&.ini and
tnsna#es.ora used in the conte't of your WebDev feature can be used to configure these files.
NOTE: Make sure you do not have a JAS.INI in this directory. If you do, please reove it
(elow shows how your \dv!1"\ini\sbf\&deinterop.ini should be configured.
[SERVER]
glossaryTexServer!"SC#AB$%&'() Where )*C+,(- is #y Enterpise *erver and ./10 is the E1 port nr
as stated in the 12DE3ET4 of your &de.ini
code*age!(+$+
[,-E.ET]
service.ame#isen!&&&/ Ta5e note of this 6ort 3r. This is the port nr we will use to configure the
local 7C0& server.
service.ameConnec!&'()
ener0riseServerTimeou!1''''
max*oolSi2e!3'
max4ernelRanges!(
[,-E.ET_4ER.E#_-E5(]
krnl.ame!SB5Server,ava 4ernel
0rocessClass.ame!oracle6e(67ssv8oundaion6im0l69dene6SB5Server,ava4ernel
sarMessageRange!(&+'(
endMessageRange!(&)$'
max.um7er:8T;read!('
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< -e8ine Cac;e 8eaure 8or Connecor
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[CAC=E]
>serSession!(?''''''
S0ecEx0ire!3''''''''
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< -e8ine ;e 8eaures 8or in7ound Business 5uncion call
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[I.TER:*]
ener0riseServer!#:CA#=:ST
0or!&'()
manual_imeou!3'''''''
Re0osiory!c%@connecor@re0osiory
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< -e8ine ;e 8eaures 8or ou7ound evens
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[EVE.TS]
0or!&'('
#isenerMaxConnecion!(''
#isenerMaxAueueEnry!(''
ou7ound_imeou!&''''''
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< ,.-I in8ormaion 8or communicaion Bi; ;e ,+EE server6
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
iniialConex5acory!com6i7m6Be7s0;ere6naming6CsnIniialConex5acory
9ndi*rovider>R#!cor7aloc%iio0%local;os%+?'1
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< >R# 8or communicaing Bi; ;e even clien service6
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
evenService>R#!;0%DDlocal;os%1'?'De(evensDEvenClienService
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< Securiy Server6 Securiy server 0or is in [,-E.ET]
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[SEC>RITE]
.umServers!(
SecuriyServer!"SC#AB$
(
Business Services Service Consumer RI_AdressBookManager
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< :CMEna7ledFFI Bill en8orce Connecor o use :CM o 8ind
< ener0riser server or use seing in [Inero0]secion6
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[:CM]
:CMEna7led!rue
[TRA.SACTI:.S]
Rea0Inerval!$
MaxAge!('
[CEB -EVE#:*ME.T]
Ce7-evelo0men!TR>E
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< T;ese seings are 8or Async =TT* call7ack 8rom
< ;ird 0ary sysem o BSSV server6
< =TT*Call7ackEnd0oinFT;is seing conains ;e serverG
< 0or and conex roo in8ormaion 8or ;e BSSV server6
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[=TT*Call7ackSeings]
=TT*Call7ackEnd0oin!local;os%????D#:CA#-EV
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
< T;ese seings are 8or Async =TT* Bi; SS#
< keysore8ile F T;is seing Bill 7e ;e 0a; o ;e
< keysore 8ile6
< keysore0assBd F T;is seing Bill 7e ;e keysore 0assBord6
< keyalias F T;is seing Bill 7e ;e keysore alias name6
< ceri8icae0assBd FT;is seing Bill 7e ;e keysore
< cericae 0assBord6
< russore8ile F T;is seing Bill 7e ;e 0a; o ;e
< russore 8ile6
< russore0assBd F T;is seing Bill 7e ;e russore
< 0assBord6
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[4EEST:RE]
keysore8ile!
keysore0assBd!
keyalias!
ceri8icae0assBd!
[TR>ST_ST:RE]
russore8ile!
russore0assBd!
$8679T,3T 37TE: #a5e sure that your E1 Client \syste#\&d5 and \syste#\&re have the correct version. ,s of Tools 9elease !.:%
this should be at version -./ ;2D< 1.-=. ,n incorrect version of 2D< will cause consu#ing a (usiness *ervice deployed to the local
2Developer 7C02 to fail6
Changes to the local startOC4J.bat
Edit your E1 Client >':\b\7C02\start7C02.bat? file as follows. Your original >start7C0&.bat? file should loo5 as follows:
0us;d HId0'
call seenv67a
0o0d
0us;d HId0'9+ee@;ome
se *AT=!HId0'66@,-4@7inJH*AT=H
sar K:C), =)AK DB K66@66@66@,-4@7in@9avaK KF-;060roxy=os!H(K KF-;060roxy*or!H+K KF-;060roxySe!H3K
F-;06non*roxy=oss!H) KF-;0s60roxy=os!H$K KF-;0s60roxy*or!H&K KF-;0s60roxySe!H/K F-;0s6non*roxy=oss!
H? KFL7ooclass0a;D0%HC*HK KF9arK Koc)969arK
0o0d
Change the bat file as shown below ;so no http pro'y para#eters are re@uired=.
0us;d HId0'
call seenv67a
0o0d
0us;d HId0'9+ee@;ome
se *AT=!HId0'66@,-4@7inJH*AT=H
sar K:C), =)AK DB K66@66@66@,-4@7in@9avaK KFL7ooclass0a;D0%HC*HK KF9arK Koc)969arK
0o0d
Note: If you are using jdeveloper 10.1.3.4 then you must change the .bat file as above. This change shouldnt be re!uired if
you specify "#ro$y Information %hen deploying the application &If you are using jdeveloper 10.1.3.' ( see #age 1').
+
Business Services Service Consumer RI_AdressBookManager
Steps to run the example
This docu#ent is based on using the E1 user id 2DE and environ#ent DA!1". 2DE is the user that logs in onto E1 and runs the
e'a#ple. The environ#ent the users logs into is DA!1". $f you follow this docu#ent to the letter% you should also use a user 2DE and
log on to a DA!1" environ#ent.
$f you have already atte#pted to deploy a (* ob&ect to your local 2Developer 7C0& instance% so#e files would have been created in
your E1 client install directory. $t is advisable to re#ove these files so all re@uired files are regenerated correctly. The presence of
these files #ight also cause error while deploying the (usiness *ervices to the local 7C0& instance.
Delete the following files or folders if they e'ist:
C:\b\syste#\7C02\&"ee\ho#e\applicationBdeploy#ents\E1*ervicesB+7C,+DEA
C:\b\syste#\7C02\&"ee\ho#e\applications\E1*ervicesB+7C,+DEA
C:\b\syste#\7C02\&"ee\ho#e\applications\E1*ervicesB+7C,+DEA.ear
$f you have already chec5edBout any business services% rena#e the >c:\b\dv!1"\&ava? folder. We will chec5 out a nu#ber of (usiness
*ervices. This will reBcreate the >&ava? folder with only the (usiness *ervices we need in this e'a#ple.
The following ob&ects #ust be in your 78W 6ro&ect ;pro&ect is status "1=:
269/1///
29/1//1/
29/1//"/
29/1//C/
29/1//0/
29D/$C/
29D/$C1
Ero# 78W% go to design for ob&ect 269/1///. Ero# 78W Design% select >$nvo5e 2Developer? to start 2Developer.
3
Business Services Service Consumer RI_AdressBookManager
$n 2Developer% DA!1" application should contain 269/1/// pro&ect with all it?s classes. $f that?s not the case% rightB#ouseBclic5 on the
DA!1" application and select the >3ew Enterprise7ne 6ro&ect? and select 269/1///.
)
Business Services Service Consumer RI_AdressBookManager
E'pand the 269/1/// pro&ect. 9ightB#ouseBclic5 on 9$F,ddress(oo58anager.&ava and select the >Create 2"EE Web *ervice?.
$
Business Services Service Consumer RI_AdressBookManager
Clic5 >o5?
&
Business Services Service Consumer RI_AdressBookManager
)ive a na#e to your Web *ervice. Gse the sa#e na#e as in this screenshot. This na#e is used in further steps
/
Business Services Service Consumer RI_AdressBookManager
Change the >*7,6 8essage Eor#at? to >Docu#entH+iteral?and clic5 >Einish?
?
Business Services Service Consumer RI_AdressBookManager
Deploy#ent. $n order to deploy the application to the e#bedded 2Developer 7C0&% the application needs to be >running?. 9ight #ouse
clic5 on the >Test9$,(8anager? service and >9un?
1
Business Services Service Consumer RI_AdressBookManager
7nce the service is running% ta5e note of the target G9+. This will be used in further steps
('
;0%DDgscla7&%?1?1DconexFrooF,*R'('''DTesRIABManagerSoa0=0*or
Business Services Service Consumer RI_AdressBookManager
7nce the service is running?% rightB#ouseBclic5 on the application ;DA!1"= and select >Deploy Develop#ent (**A *erver?
((
Business Services Service Consumer RI_AdressBookManager
$f you use 2Developer 1/.1.C."% you will need a pro'y server. Ero# 1/.1.C.C% this is not re@uired.

(+
Business Services Service Consumer RI_AdressBookManager
7nce the deploy#ent is co#pleted% the >,pache ,nt I log? window will show the status >(G$+D *GCCE**G+?
(3
Business Services Service Consumer RI_AdressBookManager
,fter you deploy the application% the service will be stopped. You will need to reBstart it : rightB#ouseBclic5 on the Test9$,(8anager
service and clic5 >9un?
3ote: When Develop#ent (**A *erver is deployed% it creates an ,pplication within 7,* na#ed E1*ervicesB
+7C,+DEA. With deploy#ent the configuration files are included fro# the sbf\ini directory that contain the 6ort
nu#ber used for pinging the local (**A server ;default ...:=. 7nce deployed% the port beco#es open and you
should be able to ping the local server. , way to verify the port is open and ready is to run the following fro# a
co##and pro#pt: telnet localhost ...:
This should return so#e characters in a window which validates the port is now opened.
Within the E1 Client % 9un 6!.11/% version J2DE///C. *elect the >*yste#? 7C8

()
Business Services Service Consumer RI_AdressBookManager
Create an entry as follows : note the port nu#ber. This #ust have the sa#e value as the value set in the 12DE33ET4 section of your
&deinterop.ini ;see page 1 of this docu#ent=. You should be able to >6ing? the server and get a >6ing Test was *uccessful? response.
NOTE: There have !een soe issues in soe custoer environents "here the Server #O$A#%OST cannot !e used. So
enter the I& address of the local achine in the Server nae field. Also, you ay need to enter a server under the Server
Map data source, this depends on "here you are pointin' to in your ini files.
($
Business Services Service Consumer RI_AdressBookManager
*tart E1 WebDev. 9un 6-1///. You should have a >*ervice 6roperty? record as follows :
(&
Business Services Service Consumer RI_AdressBookManager
9un 6-0///. Eor user 2DE and Environ#ent DA!1"% create an >softBcoding? record as follows :
*oftBcoding K8+ details: note that the >end point? ;#ar5ed in red= #atches the G9+ 2Developer created when the service was
generated ;see page 11 if this docu#ent=
M0orFin8oN
Msu7F0ro0eryN
MnameN9avax6xml6r0c6service6end0oin6addressMDnameN
MvalueN;0%DDgscla7&%?1?1DconexFrooF,*R'('''DTesRIABManagerSoa0=0*orMDvalueN
MDsu7F0ro0eryN
MBsdlF0or names0ace>RI!K;0%DDoracle6e(67ssv6,*R'('''DK local0ar!KRI_AddressBookManager=0*orKDN
Mo0eraionsN
Mo0eraion name!OaddAddressBookON
MDo0eraionN
Mo0eraion name!OaddAddressBookAnd*arenON
MDo0eraionN
Mo0eraion name!OgeAddressBookON
MDo0eraionN
MDo0eraionsN
MD0orFin8oN
(/
Business Services Service Consumer RI_AdressBookManager
You are now ready to run the test. 9un 6-0//1. Enter a valid address boo5 nu#ber and clic5 >get,ddress(oo5$nfo?
(?
Business Services Service Consumer RI_AdressBookManager
$t will ta5e a few #o#ents before you get a response. $f all is wor5ing as e'pected% you will get a response as follows:
(1