Sintaxa pt. referirea variabilelor

Puteţi referi variabile în analize şi dashboarduri.

Modul în care referiţi o variabilă depinde de sarcina pe care o efectuaţi. Pentru sarcinile în care vi se prezintă câmpuri într-un dialog, trebuie să specificaţi doar tipul şi numele variabilei (nu sintaxa integrală), de exemplu la referirea unei variabile într-o condiţie de filtrare.

Pentru alte sarcini, precum referirea unei variabile într-o vizualizare de regiune, specificaţi sintaxa variabilei. Sintaxa pe care o utilizaţi depinde de tipul de variabilă, aşa cum este descris în următorul tabel.

Tip Sintaxă Exemplu

Sesiune

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

unde variablename este numele variabilei de sesiune, de exemplu DISPLAYNAME.

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

Modelul semantic (repository)

@{biServer.variables.variablename}

sau

@{biServer.variables['variablename']}

unde variablename este numele variabilei, de exemplu, prime_begin

@{biServer.variables.prime_begin}

sau

@{biServer.variables['prime_begin']}

Prezentare sau cerere

@{variables.variablename}[format]{defaultvalue}

sau

@{scope.variables['variablename']}

unde:

variablename este numele variabilei prezentării sau cererii, de exemplu MyFavoriteRegion.

(opţional) format este o mască de formatare, dependentă de tipul de date al variabilei, de exemplu #,##0, MM/DD/YY hh:mm:ss. (Reţineţi că formatul nu este aplicat valorii prestabilite.)

(opţional) defaultvalue este o referinţă de variabilă constantă sau variabilă, care indică o valoare de utilizat dacă variabila referită de variablename nu este populată.

scope identifică calificatorii pt. variabilă. Trebuie să specificaţi domeniul când o variabilă este utilizată la mai multe niveluri (analize, pagini de dashboard şi dashboarduri) şi doriţi să accesaţi o anumită valoare. (Dacă nu specificaţi domeniul, ordinea precedenţei este analize, pagini de dashboard şi dashboarduri.)

Când utilizaţi un prompt de dashboard cu o variabilă de prezentare care poate avea mai multe valori, sintaxa diferă în funcţie de tipul de coloană. Mai multe valori sunt formatate în valori separate prin virgulă şi, prin urmare, orice clauză de formatare este aplicată fiecărei valori înainte de reunirea cu virgulă.

@{variables.MyFavoriteRegion}{EASTERN REGION}

sau

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

sau

@{dashboard.variables['MyFavoriteRegion']}

sau

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

sau

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

sau

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

Globală

@{global.variables.variablename}

unde variablename este numele variabilei globale, de exemplu gv_region. La referirea unei variabile globale, trebuie să utilizaţi numele calificat complet, conform indicaţiei din exemplu.

Convenţia de denumire pentru variabilele globale trebuie să respecte specificaţiile limbajului de scripting EMCA pentru JavaScript. Numele nu trebuie să depăşească 200 de caractere şi să nu conţină spaţii înglobate, cuvinte rezervate şi caractere speciale. Dacă nu sunteţi familiarizat cu cerinţele limbajului JavaScripting, consultaţi o referinţă terţă

@{global.variables.gv_date_n_time}

De asemenea, puteţi referi variabile în expresii. Indicaţiile pt. referirea variabilelor în expresii sunt descrise în următoarele subiecte:

Variabile de sesiune

Puteţi utiliza următoarele îndrumări pt. a face referire la variabilele de sesiune în expresii.

  • Includeţi variabila de sesiune ca argument al funcţiei VALUEOF.
  • Includeţi numele variabilei între ghilimele duble.
  • Precedaţi variabila de sesiune cu NQ_SESSION şi un punct.
  • Includeţi NQ_SESSION între ghilimele duble.
  • Includeţi porţiunea NQ_SESSION şi numele variabilei de sesiune între paranteze.

De exemplu:

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

Variabile de prezentare

Puteţi utiliza următoarele îndrumări pt. a face referire la variabilele de prezentare în expresii.

La referirea unei variabile de prezentare, utilizaţi această sintaxă:

@{variablename}{defaultvalue}

unde variablename este numele variabilei de prezentare şi defaultvalue (opţional) este o referinţă de variabilă constantă sau variabilă, care indică o valoare de utilizat dacă variabila referită de variablename nu este populată.

Pentru a converti (type-cast) variabila într-un şir sau a include variabile multiple, includeţi întreaga variabilă între ghilimele simple, de exemplu:

'@{user.displayName}'

Dacă semnul @ nu este urmat de {, este tratat ca un semn @. Când utilizaţi o variabilă de prezentare care poate avea mai multe valori, sintaxa diferă în funcţie de tipul de coloană.

Utilizaţi următoarea sintaxă în SQL pt. tipul de coloană specificat pt. a genera instrucţiuni SQL valide:

  • Text - (@{variablename}['@']{'defaultvalue'})

  • Numerică - (@{variablename}{defaultvalue})

  • Dată/Oră - (@{variablename}{timestamp 'defaultvalue'})

  • Dată (doar data) - (@{variablename}{date 'defaultvalue'})

  • Oră (doar ora) - (@{variablename}{time 'defaultvalue'})

De exemplu:

'@{user.displayName}'

Variabile pentru modelul semantic (repository)

Puteţi utiliza următoarele îndrumări pentru a face referire la variabilele modelului semantic (repository-ului) în expresii.

  • Includeţi variabila ca argument al funcţiei VALUEOF.
  • Includeţi numele variabilei între ghilimele duble.
  • Referiţi o variabilă statică din modelul semantic (repository), după nume.
  • Referiţi o variabilă dinamică din modelul semantic (repository), după numele său calificat integral.

De exemplu:

CASE WHEN "Oră" >= VALUEOF("audienţă_început") AND "Oră" < VALUEOF("audienţă_sfârşit") THEN 'Oră maximă audienţă' WHEN ... ELSE...END