IBM Cognos Framework Manager Version 10.2.0 - Guide d'utilisation

Utilisation de paramètres avec des sujets de requête de
source de données relationnelles
Les objets de modèle ne reflètent pas les modifications apportées aux objets de
source de données sur lesquels ils sont basés. Par conséquent, lorsque vous ajoutez
un paramètre à un sujet de requête de source de données, il peut être judicieux de
créer un objet de modèle faisant référence au paramètre. Dans ce cas, vous devez
affecter un alias d'objet paramétré dans le sujet de requête de source de données.
Cela garantit que les sujets de requête de modèle, les filtres ou les calculs qui font
référence à l'objet renvoient les résultats corrects lorsque la valeur du paramètre est
modifiée.
Par exemple, le code SQL suivant définit le sujet de requête de source de données
qui contient un paramètre de session appelé runLocale. La valeur du paramètre
runLocale indique la colonne extraite par la requête. L'alias se comporte comme un
raccourci pour qu'IBM Cognos Framework Manager extraie la valeur à laquelle
l'alias est affecté lorsqu'un objet de modèle fait référence à CountryNameAlias.
Select
#$ColumnMap{$runLocale}# as
CountryNameAlias
From
[GoSales].Country
Création d'invites avec des macros de requête
Les macros sont des fragments de code que vous pouvez insérer à n'importe quel
endroit de l'instruction Select qui définit un sujet de requête. Vous pouvez inclure
des références à des paramètres de session, des tables de mappage de paramètres
et des entrées de table de mappage de paramètres. Les valeurs des paramètres sont
définies lorsque vous exécutez la requête.
Par exemple, vous pouvez utiliser le paramètre de session de langue pour
n'afficher que les données qui correspondent au paramètre linguistique de
l'utilisateur en cours.
Les macros peuvent être utilisées de différentes manières :
v Elles peuvent être insérées dans le code SQL.
Exemple : Select * from Country where Country.Name = #$myMap{$runLocale}#
v Elles peuvent fournir un argument à un sujet de requête de procédure stockée.
Si une valeur n'est pas codée en dur pour l'argument, le sujet de requête de
procédure stockée peut être utilisé pour renvoyer des données différentes.
v Elles peuvent être insérées dans des expressions, telles que des calculs et des
filtres.
Exemple de filtre : [gosales].[Sales staff].[Staff name] =
#$UserLookUpMap{$UserId}#
v Elles peuvent être utilisées pour exécuter dynamiquement les propriétés d'un
sujet de requête de source de données.
Cela permet aux différents utilisateurs d'entrer des informations de connexion
différentes et d'accéder ainsi à des sources de données différentes. Les propriétés
pouvant contenir des macros sont les suivantes : Source de données de Content
Manager, Catalogue, Cube et Schéma.
Voici un exemple utilisant la propriété Source de données de Content Manager
: #$DataSourceMap{$UserId}#
v Elles peuvent être utilisées sous la forme d'un assistant de paramètres.
168 IBM Cognos Framework Manager Version 10.2.0 - Guide d'utilisation