Lisämenetelmät: viittaus muuttujien tallennettuihin arvoihin

Haluat esimerkiksi luoda analyysin, jonka otsikko näyttää kulloisenkin käyttäjän nimen. Voit tehdä tämän viittaamalla muuttujaan.

Voit viitata analyyseissä, koontinäytöissä ja toiminnoissa erityyppisiin muuttujiin, jotka ovat istunto, semanttinen malli (tietovarasto), esitys, pyyntö ja yleinen. Sisällön tekijät voivat määrittää esitys-, pyyntö- ja yleismuuttujia itse, mutta muuntyyppiset (istunto ja semanttinen malli (tietovarasto)) muuttujat määritetään semanttisessa mallissa.

Huomautus: Oracle Analytics ei tue muuttujia :user ja :password tietolähteen yhteyden valtuuksissa.

Muuttujan tyyppi Määritetty Määrittäjä Lisätietoja

Istunto

  • Järjestelmä

  • Muu kuin järjestelmä

Semanttinen malli

Tietomallin tekijät

 Tietoja istuntomuuttujista

Semanttinen malli (tietovarasto)

  • Dynaaminen

  • Staattinen

Semanttinen malli

Tietomallin tekijät

 Tietoja semanttisen mallin (tietovaraston) muuttujista

Esitys

Analyysien ja koontinäyttöjen kehotteet

Sisällön tekijät

 Tietoja esitysmuuttujista

Pyyntö

Analyysien ja koontinäyttöjen kehotteet

Sisällön tekijät

 Tietoja pyyntöjen muuttujista

Yleiset

Analyysit

Pääkäyttäjät

 Tietoja yleismuuttujista ja Yleismuuttujien luonti

Tietoja istuntomuuttujista

Istuntomuuttujat alustetaan, kun käyttäjä kirjautuu sisään.

Nämä muuttujat ovat olemassa kullekin käyttäjälle selausistunnon ajan ja ne vanhenevat, kun käyttäjä sulkee selaimen tai kirjautuu ulos. Istuntomuuttujia on kahta tyyppiä: järjestelmän muuttujia ja muita kuin järjestelmän muuttujia.

Järjestelmän istuntomuuttujat

Useita järjestelmän istuntomuuttujia voi käyttää raporteissa ja koontinäytöissä.

Järjestelmän istuntomuuttujilla on varattuja nimiä, joita ei voi käyttää missään muissa muuttujissa.

Järjestelmän istuntomuuttuja Kuvaus SQL-kyselyn arvon esimerkki (Muuttuja-valintaikkuna)

PORTALPATH

Määrittää oletuskoontinäytön, jonka käyttäjä näkee, kun hän kirjautuu sisään (hän voi ohittaa tämän määrityksen kirjauduttuaan sisään).

Oman koontinäytön näyttäminen, kun käyttäjä kirjautuu sisään:

 select ‘/shared/_portal/mydashboard’ from dual;

TIMEZONE

Määrittää käyttäjän oletusaikavyöhykkeen, kun käyttäjä kirjautuu sisään.

Käyttäjän aikavyöhyke täytetään yleensä käyttäjän profiilista. Käyttäjät voivat vaihtaa oletusaikavyöhykkeensä määrityksissä (Oma tili).

Aikavyöhykkeen määrittäminen, kun käyttäjä kirjautuu sisään:

select ‘(GMT-08:00) Pacific Time (US & Canada)’ from dual;

DATA_TZ

Määrittää tiedoille siirtymän alkuperäisestä aikavyöhykkeestä.

Tämän muuttujan avulla voit muuntaa aikavyöhykkeen niin, että käyttäjät näkevät sopivan aikavyöhykkeen.

Tietojen muuntaminen itäiseen normaaliaikaan (EST):

select ‘GMT-05:00’ from dual;

Tämä esimerkki tarkoittaa aikaa, joka on Greenwichin aika (GMT) - 5 tuntia.

DATA_DISPLAY_TZ

Määrittää aikavyöhykkeen tietojen näyttämiselle.

Itäisen normaaliajan (EST) näyttäminen:

select ‘GMT-05:00’ from dual;

Tämä esimerkki tarkoittaa aikaa, joka on Greenwichin aika (GMT) - 5 tuntia.

Muut kuin järjestelmän istuntomuuttujat

Muut kuin järjestelmän istuntomuuttuja nimetään ja luodaan semanttisessa mallissa.

Mallintaja voi luoda esimerkiksi muuttujan nimeltä SalesRegion, jolla alustetaan käyttäjän myyntialueen nimi, kun hän kirjautuu sisään.

Tietoja semanttisen mallin (tietovaraston) muuttujista

Semanttisen mallin (tietovaraston) muuttuja on muuttuja, jolla on yksi arvo kaikkina ajankohtina.

Semanttisen mallin (tietovaraston) muuttujat voivat olla staattisia tai dynaamisia. Staattisella semanttisen mallin (tietovaraston) muuttujalla on arvo, joka on pysyvä eikä muutu ennen kuin järjestelmänvalvoja muuttaa sen. Dynaamisella semanttisen mallin (tietovaraston) muuttujalla on arvo, joka päivitetään kyselyjen palauttamilla tiedoilla.

Tietoja esitysmuuttujista

Esitysmuuttuja luodaan sarakekehotteen tai muuttujan kehotteen luonnin yhteydessä.

Tyyppi Kuvaus

Sarakkeen kehote

Esitysmuuttuja, joka luodaan osana sarakkeen kehotetta, liitetään sarakkeeseen, ja arvot, joita se voi saada, tulevat sarakkeen arvoista.

Voit luoda esityksen muuttujan osana sarakkeen kehotetta valitsemalla Uusi kehote -valintaikkunassa Aseta muuttuja -kentästä Esityksen muuttuja. Syötä muuttujalle nimi Muuttujan nimi -kenttään.

Muuttujan kehote

Osana muuttujan kehotetta luotavaa esityksen muuttujaa ei liitetä mihinkään sarakkeeseen, ja määrität itse arvot, joita se voi saada.

Voit luoda esityksen muuttujan osana muuttujan kehotetta valitsemalla Uusi kehote -valintaikkunassa Kehote-kentästä Esityksen muuttuja. Syötä muuttujalle nimi Muuttujan nimi -kenttään.

Esityksen muuttujan arvon täyttää sarakkeen tai muuttujan kehote, jolla se luotiin. Tämä tarkoittaa, että joka kerta, kun käyttäjä valitsee vähintään yhden arvon sarakkeen tai muuttujan kehotteesta, esityksen muuttujan arvoksi määritetään käyttäjän valitsema arvo tai arvot.

Tietoja pyyntöjen muuttujista

Pyynnön muuttujan avulla voit ohittaa istuntomuuttujan arvon, mutta vain sarakkeen kehotteesta käynnistetyn tietokantapyynnön ajan. Voit luoda pyynnön muuttujan osana sarakkeen kehotteen luontiprosessia.

Voit luoda pyynnön muuttujan, kun luot jonkin seuraavantyyppisistä koontinäytön kehotteista:

  • Pyynnön muuttuja, joka luodaan osana sarakkeen kehotetta, liitetään sarakkeeseen, ja arvot, joita se voi saada, tulevat sarakkeen arvoista.

    Voit luoda pyynnön muuttujan osana sarakkeen kehotetta valitsemalla Uusi kehote -valintaikkunassa Aseta muuttuja -kentästä Pyynnön muuttuja. Syötä ohitettavan istuntomuuttujan nimi Muuttujan nimi -kenttään.

  • Pyynnön muuttujaa, joka luodaan osana muuttujan kehotetta, ei liitetä mihinkään sarakkeeseen, ja määrität itse arvot, joita se voi saada.

    Voit luoda pyynnön muuttujan osana muuttujan kehotetta valitsemalla Uusi kehote -valintaikkunassa (tai Kehotteen muokkaus -valintaikkunassa) Kehote-kentästä Pyynnön muuttuja. Syötä sitten ohitettavan istuntomuuttujan nimi Muuttujan nimi -kenttään.

Pyynnön muuttujan arvon täyttää sarakkeen kehote, jolla se luotiin. Tämä tarkoittaa, että joka kerta, kun käyttäjä valitsee arvon sarakkeen kehotteesta, pyynnön muuttujan arvoksi määritetään käyttäjän valitsema arvo. Arvo on kuitenkin voimassa vain siitä, kun käyttäjä painaa Siirry-painiketta kehotteessa siihen, kun analyysin tulokset palautetaan koontinäyttöön.

Tiettyjä järjestelmän istuntomuuttujia (kuten USERGUID tai ROLES) ei voi ohittaa pyynnön muuttujilla. Muita järjestelmän istuntomuuttujia, kuten DATA_TZ ja DATA_DISPLAY_TZ (aikavyöhyke), voi ohittaa, jos ne on konfiguroitu Model Administration Tool -työkalulla.

Vain merkkijono- ja numeromuotoiset pyynnön muuttujat tukevat useita arvoja. Kaikki muut tietotyypit välittävät vain ensimmäisen arvon.

Tietoja yleismuuttujista

Yleismuuttuja on sarake, joka luodaan yhdistämällä tietty tietotyyppi ja arvo. Arvo voi olla päivämäärä, päivämäärä ja kellonaika, numero, teksti ja aika.

Yleismuuttuja arvioidaan analyysin suoritushetkellä, ja yleismuuttujan arvo korvataan tarpeen mukaan.

Vain käyttäjät, joilla on BI-palvelun pääkäyttäjän rooli, voivat hallita (lisätä, muokata ja poistaa) yleismuuttujia.

Voit luoda yleismuuttujan arvon analyysin luontiprosessissa Muokkaa sarakkeen kaavaa -valintaikkunan avulla. Yleismuuttuja tallennetaan sen jälkeen luetteloon, ja se on muiden analyysien käytettävissä tietyssä oliojärjestelmässä.

Yleismuuttujien luonti

Voit tallentaa laskutoimituksen yleismuuttujana ja käyttää sitä uudelleen eri analyyseissä.

  1. Avaa analyysi muokkausta varten.
  2. Valitse Valitut sarakkeet -ruudussa Valinnat sarakkeen nimen vierestä.
  3. Avaa Sarakekaava-välilehti valitsemalla Muokkaa kaavaa.
  4. Valitse Muuttuja ja sitten Yleinen.
  5. Valitse Lisää uusi yleismuuttuja.
  6. Syötä arvo Nimi-kohtaan. Esimerkkejä: gv_region, date_and_time_global_variable tai rev_eastern_region_calc_gv.
    Yleismuuttujan nimen on oltava täydellinen, kun muuttujaan viitataan, ja näin ollen sen eteen lisätään teksti "global.variables". Esimerkiksi yleismuuttuja, joka on määritetty tuoton laskemista varten, näkyy Sarakekaava-valintaikkunassa seuraavasti:

    "Perustiedot"."1- Tuotto"*@{global.variables.gv_qualified}

  7. Syötä arvot kohtiin Tyyppi ja Arvo.
    • Jos valitset Päivämäärä ja aika -tietotyypin, syötä arvo samalla tavoin kuin seuraavassa esimerkissä: 03/25/2004 12:00:00 AM
    • Jos syötät arvoksi lausekkeen tai laskutoimituksen, sinun on käytettävä Teksti-tietotyyppiä kuten seuraavassa esimerkissä: "Perustiedot"."1- Tuotto"*3.1415
  8. Valitse OK. Uusi yleismuuttuja lisätään Yleismuuttujan lisäys -valintaikkunaan.
  9. Valitse juuri luomasi yleismuuttuja ja valitse OK. Muokkaa sarakekaavaa -valintaikkuna tulee näkyviin niin, että yleismuuttuja on Sarakekaava-ruudussa. Räätälöidyt otsikot -valintaruutu valitaan automaattisesti.
  10. Syötä sarakkeelle, johon olet määrittänyt yleismuuttujan, uusi nimi, joka vastaa paremmin muuttujaa.
  11. Valitse OK.

Muuttujiin viittauksen syntaksi

Voit viitata muuttujiin analyyseissä ja koontinäytöissä.

Se, miten muuttujaan viitataan, riippuu suoritettavasta tehtävästä. Tehtävissä, joissa käytössäsi on valintaikkunassa olevia kenttiä, sinun on määritettävä vain muuttujan tyyppi ja nimi (ei koko syntaksia), esimerkiksi viittaus muuttujaan suodatinmäärityksessä.

Muissa tehtävissä, kuten viitattaessa muuttujaan otsikkonäkymässä, muuttujan syntaksi määritetään. Käytetty syntaksi riippuu muuttujan tyypistä seuraavan taulukon mukaisesti.

Tyyppi Syntaksi Esimerkki

Istunto

@{biServer.variables['NQ_SESSION.muuttujan_nimi']}

jossa muuttujan_nimi on istuntomuuttujan nimi, esimerkiksi DISPLAYNAME.

@{biServer.variables['NQ_SESSION.SalesRegion']}

Semanttinen malli (tietovarasto)

@{biServer.variables.muuttujan_nimi}

tai

@{biServer.variables['muuttujan_nimi']}

jossa variablename on muuttujan nimi, esimerkiksi prime_begin

@{biServer.variables.prime_begin}

tai

@{biServer.variables['prime_begin']}

Esitys tai pyyntö

@{variables.muuttujan_nimi}[muoto]{oletusarvo}

tai

@{laajuus.variables['muuttujan_nimi']}

jossa:

muuttujan_nimi on esityksen tai pyynnön muuttuja, esimerkiksi MyFavoriteRegion.

(valinnainen) muoto on muuttujan tietotyypistä riippuva muotomääritys, esimerkiksi #,##0, MM/DD/YY hh:mm:ss. (Huomaa, että muotoa ei käytetä oletusarvoon.)

(valinnainen) oletusarvo on vakion tai muuttujan viittaus, joka ilmaisee arvon, jota käytetään, jos muuttujan_nimi-määrityksellä viitattua muuttujaa ei täytetä.

laajuus määrittää muuttujan tarkenteet. Laajuus on määritettävä, kun muuttujaa käytetään useilla tasoilla (analyyseissä, koontinäyttösivuissa ja koontinäytöissä) ja haluat sen käyttävän tiettyä arvoa. (Jos et määritä laajuutta, tärkeysjärjestys on analyysit, koontinäyttösivut ja koontinäytöt.)

Kun koontinäytön kehotetta käytetään sellaisen esitysmuuttujan kanssa, jolla voi olla useita arvoja, syntaksi vaihtelee saraketyypin mukaan. Useat arvot muotoillaan pilkuilla erotelluiksi arvoiksi, ja näin ollen mahdollista muotoilulausetta käytetään kuhunkin arvoon ennen kuin ne yhdistetään pilkuilla.

@{variables.MyFavoriteRegion}{EASTERN REGION}

tai

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

tai

@{dashboard.variables['MyFavoriteRegion']}

tai

(@{myNumVar}[#,##0]{1000})

tai

(@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{)

tai

(@{myTextVar}{A, B, C})

Yleiset

@{global.variables.muuttujan_nimi}

jossa muuttujan_nimi on yleismuuttujan nimi, esimerkiksi gv_region. Kun viitataan yleismuuttujaan, on käytettävä täydellistä nimeä esimerkissä näytetyllä tavalla.

Yleismuuttujien nimeämiskäytäntöjen on noudatettava JavaScriptiä koskevia ECMA-kielen määrityksiä. Nimi ei saa olla yli 200 merkkiä pitkä eikä se saa sisältää välilyöntejä, varattuja sanoja tai erikoismerkkejä. Jos et tunne JavaScript-kielen vaatimuksia, tutustu kolmannen osapuolen viitemateriaaleihin

@{global.variables.gv_date_n_time}

Voit viitata muuttujiin myös lausekkeissa. Ohjeet siihen, miten lausekkeissa viitataan muuttujiin, on annettu seuraavissa aiheissa:

Istuntomuuttujat

Seuraavissa ohjeissa kerrotaan, miten lausekkeissa viitataan istuntomuuttujiin:

  • Sisällytä istuntomuuttuja VALUEOF-funktion argumenttina.
  • Laita muuttujan nimi lainausmerkkeihin.
  • Kirjoita istuntomuuttujan eteen NQ_SESSION ja piste.
  • Laita NQ_SESSION lainausmerkkeihin.
  • Laita sekä NQ_SESSION-osio että istuntomuuttujan nimi sulkeisiin.

Esimerkki:

"Market"."Region"=VALUEOF("NQ_SESSION"."SalesRegion")

Esityksen muuttujat

Seuraavissa ohjeissa kerrotaan, miten lausekkeissa viitataan esityksen muuttujaan:

Kun viitataan esityksen muuttujaan, käytä tätä syntaksia:

@{muuttujan_nimi}{oletusarvo}

jossa muuttujan_nimi on esityksen muuttujan nimi ja oletusarvo (valinnainen) on vakion tai muuttujan viittaus, joka ilmaisee arvon, jota käytetään, jos muuttujan_nimi-määrityksellä viitattua muuttujaa ei täytetä.

Jos haluat muuttaa muuttujan tyypin merkkijonoksi tai sisällyttää useita muuttujia, laita koko muuttujan ympärille heittomerkit, esimerkiksi seuraavasti:

'@{käyttäjä.näyttöNimi}'

Jos @-merkin jälkeen ei tule {-merkkiä, sitä käsitellään @-merkkinä. Kun käytetään esitysmuuttujaa, jolla voi olla useita arvoja, syntaksi vaihtelee saraketyypin mukaan.

Käytä seuraavaa SQL-syntaksia määritetylle saraketyypille, jotta luot sallittuja SQL-lausekkeita:

  • Teksti: (@{muuttujan_nimi}['@']{'oletusarvo'})

  • Numero: (@{muuttujan_nimi}{oletusarvo})

  • Päivämäärä ja aika: (@{muuttujan_nimi}{timestamp 'oletusarvo'})

  • Päivämäärä (vain päivämäärä): (@{muuttujan_nimi}{date 'oletusarvo'})

  • Aika (vain aika): (@{muuttujan_nimi}{time 'oletusarvo'})

Esimerkki:

'@{käyttäjä.näyttöNimi}'

Semanttisen mallin (tietovaraston) muuttujat

Seuraavissa ohjeissa kerrotaan, miten lausekkeissa viitataan semanttisen mallin (tietovaraston) muuttujiin.

  • Lisää muuttuja VALUEOF-funktion argumenttina.
  • Laita muuttujan nimi lainausmerkkeihin.
  • Viittaa staattiseen semanttisen mallin (tietovaraston) muuttujaan nimellä.
  • Viittaa dynaamiseen semanttisen mallin (tietovaraston) muuttujaan sen täydellisellä nimellä.

Esimerkki:

CASE WHEN "Tunti" >= VALUEOF("tärkein_alku") AND "Tunti" < VALUEOF("tärkein_loppu") THEN 'Tärkein aika' WHEN ... ELSE...END