U kunt verwijzen naar variabelen in analysen en dashboards.
Hoe u naar een variabele verwijst, hangt af van de taak die u uitvoert. Voor taken waarbij u werkt met velden in een dialoogvenster, hoeft u alleen het type en de naam van de variabele op te geven (niet de volledige syntaxis). Dit kan bijvoorbeeld voorkomen als u verwijst naar een variabele in een filterdefinitie.
Voor andere taken, zoals verwijzen naar een variabele in een titelweergave, geeft u de syntaxis voor de variabele op. Welke syntaxis u gebruikt, hangt af van het type variabele zoals beschreven in de onderstaande tabel.
| Type | Syntaxis | Voorbeeld |
|---|---|---|
|
Sessie |
@{biServer.variables['NQ_SESSION.variabelenaam']} waarbij variabelenaam de naam is van de sessievariabele, bijvoorbeeld DISPLAYNAME. |
@{biServer.variables['NQ_SESSION.SalesRegion']} |
|
Semantisch model (repository) |
@{biServer.variables.variabelenaam} of @{biServer.variables['variabelenaam']} waarbij variabelenaam de naam is van de variabele, bijvoorbeeld prime_begin |
@{biServer.variables.prime_begin} of @{biServer.variables['prime_begin']} |
|
Presentatie of aanvraag |
@{variables.variabelenaam}[opmaak]{standaardwaarde} of @{scope.variables['variabelenaam']} waarbij: variabelenaam de naam is van de presentatie- of aanvraagvariabele, zoals 'MyFavoriteRegion'. (optioneel) opmaak een opmaakmasker is dat afhankelijk is van het gegevenstype van de variabele, bijvoorbeeld #,##0, MM/DD/JJ uu:mm:ss. (Zoals u ziet wordt de opmaak niet toegepast op de standaardwaarde.) (optioneel) standaardwaarde een constante of variabele verwijzing is die een waarde aangeeft die moet worden gebruikt als de variabele waarnaar variabelenaam verwijst, geen waarde bevat. bereik de kwalificaties voor de variabele aangeeft. U moet een waarde voor bereik opgeven wanneer een variabele wordt gebruikt op meerdere niveaus (analysen, dashboardpagina's en dashboards) en u een specifieke waarde wilt gebruiken. (Als u geen bereik opgeeft, is de volgorde van prioriteit: analysen, dashboardpagina's, dashboards.) Wanneer een dashboardprompt wordt gebruikt met een presentatievariabele die meerdere waarden kan bevatten, varieert de syntaxis afhankelijk van het kolomtype. Meerdere waarden worden opgemaakt in door komma's gescheiden waarden. Daarom wordt elke opmaakclausule toegepast op alle waarden voordat deze door komma's worden samengevoegd. |
@{variables.MyFavoriteRegion}{EASTERN REGION} of @{dashboard.MyFavoriteRegion}{EASTERN REGION} of @{dashboard.variables['MyFavoriteRegion']} of (@{myNumVar}[#,##0]{1000}) of (@{variables.MyOwnTimestamp}[JJ-MM-DD uu:mm:ss]{) of (@{myTextVar}{A, B, C}) |
|
Algemeen |
@{global.variables.variabelenaam} waarbij variabelenaam de naam is van de algemene variabele, bijvoorbeeld gv_region. Wanneer u naar een algemene variabele verwijst, moet u de volledig gekwalificeerde naam gebruiken zoals in het voorbeeld is aangegeven. De naamgevingsconventie voor algemene variabelen moet overeenkomen met de ECMAScript-taalspecificaties voor JavaScript. De naam mag het aantal tekens van 200 niet overschrijden en mag geen ingesloten spaties, gereserveerde worden en speciale tekens bevatten. Als u niet bekend bent met taalvereisten voor JavaScript, raadpleeg dan een naslagwerk van derden. |
@{global.variables.gv_date_n_time} |
U kunt ook verwijzen naar variabelen in uitdrukkingen. De richtlijnen voor verwijzingen naar variabelen in uitdrukkingen worden beschreven in de volgende onderwerpen:
U kunt de volgende richtlijnen gebruiken voor verwijzingen naar sessievariabelen in uitdrukkingen:
Bijvoorbeeld:
"Markt"."Regio"=VALUEOF("NQ_SESSION"."SalesRegion")
U kunt de volgende richtlijnen gebruiken voor verwijzingen naar presentatievariabelen in uitdrukkingen.
Gebruik de volgende syntaxis om te verwijzen naar een presentatievariabele:
@{variabelenaam}{standaardwaarde}
waarbij variabelenaamde naam is van de presentatievariabele en standaardwaarde (optioneel) een constante of variabele verwijzing is die een waarde aangeeft die moet worden gebruikt als de variabele waarnaar variabelenaam verwijst, geen waarde bevat.
Als u de variabele naar een string wilt converteren, of als u meerdere variabelen wilt opnemen, sluit u de volledige variabele in tussen enkele aanhalingstekens, bijvoorbeeld:
'@{user.displayName}'
Als het @-teken niet wordt gevolgd door een '{', wordt het teken behandeld als een @-teken. Als u een presentatievariabele gebruikt die meerdere waarden kan hebben, varieert de syntaxis afhankelijk van het kolomtype.
Gebruik voor het opgegeven kolomtype de volgende syntaxis in SQL om geldige SQL-statements te genereren:
Tekst: (@{variabelenaam}['@']{'standaardwaarde'})
Numeriek: (@{variabelenaam}{standaardwaarde})
Datum/tijd: (@{variabelenaam}{timestamp 'standaardwaarde'})
Datum (alleen de datum): (@{variabelenaam}{date 'standaardwaarde'})
Tijd (alleen de tijd): (@{variabelenaam}{time 'standaardwaarde'})
Bijvoorbeeld:
'@{user.displayName}'
U kunt de volgende richtlijnen gebruiken om naar variabelen in voor semantische modellen (repository) in uitdrukkingen te verwijzen.
Bijvoorbeeld:
CASE WHEN "Uur" >= VALUEOF("prime_begin") AND "Uur" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END