IBM Cognos Analytics Version 11.0
Guide de gestion des utilisateurs
IBM
©
Informations sur les produits
LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE
CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE.
Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmes
disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés.
Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire
commercial.
Vous pouvez également consulter les serveurs Internet suivants : v http://www.fr.ibm.com (serveur IBM en France)
v http://www.ibm.com/ca/fr (serveur IBM au Canada) v http://www.ibm.com (serveur IBM aux Etats-Unis)
Le présent document s'applique à IBM Cognos Analytics version 11.0.0 et peut aussi s'appliquer aux éditions ultérieures.
Copyright
Eléments sous licence - Propriété d'IBM
© Copyright IBM Corp. 2015, 2018.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
IBM, le logo IBM et ibm.com sont des marques d'International Business Machines Corp., dans de nombreux pays.
D'autres noms de produit et de service peuvent être des marques d'IBM ou d'autres sociétés. La liste actualisée de toutes les marques d' IBM est disponible sur la page Web «Copyright and trademark information», à l'adresse suivante : www.ibm.com/legal/copytrade.shtml.
Les termes ci-dessous sont des marques d'autres sociétés :
v Adobe, le logo Adobe, PostScript et le logo PostScript sont des marques d'Adobe Systems Incorporated aux Etats-Unis et/ou dans certains autres pays.
v Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays.
v Intel, le logo Intel, Intel Inside, le logo Intel Inside, Intel Centrino, le logo Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, et Pentium sont des marques d'Intel Corporation ou de ses filiales aux Etats-Unis et dans certains autres pays.
v Linux est une marque de Linus Torvalds aux Etats-Unis et/ou dans certains autres pays.
Table des matières
Avis aux lecteurs canadiens . . . v
Chapitre 1. Gestion des comptes . . . 1
L'espace-noms Cognos . . . 1
Création et gestion des groupes et des rôles . . . 4
Création et gestion des utilisateurs . . . 6
Personnalisation des rôles . . . 6
Fournisseurs d'authentification . . . 8
Gestion des espaces-noms OpenID Connect . . . 9
Recherche d'utilisateurs, de groupes et de rôles . . . 12
Chapitre 2. Gestion du contenu . . . 13
Chapitre 3. Connexions au serveur de données . . . 15
Création d'une connexion au serveur de données . . . 15
Paramètres de connexion Cognos . . . 17
Préchargement des métadonnées depuis une connexion de serveur de données. . . 21
Informations de référence et traitement des incidents . . . 21
Pilotes JDBC de Cloudera Impala . . . 21
Requêtes bloquées dans le moteur Pivotal HDB . . . 22
Serveurs de données Denodo 5.5 et 6.0 . . . 22
Sources de données qui ne sont plus prises en charge dans Cognos Analytics . . . 22
Mises à jour par version . . . 25
Cognos Analytics 11.0.13 - Fonctions nouvelles et modifiées . . . 25
Cognos Analytics 11.0.9 - Fonctions nouvelles et modifiées . . . 25
Cognos Analytics 11.0.8 - nouvelles fonctions . . . 27
Cognos Analytics 11.0.7 - fonctions nouvelles et modifiées . . . 28
Chapitre 4. Gestion des paramètres système . . . 29
Gestion des téléchargements de fichiers de données . . . 29
Mise en oeuvre du dispositif de sécurité HSTS (HTTP Strict Transport Security) . . . 29
Types et fichiers de journalisation . . . 29
Journalisation des diagnostics . . . 30
Configuration de la journalisation de session . . . 32
Activation ou désactivation des composants existants . . . 33
Chapitre 5. Gestion des activités programmées . . . 35
Gestion des activités en cours . . . 35
Gestion des activités passées. . . 36
Gestion des activités à venir pour un jour précis . . . 37
Gestion des activités programmées . . . 37
Gestion de la priorité d'exécution des entrées . . . 38
Chapitre 6. Gestion des licences . . . 41
Rôles de licence . . . 42
Droits par défaut basés sur les licences . . . 42
Affectation de droits en fonction du rôle de licence . . . 49
Scénario de mise à niveau : Si vos rôles personnalisés ont les mêmes noms que les nouveaux rôles de licence Cognos . . . 50
Chapitre 7. Administration des locataires . . . 51
Règles de confinement pour multilocation . . . 51
Création de locataires . . . 51
Affectation d'ID locataire à un contenu existant . . . 52
Définition d'un ID locataire pour un objet public . . . 53
Administration déléguée des locataires . . . 53
Configuration du rôle Administrateurs de locataires . . . 54
Configuration de locataires virtuels pour l'activation du partage de contenu entre les locataires . . . 55
Personnalisation des locataires . . . 56
Configuration des paramètres régionaux des locataires . . . 57
Configuration des notifications des locataires . . . 58
Arrêt des sessions utilisateur actives des locataires . . . 58
Désactivation et activation des locataires. . . 59
Suppression de locataires . . . 59
Chapitre 8. Personnalisation de Cognos Analytics pour tous les rôles . . . 61
Exemples de personnalisation . . . 62
Création de thèmes . . . 62
Exemples de thème . . . 64
Création d'extensions . . . 65
Ajout d'un bouton ou d'un élément de menu . . . 66
Ajout d'un menu . . . 71
Retrait d'un élément d'interface utilisateur . . . 72
Ajout de formes de tableau de bord . . . 72
Création d'une palette d'images . . . 73
Ajout d'un widget de tableau de bord . . . 76
Exemples d'extension . . . 78
Création de vues . . . 80
Création d'une vue (autre qu'une vue de connexion). . . 82
Création d'une vue de connexion . . . 84
Création d'une vue de connexion avec invite de demande d'espace-noms. . . 87
Exemples de vue . . . 88
Gestion des thèmes, des extensions, des vues et des paramètres . . . 90
Exécution de Cognos Analytics avec les extensions et les vues personnalisées désactivées . . . 92
Description de spec.json. . . 92
Validation de schéma JSON . . . 95
Détermination de l'idd'un objet d'interface utilisateur . . . 99
Chapitre 9. Activation d'un environnement de production . . . 101
A propos de ce guide . . . 103
Index . . . 105
Avis aux lecteurs canadiens
Le présent document a été traduit en France. Voici les principales différences et particularités dont vous devez tenir compte.
Illustrations
Les illustrations sont fournies à titre d'exemple. Certaines peuvent contenir des données propres à la France.
Terminologie
La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-vous au tableau ci-dessous, au besoin.
IBM France IBM Canada
ingénieur commercial représentant
agence commerciale succursale
ingénieur technico-commercial informaticien
inspecteur technicien du matériel
Claviers
Les lettres sont disposées différemment : le clavier français est de type AZERTY, et le clavier français-canadien de type QWERTY.
OS/2 et Windows - Paramètres canadiens
Au Canada, on utilise :
v les pages de codes 850 (multilingue) et 863 (français-canadien), v le code pays 002,
v le code clavier CF.
Nomenclature
Les touches présentées dans le tableau d'équivalence suivant sont libellées
différemment selon qu'il s'agit du clavier de la France, du clavier du Canada ou du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de votre clavier.
Brevets
Il est possible qu'IBM détienne des brevets ou qu'elle ait déposé des demandes de brevets portant sur certains sujets abordés dans ce document. Le fait qu'IBM vous fournisse le présent document ne signifie pas qu'elle vous accorde un permis d'utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux permis d'utilisation au directeur général des relations commerciales d'IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7.
Assistance téléphonique
Si vous avez besoin d'assistance ou si vous voulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.
Chapitre 1. Gestion des comptes
Dans IBM®Cognos Analytics, vous pouvez gérer l'authentification des utilisateurs ainsi que l'accès au contenu et aux fonctions du produit.
L'administrateur qui configure votre application Cognos Analytics procède à la configuration initiale de la sécurité. Cette configuration inclut la configuration de fournisseurs d'authentification pour bénéficier de l'infrastructure de sécurité existante dans votre organisation. Chaque fournisseur d'authentification configuré pour être utilisé avec Cognos Analytics est un espace-noms ou un espace-noms externe.
En plus des espaces-noms qui représentent les fournisseurs d'authentification externes, IBM Cognos Analytics possède un espace-noms interne intégré appelé Cognos. Celui-ci simplifie le processus de gestion des droits d'accès et de déploiement de contenu.
Cognos Analytics peut également être configuré pour un accès anonyme, auquel cas les utilisateurs n'ont pas besoin de fournir un ID utilisateur et un mot de passe pour accéder à l'application. Pour plus d'informations sur l'activation de l'accès anonyme, reportez-vous au document IBM Cognos Analytics - Guide d'installation et de configuration.
Important : Votre environnement peut comporter un grand nombre d'utilisateurs.
Il est recommandé de regrouper ces derniers dans des dossiers, chaque dossier ne devant pas contenir plus de 1000 utilisateurs.
La fonction d'administration Utilisateurs, groupes et rôles est requise pour gérer les comptes. Pour plus d'informations, voir la section relatives aux fonctionnalités et aux fonctions sécurisées dans le document IBM Cognos Analytics - Guide d'administration et de sécurité.
L'espace-noms Cognos
L'espace-noms Cognos inclut des objets prédéfinis pour vous aider à configurer rapidement la sécurité initiale.
Vous utilisez les objets prédéfinis et les autres fonctionnalités de l'espace-noms Cognos pour une gestion régulière de la sécurité.
L'espace-noms Cognos peut contenir des utilisateurs, des groupes et des rôles. Un groupe représente une collection d'utilisateurs. Les membres de groupes peuvent être des utilisateurs ou d'autres groupes. Un rôle est une collection de
fonctionnalités qui identifient les tâches qu'un utilisateur peut effectuer. Les membres des rôles peuvent être des utilisateurs, des groupes et d'autres rôles. Un utilisateur peut appartenir à plusieurs groupes ou rôles. Si un utilisateur est membre de plusieurs groupes, les droits d'accès sont fusionnés.
Le diagramme ci-dessous représente la structure des groupes et des rôles dans l'espace-noms Cognos.
Vous pouvez créer des groupes et des rôles dans l'espace-noms Cognos. La possibilité de créer des utilisateurs dans l'espace-noms Cognos n'existe que si l'option Installation facile a été utilisée pour installer IBM Cognos Analytics.
Objets prédéfinis et intégrés dans l'espace-noms Cognos
Les droits d'accès initiaux sont appliqués à tous les objets prédéfinis. Vous pouvez les modifier depuis les propriétés d'un objet.
Anonyme
Cet utilisateur sert à la configuration initiale au cours de laquelle un accès anonyme est activé et les utilisateurs ne sont pas invités à fournir leurs données d'identification. Lorsque l'accès anonyme est désactivé dans Cognos Configuration, un utilisateur se connecte à l'aide de ses propres données d'identification.
Tous les utilisateurs authentifiés
Ce groupe représente les utilisateurs authentifiés par des fournisseurs d'authentification. La liste des membres de ce groupe est gérée par le produit ; il est impossible de l'afficher ou de la modifier.
Tous Ce groupe représente tous les utilisateurs authentifiés et le compte utilisateur Anonyme. La liste des membres de ce groupe est gérée par le produit ; il est impossible de l'afficher ou de la modifier. Vous pouvez utiliser le groupe Tous pour définir rapidement la sécurité par défaut. Par exemple, pour sécuriser un rapport, octroyez des droits de lecture, d'écriture ou d'exécution sur le rapport au groupe Tous. Une fois cette sécurité en place, vous pouvez permettre à d'autres utilisateurs, groupes ou rôles d'accéder au rapport, puis supprimer le groupe Tous de la règle de sécurité propre à ce rapport.
Utilisateurs d'analyses
Les membres de ce rôle possèdent les mêmes droits d'accès que ceux du rôle Utilisateurs. Ils peuvent également utiliser IBM Cognos Analysis Studio.
Administrateurs d'analyse
Les membres possèdent les mêmes droits d'accès que ceux du rôle Explorateurs d'analyse. Ils peuvent également accéder à :
v Gérer> Connexions au serveur de données
v Connexion de source de donnéesdans la console d'administration v IBM Cognos Software Development Kit.
Ce rôle n'est disponible qu'après une installation personnalisée.
Analytics Explorers
Figure 1. Structure des groupes et des rôles
Les membres possèdent les mêmes droits d'accès que ceux du rôle Analytics Users. Ils peuvent également accéder à Cognos Analysis For Microsoft Excel, Cognos Framework Manager, Cognos Cube
Designer/Dynamic Query Analyzer, Transformer et TM1 Writeback to bundled FLBI TM1 server.
Ce rôle n'est disponible qu'après une installation personnalisée.
Analytics Users
Les membres possèdent les mêmes droits d'accès que ceux du rôle Distribution d'informations. Ils peuvent créer de nouveaux rapports, tableaux de bord, histoires, travaux, connexions à un serveur de données ou modules de données. Ils peuvent exécuter des rapports, répondre aux invites et télécharger des fichiers. Ils peuvent également accéder à Cognos for Microsoft Office, Cognos Workspace, Cognos Insight, Cognos Event Studio, Cognos Query Studio et Cognos Analysis Studio.
Ce rôle n'est disponible qu'après une installation personnalisée.
Auteurs
Les membres de ce rôle possèdent les mêmes droits d'accès que ceux des rôles Utilisateurs de requêtes et Utilisateurs d'analyses. Ils peuvent utiliser Reporting, Query Studio et Analysis Studio et sauvegarder un contenu public, tel que des rapports et des sorties de rapport.
Utilisateurs
Les membres de ce rôle peuvent lire et exécuter un contenu public, tel que des rapports.
Administrateurs d'annuaires
Les membres de ce rôle peuvent administrer le contenu des espaces-noms.
Dans l'espace-noms Cognos, ils administrent des groupes, des comptes, des contacts, des listes de distribution, des sources de données et des
imprimantes.
Distribution d'informations
Les membres ont les mêmes droits d'accès que les Utilisateurs de requêtes et les Utilisateurs d'analyses. Ils peuvent utiliser Reporting, Query Studio et Analysis Studio et enregistrer du contenu public tel que des rapports et des versions de rapports.
Ce rôle n'est disponible qu'après une installation personnalisée.
Administrateurs de bibliothèque
Les membres de ce rôle peuvent accéder au contenu de l'onglet
Bibliothèque, l'importer et l'administrer dans IBM Cognos Administration.
Administrateurs de Mobile
Les membres de ce rôle peuvent administrer les applications IBM Cognos Mobile.
Utilisateurs nomades
Les membres de ce rôle peuvent accéder au contenu IBM Cognos, tel que des rapports, par l'intermédiaire des applications IBM Cognos Mobile.
Modélisateurs
Les membres de ce rôle ont accès aux fonctions de modélisation reposant sur le Web.
Administrateurs du portail
Les membres de ce rôle peuvent administrer les portlets Cognos et autres
portlets. Cette opération comprend la personnalisation de portlets, la définition de styles de portlet et la définition de droits d'accès pour les portlets.
Administrateurs de PowerPlay
Les membres de ce rôle peuvent administrer le contenu public, auquel ils ont un accès complet. Ils peuvent également administrer et utiliser IBM Cognos PowerPlay.
Utilisateurs de PowerPlay
Les membres de ce rôle possèdent les mêmes droits d'accès que ceux du rôle Utilisateurs. Ils peuvent également utiliser IBM Cognos PowerPlay.
Utilisateurs de requêtes
Les membres de ce rôle possèdent les mêmes droits d'accès que ceux du rôle Utilisateurs. Ils peuvent également utiliser IBM Cognos Query Studio.
Lecture
Les membres de ce rôle disposent d'un accès en lecture seule au logiciel IBM Cognos. Ils peuvent accéder à certaines portions du Content Store, visualiser des sorties de rapport sauvegardées dans le portail et utiliser certaines options de rapport, telles que l'accès au détail.
Administrateurs de rapports
Les membres de ce rôle peuvent administrer le contenu public, auquel ils ont un accès complet. Ils peuvent également utiliser IBM Cognos Analysis Reporting et IBM Cognos Query Studio.
Administrateurs de serveurs
Les membres de ce rôle peuvent administrer des serveurs, des répartiteurs et des travaux.
Administrateurs système
Les membres de ce rôle sont considérés comme des utilisateurs racine ou super utilisateurs. Ils peuvent accéder à tout objet et le modifier dans le Content Store, quelles que soient les règles de sécurité définies pour l'objet.
Seuls les membres du rôle Administrateurs système peuvent modifier la liste d'adhésion de ce rôle.
La configuration initiale de ce rôle inclut le groupe Tous. Vous devez modifier les paramètres de sécurité initiaux de ce rôle et supprimer le groupe Tous de ses membres. Si vous ne modifiez pas la configuration initiale, tous les utilisateurs disposent d'un accès non restreint au Content Store.
Administrateurs de locataires
Les membres de ce rôle peuvent effectuer des tâches d'administration des locataires. Ce rôle est utilisé dans un environnement IBM Cognos
multilocataire. Dans la configuration initiale, ce rôle ne contient ni membres, ni fonctionnalités. Seuls les administrateurs système peuvent ajouter des membres et affecter des droits d'accès et des fonctionnalités pour ce rôle.
Création et gestion des groupes et des rôles
Vous pouvez créer des groupes et des rôles dans l'espace-noms Cognos. Ces rôles ne dépendent pas des fournisseurs d'authentification et peuvent être gérés uniquement dans IBM Cognos Analytics.
Vous pouvez ajouter des utilisateurs, des groupes ou des rôles depuis plusieurs espaces-noms externes et depuis l'espace-noms Cognos en tant que membres des groupes et des rôles Cognos.
Avant de commencer
Si vous prévoyez d'ajouter des entrées depuis plusieurs espaces-noms en tant que membres des groupes et des rôles Cognos, connectez-vous à chaque espace-noms avant de commencer cette tâche.
Pourquoi et quand exécuter cette tâche
Lorsque vous supprimez un groupe ou un rôle Cognos, les droits d'accès des utilisateurs qui reposent sur ce groupe ou ce rôle ne sont plus actifs. Vous ne pouvez pas les restaurer en créant un groupe ou un rôle du même nom.
Vous avez besoin du droit d'administration Utilisateurs, groupes et rôles pour pouvoir gérer les comptes. Pour plus d'informations, voir la section relatives aux fonctionnalités et aux fonctions sécurisées dans le Guide d'administration et de sécurité d'IBM Cognos Analytics.
Procédure
1. Cliquez sur Gérer > Comptes.
2. Cliquez sur l'espace-noms Cognos pour l'ouvrir.
3. Cliquez sur l'icône Nouveau groupe ou Nouveau rôle , entrez un nom unique pour le groupe ou le rôle dans l'espace fourni, puis appuyez sur la touche Entrée. Le groupe ou le rôle est ajouté à la liste des entrées dans
l'espace-noms Cognos.
Conseil : Vous pouvez aussi créer des groupes et des rôles dans des dossiers.
Cliquez sur l'icône Nouveau dossier pour créer un dossier.
4. Ajoutez des membres au nouveau groupe ou rôle comme suit :
a. Localisez le nouveau groupe ou le nouveau rôle dans l'espace-noms Cognos. Pour trouver l'entrée rapidement, cliquez sur l'icône de recherche
ou sur l'icône de filtre afin de restreindre la vue des entrées.
b. Dans le menu contextuel du groupe ou du rôle , cliquez sur Afficher les membres, puis cliquez sur l'icône Ajouter un membre .
c. Dans le panneau Ajouter des membres, cliquez sur l'espace-noms requis et localisez l'utilisateur, le groupe ou le rôle à ajouter. Vous pouvez ajouter des membres depuis n'importe quel espace-noms ou depuis plusieurs
espaces-noms auxquels vous êtes connectés. Si nécessaire, utilisez les fonctions de recherche et de filtre pour rechercher l'utilisateur, le groupe ou le rôle à ajouter.
d. Sélectionnez les utilisateurs, les groupes ou les rôles requis. Vous pouvez sélectionner plusieurs entrées avec la touche Ctrl. Cliquez sur OK. Les entrées sélectionnées sont affichées dans l'onglet Membres.
e. Si vous voulez ajouter d'autres membres à votre groupe ou rôle, cliquez sur l'icône Ajouter un membre dans l'onglet Membres et répétez les étapes c et d. Pour supprimer un membre, sélectionnez-le et cliquez sur l'icône
Supprimer .
f. Fermez le panneau des propriétés.
Désormais, le groupe ou le rôle inclut des membres. Il peut également être ajouté à un autre groupe ou rôle.
Que faire ensuite
Les menus contextuels de groupe et de rôle fournissent des options permettant de gérer ces entrées. Dans Propriétés, dans l'onglet Droits, vous pouvez définir les droits d'accès des groupes et des rôles. L'option Afficher les membres permet d'ajouter ou de supprimer des membres dans un groupe ou un rôle, et l'option Ajouter àpermet d'ajouter l'entrée à un autre groupe ou rôle, ou à un dossier.
Pour supprimer le groupe ou le rôle, utilisez l'option Supprimer.
Création et gestion des utilisateurs
Vous pouvez créer des utilisateurs dans l'espace-noms Cognos si l'option Installation facile a été utilisée pour installer IBM Cognos Analytics.
Procédure
1. Cliquez sur Gérer > Comptes.
2. Cliquez sur l'espace-noms Cognos pour l'ouvrir.
3. Cliquez sur l'icône Nouvel utilisateur et dans la boîte de dialogue Nouvel utilisateur, entrez les informations requises, notamment l'ID utilisateur et le mot de passe. Cliquez sur OK.
Le nom d'utilisateur est ajouté à la liste des entrées dans l'espace-noms Cognos.
A présent, vous pouvez ajouter l'utilisateur à un dossier, à un groupe ou à un rôle. L'utilisateur peut se connecter à IBM Cognos Analytics avec l'ID utilisateur et le mot de passe que vous avez spécifiés pour lui.
Que faire ensuite
Le menu contextuel de l'utilisateur contient des options de gestion de l'entrée de l'utilisateur. Dans Propriétés, dans l'onglet Général dans la section des
propriétés Avancé, vous pouvez changer le mot de passe de l'utilisateur. De plus, dans Propriétés, dans l'onglet Droits, vous pouvez définir les droits d'accès de l'utilisateur. L'option Ajouter à permet d'ajouter l'utilisateur à un groupe, rôle ou dossier. Pour supprimer l'utilisateur, servez-vous de l'option Supprimer.
Personnalisation des rôles
Si vous utilisez les rôles prédéfinis dans l'espace-noms Cognos, vous pouvez personnaliser les thèmes, les pages d'accueil et les paramètres de rapport qui sont uniques à chaque rôle Cognos.
Remarque : Seuls les rôles Cognos sont personnalisables. Vous ne pouvez pas personnaliser un rôle à moins qu'il n'appartienne à l'espace-noms Cognos - soit comme un rôle Cognos prédéfini, soit comme un rôle que vous avez créé vous-même. Pour plus d'informations sur les rôles Cognos, reportez-vous au document IBM Cognos Analytics - Guide d'administration et de sécurité.
Vous pouvez indiquer qu'une page d'accueil personnalisée (ou un rapport ou
Cognos spécifique ouvre IBM Cognos Analytics. Vous pouvez retirer des fonctions d'interface utilisateur par défaut pour des rôles. En outre, vous pouvez
personnaliser les paramètres utilisables dans différents rapports, et les ajuster pour chaque rôle utilisateur.
Pour pouvoir définir des thèmes et des pages d'accueil (autres qu'un tableau de bord ou un rapport) personnalisés, vous devez avoir créé et téléchargé des thèmes personnalisés ou des pages d'accueil personnalisées. Pour plus d'informations, voir Chapitre 8, «Personnalisation de Cognos Analytics pour tous les rôles», à la page 61.
Pour personnaliser des rôles individuels, dans Gérer > Comptes, cliquez sur un espace-noms afin d'afficher la liste des rôles pour l'espace-noms. Si vous cliquez sur un rôle, le panneau coulissant pour ce rôle comporte un onglet
Personnalisation.
Remarque : Si vous voulez définir des personnalisations pour tous les rôles, utilisez le panneau coulissant Gérer > Personnalisation. Pour plus d'informations, voir «Gestion des thèmes, des extensions, des vues et des paramètres», à la page 90.
Définition d'une page d'accueil par défaut
Cliquez sur en regard de la page d'accueil par défaut. Vous pouvez alors rechercher le tableau de bord ou le rapport de votre choix devant servir de page d'accueil par défaut ou sélectionner une vue dans la liste des vues afin de la désigner comme page d'accueil par défaut pour tous les utilisateurs dans ce rôle.
Retrait de fonctions
Vous pouvez choisir de retirer des fonctions d'interface utilisateur pour les
utilisateurs dans un rôle. Cliquez sur en regard de Fonctions. La liste des vues s'affiche. Elle inclut les vues intégrées et toute vue personnalisée que vous avez téléchargée. Cliquez sur une vue pour afficher un regroupement de fonctions de niveau supérieur pour la vue. Cliquez sur en regard d'un regroupement pour explorer un niveau inférieur de fonctions. Vous pouvez désélectionner des fonctions dans cette liste ou explorer un autre ensemble de fonctions en vue de leur désélection. Cliquez sur Appliquer pour sauvegarder les modifications. Vous pouvez annuler vos modifications en cliquant sur Restaurer les valeurs par défaut.
Définition d'un thème par défaut
Cliquez sur en regard du thème par défaut. Vous pouvez sélectionner un thème dans la liste des thèmes comme thème par défaut pour tous les utilisateurs dans ce rôle.
Création d'un dossier personnalisé
Cliquez sur en regard de l'option Dossier personnalisé afin de définir un dossier de contenu personnalisé pour les utilisateurs qui possèdent ce rôle.
Lorsqu'un utilisateur possédant ce rôle se connecte, le dossier personnalisé s'affiche dans la barre de navigation, sous Contenu de l'équipe.
Définition des paramètres par défaut pour les rôles
Cliquez sur Paramètres en regard de Paramètres. Une liste de paramètres que vous avez personnalisés s'affiche. Sélectionnez les paramètres à configurer pour le rôle.
Puis, sélectionnez les valeurs par défaut que vous souhaitez appliquer pour tous les utilisateurs correspondant à ce rôle. Lorsque vous avez terminé, cliquez sur Appliquer puis sur OK.
Pour plus d'informations, voir Utilisation de paramètres personnalisés dans Reporting.
Résolution des conflits lorsqu'un utilisateur possède plusieurs rôles
Un utilisateur peut avoir plusieurs rôles dont les thèmes ou les pages d'accueil par défaut sont différents. Pour résoudre ce problème, lors de la définition des
personnalisations pour un rôle, cliquez sur Avancé et associez au rôle une priorité comprise entre 0 et 10. En cas de conflit, les personnalisations pour le rôle dont la priorité est la plus élevée seront utilisées. Le rôle Administrateurs système est associé à la priorité codée en dur 1000.
Fournisseurs d'authentification
L'authentification des utilisateurs dans IBM Cognos Analytics est gérée par l'intermédiaire des fournisseurs d'authentification. Les fournisseurs
d'authentification définissent les utilisateurs, les groupes et les rôles utilisés pour l'authentification. Les noms d'utilisateurs, codes d'identification, mots de passe, paramètres régionaux et préférences personnelles sont des exemples d'informations stockées dans les fournisseurs.
Dans l'interface utilisateur de Cognos Analytics, les fournisseurs d'authentification sont représentés par des espaces-noms .
Cognos Analytics prend en charge les types de fournisseur d'authentification suivants :
v Active Directory v OpenID Connect
v Fournisseur Java personnalisé
v Proxy d'authentification OpenID Connect v IBM Cognos Series 7
v LDAP
v SAP
v SiteMinder
Les fournisseurs d'authentification sont configurés dans IBM Cognos Configuration, sous la catégorie Sécurité > Authentification. Une fois que l'espace-noms de fournisseur a été ajouté ici et que le service IBM Cognos a été redémarré, le nom de l'espace-noms est affiché dans Gérer > Comptes et les utilisateurs peuvent se connecter à Cognos Analytics à l'aide de cet espace-noms.
Pour en savoir davantage sur la configuration des fournisseurs d'authentification,
Vous ne pouvez pas créer d'utilisateur, de groupe ou de rôle dans les espaces-noms des fournisseurs d'authentification à partir de Cognos Analytics. Toutefois, vous pouvez ajouter des utilisateurs, des groupes et des rôles de ces espaces-noms à des groupes et des rôles de l'espace-noms Cognos.
Espaces-noms multiples
Si plusieurs espaces-noms sont configurés pour Cognos Analytics, au début d'une session, vous devez sélectionner un espace-noms. Cela ne vous empêche cependant pas de vous connecter à d'autres espaces-noms ultérieurement au cours de la session. Par exemple, si vous définissez des droits d'accès, vous pouvez faire référence à des entrées d'autres espaces-noms. Pour vous connecter à un autre espace-noms, vous ne devez pas vous déconnecter de celui que vous utilisez. Vous pouvez vous connecter simultanément à plusieurs espaces-noms.
Votre connexion principale correspond à l'espace-noms et aux données
d'identification que vous avez utilisées pour vous connecter au début de la session.
Les espaces-noms auxquels vous vous connectez ultérieurement au cours de la session et les données d'identification que vous utilisez pour cela deviennent vos connexions secondaires.
Lorsque vous supprimez l'un des espaces-noms, vous pouvez vous connecter à l'aide d'un autre espace-noms. Si vous supprimez tous les espaces-noms à l'exception de l'espace-noms Cognos, vous n'êtes pas invité à vous connecter. Si l'accès anonyme est activé, vous êtes connecté automatiquement en tant
qu'utilisateur anonyme. Si l'accès anonyme n'est pas activé, vous ne pouvez pas accéder à la page de connexion. Dans ce cas, utilisez Cognos Configuration pour activer l'accès anonyme.
Gestion des espaces-noms OpenID Connect
Utilisez le type d'espace-noms OpenID Connect pour mettre en place l'authentification OpenID Connect pour IBM Cognos Analytics.
Cognos Analytics prend en charge les fournisseurs d'identité OpenID Connect suivants. Cette liste peut être amenée à s'étendre :
11.0.6 et versions ultérieures IBMid
11.0.7 et versions ultérieures Okta
ADFS (Active Directory Federation Services) Azure AD (Active Directory)
Salesforce PingFederate SiteMinder
IBMid est le service d'identité d'IBM, une solution de gestion et d'accès aux identités sur cloud qui offre des services d'identité et de code d'accès unique pour les applications IBM.
Une fois qu'un espace-noms OpenID Connect est configuré dans IBM Cognos Configuration, tous les utilisateurs OpenID Connect ont accès à Cognos Analytics.
Lorsque les utilisateurs se connectent, leur nom est automatiquement affiché dans l'espace-noms.
En tant qu'administrateur système, il se peut que vous deviez restreindre le nombre d'utilisateurs qui peuvent accéder au produit, en fonction du nombre de licences ou d'autres facteurs. Pour cela, suivez les étapes facultatives suivantes : v Ajoutez un nombre limité d'utilisateurs à l'espace-noms OpenID Connect.
Vous pouvez ajouter ces utilisateurs individuellement ou importer plusieurs utilisateurs à partir d'un fichier .csv. Pour plus d'informations, voir «Création du fichier .csv», à la page 11.
v Ajoutez les utilisateurs OpenID Connect à des groupes ou des rôles dans l'espace-noms Cognos.
A l'aide de groupes et de rôles Cognos, vous pouvez rapidement affecter les droits d'accès requis pour différents utilisateurs.
v Dans IBM Cognos, sous Sécurité > Authentification, définissez la propriété Voulez-vous limiter l'accès aux membres de l'espace-noms prédéfini ?sur true.
Seuls les membres de l'espace-noms Cognos intégré peuvent maintenant accéder à Cognos Analytics.
Procédure
1. Connectez-vous à IBM Cognos Analytics en tant qu'administrateur système.
2. Connectez-vous à l'espace-noms OpenID Connect.
3. Accédez à Gérer > Comptes et ouvrez l'espace-noms OpenID Connect.
4. Sélectionnez l'icône Ajouter un utilisateur pour ajouter des utilisateurs à l'espace-noms.
v Pour ajouter un utilisateur, entrez son adresse électronique, son nom usuel et cliquez sur Ajouter.
v Pour importer des utilisateurs à partir d'un fichier .csv, cliquez sur Importer, puis sélectionnez le fichier. Pour plus d'informations, voir «Création du fichier .csv», à la page 11.
Un même fichier .csv peut être importé plusieurs fois. Si un compte utilisateur existe déjà dans l'espace-noms, ce compte est mis à jour. Vous pouvez également répéter l'importation si les entrées précédemment importées ne semblent pas correctes.
Répétez cette étape pour les autres fichiers, si vous disposez de plusieurs fichiers.
5. Ajoutez les utilisateurs OpenID Connect à des groupes ou des rôles dans l'espace-noms Cognos.
a. Ouvrez l'espace-noms Cognos et recherchez le groupe ou le rôle auquel vous souhaitez ajouter des utilisateurs à partir de l'espace-noms OpenID Connect.
b. Dans le menu contextuel du groupe ou du rôle , sélectionnez Propriétés, puis sélectionnez l'onglet Membres.
c. Cliquez sur l'icône Ajouter un membre .
d. Dans le panneau Ajouter des membres, sélectionnez votre espace-noms OpenID Connect, puis sélectionnez les utilisateurs appropriés. Vous pouvez
e. Cliquez sur Ajouter. Les utilisateurs sélectionnés sont affichés dans l'onglet Membres.
f. Répétez la procédure pour ajouter les utilisateurs OpenID Connect à d'autres groupes ou rôles Cognos.
6. Supprimez une entrée en cliquant sur Supprimer dans le menu contextuel à côté du groupe, rôle ou dossier spécifique.
Résultats
Les utilisateurs qui utilisent l'espace-noms OpenID Connect pour se connecter à Cognos Analytics sont redirigés vers une page de connexion externe dans laquelle ils peuvent saisir leurs données d'identification. Si les données d'identification sont acceptées, les utilisateurs peuvent accéder à Cognos Analytics.
Création du fichier .csv
Le fichier .csv qui contient la liste des utilisateurs à importer dans l'espace-noms OpenID Connect doit être correctement formaté pour que l'importation aboutisse.
La première ligne du fichier est l'en-tête. Cette ligne doit contenir la colonne email et peut contenir les colonnes facultatives suivantes : defaultName, businessPhone, faxPhone, givenName, homePhone, mobilePhone, pagerPhone, postalAddress, surname, userName.
Conseil : Tous les noms de colonne sont des propriétés de la classe de compte dans IBM Cognos Analytics. Les noms sont sensibles à la casse et doivent être saisis tel qu'ils ont été spécifiés dans ce document.
Toutes les autres lignes du fichier contiennent des valeurs correspondant aux colonnes spécifiées dans la première ligne.
Voici un exemple de fichier .csv avec deux utilisateurs : v Ligne 1 : email,defaultName,givenName,surname
v Ligne 2 : Andy.Bergin@ca.ibm.com,Andy Bergin,Andy,Bergin
v Ligne 3 : Kirsten.Vaughan@ca.ibm.com,Kirsten Vaughan,Kirsten,Vaughan Vous pouvez ajouter tous vos utilisateurs à un fichier .csv ou créer plusieurs fichiers avec moins de noms dans chaque fichier.
Une fois que le fichier a été importé, le paramètre defaultName de l'utilisateur est défini de la manière suivante :
v Si defaultNameest spécifié dans le fichier .csv, le nom est utilisé.
v Si defaultNamen'est pas spécifié dans le fichier .csv, mais que givenNameet surnamele sont, le nom par défaut est défini comme suit : givenName surname. v Si defaultName, givenNameet surname ne sont pas spécifiés, le paramètre email
est utilisé comme nom par défaut.
Plusieurs utilisateurs peuvent posséder les mêmes noms et prénoms. Pour éviter les conflits potentiels, spécifiez un paramètre defaultNamedifférent pour les utilisateurs ou ne spécifiez pas surnameet givenName pour eux. Vous pouvez également modifier le paramètre surnameen y ajoutant un caractère ou un nombre unique, comme Simpson1ou Simpson2.
Recherche d'utilisateurs, de groupes et de rôles
En tant qu'administrateur, vous devez souvent localiser les utilisateurs, les groupes ou les rôles que vous gérez.
Dans la vue Espaces-noms de Comptes, tous les espaces-noms qui sont configurés pour être utilisés avec IBM Cognos Analytics sont affichés, ainsi que l'espace-noms Cognos. Vous ne pouvez accéder qu'aux espaces-noms auxquels vous êtes
connectés, et à l'espace-noms Cognos.
Recherche d'entrées
Un espace-noms peut contenir des milliers d'utilisateurs ainsi que de nombreux groupes, rôles et dossiers, et la seule façon de localiser ces entrées consiste à utiliser la fonction de recherche dans Comptes. Vous ne pouvez rechercher des entrées que dans un seul espace-noms à la fois ; par conséquent, sélectionnez d'abord l'espace-noms, puis cliquez sur l'icône de recherche . La recherche est également utilisée lorsque vous ajoutez des membres de groupes et de rôles, que vous spécifiez des droits d'accès, etc.
Filtrage des entrées
Vous pouvez procéder au filtrage en fonction des utilisateurs, des groupes et des rôles afin de restreindre votre vue des entrées. Si vous utilisez la fonction de recherche, spécifiez les critères de filtre pour une réponse plus rapide. Cliquez sur l'icône de filtre et sélectionnez ou effacez les options de filtre.
Chapitre 2. Gestion du contenu
Les motifs les plus courants de sauvegarde et de restauration du contenu sont le déplacement d'un contenu d'un environnement de test dans un environnement de production dans le cadre du processus de développement d'applications ou la préparation de la mise à niveau vers une nouvelle version du produit.
La fonction d'administration Configuration et gestion du système est requise pour gérer le contenu.
Planification du déploiement
Le processus de sauvegarde et de restauration du contenu est appelé déploiement.
Pour que les paramètres de sécurité fonctionnent lorsque vous déployez le contenu, l'environnement source et l'environnement cible doivent utiliser les mêmes espaces-noms pour que les règles, les utilisateurs, les rôles et les groupes fonctionnent correctement. L'espace-noms Cognos est inclus lorsque vous créez une sauvegarde. Vérifiez que les autres espaces-noms requis sont configurés dans l'environnement cible avant de restaurer le contenu.
Si le déploiement fait partie d'une mise à niveau, avant de créer une sauvegarde, vous pouvez exécuter une vérification de l'uniformité afin de rechercher et corriger les éventuelles incohérences dans le Content Store ou entre le Content Store et les espaces-noms externes. Vous exécutez cette vérification de l'uniformité à partir de Console d'administration> Configuration > Administration du contenu >
Nouvelle vérification de l'uniformité.
Sauvegarde du contenu
Pour protéger les informations sensibles, toutes les sauvegardes sont chiffrées.
Lorsque vous restaurez le contenu, vous devez fournir le mot de passe défini lors de la création de la sauvegarde.
La sauvegarde est sauvegardée en tant que fichier archive (.zip) dans
l'emplacement des fichiers de déploiement spécifié dans Cognos Configuration.
L'emplacement par défaut est emplacement_installation\deployment. Pour déployer le Content Store dans une autre instance d'IBM Cognos Analytics, telle que l'ordinateur utilisé pour l'environnement de production, copiez le fichier archive dans l'emplacement des fichiers de déploiement sur l'ordinateur cible afin que le fichier soit disponible pour la restauration.
Une sauvegarde inclut le contenu ci-après.
v dossiers publics v packs
v rapports
v sources de données
v listes de diffusion et contacts v configuration de l'imprimante v paramètres de droits d'accès v espace-noms Cognos
v spécifications de déploiement
Les entrées personnelles de chaque utilisateur, telles que les rapports et les dossiers du dossier Mon contenu, ne sont pas incluses dans la sauvegarde.
Restauration du contenu
Pour restaurer le contenu, le fichier de sauvegarde que vous souhaitez utiliser doit se trouver dans l'emplacement des fichiers de déploiement spécifié dans Cognos Configuration. L'emplacement par défaut est emplacement_installation\deployment.
Vous devez fournir le mot de passe défini lors de la création de la sauvegarde.
Lorsque vous restaurez le contenu, le contenu du Content Store cible est supprimé et remplacé par celui du Content Store source.
Chapitre 3. Connexions au serveur de données
Un serveur de données définit la connexion physique à une base de données.
La connexion au serveur de données indique les paramètres nécessaires pour se connecter à la base de données, tels que l'emplacement de la base de données et la durée du délai d'attente. Une connexion au serveur de données peut inclure des informations d'authentification.
IBM Cognos Analytics prend en charge plusieurs sources de données relationnelles et OLAP. La liste des types de source de données pris en charge peut changer d'une édition à l'autre. Pour des informations sur les sources de données actuellement prises en charge, reportez-vous au site Web Supported Software Environments (www.ibm.com/support/docview.wss?uid=swg27047186).
Si vous incluez des informations d'authentification de base de données, telles que les données d'identification Cognos Analytics ou un code d'accès pour la
connexion, les utilisateurs n'ont pas besoin d'entrer les informations
d'authentification de base de données chaque fois que la connexion est utilisée. Le code d'accès généré lorsque vous créez une connexion au serveur de données est disponible par défaut pour le groupe Tous. Vous pouvez modifier les droits du code d'accès à partir des propriétés de la connexion au serveur de données.
Création d'une connexion au serveur de données
Une connexion au serveur de données spécifie les paramètres requis pour la connexion à la base de données que la connexion représente.
Chaque serveur de données peut avoir une ou plusieurs connexions. Les noms de connexion doivent être uniques.
Avant de commencer
La plupart des connexions au serveur de données requièrent le pilote JDBC d'un fournisseur de base de données. Utilisez une version du pilote JDBC qui est compatible avec Java™Runtime Environment version 8. Copiez le pilote dans Cognos Analytics emplacement_installation\driverset redémarrez le service de requête. Il n'est pas nécessaire de redémarrer l'ensemble du service IBM Cognos.
Pour créer des connexions au serveur de données, vous avez besoin de la fonction d'administration Connexions de source de données. Pour plus d'informations, reportez-vous au document IBM Cognos Analytics - Guide d'administration et de sécurité.
Pourquoi et quand exécuter cette tâche
L'interface utilisateur Gérer > Connexions au serveur de données ne dispose pas des commandes requises pour définir les fonctions de connexion suivantes : v Blocs de commande de connexion
v Connexions sécurisées à Db2 LUW, Db2 for z/OS, dashDB, IBM Big SQL v Propagation d'identité Db2 for z/OS
v Connexions ORACLE légères (les blocs de commande sont obligatoires)
Pour définir des connexions qui incluent ces fonctions, utilisez la console d'administration. Pour plus d'informations, reportez-vous au document IBM Cognos Analytics - Guide d'administration et de sécurité.
Procédure
1. Cliquez sur Gérer > Connexions au serveur de données.
2. Dans le panneau Connexions au serveur de données, cliquez sur l'icône Ajouter un serveur de données .
3. Sélectionnez le type de serveur de données dans la liste des types pris en charge.
4. Dans la zone Nouvelle connexion de serveur de données, saisissez un nom unique pour la connexion.
5. En regard de Détails de connexion, cliquez sur Editer et saisissez les détails de connexion pour le type de connexion que vous créez.
Pour la plupart des connexions, vous devez spécifier l'URL JDBC. Vous pouvez visualiser la syntaxe et l'exemple d'URL sous les détails de la connexion. Vous devrez peut-être demander davantage d'informations à l'administrateur de base de données, ou consulter la documentation du fournisseur de base de données.
Dans la zone Propriétés de connexion, saisissez le nom de la propriété prise en charge. Pour plus d'informations sur les propriétés JDBC prises en charge, voir
«Paramètres de connexion Cognos», à la page 17. Pour les connexions Planning Analytics, spécifiez l'hôte de base de données TM1 et le numéro de port HTTP.
Pour utiliser une connexion SSL, cochez la case Utiliser SSL.
6. Sous Méthode d'authentification, spécifiez la méthode d'accès au serveur de données. Vous pouvez sélectionner l'une des options suivantes.
Connexion anonyme ou sécurité intégrée
Sélectionnez l'option Connexion anonyme lorsque l'accès anonyme au serveur de données est autorisé.
Sélectionnez l'option Sécurité intégrée lorsque la base de données TM1 est configurée pour le mode de sécurité intégrée 4 ou 5. Cette option s'applique aux connexions Planning Analytics uniquement.
Demander le nom d'utilisateur et le mot de passe
Choisissez cette option si l'utilisateur doit être invité à spécifier les données d'identification de la base de données lors de chaque utilisation.
Utiliser les données d'identification d'IBM Cognos Analytics
Choisissez cette option pour transmettre au serveur de données les mêmes données d'identification que celles utilisées pour
l'authentification auprès de Cognos Analytics.
Utiliser le code d'accès suivant
Choisissez cette option pour attribuer un code d'accès pour la
connexion. Sélectionnez votre code d'accès dans la liste déroulante ou créez un code d'accès en cliquant sur l'icône Ajouter . Dans la fenêtre Nouvelle connexion de serveur de données de l'onglet Données d'identification, saisissez un ID utilisateur et un mot de passe. Pour restreindre le code d'accès à des utilisateurs, des rôles ou des groupes particuliers, dans l'onglet Droits, cliquez sur , puis spécifiez les droits d'accès associés au code.
7. Cliquez sur Tester pour vérifier que la connexion au serveur de données fonctionne, puis cliquez sur Enregistrer pour enregistrer la nouvelle connexion au serveur de données.
Résultats
Le nom de la nouvelle connexion est affiché dans le panneau Connexions au serveur de données. Pour éditer la connexion au serveur de données, notamment en ajoutant ou en modifiant son code d'accès, cliquez sur son nom.
Paramètres de connexion Cognos
Vous pouvez spécifier des paramètres Cognos facultatifs pour les connexions JDBC.
Vous pouvez spécifier ces paramètres lors de la création ou de la mise à jour des connexions JDBC pour les sources de données dans IBM Cognos Administration ou IBM Cognos Framework Manager, ou lors de la création ou de la mise à jour des connexions au serveur de données dans l'interface d'administration Gérer >
Connexions au serveur de donnéesdans IBM Cognos Analytics version 11.0.x.
Dans les différents éditeurs de connexion, ces paramètres peuvent être spécifiés en tant que Propriétés de connexion ou Paramètres de connexion JDBC.
ibmcognos.fetchBufferSize
Ce paramètre permet de définir la taille de bloc d'extraction qui est transmise au pilote JDBC pour les connexions de source de données dans IBM Cognos
Analytics.
Lorsque le mode de requête dynamique dans IBM Cognos Analytics exécute des requêtes à l'aide de JDBC, la valeur de la taille de bloc d'extraction transmise à un pilote JDBC est calculée dynamiquement. La prise en charge des tailles de bloc d'extraction varie selon les fournisseurs de données. Les fournisseurs décident également ce que la taille de bloc d'extraction signifie, ainsi que sa valeur lorsqu'elle est utilisée en interne dans le pilote et sur le serveur. Pour plus de détails, voir la documentation JDBC de votre fournisseur.
Le mode de requête dynamique calcule une valeur pour une requête avec la formule suivante : maximum( (bufferSize / 'row-size'), 10)
La valeur par défaut de la taille du tampon est 100 kilooctets (ko). La taille de ligne est calculée à partir de la taille des colonnes qui sont projetées par l'ensemble de résultats dans une requête. Les requêtes qui projettent des colonnes avec une grande précision ou qui projettent de nombreuses colonnes utilisent une taille de bloc d'extraction plus petite que celles qui projettent un nombre moins élevé de colonnes ou qui projettent des colonnes avec une précision moindre.
Si l'extraction d'un ensemble de résultats peut être considérablement améliorée grâce à une taille de tampon plus grande, un administrateur Cognos peut spécifier la propriété de connexion ibmcognos.fetchBufferSize. Le mode de requête
dynamique ajuste automatiquement la valeur si elle est inférieure à 10 kilooctets ou supérieure à 10 mégaoctets.
Si ibmcognos.fetchBufferSize > 1024 * 10240, alors bufferSize = 1024 * 10240 Si ibmcognos.fetchBufferSize < 10240, alors bufferSize = 10240
Des tailles de bloc d'extraction plus grandes ne sont pas toujours recommandées car elles peuvent potentiellement augmenter la quantité de mémoire consommée par le pilote JDBC et ne permettent pas d'obtenir de meilleures performances.
Consultez toujours la documentation du fournisseur de base de données ainsi que les pratiques recommandées avant d'utiliser des valeurs élevées pour la propriété ibmcognos.fetchBufferSize.
ibmcognos.decfloat
Si ce paramètre est spécifié, le mode de requête dynamique doit utiliser un type de variable flottante décimale, DECFLOAT 128, qui représente précisément les valeurs avec une précision pouvant atteindre 34 chiffres. Si une colonne avec une précision élevée est détectée, elle est modifiée en interne en DECFLOAT et le type de
données dans le modèle ou le rapport est décrit comme suit : DECIMAL(0,0).
Pour activer cette fonctionnalité, spécifiez le paramètre de connexion
ibmcognos.decfloat=true pour la connexion à la base de données utilisée par le mode de requête dynamique. Dans les modèles existants, les colonnes doivent être remappées en DECIMAL(0,0) et non en double.
Pour que le mode de requête dynamique puisse lire les lignes renvoyées par une requête, le pilote JDBC doit renvoyer les valeurs de colonne à l'aide d'un type de données Java spécifique. Dans les versions précédentes, une base de données telle qu'ORACLE pouvait renvoyer une colonne numérique dont la précision nécessitait que la requête dynamique utilise le type de données double. Si les valeurs
renvoyées par une requête avaient une précision supérieure à 16 chiffres, la conversion pouvait résulter en une valeur imprécise.
Par exemple, si une colonne ORACLE a été définie comme NUMBER (sans indiquer de précision), ou qu'un agrégat tel que SUM a été calculé et renvoyé par ORACLE comme NUMBER, la valeur 1234567890123456789 renvoyée peut être convertie en 1.23456789012345677E18. Ces deux valeurs ne sont pas identiques.
Si la base de données ne renvoie pas de valeurs élevées, n'utilisez pas ce paramètre et assurez-vous que les modèles n'incluent pas de colonnes avec le type de
données DECIMAL(0,0). Cela permet au mode de requête dynamique d'utiliser un type de données qui requiert moins de mémoire que le type DECFLOAT.
ibmcognos.qualifier_list
Ce paramètre est utilisé pour clarifier les métadonnées lorsque des requêtes dynamiques sont exécutées. Il affecte une liste d'un ou de plusieurs qualificatifs à des sources de données qui sont définies dans IBM Cognos Analytics.
Les exemples suivants présentent la syntaxe à utiliser lorsque vous spécifiez le paramètre ibmcognos.qualifier_list, ainsi que les valeurs que vous pouvez affecter :
v ibmcognos.qualifier_list=CATALOG1.SCHEMA1, CATALOG2.SCHEMA2 v ibmcognos.qualifier_list=SCHEMA1, SCHEMA2
v ibmcognos.qualifier_list=CATALOG1.SCHEMA1, SCHEMA2 v ibmcognos.qualifier_list=CATALOG1, CATALOG2
Un point dans le qualificatif permet de séparer les composants catalogue et schéma. Si aucun point n'apparaît et que la base de données prend en charge les
schémas, la valeur est traitée comme un schéma. Sinon, elle est traitée comme un catalogue, si la base de données prend en charge les catalogues.
Le service de requête effectue une recherche dans la liste, dans l'ordre spécifié, et utilise les métadonnées de colonne qu'il trouve pour le premier qualificatif correspondant. Si aucune correspondance n'est trouvée, une erreur signalant que les métadonnées sont ambiguës est émise.
L'administrateur doit confirmer que l'ordre dans la liste de qualificatifs fournis pour ce paramètre et le contenu de la liste sont identiques à toute liste de
recherche que la session de base de données de l'utilisateur peut avoir définie. La liste de qualificatifs est appliquée uniquement lorsque la session tente de clarifier des métadonnées renvoyées par un pilote JDBC. Les noms qualifiés dans les instructions SQL dynamiques reflètent les valeurs qui sont affectées aux propriétés de catalogue ou de schéma que la source de données du pack a utilisées lors de la planification des requêtes.
ibmcognos.authentication
Ce paramètre permet de configurer les connexions de source de données lorsque vous utilisez l'authentification Kerberos.
Spécifiez ibmcognos.authentication=java_krb5 pour les différents types de connexion de source de données, puis ajoutez les propriétés requises par le pilote JDBC pour l'authentification Kerberos, si nécessaire. Les exemples suivants illustrent la spécification de ce paramètre pour certaines connexions de source de données :
v Pour les connexions Teradata, spécifiez
ibmcognos.authentication=java_krb5;LOGMECH=KRB5;
v Pour les connexions SAP-HANA, spécifiez ibmcognos.authentication=java_krb5;
v Pour les connexions Microsoft SQL Server, spécifiez
ibmcognos.authentication=java_krb5;authenticationScheme=JavaKerberos;
ibmcognos.maxvarcharsize
Le mode de requête dynamique peut utiliser une valeur de précision VARCHAR par défaut supérieure à la valeur par défaut prise en charge par la base de
données. Ce paramètre est utilisé pour remplacer la valeur de précision VARCHAR par défaut de la base de données pour le mode de requête dynamique.
Pour définir ce paramètre, utilisez la syntaxe suivante, où N est un entier supérieur à 0 qui est pris en charge par le fournisseur de base de données :
ibmcognos.maxvarcharsize=N
La norme SQL utilise le type de données CLOB et le type d'objet NCLOB pour stocker des valeurs de caractère de grande taille. Différentes bases de données prennent en charge le type de données CLOB ou leurs propres versions de ce type avec des caractéristiques similaires. Le type de données CLOB impose un certain nombre de restrictions aux types de constructions SQL qui peuvent être utilisés dans les requêtes. Par ailleurs, des fournisseurs de base de données peuvent imposer des restrictions supplémentaires au mode de traitement des colonnes CLOB dans des interfaces client, comme JDBC. Pour éviter les restrictions liées à CLOB, le mode de requête dynamique convertit automatiquement les colonnes
CLOB en colonnes VARCHAR à l'aide de la fonction CAST. Les Npremiers résultats du type CLOB sont donc renvoyés à la demande dynamique sous la forme de données VARCHAR.
Conseil : La fonction automatique CASTn'est pas exécutée lorsqu'un pilote JDBC décrit la colonne en tant que données VARCHAR et non en tant qu'objet CLOB et lorsque la référence de colonne comporte un élément CASTdéfini par l'utilisateur.
Si la longueur d'un objet CLOBsur une ligne est supérieure aux données de précision CAST, les données sont tronquées.
Dans certains cas, un fournisseur de base de données peut prendre en charge une plus grande précision si des paramètres de configuration de base de données spécifiques, tels que la taille des pages et des lignes ou les paramètres du serveur, sont respectés. Si ces conditions préalables sont remplies, une valeur plus élevée peut être définie sur une connexion de serveur de données. Si les conditions préalables ne sont pas remplies, l'exécution des instructions SQL échoue lorsque vous utilisez une valeur supérieure à celle prise en charge par la base de données.
Avant d'utiliser des valeurs de précision VARCHAR plus élevées, reportez-vous à la documentation du fournisseur de base de données et vérifiez la valeur auprès de l'administrateur de la base de données.
Le mode de requête dynamique utilise les valeurs de précision VARCHAR suivantes pour les différentes bases de données :
Tableau 1. Valeurs de précision VARCHAR par défaut en mode de requête dynamique Base de données Précision VARCHAR par défaut
Db2 iSeries 32739
Db2 ZSeries 4096
Db2 LUW 8168
Exasol 2000000
Informix Dynamic Server 255
MariaDB 21845
MemSQL 21845
MySQL 65535
Oracle 4000
Pivotal Greenplum 2000000
PostgreSQL 2000000
SAP Hana 5000
SQL Server varchar(max)
Teradata 32000
Autres fournisseurs 1024
Si la valeur du paramètre ibmcognos.maxvarcharsizeest supérieure à la valeur maximale de l'entier Java (2147483647) ou n'est pas un entier, elle est ignorée.
Si la valeur du paramètre ibmcognos.maxvarcharsizeest inférieure à la valeur par défaut 1024 et à la taille VARCHAR du fournisseur, la plus faible de ces deux valeurs est utilisée à la place de la valeur du paramètre ibmcognos.maxvarcharsize.
Préchargement des métadonnées depuis une connexion de serveur de données
Lorsqu'un serveur de données est spécifié comme source pour un module de données, les métadonnées sont chargées depuis le serveur de données dans le magasin de données. Ce processus peut prendre du temps et vous pouvez de ce fait précharger les métadonnées afin de l'accélérer.
Les métadonnées préchargées accélèrent la modélisation des données en permettant au système de spécifier de manière intelligente les paramètres par défaut, tels que Usage et Agrégation, en se basant sur les métadonnées chargées.
Procédure
1. Cliquez sur Gérer > Connexions au serveur de données. Le panneau coulissant affiche la liste des connexions au serveur de données.
2. Dans le panneau Connexions au serveur de données, cliquez sur une
connexion au serveur de données, puis, dans l'onglet Connexions, cliquez sur un nom de connexion.
3. Dans l'onglet Schémas, cliquez sur l'icône Plus en regard d'un nom de schéma pour charger les données ou modifier les options de chargement.
4. Cliquez sur Options de chargement pour modifier la quantité de données à charger.
Dans l'onglet Tables, vous pouvez spécifier les tables à précharger.
5. Cliquez sur Charger les métadonnées pour charger les métadonnées.
6. Si les métadonnées pour un schéma sont déjà chargées, cliquez sur Effacer les métadonnéespour supprimer les métadonnées du magasin de contenu.
Informations de référence et traitement des incidents
Lors de la création et de la gestion des connexions au serveur de données dans IBM Cognos Analytics, vous pourriez rencontrer des problèmes avec les pilotes JDBC, la prise en charge de la version du serveur de données, l'authentification, etc.
Les informations de connexion sont différentes pour chaque type de serveur de données. Pour plus d'informations, voir la documentation du fournisseur de base de données.
Pilotes JDBC de Cloudera Impala
IBM Cognos Analytics prend en charge les connexions aux serveurs de données Cloudera Impala qui utilisent la version 2.5.34 et ultérieure des pilotes JDBC. Les versions des pilotes JDBC antérieures à la version 2.5.34 ne sont pas prises en charge.
Lors d'une tentative de connexion à Cloudera Impala, le moteur de requête vérifie la version du pilote JDBC. Si la version est antérieure à 2.5.34, un message d'erreur est renvoyé.
Pour éviter tout problème, remplacez les versions plus anciennes des pilotes JDBC pour Impala dans l'environnement Cognos Analytics par des versions plus
récentes. Le pilote peut être téléchargé à partir du site Web de Cloudera
(www.cloudera.com/downloads/connectors/impala/jdbc/2-5-34.html). Pour plus d'informations, voir la documentation de Cloudera.
Requêtes bloquées dans le moteur Pivotal HDB
Les requêtes peuvent se bloquer dans le moteur Pivotal HDB en raison d'un incident lié à l'optimiseur Pivotal.
Pour résoudre le problème, l'administrateur Pivotal peut modifier les paramètres par défaut du serveur, ou ajouter le bloc de commande suivant pour la connexion dans IBM Cognos Administration.
<commandBlock>
<commands>
<sqlCommand>
<sql>select disable_xform(’CXformExpandNAryJoinDP’)</sql>
</sqlCommand>
</commands>
</commandBlock>
Si une table a été créée dans HDB à l'aide du partitionnement, le pilote Pivotal JDBC renvoie les métadonnées pour chaque partition de la table. Il n'existe actuellement aucune méthode pour empêcher le logiciel Pivotal de renvoyer les métadonnées supplémentaires. Un modélisateur d'IBM Cognos Analytics n'a pas besoin d'inclure ces métadonnées supplémentaires pour que les requêtes
s'exécutent.
Serveurs de données Denodo 5.5 et 6.0
Les types de serveur de données Denodo 5.5 et 6.0 sont pris en charge grâce au pilote JDBC de Denodo.
La version minimale prise en charge de Denodo 5.5 est la mise à jour 20160322 pour laquelle le correctif logiciel Denodo #26682 doit être appliqué. Les versions précédentes de Denodo 5.5 ne sont pas prises en charge.
L'édition initiale de Denodo 6.0 GA nécessite que le correctif logiciel Denodo
#26681 soit appliqué.
Denodo nécessite un pilote JDBC 6.0 pour accéder à un serveur 6.0 et un pilote JDBC 5.5 pour accéder à un serveur 5.5.
Les pilotes JDBC de Denodo 5.5 ne bloquent pas les connexions sur un serveur 6.0.
Dans ce cas, le serveur 6.0 risque d'émettre des exceptions lors de l'exécution de requêtes ou d'une tentative d'importation des métadonnées.
Sources de données qui ne sont plus prises en charge dans Cognos Analytics
Certaines sources de données ne sont plus prises en charge dans IBM Cognos Analytics.
Toutes les connexions de source de données qui ont été définies dans les versions précédentes de Cognos Analytics restent dans le magasin de contenu jusqu'à ce qu'elles soient supprimées manuellement ou modifiées en un type pris en charge, le cas échéant. Ces connexions sont visibles dans les interfaces d'administration du produit. Lorsque ces connexions sont ouvertes dans IBM Cognos Administration,
elles apparaissent dans l'éditeur de connexion de type Autre. Cet éditeur de connexion fournit une interface limitée pour afficher ou éditer les connexions et pour accéder aux codes d'accès associés.
Chaque connexion de source de données dans le magasin de données est
représentée par une chaîne composée de différents noms et valeurs personnalisés.
Cette chaîne est visible dans les éditeurs de connexion dans Cognos Analytics. Par exemple, lors du test d'une connexion, une chaîne telle que la suivante s'affiche :
^User ID:^?Password:;LOCAL;PG;DSN=MyDataSourceName;
UID=%s;PWD=%s;MyODBCDSN@ASYNC=0@0/0@COLSEQ=
Le type de connexion dans la chaîne apparaît après la valeur LOCAL. Dans l'exemple ci-dessus, le type de connexion est PG.
Si la version actuelle de Cognos Analytics utilise des connexions à des sources de données qui ne sont plus prises en charge, vous pouvez remplacer les connexions par des types pris en charge.
Cognos Analytics 11.0.8
Les sources de données suivantes ne sont pas prises en charge à partir de la version 11.0.8 :
v Hitachi Advanced Data Binder Platform (JDBC) v IBM Domino (JDBC)
v MongoDB Connector for BI version 1
Mettez à jour les connexions version 1 pour qu'elles utilisent MongoDB Connector for BI version 2.2.1. Mettez également à jour les modèles Cognos existants lorsque vous êtes connecté à la version 2.2.1. Ainsi, vous veillerez à ce que les métadonnées du modèle répercutent les différences de type de données et d'échelle qui ont été introduites dans MongoDB Connector for BI 2.2.1.
Cognos Analytics 11.0.6
Les sources de données suivantes ne sont pas prises en charge à partir de la version 11.0.6 :
v Actian Matrix (ODBC et JDBC).
Les types de connexion ODBC génériques peuvent être utilisés pour faire référence à un nom de source de données ODBC qui utilise un pilote ODBC sur des systèmes d'exploitation Microsoft Windows pour accéder à un serveur Actian Matrix. Vous ne pourrez pas utiliser une connexion JDBC existante.
v Actian Vector (ODBC).
Les types de connexion ODBC génériques peuvent être utilisés pour faire référence à un nom de source de données ODBC qui utilise un pilote ODBC sur des systèmes d'exploitation Microsoft Windows pour accéder à un serveur Actian Vector.
v IBM IMS (JDBC)
Cognos Analytics 11.0.3
Les sources de données suivantes ne sont pas prises en charge à partir de la version 11.0.3 :
v IBM Cognos Finance - type de connexion CL
v Microsoft SQL Server Analysis Services 2005 et 2008 (ODBO) - types de connexion YK et M8
Les applications fonctionnant sous Windows doivent utiliser le client ODBO fourni avec la version Microsoft Analysis Services prise en charge. Les applications non Windows peuvent utiliser une connexion XMLA (type de connexion X8). Les versions des clients ODBO avec SQL Server Analysis Services 2005, 2008 et 2008 R2 ne sont plus prises en charge. Les connexions pour les versions 2012 (type de connexion M12) et 2014 (type de connexion M14) sont prises en charge. Les nouvelles connexions faisant référence aux clients 2012 ou 2014 doivent être utilisées uniquement pour la version 2012 et 2014 des serveurs SQL Server Analysis Services correspondants.
A partir de Cognos Analytics 11.0.0, seuls les serveurs en mode de requête dynamique prennent en charge SQL Server Analysis Services. Le mode de requête compatible ne prend pas en charge SQL Server Analysis Services.
v Clients natifs Microsoft SQL Server 2005 et 2008, et OLE DB (type de connexion OL et Provider=SQLNCLI ou SQLNCLI10)
Les versions plus anciennes des bibliothèques client Microsoft SQL Server ne sont plus prises en charge ( https://msdn.microsoft.com/en-us/library/
cc280510.aspx). Pour les applications qui doivent accéder à SQL Server via OLE DB, vous pouvez utiliser les connexions de client natif qui incluent
Provider=SQLNCLI11. Ces connexions sont parallèles à SQL Server Native Client version 11 qui est pris en charge avec SQL Server 2016, 2014 et 2012. Les connexions utilisant le pilote ODBC Microsoft pour SQL Server peuvent également être utilisées.
v SAP ECC
Cognos Analytics 11.0.2
Les sources de données suivantes ne sont pas prises en charge à partir de la version 11.0.2 :
v Composite (ODBC)
Composite (type de connexion CS) : les types de connexion ODBC (OD)
génériques peut être utilisés pour faire référence à un nom de source de données ODBC qui peut utiliser un pilote ODBC sur des systèmes d'exploitation
Windows pour accéder aux serveurs Siebel. Le mode de requête dynamique prend en charge plusieurs technologies, parmi lesquelles Cisco Information Server et Denodo via JDBC, qui peuvent potentiellement être utilisées pour fournir un accès fédéré aux systèmes Siebel.
v IBM Cognos Now! - Real-time Monitoring Cube (type de connexion LA) Il n'existe pas d'autre type de connexion.
v IBM Cognos Planning - Series 7 (type de connexion CR) Il n'existe pas d'autre type de connexion.
v IBM Cognos Virtual View Manager (ODBC) v IBM Red Brick (ODBC)
v Progress OpenEdge (ODBC) v Siebel
v Sybase Adaptive Server Enterprise (CT-Lib)
