TJTSE54 - Kehitysmenetelmät ja arkkitehtuurit liiketoiminnassa Demot kevät 2007 Demo-ohjeen tämä osa perustuu Active BPEL Designerin mukana tulevaan tutoriaaliin. Johdanto Demoissa laaditaan BPEL-prosessi, joka käsittelee lainahakemuksen. Käynnistyessään prosessi ottaa syötteenä käyttäjältä tämän etunimen (merkkijono), sukunimen (merkkijono) sekä halutun lainamäärän summan (kokonaisluku). Prosessin edetessä tarkastetaan pyydetty lainasumma (amount-muuttuja). Mikäli summa on alle 10 000, ohjataan prosessin kulku LoanAssessorille. Mikäli arvioitu riski (risk) on pieni (low), hyväksytään lainapyyntö välittömästi. Mikäli riski on korkea (high), ohjataan käsittely LoanApproverille. Näin menetellään myös jos pyydetty lainasumma on yhtä suuri tai suurempi kuin 10 000. Mikäli lainapyyntö hyväksytään, palauttaa prosessi asiakkaalle myönteisen vastauksen (yes). Ensimmäisenä tehtävä on laatia yllä kuvatun kaltainen prosessi ja simuloida sen suorittaminen Eclipsessä. Seuraavassa vaiheessa prosessi siirretään palvelimelle, jossa BPEL-moottori suorittaa sen pyydettäessä. Lisäksi prosessille laaditaan asiakas ohjelma, jonka kautta prosessille voidaan välittää tarvittavat tiedot (etunimi, sukunimi ja lainasumma) ja käynnistää se. BPEL-prosessit näkyvät verkkoon verkkopalveluina (Web service), joten asiakasohjelman tulee olla verkkopalveluasiakas. Asiakasohjelman voi toteuttaa esim. PHP:lla ATK-keskuksen suorakäyttökoneiden kautta WWWpalvelimelle. Lopuksi palataan vielä Eclipseen prosessikuvauksen pariin ja liitetään mukaan ulkoinen verkkopalvelu. Sopivaa palvelua voi etsiskellä vaikka Xmethodsin hakemistosta (http://www.xmethods.net/). Nimet, joita seuraavassa ohjeistuksessa mainitaan mm. muuttujille, ovat ohjeellisia. Jos haluat käyttää itse valitsemiasi nimiä, älä käytä niissä välilyöntejä tai erikoismerkkejä. Vaihe 1. Käynnistä Eclipse ja osoita workspace-työtila levylle, johon sinulle on kirjoitusoikeus (esim. U- verkkolevy). Luo uusi projekti ja anna sille nimeksi ActiveBPEL_tutorial. Seuraavaksi luo uusi prosessi File>New>BPEL Process. Valitse ActiveBPEL_Tutorial-kansio ja anna prosessin nimeksi tutorial. Ohita Advanced-asetukset ja klikkaa Finish.
Koska BPEL Designer validoi prosessimäärittelyn syntaksi, ilmestyy Eclipsen Problemsvälilehdelle nyt virheilmoitukset No activity designated to create instance ja Container/prosess is missing a required activity. Näistä ei tarvitse toistaiseksi välittää. Eclipsen varsinaisen työtilan reunassa on esille pomppaava Palette-valikko, joka sisältää prosessissa käytettäviä rakennuspalikoita. Vaikka työkalu mahdollistaa graafisessa tilassa työskentelyn, itse prosessimäärittely kuitenkin on XML-dokumentti. Dokumentin lähdekoodia voi tarkastella valitsemalla Source-välilehden. Properties-näkymä esittää kulloinkin valitun kohteen (kuten prosessin tilat, tilojen väliset siirtymät tai itse prosessi, joka valitaan klikkaamalla työtilan tyhjää kohtaa) ominaisuudet. Ominaisuuksia voi muokata Properties-näkymässä tai vastaavasti suoraan Source-näkymässä. Ensin mainittu on suositeltavampi vaihtoehto, mutta silloin tällöin kannattaa vilkaista myös Source-näkymää, jotta graafisessa näkymässä tehtyjen muutosten vaikutus prosessin kuvaavaan XML-dokumenttiin tulee esille. Kuva 1: Valmis prosessi Tutustu graafisen editorin ominaisuuksiin lisäämällä Palette-valikosta prosessin osia. Osia lisätään hiirellä vetämällä. Prosessin kulkua kuvaavia nuolia voi kohteiden välille lisätä valitsekaksi kohdetta (CTRL-pohjassa), klikkaamalla hiiren oikeanpuolesta nappia ja valitsemalla Link activities. Prosessinäkymän esitystapaa voi muuttaa mm. valinnoilla Auto Layout, Align ja Zoom. Kun olet aikasi kikkaillut, valitse kaikki lisäämäsi palikat hiirellä maalaamalla ne ja tuhoa ne. BPEL-prosessit koostuvat verkkopalveluiden tarjoamasta toiminnallisuudesta sekä niiden ympärille rakentuvasta prosessin kulusta. Verkkopalvelujen kuvaamisessa käytetään WSDLrajapintakuvauksia (Web Services Description Language). Tässä esimerkissä käytettävät rajapintamäärittelyt löytyvät paketista Samples.rar, joka on ladattavissa osoiteesta http://www.cc.jyu.fi/~rissepp/bpel/samples.rar. Lataa paketti ja pura se esimerkiksi verkkolevyllesi. Seuraavaksi tuo paketin sisältämä projekti Eclipsen työtilaan: File>Import>General, valitse Existing Projects into Workspace ja etsi verkkolevylle purkamasi kansio. Laadittaessa BPEL-prosesseja, prosessiin liittyvien palvelujen WSDL-kuvaukset kannattaa tuoda projektiin, jolloin niiden sisältämät tiedot (mm. palvelun portit ja palvelun vaatimat argumentit) on helposti käytettävissä. WSDL-kuvauksia voidaan tuoda projektiin sekä Import-valinnalla (käytetään myöhemmin kun prosessiin liitetään ulkopuolinen verkkopalvelu) että kopiomalla, kuten seuraavassa. Laajenna ActiveBPEL_Samples-projekti ja valitse Completed Tutorial -kansio. Valitse WSDL-alikansio ja kopioi se omaan ActiveBPEL_Tutorial-projektiisi.
Eclipsen Web References -kohdassa voidaan säilyttää projektiin liittyviä WSDL-määrityksiä tai tietotyyppejä määrittäviä skeemoja. Kun Web Referencesiin liitetään WSDL-määritys, saadaan määritykset sisältämät nimiavaruudet, viestit ja niiden tietotyypit helposti käyttöön. Valitse Web References -näkymä ja klikkaa Add a Web Reference -kuvaketta (maapallo ja plus-merkki). Valitse Browse Projects, laajenna ActiveBPEL_Tutorial-projekti ja sen alla oleva WSDL-kansio sekä valitse loanservicept.wsdl ja error-messages.xsd. Web References -valinnan oikealla puolella on alasvetovalikko, josta voidaan valita esitettäväksi tuotuja ominaisuuksia. View WSDL ja View Schemas -valintojen alla pitäisi olla nyt näkyvissä äsken tuodut wsdl ja xsd-dokumentit. Kuva 2: Web References Seuraavaksi ryhdytään muodostamaan prosessin kulkua. Prosessi tulee sisältämään seuraavat toiminallisuudet: Receive: Aloittaa prosessin. Otetaan prosessin asiakkaalta vastaan request-viesti, joka pitää sisällään lainahakemuksen käsittelemisessä tarvittavat tiedot (etunimi, sukunimi, lainasumma). Reply: Päättää prosessin. Lähetetään asiakkaalle vastaus päätöksestä. Invoke Loan Assessor ja Invoke Loan Approver. Kutsutaan tarpeen mukaan lainahakemuksen arvijoijaa ja käsittelijää. Valitse Web References -kohdasta View Partner Link Types. Avaa loanpartnerlt ja raahaa sen alta löytyvä request-operaatio työtilaan. Tämä käynnistää Operation Wizard -toiminnon. BPELprosessin käynnistää sen vastaanottama syöteviesti (input). Tämän prosessin tarkoitus on myös palauttaa asiakkaalle vastaus, joten valitse Receive-Reply. Partner Linkit määrittelevät osapuolille roolit, joita ne prosessissa edustavat. Samoin ne määrittelevät datan, jota kyseisissä rooreissa käsitellään. Mahdolliset Partner Linkit on määritelty WSDL-kuvauksissa. (Huom. Partner Link -määritykset ovat tarpeen kun palvelujen roolia
määritellään BPEL-prosessien sisällä. Ne eivät kuitenkaan ole välttämättömiä 'tavallisten' verkkopalvelujen rajapintakuvauksissa, joita kutsutaan yksinkertaisilla asiakasohjelmilla. Myöhemmässä vaiheessa, kun tähän prosessiin liitetään ulkopuolinen verkkopalvelu, on todennäköisesti tarpeen määritellä palvelulle Partner Link -asetus jälkikäteen.) Operation Wizard tarjoaa oletuksena partner linkin nimeksi loanpartnerlt. Muuta nimeksi customer ja klikkaa Next. Muutujat (Variables) sisältävät viestejä joita lähetetään prosessin osapuolten välillä sekä dataa, jota käytetään prosessin sisäisiin tarkoituksiin. Oletuksena prosessin syötemuuttujan nimeksi on creditinformationmessage. Muuta nimeksi request ja klikkaa Next. Nimeä tulosmuuttuja (Output Variable) nimellä approval ja klikkaa Finish. Receive ja Reply -aktiviteetit näkyvät nyt Eclipsen työtilassa. Klikkaa Receive-aktiviteettia ja valitse Properties-välilehti. Ominaisuudet, jotka löytyvät WSDL-määrityksestä, ovat valmiina paikoillaan (partner link, operation ja variable). Aseta aktiviteetin nimeksi ReceiveCustomerRequestforLoanAmt Activity Name -kohdassa. Valitse seuraavaksi Replyaktiviteetti ja aseta sen nimeksi AcceptMessageToCustomer. Lisää seuraavaksi kutsut prosessissa käytettäville verkkopalveluille. Nämä verkkopalvelut saavat syötteen prosessilta ja palauttavat tulosteen. Laajenna Web References -näkymässä riskassessmentlt -partner link sekä sen alla oleva assessor. Valitse check-operaatio ja raahaa se työtilaan. Valitse Operation Wizardista aktiviteetin tyypiksi Invoke ja klikkaa Next. Muuta partner linkin nimeksi assessor ja klikkaa Next. Annetaan palvelulle syötemuuttujaksi jo aiemmin käsitelty request (Use existing Variable). Klikkaa Next ja luo uusi tulosmuuttuja (output variable) nimellä risk. Lopuksi muuta luodun invokeaktiviteetin nimeksi InvokeLoanAssessor sen Properties-näkymässä. Luo seuraavaksi invoke-aktiviteetti loanapprovallt:n approve-operaatiosta. Luo approver niminen partner link ja käytä jo määriteltyjä muuttujia request ja approval. Nimeä aktiviteetti lopuksi nimellä InvokeLoanApprover. Nyt työtilassa pitäisi olla neljä aktiviteetia ja näkymän vastaava kuin Kuvassa 1 lukuunottamatta aktiviteettien välisiä siirtymiä ja AssignYestoAccept-aktiviteettia. Nämä puuttuvat osat lisätään seuraavaksi. XML-dokumenteissa käytetään nimiavaruuksia (name space), jotka liittävät määrittelyihin kontekstin. Valitse Outline-näkymä ja laajenna sen alla oleva Namespaces-kohta. Käytössä olevat nimiavaruudet ovat xsd (XML Schema Definition, joka määrittelee normaalin XML-skeeman), bpel (BPEL:n oletusmääritykset) sekä ns1 (namespace 1, joka on tämän prosessin nimiavaruus). Nimeä Properties-näkymässä ns1 muotoon lns (loan namespace). (Nimiavaruuden nimellä ei ole käytännön merkitystä, kunhan sitä käytetään johdonmukaisesti) Luodaan seuraavaksi Assign-aktiviteetti. Assignia käyttämällä on mahdollista manipuloida muuttujia. Tässä tapauksessa asetataan arvo asiakkaalle palautettavalle lainan myöntävälle paluuviestille. Valitse Process Variables -näkymä Web References -kohdan alta. Klikkaa hiiren oikealla napilla approval-muuttujaa ja valitse Open. Klikkaa acceptia oikealla napilla ja valitse Copy>To (Kuva 3. Huom. Kuvassa näkyvä error-muuttuja lisätään prosessiin myöhemmin.).
Kuva 3: Assign-aktiviteetin lisääminen Copy Operations -ikkunassa aseta kopiointioperaation lähteen (From) tyypiksi Literal ja sisällöksi yes. Kohteen tyyppi on approval-muuttujan accept-osa. Aseta lopuksi Assign-aktiviteetin nimeksi AssignYestoAccept. Seuraavaksi lisätään aktiviteettien väliset siirtymät. Siirtymien avulla ohjataan varsinaista prosessin suorituslogiikkaa. Kyseisessä prosessissa siirtymien ehdot ovat varsin yksinkertaisia. Kuten aiemmin mainittiin, niissä arvioidaan toivottua lainasummaa sekä lainan myöntämiseen liittyvää riskiä. Voit tässä vaiheessa tutustua uudelleen Palette-valikosta löytyviin aktiviteetteihin, jotka mahdollistavat tarvittaessa monimutkaisempiakin prosessikulkuja. Prosessin joku osa voidaan esimerkiksi asettaa odottamaan jonkin toisen aktiviteetin tuloksen selviämistä tai jo suoritettuja aktiviteetteja voidaan kumota Compensate-aktiviteeteilla. Other-kohdassa on välineitä tarkempien siirtymäehtojen määrittelemiseksi; esimerkiksi If ja Else -rakenteen mahdollistamat osat sekä On Event, On Alarm ja On Message -aktiviteetit, jotka voidaan asettaa käynnistymään esimerkiksi tietyn tapahtuman toteutuessa tai tietyn ajan kuluttua. Tässä prosessissa ei näitä kuitenkaan tarvita, mutta voit halutessasi kokeilla niitä myöhemmässä vaiheessa kun prosessiin liitetään ulkoinen verkkopalvelu. Liitetään Receive ja InvokeLoanAssessor -aktiviteetit. Valitse molemmat aktiviteetit CTRL-näppäin painettuna. Klikkaa hiiren oikeanpuoleista näppäintä ja valitse Link Activities. Muuta Propertiesnäkymässä siirtymän nimeksi receive-to-assess. Yhdistä samalla tavalla myös Receive
InvokeLoanApprover ja aseta siirtymän nimeksi receive-to-approve. Seuraavaksi siirtymiin lisätään siirtymäehdot. Valitse receive-to-assess ja tuplaklikkaa sen päällä. Tämän käynnistää Transition Builderin. Tuplaklikkaa request-muuttujan amount-osaa ja aseta siirtymän ehdoksi 'less than' -operaattoria käyttämällä se, että amount on pienempi kuin 10000. Klikkaa lopuksi OK. Määrittele seuraavaksi receive-to-approve -siirtymän ehdoksi se, että amount on 10000 tai enemmän. LoanAssessorin tehtävänä on palauttaa arvio lainahakemukseen liittyvästä riskistä. Tositilanteessa LoanAssessor voisi siis olla esimerkiksi verkkopalvelu, joka tarkastaisi lainaa pyytäneen asiakkaan luottotiedot. Luo siirtymä LoanAssessorin ja LoanApproverin välillä ja aseta siirtymän nimeksi assess-to-approve. Määrittele siirtymän ehdoksi $risk.level!= 'low'. Tällä määrätään siis se, että jos lainan myöntämiseen liittyy korkea riski, käsittely siirretään LoanApproverille. Luo lopuksi siirtymä LoanAssessorin ja hakemukseen myönteisen vastauksen palauttavan Assign-aktiviteetin välille nimellä assess-to-setmessage ja ehdolla $risk.level = 'low'. Prosessin pitäisi nyt muistuttaa asetteluaan lukuunottamatta Kuvaa 1. Varmistu vielä, että Receiveaktiviteetin ominaisuuksissa Create Instancen arvona on Yes. Tällä asetetaan, että prosessin ensimmäinen aktiviteetti voi käynnistää prosessin suorittamisen. Tarkista myös, että prosessi ei ole tyypiltään abstrakti. Lopuksi tallenna prosessi. Problems-näkymään ei tulisi ilmestyä virheitä.