JBO 2.0 Beta 2 jakeludokumentti

JBO 2 budjetointiohjelman lisenssiehdot

JBO (Juhan Budjetti Ohjelma):a saa käyttää ja levittää alkuperäisen asennuspaketin mukana vapaasti henkilökohtaista käyttöä varten.
Ohjelmaa tai muita siihen liittyviä osia ei saa kuitenkaan muokata tai muuttaa millään tapaa.

Tekijä ei ota mitään vastuuta ohjelman tai sen osien mahdollisesti aiheuttamista suorista tai välillisistä vahingoista tai
toimivuudesta. Käyttö omalla vastuulla.

JBO program might be used and copied freely for personal use as it is with the original
setuppackage.

JBO is supplied as it is. The author disclaims all warranties, expressed or
implied, including without limitation, the warranties of fitness for any purpose. The author
assumes no liability for damages, direct or consequential, which may result from the use of
JBO.

Copyright (c) 1998 - 2004 Juha Lähteenmäki

1. JBO budjettiohjelman yleiskuvaus

JBO eli yksinkertaisesti Juhan Budjetti Ohjelma on nimensä mukaisesti ohjelma tavallisen kotikäyttäjän talouden (tulojen ja menojen) seurantaan. Sen perusfilosofiana on tehdä budjetin pitämisestä mahdollisimman helppoa, koska käytännön kokemus on osoittanut että muutoin se ei pysy ajan tasalla ( budjettia ei yksinkertaisesti jaksa ylläpitää jos on liian vaivalloista). Tästä lähtökohdasta olen jo pitkään kehitellyt omiin tarpeisiini soveltuvaa ohjelmaa, jossa yleisemmin tarvittavat toiminnot, kuten Tulo-/menoerien ryhmittely, lisäys, poisto, haku ja muokkaus sekä taseen laskeminen eri aikaväleiltä, on pyritty tekemään mahdollisimman suoraviivaisiksi. Nyt esiteltävässä viidennessä JBO:n versiossa (aiemmat versiot 1.0, 1.1, 1.2 ja 2.0 beta 1) tämä tavoite on ehkä lähempänä kuin koskaan ennen.

Helppokäyttöisyyden kannalta on tärkeää, että uutta syötettä annettaessa kentissä voi tarvittaessa liikkua luonnollisesti näppäimistön avulla (esim. "Backspace" siirtää kentän alussa painettuna fokuksen edelliseen ja "enter" seuraavaan kenttään). Vanhat tulo-/menoerille annetut selitteet puolestaan saadaan tarvittaessa ohjelmoijille tuttuun "intellisense" -tyyliin uusien selitteiden pohjaksi.

Helppokäyttöisyyden filosofiaan kuuluu myös käyttöliittymän selkiyttäminen käyttämällä normaalia hieman isompia fontteja. Toisaalta kaikille useimmin tarvittaville toiminnoille on omat pikanäppäin-yhdistelmänsä mikä helpottaa kokenutta käyttäjää

Tässä uudessa versiossa on käyttöliittymän selkiyttämisen  lisäksi parannettu syötteen vienti- tuontiominaisuuksia sekä raportointia. Taseen lisäksi XML-muotoon voidaan nyt tallentaa mikä tahansa syötehaun tulos ja myös formuloida se selaimessa halutulla tavalla näkyväksi tai tulostuvaksi dokumentiksi XSL-tyylitiedoston avulla. Taseen osalta XSL-tyylitiedosto on budjettikohtainen, joten eri budjeteilla voi olla eri tavalla formuloidut taseet. Toisaalta ohjelmaan voidaan tuoda syötteenä XML-tiedosto ulkopuolelta, mikä mahdollistaa syötejoukon siirtämisen budjettiohjelmasta toiseen tai automaattisen syötteen latauksen kolmannen osapuolen datasta esim. tiliotteista.

Budjetteja voi myös tässä 2.0-versiossa olla rajoittamaton määrä ja niitä voi käyttää esim. verkkoasennuksissa yhtä aikaa (samaa budjettia voi kuitenkin käyttää vain yksi käyttäjä kerrallaan). Budjetteja voi myös tuoda ja viedä kokonaisina asennuksesta toiseen. Tästä hyötyä erityisesti silloin, jos budjettia päivittelee satunnaisesti eri koneilla jotka eivät ole jatkuvassa verkkoyhteydessä toisiinsa.

2. Asennus ja käyttövaatimukset

Järjestelmä on testattu ja todettu toimivaksi kuormitustesteissä seuraavalla suositellulla minimikokoonpanolla Pentium 166 Mhz,  48 Mt RAM, Win98SE + IE 6.

Ohjelmistovaatimukset: Windows 98 tai uudempi Windows-käyttöjärjestelmä, Internet Explorer 6 selain XML-muotoisten raporttien esikatselua varten. Laitteistovaatimukset: 32 MT Ram, Pentium 133 Mhz, vähintään 800x600 resoluutio ja 256 värin näyttötila.

Asennus:

Pura asennuspaketti JBO20.zip haluamaasi tilapäishakemistoon, aja setup.exe ja noudata ohjeita.

Verkkokäyttö:

Asenna ohjelma normaalisti haluamallesi verkossa näkyvälle resurssille ja määritä "Mäppää" sen hakemisto verkkolevyksi.kaikilla niillä koneilla, joilta käsin haluat ohjelmaa käyttää.  Eri budjetteja voi käyttää yhtä aikaa mutta samaa budjettia voi kuitenkin käyttää vain yksi käyttäjä kerrallaan.

 3. Esimerkki käytöstä

JBO 2.0:n käyttöä on tarkemmin kuvattu erillisessä käyttöohjeessa.  Myös alkuperäisestä määrittelydokumentista  tai seuraavassa luvussa esitetystä toimintolistauksesta saattaa olla hyötyä toiminnallisuuden hahmottamisessa. Tässä on käsitelty esimerkin avulla muutama ohjelman peruskäyttöön liittyvä toiminto

Uuden budjetin luominen (ohjattu toiminto)

Kun käynnistät JBO:n ensimmäistä kertaa tai jos Budjettihakemistossa ei ole yhtään budjettia, aukeaa budjetin luonnin ohjattu toiminto:

1. Anna budjetin nimi ja paina seuraava.

2. Seuraavaksi kysytään budjettiin lisättävien käyttäjien nimet ja login tunnukset. Kun kaikki käyttäjät on lisätty listaan paina seuraava.

3. Lisää haluamasi tulo- ja menoryhmät budjettiin. Ryhmät kannattaa oikeaa budjettia tehdessä miettiä huolella, sillä budjettiin lisättävät erät ryhmitellään niiden alle ja myös taseessa lasketaan kokonaissummien lisäksi ryhmäkohtaiset menot ja tulot. Ryhmän luokittelulla voit määrätä huomioidaanko ryhmän alle lisätyt syötteet oletuksena taseen kannalta negatiivisina (meno) vai positiivisina (tulo).

4. Kun painat valmis budjetti on valmis käytettäväksi ja ohjattu budjetin luonti toiminto sulkeutuu.

Ohjatun budjetin luonnin voit käynnistää koska tahansa uudestaan budjetti valikosta:

Samoin käyttäjiä tai tulo- ja menoryhmiä voit lisätä luomaasi budjettiin myös jälkeenpäin.

Budjettiohjelman peruskäyttö, syötteen lisääminen ja taseen laskeminen

Kun budjetti on luotu voit kirjautua siihen normaalisti valitsemalla budjetin (ohjelmassa voi olla useita budjetteja) ja käyttäjätunnuksen.

Esimerkissämme tehtävänä on kirjata budjettiin nimeltä Oma Budjetti käyttäjän Aku tunnuksella seuraavat tulo-/menoerät:

• Jotain Tuloja ryhmän alle: Palkka kolikon kiillotuksesta 2 Euroa, tapahtuma pvm 7.2.2004
• Jotain Menoja ryhmän alle: vuokrarästi 400 Euroa, tapahtuma pvm 5.2.2004

Kirjausten jälkeen tulee etsiä kaikki käyttäjän Aku budjettiin helmikuussa kirjaamat euromääräiset menot, joiden summa on vähintään 100 euroa. Lisäksi selitteessä tulee esiintyä sana tai sanan osana "rästi"

Lopuksi tulee vielä laskea helmikuun 2004 tase ja tallentaa se XML-muotoisena raporttina työpöydälle.

Oletetaan että kirjauspäivä on 7.2.2004

Kirjaudutaan ensin sisään budjettiin.

Kirjautumisen jälkeen avautuu JBO:n varsinainen syöteikkuna, joka ensimmäisellä käynnistyskerralla on suunnilleen seuraavan kaltainen

Voit katsoa myös tasetta, joskaan siitä ei ole paljoa iloa tässä vaiheessa, koska budjetissa ei vielä ole yhtään syötettä

Palataan syötepuolelle ja lisätään budjettiin halutut esimerkki syötteet

Kun syöte on lisätty, se tulee välittömästi näkyviin yläpuolella näkyvään syötelistaan mikäli optio "Näytä valitun ryhmän alta" on valittuna (oletus)

Syötelistassa näkyvät syötteet järjestetään päivämäärän mukaan siten, että uusin syöte näkyy ylimpänä. Oletuksena kerralla näytetään enintään 200 syötettä mutta määrää voi muuttaa ohjelman asetuksista. Mikäli näyttösi resoluutio on suurempi kuin ohjelman edellyttämä minimi resoluutio 800 x 600, kannattaa ikkuna suurentaa koko näytön kokoiseksi. Tällöin syötteitä mahtuu enemmän näkyviin ilman vierityspalkkia ja selitteille varattu tekstitila levenee.

Syötetään vielä budjettiin toinen syöte, tällä kertaa menoryhmän "Joitain Menoja" alle. Koska ko. maksu on suoritettu jo aiemmin, vaihdetaan päivämäärä napsauttamalla vaihda linkkiä Pvm kentän yläpuolella:

Auenneesta kalenteri ikkunasta valitaan päiväksi 5.2.2004 ja kuitataan OK:lla

Kun päivä on vaihdettu lisätään syöte budjettiin

Toiminnon syötelista näyttää tältä:

Suoritetaan vielä aiottu syötehaku. Ts. etsitään kaikki  käyttäjän Aku budjettiin helmikuussa kirjaamat euromääräiset menot, joiden summa on vähintään 100 euroa ja selitteessä esiintyy merkkijono "rästi"

Huomaa - merkki summan edessä. Huomaa myös, että painettuasi etsi nappulaa, syötteiden näyttökriteeriksi vaihtui automaattisesti "Syötehaun tulokset". Kun et enää tarvitse haun tuloksia, kannattaa syötteiden näyttökriteeri palauttaa takaisin oletukseensa eli "Näytä valitun ryhmän alta".

Syötehaun yleisestä logiikasta vielä sen verran, että tyhjä kenttä tarkoittaa ko. hakuehdon jättämistä tyhjäksi. Kentät puolestaan yhdistellään keskenään siten, että uusi kenttä rajaa aina hakua lisää (AND)

Pieni tarkkaavaisuustesti hakuun liittyen:

Tehtävänantoon nähden hakuehdoissa esiintyy yksi pieni epämääräisyys. Mikä se on?

V: Valuuttaa ei ole määritelty, vaikka tehtävänä oli etsiä euromääräiset summat, joiden suuruus oli nimenomaan vähintään 100 euroa. Hakuehdoksi olisi siis pitänyt valuutta kenttään antaa vielä arvo "Euroa"

Taseen käsittely:

Kun halutut syötteet on lisätty budjettiin, kannattanee vilkaista ehkä vähäsen myös taseen puolelle. Valitsemalla Tase -välilehti nähdään oletuksena kuluvan vuoden tase.

Tase päivittyy normaalisti budjetin muokkausten yhteydessä, mutta varmuuden vuoksi kannattaa vielä painaa "Laske tase aikaväliltä" linkkiä. Koska tarkoituksena ei ollut määrittää kuluvan vuoden, vaan nimenomaan helmikuun tase, vaihdetaan vielä taseen laskuaikavälin päivämäärät napsauttamalla sekä alku- että loppupäivämäärän pudotusvalikkoa

Kun päivät on vaihdettu lasketaan vielä tase uudelleen:

Tässä tapauksessa tuloksena saadaan tietenkin täsmälleen sama tase, koska kaikki tulot/menot oli syötetty helmikuussa. Huomaa että prosenttiluvut pyöristetään yhden prosentin tarkkuuteen (puolikkaat prosentit matemaattisesta tavasta poiketen alaspäin). Tästä syystä esim. tulojen osuus menoihin nähden on esimerkkitaseessa 0%.

Viimeisenä tehtävänä oli vielä taseen tallennus XML-muotoisena raporttina työpöydälle. Tämä onnistuu helposti painamalla tallenna/tulosta linkkiä Tase-välilehden oikeasta yläkulmasta ja sen jälkeen avautuvasta esikatselu ikkunasta edelleen tallenna.

Huomaa että tase-XML:n lisäksi tallennetaan sitä vastaava muotoilu- ja tyyli tiedosto (.XSL), joka määrittelee miten ja mitkä taseen tiedot tulisi visuaalisesti selaimessa esittää. XSL-tiedosto on tasekohtainen (Luvussa  5 on tarkemmat ohjeet sen määrittelystä). Näin jokaiselle taseelle voi säätää haluamansa ulkoasun ja näytettävät tiedot erikseen. Tallennuksen jälkeen XSL:ää voidaan tietysti muokata edelleen, jota kautta saadaan tarvittaessa vaikka jokainen tallennettu tase erilaiseksi. Tase voidaan myös sellaisenaan siirtää Web:iin, mutta selainten XSL:n tuen rajoittuneisuudesta johtuen vanhemmat selaimet eivät välttämättä osaa näyttää tietoja oikein.

4. JBO 2.0 Beta 2 version toiminnot

Tässä luvussa on listattu taulukon muodossa kaikki JBO 2.0 Beta 2 version tukemat  peruskäyttöliittymän kautta käytettävissä olevat toiminnot. Asetustiedostojen ja ulkopuolisten lisäpalikoiden tarjoamaa toiminnallisuutta ei ole listattu. Samoin ei ole listattu myöskään yleiskäyttöisten käyttöliittymäosien, kuten kalenteri-ikkunan, raportin esikatseluikkunan ja standardien Windows-valikoiden kautta tarjottua toiminnallisuutta. Kalenterin ja raportin esikatseluikkunan toiminnallisuus on kuitenkin listattu yleisemmällä tasolla erikseen.

Yleiskäyttöisen kalenterikomponentin tarjoama toiminnallisuus JBO:n kannalta.

Aikoinaan jo potilaskertomusjärjestelmää (JSO) varten kehittämäni kalenterikomponentti tarjoaa Windows:n standardikalenteria huomattavasti laajemman toiminnallisuuden joskin suurin osa toiminnallisuudesta on JBO:n kannalta turhia ja siten piilotettuna. Merkittävin etu oman kalenterikomponentin käytöstä saavutetaan JBO:n yhteydessä paremmalla päivämäärävälin rajoituksilla. Kalenterille voidaan antaa periaatteessa mikä tahansa päivämääräväli, jonka perusteella se rajoittaa näyttämäänsä aikaväliä.

Kalenteri tarjoaa päivämäärän valinnan standardilla tavalla vastaavaa päiväystä klikkaamalla. Kun valitaan kuukausi, valituksi tulee automaattisesti kuukauden ensimmäinen päivä (jolleivät päivämäärävälin rajoitukset tai asetukset sitä estä). Samoin kun valitaan vuosi, valituksi tulee automaattisesti vuoden ensimmäisen kuukauden ensimmäinen päivä. Valintaa ei kuitenkaan päivitetä, jos optio "Päivitä kalenteri automaattisesti" ei ole valittuna. Tämän option kytkeminen pois päältä saattaa olla järkevää kaikkein hitaimmissa koneissa, mutta tällöin päivänäkymän päivittäminen kuukauden tai vuoden valinnan yhteydessä edellyttää päivitä nappulan painallusta.

Kalenteri tarjoaa myös mahdollisuuden nykyisen päivämäärän valintaan tai viimeisen valinnan kumoamiseen. Samoin voidaan nopeasti palata kalenterin avaushetkellä valittuna olleeseen päivään. Huomaa että mikäli haluat ottaa käyttöön kalenterissa valitsemasi päiväyksen, sulje kalenteri painamalla OK. Ruksista tai peruuta nappulasta sulkeminen aiheuttaa muutosten hylkäämisen. Joissain tilanteissa päivämäärä kuitenkin tällöinkin tulee voimaan esim. mikäli kentässä ei ole ennestään kelvollista päivää tai jos kenttä on ollut tyhjä.

Päivämäärän muuttaminen kalenterin kautta on mahdollista kaikissa ohjelman käyttämissä päivämäärä kentissä, vaikkei tätä ole toimintolistassa erikseen mainittukaan. Kalenterin saa avattua joko erillistä linkkinappulaa painamalla tai jos sitä ei ole, alasvetovalikkoa napsauttamalla.

Yleiskäyttöisen raportin esikatselukomponentin tarjoama toiminnallisuus JBO:n kannalta

JSO -potilaskertomusjärjestelmääni varten kehitin yleiskäyttöisen komponentin Web-sivujen ja selaimen ymmärtämien muiden dokumenttien esikatseluun. Komponentti käyttää sisäisesti Internet Explorer selainta, joten sen käyttö edellyttää, että järjestelmässä on oltava asennettuna IE 5 tai uudempi versio Internet Explorerista. Lisäksi tulosteen esikatselu edellyttää IE 5.5 selainta tai uudempaa. JBO:n tuottamat XML-muotoiset raportit puolestaan asettavat selaimelle lisärajoituksia, koska ne edellyttävät selaimelta melko kattavaa XSL:n tukea. Käytännössä tämä tuki on saatavissa vasta IE 6.0:sta lähtien, joten koneella on oltava IE 6, jotta raporttien esikatselu toimisi. Raporttien tallentamista IE:n puuttuminen ei kuitenkaan kaikissa tapauksissa estä.

Raporttien esikatselu komponentti tarjoaa seuraavat mahdollisuudet: "Tallenna" tallentaa raportin ja siihen mahdollisesti liittyvät muut tiedostot haluttuun sijaintiin (avaa standardin tallennusvalikon). "Tulosta" avaa standardin tulostusvalikon tai jos esikatselu optio on päällä avataan selaimen tukema Esikatselutila.

Kenttien validointi ja virheilmoitukset

JBO:ssa on suhteellisen paljon erilaisia syötekenttiä, joilla tiettyjä rajoitteita esim. pituuden tai kentän muodon suhteen. Useimmat näistä kentistä validoidaan eli niiden muoto tarkistetaan kentistä riippuvaa toimintoa suoritettaessa. Jotkut kentät validoidaan myös kirjoituksen aikana, mutta näistä on maininta toimintoluettelossa. Mikäli kenttä on virheellistä muotoa, muutetaan sen ja siihen liittyvän ohjekentän väri tällöin punaiseksi. Syötehakuehtojen yhteydessä itse kentän väriä ei muuteta, vaan kaikkia kenttiä rajaavan kehyksen tekstin väri muutetaan. Mahdollisesti annetaan myös vihjeitä virheen syystä yms. Väri muutetaan takaisin normaaliksi seuraavan hyväksytyn validoinnin yhteydessä.

Virheellisten syötekenttien tapauksessa ei siis näytetä perinteiseen tapaan erillistä virheviestiä, koska tämän kuittaaminen edellyttäisi käyttäjän huomion ja fokuksen siirtämistä itse virheellisestä syötekentästä virheilmoitukseen. Tämä puolestaan hidastaisi työskentelyä. Sen sijaan kriittisten ohjelman toimintaan liittyvien virheiden ja varoitusten yhteydessä näytetään standardi virheilmoitus. Kriittisten virheiden käsittelyä ja niistä toipumista ei ole tässä vielä Beta tasolla olevassa versiossa täysin huomioitu, mutta käytännön testit ainakin omissa laitteisto- ja ohjelmistoympäristöissä ovat osoittaneet oikein asennetun ohjelman hyvinkin vakaaksi.

Tuetut Windows:n standardit pikanäppäimet

Pikanäppäinkomennoista listattu on vain normaalista Windows käytännöstä poikkeavat näppäinyhdistelmät. Esim. kaikkien valikkojen toimintoihin pääsee Windows:n versiosta riippuen käsiksi normaaleilla näppäin yhdistelmillä: Alt+valikon alkukirjain+toiminnon alkukirjain. Ohjeen saa mistä tahansa ikkunasta käsin esille painamalla F1

Ohjelman tarjoamien toimintojen luettelo

 5. JBO:n arkkitehtuuri, ulkopuoliseen käyttöön tarvittavat rajapinnat ja "raporttitemplaatit".

HUSA:an pohjautuvan arkkitehtuurin teoreettinen kuvaus

JBO 2 on rakenteeltaan täysin erilainen vanhoihin versioihinsa nähden ja hyödyntää HUSA:n mukaista 6-taso arkkitehtuuria. Tässä on käsitelty arkkitehtuuria lähinnä yleisestä HUSA-lähtöisestä näkökulmasta. Käytännönläheisempää ja yksityiskohtaisempaa arkkitehtuurin kuvausta löytyy erillisestä arkkitehtuurisuunnitelmasta.

 Tietokantana on MS Access ja rakenne on suunniteltu mahdollisimman yksinkertaiseksi ja budjettikohtaiseksi.  Tällä järjestelyllä helpotetaan budjettien siirrettävyyttä ja mahdollista käsittelyä muilla ohjelmilla. Kantaan upotettuja "storeprosedureja", jotka Access tietokannassa käytännössä ovat hakukyselyjä, ei käytetä, johtuen halusta erottaa data ja datan käsittely puhtaasti toisistaan. Tämä on välttämätöntä myös siksi, että kutakin budjettia vastaa oma tietokantansa, joten mahdolliset muutokset hakukyselyissä pitäisi päivittää erikseen jokaiseen budjettiin. Toisaalta "storeprosedureista" saatu tehohyöty pienen kotikäyttöön tarkoitetun budjetin kohdalla ei välttämättä olisi kovin merkittävä ja sitoisi osan järjestelmän toteutuksestakin tiettyyn tietokantaformaattiin.

Tietokantaa käsitellään Data-rajapinnan kautta. Data-rajapinta puolestaan käyttää ADO:a kantaan kytkeytymiseen ja kannan käsittelyyn. Näin Data-rajapintakin on saatu kantariippumattomaksi ja myös yleiskäyttöiseksi. Vaikka data-rajapinta onkin joiltain osin sovitettu JBO:n tarpeisiin, voidaan siihen kuuluvia luokkia hyödyntää sellaisenaan myös muissa projekteissa. Disconnected ADO recordsettien käyttö puolestaan mahdollistaa tämän kerroksen osalta helpommin siirtymisen usean käyttäjän yhtä aikaa käyttämiin budjetteihin ja säästää muutenkin resursseja sulkemalla tietokantayhteydet heti kun mahdollista.

Data-rajapinnasta eteenpäin kerrokset on lisäksi jaettu tehtäväalueittaan kolmeen perusosaan. Kukin osa käsittelee oman tehtäväkenttänsä vaatimaa dataa jalostamalla sitä astetta helppokäyttöisempään muotoon hierarkiassa ylöspäin mentäessä.

Data-logiikka vastaa HUSA:n mukaisesti järjestelmän tietoalkioiden käsittelystä järkevinä kokonaisuuksina ja datariippuvuuksien hallinnoinnista. Sen tehtävänä on tarjota yhtenäinen mutta kuitenkin tietoalkiospesifiset validointi tarpeet ja riippuvuudet huomioiva tapa järjestelmän datan käsittelyyn. Tyypillisesti datalogiikka koostuu suuresta joukosta olioita (erilaiset elementit, itemit, memberit, member- ja itemiryhmät sekä itemeitä ja membereitä vastaavat hakuoptiot).  Näillä on yhteiset kantaluokat ja monilta osin samat rajapinnat mutta ne huomioivat kuitenkin omaan dataansa liittyvät rajoitukset. Datalogiikan luokat kätkevät taakseen datan käsittelyyn liittyviä yksityiskohtia ja toimintokokonaisuuksia, mutta tarjoavat vielä hyvin monipuoliset ja osittain järjestelmän tarpeet ylittävät mahdollisuudet.

Monipuolisuus tekee data-logiikan käytöstä käyttöliittymälogiikan kannalta turhan  hankalaa. Data-logiikan olioita hallinnoimaan ja yhdistelemään tarvitaankin edelleen käyttöliittymäympäristöstä riippumatonta logiikkaa (managerit), joka on järkevää erotella alemmista kerroksista omaksi tasokseen. Tätä hallinnointilogiikka-kerrosta voisi kutsua järjestelmän toiminnalliseksi ytimeksi. Se koostaa data-logiikan olioista käyttöliittymän toimintoja vastaavia palvelukokonaisuuksia, jotka kätkevät alleen data-logiikan oliojoukot. Siinä missä data-logiikka siis kätkee järjestelmän käsittelemään dataan liittyvät muodolliset eroavaisuudet ja riippuvuudet, hallinnointilogiikka puolestaan kätkee järjestelmän toiminnallisuuteen liittyvät muodolliset eroavaisuudet ja toimintojen keskinäiset riippuvuudet. Hallinnointilogiikan rajapinnat on räätälöity nimenomaan käyttöliittymän tarvitsemia tehtäväkokonaisuuksia ajatellen ja sen välittämästä datasta on karsittu käyttäjän kannalta turha informaatio, jota tarvitaan ainoastaan järjestelmän sisäiseen hallinnointiin. Sisäisen käyttöliittymän tarpeiden täyttämisen lisäksi hallinnointilogiikan tehtävänä on myös muodostaa tarvittavat kommunikointirajapinnat järjestelmästä ulospäin. Hallinnointilogiikka onkin nimenomaan se taso, jolle nykyiset ja myös tulevat liittymärajapinnat (esim. Web-servicejen kautta) ulkopuolisiin järjestelmiin on toteutettu ja tullaan toteuttamaan.

Ylimpänä logiikkatasona on käyttöliittymälogiikka, jonka tärkeimpänä tehtävänä on vastata hallinnointilogiikalta kysyttävän datan kytkemisestä käyttöliittymän kontrolleihin, sen esittämisestä käyttäjän kannalta sopivissa kokonaisuuksissa, paikoissa ja muodossa. Se ottaa myös vastaan käyttöliittymän tapahtumat ja välittää niitä vastaavat toimintokutsut hallinnointilogiikalle. Käyttöliittymälogiikka on ensimmäinen käyttöliittymäympäristöstä riippuva kerros eli esim. mahdollista selainkäyttöistä versiota varten tulee Web-ympäristöön rakentaa käyttöliittymän lisäksi oma  sinne sopiva käyttöliittymälogiikkansa.

Käyttöliittymäkerros on JBO:n tapauksessa rajattu pelkästään tiedon esittämistä ja sijoittelua varten. Siihen ei kuulu lainkaan varsinaista itse kirjoitettua koodia, vaan se koostuu tässä Windows-versiossa ainoastaan käyttöliittymän (formi) ulkoasun määrittelevästä koodiosasta, joka taas on generoitu automaattisesti kehitystyökalun suunnittelutilan perusteella.. Käyttöliittymä muodostaa käyttäjälle selkeän ja helposti hahmotettavan ympäristön järjestelmän tarjoaman datan havainnointia ja järjestelmän sekä käyttäjän välistä kommunikointia silmälläpitäen. Sen tehtävänä on myös luoda järjestelmälle positiivinen Imago, jonka perusteella käyttäjä pystyy saamaan käsityksen myös ohjelman pinnan alla piilevästä laadukkuudesta ja toimivuudesta.

JBO:n tietojärjestelmäarkkitehtuuri karkeimmalla tasolla. Järjestelmä on jaettu HUSA:n mukaisesti kuuteen peruskerrokseen, jotka data-logiikkatasolta lähtien on eriytetty edelleen kolmeen toiminnallisen kokonaisuuteen. Tietokantana on MS Access ja kantaa käsitellään ADO:n kautta. Data-rajapinta puolestaan tarjoaa yksinkertaistetun ja kanta-riippumattomattoman tavan datan välitykseen pääosin ADO-recordsettteinä tietokannasta logiikalle ja päinvastoin. Kerrosten eriytetyt palaset on pyritty suunnittelemaan siten, että keskinäisiä riippuvuuksia olisi mahdollisimman vähän. Käytännön toteutuksellisista syistä yhteyksiä kuitenkin on jonkin verran lähinnä Budjetti ja tasepaketista asetuspaketin suuntaan. Tarkempaa kuvausta arkkitehtuurista löytyy erillisestä arkkitehtuurisuunnitelmasta.

Raporttitemplaatit eli XSL-muotoiset raporttien muotoilumallit ja datavälitykseen käytettävän xml:n formatti

JBO-beta 2 versiossa on mahdollista tallentaa dataa xml-muodossa sekä syöte että tasepuolelta. Kummallekin näistä raporttityypeistä voidaan myös tehdä mukautetut XSL-templaatit eli muotoilumallit, joiden perusteella määräytyy miten raportit näkyvät selaimessa. Tässä ei käsitellä tarkemmin XSL-templaattien tekemistä sillä XSL:n formaatti on yleisesti hyväksyttyjen ohjeiden, standardien ja käytäntöjen mukainen. Huomaa että eri selaimet tai niiden versiot voivat rajoittaa sallittujen XSL-komentojen käyttöä. Raportit voidaan myös kääntää valmiiksi erillisillä kääntäjillä, jolloin selaimeen integroitua XML ja XSL-tukea ei tarvita.

Tämän dokumentin liitteenä on mallit sekä syöte- että tasepuolelta tallennetuista XML-dokumenteista, että niiden yhteydessä käytettävistä oletus XSL-stylesheeteistä. Huomaa että XSL-tarjoaa laajoja mahdollisuuksia ja esim. Javascriptin avulla voit muodostaa dataa vastaten jopa graafisia kaavioita.

• Viedyn (tuotavan) syötteiden XML-tiedoston formaatti (syöteraportti)
• Syöteraporttiin liittyvän XSL-mallin formaatti.
• Viedyn taseen XML-tiedoston formaatti (taseraportti)
• Taseraporttiin liittyvän XSL-mallin formaatti

Omien raporttimallien käyttöönotto

1. Syöteraporteille: Luo oma xsl-muotoinen syöteraporttimalli ja kopioi se ohjelman asennushakemiston alla sijaitsevaan ini hakemistoon nimellä. JBOInput.xsl. Vanhasta raporttimallista kannattaa ottaa varmuuskopio ennen sen ylikirjoittamista.
2. Taseraporteille: Taseraporteille on mahdollista luoda yleisen raporttimallin lisäksi myös budjettikohtainen raportti. Jos haluat luoda yleisen eli kaikille sellaisille taseraporteille joita vastaten ei ole luotu omaa budjettikohtaista raporttimallia käytettävän raporttimallin, luo raporttimallisi ohjelman asennushakemiston alla sijaitsevaan ini-hakemistoon nimellä balanceOutput.xsl. Jos taas haluat luoda vain tietylle budjetille käytettävän raporttimallin kopioi mallitiedostosi nimelle  budjetin nimi_balanceOutput.xsl (missä budjetin nimi korvataan tietysti :-) sen budjetin nimellä, jonka taseille haluat ko. mallia käyttää). Jälleen kerran muista varmuuskopioida mahdollinen ylikirjoitettava raporttimalli.

6. Usein kysytyt kysymykset

Huom. myös muualta tästä dokumentista tai ohjelman mukana tulevasta käyttöohjeesta saattaa löytyä ratkaisu mieltäsi askarruttavaan kysymykseen. Tässä käsitellyt kysymykset liittyvät lähinnä ohjelman asennukseen ja ylläpitoon.

1. Voinko asentaa JBO:n vapaasti oman koneeni lisäksi myös yritykseni käyttöön. V: JBO:n lisenssi sallii ohjelman asentamisen omaan henkilökohtaiseen käyttöön ja asennuksen levittämisen vapaasti em. käyttötarkoitukseen. Yrityskäyttöä varten tulee ottaa erikseen yhteyttä ohjelman tekijään esim. sähköpostitse.
2. Voinko sisällyttää JBO:n osaksi omaa ohjelmistotuotettani. V: JBO:n lisenssi ei salli tätä. Voit kuitenkin ottaa erikseen yhteyttä ohjelman tekijään esim. sähköpostitse.
3. Haluaisin tehdä ohjelman, jolla voin tuoda tietoja JBO:n esim. suoraan verkossa näkyvästä tiliotteestani. Onko tällaisen ohjelman tekeminen sallittua ja mistä saisin lisätietoja esim.JBO:n ulkopuoliseen käyttöön tarkoitetuista rajapinnoista. V: Kyllä se sallittua on, kunhan et tee muutoksia ohjelman alkuperäiseen asennuspakettiin. Käytännössä ulkopuolisilta ohjelmilta saatava syötedataa voidaan tuoda järjestelmään XML-muodossa (tiedostona), joka on täsmälleen samaa muotoa, kuin ohjelmasta ulos vietävä syötetiedosto. Myös COM-rajapinta olisi mahdollista tarjota hallinnointilogiikka tasolle, mutta tätä ei ole mahdollistettu ainakaan nykyisessä versiossa. Tulevissa versioissa saattaa tulla mahdollisia ulkopuoliseen käyttöön tarkoitettuja liittymärajapintoja esim. Web-service tai muiden liityntämekanismien avulla.
4. Tein oman siistimmän raporttimallin tasetta varten. Voinko liittää sen kaverilleni kopioimaani JBO:n versioon. V: JBO:n asennuspakettiin ei saa tehdä mitään muutoksia. Et siis voi liittää tiedostoa suoraan asennuspakettiin. Voit kuitenkin antaa tasemallin erillisenä tiedostona kaverillesi.
5. Asensin ohjelman ohjeiden mukaisesti, mutta käynnistyksen yhteydessä tulee joku mystinen runtime error. V: Asennus on epäonnistunut tai järjestelmäsi ei täytä minimivaatimuksia. Ohjelman asennushakemistossa täytyy olla kirjoitusoikeudet ja budjettitietokantojen ym. ohjelman käyttämien tiedostojen on oltava kirjoitettavassa muodossa (ei readonly). Levyllä on oltava tyhjää tilaa riittävästi käynnistyksen yhteydessä. Tarkista em. seikat ja jos niistä ei ole apua, yritä poistaa vanha asennus ja asentaa ohjelma uudelleen.
6. Kun käynnistin ohjelman ensimmäisen kerran avautui ohjattu budjetin luontitoiminto. Keskeytin kuitenkin toiminnon budjetin käyttäjien lisäysvaiheessa ja nyt budjetti valikkoon tulee näkyville luomani budjetin nimi, mutta en voi kirjautua sisään. V:  Jotta budjettia voisi käyttää, siinä tulee olla vähintään yksi käyttäjä ja käytännössä myös vähintään yksi tulo-/menoryhmä. Voit joko lisätä luomaasi budjettiin käyttäjän erillisellä toiminnolla ja kirjauduttuasi vähintään yhden tulo-/menoryhmän (ks. tarkempia ohjeita käyttöohjeesta). Mikäli haluat mieluummin luoda budjetin uudelleen käyttäen ohjattua toimintoa, poista ensin luomasi budjetti ja käynnistä sitten ohjattu budjetin luontitoiminto uudelleen.
7. JBO:n asennuksen poiston yhteydessä tulee virheilmoituksia. V: Todennäköisin syy virheilmoituksiin on että asennuksen poisto-ohjelma ei voi poistaa asennuksen jälkeen muokattuja tiedostoja. Näistä virheistä ei tarvitse välittää. Voit poistaa tiedostot turvallisesti asennuksen poiston jälkeen poistamalla koko budjetti ohjelman hakemiston. Huomaa kuitenkin että jos haluat säilyttää budjettisi ne kannattaa kopioida asennushakemiston alta löytyvästä Budjets hakemistosta talteen ennen ko. operaatiota.
8. Minulla oli aiemmin asennettuna budjettiohjelma, mutta poistin sen ja asensin uudelleen eri hakemistoon. Olisin halunnut vanhojen budjettieni säilyvän, mutta nyt niitä ei löydy enää mistään. V: JBO:n asennuksen poisto ei poista normaalisti budjetteja. Ohjelma ei kuitenkaan enää löydä niitä, jos se asennetaan eri hakemistoon. Voit joko manuaalisesti kopioida budjetti tiedostot vanhasta budjetti hakemistosta (oletuksena entisen asennussijainnin alihakemisto Budjets) uuteen budjettihakemistoon (oletuksena nykyisen asennussijainnin alihakemisto Budjets) tai sitten tuoda ne uuteen asennukseen Budjetti --> Tuo ulkopuolelta toiminnon avulla
9. Haluaisin siirtää budjetit johonkin eri hakemistoon kuin ohjelman asennuskansion yhteydessä oleva Budjets alihakemisto. V: Tätä toimintoa ei periaatteessa tässä Beta -versiossa tueta. Voit kuitenkin muuttaa budjettihakemistosi sijaintia muokkaamalla ohjelman asennushakemiston alihakemistossa ini sijaitsevassa jbo_dataSr.dsn tiedostossa budjetin sijaintipaikkoja. Rivit näyttävät suunnilleen seuraavan kaltaisilta: DefaultDir=D:\Projects\JBO\AjettavaOhjelma_JBO2\Budjets
   DBQ=D:\Projects\JBO\AjettavaOhjelma_JBO2\Budjets\jbo_newBudj.mdb  Muuta näiden hakemistopolut osoittamaan uuteen budjettihakemistoon. Huom. Ota varmuuskopio ko. tiedostosta ennen muokkausta. Virheellinen sijainti tai jopa ylimääräiset välilyönnit/rivinvaihdot ko. tiedostossa saattavat johtaa ohjelman toimimattomuuteen.
10. Poistin vahingossa tärkeän budjettini. Onko mitään mahdollisuutta saada sitä takaisin. V: Itse budjettiohjelman kautta ei. Kun budjetti poistetaan (siis kun vastaat poiston vahvistukseen kyllä), se poistetaan lopullisesti, eikä se mene esim. Windows:n roskakoriin. Tästä syystä on suositeltavaa ottaa budjets hakemistosta säännöllisesti varmuuskopioita. Budjetit ovat tavallisia tiedostoita ja saattavat myös korruptoitua vaikkapa äkillisen virtakatkoksen yhteydessä. Mikäli sinulla ei ole budjetistasi varmuuskopioita, mutta poisto tapahtui äskettäin voit yrittää palauttaa budjetti tiedostoasi kolmannen osapuolen tiedostojen palautus "unerase" ohjelmilla, jotka yleensä osaavat palauttaa lähiaikoina poistetut tiedostot.
11. Raporttien esikatselu ei toimi tallennusten ja/tai tulostusten yhteydessä. Raportin sijasta näkyviin tulee virhesivu "Page cannot be displayed" tai vastaava. V: Tarkista että sinulla on asennettuna IE:n 6:s versio tai uudempi. Raportti XML:n näyttäminen vaatii tätä. Mikäli olet äskettäin muokannut raporttien näyttämisestä vastaavaa XSL-tiedostoa voi ongelma johtua myös siitä, että ko. tiedosto on syntaksiltaan virheellinen.
12. Haluaisin tallentaa/tulostaa taseisiin liittyen myös graafiset kaaviot ja prosenttiosuudet. V: Tämä Beta versio ei suoraan tue ko. ominaisuutta. Seuraavaan versioon se kuitenkin todennäköisesti tulossa. Tällä hetkellä voit tietysti esim. erillisellä kuvankaappaus ohjelmalla kaapata kuvat tiedostoiksi ja liittää sitten käsin tulostettavaan taseraporttiin. JavaScriptiä hyödyntämällä voit laskea summia vastaavat prosenttiosuudet ja ottaa ne mukaan raporttiin. JavaScriptillä voit myös piirtää joitakin graafisia kuvioita. Ainakin pylväskaavioiden piirtäminen pitäisi onnistua.
13. Pidän kovasti budjettiohjelmasta, mutta siinä on myös joitakin puutteita/virheitä ja haluaisin esittää ehdotuksiani/kommenttejani ohjelman jatkokehitystä varten. V: Voit ottaa yhteyttä ohjelman kehittäjään esim. sähköpostilla. Muista kuitenkin, että olen kehittänyt budjettiohjelman omalla ajallani lähinnä omia tarpeitani varten (ilman kaupallisia taka-ajatuksia), mutta pistänyt sen yleiseen jakeluun ilmaiseksi, että muutkin voisivat hyötyä siitä jos näkevät sen itselleen hyödylliseksi. Rakentavat kommentit ja ehdotukset ovat aina tervetulleita,  mutta ei ole mitään takuuta siitä että ne aiheuttaisivat käytännön toimenpiteitä. Koska kyseessä on oma lähinnä vapaaluontoisesti etenevä projekti, kehitän sitä silloin kun hyväksi näen ja kun aikaa sattuu muilta kiireiltä olemaan. On kuitenkin ihan mukava saada kommentteja ja joskus pelkkä se tieto että ohjelmasta on ollut hyötyä itseni lisäksi myös jollekin muulle saattaa innoittaa tekemään siihen parannuksia. Eli lähettäkää vaikka postikortti jos siltä tuntuu. Osoite yms. tiedot löytyvät kotisivuiltani.  Ps. Älkää kuitenkaan lähettäkö kommentteja esim. tämän dokumentin kirjoitusvirheistä, joita varmaan löytyy vähintään miljoona. Oli suoranainen ihme että jaksoin näinkin laajan readme:n ohjelmaan väkertää, mutta suomen kielioppisääntöjä en sentään viitsi ruveta lauantai iltojeni ratoksi kertailemaan :-)

7. Viimehetken muutoksia ja versiohistoria

• Infoikkunaan lisätty lisenssitiedot ja linkki tekijän kotisivulle

Versiohistoria

• JBO with Basic (1993). Ohjelman kantamuotona voidaan pitää aikoinaan Basic -kielellä laatimaani ohjelmaa, jonka kautta tiettyihin ennalta määriteltyihin ryhmiin saattoi lisätä summia ja ohjelma laski sitten näiden ryhmien alla olevat summat yhteen sekä kokonaistaseen. Käyttö: Tulkin kautta
• JBO 1.0 (1998 alkuvuosi) Ensimmäinen virallinen JBO:n C++:lla koodattu versio, joka luki teksti muotoisia syötetiedostoja (syötteet annettiin esim. notepad:lla) ja käynnistettiin sitten komentoriviltä ohjelma, joka ajoi kaikki syötteet kerralla budjettiin (tekstimuotoiseen tietokantaan). Ohjelma generoi myös Html-muotoisen taseen, johon laski tulo-/menoryhmä kohtaiset yhteissummat, sekä kokonaistaseen. Tulo- ja menoryhmiä voitiin luokitella haluttu määrä tekstimuotoisia asetustiedostoja muokkaamalla. Taseeseen luotiin lisäksi linkki kunkin tulo-/menoryhmän kohdalle, jota klikkaamalla saattoi päästä katselemaan ko. ryhmän alle syötettyjä menoeriä. Käyttö: komentoriviltä tai erillisten toimintokohtaisten pikakuvakkeiden kautta.
• JBO 1.1 (1998 loppuvuosi) Toinen virallinen JBO:n versio joka toi JBO:n muutamia hyödyllisiä ominaisuuksia kuten lyhenteiden käytön. Lyhenteitä saattoi määritellä samalla tavalla erilliseen asetustiedostoon kuin otsikoita ja niiden avulla minkä tahansa teksti pätkän saattoi lyhentää määrittelemällään lyhenteellä. Budjettiin ajon yhteydessä lyhenteet korvattiin niitä vastaavilla teksteillä. 1.1 versioon tuli mukaan myös graafisen käyttöliittymän sisältävä hakuohjelma, jonka kautta syötteitä saattoi hakea budjetti tietokannasta summan/selitteen tai sen osan sekä tulo- ja menoryhmän otsikon perusteella. Molemmat ohjelmat oli koodattu C++:lla. Graafisen käyttöliittymän sisältävä hakuohjelma  C++ Builder 3:lla. Käyttö: komentoriviltä tai erillisten toimintokohtaisten pikakuvakkeiden kautta. Hakuohjelmaa käytettiin normaalisti graafisena Windows ohjelmana.
• JBO 1.2 (1999) Ensimmäinen versio, joka sisälsi täysin graafisen käyttöliittymän. Budjettitietokannan ja taseen päivittämiseen käytettiin kuitenkin edelleen vanhoja versioita JBO:sta.  Komentorivin tai erillisten pikakuvakkeiden sijasta toiminnot käynnistettiin nyt Windows-pohjaisen ohjelman käyttöliittymän kautta. Graafinen käyttöliittymä tehtiin sekä Delphi:llä että VB6:lla. Syötteen editointiin käytettiin notepad:n tai muun ulkopuolisen tekstieditorin sijasta samaa Windows käyttöliittymää, mikä tarjosi mahdollisuuden syötteiden formaatin tarkistamiseen jo ennen budjetin päivitystä. Käyttö: Graafisen Windows käyttöliittymän kautta.
• JBO 2.0 Beta 1 (2001 alkuvuosi) Pitkälti nykyisen ohjelman kaltainen versio JBO:sta, josta kuitenkin puuttui mm. mahdollisuus useisiin budjetteihin samassa asennuksessa. Ohjelma oli kokonaan tehty Windows-pohjaisena 32 bittisenä sovelluksena VB6:lla. Tietokanta formaattina Access 2000 ja kannan käsittelytekniikkana ADO. Järjestelmä oli suunniteltu (määrittely ja suunnitteludokumentit HYTT) ja käytti 4-tasoista arkkitehtuuria. Käyttö: Graafisen Windows käyttöliittymän kautta.

8. Lisäapua ja järjestelmän/komponentin päivitykset

• Ohjelman päivityksiä ja uusinta asennuspakettia voi etsiä Web:stä sivulta http://koti.mbnet.fi/lahteenj/Projects/JBO2/
• Tarkempaa informaatiota ohjelmaan liittyen voi kysellä sähköpostitse: osoite löytyy kotisivuiltani.

Määritelmät ja termit

Lyhenne/termi/määritelmä	Selitys
STEP	Sovittu Toimintatapa Erilaisille Projekteille
Kirjautumisikkuna
InfoIkkuna
Pääikkuna
Kalenteri-ikkuna
Raporttien esikatseluikkuna
JBO	Juhan Budjetti Ohjelma
JSO	Juhan Sairaskertomus Ohjelma
HUSA	Human Understandable System Analysis