Tietolähteiden parametrien toteutus

Tietolähteistä saa joustavampia toteuttamalla kyselyssä ajoaikaisia parametreja, joiden avulla tietolähteessä voidaan käyttää muuttujia.

Ne voivat olla Essbasessa määriteltyjä korvausmuuttujia, ajoaikaisia ruudukkokontekstin Smart View -käyttäjien siirtyessä ulkoisiin tietoihin määrittämiä parametreja, tai käyttäjän määrittämiä toimintoja, jotka on kirjoitettu ulkoisessa lähdejärjestelmässä.

Kun aiot käyttää muuttujia Essbase-tietolähteissä, sinun on ensin

  1. Ota muuttujan syntaksi mukaan tietolähteen kyselyyn. Tietolähteen kyselyn on esimerkiksi sisällettävä ? syntaksissaan, jossa ? on ajoaikana määriteltävän muuttujan paikkamerkki.

  2. Suorita jokin seuraavista toimista:

    • Aseta tietolähteessä kiinteä oletusparametri -arvo, jota Essbase voi käyttää varmistuksena siltä varalta, että muuttujan ajoaikainen konteksti ei kelpaa, TAI

    • Aseta tietolähteen käyttämä korvausmuuttuja
    • Hyväksy ulkoinen, käyttäjän määrittämä toiminto (tai tallennettu toimenpide) parametriksi

Tietolähteiden määrittäminen ja parametrien toteuttaminen niille edellyttää sovelluksen pääkäyttäjän tai ylempää roolia.

Muuttujien ottaminen käyttöön Essbase-tietolähteissä sujuvoittaa toimintoja, sillä ylläpidettävänä on vähemmän tietolähteitä. Toteuttamalla muuttujia tietolähteissä voit määrittää ajoaikaisen kyselyn kontekstin, jota käytetään aina käyttäjän käyttäessä Essbase-kuutioon liitettyä tietolähdettä.

Esimerkkinä seuraavat käyttötapaukset.

  • Tietokannan pääkäyttäjä valvoo toistuvaa tietojenlataustehtävää, jolla ladataan tiedot kuutioon kuukausittain. Tietokannan pääkäyttäjä voi hyödyntää korvausmuuttujaa kuluvan kuukauden tietojen lataukseen sen sijaan, että ylläpitäisi kullekin kuukaudelle lataussääntöä.

  • Sovelluksen pääkäyttäjä ylläpitää erilaisten liiketoiminnan käyttötapausten siirtymisraporttien määritelmiä. Sovelluksen pääkäyttäjä toteuttaa muuttujat taustalla olevassa tietolähteessä, jota Smart View -käyttäjät käyttävät siirtotoiminnoissaan. Näin sovelluksen pääkäyttäjällä on vähemmän siirtymisraporttien määritelmiä, jotka edellyttävät ylläpitoa ja virheenetsintää.

Tietolähteen oletusparametrin asetus

Aseta parametri tietolähteessä, jos haluat ottaa käyttöön muuttujat kyselyissä, joita Essbase luo kuution ulkopuolelle tallennettuja tietoja työstäessään.

Aseta oletusparametri seuraavasti:

  1. Hanki tai luo yhteys ulkoiseen tietojen lähteeseen (voit esimerkiksi luoda yhteyden Oracle-tietokantaan).

    Voit käyttää yleistä yhteyttä, jos sellainen on jo olemassa Lähteet-sivulla Essbase-verkkokäyttöliittymässä, tai voit luoda sovellustason yhteyden.

  2. Luo tietolähde sillä yhteydellä, jonka kautta käytät Oracle-tietokantaa.

    Voit määrittää tietolähteen yleisellä tasolla, jos sen tulee olla kaikkien sovellusten käytettävissä, tai voit määrittää sen sovellustasolla.

    1. Yleisen tietolähteen luontia varten sinun on oltava palvelun pääkäyttäjä. Valitse Lähteet, sitten Tietolähteet-välilehti käyttäjätunnuksen alla ja lopuksi Luo tietolähde.

      Jos taas haluat luoda sovellustason tietolähteen, sinun on oltava sovelluksen järjestelmänvalvojana tai tehokäyttäjä, jolla on määritetyn sovelluksen hallintaoikeus. Napsauta Sovellukset-välilehdessä sovelluksen nimeä. Valitse Lähteet, sitten Tietolähteet-välilehti käyttäjätunnuksen alla ja lopuksi Luo tietolähde.

    2. Valitse Yleinen-vaiheessa Yhteydelle luomasi Oracle-tietokantayhteys.

    3. Anna Nimi-kohtaan tietolähteen nimi.

    4. Syötä Kysely-kohtaan kysely (tässä esimerkissä SQL). Jos haluat siitä parametroidun kyselyn, on lisättävä suodatinehto (WHERE-lauseke), joka liittää lähteessä relaatiosarakkeen paikkamerkkiin. Muuttujan paikkaa ilmaistaan paikkamerkillä, ?, kyselyn syntaksiin. Paikkamerkki on parametrille, jonka siirrät tuonnempana.

      select * from SB_DT where DIMENSION_YEAR=?

      Oletetaan esimerkiksi, että relaatiotietokannassa on seuraava taulu nimeltä SB_DT. Taulussa on DIMENSION_YEAR-sarake, jonka arvoja ovat kuukaudet:
      Kuva relaatiotietokannasta, jossa sarake DIMENSION_YEAR on valittuna. Kaikki sen arvot ovat kuukausia: Jul, Aug, Aug, Sep, Sep, Oct, jne.

      Voit käyttää muuttujaa kuukausiarvojen valintaan DIMENSION_YEAR-sarakkeesta käyttämällä kyselyssä seuraavaa suodatinsyntaksia: where DIMENSION_YEAR=?
      Kuva Yleinen-välilehdestä Tietolähteen luonnin ohjatussa toiminnossa. Yhteys: SAMPLE.oracledb_conn, Nimi: oracledb_ds, Kuvaus: Tietolähde Oracle-tietokannalle, Kysely:ect * kohteesta SB_DT, jossa dimension_year=?

    5. Valitse Seuraava.

    6. Käytä Sarakkeet-vaiheessa tietotyyppiä, jonka Essbasen tulisi liittää jokaiseen relaatiolähdetietojen jokaiseen sarakkeeseen.

      Voit esimerkiksi asettaa numeeristen sarakkeiden tyypiksi Kaksinkertainen ja jättää aakkosnumeeristen sarakkeiden tyypiksi Merkkijono.


      Kuva Sarakkeet-välilehdestä ohjatussa Luo tietolähde -toiminnossa, Tyyppi-valintana Kaksinkertainen ja Merkkijono.

    7. Valitse Seuraava.

    8. Parametrit-vaiheessa luodaan Param1 – tämä parametri on olemassa, koska käytit arvoa ? Yleinen-vaiheen kyselyssä.

      Jätä Käytä muuttujia valitsematta, napsauta hiiren kakkospainikkeella tekstikenttää kohdassa Arvo ja anna ajoaikaiselle parametrille oletusarvo. Tämän oletusarvon tarkoituksena on toimia Essbasen varmistuksena siltä varalta, että parametrin ajoaikainen konteksti ei kelpaa. Tämä vaihe on tärkeä, jos aiot käyttää ajoaikaisia parametreja osana siirtymisraporttien määritelmiä.

      Voit myös nimetä parametrin Param1 uudelleen nimellä, joka on käyttötapauksessa merkityksellinen. Voit esimerkiksi antaa uudeksi nimeksi param_G_month, jolla ilmaistaan, että parametri käyttää yleistä muuttujaa kuluvalle kuukaudelle, tai voit käyttää nimenä param_<appName>_month, jolla ilmaistaan, että parametri käyttää sovellustason muuttujaa kuluvalle kuukaudelle. Parametrien nimien mukautuksesta voi olla hyötyä parametrien virheenkorjauksessa Essbasen palvelinlokitiedostojen avulla.


      Kuva Parametrit-välilehdestä ohjatussa Luo tietolähde -toiminnossa. Käytä muuttujia -valinta on poistettu ja annettu arvo on Jan.

      Jos haluat mukauttaa parametria niin, että se viittaa korvausmuuttujaan, oletusarvoa ei tarvitse antaa. Katso tämän aiheen sijaan kohta Korvausmuuttujien käyttäminen tietolähteessä.

    9. Valitse Seuraava.

    10. Huomaa, että Esikatselussa kyselyssä on käytetty oletusparametria. Esikatselu täytetään vain ulkoisilla lähdetietueilla, joiden DIMENSION_YEAR-sarakkeen arvo on Jan.


      Kuva Esikatselu-välilehdestä ohjatussa Luo tietolähde -toiminnossa. Vain tietueet, joissa DIMENSION_YEAR = Jan, näytetään.

      Vaikka esikatselussa näytetään vain arvot, joissa on oletusparametri käytössä, kun myöhemmin otat käyttöön ajoaikaisia parametreja siirtymisraportin määritelmälle, käytössäsi on ulkoisia tietoja enemmän kuin mitä esikatselussa näytettiin.

    11. Luo tähän ulkoisten lähdetietojen kyselyyn perustuva tietolähde valitsemalla Luo. Tietolähde otetaan käyttöön ajoaikaisten parametrien käyttöönottoa varten.

Korvausmuuttujien käyttäminen tietolähteessä

Seuraavassa työnkulussa esitetään, kuinka luoda Essbase-tietolähde ulkoisten lähdetietojen kyselystä käyttämällä Essbasessa määritettyä korvausmuuttujaa. Korvausmuuttuja lisää joustavuutta lähdetiedoista hakevan kyselyn suunnitteluun.

Tässä esimerkissä käytetään korvausmuuttujaa Essbasessa kuluvan kuukauden ilmoittamiseen. Sen sijaan, että päivittäisit tietolähteet kuukausittain käyttämään sen hetkisen kuukauden tietoja, voit antaa tietolähteiden olla ja päivittää vain määrittämäsi korvausmuuttujan.

  1. Luo yleinen tai sovellustason korvausmuuttuja.


    Sovellustasolla luodun korvausmuuttujan kuva. Nimi: CurrMonth, arvo: Aug

  2. Hanki tai luo yhteys ulkoiseen tietojen lähteeseen (voit esimerkiksi luoda yhteyden Oracle-tietokantaan).

    Voit käyttää yleistä yhteyttä, jos sellainen on jo olemassa Lähteet-sivulla Essbase-verkkokäyttöliittymässä, tai voit luoda sovellustason yhteyden.

  3. Luo tietolähde sillä yhteydellä, jonka kautta käytät Oracle-tietokantaa.

    Voit määrittää tietolähteen yleisellä tasolla, jos sen tulee olla kaikkien sovellusten käytettävissä, tai voit määrittää sen sovellustasolla.

    1. Valitse Yleinen-vaiheessa Yhteydelle luomasi Oracle-tietokantayhteys.

    2. Anna Nimi-kohtaan tietolähteen nimi.

    3. Syötä Kysely-kohtaan kysely (tässä esimerkissä SQL). Jos haluat siitä parametroidun kyselyn, on lisättävä suodatinehto (WHERE-lauseke), joka liittää lähteessä relaatiosarakkeen paikkamerkkiin. Muuttujan paikkaa ilmaistaan paikkamerkillä, ?, kyselyn syntaksiin. Paikkamerkki on parametrille, jonka siirrät tuonnempana.

      select * from SB_DT where DIMENSION_YEAR=?

      Oletetaan esimerkiksi, että relaatiotietokannassa on seuraava taulu nimeltä SB_DT. Taulussa on DIMENSION_YEAR-sarake, jonka arvoja ovat kuukaudet:
      Kuva relaatiotietokannasta, jossa sarake DIMENSION_YEAR on valittuna. Kaikki sen arvot ovat kuukausia: Jul, Aug, Aug, Sep, Sep, Oct, jne.

      Voit käyttää muuttujaa kuukausiarvojen valintaan DIMENSION_YEAR-sarakkeesta käyttämällä kyselyssä seuraavaa suodatinsyntaksia: where DIMENSION_YEAR=?
      Kuva Yleinen-välilehdestä Tietolähteen luonnin ohjatussa toiminnossa. Yhteys: SAMPLE.oracledb_conn, Nimi: oracledb_ds, Kuvaus: Tietolähde Oracle-tietokannalle, Kysely:ect * kohteesta SB_DT, jossa dimension_year=?

    4. Valitse Seuraava.

    5. Käytä Sarakkeet-vaiheessa tietotyyppiä, jonka Essbasen tulisi liittää jokaiseen relaatiolähdetietojen jokaiseen sarakkeeseen.

      Voit esimerkiksi asettaa numeeristen sarakkeiden tyypiksi Kaksinkertainen ja jättää aakkosnumeeristen sarakkeiden tyypiksi Merkkijono.


      Kuva Sarakkeet-välilehdestä ohjatussa Luo tietolähde -toiminnossa, Tyyppi-valintana Kaksinkertainen ja Merkkijono.

    6. Valitse Seuraava.

    7. Parametrit-vaiheessa luodaan Param1 – tämä parametri on olemassa, koska käytit arvoa ? Yleinen-vaiheen kyselyssä. Voit mukauttaa Param1-arvon viittaamaan korvausmuuttujaan valitsemalla Käytä muuttujia ja valitsemalla korvausmuuttuja avattavasta Arvo-luettelosta.

      Jos luot tietolähdettä sovelluksen sisällä, valittavissa on sekä yleiset että sovellustason korvausmuuttujat. Sovellustason muuttujien etuliitteenä on sovelluksen nimi. Jos luot yleistä tietolähdettä, valittavissa on vain yleiset korvausmuuttujat.

      Voit nimetä parametrin Param1 uudelleen nimellä, joka on käyttötapauksessa merkityksellinen. Voit esimerkiksi antaa uudeksi nimeksi param_G_month, jolla ilmaistaan, että parametri käyttää yleistä muuttujaa kuluvalle kuukaudelle, tai voit käyttää nimenä param_<appName>_month, jolla ilmaistaan, että parametri käyttää sovellustason muuttujaa kuluvalle kuukaudelle. Parametrien nimien mukautuksesta voi olla hyötyä parametrien virheenkorjauksessa Essbasen palvelinlokitiedostojen avulla.


      Kuva Parametrit-välilehdestä ohjatussa Luo tietolähde -toiminnossa. Käytä muuttujia -vaihtoehto on valittu, ja arvo on Sample.CurrMonth.

    8. Valitse Seuraava.

    9. Huomaa, että Esikatselussa kyselyssä käytetään korvausmuuttujaa. Esikatselu täytetään vain ulkoisilla lähdetietueilla, joiden DIMENSION_YEAR-sarakkeen arvo on Aug.


      Kuva Esikatselu-välilehdestä ohjatussa Luo tietolähde -toiminnossa. Vain tietueet, joissa DIMENSION_YEAR = Aug, näytetään.

    10. Luo tähän ulkoisten lähdetietojen kyselyyn perustuva tietolähde valitsemalla Luo.