login vào Service Designer thì tr c tiên ta ph i login vào Webtool : 1. Truy c p vào đ a ch URL :
http://hostname:7777/webtool/login.uix
Chú ý : port default là 7777, nh ng nó có th thay đ i tùy thao h th ng mà ta cài đ t, nh ng nó ch dao đ ng trong kh ang (7777 ---- 7877).
2. Nh p vào username và password . Chú ý : username defualt : orcladmin
Password là password mà ta đã đnh ra khi cài đ t.
Sau khi đã đ ng nh p thành công thì ta th y tên webtool có 3 tab là : User Manager, Service Designer và Content Manager. Ta ch n tab Service Designer s th y có các tab con sau : Ü Master Services Ü Data Feeders Ü Master Alerts Ü Data Feeders Ü Logical Devices Ü Preset Definitions Ü Transformers Ü Adapters Ü Regions Hình 3.2.3: Service Designer 3.3.3 Qu n lý Master Service
Ch n Master Service tab. Trong tab này cho phép ta t o, edit, debug, …. Master Service và Folder. Và ta c ng có th test các master trên simulator. Khi ch n tab này ta s th y m t b ng bao g m các thành ph n sau :
Ü Type : lo i đ i t ng
Ü Name : tên hi n th c a service hay folder. Ü Object ID : OID c a master service
Ü Adapter : adapter c a master service
Ü Test : click vào bi u t ng đi n tho i đ test service. Ü Valid : tình tr ng c a 3 master service.
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 57 Ü Sequence : th t xu t hi n trên thi t b di đ ng.
Ü Last Modifield : ngày ch nh s a g n đâu nh t.
3.3.3.1 Tìm ki m master service
Ü Ch n lo i master service (master service, async agent service, modulable service, folder)
Ü Nh p vào keyword Ü Click Go.
Các master service phù h p s xu t hi n .
3.3.3.2 T o Folder
Ta có th t o các folder đ thu n ti n cho vi c qu n lý các master service. Các folder đây ta có th xem là các sub-folder vì chúng đ u ph i n m trong folder master. Ta t o các sub-folder theo các b c sau :
¬ Click vào buton Add Sub-Folder ¬ i n vào các thôngtin sau :
X Folder Name : tên th m c X Description : chú gi i
X Valid : check box cho phép enable folder này X Menu Icon URI : đa ch ch a icon cho menu X Title Icon URI : đa ch ch a icon cho title
X Menu Audio URI : đa ch ch a file audio cho menu X Title Audio URI : đa ch ch a file audio cho title
3.3.3.3 T o Master Service
3.3.3.3.1 i n các thông tin cho master service
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 58 X Name : tên c a master service
X Description : chú gi i
X Adapter : ch n adapter cho master service. X Check box
• Valid : cho phép kích ho t master service
• Modulable : cho phép xây d ng module (t c là master này cùng v i các mastersrvice khác t o thành m t module)
• Location Dependent : cho phép master service ph thu c vào v trí. X Region Name : tên v trí đa lí mà master ph thu c vào.
X Menu Icon URI : đ a ch ch a icon cho menu X Title Icon URI : đa ch ch a icon cho title
X Title Audio URI : đ a ch ch a file audio cho title X Menu Audio URI : đa ch ch a file audio cho menu X Sequence : s th t c a master service
3.3.3.3.2 Nh p vào các thông tin cho vi c cache c a master service
N u ta ch n vào check box Cacheable có ngh a là ta cho phép service đó đ c l u l i trong m t kh ang th i gian nào đó mà ta đnh ra, đi u này s làm gi m th i gian x lí t i wireless service. N u ta không cho phép service này có th b l u l i (cache) thì ta đ check box này tr ng vào click vào nút Next.
cho service đ c l u l i trong cache thì ta ph i đnh ra kho ng th i gian mà service cache l i :
Ü Nh p m t s vào field Cardinal
Ü Ch n đ n v (giây, phút, gi , ngày, tháng, n m )
Hình 3.3.3.3.2: Màn hình Caching c a Create Master Service
3.3.3.3.3 Tham s kh i t o
B c này ta nh p vào tham s kh i t o cho adapter mà ta đã ch n b c th 1. Ph i chú ý r ng, không ph i adapter nào c ng c n tham s kh i t o. N u adapter không c n tham s kh i t o thì ta đ tr ng ô này và click Next. bi t thêm chi ti t v các tham s kh i t o c a t ng lo i adapter thì ta xem ph n Adapter (trình bày sau trong ch ng này).
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 59 N u ta mu n thêm vào m t listener đ ph c v cho vi c debug thì ta nh p vào ô HttpInvokeListener tên c a listener class. Và khi đó listener này s đ c g i khi :
Ü Khi có yêu c u HTTP adapter . Ü Tr c khi k t n i v i m t file .jsp Ü Sau khi k t n i v i m t file .jsp Ü Khi k thúc yêu c u HTTP adapter.
3.3.3.3.4 Tham s input
Ta nh p vào các tham s đ u vào cho adapter mà ta đã ch n b c th 1. Khi đó tùy vào l ai adapter mà ta ph i nh p vào các tham s khác nhau.
Các tham s c a các adapter có các thành ph n sau : Ü Name : tên c a tham s input
Ü Comment : trong tr ng h p master service d a trên Web Integration adapter, thì Wireless s t đ ng đ a tr ng này vào tên c a WILD service. Còn đ i v i các adapter khác thì chúng ch đ c xem nh ph n chú gi i.
Ü Mandatory : n u mu n service đó b t bu c ph i có tham s này thì ta check vào check này.
Ü Default Value : giá tr m c đnh cho tham s .
Trong m c này ta c ng có th thêm hay xóa tham s input c a m t adapter đ i v i master service c th này .
thêm m t tham s input thì ta click vào nút Add Another Row. R i sau đó nh p vào m t s tr ng Name, Comment, Mandatory, Default Value (theo ý ngh a đ c gi i thích trên).
xóa m t tham s input thì ta ch n tham s đó r i nh n nút Delete
Hình 3.3.3.3.4: Màn hình Input Parameter c a Create Master Service
D i dây ta s đi n các tham s input cho HTTP Adapter :
Ü URL : đa ch c a d li u ngu n . ây là tham s b t bu c ph i có c a HTTP adapter.
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 60 Ü REPLACE_URL : Tr ng này cho phép hay không cho phép vi c thay th URL
liên quan trong k t qu mà HTTP tr ra.
Ü FORM_METHOD : là HTTP method mà adapter dùng đ l y d li u t ngu n. Ü INPUT_ENCODING : ki u encoding d lli u c a ngu n d li u.
3.3.3.3.5 Tham s Output
B c này cho phép ta ch n hay thêm tham s output cho adapter mà ta ch n b c th nh t. Khi đó Master service Creation Wizard s truy v n t i đ nh ngh a c a adapter đ hi n th lên các tham s . Các tham s output có các thu c tính sau :
Ü Name : tên c a tham s output. Master service Creation Wizard s truy v n ra tên c a tham s t adapter.
Ü Caption : là nhãn mà Wireless dùng cho tham s khi hi n th ra cho ng i dùng. Ü Comment : trong tr ng h p master service d a trên Web Integration adapter, thì
Wireless s t đ ng đ a tr ng này vào tên c a WILD service. Còn đ i v i các adapter khác thì chúng ch đ c xem nh ph n chú gi i.
Ü User Customizable : là check box cho phép user có th ch nh s a giá tr c a tham s .
Thêm tham s outputcho adapter : Ü Nh p vào tên c a tham s output.
Ü Nh p vào dòng chú gi i c a tham s output (sau này đ c dùng nh là m t nhãn trong tr ng caption trên)
Ü Nh p vào field Comment
Ü Ch n (ho c không ch n) vào check box User Customizable.
3.3.3.3.6 Async Agent
N u ta gán Async agent cho Master Service thì có ngh là ta cho phép service đ c giao ti p b ng HTTP các protocol khác.
gán async agent cho m t master service thì ta ph i : Ü Ch n check box async agent
Ü Trong tr ng Async agent Command Line Syntax ta nh p vào m t đ an text mà đ an text này s đ c tr v cho user khi user yêu c u l nh help.
Ü Nh p vào kí t phân cách cho Async agent service. N u ta không nh p vào tr ng này thì kí t phân cách m c đnh là kho ng tr ng.
Ü Nh p vào các đ i s cho async service. X Click vào nút Add Another Row. X Nh p vào tên c a đ i s
X Nh p vào s sequence c a đ i s .
X Nh p vào giá tr m c đnh c a đ i s . N u ta đ tr ng này tr ng thì Wireless s yêu c i user nh p vào khi user s d ng service này.
3.3.3.3.7 Transformer
Sau khi ta đnh các tham s output cho adapter thì Wirelesss ki m tra trong các tham s input n u có PASection thì Wireless s hi n ra màn hình cho phép ta ch n Result
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 61 Transformer. Ngòai ra t màn hình này ta có th thêm transformer m i b ng cách import vào m t file XSLT stylesheet.
Import m t file XSLT stylesheet :
Ü Ch n tab có PASection mà ta mu n ch nh s a. M i c a s có m t text edittor cho phép ta nh p vào XSLT stylesheet(ho c import vào t file).
Ü Click vào buton Next, màn hình Device Transformer xu t hi n. N u ta không mu n t o m t result transformer m i thì ta đ tr ng và click Next.
Ü N u các giá tr đã nh p đ u đúng thì ta nh n nút Finish đ hòan thành vi c t o m t Master Service.
Thêm Result Transformer m i :
Ü Nh p vào tên c a result transformer. Ü Import file XSLT stylesheet.
Ü Click nút Add.
3.3.3.4 Ch nh s a Master Service
Ch n master service sau đó click vào nút edit. Trong m c ch nh s a này các đ i t ng(tham s kh i t o, tham s input,…) s hi n th d i d ng các tab con. Ta nh p vào t ng tab đ ch nh s a các tham s sau đó click vào nút Apply đ hòan t t vi c ch nh s a.
Hình 3.3.3.4: Màn hình Edit Master Service
3.3.3.5 Xóa Master Service
Ch n master service sau đó click vào nút Delete.
3.3.3.6 Debug Master Service
Service Designer cho phép ta test m t master service thông qua m t simulator và dùng Wireless XML hay ngôn ng c a thi t b . Và transformer chính là thành ph n th c hi n đi u đó. Ta có th test các service c th trên nhi u l ai đnh d ng d li u output. Ch n master servic su đó click vào nút Debug. Ta ch n các l ai đnh d ng output sau:
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 62 Ü Adapter XML result :
Ü Wireless XML result Ü Device result
Click Set Parameters.
Click Run Service. Service s đ c hi n th trên simulator. Và k t qu s đ c hi n th trong c a s Service Result.
Ngoài ra trong trang này còn cho phép ta đnh chi u dài hi n th c a Logging file.
3.3.3.7 Di chuy n Folder và Master service
Ü Ch n folder hay master service. Ü Click vào nút Move.
Ü nh ra n i chuy n đ n c a folder hay master service. Ü Click vào nút Move.
3.3.4 Qu n lý Master Alert
Service Designer cho phép ta t o, s a, xóa master alert. Tr c tiên ta click vào tab Master Alert, khi đó t t c các master alert s đ c li t kê ra.Các master alert có các thu c tính :
Ü Name : tên c a master alert Ü Object ID : ID c a master alet
Ü Datafeeder : tên c a data feeder mà master alert đó đang s d ng.
Ü Time-based Enable : ch ra th i gian (n u master alert h at đ ngtheo th i gian)
Hình 3.3.4: Màn hình Browse Master Alerts
3.3.4.1 T o Master alert
3.3.4.1.1 Nh p vào m t s thông tin c b n
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 63 Ü Name : tên c a master alert.
Ü Description : chú gi i cho master alert.
Ü Data feeder : ch n data feeder cho master alert. Ü Check box:
X Valid : enable master alert này
X Time-based Enabled : cho phép master alert h at đ ng theo th i gian đã đ c đ nh tr c.
3.3.4.1.2 nh đi u ki n cho master alert
Hình 3.3.4.1.2: Màn hình Trigger Conditions c a Create Master Alert
B c này cho phép ta đnh ra các đi u ki n cho master alert. Ví d nh , ta t o m t alert đ thông báo cho user v giá ch ng khoán. Ta thi t l p đi u ki n là khi nào giá ch ng khoán t ng hay gi m thì ta alert cho user bi t.
i u ki n này bao g m các thu c tính sau :
Ü Condition Name : tên c a đi u ki n.(ch ch a s và kí t , không đ c b t đ u b ng ch s , và không dài quá 30 kí t )
Ü Trigger parameter : là m t thành ph n trong data feeder mà ta đã ch n b c tr c. Ví d nh đ i v i service v ch ng khoán trên, n u data feeder c a alert service có ch a tham s output là giá ch ng khoán thì ta ch n giá ch ng khoán này nh là m t trigger parameter.
Ü Condition Type : lo i đi u ki n. cho phép ta ch n các l ai đi u ki n cho trigger parameter
Ü Default value: giá tr m c đnh làm đ i s th 2 cho phép tóan trong Conditon type. N u ta nh p vào tr ng này m t giá tr nào đó thì alert s không yêu c u user nh p vào giá tr này.
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 64 Ü Thêm Trigger Condition m i : click vào nút Add Another Row
Ü Nh p vào tên c a trigger condition. Ü Nh p vào dòng chú gi i
Ü Ch n trigger parameter
Ü Ch n condition type. Condition type bao g m các đi u ki n sau: X i v i trigger parameter là s :
o Less Than : nh h n o Greater Than : l n h n o Equal :b ng
o Less Than and Equal : nh h n ho c b ng o Greater Than and Equal : l n h n ho c b ng
o Less Than Absolute Value : nh h n giá tr hi n t i o Greater Than Absolute Value : l n h n giá tr hi n t i o Equal Absolute Value : b ng giá tr hi n t i
o Less Than and Equal Absolute Value : nh h n ho c b ng giá tr hi n t i o Greater Than and Equal Absolute Value : l n h n ho c b ng giá tr hi n
t i
o Value Change : giá tr thay đ i. X i v i trigger parameter là text :
o Exact Match : gi ng nhau o Not Match : không gi ng nhau o Contain : ch a
o Not Contain :không ch a o Begin With : b t đ u b ng o End With : k t thúc b i
o Value Change : giá tr thay đ i ̇ Nh p vào giá tr m c đnh ̇ Click Apply
3.3.4.1.3 T o template message cho master alert
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng
SVTH: Tr n Thanh Nhân – Nguy n Qu c Chính Trang 65 Ta có th t nh p vào XML template ho c imput t m t file
3.3.4.2 Ch nh s a Master alert
ch nh s a master alert thì ta ch n master alet đó r i click vào nút Edit. Các tham s trong quá trình ch nh s a đ u có ý ngh a t ng t v i các tham s trong quá trình kh i t o.
3.3.5 Qu n lý Data Feeder
Data feeder là m t đ i t ng trong Wireless làm nhi m v l y data t ngu n d li u và chuy n đ i thành d ng d li u chung cho các alet service.
Hình 3.3.51: Màn hình Browse Data Feeders
3.3.5.1 T o Data Feeder
3.3.5.1.1 Nh p vào m t s thông tin c b n
Oracle 9i AS Wireless Edition GVHD: ThS. Hoàng C ng