Pahoittelut etukäteen blogimme lukijoille; tämä menee nyt hieman tuotemainoksen puolelle, mutta nyt on kyseessä sen verran uniikki tuote että on pakko hieman hehkuttaa.
Business Intelligence-projektit ovat tyypillisesti haasteellisia dokumentoitavia. Täytyy myöntää että itsellekin on useamman kerran tullut tunnettua tuskaa dokumentaatiota tehdessä toimituksen viime metreillä.
Tyypillisesti projektin dokumentaatio koostuu osin tehdystä määrittelydokumentista, jota sitten projektin edetessä täydennetään BI-projektin tuotoksilla (suomeksi, yleensä dokumentaatio luodaan vasta kun on ihan pakko).
Tyypillistä on, että Word-dokumenttiin luodaan n kpl staattisia taulukoita, joihin otetaan sisältöä sivumäärän kasvattamiseksi copy-pastella luodusta tietovarastosta, taulujen rakenteesta, stage-tauluista, kuutioista, mappauksista jne. Lopputuloksena on pahimmillaan sata sivua pitkä arvoton copy-paste-pläjäys.
Kahden vuoden kuluttua projektin päättymisestä ja dokumentaation luovuttamisesta on tyypillistä että:
- Dokumentaatio on jäänyt päivittämättä ja on siksi käyttökelvoton.
- Dokumentaatio on niin kompleksinen, pitkä ja tekninen, ettei asiakas ymmärrä siitä mitään. Dokumenttia ei ole edes avattu luovuttamisen jälkeen.
- BI-projekti on enemmän tai vähemmän itse itsensä dokumentoiva, kokeneille tekijöille asiat selviävät helpommin katsomalla tuotokset läpi.
- Dokumentaatio ei itse asiassa vastaa seuraaviin oleellisiin kysymyksiin:
- Mistä raportilla näkyvä luku tulee? Missä se on tietovarastossa? Mistä lähdejärjestelmän taulusta ja sarakkeesta se tulee?
- Miten raportit, kuutiot, tietovarastot suhteutuvat toisiinsa?
- Mitä tapahtuu jos muutan tietovaraston yhden taulun tai sarakkeen nimeä tai tietotyyppiä, mihin kaikkialle se vaikuttaa?
Dokumentaation suurin arvo on siihen tallennetut käyttäjätunnukset ja salasanat, joilla pahimmillaan pääsee sekunneissa murtautumaan asiakkaan tuotantoympäristöön. Varmuuden vuoksi dokumentaationivaska kulki konsultin mukana putkikassissa, joka unohtui epähuomiossa Ala-Tikkurilan Shell-huoltoasemalle.
Näitä dokumentoinnin dilemmoja olen silloin tällöin pohdiskellut jo monta vuotta. Muistelisin että kymmenisen vuotta sitten eräs kollega heitti idean, mitä jos oikeasti dokumentoitaisiin projekti mappauksilla? Siten että helposti päästäisiin käsiksi esim. raportin sarakkeelta tiedon lähteelle asti? Taisin vastata jotain tyyliin: “Joo, tee pois vaan – jos osaat”. No, ilman työkaluja tuollaisen dokumentaation luonti olisikin ollut mahdoton tehtävä.
Vuosi sitten törmäsin Pragmatic Worksiin. ‘BI Documenter’ (nykyiseltä nimeltään Doc xPress)-tuotteeseen. Olin myyty heti ensiasennuksen suoritettuani.
Yhtään liitoittelematta uskallan väittää, että Doc xPress vie BI-projektin dokumentoinnin uusiin, ennennäkemättömiin svääreihin.
Lyhyesti, kyse on tästä:
- Dokumentaation automatisointi. Dokumentoi Microsoft BI-ympäristösi automaattisesti Word, HTML tai .chm-help-file muotoisena. Unohda rakenteiden manuaalinen kopiointi. Dokumentaatio on käytettävyydeltään aivan toista luokkaa staattiseen word-dokumentaatioon verrattuna, ja aina ajantasainen.
- Projektin seuranta projektin aikana; mitä on saatu aikaiseksi. Tämä onnistuu Snapshot-vertailulla. Dokumentaation versiot arkistoidaan automaattisesti snapshotteina. Näet työkalun avulla heti mitä uutta projektiin on tullut esim. edellisen viikon aikana. Alla olevan esimerkkivertailun avulla selviää, että asiakasdimensioon on lisätty yksinkertainen audit-toiminnallisuus.


- Ehkä paketin pysäyttävin ominaisuus on Lineage Analysis. Koskaan aiemmin ei ole ollut käsissä välinettä, jolla pystytään analysoimaan projektin vaikutussuhteita miltä tahansa tasolta. BI-projektin kokonaisuushan koostuu tyypillisesti ETL:stä, tietovarastosta, kuutioista sekä raporteista. Lineage Analysis mahdollistaa ennennäkemättömällä tavalla valitsemaan esimerkiksi tietovarastosta yhden sarakkeen, selvittämään mistä se tulee ja mihin sarake ui kuutiossa ja raporteilla.
- Erilaisia hyötyjä voidaan esimerkiksi saada:
- Vaikutussuhteiden selvittäminen pääkäyttäjälle ja kehittäjille – esim. mistä lähteestä raportilla näkyvä luku tulee, mitä ketjua pitkin se tulee raportille
- Projektin kokonaisuuden hahmottaminen uudelle kehittäjälle
- Mihin kaikkialle vaikuttaa jos vaihdan tietovaraston sarakkeen tietotyyppiä tai nimeä
- Heikot nimeämiskäytännöt tietovarastossa paljastuvat projektipäällikölle tai pääkäyttäjälle helposti ja nopeasti. On tyypillistä että kehittäjien laiskuuden vuoksi ETL-komponentit, datasetit jne on jätetty nimeämättä. Tämä vaikeuttaa ylläpitoa tai uusien kehittäjien mukaan hyppäämistä huomattavasti. Tai esimerkiksi asioita on oiottu lisäämällä logiikkaa pelkästään kuutioon.
- Alla olevasta esimerkistä selviävät nopeast demo- BI-projektin komponentit, joissa asiakasdimensiota on käytetty:
- Seuraavasta esimerkistä selviää, mistä lähdejärjestelmän sarakkeesta asiakkaan nimi tulee. Se on näemmä yhdistelmä lähdejärjestelmän etu- ja sukunimestä.