Date de publication : 12-Mar-2013 03:32:15
Variables de session #
Une variable de session est initialisée au moment de la connexion pour chaque utilisateur. Lorsqu'un utilisateur commence une session, le serveur BI crée une nouvelle instance d'une variable de session et l'initialise.
Il y a autant d'instances d'une variable de session qu'il y a de sessions actives sur le serveur BI. Chaque instance d'une variable de session peut être initialisée à une valeur différente.
Il existe deux types de variables de session :
- Système - Une variable de session que BI Server et BI Presentation Services utilisent à des fins spécifiques.
Les variables de session système ont des noms réservés qui ne peuvent pas être utilisés pour d'autres types de variables (telles que les variables de référentiel statiques ou dynamiques et les variables de session non système).
- Hors système - Variable système créée et nommée par l'administrateur. Par exemple, l'administrateur peut créer une variable non système SalesRegion qui initialise le nom de la région de vente d'un utilisateur.
L'administrateur crée des variables de session hors système à l'aide de l'outil d'administration Oracle BI.
Variables du référentiel #
Une variable référentielle est une variable qui a une seule valeur à un moment donné.
Il existe deux types de variables de référentiel :
- Statique - Variables du référentiel dont la valeur persiste et ne change pas jusqu'à ce que l'administrateur décide de les modifier.
- Dynamique - Variables du référentiel dont les valeurs sont rafraîchies par les données renvoyées par les requêtes.
L'administrateur crée des variables de référentiel à l'aide de l'outil d'administration Oracle BI.
Variables de présentation #
Une variable de présentation est une variable que vous pouvez créer dans le cadre du processus de création de l'un des types d'invites de tableau de bord suivants :
- Invite à la colonne - Une variable de présentation créée dans le cadre d'une invite de colonne est associée à une colonne et les valeurs qu'elle peut prendre proviennent des valeurs de la colonne.
Pour créer une variable de présentation dans le cadre d'une invite de colonne, dans la "boîte de dialogue Nouvelle invite" (ou boîte de dialogue Éditer l'invite), vous devez sélectionner Variable de présentation dans le Définir une variable puis saisissez un nom pour la variable dans le champ Nom de la variable champ.
- Invite variable - Une variable de présentation créée dans le cadre d'une invite de variables n'est associée à aucune colonne et l'administrateur définit les valeurs qu'elle peut prendre.
Pour créer une variable de présentation dans le cadre d'une invite variable, dans la "boîte de dialogue Nouvelle invite" (ou boîte de dialogue Éditer l'invite), sélectionnez Variable de présentation dans le Invitation à puis saisissez le nom de la variable dans le champ Nom de la variable champ.
La valeur d'une variable de présentation est alimentée par l'invite de la colonne ou de la variable avec laquelle elle a été créée. En d'autres termes, chaque fois qu'un utilisateur sélectionne une valeur dans l'invite de la colonne ou de la variable, la valeur de la variable de présentation est fixée à la valeur sélectionnée par l'utilisateur.
Variables de la demande #
Une variable de requête permet de remplacer la valeur d'une variable de session, mais uniquement pour la durée d'une requête de base de données initiée à partir d'une invite de colonne. Une variable de requête peut être créée dans le cadre du processus de création d'une invite de colonne.
Une variable de requête créée dans le cadre d'une invite de colonne est associée à une colonne et les valeurs qu'elle peut prendre proviennent des valeurs de la colonne.
Pour créer une variable de requête dans le cadre d'une invite de colonne, dans la "boîte de dialogue Nouvelle invite" (ou la boîte de dialogue Éditer l'invite), sélectionnez Variable de demande en Définir une variable puis saisissez le nom de la variable de session à remplacer dans le champ Nom de la variable champ.
La valeur d'une variable de requête est alimentée par l'invite de la colonne avec laquelle elle a été créée. En d'autres termes, chaque fois qu'un utilisateur sélectionne une valeur dans l'invite de la colonne, la valeur de la variable de requête est fixée à la valeur sélectionnée par l'utilisateur. La valeur n'est toutefois effective qu'à partir du moment où l'utilisateur appuie sur la touche Allez jusqu'à ce que les résultats de l'analyse soient affichés dans le tableau de bord.
Où puis-je faire référence à des variables ? #
Les variables peuvent être référencées dans les domaines suivants (mais tous les types de variables ne peuvent pas être référencés dans chaque domaine) :
- Titre des vues.
- Vues narratives.
- Vues statiques du texte.
- Filtres.
- Formules de colonne.
- Conditions de mise en forme conditionnelle.
- Titres des tableaux et des colonnes dans les analyses.
- Demandes directes de base de données.
- Invites du tableau de bord et invites en ligne.
- En-têtes et pieds de page pour la sortie PDF.
- Lier des objets ou des images dans un tableau de bord.
- Objets textuels dans un tableau de bord.
- Graphiques pour spécifier le formatage conditionnel des données du graphique.
- Seuils de jauge.
- Limites de la jauge.
- Agents.
- Actions permettant de spécifier des paramètres.
- Conditions pour spécifier les paramètres.
- Étapes de sélection.
- KPI pour définir les seuils.
- Indicateurs de performance clés inclus dans une liste de surveillance des indicateurs de performance clés.
- Champs d'URL dans les dialogues.
Syntaxe de référencement des variables
Les variables peuvent être utilisées dans les analyses, les tableaux de bord, les indicateurs clés de performance et les agents. La manière dont vous faites référence à une variable dépend de la tâche que vous effectuez.
Pour les tâches où des champs vous sont présentés dans une boîte de dialogue, vous ne devez spécifier que le type et le nom de la variable (et non la syntaxe complète), par exemple en faisant référence à une variable dans la définition d'un filtre.
Pour d'autres tâches, telles que le référencement d'une variable dans une vue de titre, vous devez spécifier la syntaxe de la variable. La syntaxe que vous utilisez dépend du type de variable, comme décrit dans le tableau 1.
Note :
Dans la syntaxe, si le signe "at" (@) n'est pas suivi d'une accolade ({), il est traité comme un signe "at".
Tableau 1 Syntaxe de référencement des variables
| Type de variable | Syntaxe | Exemple |
| Session | @{biServer.variables['NQ_SESSION. nom de la variante ']} où nom de la variante est le nom de la variable de session, par exemple DISPLAYNAME. | @{biServer.variables['NQ_SESSION.USER']} |
| Référentiel | @{biServer.variables. nom de la variante } ou @{biServer.variables[''. nom de la variante ']} où nom de la variante est le nom de la variable du référentiel, par exemple prime_begin. | @{biServer.variables.prime_begin} ou @{biServer.variables['prime_begin']} |
| Présentation ou demande | @{variables. nom de la variante }[ format ]{ valeur par défaut } ou @{ champ d'application .variables[']. nom de la variante ']} where : nom de la variante est le nom de la présentation ou de la variable de requête, par exemple, MyFavoriteRegion. (facultatif) format est un masque de format dépendant du type de données de la variable, par exemple #,##0, MM/JJ/AA hh:mm:ss. (Notez que le format n'est pas appliqué à la valeur par défaut.) (facultatif) valeur par défaut est une référence à une constante ou à une variable indiquant une valeur à utiliser si la variable référencée par nom de la variante n'est pas renseigné. champ d'application identifie les qualificateurs de la variable. Vous devez spécifier le champ d'application 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 spécifique (si vous ne spécifiez pas le champ d'application, l'ordre de priorité est analyses, pages de tableau de bord et tableaux de bord). (Si vous ne précisez pas le champ d'application, l'ordre de priorité est le suivant : analyses, pages de tableau de bord et tableaux de bord). | @{variables.MyFavoriteRegion}{EASTERN REGION} ou @{dashboard.variables['MyFavoriteRegion']} |
Vous pouvez également faire référence à des variables dans des expressions. Les règles de référencement des variables dans les expressions sont décrites dans le tableau 2.
Tableau 2 Lignes directrices pour le référencement des variables dans les expressions
| Type de variable | Lignes directrices | Exemple |
| Session | Incluez la variable de session comme argument de la fonction VALUEOF. Mettez le nom de la variable entre guillemets. Faites précéder la variable de session de NQ_SESSION et d'un point. Mettez la partie NQ_SESSION et le nom de la variable de session entre parenthèses. | "Market". "Region"=VALUEOF(NQ_SESSION. "SalesRegion") |
| Référentiel | Inclure la variable du référentiel comme argument de la fonction VALUEOF. Mettez le nom de la variable entre guillemets. Faites référence à une variable de référentiel statique par son nom. Faites référence à une variable de référentiel dynamique par son nom pleinement qualifié. Si vous utilisez une variable de référentiel dynamique, les noms du bloc d'initialisation et de la variable de référentiel doivent être placés entre guillemets doubles ("), séparés par un point et contenus dans des parenthèses. Par exemple, pour utiliser la valeur d'une variable de référentiel dynamique nommée REGION contenue dans un bloc d'initialisation nommé Région Sécurité, utilisez la syntaxe suivante : VALUEOF("Region Security". "REGION") | CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour"< VALUEOF("prime_end") THEN "Prime Time" WHEN ... ELSE...END |
| Présentation | Utilisez la syntaxe @{variablename}{defaultvalue} 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 renseignée. Pour convertir la variable en chaîne de caractères, mettez toute la syntaxe entre guillemets simples, par exemple : "@{nom.utilisateur} Note : Si le signe @ n'est pas suivi d'un {, il est traité comme un signe @. | "Market". "Region"=@{MyFavoriteRegion}{EASTERN REGION} |
