Vous pouvez référencer des variables dans les analyses et les tableaux de bord.
La façon de référencer une variable dépend de la tâche que vous êtes en train d'accomplir. Pour les tâches qui présentent des champs dans une boîte de dialogue, vous devez spécifier seulement le type et le nom de la variable (et non la syntaxe complète). C'est le cas, par exemple, pour référencer une variable dans une définition de filtre.
Pour les autres tâches, comme référencer une variable dans une vue de titre, vous devez spécifier la syntaxe de la variable. La syntaxe utilisée dépend du type de variable, comme décrit dans le tableau suivant.
| Type | Syntaxe | Exemple |
|---|---|---|
|
Session |
@{biServer.variables['NQ_SESSION.nondelavariable']} où nomdelavariable est le nom de la variable de session, par exemple DISPLAYNAME. |
@{biServer.variables['NQ_SESSION.SalesRegion']} |
|
Modèle sémantique (référentiel) |
@{biServer.variables.nomdelavariable} ou @{biServer.variables['nomdelavariable']} où nomdelavariable est le nom de la variable, par exemple prime_begin |
@{biServer.variables.debut_prime} ou @{biServer.variables['debut_prime']} |
|
Présentation ou demande |
@{variables.nomdelavariable}[format]{valeurpardefaut} ou @{étendue.variables['nomdelavariable']} où : nomdelavariable est le nom de la variable de présentation ou de la demande, par exemple MaRegionPreferee. (Facultatif) format est un masque pour le format qui dépend du type de données de la variable, par exemple #,##0, MM/DD/YY hh:mm:ss. (Il est à noter que le format n'est pas appliqué à la valeur par défaut.) (Facultatif) defaultvalue est une constante ou une variable de référence indiquant une valeur à utiliser si la variable référencée par variablename n'a pas de valeur. etendue identifie les qualificatifs pour la variable. Vous devez spécifier l'étendue lorsqu'une variable est utilisée à plusieurs niveaux (analyses, pages de tableau de bord et tableaux de bord) et que vous souhaitez accéder à une valeur particulière. (Si vous ne spécifiez pas l'étendue, l'ordre de priorité sera le suivant : analyses, pages de tableau de bord et tableaux de bord.) Lorsque vous utilisez une invite de tableau de bord avec une variable de présentation qui a plusieurs valeurs, la syntaxe diffère selon le type de colonne. Les valeurs multiples sont formatées avec le format séparé par la virgule. Ainsi, toutes les clauses de format sont appliquées à chaque valeur avant une jointure par une colonne. |
@{variables.MaRegionPreferee}{REGION EST} ou @{dashboard.MyFavoriteRegion}{EASTERN REGION} ou @{dashboard.variables['MaRegionPreferee']} ou (@{myNumVar}[#,##0]{1000}) ou (@{variables.MonPropreHorodatage}[YY-MM-DD hh:mm:ss]{) ou (@{maVariableTexte}{A, B, C}) |
|
Variable globale |
@{global.variables.nomdelavariable} où nomdelavariable est le nom de la variable globale, par exemple vg_région. Lors de la référence à une variable globale, vous devez utiliser un nom entièrement qualifié, comme dans l'exemple. La convention d'attribution de nom pour les variables globales doit être conforme au langage de script ECMA pour JavaScript. Le nom ne doit pas dépasser 200 caractères ni contenir des espaces, des mots réservés ou des caractères spéciaux. Si vous ne connaissez pas les exigences du langage de script JavaScript, consultez une référence de tierce partie. |
@{global.variables.vg_date_et_heure} |
Vous pouvez aussi référencer des variables dans des expressions. Les instructions pour référencer des variables dans des expressions sont décrites dans les rubriques suivantes :
Vous pouvez utiliser les instructions suivantes pour référencer des variables de session dans des expressions.
Par exemple :
"Market"."Region"=VALUEOF("NQ_SESSION"."SalesRegion")
Vous pouvez utiliser les instructions suivantes pour référencer des variables de présentation dans des expressions.
Lorsque vous référencez une variable de présentation, utilisez la syntaxe suivante :
@{nomdelavariable}{valeurpardefaut}
où variablename est le nom de la variable de présentation et defaultvalue (facultatif) est une constante ou une référence de variable indiquant une valeur à utiliser si la variable référencée par variablename n'est pas alimentée.
Pour convertir le type de la variable en une chaîne de caractères ou inclure plusieurs variables, encadrez la variable entière au moyen de guillemets simples, par exemple :
'@{user.displayName}'
Si le signe @ n'est pas suivi par {, il est traité comme un signe @. Lorsque vous utilisez une variable de présentation qui a plusieurs valeurs, la syntaxe diffère selon le type de colonne.
Utilisez la syntaxe suivante dans le code SQL pour le type de colonne spécifié afin de générer des énoncés SQL valides :
Texte — (@{nomdelavariable}['@']{'valeurpardefaut'})
Numérique — (@{nomdelavariable}{valeurpardefaut})
Date-heure — (@{nomdelavariable}{timestamp 'valeurpardefaut'})
Date (seulement la date) — (@{nomdelavariable}{date 'valeurpardefaut'})
Heure (seulement l'heure) — (@{nomdelavariable}{time 'valeurpardefaut'})
Par exemple :
'@{user.displayName}'
Vous pouvez utiliser les instructions suivantes pour référencer des variables de modèle sémantique (référentiel) dans des expressions.
Par exemple :
CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END