V ersió 11 - IBM · 2020-03-24 · Els permisos d'accés inicials s'apliquen a tots els objectes pr edefinits. Podeu modificar els permisos des de les pr opietats d'objecte. Anònim

IBM Cognos AnalyticsVersió 11.0

Manual d'usuari de gestió

IBM

©

Informació del producte

Aquest document s'aplica a IBM Cognos Analytics versió 11.0.0 i també es pot aplicar a versions posteriors.

Copyright

Materials sota llicència - Propietat d'IBM

© Copyright IBM Corp. 2015, 2018.

Drets restringits del usuaris del govern dels Estats Units: L'ús, la duplicació o la divulgació estan subjectes a lesrestriccions publicades al GSA ADP Schedule Contract amb IBM Corp.

IBM, el logotip d'IBM i ibm.com són marques comercials o marques comercials registrades d'International BusinessMachines Corp., registrades a nombroses jurisdiccions arreu del món. Altres noms de productes i serveis poden sermarques registrades d'IBM o d'altres empreses. Trobareu una llista completa de les marques registrades d'IBM allloc web de “Copyright i informació sobre marques registrades” a www.ibm.com/legal/copytrade.shtml.

Els termes següents són marques comercials o marques registrades d'altres empreses:v Adobe, el logotip d'Adobe, PostScript i el logotip de PostScript són marques comercials o marques registrades

d'Adobe Systems Incorporated als Estats Units o a altres països.

v Microsoft, Windows, Windows NT i el logotip de Windows són marques registrades de Microsoft Corporation alsEstats Units o a d'altres països.

v Intel, el logotip d'Intel, Intel Inside, el logotip d'Intel Inside, Intel Centrino, el logotip d'Intel Centrino, Celeron,Intel Xeon, Intel SpeedStep, Itanium i Pentium són marques registrades d'Intel Corporation o de les subsidiàriesals Estats Units i/o a altres països.

v Linux és una marca registrada de Linus Torvalds als Estats Units i a d'altres països.

v UNIX és una marca registrada de The Open Group als Estats Units i/o a altres països.

v Java i totes les marques registrades i logotips basades en Java són marques registrades d'Oracle i/o els seusafiliats.

Les captures de pantalla dels productes de Microsoft s'han utilitzat amb permís de Microsoft.

http://www.ibm.com/legal/copytrade.shtml

Contingut

Capítol 1. Gestió de comptes . . . . . . . . . . . . . . . . . . . . . . . . . . 1L'espai de noms Cognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Creació i gestió de grups i rols . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Creació i gestió d'usuaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Personalització de rols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Proveïdors d'autenticació . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Gestió dels espais de noms de l'OpenID Connect . . . . . . . . . . . . . . . . . . . . . . 9

Cerca d'usuaris, grups i rols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Capítol 2. Gestió del contingut . . . . . . . . . . . . . . . . . . . . . . . . . 13

Capítol 3. Connexions del servidor de dades . . . . . . . . . . . . . . . . . . . 15Creació d'una connexió amb un servidor de dades . . . . . . . . . . . . . . . . . . . . . . 15

Paràmetres de connexió específica de Cognos . . . . . . . . . . . . . . . . . . . . . . . 17Precàrrega de metadades des d'una connexió de servidor de dades . . . . . . . . . . . . . . . . . 20Referència i resolució de problemes . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Controladors JDBC de Cloudera Impala . . . . . . . . . . . . . . . . . . . . . . . . . 21Consultes estancades en el motor Pivotal HDB . . . . . . . . . . . . . . . . . . . . . . 21Servidors de dades de Denodo 5.5 i 6.0 . . . . . . . . . . . . . . . . . . . . . . . . . 22Fonts de dades que ja no reben suport a Cognos Analytics . . . . . . . . . . . . . . . . . . 22

Actualitzacions per versió . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Cognos Analytics 11.0.13 - característiques noves i modificades . . . . . . . . . . . . . . . . . 24Cognos Analytics 11.0.9 - característiques noves i modificades . . . . . . . . . . . . . . . . . 25Cognos Analytics 11.0.8 - noves característiques . . . . . . . . . . . . . . . . . . . . . . 26Cognos Analytics 11.0.7 - característiques noves i modificades . . . . . . . . . . . . . . . . . 27

Capítol 4. Gestió de valors del sistema . . . . . . . . . . . . . . . . . . . . . . 29Gestió de la càrrega de fitxers de dades . . . . . . . . . . . . . . . . . . . . . . . . . . 29Aplicació de la Seguretat de transport estricte HTTP. . . . . . . . . . . . . . . . . . . . . . 29Tipus i fitxers de registre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Registre de diagnòstics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Configuració del registre de sessió. . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Habilitar o inhabilitar components heretats . . . . . . . . . . . . . . . . . . . . . . . . . 33

Capítol 5. Gestionar activitats planificades . . . . . . . . . . . . . . . . . . . . 35Gestió d'activitats actuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Gestió d'activitats passades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Gestionar les activitats futures d'un dia específic . . . . . . . . . . . . . . . . . . . . . . . 36Gestió d'activitats planificades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Gestió de la prioritat d'execució de les entrades . . . . . . . . . . . . . . . . . . . . . . . 38

Capítol 6. Gestió de llicències . . . . . . . . . . . . . . . . . . . . . . . . . . 41Rols de llicència . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Permisos per defecte basats en llicències . . . . . . . . . . . . . . . . . . . . . . . . . . 42Assignació de capacitats segons els rols de llicència . . . . . . . . . . . . . . . . . . . . . . 49Escenari d'actualització: si els vostres rols personalitzats tenen els mateixos noms què els nous rols de llicència deCognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Capítol 7. Administració d'arrendataris . . . . . . . . . . . . . . . . . . . . . . 51Regles de contenció per al multiarrendament . . . . . . . . . . . . . . . . . . . . . . . . 51Creació d'arrendataris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Assignació d'ID de arrendatari a contingut existent . . . . . . . . . . . . . . . . . . . . . . 52Definició d'un ID d'arrendament per a un objecte públic . . . . . . . . . . . . . . . . . . . . 53Administració delegada d'arrendataris . . . . . . . . . . . . . . . . . . . . . . . . . . 53

iii

Configuració del rol Administradors d'arrendataris . . . . . . . . . . . . . . . . . . . . . 54Configuració d'arrendataris virtuals per habilitar l'ús compartit del contingut entre arrendataris . . . . . . . 55Personalització d'arrendataris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Definir la configuració regional per als arrendataris . . . . . . . . . . . . . . . . . . . . . . 57Configuració de notificacions per a arrendataris . . . . . . . . . . . . . . . . . . . . . . . 58Finalització de les sessions d'usuari actives dels arrendataris . . . . . . . . . . . . . . . . . . . 58Inhabilitació i habilitació d'arrendataris . . . . . . . . . . . . . . . . . . . . . . . . . . 59Supressió d'arrendataris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Capítol 8. Personalització de Cognos Analytics a tots els rols . . . . . . . . . . . . 61Exemples de personalització . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Creació de temes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Temes d'exemple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Creació d'extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Addició d'un botó o d'un element de menú. . . . . . . . . . . . . . . . . . . . . . . . 65Addició d'un menú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Eliminació d'un element de la interfície d'usuari . . . . . . . . . . . . . . . . . . . . . . 72Addició de formes de panell d'eines . . . . . . . . . . . . . . . . . . . . . . . . . . 72Creació d'una galeria d'imatges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Addició d'un giny de panell d'eines . . . . . . . . . . . . . . . . . . . . . . . . . . 76Extensions d'exemple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Creació de vistes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Creació d'una vista (una que no sigui una vista d'inici de sessió) . . . . . . . . . . . . . . . . 82Creació d'una vista d'inici de sessió . . . . . . . . . . . . . . . . . . . . . . . . . . 84Creació d'una vista d'inici de sessió amb una solvlicitud d'espai de noms . . . . . . . . . . . . . . 87Vistes d'exemple. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Gestió de temes, extensions, vistes i paràmetres . . . . . . . . . . . . . . . . . . . . . . . 90Execució de Cognos Analytics amb extensions personalitzades i vistes inhabilitades . . . . . . . . . . 92

Descripció de spec.json . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Validació d'esquema JSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Com determinar l'id d'un objecte d'interfície d'usuari . . . . . . . . . . . . . . . . . . . . 99

Capítol 9. Habilitació d'un entorn de producció . . . . . . . . . . . . . . . . . . 101

Quant a aquesta guia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Índex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

iv IBM Cognos Analytics Versió 11.0: Manual d'usuari de gestió

Capítol 1. Gestió de comptes

A l'IBM® Cognos Analytics, podeu gestionar l'autenticació d'usuaris i l'accés alcontingut i les característiques del producte.

L'administrador que configura la vostra aplicació Cognos Analytics efectua laconfiguració de seguretat inicial. Aquesta configuració inclou la configuració deproveïdors d'autenticació per aprofitar la infraestructura de seguretat existent en lavostra organització. Cada proveïdor d'autenticació que es configura per utilitzar-loamb l'Cognos Analytics es coneix com espai de noms o espai de noms extern.

A més a més dels espais de noms que representen els proveïdors d'autenticacióexterns, l'IBM Cognos Analytics té un espai de noms intern integrat que es diuCognos. L'espai de noms Cognos simplifica el procés de gestió dels permisosd'accés i desplegament del contingut.

El Cognos Analytics també es pot configurar per a l'accés anònim, en el qual no calque els usuaris proporcionin el seu ID d'usuari i la seva contrasenya per accedir al'aplicació. Per obtenir informació sobre l'habilitació de l'accés anònim, consulteu lapublicació IBM Cognos Analytics Installation and Configuration Guide.

Important: Pot ser que el vostre entorn tingui molts usuaris. Com a pràcticarecomanada, els usuaris s'han d'agrupar en carpetes, i cada carpeta ha de contenir1000 usuaris com a màxim.

La capacitat d'administració Usuaris, grups i rols és necessària per a gestionarcomptes. Per obtenir més informació, consulteu l'apartat sobre funcions icaracterístiques protegides a la guia d'administració i seguretat de l'IBM CognosAnalytics.

L'espai de noms CognosL'espai de noms Cognos inclou objectes predefinits per ajudar-li a configurarràpidament la seguretat inicial.

Fareu servir els objectes predefinits i altres característiques de l'espai de nomsCognos per a la gestió de la seguretat en curs.

L'espai de noms Cognos conté usuaris, grups i rols. Un grup és un conjuntd'usuaris. Els membres dels grups poden ser usuaris i altres grups. Un rol es unarecopilació de capacitats que identifiquen les tasques que un usuari pot realitzar.Els membres de rols poden ser usuaris, grups i altres rols. Un usuari pot pertànyera diversos grups o rols. Quan un usuari és membre de més d'un grup, els permisosd'accés es fusionen.

El diagrama següent mostra l'estructura de grups i rols de l'espai de noms Cognos.

1

Podeu crear grups i rols a l'espai de noms Cognos. La capacitat de crear usuaris enl'espai de noms Cognos només està disponible si s'ha utilitzat l'opció Instalvlaciófàcil per a instalvlar l'IBM Cognos Analytics.

Objectes predefinits i incorporats en l'espai de noms Cognos

Els permisos d'accés inicials s'apliquen a tots els objectes predefinits. Podeumodificar els permisos des de les propietats d'objecte.

AnònimAquest usuari és per a la configuració inicial en què l'accés anònim estàhabilitat i no es solvlicita als usuaris que indiquin les seves credencials.Quan s'inhabilita un accés anònim a Cognos Configuration, un usuari esregistra utilitzant les seves pròpies credencials.

Tots els usuaris autenticatsAquest grup representa els usuaris autenticats pels proveïdorsd'autenticació. La pertinença a aquest grup s'actualitza mitjançant elproducte i no es pot visualitzar ni alterar.

TothomAquest grup representa a tots els usuaris autenticats y al compte d'usuarianònim. La pertinença a aquest grup s'actualitza mitjançant el producte ino es pot visualitzar ni alterar. Podeu fer servir el grup Tots per establir laseguretat per defecte ràpidament. Per exemple, per protegir un informe,podeu atorgar els permisos de lectura, escriptura o execució de l'informe algrup Tots. Un cop activada aquesta seguretat, podeu atorgar accés al'informe a altres usuaris, grups o rols, així com eliminar el grup Tots de lapolítica de seguretat d'aquest informe.

Usuaris d'AnalysisEls membres d'aquest rol tenen els mateixos permisos d'accés que elsconsumidors. També poden utilitzar l'IBM Cognos Analysis Studio.

Administradors d'Analytics

Els membres tenen els mateixos permisos d'accés que els Exploradorsd'Analytics. També poden accedir a:v Gestiona > Connexions del servidor de dades

v Connexions del servidor de dades a la consola d'administracióv Kit de desenvolupament de programari d'IBM Cognos

Aquest rol només està disponible després d'una instalvlació personalitzada.

Exploradors d'Analytics

Els membres tenen els mateixos permisos d'accés que els Usuarisd'Analytics. També poden accedir a Cognos Analysis For Microsoft Excel,

Figura 1. Estructura de grups i rols

2 IBM Cognos Analytics Versió 11.0: Manual d'usuari de gestió

Cognos Framework Manager, Cognos Cube Designer i Dynamic QueryAnalyzer, Transformer, i TM1 Writeback to bundled FLBI TM1 server.


Usuaris d'Analytics

Els membres tenen els mateixos permisos d'accés que els membresd'Information Distribution. Poden crear nous informes, panells d'eines,històries, noves feines, connexions de servidor de dades o mòduls dedades. Poden executar informes, respondre a solvlicituds, carregar fitxers.També poden accedir a Cognos for Microsoft Office, Cognos Workspace,Cognos Insight, Cognos Event Studio, Cognos Query Studio i CognosAnalysis Studio


AutorsEls membres d'aquest rol tenen els mateixos permisos d'accés que elsusuaris de Query i d'Analysis. Poden fer servidor la creació d'informes,Query Studio i Analysis Studio, així com desar contingut públic cominformes y sortides d'informes.

ConsumidorsEls membres d'aquest rol poden llegir i executar contingut públic, cominformes.

Administradors de directorisEls membres d'aquest rol poden administrar els continguts d'espais denoms. En l'espai de noms del Cognos, poden administrar grups, comptes,contactes, llistes de distribució, orígens de dades i impressores.

Information Distribution

ls membres tenen els mateixos permisos d'accés que els Usuaris de Query id'Analysis. Poden utilitzar Reporting, Query Studio i Analysis Studio, idesar contingut públic com ara informes i sortides d'informes.


Administradors de la bibliotecaEls membres d'aquest rol poden accedir, importar i administrar elscontinguts de la pestanya Biblioteca en l'IBM Cognos Administration.

Administradors de MobileEls membres d'aquest rol poden administrar aplicacions de l'IBM CognosMobile.

Usuaris de MobileEls membres d'aquest rol poden accedir a contingut de l'IBM Cognos, cominformes, mitjançant aplicacions de l'IBM Cognos Mobile.

ModeladorsEls membres d'aquest rol tenen accés a les capacitats de modelatge basaten web.

Administradors del portalEls membres d'aquest rol poden administrar els portlets de Cognos i altresportlets. Això inclou la personalització de portlets, la definició d'estils deportlets i l'establiment de permisos d'accés a portlets.

Capítol 1. Gestió de comptes 3

Administradors del PowerPlayEls membres d'aquest rol poden administrar el contingut públic per al quetenen accés complet. També poden administrar i utilitzar IBM CognosPowerPlay.

Usuaris del PowerPlayEls membres d'aquest rol tenen els mateixos permisos d'accés que elsconsumidors. També poden utilitzar IBM Cognos PowerPlay.

Usuaris de QueryEls membres d'aquest rol tenen els mateixos permisos d'accés que elsconsumidors. També poden utilitzar l'IBM Cognos Query Studio.

LectorsEls membres d'aquest rol tenen accés de només de lectura al programari del'IBM Cognos. Poden navegar per algunes parts del magatzem decontingut, visualitzar sortides d'informes desades al portal i utilitzaralgunes opcions d'informes com l'accés als detalls.

Administradors d'informesEls membres d'aquest rol poden administrar el contingut públic per al quetenen accés complet. També poden utilitzar l'IBM Cognos AnalysisReporting i l'IBM Cognos Query Studio.

Administradors de servidorEls membres d'aquest rol poden administrar servidors, assignadors itreballs.

Administradors del sistema

Els membres d'aquest rol es consideren usuaris root o usuaris súper. Podenaccedir i modificar qualsevol objecte del magatzem de continguts, ambindependència de qualsevol política de seguretat configurada per l'objecte.Només aquells membres que tinguin el rol d'administradors del sistemapodran modificar la pertinença a aquest rol.

la configuració inicial d'aquest rol inclou el grup Tots. Heu de modificar elsvalors de seguretat inicials per a aquest rol i eliminar el grup Tots de laseva pertinença. Si no modifiqueu la configuració inicial, tots els usuaristindran accés no restringit al magatzem de continguts.

Administradors d'arrendatarisEls membres d'aquest rol poden realitzar tasques d'administraciód'arrendataris. Aquest rol s'utilitza en un entorn de l'IBM Cognos demúltiples arrendataris. En la configuració inicial, aquest rol no té membresni capacitats. Els administradors del sistema són els únics que poden afegirmembres i assignar permisos d'accés i capacitats a aquest rol.

Creació i gestió de grups i rolsPodeu crear nous grups i rols a l'espai de noms Cognos. Aquests rols no depenendels proveïdors d'autenticació i només es poden gestionar a l'IBM CognosAnalytics.

Podeu afegir usuaris, grups o rols des de diversos espais de noms externs i des del'espai de noms Cognos com a membres dels grups i rols de Cognos.


Abans de començar

Si teniu pensat afegir entrades de diversos espais de noms com a membres delsgrups i rols de Cognos, inicieu sessió a cada espai de noms abans de començaraquesta tasca.

Quant a aquesta tasca

Quan suprimiu un grup o un rol de Cognos, els permisos d'accés dels usuaris quees basen en ell deixen d'estar actius. No podeu restaurar els permisos d'accésmitjançant la creació d'un grup o un rol amb el mateix nom.

Cal la funció d'administració Usuaris, grups i rols per gestionar comptes. Perobtenir més informació, consulteu l'apartat sobre funcions i característiquesprotegides a la guia d'administració i seguretat de l'IBM Cognos Analytics.

Procediment1. Feu clic a Gestiona > Comptes.2. Feu clic a l'espai de noms Cognos per obrir-lo.

3. Feu clic a la icona de grup nou

o de rol nou , escriviu un nomexclusiu a l'espai habilitat a tal efecte i premeu la tecla Intro. El grup o el rols'afegeix a la llista d'entrades de l'espai de noms Cognos.

Consell: També podeu crear grups i rols dins les carpetes. Feu clic a la icona

de carpeta nova

per crear una nova carpeta.4. Afegiu membres al grup o rol nou com s'indica a continuació:

a. Localitzeu el grup o rol nou a l'espai de noms Cognos. Per trobar l'entrada

ràpidament, feu clic a la icona de cerca

o feu clic a la icona de filtre per reduir les entrades visualitzades.

b. Al menú contextual del grup o del rol , feu clic a Mostra membres i feu

clic a la icona per afegir un membre .c. Al panell Afegeix membres, feu clic a l'espai de noms necessari i localitzeu

l'usuari, el grup o el rol que voleu afegir. Podeu afegir membres dequalsevol espai de noms o de diferents espais de noms al qual hagueuiniciat sessió. Si és necessari, feu servir les funcions de cerca i filtre pertrobar l'usuari, el grup o el rol que voleu afegir.

d. Seleccioneu els usuaris, grups o rols necessaris. Podeu seleccionar diversesentrades mitjançant la tecla Ctrl. Feu clic a D'acord. Les entradesseleccionades es visualitzen a la pestanya Membres.

e. Si voleu continuar afegint membres al grup o al rol, feu clic a la icona perafegir membres de la pestanya Membres i repetiu els passos c i d. Pereliminar un membre, apunteu al seu nom i feu clic a la icona per eliminar

.f. Tanqueu el panell de propietats.

El grup o el rol inclou ara els membres. També es pot afegir a un altre grupo rol.


Què cal fer posteriorment

Els menús contextuals de grup i de rol

proporcionen opcions per gestionaraquestes entrades. A Propietats, a la pestanya Permisos, podeu definir els permisosd'accés per als grups i els rols. L'opció Mostra membres també us permet d'afegiro eliminar membres d'un grup o un rol, i l'opció Afegeix a us permet d'afegirl'entrada a un altre grup o rol o bé a una carpeta. Per suprimir el grup o el rol, feuservir l'opció Suprimeix.

Creació i gestió d'usuarisPodeu crear usuaris en l'espai de noms Cognos si s'ha utilitzat l'opció Instalvlaciófàcil per instalvlar l'IBM Cognos Analytics.

Procediment1. Feu clic a Gestiona > Comptes.2. Feu clic a l'espai de noms Cognos per obrir-lo.

3. Feu clic a la icona d'usuari nou

i, al quadre de diàleg Nou usuari, escriviula informació necessària, inclosos l'ID d'usuari i la contrasenya. Feu clic aD'acord.El nom d'usuari rol s'afegeix a la llista d'entrades de l'espai de noms Cognos.Ara podeu afegir l'usuari a una carpeta, un grup o un rol. L'usuari pot iniciarsessió a l'IBM Cognos Analytics amb l'ID d'usuari i la contrasenya que li heuassignat.


El menú contextual d'usuari

conté opcions per gestionar l'entrada de l'usuari.A Propietats, a la pestanya General de la secció de propietats Avançades, podeucanviar la contrasenya d'usuari. També a Propietats, a la pestanya Permisos, podeudefinir els permisos d'accés per a l'usuari. L'opció Afegeix a us permet d'afegirl'usuari a un grup, rol o carpeta. Per suprimir l'usuari, feu servir l'opcióSuprimeix.

Personalització de rols

Si esteu utilitzant els rols predefinits a l'espai de noms de Cognos, podeupersonalitzar temes, pàgines d'inici i paràmetres d'informes que siguin exclusiusper cada rol de Cognos.

Nota: Només els rols de Cognos son personalitzables. No podeu personalitzar unrol si no pertany a l'espai de noms de Cognos, ja sigui com a rol predefinit deCognos o com a rol creat per l'usuari. Per obtenir més informació sobre els rols deCognos, consulteu la publicació IBM Cognos Analytics Administration and SecurityGuide.

Podeu especificar que es mostri una pàgina d'inici personalitzada, o un informe opanell d'eines particular, quan un usuari amb un rol de Cognos particular obri IBMCognos Analytics. Podeu eliminar les funcions de la interfície d'usuari per defecteper als rols. A més, podeu personalitzar els paràmetres que poden fer-se servir alsdiferents informes i adaptar-los a cada rol d'usuari.


Abans d'establir temes i pàgines inicials personalitzats (que no siguin un panelld'eines o un informe) heu d'haver creat i carregat els temes o les pàgines inicialspersonalitzats. Per obtenir més informació, consulteu: Capítol 8, “Personalització deCognos Analytics a tots els rols”, a la pàgina 61.

Per tal de personalitzar rols individuals, a Gestiona > Comptes, feu clic a un espaide noms per veure la llista de rols de l'espai de noms. Si feu clic en un rol, elpanell lliscant d'aquest rol contindrà una pestanya Personalització.

Nota: Si voleu establir personalitzacions a tots els rols, utilitzeu el panell lliscantGestió > Personalització. Per obtenir més informació, consulteu: “Gestió de temes,extensions, vistes i paràmetres” a la pàgina 90.

Establiment d'una pàgina inicial per defecte

Feu clic a

al costat de la pagina d'inici per defecte. Ja podeu navegar fins elpanell d'eines o l'informe que voleu com a pàgina inicial per defecte, o podeuseleccionar una vista de la llista de vistes perquè esdevingui la pàgina inicial perdefecte per a tots els usuaris d'aquest rol.

Eliminació de funcions

Podeu escollir les funcions de la interfície d'usuari que vulgueu eliminar pels

usuaris d'un rol. Feu clic a

al costat de Característiques. A continuació esmostra una llista de vistes. Aquesta llista inclou les vistes incorporades i les vistespersonalitzades que s'hagin carregat. Feu clic en una vista per veure l'agrupació de

funcions d'alt nivell de la vista. Feu clic a

al costat d'una agrupació per aampliar els detalls d'un nivell inferior de funcions. Podeu desseleccionar qualsevolfunció d'aquesta llista, o bé ampliar els detalls d'un altre conjunt de funcions perdesseleccionar-les. Feu clic a Aplica per desar els canvis. Podeu revertir els canvisfent clic a Restableix el valor per defecte.

Establiment d'un tema per defecte

Feu clic a

al costat del tema per defecte. Podeu seleccionar un tema de la llistade temes perquè esdevingui el tema per defecte per a tots els usuaris d'aquest rol.

Creació d'una carpeta personalitzada

Feu clic a

al costat de Carpeta personalitzada per definir una carpeta decontingut personalitzada pels usuaris amb aquest rol. Quan un usuari amb aquestrol inicia sessió, la carpeta personalitzada es visualitza a la barra de navegació sotaContingut d'equip.

Configurar paràmetre predeterminats per a rols

Feu clic a Configuració al costat de Paràmetres. Es mostre una llista delsparàmetres que heu personalitzat. Escolliu els paràmetres que voldreu configurar


per al rol. Després seleccioneu els valors predeterminats que desitgeu que esmostrin per a tots els usuaris d'aquest rol. Feu clic a Aplica i després a Acceptaquan hàgiu acabat.

Per obtenir més informació, consulteu Utilització de paràmetres personalitzats aCreació d'informes.

Resolució de conflictes quan un usuari té diversos rols

Un usuari pot tenir diversos rols amb temes o pàgines inicials per defectediferents. Per resoldre aquesta situació, a l'hora d'establir personalitzacions per aun rol, feu clic a Opcions avançades o definiu una prioritat pel rol entre 0 i 10. Encas que es produeixi un conflicte, s'utilitzaran les personalitzacions del rol quetinguin una prioritat més alta. El rol Administradors del sistema té una prioritatno modificable de 1000.

Proveïdors d'autenticacióL'autenticació d'usuari a l'IBM Cognos Analytics es gestiona mitjançant proveïdorsd'autenticació. Els proveïdors d'autenticació defineixen els usuaris, grups i rols ques'utilitzen per a l'autenticació. Els noms d'usuaris, els identificadors, lescontrasenyes, la configuració regional i les preferències personals són algunsexemples del tipus d'informació que s'emmagatzema als proveïdors.

A la interfície d'usuari del Cognos Analytics, els proveïdors d'autenticació es

representen mitjançant espais de noms .

El Cognos Analytics admet els tipus següents de proveïdors d'autenticació:v Active Directoryv OpenID Connectv Proveïdor Java personalitzatv Proxy d'autenticació de l'OpenID Connectv IBM Cognos Series 7v LDAPv SAPv SiteMinder

Els proveïdors d'autenticació es configuren a l'IBM Cognos Configuration, a lacategoria Seguretat > Autenticació. Després d'afegir aquí l'espai de noms delproveïdor i de reiniciar el servei IBM Cognos, el nom de l'espai de noms es mostraa Gestiona > Comptes, i els usuaris poden iniciar sessió al Cognos Analytics ambaquest espai de noms. Per obtenir més informació sobre la configuració delsproveïdors d'autenticació, consulteu la publicació IBM Cognos Analytics Installationand Configuration Guide.

No podeu crear usuaris, grups ni rols en els espais de noms dels proveïdorsd'autenticació des del Cognos Analytics. No obstant això, podeu afegir usuaris,grups i rols des d'aquests espais de noms als grups i rols en l'espai de nomsCognos.

Diversos espais de noms

Si hi ha diversos espais de noms configurats per al Cognos Analytics, alcomençament de la sessió caldrà que en seleccioneu un. No obstant això, aquesta


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cr_rptstd.doc/t_cr_rptstd_wrkdat_my_parameters.html

acció no us impedirà iniciar sessió a d'altres espais de noms més endavant en lasessió. Per exemple, si definiu permisos d'accés, potser us interessa fer referència ales entrades de diferents espais de noms. Per iniciar sessió en un altre espai denoms, no cal que finalitzeu la sessió de l'espai de noms que estigueu fent servir.Podeu tenir sessions iniciades a diversos espais de noms simultàniament.

El vostre inici de sessió principal és l'espai de noms i les credencials que utilitzeuper connectar-vos al començament de la sessió. Els espais de noms en els qualsinicieu sessió després i les credencials que hi utilitzeu es convertiran en els vostresinicis de sessió secundaris.

Quan suprimiu un dels espais de noms, podeu iniciar sessió amb un altre espai denoms. Si suprimiu tots els espais de noms excepte el del Cognos, no se ussolvlicitarà que inicieu sessió. Si l'accés anònim està habilitat, s'iniciarà la sessióautomàticament com a usuari anònim. Si l'accés anònim no està habilitat, nopodreu accedir a la pàgina d'inici de sessió. En aquest cas, feu servir el CognosConfiguration per habilitar l'accés anònim.

Gestió dels espais de noms de l'OpenID ConnectUtilitzeu el tipus d'espai de noms de l'OpenID Connect per implementarl'autenticació del OpenID Connect per a l'IBM Cognos Analytics.

El Cognos Analytics admet els tipus següents de proveïdors d'autenticaciód'OpenID Connect. Aquesta llista podria ampliar-se amb el temps:

11.0.6 i posteriorIBMid

11.0.7 i posteriorOkta

Google

ADFS (Active Directory Federation Services)

Azure AD (Active Directory)

Salesforce

PingFederate

Site Minder

IBMid és IBM Identity Service, una solució de gestió i accés d'identitat basada alnúvol que proporciona serveis d'identitat i d'inici de sessió únic per aplicacionsIBM.

Després de configurar un espai de noms OpenID Connect a l'IBM CognosConfiguration, tots els usuaris d'OpenID Connect tindran accés a Cognos Analytics.Quan els usuaris inicien la sessió, els seus noms es mostren automàticament al'espai de noms.

Como a administrador del sistema, pot ser que hagueu de limitar el nombred'usuaris que poden accedir al producte en funció del nombre de llicències o altresfactors. Per fer-ho, seguiu aquests passos opcionals:v Afegiu un nombre limitat d'usuaris a l'espai de noms de l'OpenID Connect.

Podeu afegir els usuaris d'un en un o importar diversos usuaris a partir d'unfitxer .csv. Per obtenir més informació, consulteu: “Creació del fitxer .csv” a lapàgina 11.


v Afegiu els usuaris de l'OpenID Connect a grups o rols de l'espai de noms delCognos.Mitjançant l'us dels grups i els rols del Cognos, podeu assignar ràpidament elspermisos d'accés necessaris per a diferents usuaris.

v IBM Cognos Configuration, a Seguretat > Autenticació, assigneu el valor TRUEa la propietat Restringeix l'accés als membres de l'espai de noms incorporat.Ara, només els membres de l'espai de noms del Cognos poden accedir alCognos Analytics.

Procediment1. Inicieu sessió a l'IBM Cognos Analytics com a administrador del sistema.2. Inicieu la sessió a l'espai de noms de l'OpenID Connect.3. Aneu a Gestiona > Comptes i obriu l'espai de noms de l'OpenID Connect.

4. Seleccioneu la icona per afegir usuaris

per afegir usuaris a l'espai denoms.v Per afegir un sol usuari, escriviu la seva adreça de correu electrònic i el seu

nom preferit i feu clic a Afegeix.v Per importar usuaris a partir d'un fitxer .csv, feu clic a Importa i seleccioneu

el fitxer. Per obtenir més informació, consulteu: “Creació del fitxer .csv” a lapàgina 11.El mateix fitxer .csv es pot importar moltes vegades. Si el compte d'usuari jaexisteix a l'espai de noms, s'actualitza. També podeu repetir la importació siles entrades importades prèviament semblen incorrectes.Repetiu aquest pas amb altres fitxers, si en teniu més d'un.

5. Afegiu els usuaris de l'OpenID Connect a grups o rols de l'espai de noms delCognos.a. Obriu l'espai de noms del Cognos i cerqueu el grup o el rol al qual voleu

afegir usuaris des de l'espai de noms de l'OpenID Connect.

b. Al menú contextual del grup o el rol , seleccioneu Propietats i, acontinuació, seleccioneu la pestanya Membres.

c. Feu clic a la icona .d. Al panell Afegeix membres, seleccioneu el vostre espai de noms de

l'OpenID Connect i després seleccioneu els usuaris que calgui. Podeuseleccionar diversos usuaris al mateix temps.

e. Feu clic a Afegeix. Els usuaris seleccionats es visualitzen a la pestanyaMembres.

f. Repetiu els passos per afegir els usuaris de l'OpenID Connect a altres grupso rols del Cognos.

6. Elimineu una entrada fent clic a Elimina al menú de context

al costat delgrup, rol o carpeta específics.

Resultats

Els usuaris que facin servir l'espai de noms de l'OpenID Connect per iniciar sessióal Cognos Analytics són redirigits a una pàgina d'inici de sessió externa a la qualpoden escriure les seves credencials. Si les credencials s'accepten, els usuaris podenaccedir al Cognos Analytics.


Creació del fitxer .csvEl fitxer .csv que conté la llista d'usuaris que cal importar a l'espai de noms del'OpenID Connect ha de tenir el format adequat per tal que la importació siguicorrecta.

La primera fila del fitxer és la capçalera. Aquesta fila ha de contenir la columnaemail i pot contenir les columnes opcionals següents: defaultName, businessPhone,faxPhone, givenName, homePhone, mobilePhone, pagerPhone, postalAddress, surname,userName.

Consell: Tots els noms de columnes són propietats de la classe de compte a l'IBMCognos Analytics. Els noms distingeixen entre majúscules i minúscules i s'hand'escriure exactament com s'especifica en aquest document.

La resta de files del fitxer contenen valors que corresponen a les columnesespecificades a la primera fila.

A continuació hi ha un exemple d'un fitxer .csv amb dos usuaris:v Fila 1: email,defaultName,givenName,surnamev Fila 2: [email protected],Andy Bergin,Andy,Berginv Fila 3: [email protected],Kirsten Vaughan,Kirsten,Vaughan

Podeu afegir tots els vostres usuaris en un sol fitxer .csv o bé podeu crear diferentsfitxers que continguin menys noms.

Un cop importat el fitxer, es defineix el valor de defaultName de l'usuari com esdescriu a continuació:v Si al fitxer .csv s'especifica defaultName, s'utilitza el nom.v Si al fitxer .csv no s'especifica defaultName, sinó que s'especifica givenName i

surname, es defineix el nom per defecte com a givenName surname.v Si no s'especifiquen defaultName, givenName i surname, s'utilitza email con a nom

per defecte.

Diversos usuaris poden tenir els mateixos nom i cognoms. Per evitar possiblesproblemes, especifiqueu un valor diferent de defaultName per als usuaris, o noespecifiqueu surname i givenName en aquests casos. També podeu modificar el valorde surname afegint-hi un caràcter únic o un número, com per exemple Simpson1 oSimpson2.

Cerca d'usuaris, grups i rolsCom a administrador, sovint haureu de localitzar els usuaris, grups o rols quegestioneu.

A la vista Espais de noms d'Comptes, veureu tots els espais de noms que estanconfigurats per utilitzar-los amb l'IBM Cognos Analytics i també l'espai de nomsdel Cognos. Només podeu navegar pels espais de noms al quals hagueu iniciatsessió i per l'espai de noms Cognos.

Cerca d'entrades

Un espai de noms pot contenir milers d'usuaris i molts grups, rols i carpetes, il'única manera de trobar aquestes entrades és mitjançant la funció de cerca que hiha a Comptes. Heu de cercar les entrades espai de noms a espai de noms, per la


qual cosa heu de seleccionar l'espai de noms primer i després fer clic a la icona de

cerca . La cerca també s'utilitza quan s'afegeixen membres de grups o rols,s'especifiquen permisos d'accés, etcètera.

Filtratge d'entrades

Podeu filtrar els usuaris, grups i rols per reduir el nombre d'entrades visualitzades.Quan l'utilitzeu amb la cerca, especifiqueu els criteris de filtre perquè la resposta

sigui més ràpida. Feu clic a la icona de filtre

i seleccione o desmarqueu lesopcions de filtre.


Capítol 2. Gestió del contingut

Els motius més freqüents per realitzar una còpia de seguretat i restaurar contingutsón quan es desitja moure contingut d'un entorn de prova a un entorn deproducció com a part del procés de desenvolupament d'aplicacions, o per prepararl'actualització a una nova versió del producte.

La capacitat d'administració Configura i gestiona el sistema és necessària pergestionar el contingut.

Planificació del desplegament

El procés de realitzar còpies de seguretat i restaurar contingut s'anomenadesplegament. Per a què els valors de seguretat funcionin en desplegar contingut,l'entorn d'origen i l'entorn de destinació han d'utilitzar els mateixos espais de nomsper a què les polítiques, usuaris, rols i grups també funcionin correctament. L'espaide noms de Cognos s'inclou en crear una còpia de seguretat. Assegureu-vos queels altres espais de nom necessaris es configurin a l'entorn de destinació abans derestaurar el contingut.

Si el desplegament forma part d'una actualització, abans de crear una còpia deseguretat podeu executar una comprovació de coherència per a cercarinconsistències d'esmenes dins del magatzem de continguts o entre el magatzem decontinguts i els espais de noms externs. Executeu una comprovació de coherènciades de la Consola d'administració > Configuració > Administració de contingut >Nova comprovació de coherència.

Còpies de seguretat de contingut

Per protegir la informació confidencial, es xifren totes les còpies de seguretat. Enrestaurar el contingut, heu de proporcionar la contrasenya establerta en crear lacòpia de seguretat.

La còpia de seguretat es desa com un fitxer d'arxiu (.zip) en la Ubicació de fitxersde desplegament especificada a Cognos Configuration. La ubicació per defecte ésubicació_instalvlació\deployment. Per desplegar el magatzem de continguts en unainstància diferent del IBM Cognos Analytics, com el sistema utilitzat per a l'entornde producció, copieu el fitxer d'arxiu en la ubicació dels fitxers de desplegament enel sistema de destinació perquè el fitxer estigui disponible per a la seva restauració.

Una còpia de seguretat inclou el següent contingut.v carpetes públiquesv paquetsv informesv orígens de dadesv llistes de distribució i contactesv configuració d'impressorav valors del permís d'accésv l'espai de noms del Cognosv especificacions de desplegament

13

Les entrades personals de cada usuari, com informes i carpetes des de El meucontingut de l'usuari, no s'inclouen en la còpia de seguretat.

Restauració de contingut

Per restaurar contingut, el fitxer de còpia de seguretat que voleu utilitzar ha d'estaren la Ubicació dels fitxers de desplegament especificada a Cognos Configuration.La ubicació per defecte és ubicació_instalvlació\deployment. Heu d'indicar lacontrasenya que es va configurar en crear la còpia de seguretat.

En restaurar contingut, el contingut del magatzem de contingut de destinaciós'elimina i es substitueix pel contingut del magatzem de contingut d'origen.


Capítol 3. Connexions del servidor de dades

Un servidor de dades defineix la connexió física a una base de dades.

La connexió de servidor de dades especifica els paràmetres que es necessiten perestablir la connexió amb la base de dades, com ara la ubicació de la base de dadesi els temps d'espera. Una connexió de servidor de dades pot incloure informaciód'autenticació.

L'IBM Cognos Analytics admet diverses fonts de dades relacionals i OLAP. La llistade tipus de fonts de dades admeses pot canviar de versió a versió. Per obtenirinformació sobre les fonts de dades actualment admeses, consulteu el lloc webEntorns de programari suportats (www.ibm.com/support/docview.wss?uid=swg27047186) .

Si afegiu informació d'autenticació de base de dades, com les credencials delCognos Analytics o un inici de sessió per a la connexió, no cal que els usuarisespecifiquin informació d'autenticació de base de dades cada vegada que s'utilitzila connexió. L'inici de sessió generat en crear una connexió del servidor de dadesestà disponible en el grup Tots de manera predeterminada. Podeu modificar elspermisos d'inici de sessió des de les propietats de la connexió del servidor dedades.

Creació d'una connexió amb un servidor de dadesUna connexió amb un servidor de dades especifica els paràmetres que esnecessiten per connectar-vos a la base de dades a la qual representa la connexió.

Cada servidor de dades pot tenir una o més connexions. Els noms de lesconnexions han de ser únics.

Abans de començar

La majoria de connexions del servidor de dades requereixen un controlador JDBCfacilitat pel proveïdor de bases de dades. Utilitzeu una versió del controlador JDBCque sigui compatible amb Java™ Runtime Environment versió 8. Copieu elcontrolador al directori Cognos Analytics ubicació_instalvlació\drivers ireinicieu el servei de consulta. No és necessari reiniciar el servei IBM Cognoscomplet.

Per crear connexions de servidor de dades, necessiteu la capacitat d'administracióConnexions de font de dades. Per obtenir més informació, consulteu la publicacióGuia d'administració i seguretat de l'IBM Cognos Analytics.


La interfície d'usuari Gestionar > Connexions de servidor de dades no disposadels controls necessaris per definir les següents característiques de connexió:v Blocs d'ordres de connexióv Connexions fiables de Db2 LUW, Db2 for z/OS, dashDB, IBM Big SQLv Propagació d'identitats del Db2 for z/OSv Connexions de l'ORACLE Lightweight (es necessiten blocs d'ordres)

15

http://www.ibm.com/support/docview.wss?uid=swg27047186

Per a definir connexions que incloguin aquestes característiques, utilitzeu laConsola de administració. Per obtenir més informació, consulteu la Guiad'administració i de seguretat de l'IBM Cognos Analytics.

Procediment1. Feu clic a Gestiona > Connexions del servidor de dades.2. En el panell Connexions del servidor de dades, feu clic sobre la icona Afegeix

servidor de dades .3. Selecioneu el tipus de servidor de dades de la llista de tipus admesos.4. En el camp Nova connexió de servidor de dades, escriviu un nom exclusiu per

a la connexió.5. Al costat de Detalls de connexions, feu clic a Editar i introduïu els detalls de la

connexió per al tipus de connexió que esteu creant.A la majoria de les connexions, haureu d'especificar l'URL JDBC. Podeuvisualitzar la sintaxi i un URL d'exemple a detalls de la connexió. És possibleque necessiteu demanar més detalls a l'administrador de bases de dades, ocaldrà comprovar la documentació del proveïdor de base de dades.En el quadre Propietats de connexió, escriviu el nom de la propietat admesa.Per obtenir informació sobre les propietats JDBC, consulteu “Paràmetres deconnexió específica de Cognos” a la pàgina 17. Per a connexions de PlanningAnalytics, especifiqueu el host de base de dades TM1 i el número de portHTTP. Per utilitzar una connexió SSL, seleccioneu el quadre de selecció UtilitzaSSL.

6. A Mètode d'autentificació, especifiqueu com accedir al servidor de dades.Podeu seleccionar una de les següents opcions.

Connectar-se anònimament o seguretat integradaSeleccioneu la opció Connectar-se anònimament quan es permetil'accés anònim al servidor de dades.

Feu servir l'opció Seguretat integrada quan la base de dades TM1 s'haconfigurat per al mode de seguretat integrat 4 o 5. Aquesta opciónomés es pot aplicar a connexions de Planning Analytics.

Solvlicitar l'identificador d'usuari i la contrasenyaSeleccioneu aquesta opció quan s'hagi de solvlicitar a l'usuari lescredencials de la base de dades en cada ús.

Utilitzeu les credencials de l'IBM Cognos AnalyticsEscolliu aquesta opció per passar les mateixes credencials al servidor dedades que s'utilitza per autenticar-se a Cognos Analytics.

Utilitzar l'inici de sessióSeleccioneu aquesta opció per assignar un inici de sessió per a laconnexió. Seleccioneu un inici de sessió de la llista desplegable o creeu

un nou inici de sessió prement la icona Afegeix . A la finestra Novaconnexió del servidor de dades a la pestanya Credencials, escriviu unID d'usuari i una contrasenya. Per restringir l'inici de sessió a usuaris,

rols o grups determinats, a la pestanya Permisos feu clic a iespecifiqueu els permisos d'accés necessaris per a l'inici de sessió.

7. Feu clic a Prova per verificar que funciona la connexió del servidor de dades idesprés feu clic a Desa per desar la nova connexió de servidor de dades.


Resultats

El nom de la connexió nova es visualitza al panell Connexions del servidor dedades. Per editar la connexió del servidor de dades, i també afegir o modificar elseu inici de sessió, premeu el nom de la connexió.

Paràmetres de connexió específica de CognosPodeu especificar alguns paràmetres específics de Cognos opcionals per aconnexions JDBC.

Podeu especificar aquests paràmetres en crear o actualitzar connexions JDBC per afonts de dades a l'IBM Cognos Administration o l'IBM Cognos FrameworkManager o en crear o actualitzar connexions de servidors de dades a la interfícied'administració Gestionar > Connexions de servidor de dades a IBM CognosAnalytics versió 11.0.x.

En editors de connexió diferents, aquests paràmetres poden especificar-se com aPropietats de connexió o paràmetres de connexió JDBC.

ibmcognos.fetchBufferSize

Aquest paràmetre s'utilitza per establir la mida de recuperació del controladorJDBC per a connexions de fonts de dades aIBM Cognos Analytics.

Quan el mode de consulta dinàmic a IBM Cognos Analytics executa consultesutilitzant JDBC, el valor de la mida de recuperació que es passa a un controladorJDBC es calcula dinàmicament. El suport per obtenir mides depèn dels proveïdorsde bases de dades. Els proveïdors també decideixen quina és la la mida quesignifica la mida de recuperació, i el que la mida de la recuperació és quans'utilitza internament en el controlador i el servidor. Per a obtenir més detalls,consulteu la documentació JDBC del vostre proveïdor.

El mode de consulta dinàmic calcula un valor per a una consulta utilitzant lasegüent fórmula maximum( (bufferSize / 'row-size'), 10)

El valor per defecte de la mida de la memòria intermèdia és de 100 kilobytes (KB).La mida de la fila es calcula a partir de la mida de les columnes projectades pelconjunt de resultats en una consulta. Les consultes que projecten columnes ambgran precisió o projecten moltes columnes usen una mida d'obtenció menor queaquelles que projecten menys columnes o columnes amb menor precisió.

Si la recuperació d'un conjunt de resultats es pot millorar considerablementmitjançant l'ús d'una mida de memòria intermèdia més gran, un administrador deCognos pot especificar la propietat de connexió ibmcognos.fetchBufferSize. Elmode de consulta dinàmica ajusta automàticament el valor si és inferior a 10kilobytes o superior a 10 megabytes.

Si ibmcognos.fetchBufferSize > 1024 * 10240 a continuació bufferSize = 1024 * 10240

Si ibmcognos.fetchBufferSize < 10240 a continuació bufferSize = 10240

No sempre es recomana que les mides d'obtenció siguin més grans, ja que podenaugmentar el consum de memòria del controlador JDBC i no conduir a unrendiment millorat. Reviseu sempre la documentació del proveïdor de base de

Capítol 3. Connexions del servidor de dades 17

dades i les pràctiques recomanades abans d'utilitzar valors grans per a la propietatibmcognos.fetchBufferSize.

ibmcognos.decfloat

Quan s'especifica aquest paràmetre, el mode de consulta dinàmica està destinat autilitzar un tipus de flotant decimal, DECFLOAT 128, que representa amb precisióvalors amb una precisió de fins a 34 dígits. Quan es detecta una columna amb granprecisió, es canvia internament a DECFLOAT i el tipus de dades del model ol'informe es descriu com DECIMAL (0,0).

Per habilitar aquesta característica, especifiqueu el paràmetre de connexióibmcognos.decfloat=true per a la connexió de base de dades que utilitza el modede consulta dinàmic. En els models existents, les columnes s'han de tornar a aplicara DECIMAL (0,0) en lloc de duplicar-les.

Per a què el mode de consulta dinàmica llegeixi les files retornades per unaconsulta, el controlador JDBC ha de retornar els valors de columna utilitzant untipus de dades Java específic. En versions anteriors, era possible que una base dedades com ORACLE retornés una columna numèrica on la precisió feia que laconsulta dinàmica utilitzés el tipus de dades doble. Quan els valors retornats peruna consulta tenien una precisió superior a 16 dígits, la conversió podria provocarun valor incorrecte.

Per exemple, si una columna d'ORACLE s'ha definir com a NUMBER (senseindicar la precisió) o una agregació com SUM s'ha calculat de forma que ORACLEl'ha retornat com a NUMBER, el valor retornat de 1234567890123456789 es potconvertir en el valor 1,23456789012345677E18. Els dos valors no són el mateix.

Si la base de dades no retorna valors grans, no utilitzeu aquest paràmetre iassegureu-vos que els models no inclouen columnes amb el tipus de dadesDECIMAL (0,0). Això permet que el mode de consulta dinàmica utilitzi un tipus dedades que requereix menys memòria que el tipus DECFLOAT.

ibmcognos.qualifier_list

Aquest paràmetre s'utilitza per desambiguar metadades quan s'executen consultesdinàmiques. Assigna una llista d'un o més qualificadors a fonts de dades que esdefineixen a IBM Cognos Analytics.

Els següents exemples mostra la sintaxi que cal utilitzar en especificar el paràmetreibmcognos.qualifier_list i els valors que es poden assignar al mateix:v ibmcognos.qualifier_list=CATALOG1.SCHEMA1, CATALOG2.SCHEMA2v ibmcognos.qualifier_list=SCHEMA1, SCHEMA2v ibmcognos.qualifier_list=CATALOG1.SCHEMA1, SCHEMA2v ibmcognos.qualifier_list=CATALOG1, CATALOG2

Un període del qualificador s'utilitza per separar els components del catàleg il'esquema. Si no hi ha cap període i la base de dades admet esquemes, el valor estracta com un esquema. En cas contrari, el valor es tracta com un catàleg, si la basede dades admet catàlegs.

El servei de consultes busca la llista en l'ordre especificat i utilitza les metadadesde columna que troba per al primer qualificador coincident. Si no es troba capcoincidència, es genera un error de metadades ambigu.


L'administrador ha de confirmar que la llista de qualificadors proporcionats per aaquest paràmetre és idèntica en ordre i contingut a qualsevol llista de cerca que lasessió de base de dades de l'usuari pugui haver definit. La llista de qualificadorsnomés s'aplica quan la sessió intenta desambiguar les metadades retornades per uncontrolador JDBC. Els noms qualificats de les sentències SQL dinàmiquesreflecteixen els valors assignats a les propietats del catàleg o de l'esquema quel'origen de dades del paquet ha utilitzat durant la planificació de consultes.

ibmcognos.authentication

Aquest paràmetre s'utilitza per configurar connexions de fonts de dades quans'utilitza l'autenticació de Kerberos.

Per a tipus de connexió a font de dades diferents, especifiqueuibmcognos.authentication=java_krb5 i, a continuació, les propietats que elcontrolador JDBC necessita per a l'autenticació de Kerberos, si resulten necessàries.Els següents exemples mostren com especificar aquest paràmetre per a algunesconnexions de fonts de dades:v Per a connexions de Teradata, especifiqueu

ibmcognos.authentication=java_krb5;LOGMECH=KRB5;

v Per a connexions de SAP-HANA, especifiqueuibmcognos.authentication=java_krb5;

v Per a connexions de Microsoft SQL Server, especifiqueuibmcognos.authentication=java_krb5;authenticationScheme=JavaKerberos;

ibmcognos.maxvarcharsize

La consulta dinàmica pot utilitzar un valor de precisió VARCHAR superior alvalor per defecte que suporta la base de dades. Aquest paràmetre substitueix elvalor de precisió de base de dades per defecte VARCHAR per al mode de consultadinàmica.

Per especificar aquest paràmetre, utilitzeu la sintaxis següent, on N és un valorenter superior a zero al que dóna suport el proveïdor de base de dades:ibmcognos.maxvarcharsize=N

L'estàndard SQL utilitza el tipus de dades CLOB i el tipus NCLOB (NationalCharacter Large Object Type) per valors de caràcters superiors. Altres bases dedades donen suport al tipus de dades CLOB o a les seves pròpies versionsd'aquest tipus amb característiques similars. El tipus de dades CLOB imposarestriccions dels tipus de construccions SQL que es poden utilitzar en les consultes.A més, els proveïdors de base de dades poden imposar restriccions addicionals pergestionar les columnes CLOB en les interfícies de client, com JDBC. Per evitar lesrestriccions relacionades amb CLOB, el mode de consultes dinàmiques converteixautomàticament les columnes CLOB en columnes VARCHAR utilitzant la funcióCAST. Com a resultat, els primers N caràcters del tipus CLOB es retornen comVARCHAR en la consulta dinàmica.

Consell: No es realitza el CAST automàtic quan un controlador JDBC descriu lacolumna com VARCHAR i no com CLOB i quan la referència de columna té unCAST especificat per l'usuari al voltant.

Si la longitud d'un CLOB d'una fila és major que les dades de precisió de CAST, estrunca.


En alguns casos, el proveïdor de base de dades pot donar suport a unaespecificació superior si es compleixen els paràmetres de configuració de base dedades específics, tals com els paràmetres de mida de fila, pàgina o servidor. Si escompleixen aquestes condicions prèvies, podeu especificar un valor superior enuna connexió de servidor de dades. Si no es compleixen les condicions prèvies, iutilitzeu un valor superior al valor suportat per la base de dades, les sentènciesSQL no s'executen correctament. Abans d'utilitzar valors de VARCHAR superiors,consulteu la documentació del proveïdor de base de dades i verifiqueu el valoramb l'administrador de base de dades.

La consulta dinàmica utilitza els següents valors de precisió VARCHAR per defecteper a les diferents bases de dades:

Taula 1. Valors de precisió VARCHAR per defecte del mode de consulta dinàmica

Base de dades Valor de precisió VARCHAR per defecte

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

Altres proveïdors 1024

Si el valor de ibmcognos.maxvarcharsize és superior al valor màxim de Java(2147483647), o no és un enter, s'omet el valor.

Si el valor de ibmcognos.maxvarcharsize és inferior al valor per defecte 1024 i a lamida de VARCHAR del proveïdor, s'utilitza el valor més baix d'aquests 2 valors,en lloc del valor ibmcognos.maxvarcharsize.

Precàrrega de metadades des d'una connexió de servidor de dadesQuan s'especifica un servidor de dades com a font per a un mòdul de dades, lesmetadades es carreguen al Content Store des del servidor de dades. Aquest procéspot ser molt llarg; podeu precarregar les metadades si voleu que sigui més ràpid.

Les metadades precarregades acceleren el modelatge de dades donat què permetque el sistema especifique de forma intelvligent els valors predeterminats, com araÚs i Agregació, basats en les metadades que s'hagin carregat.


Procediment1. Feu clic a Gestiona > Connexions del servidor de dades. El panel lliscant

visualitza una llista de connexions de servidor de dades.2. Al panell Connexions del servidor de dades, feu clic a una connexió de

servidor de dades i després, a la pestanya Connexions, feu clic a un nom deconnexió.

3. A la pestanya Esquemes, feu clic a Més al costat d'un nom d'esquema percarregar dades o modificar les opcions de càrrega.

4. Feu clic a Opcions de càrrega per modificar la quantitat de dades que escarreguen.A la pestanya Taules podeu indicar quines taules es precarreguen.

5. Feu clic a Carrega metadades per carregar les metadades.6. Si les metadades d'un esquema ja estan carregades, feu clic a Esborra

metadades per eliminar les metadades del Content Store.

Referència i resolució de problemesEn crear i actualitzar servidors de dades a IBM Cognos Analytics, és possible queus trobeu amb problemes amb controladors JDBC, el suport de la versió delservidor de dades, l'autenticació, etc.

La informació de la connexió és diferent per a cada tipus de servidor de dades. Perobtenir més informació, consulteu la documentació del proveïdor de base dedades.

Controladors JDBC de Cloudera ImpalaIBM Cognos Analytics admet connexions al servidors de dades de ClouderaImpala que fan servir controladors JDBC, versió 2.5.34 i posteriors. No s'admetenels controladors JDBC anteriors a la versió 2.5.34.

En intentar establir la connexió amb Cloudera Impala, el motor de consultescomprova la versió del controlador JDBC. Si la versió és anterior a la 2.5.34, elsistema retorna un missatge d'error.

Per evitar potencials problemes, substituïu les versions més antigues delscontroladors JDBC per Impala en l'entorn del Cognos Analytics per versions mésrecents. El controlador es pot baixar des del lloc web de Cloudera(www.cloudera.com/downloads/connectors/impala/jdbc/2-5-34.html). Per obtenirinformació, consulteu la documentació de Cloudera.

Consultes estancades en el motor Pivotal HDBLes consultes es poden estancar en el motor Pivotal HDB a causa d'un defecte enl'optimitzador central.

Per resoldre el problema, l'administrador de Pivotal por canviar els valors perdefecte del servidor o afegir el següent bloc d'ordres per a la connexió amb l'IBMCognos Administration.<commandBlock>

<commands><sqlCommand>


http://www.cloudera.com/downloads/connectors/impala/jdbc/2-5-34.html

<sql>select disable_xform(’CXformExpandNAryJoinDP’)</sql></sqlCommand></commands>

</commandBlock>

Si s'ha creat una taula a l'HDB amb particionament, el controlador JDBC de Pivotalretorna metadades a cada partició de la taula. Actualment, no hi ha cap mitjà en elprogramari Pivotal per impedir el retorn de les metadades addicionals. No cal queun modelador de IBM Cognos Analytics inclogui les metadades addicionals per aque funcionin les consultes.

Servidors de dades de Denodo 5.5 i 6.0Els tipus de servidors de dades 5.5 i 6.0 de Denodo són admesos pel controladorJDBC de Denodo.

La versió mínima admesa de Denodo 5.5 és l'actualització 20160322 que ha de teniraplicada l'esmena #26682. No s'admeten versions anteriors de Denodo 5.5.

La versió inicial de Denodo 6.0 GA requereix que s'apliqui l'esmena #26681 deDenodo.

Denodo requereix un controlador JDBC 6.0 en accedir a un servidor 6.0 i uncontrolador JDBC 5.5 en accedir a un servidor 5.5.

Els controladors JDBC de Denodo 5.5 no eviten les connexions amb un servidor6.0. Si es produeix aquesta situació, és possible que el servidor 6.0 generiexcepcions en executar consultes o intentar importar metadades.

Fonts de dades que ja no reben suport a Cognos AnalyticsAlgunes fonts de dades ja no reben suport a IBM Cognos Analytics.

Totes les connexions de fonts de dades definides en versions anteriors d'CognosAnalytics romanen al magatzem de continguts fins que s'eliminen manualment oes canvien per un altre tipus de suport, si és necessari. Aquestes connexions sonvisibles a les interfícies d'administració del producte. Quan aquestes connexionss'obren a IBM Cognos Administration, apareixen a l'editor de connexió amb eltipus Altres tipus. Aquest editor de connexió proporciona una interfície limitadaper veure o editar connexions, i per accedir als inicis de sessió associats.

Cada connexió de fonts de dades del emmagatzemament de continguts estàrepresentada per una cadena amb diversos noms i valors personalitzats. Aquestacadena és visible als editors de connexions a Cognos Analytics. Per exemple, alprovar una connexió, apareix una cadena com aquesta:^User ID:^?Password:;LOCAL;PG;DSN=NomFontDades;UID=%s;PWD=%s;MyODBCDSN@ASYNC=0@0/0@COLSEQ=

El tipus de connexió a la cadena es mostra després del valor LOCAL. A l'exempleanterior, el tipus de connexió es PG.

Si la vostra versió actual de Cognos Analytics utilitza connexions a fonts de dadesque ja no reben suport, en alguns casos podeu canviar les connexions als tipussuportats.


Cognos Analytics 11.0.8

Les fonts de dades següents no reben suport a partir de la versió 11.0.8:v Hitachi Advanced Data Binder Platform (JDBC)v IBM Domino (JDBC)v MongoDB Connector for BI versió 1

Actualitzeu les connexions de la versió 1 per tal que es faci servir MongoDBConnector for BI versió 2.2.1. Actualitzeu també els models de Cognos actualsquan estigui connectat a la versió 2.2.1. D'aquesta manera es garanteix que lesmetadades de model reflecteixin les diferències dels tipus de dades i d'escalaque es varen introduir a MongoDB Connector for BI 2.2.1.


Les fonts de dades següents no reben suport a partir de la versió 11.0.6:v Actian Matrix (ODBC i JDBC)

Poden utilitzar-se tipus de connexió ODBC genèrics per fer referència a unODBC DSN que faci servir un controlador ODBC en sistemes operatiusMicrosoft Windows per tal d'accedir a un servidor Actian Matrix. No podreuutilitzar una connexió JDBC actual.

v Actian Vector (ODBC)Poden utilitzar-se tipus de connexió ODBC genèrics per fer referència a unODBC DSN que faci servir un controlador ODBC en sistemes operatiusMicrosoft Windows per tal d'accedir a un servidor Actian Vector.

v IBM® IMS™ (JDBC)


Les fonts de dades següents ja no reben suport a partir de la versió 11.0.3:v IBM Cognos Finance - tipus de connexió CLv Microsoft SQL Server Analysis Services 2005 i 2008 (ODBO) - tipus de connexió

YK i M8Les aplicacions dels sistemes operatius Windows han d'utilitzar el client ODBOque es publica amb la versió Microsoft Analysis Services suportada. Lesaplicacions que no son de plataformes Windows poden fer servir una connexióXMLA (tipus de connexió X8). Les versions dels clients ODBO que tenen SQLServer Analysis Services 2005, 2008 y 2008 R2 ha no reben suport. Es donasuport a les connexions per a les versions 2012 (tipus de connexió M12) i 2014(tipus de connexió M14). Les noves connexions que fan referència als clients2012 o 2014 només han d'utilitzar-se per a la versió 2012 i 2014 dels servidorsSQL Server Analysis Services corresponents.A partir de Cognos Analytics 11.0.0, només els servidors del mode de consultesdinàmiques donen suport a SQL Server Analysis Services. El mode de consultescompatible no dona suport a SQL Server Analysis Services.

v Microsoft SQL Server 2005 i 2008 Native Clients, i OLE DB (tipus de connexióOL i Provider=SQLNCLI o SQLNCLI10)Les versions anteriors de les biblioteques de client Microsoft SQL Server ja noreben suport ( https://msdn.microsoft.com/en-us/library/cc280510.aspx). Perles aplicacions que han d'accedir a SQL Server a través de la BD OLE, podeuutilitzar les connexions Native Client que inclouen Provider=SQLNCLI11.Aquestes connexions son paralvleles a la versió actual 11 de SQL Server Native


https://msdn.microsoft.com/en-us/library/cc280510.aspx

Client que rep suport amb SQL Server 2016, 2014 i 2012. Com alternativa espoden utilitzar connexions que fan servir el controlador Microsoft ODBC forSQL Server.

v SAP ECC


Les fonts de dades següents ja no reben suport a partir de la versió 11.0.2:v Composite (ODBC)

Composite (tipus de connexió CS): es poden utilitzar tipus de connexió ODBC(OD) genèrics per fer referència a un ODBC DSN que faci servir un controladorODBC en sistemes operatius Windows per tal d'accedir a servidors Siebel. Elmode de consulta dinàmica dona suport a diverses tecnologies, como ara CiscoInformation Server i Denodo a través de JDBC que es podrien fer servirpotencialment per proveir accés federat als sistemes Siebel.

v IBM Cognos Now! - Real-time Monitoring Cube (tipus de connexió LA)No hi ha cap tipus de connexió alternatiu en aquest cas.

v IBM Cognos Planning - Series 7 (tipus de connexió CR)No hi ha cap tipus de connexió alternatiu en aquest cas.

v IBM Cognos Virtual View Manager (ODBC)v IBM Red Brick® (ODBC)v Progress OpenEdge (ODBC)v Siebelv Sybase Adaptive Server Enterprise (CT-Lib)

Actualitzacions per versióCognos Analytics dona suport a molts servidors de dades diferents. En versionsdiferents, s'agreguen, modifiquen o eliminen servidors de dades.

Per tal de veure una llista actualitzada de servidors de dades que reben suport perversions específiques de Cognos Analytics, aneu a la pàgina IBM Cognos Analytics11.0.0 Supported Software Environments. En la secció de la versió, per exemple11.0.8, feu clic en un dels enllaços següents per veure un informe al detall de lesfonts de dades suportades:v A Requisits per tipus, feu clic a l'enllaç Software. A la pestanya Programari

suportat, aneu a la secció Fonts de dades. A la taula trobareu llistades totes lesfonts de dades suportades.

v A Requisits per plataforma, feu clic al nom del sistema operatiu, com ara Linux.A la pestanya Programari suportat, aneu a la secció Fonts de dades. A la taulatrobareu llistades totes les fonts de dades suportades al sistema operatiu escollit.

Cognos Analytics 11.0.13 - característiques noves imodificades

IBM Cognos Analytics dona suport al controlador JDBC de Amazon Athena1.1.1001. El nou controlador no dona suport a les propietats de nom de controladori connexió a les que donava suport el controlador anterior (1.1.0).

Controlador Amazon Athena JDBC 1.1.1001

El controlador 1.1.1001 utilitza un nom de classe de controlador diferent per a cadaimplementació de 4.0, 4.1 i 4.2 proporcionada. Les connexions existents han de ser




actualitzades perquè el nom de la classe de controladorcom.amazonaws.athena.jdbc.AthenaDriver sigui un dels noms d'aquestes classes decontrolador, si s'aplica.v com.simba.athena.jdbc4.Driverv com.simba.athena.jdbc41.Driverv com.simba.athena.jdbc42.Driver

El controlador 1.1.1001 utilitza diferents noms per a rebre la regió Amazon i elgrup de sortida S3.

Nota: Les connexions existents s'han d'actualitzar per passar les propietatsAwsRegion i S3OutputLocation necessàries. Per a obtenir més detalls delcontrolador Amazon Athena JDBC, consulteu la documentació de Amazon AthenaJDBC i les notes de lliurament: https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html

Cognos Analytics 11.0.9 - característiques noves i modificadesEls canvis suposen una millora en el rendiment del servidor IBM Cognos Analyticsi garanteixen el compliment amb els productes de la base de dades suportats.

Connexions Teradata JDBC - concurrència millorada deconsultes

S'ha canviat el mode de consultes dinàmiques per garantir que només s'executauna consulta a la connexió Teradata JDBC. Aquest canvi millora la concurrència deconsultes, tal com està descrit a la secció de diversos fils de Teradata JDBC DriverReference.

Els administradors de bases de dades que supervisen les càrregues de treball de lesseves bases de dades poden observar un augment en el nombre de connexions debases de dades en comparació amb les versions anteriors de Cognos Analytics.

Connexions Snowflake - nom de classe de controlador modificat

En versions anteriors d'Cognos Analytics, el nom de classe de controladorpredeterminat per les noves connexions Snowflake eracom.snowflake.client.jdbc.SnowflakeDriver. A partir de Cognos Analytics versió11.0.9, el nom de classe del controlador predeterminat de les noves connexionsSnowflake és net.snowflake.client.jdbc.SnowflakeDriver.

Les connexions actuals continuaran fent referència a la classe de controladorcom.snowflake.client.jdbc.SnowflakeDriver. Quan Snowflake elimina aquest nomde classe del controlador, les connexions requereixen que la propietat Nom declasse del controlador canvii a net.snowflake.client.jdbc.SnowflakeDriver.

Consell: Per editar una connexió de servidor de dades, aneu a Gestiona >Consola d'administració. A la pestanya Configuració, seleccioneu Connexions defonts de dades. Cerqueu la connexió del servidor de dades i obriu-la. No podeueditar connexions actuals des de Gestiona > Connexions del servidor de dades.


https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html

https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html

https://developer.teradata.com/doc/connectivity/jdbc/reference/current/jdbcug_chapter_2.html#BGBEFIH4

https://developer.teradata.com/doc/connectivity/jdbc/reference/current/jdbcug_chapter_2.html#BGBEFIH4

Connexions Amazon Redshift - nom de classe de controladormodificat

En les versions anteriors de Cognos Analytics, el nom de classe de controladorpredeterminat de les noves connexions d'Amazon Redshift eracom.amazon.redshift.jdbc41.Driver, què requeria el fitxer RedshiftJDBC41.*.jar.

A partir de Cognos Analytics versió 11.0.9, el nom de classe de controladorpredeterminat per les noves connexions d'Amazon Redshift éscom.amazon.redshift.jdbc.Driver. Aquest nom de classe de controlador s'utilitzaal controlador Amazon JDBC versió 1.2.1 o posterior. El fitxer de controladorassociat és RedshiftJDBC.jar.

Podeu actualitzar les connexions actuals canviant la propietat Nom de classe decontrolador per com.amazon.redshift.jdbc.Driver.

Consell: Per editar una connexió de servidor de dades, aneu a Gestiona >Consola d'administració. A la pestanya Configuració, seleccioneu Connexions defonts de dades. Cerqueu la connexió del servidor de dades i obriu-la. No podeueditar connexions actuals des de Gestiona > Connexions del servidor de dades.

Es poden utilitzar connexions PostgreSQL amb Amazon AuroraPostgreSQL

A partir d'aquesta versió, podeu fer servir l'editor de connexions PostgreSQL i elcontrolador JDBC per crear i mantenir connexions de servidor de dades ambAmazon Aurora PostgreSQL.

Cognos Analytics 11.0.8 - noves característiquesS'ha afegit suport addicional a l'IBM Cognos Analytics per als següents servidorsde dades: MongoDB Connector for BI 2.2.1, Spark SQL 2.1 Thrift Server, AzureSQL Data Warehouse, Amazon Redshift i Amazon Athena.

MongoDB Connector for BI 2.2.1

Cognos Analytics dona suport a MongoDB Connector for BI versió 2.2.1 a travésdel controlador MySQL JDBC requerit per MongoDB. MongoDB Connector for BI2.2.1 no utilitza la tecnologia de servidor ni el controlador Postgres JDBC peraccedir als servidor MongoDB 3.x.

MongoDB Connector for BI versió 1 ja no està suportat. Actualitzeu les connexionsde la versió 1 per tal que es faci servir la versió nova. Actualitzeu també elsmodels de Cognos actuals quan estigui connectat a la versió 2.2.1. D'aquestamanera es garanteix que les metadades de model reflecteixin les diferències delstipus de dades i d'escala que es varen introduir a MongoDB Connector for BI 2.2.1.

Servidor Spark SQL 2.1 Thrift

Cognos Analytics dona suport al servidor Spark SQL 2.1 Thrift a través delcontrolador SIMBA (Magnitude) JDBC per Spark SQL.

Magatzem de dades d'Azure SQL

Les connexions a Azure SQL Data Warehouse es mantenen mitjançant l'editor deconnexions Microsoft SQL Server.


Amazon Redshift

De manera predeterminada, els usuaris d'Amazon Redshift han de copiar unaversió del fitxer RedshiftJDBC41*.jar al directori Cognos Analyticsubicació_instalvlació\drivers. Si no es requereix l'ús d'un controlador 4.0 o 4.2,podeu editar els noms de classe predeterminats del controlador als que Amazondona suport. Els controladors Amazon JDBC, des de la versió 1.2.1, donen suportal controlador genèric com.amazon.redshift.jdbc. Aquest controlador es potutilitzar en lloc dels noms de classe de controlador anteriors.

Amazon Athena

Cognos Analytics dona suport a Amazon Athena a través del controlador AmazonAthena JDBC. Una connexió ha d'especificar una ubicació d'Amazon S3 vàlidautilitzant la propietat de connexió s3_staging_dir d'Amazon Athen des del que elcontrolador recupera els resultats de consultes.

Cognos Analytics 11.0.7 - característiques noves i modificadesMemSQL i Presto s'afegeixen com a tipus de servidor de dades suportats, iMariaDB compta amb el seu editor de connexions propi.

MemSQL

A partir d'aquesta versió, els tipus de servidor de dades MemSQL ja reben suport.Per tal de mantenir una connexió per aquest servei de dades, utilitzeu el tipus deconnexió MySQL i el controlador Connector/J JDBC.

Presto

A partir d'aquesta versió, els tipus de servidor de dades Presto (versió 0.167 iposterior) ja reben suport. Podeu utilitzar els controladors JDBC de Presto i deTeradata Presto. Les connexions a aquest servidor de dades es mantenen mitjançantl'editor de connexions Presto o Teradata Presto, segons quin controlador JDBC esfaci servir.

Consell: Les versions actuals de Presto tenen un suport limitat per tipus decaràcters de llargada fixa (CHAR), que pot donar resultats incorrectes. Per evitaraquesta limitació, genereu expressions que utilitzin un tipus de caràcter delongitud variable.

MariaDB

A partir de Cognos Analytics 11.0.7, el servidor de dades MariaDB compta amb elseu editor de connexions propi que dona suport al controlador MariaDBConnector/J JDBC.

En versions anteriors, les connexions a MariaDB es definien mitjançant l'editor deconnexions MySQL i el controlador MySQL Connector/J JDBC.

El controlador MariaDB Connector/J torna detalls de la versió. D'aquesta manerael mode de consultes dinàmiques utilitza les millores SQL que s'introdueixen aMariaDB 10.2.4. Quan es defineixen connexions a través del controlador MySQLJDBC, aquestes característiques no es podran utilitzar i podrien tenir lloc mésprocessos locals en el mode de consultes dinàmiques.



Capítol 4. Gestió de valors del sistema

Podeu configurar els paràmetres del sistema que afecten a tots els usuaris icomponents del vostre l'entorn de Cognos Analytics.

Gestió de la càrrega de fitxers de dadesPodeu controlar la forma en què es carreguen els fitxers de dades en IBM CognosAnalytics.

Procediment1. Aneu a Gestiona > Configuració > Sistema, i seleccioneu la pestanya

Càrregues de fitxer.2. Modifiqueu els valors següents, si cal:v el camí del fitxer de dadesv l'encriptatge del fitxer de dades (on o off)v el límit de la mida per càrregav el límit de la mida de les dades desades per usuari

Consell: L'actualització dels límits de la mida pot trigar uns minuts.3. Feu clic a D'acord.

Aplicació de la Seguretat de transport estricte HTTPPodeu especificar que totes les solvlicituds HTTP enviades des de navegadors webes reenviïn com a solvlicituds HTTPS. Aquesta configuració aplica la Seguretat detransport estricte HTTP (HSTS - HTTP Strict Transport Security) garantint que totesles connexions utilitzen el protocol SSL (Secure Sockets Layer).

Procediment1. Aneu a Gestiona > Configuració > Sistema, i seleccioneu la pestanya

Seguretat.2. Activeu el paràmetre transport estricte HTTP.3. Feu clic a D'acord.

Tipus i fitxers de registreEls missatges de registre proporcionen informació sobre l'estat dels components isuccessos importants. Els administradors i els usuaris poden utilitzar aquestsmissatges per resoldre problemes.

IBM Cognos Analytics admet diferents tipus de registre, incloent els següents tipusprincipals de registre: auditoria, diagnòstics, sessió d'usuari i informes derendiment.

Per defecte, el servei IBM Cognos de cada instalvlació envia informació al directorilocal ubicació_instalvlació/logs. Els missatges d'auditoria es desen al fitxercogaudit.log, i els missatges de diagnòstics es desen als fitxers cognosserver.log idataset-service.log. Per als registres d'auditoria, l'administrador pot especificar laubicació, mida i nombre de fitxers de registre a IBM Cognos Configuration. Per als

29

registres de diagnòstics, la mida i el nombre de fitxers de registre s'estableix a lapart de Gestió de Cognos Analytics. Els registres de diagnòstics sempre s'escriuenal directori ubicació_instalvlació/logs. Els registres d'auditoria també es podenconfigurar per tal que s'escriguin a una base de dades, un servidor de registreremot o un registre del sistema. Per obtenir més informació, consulteu: “Registrede diagnòstics”.

Els usuaris individuals poden activar el registre de sessió per a una única sessió deCognos Analytics un cop que els administradors hagin activat aquest tipus deregistre al sistema. Els missatges es registren als fitxers de registre següents aldirectori ubicació_instalvlació/logs: cognosserver-session-session_id.log idataset-service-session-session_id.log. Per obtenir més informació, consulteu:“Configuració del registre de sessió” a la pàgina 32.

Registre d'informes de rendiment

Aquest tipus de registre s'admet a IBM Cognos Analytics - Reporting per informesindividuals. L'autor de l'informe activa la opció per registrar els detalls derendiment seleccionant la opció d'executar l'informe Incloure detalls derendiment. Els detalls següents es poden veure als resultats de l'informe: Tempstotal d'execució, Temps d'execució de consulta i Temps de representació. Elsusuaris poden utilitzar aquesta informació per realitzar un autodiagnòstic delrendiment o per resoldre problemes abans de registrar una solvlicitud de servei.

Per obtenir més informació, consulteu les seccions sobre l'execució d'informes i lavisualització dels detalls de rendiment a la publicació Guia de IBM Cognos Analytics- Reporting.

Registre de diagnòsticsEls administradors poden configurar el registre de diagnòstics per problemesintermitents o específics de servei. A tots els servidor s'estableix automàticament lamateixa configuració de registre.

Els missatges de registre de diagnòstics ara es registren als dos fitxerscognosserver.log i dataset-service.log al directori ubicació_instalvlació/logs.Els administradors poden especificar la mida màxima dels fitxers de registre i elnombre màxim de fitxers de registre per tal d'evitar un impacte negatiu alrendiment.

Aquest tipus de registre substitueix el registre JAVA IPF (ipfclientconfig.xml) de lesversions anteriors de Cognos Analytics. Cognos Analytics processa els missatges deregistre des dels serveis de producte utilitzant els registradors que es defineixeninternament. Aquests registradors s'extreuen en temes de registre que es podenhabilitar a la interfície d'usuari de Gestió.

El registre de diagnòstics no influeix en el registre de sessió ni en el registred'auditoria.

Consell: Podeu continuar utilitzant el fitxer ipfclientconfig.xml pels components decodi nadiu, com ara Servidors d'informes o Framework Manager.ipfclientconfig.xml pot influir en el registres d'auditoria, per tant, convé fer-loservir amb precaució.

Configuració del registre de diagnòsticsEls administradors poden especificar restriccions sobre la mida i el nombre defitxers de registre que s'utilitzen per al registre de diagnòstics.


Procediment1. Aneu a Gestiona > Configuració > Sistema, i seleccioneu la pestanya Registre

de diagnòstics.2. Especifiqueu els valors necessaris per als valors següents:v Límit de mida per al fitxer de registre del servidor

v Nombre màxim de fitxers de registre de servidor de còpia de seguretat

3. Feu clic a D'acord.No és necessari reiniciar el servei IBM Cognos per canviar el registre dediagnòstics.

Activació del registre de diagnòstics per temes diferentsPodeu activar el registre de diagnòstics en un component, servei o funció deproducte diferent canviant el tema de registre.

IBM Cognos Analytics processa els missatges de registre des dels serveis deproducte utilitzant registradors que es defineixen internament. Aquests registradorss'extreuen en temes de registre. El tema REGISTRE PER DEFECTE que s'estableixpel registre de diagnòstic utilitza un conjunt de noms de registrador que s'estableixa nivells d'error específics. Això serveix per què el registre predeterminat no siguimassa dens i només registri els missatges més importants.

Podeu habilitar el registre de diagnòstics en un tema incorporat o en un temapersonalitzat. Per crear un tema personalitzat, podeu descarregar una especificacióJSON per a un tema incorporat i utilitzar-lo com a base per crear el vostre temapersonalitzat. Els temes personalitzats es poden modificar, no així els temesincorporats.

Procediment1. Aneu a Gestiona > Configuració.2. Seleccioneu la pestanya Registre de diagnòstic.3. Seleccioneu un dels temes incorporats o personalitzats per als quals voleu

habilitar el registre.Per exemple, per habilitar el registre de problemes d'autenticació, trieu el temaAAA.

4. Feu clic a Aplica.Per restablir REGISTRE PER DEFECTE, feu clic a Restableix.No és necessari reiniciar el servei IBM Cognos Analytics per canviar el tema deregistre.

Resultats

Els registres ara s'escriuen als fitxers cognosserver.log i dataset-service.log aldirectori ubicació_instalvlació/logs.

Utilització del registre de diagnòstic per resoldre problemesd'engegada del servei CognosEls problemes d'engegada del servei IBM Cognos és un exemple que ilvlustra laforma en què el registre de diagnòstics pot contribuir a detectar l'arrel d'unproblema.

Si el servei Cognos no s'engega abans que l'assignador estigui llest, haureud'habilitar el registre de més diagnòstics detallats en la vostra instalvlació

Capítol 4. Gestió de valors del sistema 31

directament abans d'intentar engegar el servei un altre cop. De formapredeterminada, s'habilita el nivell de registre mínim.

Procediment1. Des del directori IBM Cognos Analytics ubicació_instalvlació/wlp/usr/

servers/cognosserver, obriu el fitxer bootstrap.properties.2. En aquest fitxer, afegiu la propietat del sistema

com.ibm.bi.logging.glug.hint.isready=false per permetre el registre detallat.3. Reinicieu el servei Cognos (des de Cognos Configuration o des d'una línia

d'ordres).Durant l'engegada, el servei de registre examina la propietat del sistemacom.ibm.bi.logging.glug.hint.isready=false abans que la resta de serveisestiguin disponibles. L'engegada torna a fallar, però en aquesta ocasió amb elsregistres detallats al fitxer ubicació_instalvlació/logs/cognosserver.log.Utilitzeu aquests registres per resoldre el problema.

4. Un cop resolt el problema, elimineu la propietat del sistemacom.ibm.bi.logging.glug.hint.isready=false del fitxer bootstrap.propertiesper tal d'inhabilitar el registre detallat, i engegueu el servei Cognos. Desprésd'engegar-lo, es recupera el registre mínim predeterminat.

Consell: Si no us preocupa el temps que triga a engegar-se el servei, i si teniusuficient espai disponible, podeu deixar aquesta propietat amb el valor "false".D'aquesta manera el registre detallat romandrà habilitat fins que aparegui elmissatge que l'assignador està llest.

Configuració del registre de sessióEl registre de sessió s'utilitza per registrar l'activitat detallada de l'usuari a cadacomponent i servei IBM Cognos Analytics associat a la solvlicitud de l'usuari.

No és necessari que l'usuari conegui els components, serveis o detalls deconfiguració del registre. Els altres usuaris no experimentaran canvis en el seurendiment.

El registre de sessió se sol utilitzar quan un usuari pot reproduir un problema. Espot configurar per tal que duri una hora como a màxim y es pari a qualsevolmoment que l'usuari triï.

Es generen fitxers de registre únics per a cada usuari què permeti el registre desessió. Els noms de fitxer inclouen un identificador de registre únic que es generaquan l'usuari activa el registre de la sessió.

L'administrador ha d'habilitar el registre de la sessió al sistema, i després cadausuari pot activar-lo o desactivar-lo.

Procediment1. Seleccioneu Gestiona > Configuració > Sistema.2. Seleccioneu la pestanya Registre de diagnòstic.3. Activeu el valor Habilitar registre de sessió d'usuari.

Quan aquest valor està activat, la opció Registrar la meva sessió estàdisponible per a tots els usuaris a la seva configuració personal.

4. Especifiqueu els valors necessaris per als valors següents:v Mida límit per fitxer de registre de sessió d'usuari (per usuari)


v Nombre màxim de fitxers de registre de còpia de seguretat (per sessiód'usuari)

5. Feu clic a Accepta per aplicar els canvis.No és necessari reiniciar el servei IBM Cognos Analytics.


Ara els usuaris poden habilitar el registre de sessió a la seva configuració personalseleccionant la opció Registrar la meva sessió i activant el valor Registre desessió. Els usuaris han de registrar l'Identificador de registre que es genera per ala sessió abans de desactivar el registre o de tancar l'explorador. L'administradornecessitarà aquest identificador per trobar els fitxers de registre de la sessió,cognosserver-session-log_identifier.log i dataset-service-session-session_id.log, al directori ubicació_instalvlació/logs.

Habilitar o inhabilitar components heretatsPodeu habilitar o inhabilitar els components heretats de Cognos BusinessIntelligence Analysis Studio, Event Studio i Query Studio.

Procediment1. Inicia Cognos Analytics i inicia sessió com a administrador del sistema.2. Al navegador, escriviu http://nom_servidor_CA:port/bi/utils/

ConfigSetter.html

3. Al camp Nom, escriviu Configuration.LegacyLaunchable4. Feu clic al camp Valor.v Si el valor que es retorna és 0, significa que els components heretats no estan

habilitats.v Si el valor que es retorna és 1, significa que els components heretats estan

habilitats.5. Si desitgeu canviar el valor actual, realitzeu una d'aquestes accions:

a. Escriviu 1 al camp Valor per habilitar els components heretats.b. Escriviu 0 al camp Valor per inhabilitar els components heretats.

6. Feu clic a Enviar.

Nota: El canvi de configuració es propaga a tots els assignadors.

Resultats

Quan els usuaris de Cognos Analytics seleccionen Nou > Altres, els componentsAnalysis Studio, Event Studio i Query Studio es mostre o bé s'oculten, en funció desi els heu habilitat o inhabilitat.

Capítol 4. Gestió de valors del sistema 33


Capítol 5. Gestionar activitats planificades

Podeu veure una llista de activitats planificades dels usuaris actuals, passades ofutures per a un dia específic.

Podeu filtrar la llista perquè només apareguin les entrades que vulgueu. Undiagrama de barres us mostrarà una visió general de les activitats diàries, per hora.Podeu utilitzar el diagrama per triar la data més adequada per tornar a planificarles activitats. Podeu definir la prioritat d'execució de les entrades. També podeuveure l'historial d'execució de les entrades, especificar quant de temps calconservar els historials d'execució i tornar a executar les entrades que han fallat.

Podeu veure qui ha executat cada entrada i efectuar accions a les entrades segonscalgui. Per exemple, és possible que vulgueu cancelvlar o suspendre una feina degran volum d'un usuari si està retenint entrades importants a la cua. També podeusubstituir la prioritat d'una instància d'entrada o podeu canviar-la permanentmentper a una mateixa entrada.

Si canvieu de visualització, cal que la refresqueu per veure les dades actuals. Perexemple, si canvieu d'Activitats passades a Activitats futures, cal que refresqueula visualització per veure les dades actuals a les subfinestres.

Els administradors poden utilitzar la funció d'administració Gestiona > Activitats,o bé IBM Cognos Administration per gestionar les activitats de totes les entradesd'usuari.

Gestió d'activitats actualsLes activitats actuals són entrades que s'estan processant actualment al programariIBM Cognos.

Cada entrada apareix llistada pel nom i mostra l'hora de la solvlicitud i la prioritatper a les activitats de fons. El diagrama de barres mostra el nombre totald'entrades desglossades pel nombre d'entrades pendents, en execució, en espera isuspeses. Mentre s'està processant l'activitat, es mostra el número de procés.

Podeu ordenar les columnes Hora de la solvlicitud, Estat i Prioritat. Podeu escollirveure una llista de les activitats de fons o les activitats interactives.

Podeu filtrar les entrades perquè es mostrin només les que vulgueu. Podeu optarper mostrar només les entrades amb un estat o una prioritat concreta, o lesentrades amb un tipus o un àmbit específic.

Per a les entrades interactives actuals, podeu filtrar per estat i per l'assignador ons'executa l'activitat. Per a les entrades actuals en segon pla, podeu filtrar per estat,prioritat, tipus, àmbit, usuari que ha executat l'entrada, y usuari que és propietaride l'entrada.

Quan una entrada s'està processant, se'n mostren el distribuïdor, l'ID del procés il'hora d'inici. Tingueu en compte que l'ID del procés i el distribuïdor de lesentrades de fons actuals poden no estar disponibles la primera vegada que apareixl'activitat. Refresqueu la pàgina per veure l'ID del procés i el distribuïdoractualitzats.

35

Si cancelvleu una entrada que conté altres entrades, com ara una feina o un agent,es cancelvlaran els passos o les tasques que encara no s'hagin acabat. En canvi, elspassos o les tasques que ja s'han acabat es mantenen en aquest estat.

Podeu canviar la prioritat de les entrades i veure l'historial d'execucions.

Procediment1. Al menú Gestiona, feu clic a Activitats.

2. Feu clic a la icona Tipus , i després a Actuals.3. A la secció Filtre, especifiqueu les opcions de filtratge que vulgueu utilitzar.

Consell: Si voleu fer servir opcions de filtratge avançades, feu clic a Opcionsavançades.

4. Feu clic a Aplica.La llista mostra les entrades que heu seleccionat.

Gestió d'activitats passadesLes activitats passades són entrades que s'han acabat de processar al programariIBM Cognos.

Cada entrada apareix llistada pel nom i mostra l'hora de la solvlicitud i l'estat.Podeu ordenar les columnes Hora de la solvlicitud i Estat. El diagrama de barresmostra el nombre total d'entrades desglossades per estat. Si una entrada ha fallat,apareix un botó on es mostra la gravetat de l'error. L'usuari que ha executatl'entrada també apareix a la llista.

Podeu filtrar les entrades perquè es mostrin només les que vulgueu. Podeu optarper veure una llista de les activitats produïdes en un període concret, com ara lesúltimes quatre hores o l'últim dia, o per especificar una data o un interval detemps. Podeu filtrar per estat, tipus i àmbit. També podeu filtrar per l'usuari queha executat l'entrada, l'usuari que és propietari de l'entrada i l'assignador on s'haexecutat l'activitat.

Podeu veure l'historial d'execucions ().


2. Feu clic a la icona Tipus , i després a Passades.3. Situeu-vos sobre el botó d'error, al costat de l'estat per veure la gravetat de

l'error.

Gestionar les activitats futures d'un dia específicPodeu seleccionar veure una llista de totes les activitats futures que estanplanificades per a un dia específic.

Cada entrada apareix llistada pel nom i mostra l'hora de la solvlicitud i la prioritat.Un diagrama de barres mostra el nombre total d'entrades planificades icancelvlades per a cada hora del dia. La llegenda del diagrama indica el nombretotal d'entrades planificades i cancelvlades per al dia.


Podeu ordenar les columnes Hora de la solvlicitud, Estat i Prioritat. Podeu escollirveure una llista de les activitats de fons o les activitats interactives.

Cada entrada mostra l'usuari que l'ha planificat. Podeu ordenar per usuari.

Podeu filtrar les entrades perquè es mostrin només les que vulgueu. Podeu escollirla data i l'hora per a les quals voleu veure les activitats futures. Podeu filtrar perestat, prioritat, tipus i àmbit.

També podeu filtrar per l'usuari que ha planificat l'entrada i pel propietari del'entrada.

Podeu canviar la prioritat d'una entrada de la cua.


2. Feu clic a la icona Tipus , i després a Futures.3. A la secció Filtre, feu clic a les opcions de filtratge que vulgueu utilitzar.

Consell: Si voleu fer servir opcions de filtratge avançades, feu clic a Opcionsavançades. Per restablir totes les seleccions amb els seus valors per defecte, feuclic a Restableix el valor per defecte.

4. Feu clic a Aplica.v La llista mostra les entrades que heu seleccionat.v La línia d'estat del filtre mostra els criteris utilitzats per generar la llista.v El diagrama de barres mostra les entrades planificades i cancelvlades per

hora corresponents al dia especificat.La llista d'entrades, la línia d'estat del filtre i el diagrama s'actualitzen quan esredefineix el filtre i es fa clic a Aplica. La llista d'entrades i la línia d'estat delfiltre no canvien quan s'accedeix a una altra data en el diagrama.

Gestió d'activitats planificadesPodeu veure una llista de totes les entrades planificades per a tots els usuaris.

Cada entrada apareix llistada per nom, estat i prioritat. Un diagrama de barresmostra una visió general de les activitats desglossades per planificacionshabilitades i inhabilitades.

A la llista també hi apareix la data i l'hora en què s'ha modificat la planificació il'usuari que ho ha planificat.

Podeu filtrar les entrades perquè es mostrin només les que vulgueu. Podeu optarper mostrar només les entrades amb un estat o una prioritat concreta, o lesentrades amb un tipus o un àmbit específic. També podeu filtrar per l'usuari queha planificat l'entrada i pel propietari de l'entrada.

Podeu definir propietats, executar la planificació una vegada, inhabilitar i habilitarentrades planificades, modificar la planificació, eliminar la planificació, establir laprioritat () i veure l'historial d'execucions (). Segons l'entrada, pot ser que tambépugueu dur a terme altres funcions, com ara veure sortides o llistes d'incidències.

Capítol 5. Gestionar activitats planificades 37


2. Feu clic a la icona Tipus , i després a Planificades.3. A la secció Filtre, feu clic a les opcions de filtratge que vulgueu utilitzar.

Consell: Si voleu fer servir opcions de filtratge avançades, feu clic a Opcionsavançades.

4. Feu clic a Aplica.La llista mostra les entrades que heu seleccionat.

5. Per realitzar una acció en una entrada individual, feu clic a Més ( ) al costatde l'entrada i seleccioneu l'acció adequada.A la taula següent s'especifiquen les accions disponibles per a les entrades i lesicones associades:

Taula 2. Accions i icones d'activitats planificades

Acció Icona

Propietats

Modificar aquesta planificació

Visualitzar versions

Inhabilitar aquesta planificació

Eliminar aquesta planificació

Establir la prioritat

Utilitza les meves credencials

Consell: Per seleccionar totes les entrades de la llista, marqueu la casella deselecció corresponent a la llista.

Gestió de la prioritat d'execució de les entradesPodeu assignar una prioritat de l'1 al 5 a les entrades planificades.

Per exemple, una entrada amb la prioritat 1 s'executarà abans que una entradaamb la prioritat 5. Si hi ha més d'una entrada amb la mateixa prioritat, la que haentrat abans a la cua s'executa primer. La prioritat per defecte és 3.

Les entrades interactives sempre s'executen immediatament i no se'n pot canviar laprioritat un cop s'estan executant.

La prioritat d'una entrada s'estableix en el moment de planificar-la (). Quan unaentrada és a la cua actual, futura o planificada, en podeu canviar la prioritat.

Pot ser que vulgueu establir una prioritat baixa per a les entrades que triguen molta executar-se, per evitar així que es retardin les altres entrades de la cua.


Quan es planifica una feina (), s'estableix la prioritat per a tota la feina, no per aentrades individuals de la feina. Pot ser que vulgueu establir una prioritat baixaper a una feina que contingui moltes entrades, per evitar així que es retardin lesaltres entrades de la cua.

La prioritat es planifica per a la feina pare. Quan s'executa la feina, totes lesentrades fill hereten la prioritat del pare. Quan la feina és a la cua i encara nos'està executant, podeu actualitzar-ne la prioritat. Això no es pot fer amb lesentrades individuals de la feina. Quan es canvia la prioritat de la feina, es canvia laprioritat de totes les seves entrades fill. Podeu veure l'historial d'execucions d'unafeina () mentre s'està executant, així com veure quines de les seves entrades s'hanacabat, s'estan executant o estan pendents.

La prioritat de les entrades de la cua no afecta una entrada que ja s'estiguiexecutant. Quan aquesta entrada s'hagi acabat d'executar, es comprovarà laprioritat de la cua per veure quina és la pròxima entrada que cal executar.

Abans de començar

Heu de tenir la capacitat Executa les activitats i les planificacions per podergestionar la prioritat d'execució de les entrades.


2. Feu clic a la icona Tipus , i després a Planificades.

3. Per canviar la prioritat d'una entrada, feu clic a Més ( ) al costat de l'entradai seleccioneu Estableix prioritat.

4. Al menú, feu clic a la prioritat que vulgueu i després feu clic a D'acord.

Resultats

La prioritat nova apareix a la columna Prioritat situada al costat de les entradesque heu seleccionat.

Capítol 5. Gestionar activitats planificades 39


Capítol 6. Gestió de llicències

Els administradors del sistema han de fer un seguiment de l'ús de llicències del'IBM Cognos Analytics.

La informació de llicències a l'IBM Cognos Analytics mostra les llicènciesutilitzades per cada usuari amb el seu últim inici de sessió. Les prestacionsmodificades dels usuaris no queden reflectides al seu ús de llicències fins que notornen a iniciar sessió. A més a més, en el cas del clients ja existents, la informaciód'ús de llicències estarà incompleta fins que tots els usuaris iniciïn sessió de nou.

Es genera un informe d'ús de llicències quan la pàgina de llicències de Gestiona >Llicències s'obre per primera vegada, quan es fa clic al botó Refresca o després dereiniciar el producte.

L'informe bàsic conté informació sobre l'ús de llicencies per usuari. A alguns clientspotser els interessarà crear informes addicionals, per exemple sobre l'ús dellicències per arrendatari.

L'IBM Cognos Analytics té alguns tipus de rols amb llicència, cadascun d'ellsassociat amb diferents prestacions. Consulteu aquest article (www.ibm.com/support/docview.wss?uid=swg21684890) per veure la taula de prestacions ipermisos en els quals es basa el model de llicències de l'IBM Cognos Analytics.

L'ús de les llicències es pot supervisar en un entorn de producció i també de noproducció. Per obtenir més informació sobre aquests dos tipus d'entorn, consulteu:Capítol 9, “Habilitació d'un entorn de producció”, a la pàgina 101.

Procediment1. Per accedir a la pàgina de llicències de l'IBM Cognos Analytics, feu clic a

Gestiona > Llicències.2. Per introduir el nombre de llicències que es tenen, feu clic al camp Propietat de

corresponent al rol amb llicència, escriviu la xifra i feu clic a Aplica per desarel valor.Aquest valor s'utilitza a títol informatiu únicament i no s'inclou a l'informe d'úsde llicències.

3. Per generar l'informe d'ús de llicències, feu clic a Refresca.Podeu generar l'informe amb la freqüència que desitgeu.

4. Per veure la informació de llicències d'un rol concret, feu clic a la icona de

detalls .Aquesta informació es part de la informació inclosa a l'informe complet.

5. Per veure l'informe sencer, feu clic a Exporta per desar la informació en unfitxer CSV i obriu el fitxer.

Consell: Al fitxer exportat, els valors de la columna Nivell es corresponen ambuns rols de llicència específics, como s'indica a continuació:

Nivell Rol de llicència

3 Analytics Administrator2 Analytics Explorer

41


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_predefinedentries.html#predefined_license_roles

Nivell Rol de llicència

1 Analytics User0 Information Distribution-1 El rol de llicència és desconegut perquè

l'usuari encara no ha iniciat la sessió.


Per obtenir més informació, consulteu els temes següents:v Rols de llicència predefinitsv Assignació de capacitats segons els rols de llicènciav Escenari d'actualització: si els vostres rols personalitzats tenen els mateixos noms

què els nous rols de llicència

Rols de llicènciaPer tal d'ajudar-lo a correlacionar capacitats als requeriments de llicència, CognosAnalytics també proporciona rols predefinits basats en titularitats de llicència.

La taula següent enumera els rols de llicència predefinits.

Taula 3. Rols de llicència Cognos predefinits

Rol de llicència Descripció

Administradors d'Analytics Els membres tenen els mateixos permisos d'accés que elsExploradors d'Analytics. També poden accedir al kit dedesenvolupament de programari d'IBM.

Exploradors d'Analytics Els membres tenen els mateixos permisos d'accés que elsUsuaris d'Analytics. També poden accedir a PlanningAnalytics for Microsoft Excel, Cognos Framework Manager,Cognos Cube Designer and Dynamic Query Analyzer iTransformer.

Usuaris d'Analytics Els membres poden crear nous informes, panells d'eines,històries, noves feines, connexions d'origen i servidor dedades o mòduls de dades. Poden executar informes,respondre a solvlicituds i carregar fitxers. També podenaccedir a Cognos for Microsoft Office, Cognos Workspace,Cognos Event Studio, Cognos Query Studio i CognosAnalysis Studio.

Usuaris de distribuciód'informació

Els membres poden llegir contingut públic, com informes.No obstant això, els membres no poden executar contingutpúblic.

Permisos per defecte basats en llicènciesA IBM Cognos Analytics, el comptador de llicències de Gestiona > Llicències escontrola a través de les capacitats que han estat atorgades a un usuari, grup o rol.

Nota: Si feu canvis als permisos per defecte, un usuari pot millorar el seu nivell dellicència a un diferent del que va obtenir per defecte.

La tabla següent correlaciona les capacitats atorgades per a cada llicència. Lescapacitats estan dividides en característiques protegides. La lletra X indica que s'haatorgat un permís per a una característica protegida.


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_predefinedentries.html#predefined_license_roles

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_predefinedentries.html#assign_capabilities_license_roles

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_predefinedentries.html#upgrade_license_role_names

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_predefinedentries.html#upgrade_license_role_names

Taula 4. Capacitats de Cognos Analytics 11 per rols de llicència

CapacitatCaracterísticprotegida

InformationDistribution

AnalyticsUser

AnalyticsExplorer

AnalyticsAdministr Observac

AdaptiveAnalytics

No s'aplica No s'aplica No s'aplica No s'aplica

Administr X X X

Administrd'AdaptiveAnalytics


Tasquesd'administr

X

Configura igestiona elsistema

X

Administrdecontrolador

No s'aplica No s'aplica No s'aplica No s'aplica Esrequereix

unatitularitatindividual

de IBMConnections

Connexionsd'origen dedades

X X X

Llistes dedistribuciói contactes

X

Administrde MetricStudio

X

Administrde Mobile

X

AdministrdePlanning



de IBMPlanning

Contributor

ServidorsPowerPlay

X X X Esrequereix

unallicència

individualde

PowerPlay

Impressores X

Administrde QueryService

X

Capítol 6. Gestió de llicències 43

Taula 4. Capacitats de Cognos Analytics 11 per rols de llicència (continuació)



AnalyticsUser

AnalyticsExplorer


Executaractivitats iplanificac

X

Establircapacitats iadministrarperfilsd'interfícied'usuari

X

Estils iportlets

X

Usuaris,grups i rols

X

AnalysisStudio

X X X

CognosInsight


CognosViewer

X X X X

Menúcontextual

X X X X

Executarambopcions

X X X

Selecció X X X X

Barrad'eines

X X X X

Colvlaborar X X X Esrequereix


de IBMConnections

Permetrecaracterístiquesdecolvlaboració

X X X Esrequereix


de IBMConnections

Iniciareines decollaboració

X X X Esrequereix


de IBMConnections





AnalyticsUser

AnalyticsExplorer


ControllerStudio



de IBMConnections

Panelld'eines

X X X

DataManager


Einesd'escriptori

X X

Conjuntsde dades

X X X X

Errorsdetallats

X X X X Quan unadministr

atorgaaquestpermís,

l'usuari potveure elmissatged'error

detallat aViewer i a

Report

Assistentper l'accésa detalls

X X X Quan unadministr

atorgaaquestpermís,

l'usuari potveure quinsparàmetres

s'hanpassat desde l'origeni de quina

manera hanestat

correlac alobjecte dedestí des

de lapàginaAneu a

mitjançantl'assistentper l'accésa detalls.





AnalyticsUser

AnalyticsExplorer


EventStudio

X X X

Executarcercaindexada

X X X X

Panelld'einesexecutiu

X X X

Utilitzarcaracterístiqavançadesdel panelld'eines

X X X

Utilitzarcaracterístiqinteractivesdel panelld'eines

X X X

Dipòsitsexterns

X X X X L'administrha d'activar

laconfiguració

depermisos

per tal quel'usuaripugui

accedir alsfitxers

arxivats

Gestionarconnexionsdel dipòsit

X

Veuredocumentsexterns

X X X X

GenerarsortidaCSV

X X X X

GenerarsortidaPDF

X X X X

Generarsortida XLS

X X X X

GenerarsortidaXML

X X X X





AnalyticsUser

AnalyticsExplorer


Glossari X X X X Integracióamb elglossarid'IBM

InfoSphereBusiness.

Es potutilitzar

directamentdes deViewer.

Ocultarentrades

X X X X

Importarmetadadesrelacionals

X

Llinatge X X X X Un cophabilitat,

l'usuari enpot accedir

des deViewer.

Gestionarcontingut

X

Gestionarinicis desessiópropisd'origen dedades

X X X

MetricStudio

X X

Editar vista X X

Mobile X X X X

PlanningContributor



de IBMPlanning

Contributor

PowerPlayStudio

X X X Esrequereix

unallicència

individualde

PowerPlay





AnalyticsUser

AnalyticsExplorer


QueryStudio

X X X

Advanced X X X

Crear X X X

ReportStudio

X X X

Permetredadesexternes

X

Separació X X X

Crear/Suprimir

X X X

ElementsHTML aReport

X X X

SQL definitper l'usuari

X X X

Planificació X X X

Planificarper dia

X X X

Planificarper hora

X X X

Planificarper minut

X X X

Planificarper mes

X X X

Planificarperactivador

X X X

Planificarpersetmana

X X X

Planificarper any

X X X

Planificarperprioritat

X

Assistentper apaquetsd'autoservei

X

Establirfuncionsespecífiquesd'entrada

X

Instantànies X X X X





AnalyticsUser

AnalyticsExplorer


Execuciód'especificac

X

Carregarfitxers

X X X

Observarnormes

X X X

Modelatgebasat enweb

X X X

Assignació de capacitats segons els rols de llicènciaPodeu assignar capacitats segons el rol de llicència de posseïu.v Per tal d'utilitzar els rols predefinits que s'han configurat automàticament en el

moment de la instalvlació, seguiu els passos que s'indiquen a Com restringirusuaris segons els seus rols de llicència a Cognos Analytics (versió 11.0.7 +) .

v Per tal de configurar aquests rols manualment, seguiu els passos que s'indiquena Com restringir usuaris segons els seus rols de llicència a Cognos Analytics(versions 11.0.0 a 11.0.6).

Escenari d'actualització: si els vostres rols personalitzats tenen elsmateixos noms què els nous rols de llicència de Cognos

Si heu creat rols prèviament amb els mateixos noms que els rols de llicència nousde Cognos i teniu previst realitzar una actualització, considereu les capacitats quevoleu aplicar als rols després de l'actualització.

Per obtenir-ne més informació, consulteu: “Rols de llicència” a la pàgina 42v Si voleu continuar fent servir capacitats que havíeu assignat prèviament a

aquests rols, podeu realitzar una actualització sense perdre aquestes capacitats.v No obstant això, si voleu adoptar les capacitats dels nous rols de llicència,

primer heu de suprimir els rols existents o canviar-los el nom abans de ferl'actualització.


http://www-01.ibm.com/support/docview.wss?uid=swg21684890





Capítol 7. Administració d'arrendataris

Les tasques d'administració d'arrendataris les duen a terme els administradors delsistema i els administradors d'arrendataris delegats.

Els administradors del sistema han de ser membres del rol Administradors delsistema a l'espai de noms del Cognos. Els administradors del sistema poden veurei modificar tots els objectes del magatzem de continguts. També poden delegar lestasques d'administració d'arrendataris a altres administradors que siguin membresdel rol Administradors d'arrendataris a l'espai de noms del Cognos.

Els membres del rol Administradors del sistema poden dur a terme les tasquessegüents en un entorn de multiarrendament de l'IBM Cognos Analytics:v Crear, canviar i suprimir objectes d'arrendatariv Canviar les propietats d'arrendament en qualsevol objecte del magatzem de

contingutsv Moure els arrendatarisv Finalitzar sessions dels arrendataris

La pestanya Multiarrendament de Gestiona és l'àrea central de l'administraciód'arrendataris. En aquesta pestanya, l'administrador pot afegir nous arrendataris igestionar tots els arrendataris que estiguin registrats a l'entorn actual del CognosAnalytics. Només aquells membres que tinguin el rol Administradors del sistemapoden accedir a la pestanya Multiarrendament.

Consell: La pestanya Multiarrendament de l'IBM Cognos Administration també espot utilitzar per a l'administració d'arrendataris.

Regles de contenció per al multiarrendamentEn un mateix magatzem de continguts poden coexistir diversos arrendataris. Lesregles de contenció d'arrendatari garanteixen la seguretat i l'aïllament entre elsarrendataris. Aquestes regles dicten com es crea el contingut i on es troba.

Cada objecte del magatzem de continguts té un valor d'ID d'arrendatari que indicaa quin arrendatari pertany l'objecte. Per obtenir informació sobre la creació dels IDd'arrendatari, consulteu: “Creació d'arrendataris” a la pàgina 52.

L'ID d'arrendatari d'un objecte ha de ser el mateix que l'ID d'arrendatari del seupare, tret que l'ID d'arrendatari del pare sigui públic. Si l'ID d'arrendatari del pareés públic, l'ID d'arrendatari del fill es pot canviar per qualsevol valor. Per obtenirmés informació, consulteu: “Definició d'un ID d'arrendament per a un objectepúblic” a la pàgina 53.

Si l'usuari que té iniciada la sessió actualment crea l'objecte, l'ID d'arrendatari del'objecte és el mateix que l'ID d'arrendatari de l'usuari.

Els objectes de model i vista de model hereten els seus ID d'arrendatari del paquet.Per exemple, els models publicats en un paquet públic sempre són públics.

51

Creació d'arrendatarisEls administradors del sistema han de crear i habilitar l'objecte d'arrendatari per talque els usuaris dels arrendataris puguin accedir a l'IBM Cognos Analytics.

Abans de començar

Cal que el multiarrendament ja estigui habilitat a l'IBM Cognos Configuration.


L'administrador del sistema crea l'objecte d'arrendatari a la pestanyaMultiarrendament del component Gestiona del Cognos Analytics i assigna un IDd'arrendatari únic a l'objecte.

Els ID d'arrendatari es defineixen al proveïdor d'autenticació, com LDAP, ActiveDirectory o un proveïdor d'autenticació personalitzat. Per obtenir més informació,consulteu: Configuració de multiarrendament.

Procediment1. A Gestiona, seleccioneu la pestanya Multiarrendament.

2. Seleccioneu la icona Add a tenant .3. Especifiqueu els paràmetres Nom i ID d'arrendatari.

Assegureu-vos que especifiqueu un ID d'arrendatari vàlid que estiguipreconfigurat en el proveïdor d'autenticació.Altres paràmetres d'aquesta pàgina són opcionals.

4. Seleccioneu Afegeix.

Resultats

El nom de l'arrendatari es mostra a la pestanya Multiarrendament. Per defecte,

l'arrendatari està inhabilitat . Podeu habilitar l'arrendatari quan estiguitotalment configurat.

Assignació d'ID de arrendatari a contingut existentUn cop habilitat el multiarrendament, l'administrador del sistema assigna uns IDd'arrendatari als objectes del magatzem de continguts existents. Tots els objectesque pertanyen a un arrendatari tenen el mateix ID d'arrendatari.

Quan un usuari d'un arrendatari específic inicia sessió a l'IBM Cognos Analytics, elsistema consulta l'ID de arrendatari i filtra el contingut.

Es poden crear arrendataris i assignar els ID d'arrendatari amb el kit dedesenvolupament de programari (SDK).


En un entorn multiarrendament, tots els objectes del magatzem de continguts sónpúblics o pertanyen a un sol arrendatari. Com a administrador del sistema, cal queus assegureu que els objectes existents tinguin un ID d'arrendatari adequat o


estiguin destinats a seguir sent públics. Per exemple, podeu assignar uns IDd'arrendatari al contingut d'una carpeta, però deixar com a pública la pròpiacarpeta.

També podeu assignar ID d'arrendatari per a objectes individuals, com arainformes, panells d'eines, connexions de servidor de dades, grups d'usuaris i rols,etcètera.

Procediment1. Inicieu sessió a l'IBM Cognos Analytics com a administrador del sistema.2. A Contingut d'equip, cerqueu les entrades del contenidor, como ara carpetes o

paquets, als descendents de les quals se'ls hagi d'assignar el mateix IDd'arrendatari.en assignar l'ID d'arrendatari per a objectes com ara connexions de servidors dedades o grups o rols, localitzeu els objectes a l'àrea adequada a la interfícied'administració.

3. Obriu el panell Propietats de l'objecte al qual vulgueu assignar l'IDd'arrendatari.

4. A la pestanya General, secció Avançades, feu clic a l'enllaç que hi ha al costatd'Arrendatari.

5. Seleccioneu un ID d'arrendatari de la llista d'ID disponibles i feu clic a Aplica.

Resultats

L'ID d'arrendatari s'aplica a l'entrada. Si l'entrada és un contenidor, com ara unacarpeta o un paquet, l'ID d'arrendatari s'aplica a l'entrada i als deus descendents.

El nom de l'arrendatari es mostra a la pestanya General, secció Avançades, a lapàgina de propietats d'objecte.

Definició d'un ID d'arrendament per a un objecte públicPodeu assignar un ID d'arrendatari per als objectes el pare dels quals sigui públic.

Procediment1. Obriu el panell Propietats de l'objecte, com per exemple una connexió de

servidor de dades, per al qual vulgueu especificar un ID d'arrendatari.2. A la pestanya General, secció Avançades, seleccioneu l'enllaç que hi ha al

costat d'Arrendatari.3. Seleccioneu un ID d'arrendatari de la llista d'ID disponibles.4. Feu clic a Aplica.

Administració delegada d'arrendatarisEls administradors del sistema poden delegar les tasques d'administraciód'arrendataris al membres del rol Administradors d'arrendataris.

Si la propietat Correlació de conjunt delimitador d'arrendatari està configurada,els administradors d'arrendataris poden accedir únicament als arrendataris queestiguin definits en el seu conjunt delimitador. També tenen restriccions segons lespolítiques de seguretat del Cognos Analytics que els administradors del sistemahagin assignat al contingut. En aquests casos, els administradors d'arrendataris esconsideren administradors d'arrendataris delimitats.

Capítol 7. Administració d'arrendataris 53

Si la propietat Correlació de conjunt delimitador d'arrendatari no estàconfigurada, els administradors d'arrendataris ignoren la comprovaciód'arrendament i les úniques restriccions que tenen són les dictades per lespolítiques de seguretat del Cognos Analytics que els administradors del sistemahagin assignat al contingut. En aquests casos, els administradors d'arrendataris esconsideren administradors d'arrendataris no delimitats.

Per obtenir més informació sobre la propietat Correlació de conjunt delimitadord'arrendatari, consulteu la informació sobre les característiques avançadesmultiarrendatari a IBM Cognos Analytics Administration and Security Guide.

Els administradors d'arrendataris poden dur a terme les tasques d'administracióque l'administrador del sistema els hagi assignat.

Els administradors d'arrendataris no poden dur a terme les tasques següents:v Accedir a la pestanya Multiarrendament de Gestiona i de l'IBM Cognos

Administrationv Crear, suprimir, desplegar i inhabilitar arrendatarisv Finalitzar les sessions dels usuaris i personalitzar els arrendatarisv Canviar l'arrendament en qualsevol objecte del magatzem de continguts

Consell: El rol Administradors d'arrendataris és una de les entrades incorporadesde l'espai de noms del Cognos.

Per obtenir informació sobre el rol Administradors del sistema en un entornmultiarrendament, consulteu: Capítol 7, “Administració d'arrendataris”, a la pàgina51.

Configuració del rol Administradors d'arrendatarisAl magatzem de continguts inicial, el rol Administradors d'arrendataris no té capmembre; només els administradors del sistema tenen permisos d'accés sobreaquest rol. Els administradors del sistema han d'afegir membres i canviar elspermisos d'accés inicials d'aquest rol per utilitzar-lo en l'administració delegadad'arrendataris.


Quan afegiu membres al rol Administradors d'arrendataris, seleccioneu elsusuaris, els grups o els rols dels arrendataris pertinents.

Procediment

Feu servir el procediment següent per afegir o eliminar membres del rolAdministradors d'arrendataris.1. Inicieu sessió a l'IBM Cognos Analytics com a un administrador del sistema

que sigui membre del rol Administradors del sistema.2. A Gestiona > Comptes > Espais de noms, seleccioneu l'espai de noms del

Cognos.3. A la llista d'entrades, cerqueu el rol Administradors d'arrendataris i, al seu

menú contextual , feu clic a Mostra membres.


4. A la pestanya Membres, seleccioneu la icona per afegir membres

idesplaceu-vos per la jerarquia de l'espai de noms de seguretat per seleccionarels usuaris, grups o rols que voleu que siguin membres d'aquest rol.

Resultats

Un cop hagueu afegit els usuaris, grups o rols adients al rol Administradorsd'arrendataris, podeu utilitzar aquest rol per configurar les polítiques de seguretati les capacitats dels objectes del magatzem de continguts.

Configuració d'arrendataris virtuals per habilitar l'ús compartit delcontingut entre arrendataris

Quan configureu arrendataris virtuals, als objectes del magatzem de contingutpoden accedir usuaris que pertanyen a diferents arrendataris.

Els arrendataris virtuals inclouen els arrendataris reals que ja estan configurats alCognos Analytics.

Abans de començar

El multiarrendament està habilitat per a l'IBM Cognos Analytics; els arrendataris escreen a Gestiona > Multiarrendament. Per obtenir més informació, consulteu:“Creació d'arrendataris” a la pàgina 52.


Les entrades dels arrendataris virtuals i els real es veuen de forma idèntica a lapestanya Multiarrendament. Perquè sigui més fàcil identificar els arrendatarisvirtuals, utilitzeu noms significatius al crear-los i escriviu descripcions.

Per exemple, voleu configurar l'ús compartit del contingut per als arrendatarisanomenats Amèrica del Nord, Amèrica Central i Amèrica del Sud. Creeu unarrendatari virtual anomenat Amèrica i hi afegiu els tres arrendataris. Els usuarisque pertanyen a qualsevol d'aquests tres arrendataris poden accedir al contingutdel seu arrendatari, al contingut dels altres dos arrendataris i al contingut públic.

Si suprimiu un arrendatari virtual, també se suprimeix tot el contingut que tinguiassociat.

Per obtenir més informació, consulteu: Advanced multitenancy features(www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_config_mt_advanced.html).

Procediment

Seguiu aquests passos per crear un arrendatari virtual i una carpeta per alcontingut de l'arrendatari virtual.1. Inicieu sessió a l'IBM Cognos Analytics com a membre del rol Administradors

del sistema.2. A Gestiona, seleccioneu la pestanya Multiarrendament.

3. Seleccioneu la icona Add a tenant .4. Especifiqueu els paràmetres Nom i ID d'arrendatari.


http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_config_mt_advanced.html

L'ID d'arrendatari virtual no necessita preconfiguració. Pot ser qualsevol valor.Per proporcionar una descripció, escriviu una cadena, com ara Arrendatarivirtual, que us ajudi a identificar l'arrendatari entre altres arrendataris alCognos Analytics.

5. Seleccioneu Afegeix. El nom de l'arrendatari virtual es mostra a la llistad'arrendataris; per defecte, l'arrendatari està inhabilitat. Podeu habilitarl'arrendatari quan acabeu de configurar-lo.

6. Al menú contextual

de l'arrendatari virtual que heu creat, seleccioneuMostra membres.

7. A la pestanya Membres, seleccioneu la icona per afegir membres .8. Seleccioneu els arrendataris que voleu afegir a l'arrendatari virtual i feu clic a

Afegeix.

Consell: Podeu afegir arrendataris inhabilitats. No obstant això, els usuaris nopodran accedir al contingut dels arrendataris inhabilitats fins que nos'habilitin.

9. Creeu una nova carpeta. El nom de la carpeta hauria de ser semblant al nomde l'arrendatari virtual per facilitar la identificació.

10. A la pàgina de propietats de la carpeta, a la pestanya General, seccióAvançades, canvieu el valor de ID d'arrendatari per l'ID de l'arrendatarivirtual mitjançant la selecció de l'ID a la llista d'ID disponibles. Per exemple,si l'ID de l'arrendatari virtual és Amèrica, seleccioneu aquest ID a la llista iassigneu-lo a la carpeta.

Personalització d'arrendatarisPodeu aplicar temes als arrendataris individuals. També podeu especificar que esvisualitzi una pàgina inicial personalitzada, o un informe o un panell d'einesconcret, quan un usuari amb un ID d'arrendatari determinat obri l'IBM CognosAnalytics. També podeu eliminar les funcions de la interfície d'usuari per defecteper als arrendataris.

Abans d'establir temes i pàgines inicials personalitzats (que no siguin un panelld'eines o un informe) heu d'haver creat i carregat els temes o les pàgines inicialspersonalitzats. Per obtenir més informació, consulteu: Capítol 8, “Personalització deCognos Analytics a tots els rols”, a la pàgina 61.

A Gestiona > Multiarrendament, feu clic a arrendatari. El panell lliscant d'aquestarrendatari té una pestanya Personalització. Per obtenir més informació, consulteu:“Gestió de temes, extensions, vistes i paràmetres” a la pàgina 90.

Establiment d'una pàgina inicial per defecte

Feu clic a la icona Següent

al costat de la pàgina inicial per defecte. Ja podeunavegar fins el panell d'eines o l'informe que voleu com a pàgina inicial perdefecte, o podeu seleccionar una vista de la llista de vistes perquè esdevingui lapàgina inicial per defecte per a tots els usuaris d'aquest arrendatari.

Eliminació de funcions

Podeu escollir les funcions de la interfície d'usuari que vulgueu eliminar per a

l'arrendatari. Feu clic a la icona Següent

al costat de Característiques. A


continuació es mostra una llista de vistes. Aquesta llista inclou les vistesincorporades i les vistes personalitzades que s'hagin carregat. Feu clic en una vista

per veure l'agrupació de funcions d'alt nivell de la vista. Feu clic a

al costatd'una agrupació per a ampliar els detalls d'un nivell inferior de funcions. Podeudesseleccionar qualsevol funció d'aquesta llista, o bé ampliar els detalls d'un altreconjunt de funcions per desseleccionar-les. Feu clic a Aplica per desar els canvis.Podeu revertir els canvis fent clic a Restableix el valor per defecte.


Feu clic a

al costat del tema per defecte. Podeu seleccionar un tema de la llistade temes perquè esdevingui el tema per defecte per a aquest arrendatari.

Creació d'una carpeta personalitzada

Feu clic a

al costat de Carpeta personalitzada per definir una carpeta decontingut personalitzada per a aquest arrendatari. Quan un usuari amb aquest IDd'arrendatari inicia sessió, la carpeta personalitzada es visualitza a la barra denavegació sota Contingut d'equip.

Paràmetres

Afegir contingut aquí, i també per a rols.

Definir la configuració regional per als arrendatarisUn administrador del sistema pot especificar la configuració regional d'unarrendatari.

La configuració regional s'aplica a tots els components de l'IBM Cognos Analytics,com ara informes, panells d'eines, models, administració, etcètera. I també s'aplicaa les aplicacions relacionades, com ara IBM Cognos Analysis Studio, IBM CognosEvent Studio, etcètera.

Es poden especificar els següents paràmetres:

Fus horariEl fus horari dels usuaris arrendataris.

Idioma del producteL'idioma de la interfície d'usuari de l'IBM Cognos Analytics.

Idioma del contingutL'idioma utilitzat per visualitzar i generar continguts a IBM CognosAnalytics, com ara dades dels informes, dels panells d'eines i de leshistòries.

Suport per a idiomes bidireccionalsAquest paràmetre s'aplicar a idiomes com ara l'àrab, l'hebreu, l'urdu o elfarsi. Amb aquest paràmetre podeu controlar la direcció del text en el nomde les entrades, descripcions, etiquetes i ajudes contextuals, quadresd'entrada, comentaris, i en text estructurat com ara adreces de correuelectrònic, camins d'accés de fitxers, traces de navegació, URL, i indicacionsde data i hora.

Seleccioneu una de les següents opcions a Direcció base del text: De dretaa esquerra, D'esquerra a dreta, Contextual. Quan se selecciona l'opció


Contextual, la direcció del text depèn de la primera lletra del text. Si lalletra pertany a un script de dreta a esquerra, la direcció del text serà dedreta a esquerra. Si no, la direcció del text serà d'esquerra a dreta. Elsnúmeros i els caràcters especials no afecten la direcció del text. Perexemple, si el text comença per un número seguit d'una lletra àrab, ladirecció serà de dreta a esquerra. Si el text comença per un número seguitd'una lletra llatina, la direcció serà de dreta a esquerra.

Procediment1. A Gestiona, seleccioneu la pestanya Multiarrendament.2. Al menú contextual de l'arrendatari, feu clic a Propietats.3. Feu clic a la pestanya Regional i especifiqueu els paràmetres.

Resultats

Per defecte, tots els usuaris arrendataris hereten aquests paràmetres. Segons elspermisos d'accés que tinguin, poden personalitzar-los després.

Configuració de notificacions per a arrendatarisCom a administrador del sistema, podeu configurar un compte de correuelectrònic, anomenat remitent arrendatari, des d'on els usuaris arrendataris rebenels correus.

El compte del remitent arrendatari sobreescriu el compte de remitent per defecteque s'especifica quan es configura el servidor de correu d'IBM Cognos Analytics.

Consell: El remitent per defecte es configura a l'IBM Cognos Configuration, aAccés de dades > Notificació.

Procediment1. A Gestiona, seleccioneu la pestanya Multiarrendament.2. Al menú contextual de l'arrendatari, feu clic a Propietats.3. A la pestanya Notificacions, seleccioneu Remitent arrendatari i especifiqueu

l'adreça de correu electrònic corresponent. Feu clic a Aplica.

Resultats

El compte de correu electrònic del remitent arrendatari està ara associada perdistribuir el contingut d'IBM Cognos Analytics.

Finalització de les sessions d'usuari actives dels arrendatarisCal que finalitzeu les sessions d'usuari actives d'un arrendatari abans desuprimir-lo o abans de dur a terme algunes operacions de mantenimentd'arrendataris.

Abans de començar

Abans de finalitzar les sessions d'usuari actives d'un arrendatari, inhabiliteu-loperquè no es puguin iniciar noves sessions d'usuari. Per obtenir més informació,consulteu: “Inhabilitació i habilitació d'arrendataris” a la pàgina 59.



Utilitzeu aquesta acció per finalitzar totes les sessions d'usuari actives delsarrendataris especificats. L'accés de la resta d'arrendataris no es veurà afectat.

Procediment1. A Gestiona > Multiarrendament, cerqueu l'arrendatari adient.

2. Al menú contextual de l'arrendatari , feu clic a Finalitza sessions.

Resultats

Es mostra un missatge que indica el nombre de sessions d'usuari finalitzades.

Inhabilitació i habilitació d'arrendatarisPodeu inhabilitar un arrendatari quan vulgueu impedir que els usuaris d'aquestarrendatari accedeixin a l'IBM Cognos Analytics i modifiquin el contingut del'arrendatari.


Per defecte, un arrendatari acabat de crear està inhabilitat, i heu d'habilitar-lodesprés de configurar-lo.

Abans de desplegar un arrendatari i el seu contingut, cal que inhabiliteul'arrendatari. Per obtenir més informació, consulteu: Tenant content deployment(www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_mt_deployment.html).

Como a pràctica recomanada, també cal que inhabiliteu un arrendatari abans definalitzar les seves sessions d'usuari actives. Per obtenir més informació, consulteu:“Finalització de les sessions d'usuari actives dels arrendataris” a la pàgina 58.

Procediment1. A Gestiona > Multiarrendament, cerqueu l'arrendatari necessari.

2. Al menú contextual de l'arrendatari , feu clic a Inhabilita.A la icona de l'arrendatari s'afegeix una icona que indica que té l'estat

inhabilitat .Per habilitar l'arrendatari, seleccioneu Habilita.

Supressió d'arrendatarisPodeu suprimir un arrendatari de l'IBM Cognos Analytics. Aquesta acció pot sernecessària si l'arrendatari s'ha mogut de manera permanent a una altra instància del'IBM Cognos Analytics.

Abans de començar

Abans de suprimir un arrendatari, cal finalitzar les seves sessions d'usuari actives.Si no és així, no podreu suprimir l'arrendatari. Per obtenir més informació,consulteu: “Finalització de les sessions d'usuari actives dels arrendataris” a lapàgina 58.


http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_mt_deployment.html


Quan suprimiu un arrendatari, també suprimiu tot el contingut associat amb ell,com els informes o els panells de control.

Procediment1. A Gestiona > Multiarrendament, cerqueu l'arrendatari que voleu suprimir.

2. Al menú contextual de l'arrendatari , feu clic a Suprimeix.


Capítol 8. Personalització de Cognos Analytics a tots els rols

La interfície d'usuari de l'IBM Cognos Analytics es crea sobre un model extensible.En aquest model, les pantalles de la interfície d'usuari es defineixen com vistes(com inici, creació personalitzada, panell d'eines i modelador). Podeu personalitzaraquestes vistes per tots els usuaris i rols afegint i eliminant elements d'interfícied'usuari, com ara botons i menús. Podeu definir vistes noves per ampliar lainterfície d'usuari de Cognos Analytics. També podeu substituir la pàgina d'iniciper defecte i la pàgina d'inici de sessió, o bé substituir la vostra pròpia marca(colors, logotips i text de la marca) per la marca per defecte en totes les vistes.

Les personalitzacions s'empaqueten com fitxers comprimits que contenen un fitxerspec.json que defineix la personalització. El fitxer comprimit també pot inclourealtres fitxers, en funció del tipus de personalització. Les personalitzacions també espoden incloure en desplegaments.

Gestioneu personalitzacions per a tots els usuaris i rols amb el panell lliscantGestiona > Personalitzacions. Utilitzeu aquest panell per carregar les vostrespersonalitzacions en el servidor de Cognos Analytics i per seleccionar lespersonalitzacions que vulgueu utilitzar.

Nota:

Quan utilitzeu el panell lliscant Gestiona > Personalitzacions, les vostres personalitzacionss'apliquen a tots els usuaris i rols.

Per exemple, si carregueu l'extensió d'exemple anomenada

SampleExtensionExcludeNotifications.zip, eliminarà la icona Notificacions de labarra d'aplicacion a la perspectiva Inici per a tots els usuaris i rols. També eliminarà elquadre de selecció Notificacions de la llista de característiques quan un administradorseleccioni les propietats d'un rol, faci clic a la pestanya Personalització i vagi aCaracterístiques > Inici > Barra d'aplicacions.

Per tant, si el vostre objectiu és afegir o eliminar una característica per a tothom al vostreentorn de Cognos, he d'utilitzar una extensió. Si l'objectiu és oferir diferentscaracterístiques als usuaris i rols, hauríeu d'utilitzar un apersonalització de rols individualen comptes d'una extensió.

Si utilitzeu personalitzacions de rol per definir característiques específiques per a rolsd'usuari i després apliqueu una extensió basada en aquestes característiques, l'extensiósobreescriurà totes les personalitzacions de rol.

Per tal d'assignar pàgines d'inici, característiques, temes, carpetes personalitzades iparàmetres a rols particulars, utilitzeu el panell lliscant Gestiona > Comptes >Espais de noms. Per obtenir més informació, consulteu: “Personalització de rols” ala pàgina 6.

Per assignar temes i pàgines inicials personalitzats a arrendataris determinats,utilitzeu el panel lliscant Gestiona > Multitarrendatari i, al panell de propietats del'arrendatari, seleccioneu la pestanya Personalització. Per obtenir més informació,consulteu: “Personalització d'arrendataris” a la pàgina 56.

61

Alguns tipus de personalització exigeixen l'ús del llenguatge de programacióJavaScript. Aquestes personalitzacions es descriuen en els temes següents.v “Creació d'un controlador d'acció personalitzat” a la pàgina 69v “Creació d'una vista (una que no sigui una vista d'inici de sessió)” a la pàgina

82v “Creació d'una vista d'inici de sessió” a la pàgina 84

La resta de tipus de personalització no requereixen coneixements de programació.

Els esquemes JSON que s'utilitzen per definir personalitzacions són provisionals ipoden canviar en futures versions del Cognos Analytics de manera que ja nosiguin compatibles amb versions anteriors.

Exemples de personalitzacióHi ha exemples de personalització disponibles per ensenyar a crear temes,extensions i vistes. Podeu modificar aquests exemples per crear les vostres pròpiespersonalitzacions.

Aquests fitxers d'exemple s'instalvlen amb el producte en una Instalvlació fàcil i sónopcionals en una Instalvlació personalitzada. Després de la instalvlació, els podeutrobar a la carpeta installation_location/samples/.

Els exemples de personalització es descriuen en els temes següents.v “Temes d'exemple” a la pàgina 64v “Extensions d'exemple” a la pàgina 78v “Vistes d'exemple” a la pàgina 88

Utilització d'exemples

Els exemples de personalització mostren com implementar les personalitzacionsque s'utilitzen més sovint. Podeu visualitzar el codi d'exemple i modificar-lo percrear personalitzacions per als vostres usuaris. Per examinar el contingut d'unexemple de personalització, heu d'extreure el contingut del fitxer .zip. Cadaexemple conté un fitxer spec.json que conté la lògica per a la personalització. Pothaver-hi també altres fitxers o carpetes que contenen fitxers d'imatges, fitxersJavaScript i fitxers HTML, segons la personalització.

Per carregar i utilitzar un tema o extensió d'exemple, seguiu les instruccions de“Gestió de temes, extensions, vistes i paràmetres” a la pàgina 90.

Creació de temesPodeu alterar temporalment el tema de IBM Cognos Analytics estàndard de lainterfície d'usuari de Cognos Analytics per reflectir la vostra marca corporativa.

La personalització d'exemple, SampleTheme.zip, mostra com crear un tema. El fitxer.zip conté un fitxer, spec.json, que defineix el tema i una carpeta, images, queconté les imatges gràfiques associades amb aquest tema. Els noms de fitxers nocontenen espais.

Nota: El vostre tema específic pot consistir en una carpeta com ara “elmeuTema”que contingui un fitxer .json i la carpeta d'imatges (que conté els gràfics). Quan escrea el fitxer zip, no s'ha d'incloure la carpeta (ex., “elmeuTema”) al fitxer zip;


Cognos Analytics no estarà disponible per processar. Tanmateix, seleccioneu elfitxer .json i la carpeta d'imatges, i després utilitzeu un programa de compressióper tal de crear el fitxer .zip. No utilitzeu la característica de Windows Explorer“enviar a carpeta comprimida” per crear el fitxer .zip; podria donar com a resultatun fitxer incompatible.

Aquí es mostra el fitxer spec.json.{

"name": "Sample_Theme","schemaVersion": "2.0","brandText": "the Sample Outdoors Company","brandTextSmall": "Sample Outdoors Company","images": {"brandIcon": "images/logo_large.png","brandIconSmall": "images/logo_small.png","favicon": "images/logo_fav.png"

},"colors": {"appbarBackground": "#eeeeee","appbarForeground": "black","appbarSelectLine": "#033f38","appbarPushButtonBackground": "#c8d2d1","navbarBackground": "#1c96d4","navbarForeground": "white","navbarSelectLine": "#033f38","navbarPushButtonBackground": "#007670"

}}

Els exemples actuals no inclouen els elements brandTextSmall i favicon. S'inclouenaquí per finalitat documentativa.

Els objectes d'aquest fitxer es correlacionen amb els elements de la interfícied'usuari de Cognos Analytics com es mostra aquí. Si no es tenen en compte elselements del tema, es fa servir l'element del tema per defecte Cognos Analytics.

Aquesta taula relaciona els elements de la interfície d'usuari amb els objectes JSON.

Capítol 8. Personalització de Cognos Analytics a tots els rols 63

Taula 5. Objectes de tema

Referència de lainterfícied'usuari Descripció de JSON Definició

1 brandText Text de marca. Introduir un sèriebuida per deixar aquesta entradaen blanc.

2 brandTextSmall Petit text de marca. Si s'omet,s'utilitza, brandText. Introduir unsèrie buida per deixar aquestaentrada en blanc.

3 brandIcon Icona de la marca

4 brandIconSmall Icona petita de la marca

5 appbarBackground Color de fons de la barrad'aplicacions

5 appbarForeground Color de primer pla de la barrad'aplicacions

5 appbarSelectLine Color de línia de selecció de labarra d'aplicacions

5 appbarPushButtonBackground Color de fons del polsador de labarra d'aplicacions

6 navbarBackground Color de fons de la barra denavegació

6 navbarForeground Color de primer pla de la barra denavegació

6 navbarSelectLine Color de línia de selecció de labarra de navegació

6 navbarPushButtonBackground Color de fons del polsador de labarra de navegació

favicon Icona per visualitzar en unapestanya del navegador web.

Temes d'exempleEstan disponibles els exemples següents, que ilvlustren l'ús dels temes.

Aquests exemples s'instalvlen a la carpeta <ubicació_instalvlació>/samples/themes.

SampleTheme.zipUn tema que modifica la marca i l'esquema de color de la interfícied'usuari de Cognos Analytics.

SampleThemeBlueGreen.zipUn tema que modifica l'esquema de color de la interfície d'usuari deCognos Analytics.

SampleThemeDarkBlue.zipUn tema que modifica l'esquema de color de la interfície d'usuari deCognos Analytics.

SampleThemeLight.zipUn tema que modifica l'esquema de color de la interfície d'usuari deCognos Analytics.


Creació d'extensionsPodeu crear extensions que afegeixin funcions a la interfície d'usuari de l'IBMCognos Analytics. Per exemple, podeu afegir botons que en clicar-los, obrin uninforme o panell d'eines concrets. També podeu eliminar botons per defecte de lainterfície d'usuari.

Per poder crear o carregar extensions, heu de tenir privilegis d'administrador delportal o d'administrador del sistema.

Les extensions es defineixen en un fitxer spec.json inclòs en l'arrel del fitxer .zipde l'extensió. En funció de l'extensió, és possible que també hi hagi carpetes queincloguin imatges, fitxers HTML i fitxers JavaScript. L'estructura i el contingut delfitxer spec.json es descriu a “Descripció de spec.json” a la pàgina 92. Aquí esmostra l'estructura d'alt nivell del fitxer.{"name":"...","schemaVersion": "1.0","extensions": [{"perspective": "common","features": [{"id": "...","toolItems": [<element_eina>,<element_eina>,...],"collectionItems":

[<element_recopilació1>,<element_recopilació2>,...],"excludeFeatures": [<funció_exclusió1>,<funció_exclusió2>,...],"excludeItems": [<element_exclusió1>,<element_exclusió2>,...]}]}}

El valor de l'element perspectiva indica quines vistes utilitzaran aquesta extensió.Un valor comú significa que l'extensió s'utilitza per a totes les vistes. Els articlescontinguts en la matriu de funcions s'utilitzen segons l'acció de l'extensió. Esdescriuen en els temes següents.

Mitjançant la creació d'extensions, podeu modificar les vistes existents i crear denoves. Les accions que una extensió pot realitzar apareixen llistades aquí y esdescriuen en els temes següents. Una sola extensió pot realitzar una o més accions.v Afegir un botó a les barres d'aplicacions o de navegació que realitza accions com

ara visualitzar un lloc web, executar un informe o obrir un panell d'eines, unahistòria o una carpeta.

v Afegir un element de menú en un menú existent que realitza accions como aravisualitzar un lloc web, executar un informe o obrir un panell d'eines, unahistòria o una carpeta.

v Afegir un menú juntament als seus elements de menú.v Eliminar un element o funció de la interfície d'usuari per defecte.v Afegir formes personalitzades per utilitzar-les als panells d'eines.v Afegir ginys personalitzats per utilitzar-los als panells d'eines.

Addició d'un botó o d'un element de menúPodeu afegir botons i elements de menú per realitzar diverses accions, como aravisualitzar un lloc web, executar un informe, obrir un panell d'eines, una història ouna carpeta. També podeu crear accions personalitzades.


Tots els botons requereixen un controlador d'acció. Existeixen quatre controladorsd'acció incorporats que realitzen accions comunes. Aquestes accions es mostren acontinuació.

bi/glass/api/IFrameOpenerObre una pàgina web.

bi/glass/api/ReportOpenerExecuta un informe.

bi/glass/api/DashboardOpenerObre un panell d'eines.

bi/glass/api/FolderOpenerObre una carpeta.

També podeu escriure controladors d'accions comunes utilitzant JavaScript.

El contingut del fitxer json.spec és similar per els botons i els elements de menú iestan descrits junts. La principal diferència es troba en què el valor de l'elementtype es button per a un botó, i menuItem per a un element de menú. En elssegüents temes es descriuen altres diferències.

Utilització de controladors d'acció incorporatsExisteixen quatre controladors d'acció incorporats disponibles. Aquestscontroladors d'acció poden obrir una pàgina web, executar un informe, obrir unacarpeta i obrir un panell d'eines o història. Els controladors d'acció es descriuen enles seccions següents.

Obertura d'una pàgina web

Utilitzeu el controlador d'accions bi/glass/api/IFrameOpener per obrir una pàginaweb. Les opcions disponibles es mostren aquí.

url Especifica l'URL de la pàgina web que s'obrirà.

title Especifica el títol de la pàgina web que es mostrarà.

L'extensió del fitxer SampleExtensionButtonWebsite.zip de mostra obre una pàginaweb. Aquí es mostra el fitxer spec.json.{"name":"Sample_Button_Website","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Hi ha una metaperspectiva especial anomenada COMMON. Si s’afegeixen

contribucions a aquesta perspectiva, l’extensió s’aplicaràa totes les perspectives.",

"features": [{"id": "sample.common.button.openWebsite","toolItems": [{"comment": "Aquest codi mostrarà un botó personalitzat de Lloc web que obre

la URL especificada en un iFrame.","id": "sample.iframeOpener.website","containerId": "com.ibm.bi.glass.navbarTrailingGroup","label": "Lloc web","type": "Button","icon": "images/web.png","weight": 100,"actionController": "bi/glass/api/IFrameOpener","options": {"url": "http://www.ibm.com/analytics/us/en/technology/products/cognos-analytics/",


"title": "Lloc web"}}]}]}]}

L'etiqueta del botó és Lloc web i la icona del botó és la imatge web.png, que estroba a la carpeta images. El controlador d'accions és bi/glass/api/IFrameOpener irequereix dues opcions: l'URL de la pàgina web (url) i el títol de la pàgina webque es mostrarà quan s'obri la pàgina (title). Els altres elements del fitxerspec.json es descriuen a “Descripció de spec.json” a la pàgina 92.

Execució d'un informe

Utilitzeu el controlador d'accions bi/glass/api/ReportOpener per executar uninforme. Les opcions disponibles es mostren aquí. Cal especificar id o path.

id Especifica l'storeID de l'informe que s'executarà.

path Especifica el camí d'accés de l'informe que s'executarà.

L'extensió del fitxer SampleExtensionButtonReport.zip de mostra executa uninforme. Aquí es mostra el fitxer spec.json.{"name":"Sample_Button_Report","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Hi ha una metaperspectiva especial anomenada COMMON. Si s’afegeixen

contribucionsa aquesta perspectiva, l’extensió s’aplicarà

a totes les perspectives.","features": [{"id": "sample.common.button.openReport","toolItems": [{"comment": "Aquest codi afegeix un botó a la barra de navegació per obrir directament uninforme popular.","id": "sample.report.opener","containerId": "com.ibm.bi.glass.navbarLeadingGroup","label": "Ingressos trimestrals fins a la data","type": "Button","icon": "common-report","weight": 800,"comment": "Contra més pesi l’element, més amunt apareix al contenidor.","actionController": "bi/glass/api/ReportOpener","options": {"path": ".public_folders/Samples/Extensions/QTD revenue"}}]}]}]}

El controlador d'acció és bi/glass/api/ReportOpener i requereix una opció, el camía l'informe (path). .public_folders és la carpeta arrel del Contingut d'equip i.my_folders és la carpeta arrel de El meu contingut. Si el nom de l'informe contéuna barra inclinada (/), cal codificar-se com %2F. Els altres elements del fitxerspec.json es descriuen a “Descripció de spec.json” a la pàgina 92.


Obertura d'un panell d'eines o d'una història

Utilitzeu el controlador d'accions bi/glass/api/DashboardOpener per obrir unpanell d'eines o una història. Les opcions disponibles es mostren aquí. Calespecificar id o path.

id Especifica l'storeID del panell d'eines o la història que s'obrirà.

path Especifica el camí d'accés del panell d'eines o la història que s'obrirà.

L'extensió del fitxer SampleExtensionButtonDashboard.zip de mostra obre unpanell d'eines. Aquí es mostra el fitxer spec.json.{"name":"Sample_Button_Dashboard","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Hi ha una metaperspectiva especial anomenada COMMON. Si s’afegeixen


a totes les perspectives.","features": [{"id": "sample.common.button.openDashboard","toolItems": [{"comment": "Aquest codi afegeix un botó per obrir directament un panell d’eines del nucli.","id": "sample.dashboard.opener","containerId": "com.ibm.bi.glass.navbarLeadingGroup","label": "Panell d’eines de línia","type": "Button","icon": "common-dashboard","weight": 900,"comment": "Contra més pesi l’element, més amunt apareix al contenidor.","actionController": "bi/glass/api/DashboardOpener","options": {"path": ".public_folders/Samples/Extensions/Line dashboard"}}]}]}]}

El controlador d'acció és bi/glass/api/DashboardOpener i l'única opció és el camíal panell d'eines (path) que es determina de la mateixa manera que el camí al'informe. Els altres elements del fitxer spec.json es descriuen a “Descripció despec.json” a la pàgina 92.

Obertura d'una carpeta

Utilitzeu el controlador d'accions bi/glass/api/FolderOpener per obrir unacarpeta. Les opcions disponibles es mostren aquí. Cal especificar id o path.

id Especifica l'storeID de la carpeta que s'obrirà.

path Especifica el camí d'accés de la carpeta que s'obrirà.

skipAncestorsEspecifica si les carpetes d'ancestres s'han de mostrar (false) o s'hand'ocultar (true) quan s'obre la carpeta. El valor per defecte és false.

L'extensió del fitxer SampleExtensionButtonFolder.zip de mostra obre una carpeta.Aquí es mostra el fitxer spec.json.{"name":"Sample_Button_Folder","schemaVersion": "1.0",


"extensions": [{"perspective": "common","comment": "Hi ha una metaperspectiva especial anomenada COMMON. Si s’afegeixen


a totes les perspectives.","features": [{"id": "sample.common.button.openFolder","toolItems": [{"comment": "Aquest codi afegeix un botó per accedir fàcilment a una carpeta important.","id": "sample.folder.opener","containerId": "com.ibm.bi.glass.navbarLeadingGroup","label": "Informes de 2016","type": "Button","icon": "common-folder","weight": 700,"push": "true","comment": "Contra més pesi l’element, més amunt apareix al contenidor.","actionController": "bi/glass/api/FolderOpener","options": {"path": ".public_folders/Samples/Extensions"}}]}]}]}

Aquest exemple té l'element "push": "true". Aquest element és necessari per obriruna carpeta perquè els botons per obrir una carpeta tenen dos estats: obrir i tancar.(Aquest element no s'utilitza als elements de menú.) Si premeu el botó de noudesprés d'obrir una carpeta, aquesta es tancarà. El controlador d'acció ésbi/glass/api/FolderOpener i l'única opció és el camí a la carpeta (path) que esdetermina de la mateixa manera que el camí a un informe. Els altres elements delfitxer spec.json es descriuen a “Descripció de spec.json” a la pàgina 92.

Creació d'un controlador d'acció personalitzatPodeu crear controladors d'acció personalitzats per realitzar accions que no estandisponibles amb els controladors d'acció incorporats. Els controladors d'acciópersonalitzats estan escrits amb JavaScript i utilitzen l'API AMD (AsynchronousModule Definition).

L'extensió del fitxer SampleExtensionContextMenuItem.zip de mostra implementaun controlador d'acció personalitzat que afegeix un element de menú al menúcontextual per a tots els objectes d'informe. Aquí es mostra el fitxer spec.json.{"name":"Sample_Context_Menu_Item","comment": "Aquesta extensió afegirà un element de menú nou al menú contextual per

tots els objectes de l’informe.","comment": "L’element de menú obrirà un quadre d’alerta que proporciona informació

sobre l’informe seleccionat.","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Hi ha una metaperspectiva especial anomenada COMMON. Si s’afegeixencontribucions

a aquesta perspectiva, l’extensió s’aplicaràa totes les perspectives.",

"features": [{"id": "sample.home.context.item","toolItems": [{"id": "custom.context.menu.item1","containerId" : "com.ibm.bi.contentApps.listViewMenu","comment": "containerId és l’ID del menú pare.",


"type": "MenuItem","actionController":

"v1/ext/Sample_Context_Menu_Item/js/controllers/SampleContextMenuItem","label": "Element de menú de mostra","icon": "common-properties","weight":950}]}]}]}

El controlador d'acció personalitzat és el fitxer SampleContextMenuItem.js i es trobaa la carpeta js/controllers de l'extensió. El fitxer es mostra aquí./*** Licensed Materials - Property of IBM** IBM Cognos Products: BI Glass** Copyright IBM Corp. 2015** Drets restringits dels usuaris del govern dels EUA: l’ús, la duplicació o divulgació* estan subjectes a les restriccions publicades al GSA ADP Schedule Contract amb IBM Corp.*/define([], function() {’use strict’;

var SampleAction = function(){

/*** Cridat per l’AppController quan es crea aquesta vista** @public* @returns {Promise} promesa resolta a l’element DOM arrel per aquesta vista.*/this.isVisible = function(context, target) {return target.options[0].type === ’report’;},

/*** Cridat per l’AppController quan es destrueix aquesta vista** @public*/this.execute = function(context, target) {var info = ’Aquesta extensió d’element de menú de mostra obre una alerta.\nL’alerta conté informació sobre l’informe seleccionat.\n\nType: ’ + target.options[0].type + ’\nName: ’ + target.options[0].name+ ’\nID: ’ + target.options[0].id;alert(info);}

};

return SampleAction;

});

Aquest codi JavaScript utilitza l'API d'Acció en un mòdul AMD JavaScript. Aquestsmòduls requereixen la biblioteca Q de JavaScript. L'API d'Acció consta de dosmètodes.

void execute(context, target)


contextAquest objecte conté mètodes de programa d'utilitat.

target Aquest objecte conté informació sobre el botó o l'element de menúque es crea mitjançant l'extensió.v Per a un botó o un element de menú d'una barra d'aplicacions o

d'un menú de la barra de navegació, aquest objecte conté lapropietat d'opcions de l'element.

v Per a un element de menú en un menú contextual d'un objecte,aquest objecte conté una matriu del tipus, nom i identificadorsd'emmagatzematge de l'objecte.

boolean isVisible(context, target)Aquest mètode només es pot aplicar als elements de menú. L'element demenú es visualitza si aquest mètode torna true; en cas contrari, l'elementde menú queda ocult.

Addició d'un menúPodeu afegir un menú i els seus elements de menú associats a les barresd'aplicacions o de navegació.

L'extensió del fitxer SampleExtensionMenuQuicklinks.zip de mostra afegeix unmenú i sis elements de menú. Part del fitxer spec.json es mostra aquí.{"name":"Sample_Menu_Quicklinks","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Hi ha una metaperspectiva especial anomenada COMMON. Si s’afegeixen


a totes les perspectives.","features": [{"id": "sample.common.menu.openMulipleItems","toolItems": [{"comment": "Aquest codi afegeix un element de menú personalitzat a la barra d’aplicacions al

grup final.","id":"custom.appbar.trailingGroup.menu","containerId": "com.ibm.bi.glass.appbarTrailingGroup","type": "Menu","label": "Enllaços ràpids","icon": "images/debug.svg","weight": 650},{"comment": "Aquest codi afegeix un element de submenú al menú personalitzat creat a dalt.","id": "custom.appbar.trailingGroup.menuItem1","containerId" : "custom.appbar.trailingGroup.menu","comment": "containerId és l’ID del menú pare.","type": "MenuItem","actionController": "v1/ext/Sample_Menu_Quicklinks/js/controllers/SampleMenuQuicklinks","comment": "actionController determina les accions de l’element de menú.","label": "Inici","icon": "common-home","weight":900},{"comment": "Aquest codi afegeix un element de submenú al menú personalitzat creat a dalt.","id": "custom.appbar.trailingGroup.menuItem2","containerId" : "custom.appbar.trailingGroup.menu","comment": "containerId és l’ID del menú pare.",


"label": "Panell d’eines de línia","type": "MenuItem","icon": "common-dashboard","weight": 800,"actionController": "bi/glass/api/DashboardOpener","comment": "actionController determina les accions de l’element de menú.","options": {"path": ".public_folders/Samples/Extensions/Line dashboard"}},...]}]}]}

En aquest exemple, el menú es troba al grup final de la barra d'aplicacions.

Eliminació d'un element de la interfície d'usuariPodeu eliminar els elements d'usuari per defecte de totes les vistes o de les vistesespecificades.

L'extensió del fitxer SampleExtensionExcludeNotifications.zip de mostra eliminael botó Notificacions de la barra de navegació. Aquí es mostra el fitxer spec.json.{"name":"Sample_Exclude_Notifications","schemaVersion": "1.0","extensions": [{"perspective": "home","comment": "Aquest codi només s’aplica a la perspectiva HOME.","features": [{"id": "sample.home.exclude.notifications","excludeItems":["com.ibm.bi.share.notifications"],"comment": "A sobre, EXCLUDEITEMS elimina el botó Notificacions de

la barra de navegació de la perspectiva HOME.","comment": "EXCLUDEITEMS ha d’aplicar-se al nivell de perspectiva individual.

No es pot utilitzar globalment mitjançant laperspectiva COMMON."

}]}]}

Per determinar l'identificador que cal utilitzar als valors de l'element excludeItems,consulteu “Com determinar l'id d'un objecte d'interfície d'usuari” a la pàgina 99.

Addició de formes de panell d'eines

Podeu crear formes personalitzades per utilitzar-les als panells d'eines.

L'exemple SampleExtensionCustomShape.zip crea tres noves formes per utilitzar-lesals panells d'eines. Aquest exemple s'instalvla igual que qualsevol altre extensió. Uncop s'hagi instalvlat, apareixen les tres formes noves següents al panell Formes.

Nota: Només es poden utilitzar com a formes de panell d'eines els fitxers.svg.

Aquí es mostra el contingut del fitxer spec.json.{"name":"Sample_Custom_Shape","comment":"Aquest exemple afegirà tres imatges personalitzades al final del


panell de formes al component de disseny de panells d’eines.","schemaVersion": "2.0","extensions": [{"perspective": "dashboard","comment": "Les formes personalitzades són per a la perspectiva de panell

d’eines només.","features": [{"id": "com.ibm.bi.dashboard","collectionItems": [{"containerId": "com.ibm.bi.dashboard.shapes","id": "sample_custom_shape_music","name": "Music","options": {"templatePath": "v1/ext/Sample_Custom_Shape/images/music_32.svg"

}},{"containerId": "com.ibm.bi.dashboard.shapes","id": "sample_custom_shape_relationship","name": "Relationship","options": {"templatePath": "v1/ext/Sample_Custom_Shape/images/relationship_32.svg"

}},{"containerId": "com.ibm.bi.dashboard.shapes","id": "sample_custom_shape_traffic","name": "Traffic","options": {"templatePath": "v1/ext/Sample_Custom_Shape/images/traffic_32.svg"

}}]}]}]}

Les formes personalitzades són a la carpeta images de l'exemple.

Creació d'una galeria d'imatges

Podeu crear una galeria d'imatges que contingui imatges personalitzades perutilitzar en panells d'eines i informes.

Els exemples SampleExtensionCustomMedia.zip iSampleExtensionCustomMediaAll.zip creen noves imatges per utilitzar en panellsd'eines i informes. Aquests exemples s'instalvlen com qualsevol altra extensió.

Un cop heu creat la galeria d'imatges, els usuaris poden seleccionar imatges coms'indica a continuació:v Els autors de panells d'eines poden seleccionar la pestanya Biblioteca d'imatges

al panell Ginys. Per obtenir més informació, consulteu la publicació Guia dePanells d'eines i històries.

v Els autors d'informes poden seleccionar la icona de Caixa d'eines ,

seleccionar Disseny, arrossegar l'objecte d'imatge a l'informes i desprésfer-hi doble clic. Per obtenir més informació, consulteu la Guia de creaciód'informes.


Les imatges disponibles a la biblioteca d'imatges tenen les següents descripcions:v Llampec nocturn a la ciutatv Llampecs a un cel fosc púrpurav Tràfic dens a la nitv Excursionista per un turó al boscv Diverses tendes de campanya a la muntanyav Gràfic amb els beneficis destacatsv Gràfic amb beneficisv Grup de persones en un centre d'atenció telefònica

Sample_Custom_Media

A continuació es mostra el contingut del fitxer spec.json per aSample_Custom_Media.{

"name": "Sample_Custom_Media","comment":"Aquesta extensió d’exemple afegirà imatges personalitzades al final del panellMEDIA al panells d’eines.","comment":"Actualment només s’admet afegir fitxers JPG i PNG.","schemaVersion": "1.0","extensions": [{

"perspective": "dashboard","comment": "Les imatges personalitzades són només per la perspectiva DASHBOARD.","features": [{

"id": "com.ibm.bi.common.media","comment": "Aquest és l’ID per al panell MEDIA. Serà el contenidor de les imatgessegüents.","collectionItems": [{

"containerId": "com.ibm.bi.common.media","id": "customImage1","name": "Llampecs a la ciutat",

"comment": "NAME és el text de l’ajuda contextual de la imatge.","options": {

"altText": "Llampec nocturn a la ciutat.","comment": "ALTTEXT es mostra com a Propietat de la imatge seleccionada.",

"imageLink": "v1/ext/Sample_Custom_Media/images/SE_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage2","name": "Llampecs al cel","options": {

"altText": "Llampecs nocturns al cel púrpura.","imageLink": "v1/ext/Sample_Custom_Media/images/weather_background3.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage3","name": "Tràfic nocturn a la ciutat","options": {

"altText": "Tràfic dens nocturn a la ciutat.","imageLink": "v1/ext/Sample_Custom_Media/images/story_scene1_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage4","name": "Excursionista per un turó","options": {

"altText": "Excursionista per un turó al bosc.","imageLink": "v1/ext/Sample_Custom_Media/images/login_background.jpg"}

}, {


"containerId": "com.ibm.bi.common.media","id": "customImage5","name": "Tendes de campanya a la muntanya","options": {

"altText": "Diverses tendes de campanya a la muntanya.","imageLink": "v1/ext/Sample_Custom_Media/images/welcome_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage6","name": "Beneficis destacats","options": {

"altText": "Gràfic amb beneficis destacats.","imageLink": "v1/ext/Sample_Custom_Media/images/story_scene5_background2.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage7","name": "Beneficis ascendents","options": {

"altText": "Gràfic de beneficis ascendents.","imageLink": "v1/ext/Sample_Custom_Media/images/story_scene5_background.jpg"}

}]}]

}]}

Sample_Custom_Media_All

Aquí es mostra el contingut del fitxer spec.json per a Sample_Custom_Media_All.{

"name": "Sample_Custom_Media_All","comment":"Aquesta extensió d’exmple afegirà 8 imatges personalitzades a la pestanya IMAGE

LIBRARY del panell WIDGETS dels panells d’eines i històries.","comment":"També afegirà les mateixes 8 imatges personalitzades al diàleg IMAGE PICKER en crearinformes a IMAGE GALLERY.","comment":"En aquest moment només s’admeten fitxers JPG i PNG.","comment":"Aquests tipus d’extensions no són additius. Heu d’especificar totes les imatgespersonalitzades que necessiteu en una extensió.","comment":"En cas contrari, l’última extensió carregada (no ACTUALITZADA) tindrà prioritat iesdevindrà la vostra biblioteca d’imatges final.",

"schemaVersion": "1.0","extensions": [{

"perspective": "common","comment": "Les imatges personalitzades s’aplicaran a totes les perspectives: creació

d’informes, creació de panells d’eines i històries.","features": [{

"id": "com.ibm.bi.common.media","comment": "És l’ID del panell Ginys. Serà el contenidor de les imatges

següents.","collectionItems": [{

"containerId": "com.ibm.bi.common.media","id": "customImage1","name": "Llampecs a la ciutat",

"comment": "El NAME és el text de l’ajuda contextual de la imatge a la pestanya Bibliotecad’imatges.",

"options": {"altText": "Llampec nocturn a la ciutat.",

"comment": "El ALTTEXT es mostra a la propietat Descripció de la imatge seleccionada unavegada que es col•loca en el panell d’eines.",

"imageLink": "v1/ext/Sample_Custom_Media_All/images/SE_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage2",


"name": "Llampecs al cel","options": {

"altText": "Llampecs nocturns al cel púrpura.","imageLink": "v1/ext/Sample_Custom_Media_All/images/weather_background3.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage3","name": "Tràfic nocturn a la ciutat","options": {

"altText": "Tràfic dens nocturn a la ciutat.","imageLink": "v1/ext/Sample_Custom_Media_All/images/story_scene1_background.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage4","name": "Excursionista per un turó","options": {

"altText": "Excursionista en un turó en el bosc.","imageLink": "v1/ext/Sample_Custom_Media_All/images/login_background.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage5","name": "Tendes de campanya a la muntanya","options": {

"altText": "Diverses tendes de campanya a la muntanya.","imageLink": "v1/ext/Sample_Custom_Media_All/images/welcome_background.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage6","name": "Centre d’atenció telefònica","options": {

"altText": "Grup de persones en un Centre d’atenció telefònica.","imageLink": "v1/ext/Sample_Custom_Media_All/images/call_center.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage7","name": "Beneficis destacats","options": {

"altText": "Gràfic amb beneficis destacats.","imageLink": "v1/ext/Sample_Custom_Media_All/images/story_scene5_background2.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage8","name": "Beneficis ascendents","options": {

"altText": "Gràfic de beneficis ascendents.","imageLink": "v1/ext/Sample_Custom_Media_All/images/story_scene5_background.jpg"

}}

]}

]}

]}

Addició d'un giny de panell d'eines

Podeu crear ginys personalitzats per utilitzar-los als panells d'eines.


Podeu crear ginys personalitzats per utilitzar-los als panells d'eines. Els ginyspersonalitzats s'instalvlen igual que altres extensions. L'acció del giny la determinaun fitxer JavaScript que pot executar qualsevol acció JavaScript i visualitza elresultat al giny.

Un giny personalitzat senzill conté un fitxer spec.json, un fitxer JavaScript i unacarpeta que conté imatges utilitzades pel giny. Aquí es mostra el fitxer spec.json.{"name":"SampleWidgetExt_old","schemaVersion": "1.0","extensions": [{"perspective": "dashboard","comment": "Ginys personalitzats d’exemple per al panell d’eines","features": [{"id": "com.ibm.bi.dashboard.widgets","collectionItems": [{"containerId": "com.ibm.bi.dashboard.widgets","id": "Hello","title": "Hello!","iconUrl": "v1/ext/SampleWidgetExt/images/ibm.png","widget": "v1/ext/SampleWidgetExt/helloParam.js","scroll": "scrollNone","disableTitle": true,"params" : {"name": "IBM"

}}]}]}]}

Aquest giny crida el fitxer JavaScript helloParam.js, que es mostra aquí.define([’jquery’,’dashboard/widgets/CustomWidget’], function( $, Base) {

var Widget = Base.extend({onInit: function(params) {this.name = params.name;},onRender: function() {var root = this.getContentRootNode();$(root).append(’<h1 class="titleColor titleFontSize">Hello ’ + this.name + ’!</h1>’);}});

return Widget;});

La carpeta images conté la imatge gràfica ibm.png.

Després d'instalvlar l'extensió, els usuaris que creïn un panell d'eines veuran una

icona nova, Ginys personalitzats ( ). Quan facin clic a Ginys personalitzats (

), podran arrossegar el giny personalitzat al llenç del panell d'eines. El ginypersonalitzat es mostra aquí.


Extensions d'exempleEstan disponibles els exemples següents, que ilvlustren l'ús de les extensions.

Aquests fitxers d'exemple s'instalvlen amb el producte en una Instalvlació fàcil i sónopcionals en una Instalvlació personalitzada. Després de la instalvlació, els podeutrobar a la carpeta ubicació_instalvlació/samples/extensions.

SampleExtensionButtonDashboard.zipUna extensió que afegeix un botó per obrir un panell d'eines en totes lesvistes.

SampleExtensionButtonFolder.zipUna extensió que afegeix un botó per obrir una carpeta en totes les vistes.

SampleExtensionButtonOpenPerspective.zip

Una extensió que crea una vista personalitzada i afegeix un botó ( ) a labarra de navegació en totes les vistes que obrin la vista personalitzada.

SampleExtensionButtonReport.zipUna extensió que afegeix un botó per obrir un informe en totes les vistes.

SampleExtensionButtonWebsite.zipUna extensió que afegeix un botó per obrir un lloc web en totes les vistes.

SampleExtensionContextMenuItem.zip

Extensió que afegeix un element de menú ( ) al menú emergent per atots els objectes d'informe. Quan se selecciona, l'element de menú obre unaalerta que mostra informació sobre l'informe.

SampleExtensionCustomMedia.zipExtensió que afegeix imatges personalitzades que es poden fer servir alspanells d'eines.

SampleExtensionCustomMediaAll.zipUna extensió que afegeix imatges personalitzades que es poden utilitzartant en panells d'eines com en informes.

SampleExtensionCustomShape.zipExtensió que afegeix formes personalitzades que es poden fer servir alspanells d'eines.

SampleExtensionExcludeDelete.zipUna extensió que elimina el botó Suprimeix de tots els objectes de totes lesvistes.


SampleExtensionExcludeNotifications.zipUna extensió que elimina el botó Notificacions de totes les vistes.

SampleExtensionMenuQuicklinks.zipUna extensió que afegeix un menú en totes les vistes.

SampleExtensionMenuUrlLinks.zipUna extensió que mostra com afegir un menú a l'AppBar que conté doselements del menú que obren URL externs.

SampleExtensionOpenFolderShowHideParent.zipExtensió que mostra l'ús de l'opció skipAncestors en obrir una carpeta.

SampleExtensionsAll.zipUna extensió que combina les extensionsSampleExtensionButtonDashboard.zip, SampleExtensionButtonFolder.zip,SampleExtensionButtonWebsite.zip, SampleExtensionButtonReport.zip,SampleExtensionContextMenuItem.zip, SampleExtensionExcludeDelete.zip,SampleExtensionMenuQuicklinks.zip iSampleExtensionExcludeNotifications.zip.

SampleExtensionTabs.zipExtensió que afegeix un grup de pestanyes a la vista d'inici i proporcionaaccés ràpid a determinats informes i panells d'eines.

Utilització de l'extensió de recopilació de pestanyes

Aquesta tasca ensenya com instalvlar i utilitzar l'extensió de recopilació depestanyes.


L'extensió de recopilació de pestanyes imita les pàgines de portal disponibles a lesversions anteriors de l'IBM Cognos Business Intelligence. Aquesta extensió afegeixtres botons a la barra de navegació com es mostra aquí.

Cada botó correspon a una pestanya d'una pàgina de portal. Feu clic al botó Visiógeneral per visualitzar una subcarpeta que conté dos elements: el panell d'einesLínia de producte per any i l'informe Quantitat venuda. La subcarpeta ésequivalent a una subpestanya d'una pàgina de portal.


Feu clic al botó Ingressos per visualitzar una subcarpeta que conté tres elements: elpanell d'eines Per any, la carpeta Per trimestre que conté quatre informes, il'informe QTD.

Feu clic al botó Minorista per obrir un panell d'eines.

Procediment

Carregueu el fitxer de desplegament Samples_for_Install. (Si no ho heu fet ja.)1. Utilitzeu Gestiona > Consola d'administració per obrir l'IBM Cognos

Administration.2. A la pestanya Configuració, feu clic a Administració del contingut.3. A la barra d'eines, feu clic al botó Importació nova.4. Seleccioneu Samples_for_Install al primer pas de l'assistent Importació nova i

completeu els passos restants de l'assistent.Carregueu l'extensió d'exemple SampleExtensionTabs.zip.5. En el panell lliscant Gestiona > Personalitzacions, seleccioneu la pestanya

Extensions, premeu Carrega extensió ( ), aneu a la carpeta<ubicació_instalvlació>/samples/extensions i seleccioneuSampleExtensionTabs.zip.

Resultats

Ara podeu utilitzar aquesta extensió.

Creació de vistesLa interfície d'usuari de IBM Cognos Analytics consta de vistes, com ara inici, inicide sessió, creació, panell d'eines i modelatge. Podeu crear vistes personalitzadesper incrementar les vistes incorporades.

Les vistes estan definides al fitxer spec.json, que es troba a l'arrel del fitxer .zip dela visualització. Les vistes personalitzades també inclouen un element HTML divque substitueix el panell central de la interfície d'usuari de Cognos Analytics. Lesvistes personalitzades també poden afegir o eliminar menús i botons de les barresd'aplicacions i de navegació, o eliminar una o les dues barres. L'estructura i el


contingut del fitxer spec.json es descriu a “Descripció de spec.json” a la pàgina92. Aquí es mostra l'estructura d'alt nivell del fitxer.{"name": "<nom>","schemaVersion": "2.0","extensions": [{"perspective":"<nom_vista>","type":"<inici_o_inicisessió>","features": [{"id": "<id>","toolItems":

[<element_eina1>,<element_eina2>,...],"collectionItems":

[<element_recopilació1>,<element_recopilació2>,...],"excludeFeatures":

[<funció_exclusió1>,<funció_exclusió2>,...],"excludeItems":

[<element_exclusió1>,<element_exclusió2>,...]"content": {"type":"<camí_a_fitxer_javascript>","options": {...}

}},"cssStyles": ["<camí_a_fitxer_css>"]

}]}]}

Les vistes s'empaqueten com a extensions i un fitxer .zip de visualització tambépot contenir elements d'extensió. Per exemple, el fitxerSampleExtensionButtonOpenPerspective.zip de mostra defineix una visualitzaciópersonalitzada i també afegeix un botó a la barra de navegació de la vista d'inicique mostra la vista personalitzada.

L'element content conté el camí i el nom del fitxer de JavaScript que s'executa percrear la vista personalitzada. L'element options conté qualsevol opció querequereixi el fitxer de JavaScript. Els fitxers de JavaScript utilitzen l'API AMD(Asynchronous Module Definition).

Un tipus especial de vista és la d'inici de sessió. Aquest tipus de vista us permetcrear una pàgina d'inici de sessió personalitzada per Cognos Analytics. El valor del'element type determina si es tracta d'una vista d'inici de sessió (el valor és login)o no (el valor és home).

A diferència de les extensions, les vistes s'han d'invocar explícitament per què espuguin obrir. Una vista es pot invocar de tres maneres.v Es pot definir un botó o un element de menú per obrir la vista.v La vista es pot obrir mitjançant una URL com s'indica a continuació.

http://<servidor>:<port>/bi/?perspective=<nom_vista>

v Es pot definir que la vista sigui la vista d'inici per defecte per a un usuari o unrol, o per a tots els usuaris. Per obtenir més informació, consulteu: “Gestió detemes, extensions, vistes i paràmetres” a la pàgina 90.


Creació d'una vista (una que no sigui una vista d'inici desessió)

El fitxer SampleWelcome.zip de mostra és un exemple de vista que substitueix lavista d'inici incorporada per una versió alternativa que inclou la marca corporativade Sample Outdoors Company.

El fitxer SampleWelcome.zip de mostra conté un fitxer spec.json que defineix lavista. Aquest fitxer es mostra aquí.{

"name": "Sample_Welcome","schemaVersion": "2.0","extensions": [{"perspective":"Sample welcome","type":"home","features": [{

"id": "com.sample.welcome","excludeItems": ["com.ibm.bi.glass.common.cognosLogo"],"toolItems": [{"id": "brandLogoHomePage","containerId" : "com.ibm.bi.glass.appbarLeadingGroup","type": "bi/glass/app/plugins/GlassPlugin","class": "cognosIcon cognosLogo","label":"theme.current.brandTextSmall","icon": "theme.current.images.brandIconSmall","weight": 995}],

"content": {"type":"v1/ext/Sample_Welcome/js/views/SampleWelcomeView","options": {

"info":{"title":"Sample welcome","icon":"v1/ext/Sample_Welcome/images/bee_blue.svg"

}}

},"cssStyles": ["v1/ext/Sample_Welcome/css/SampleWelcomeCSS.css"]

}]}]

}

Es fa referència a la vista com Sample welcome als panells de gestió depersonalització. El fitxer spec.json enllaça a un fitxer SampleWelcomeView.js a lasubcarpeta js/views de la vista. L'entrada "type":"home" indica que aquesta vistapot definir-se com la vista d'inici per defecte. L'element cssStyles defineix el fitxer.css que s'utilitza quan es visualitza la vista.

Aquí es mostra el fitxer SampleWelcomeView.js./*** Licensed Materials - Property of IBM** IBM Cognos Products: BI Glass** Copyright IBM Corp. 2015** US Government Users Restricted Rights - Use, duplication or disclosure restricted* by GSA ADP Schedule Contract with IBM Corp.*/define([’q’,

’text!./SampleWelcomeView.html’,], function(Q, html) {


’use strict’;

var ContentView = function(){

/*** Cridat per l’AppController quan es crea aquesta vista** @public* @returns {Promise} promesa resolta a l’element DOM arrel per aquesta vista.*/

this.open = function(context, options) {this.logger = context.logger;this.options = options;var deferred = Q.defer();

var root = document.createElement(’div’);root.setAttribute(’class’,’welcome’);

root.innerHTML = html;deferred.resolve(root);return deferred.promise;

};

/*** Cridat per l’AppController quan es destrueix aquesta vista** @public*/

this.close = function() {this.logger.info(’close’);

};

/*** Cridat per l’AppController quan es mostra aquesta vista** @public*/

this.onShow = function() {this.logger.info(’onShow’);

};

/*** Cridat per l’AppController quan s’oculta aquesta vista** @public*/

this.onHide = function() {this.logger.info(’onHide’);

};

/*** Cridat per l’AppController quan es requereix informació de visualització peraquesta vista** @public* @returns {Object} displayInfo: la informació de visualització d’aquesta vista.* @returns {string} displayInfo.title: el título.* @returns {string} displayInfo.icon: la icona.*/

this.getDisplayInfo = function() {this.logger.info(’getDisplayInfo’);return {’title’:this.options.info.title,’icon’: this.options.info.icon

};};


};

return ContentView;

});

Aquest fitxer fa referència al SampleWelcomeView.html que es visualitza quans'invoca la vista.

Aquest codi JavaScript utilitza l'API de Vista en un mòdul AMD de JavaScript.Aquesta implementació utilitza la biblioteca Q de JavaScript. L'API de Vista constadels següents mètodes.

promise open(content. options)Aquest mètode s'invoca quan s'obra la vista. Torna un objecte Q promiseamb l'element DOM que representa la vista com a valor resolt.

contextConté l'objecte de context.

optionsConté les opcions incloses al fitxer spec.json.

void close()S'invoca just abans de tancar la vista.

void onShow()S'invoca just abans de mostrar la vista.

void onHide()S'invoca just abans d'ocultar la vista.

getDisplayInfo()Torna el títol i la icona associada de la vista.

Creació d'una vista d'inici de sessióAmb una vista d'inici de sessió personalitzada, podeu substituir la pàgina d'inicide sessió per defecte de IBM Cognos Analytics. Podeu utilitzar la vostra pròpiamarca corporativa i fer altres canvis a la pàgina d'inici de sessió.

Aquí es mostra una visió general d'alt nivell de l'estructura del codi JavaScriptnecessari per iniciar una sessió.

El fitxer SampleLogin.zip de mostra és un exemple de vista que substitueix la vistad'inici de sessió incorporada per una versió alternativa. El fitxer SampleWelcome.zipde mostra conté un fitxer spec.json que defineix la vista. Aquest fitxer es mostraaquí.{"name": "Sample_Login","schemaVersion": "2.0","extensions": [{"perspective":"Sample login","type": "login","features": [{"id": "com.sample.login","excludeItems":["com.ibm.bi.glass.navbar","com.ibm.bi.glass.appbar"],"content": {"type":"v1/ext/Sample_Login/login/js/views/SampleLoginView","options": {"info":{

"title":"Sample login"}


}},"cssStyles": ["v1/ext/Sample_Login/login/css/SampleLoginCSS.css"]}]}]}

Aquest fitxer spec.json és similar al mateix fitxer corresponent alSampleWelcome.zip de mostra llevat que el valor de l'element type és login i lesbarres d'aplicacions i de navegació estan excloses d'aquesta vista.


/*** @typedef {Object} LoginError* @property {string} message - missatge d’error*//*** efectua un inici de sessió** @public* @param {Object[]} loginPrompts - objecte que conté les sol•licituds d’inici de sessió* @param {string} loginPrompts[].name - nom de la sol•licitud d’inici de sessió* @param {string} loginPrompts[].value - valor de la sol•licitud d’inici de sessió* @return {Promise<undefined|LoginError} promise es resol sense cap objecte* quan l’inici de sessió és correcte, es rebutja amb un error quan falla.**/signin: function(loginPrompts)

Aquí es mostra el fitxer SampleLoginView.js./*** Licensed Materials - Property of IBM* IBM Cognos Products: BI Glass* Copyright IBM Corp. 2017* US Government Users Restricted Rights - Use, duplication or disclosure restricted* by GSA ADP Schedule Contract with IBM Corp.*/define([’q’,

’text!./SampleLoginView.html’,], function(Q, html) {’use strict’;

var ContentView = function(){

/*** Cridat per l’AppController quan es crea aquesta vista** @public* @returns {Promise} promesa resolta a l’element DOM arrel per aquesta vista.*/

this.open = function(context, options) {this.logger = context.logger;this.options = options;var deferred = Q.defer();

var root = document.createElement(’div’);root.setAttribute(’class’,’welcome’);

root.innerHTML = html;

var loginBtn = root.getElementsByClassName(’sample.loginBtn’)[0];loginBtn.onclick = function() {document.getElementsByClassName(’sampleIncorrectLoginText’)[0].innerHTML=’’;var uid = document.getElementsByClassName(’sample.username’)[0].value;


var pwd = document.getElementsByClassName(’sample.password’)[0].value;var loginPrompts = [

{name:’CAMNamespace’,value:’CognosEx’},{name:’h_CAM_action’,value:’logonAs’},{name:’CAMUsername’,value:uid},{name:’CAMPassword’,value:pwd}

];this.signin(loginPrompts).catch(this._loginError.bind(this));

}.bind(this);

deferred.resolve(root);return deferred.promise;

},

/*** Cridat per l’AppController quan es destrueix aquesta vista** @public*/

this.close = function() {this.logger.info(’close’);

},

/*** Cridat per l’AppController quan es mostra aquesta vista** @public*/

this.onShow = function() {this.logger.info(’onShow’);

},

/**** El codi directe següent recupera el missatge d’error del producte.* Si desitgeu incloure el vostre propi missatge d’error, utilitzeu* el codi del comentari següent:** this._loginError = function() {* document.getElementsByClassName(’sampleIncorrectLoginText’)[0].innerHTML=* ’Heu introduït una combinació de nom d’usuari/contrasenya no vàlida.’;* this.logger.error(’loginError’,arguments);* },***/

this._loginError = function(error) {document.getElementsByClassName(’sampleIncorrectLoginText’)[0].innerHTML=error.message;this.logger.error(’loginError’,arguments);

},

/*** Cridat per l’AppController quan s’oculta aquesta vista** @public*/

this.onHide = function() {this.logger.info(’onHide’);

},

/*** Cridat per l’AppController quan es requereix informació de visualització peraquesta vista** @public* @returns {Object} displayInfo: la informació de visualització d’aquesta vista.


* @returns {string} displayInfo.title: el título.* @returns {string} displayInfo.icon: la icona.*/

this.getDisplayInfo = function() {this.logger.info(’getDisplayInfo’);return {’title’:this.options.info.title,’icon’: this.options.info.icon

};}

};

return ContentView;

});

Una vista d'inici de sessió utilitza un mètode addicional.

promise login(credentials)Aquest mètode tramet una solvlicitud d'inici de sessió i torna un objectepromise que es rebutja si falla l'intent d'inici de sessió.

credentialsConté la informació d'inici de sessió.[{name:’CAMNamespace’,value:’<espai_de_noms>’},{name:’h_CAM_action’,value:’logonAs’},{name:’CAMUsername’,value:<nom_usuari>},{name:’CAMPassword’,value:<contrasenya>}]

Creació d'una vista d'inici de sessió amb una solvlicitudd'espai de noms

Utilitzant una vista d'inici de sessió personalitzada amb una solvlicitud d'espai denoms, podeu substituir la pàgina d'inici de sessió per defecte de IBM CognosAnalytics. Podeu especificar que l'usuari hagi de seleccionar d'una llista d'espais denoms a l'hora d'iniciar la sessió. També podeu utilitzar la vostra pròpia marcacorporativa i fer altres canvis a la pàgina d'inici de sessió.


El fitxer SampleLoginMultiple.zip de mostra és un exemple de vista quesubstitueix la vista d'inici de sessió incorporada per una versió alternativa. El fitxerSampleLoginMultiple.zip de mostra conté un fitxer spec.json que defineix la vista.Aquest fitxer es mostra aquí.{"name": "Sample_Login_Multiple","schemaVersion": "2.0","extensions": [{"perspective":"sampleLoginMultiple","type": "login","features": [{"id": "com.sample.login.multiple","excludeItems":["com.ibm.bi.glass.navbar","com.ibm.bi.glass.appbar"],"toolItems": [],"content": {"type":"v1/ext/Sample_Login_Multiple/login/js/views/SampleLoginView","options": {"info":{"title":"Sample login namespaces"}

}


},"cssStyles": ["v1/ext/Sample_Login_Multiple/login/css/SampleLoginCSS.css"]}]}]}

Aquest fitxer spec.json és similar al mateix fitxer corresponent al SampleLogin.zipde mostra en què les barres d'aplicacions i de navegació estan excloses d'aquestavista.

Vistes d'exempleEstan disponibles els exemples següents, que ilvlustren l'ús de les vistes.

Aquests fitxers d'exemple s'instalvlen amb el producte en una Instalvlació fàcil i sónopcionals en una Instalvlació personalitzada. Després de la instalvlació, els podeutrobar a la carpeta ubicació_instalvlació/samples/extensions.

SampleLogin.zipUna vista de substitució per a la pàgina d'inici de sessió de CognosAnalytics.

SampleLoginMultiple.zipUna vista de substitució per a la pàgina d'inici de sessió de CognosAnalytics que solvlicita a l'usuari un espai de noms.

SampleWelcome.zipUna vista de substitució per a la pàgina de benvinguda de CognosAnalytics.

Utilització de la vista de benvinguda personalitzadaAquesta tasca mostra com instalvlar i utilitzar la vista de benvingudapersonalitzada.

Procediment

Carregueu el fitxer de desplegament Samples_for_Install. (Si no ho heu fet ja.)1. Utilitzeu Gestiona > Consola d'administració per obrir l'IBM Cognos

Administration.2. A la pestanya Configuració, feu clic a Administració del contingut.3. A la barra d'eines, feu clic al botó Importació nova.4. Seleccioneu Samples_for_Install al primer pas de l'assistent Importació nova i

completeu els passos restants de l'assistent.Càrrega d'extensions d'exemple.5. En el panell lliscant Gestiona > Personalitzacions, seleccioneu la pestanya

Extensions, premeu Carrega extensió ( ), aneu a la carpeta<ubicació_instalvlació>/samples/extensions i seleccioneu SampleWelcome.zip.

6. Repetiu el pas anterior per a SampleExtensionsAll.zip.7. En el navegador web, escriviu <nom_servidorWeb>:<número_port>/bi/

?perspective=sampleWelcome per a visualitzar la vista de benvingudapersonalitzada.

Resultats

Aquí apareix la vista de benvinguda personalitzada. Té un menú nou (Enllaçosràpids) en la barra d'aplicacions i botons nous de la barra de navegació (Panell


d'eines de línia, Ingressos trimestrals fins a la data, Informes de 2016 i Llocweb). El botó Notificacions s'ha eliminat de la barra de navegació. La pantallaprincipal té una imatge nova, un text nou i un enllaç a un vídeo.

Utilització de la vista d'inici de sessió personalitzadaAquesta tasca ensenya com instalvlar i utilitzar la vista de sessió d'inicipersonalitzada.

Procediment1. Extraieu els fitxers a SampleLogin.zip.2. Editeu login/js/views/SampleLoginView.js i ubiqueu la línia que conté

{name:’CAMNamespace’,value:’CognosEx’}.3. Substituïu CognosEx pel nom d'un dels vostres espais de noms d'autenticació

(com s'ha definit a l'IBM Cognos Configuration).4. Deseu SampleLoginView.js i torneu a crear el fitxer .zip.5. En el panell lliscant Gestiona > Personalitzacions, seleccioneu la pestanya

Extensions, premeu Carrega extensió ( ), aneu a la carpeta<ubicació_instalvlació>/samples/extensions i seleccioneu SampleLogin.zip.

6. A la pestanya Vistes, feu clic a

al costat de la vista d'inici de sessió perdefecte. Seleccioneu la vista Sample login com a vista d'inici de sessió perdefecte.

7. Tanqueu la sessió de l'IBM Cognos Analytics.8. Accediu al vostre servidor de Cognos Analytics.

Resultats

Aquí apareix la vista d'inici de sessió personalitzada. Té un fons personalitzat i textnou en el quadre de diàleg d'inici de sessió.


Gestió de temes, extensions, vistes i paràmetresPodeu gestionar temes, extensions, vistes i paràmetres amb el panell lliscant Gestió> Personalització. Podeu carregar, suprimir i modificar temes, extensions, vistes iparàmetres. També podeu definir un tema per defecte per a tots els usuaris, idefinir les vistes d'inici i d'inici de sessió per defecte.

El panell lliscant Gestió > Personalització disposa de quatre pestanyes, Temes,Extensions, Vistes i Paràmetres. Els temes es carreguen a la pestanya Temes, i lesextensions i les vistes es carreguen a la pestanya Extensions.

Càrrega de temes

Per carregar un tema, a la pestanya Temes feu clic a Carregar temes ( ) i aneual tema del sistema de fitxers. El tema es carregarà i validarà. Si el tema no ésvàlid, es mostrarà un missatge d'error. En cas contrari, el tema s'afegirà a la llista

de temes disponibles. Podeu fer clic a Més ( ) al costat d'un tema peractualitzar-lo, suprimir-lo o descarregar-lo.

Consell: Si apliqueu un tema a un entorn distribuït, espereu al menys cinc minutsper què tingui efecte.



Podeu seleccionar un tema perquè esdevingui el tema per defecte per a tots elsusuaris. A la pestanya Temes del panell lliscant Gestió > Personalització,seleccioneu la casella de selecció al costat d'un tema i tot seguit feu clic a Aplica.

També podeu establir temes per defecte a rols al panell lliscant Gestió > Comptes.Si un usuari té un rol amb un tema per defecte, aquest tema serà el que s'utilitzaràen lloc del tema seleccionat per a tots els usuaris. Per obtenir més informació,consulteu: “Personalització de rols” a la pàgina 6.

Càrrega d'extensions i vistes

Per carregar una extensió o una vista, a la pestanya Extensions, feu clic a Carrega

extensió( ) i aneu a l'extensió o a la vista del sistema de fitxers. L'extensió o lavista es carregarà i validarà. Si l'extensió no és vàlida, es mostrarà un missatged'error. En cas contrari, l'extensió s'afegirà a la llista de temes carregats. Podeu fer

clic a Més ( ) al costat d'una extensió o vista per actualitzar-la, suprimir-la odescarregar-la.

Establiment d'una vista d'inici per defecte

A la pestanya Vistes del panell lliscant Gestió > Personalització, feu clic a

alcostat de la vista d'inici per defecte. Ja podeu navegar fins el panell d'eines ol'informe que voleu com a vista d'inici per defecte, o podeu seleccionar una vistade la llista de vistes d'inici perquè esdevingui la vista d'inici per defecte per a totsels usuaris.

També podeu establir vistes d'inici per defecte a rols al panell lliscant Gestió >Comptes. Si un usuari té un rol amb una vista d'inici per defecte, aquesta vistaserà la que s'utilitzarà en lloc de la vista d'inici seleccionada per a tots els usuaris.Per obtenir més informació, consulteu: “Personalització de rols” a la pàgina 6.

L'usuari també pot seleccionar una vista d'inici personal per defecte a partir de

qualsevol vista. L'usuari pot fer clic a Més ( ) a la vista que desitgi, i tot seguitfer clic a Defineix-la com a pàgina inicial per a definir una vista d'inici personalper defecte. Aquesta vista d'inici per defecte tindrà preferència per davant de lesvistes d'inici creades per a rols o per a tots els usuaris.

Establiment d'una vista d'inici de sessió per defecte

A la pestanya Vistes del panell lliscant Gestió > Personalització, feu clic a

alcostat de la vista d'inici de sessió per defecte. Ara ja podeu seleccionar una vista dela llista de vistes d'inici de sessió perquè esdevingui la vista d'inici de sessió perdefecte per a tots els usuaris.

Personalització de paràmetres que poden fer-se servir alsdiferents informes

Feu clic a la pestanya Paràmetres al panell lliscant Gestió > Personalització.


v Per utilitzar paràmetres d'informes existents, feu clic a Importa i navegueu finsun informe què sabeu que conté paràmetres. Seleccioneu un paràmetre perpersonalitzar i feu clic a Estableix valors. Seleccioneu el valor que desitgeuestablir com a valor predeterminat.

v Per crear un paràmetre nou, feu clic a Nou i escriviu el nom del paràmetre. Feu

clic a Més ( ), i després feu clic a Propietats. A la secció Valors personalitzats,feu clic a Estableix valors. A cada valor de paràmetre, feu clic a Nou i escriviuun valor.

També podeu establir paràmetres d'informe per defecte a rols al panell lliscantGestió > Comptes. Si un usuari té un rol amb paràmetres personalitzats, a l'horad'executar informes amb aquests paràmetres, podreu veure els valorspredeterminats que vareu establir. Per obtenir més informació, consulteu:“Personalització de rols” a la pàgina 6.

Execució de Cognos Analytics amb extensionspersonalitzades i vistes inhabilitades

Si una extensió o vista descarregades contenen errors, és possible que l'IBMCognos Analytics quedi representat com a no utilitzable. En aquest cas, podeuexecutar Cognos Analytics amb les vistes i extensions personalitzades inhabilitades.

Procediment

Inicieu el Cognos Analytics escrivint l'URL <nom_servidorWeb>:<número_port>/bi/?factoryMode=true.

Resultats

El Cognos Analytics s'inicia amb totes les extensions inhabilitades. Ara podeucorregir o suprimir les extensions o vistes personalitzades abans de reiniciar elCognos Analytics amb l'URL estàndard.

Descripció de spec.jsonEl fitxer spec.json en una extensió defineix les addicions i supressions quel'extensió fa en la interfície d'usuari per defecte de l'IBM Cognos Analytics.L'estructura i el contingut d'aquest fitxer s'expliquen aquí.

L'estructura i els continguts aquí descrits són provisionals. És possible que canviïnen futures versions del Cognos Analytics. És possible que aquests canvis no siguincompatibles amb versions anteriors.

name Especifica el nom de l'extensió. El nom pot contenir caràcters alfanumèrics,caràcters de subratllat (_) i espais ().

schemaVersionEspecifica un valor numèric per a la versió d'esquema. Pot ser 1.0 o bé2.0. El valor per defecte és 1.0.

extensionsConté una matriu d'objectes perspective.

perspectiveEspecifica la vista que s'està ampliant. Les opcions són lessegüents.

common S'aplica a totes les vistes.


<nom_vista>S'aplica a la vista <nom_vista>, que pot ser una vistaincorporada (home, authoring, dashboard o modeller) o unavista carregada.

type Si l'extensió és una vista, especifica el tipus. Els valors possiblessón login per a una vista d'inici de sessió i home per a una vistad'inici. Aquest element només es fa servir a la versió d'esquema2.0. Si no es té en compte i s'especifica la versió d'esquema 2.0, lavista no s'inclou a la llista de possibles vistes d'inici de sessió od'inici.

lensableSi té el valor false, aquesta vista no s'inclou a la llista de vistes pera les quals es poden ometre funcions. Per obtenir més informació,consulteu: “Personalització de rols” a la pàgina 6.

El valor per defecte és true.

commentUn comentari opcional.

featuresConté una matriu d'agrupacions de característiques.

id Especifica l'identificador exclusiu de la característica.

toolItemsConté una matriu dels elements de la interfície d'usuarique s'estan afegint.

id Identificador exclusiu del nou element de lainterfície d'usuari.

containerIdEspecifica la ubicació de l'element de la interfícied'usuari.v Si l'element de la interfície d'usuari és un menú

o un botó, l'element s'ubica en l'aplicació o enbarres de navegació tal i com es mostra en elgràfic.

Els valors de containerId que corresponen a laubicació del botó o el menú apareixen en lasegüent llista.1. com.ibm.bi.glass.navbarLeadingGroup

2. com.ibm.bi.glass.navbarTrailingGroup

3. com.ibm.bi.glass.appbarLeadingGroup


4. com.ibm.bi.glass.appbarCenterGroup

5. com.ibm.bi.glass.appbarTrailingGroup

v Si l'element de la interfície d'usuari és unelement de menú, el valor de containerId és l'iddel menú que conté l'element de menú. Perobtenir informació sobre com determinar un id,consulteu “Com determinar l'id d'un objected'interfície d'usuari” a la pàgina 99.

label Especifica l'etiqueta de text de l'element de lainterfície d'usuari. Aquest text no es pot localitzar.

type Especifica el tipus d'element de la interfícied'usuari. Els valors possibles es mostren aquí.v Button

v Menu

v MenuItem

icon Especifica la imatge de l'element de la interfícied'usuari que s'ha de visualitzar. El camí d'accéscorrespon al fitxer d'imatge en el fitxer zip del'extensió.

weight Especifica un valor numèric que determina laubicació de l'element de la interfície d'usuari en elcontenidor. Un valor més alt desplaça cap a daltl'element en el contenidor.

push Especifica si, quan el botó es prem per segon cop,es desfà l'acció de la primera pulsació. Perexemple, obrir i després tancar una carpeta. Elvalor pot ser true o false. El valor ha de ser trueen el cas d'un botó que obre una carpeta.

coachMarkEspecifica una marca d'ajuda.

title Especifica el títol de la marca d'ajuda.

contentsEspecifica el contingut de la marca d'ajuda.

actionControllerEspecifica l'acció que cal emprendre quan es fa clicsobre l'element de la interfície d'usuari. Aquí esllisten les accions disponibles.

bi/glass/api/IFrameOpenerObre una pàgina web.

bi/glass/api/ReportOpenerObre un informe en concret.

bi/glass/api/DashboardOpenerObre un panell d'eines en concret.

bi/glass/api/FolderOpenerObre una carpeta en concret.

v1/ext/<nom>/js/controllers/nom_controladorExecuta el controlador personalitzat


empaquetat en l'extensió. El controlador ésel fitxer js/controllers/nom_controlador.js.

optionsConté una matriu d'opcions per passar-les a alcontrolador d'accions. Les opcions varien en funciódel controlador d'accions que es fa servir. Per veureles opcions utilitzades pels controladors d'accions,consulteu: “Utilització de controladors d'accióincorporats” a la pàgina 66.

collectionItemsConté una matriu dels elements de la interfície d'usuarique s'estan afegint.

containerIdEspecifica el lloc on es troba l'element de lainterfície d'usuari.

id Especifica l'identificador exclusiu de l'element de lainterfície d'usuari.

contentConté definicions d'una vista.

type Conté un enllaç al fitxer JavaScript per aexecutar-lo en invocar aquesta vista.

optionsConté els paràmetres que cal passar al fitxerJavaScript.

cssStylesConté una matriu d'enllaços a fitxers .css que cal utilitzarper a aquesta vista.

excludeFeaturesConté una matriu d'identificadors de característiques de lainterfície d'usuari que cal excloure. Aquesta característicano es pot aplicar a la vista common.

Per obtenir informació sobre com determinar un id,consulteu “Com determinar l'id d'un objecte d'interfícied'usuari” a la pàgina 99.

excludeItemsConté una matriu d'identificadors d'elements de lainterfície d'usuari que cal excloure. Aquesta característicano es pot aplicar a la vista common.

Per obtenir informació sobre com determinar un id,consulteu “Com determinar l'id d'un objecte d'interfícied'usuari” a la pàgina 99.

Validació d'esquema JSONEn carregar un fitxer spec.json, es valida comparant-lo amb l'esquema següent:{

"type": "object","definitions": {"extType": {

"type": "string",


"minLength": 1,"pattern": "^v1/ext/.+$"

},"noEmptyString": {

"type": "string","minLength": 1

},"toolItem": {

"type": "object","properties": {"id": {

"$ref": "#/definitions/noEmptyString"},"title": {

"type": "string"},"type": {

"$ref": "#/definitions/noEmptyString"},"actionController": {

"$ref": "#/definitions/noEmptyString"},"label": {

"$ref": "#/definitions/noEmptyString"},"containerId": {

"$ref": "#/definitions/noEmptyString"},"icon": {

"type": "string"},"weight": {

"type": "number"},"class": {

"type": "string"},"comment": {

"type": "string"},"options": {

"type": "object"},"push": {

"type": "string","enum": ["true","false"

]},"coachMark": {

"type": "object","properties": {"title": {"type": "string"

},"contents": {"type": "string"

}},"additionalProperties": false,"required": ["title"

]},"lensable": {

"type": "boolean"


}},"required": ["id"

]},"collectionItem": {


"$ref": "#/definitions/noEmptyString"},"containerId": {


"$ref": "#/definitions/noEmptyString"},"lensable": {

"type": "boolean"}

},"required": ["id","containerId"

]},"collectionContainerItem": {



"$ref": "#/definitions/noEmptyString"},"lensable": {

"type": "boolean"}

},"required": ["id"

]},"collectionContainer": {


"$ref": "#/definitions/noEmptyString"},"items": {

"type": "array","items": {

"$ref": "#/definitions/collectionContainerItem"}

},"lensable": {

"type": "boolean"}

},"additionalProperties": false,"required": ["id"

]},"feature": {

"type": "object",


"properties": {"id": {

"$ref": "#/definitions/noEmptyString"},"excludeItems": {

"type": "array","items": {"$ref": "#/definitions/noEmptyString"

}},"excludeFeatures": {

"type": "array","items": {"$ref": "#/definitions/noEmptyString"

}},"toolItems": {

"type": "array","items": {"$ref": "#/definitions/toolItem"

}},"content": {

"type": "object","properties": {"type": {"$ref": "#/definitions/extType"

},"options": {"type": "object"

}},"additionalProperties": false,"required": ["type"

]},"cssStyles": {

"type": "array","items": {"$ref": "#/definitions/extType"

}},"collectionItems": {

"type": "array","items": {"$ref": "#/definitions/collectionItem"

}},"collectionContainers": {

"type": "array","items": {"$ref": "#/definitions/collectionContainer"

}},"comment": {

"type": "string"},"lensable": {

"type": "boolean"}

},"additionalProperties": false,"required": ["id"

]},


"extension": {"type": "object","properties": {"perspective": {

"$ref": "#/definitions/noEmptyString"},"features": {

"type": "array","minItems": 1,"items": {

"$ref": "#/definitions/feature"}

},"type": {

"type": "string","enum": [

"home","login"

]},"lensable": {

"type": "boolean","default": true

},"comment": {

"type": "string"}

},"additionalProperties": false

}},"properties": {"schemaVersion": {

"type": "string","enum": ["1.0","2.0"

]},"name": {

"type": "string","pattern": "[a-zA-Z0-9_ ]+$"

},"extensions": {

"type": "array","minItems": 1,"items": {"$ref": "#/definitions/extension"

}},"comment": {

"type": "string"}

},"additionalProperties": false,"required": ["name","extensions"

]}

Com determinar l'id d'un objecte d'interfície d'usuariHeu de determinar l'id d'un element d'interfície d'usuari existent en crearextensions que excloguin característiques o elements, o que afegeixin elements a unmenú existent.


Procediment1. Si teniu Cognos Analytics 11.0.7 o posterior, seguiu aquests passos:

a. Obrir la finestra Serveis de Windows i atureu el servei IBM Cognos.b. Obriu el fitxer ubicació_instalvlació\wlp\usr\servers\cognosserver\

bootstrap.properties.c. Afegiu la línia següent:

disableXSRFCheck=true

d. Deseu el fitxer.e. Reinicieu el servei IBM Cognos.

2. Inicieu la sessió en el vostre servidor de IBM Cognos Analytics.3. Escriviu el següent URL en un navegador web: http://<nom_servidor>:<port>/

bi/v1/perspectives/<view> on <vista> és la vista (home, authoring, dashboard omodeller) que conté l'objecte de la interfície d'usuari. El sistema torna un fitxerJSON que conté una descripció de tots els elements de la interfície d'usuari enla vista.

4. Busqueu el cursor per damunt de l'element de la interfície d'usuari. Elselements id i featureId de la interfície d'usuari es visualitzen segons esdesplaça el text en passar el cursor per damunt.

Exemple

Si es busca Delete en el fitxer JSON retornat per a la vista d'inici, es visualitza lasegüent part del fitxer."label": "Delete","id": "com.ibm.bi.contentApps.deleteAction.DeleteAction","featureId": "com.ibm.bi.contentApps.deleteAction"

Els valors d'id i featureId es poden utilitzar en l'extensió per excloure aquest botóo característica, si així es desitja.


Capítol 9. Habilitació d'un entorn de producció

Els programes de IBM Cognos tenen llicència si accepten termes y condicionsespecífics. Heu de disposar de la titularitat apropiada per a seleccionar el tipusd'entorn de producció.

La capacitat d'administració Configura i gestiona el sistema és necessària pergestionar els valors del sistema.

Limitació del tipus no productiu

Si el vostre programa de l'IBM Cognos s'ha designat com a "no productiu", elprograma només podrà desplegar-se com a part del desenvolupament intern delllicenciatari i de l'entorn de prova, incloent però sense limitar-se a proves,ajustament de rendiment, diagnosi d'errors, benchmarking intern, periodificacions,l'activitat de control de qualitat i/o el desenvolupament d'accions i ampliacionsutilitzades internament en el programa utilitzant interfícies de programaciód'aplicacions publicades. El llicenciatari no està autoritzat a utilitzar cap part delprograma per a cap altre propòsit sense adquirir les autoritzacions de produccióapropiades.

101


Quant a aquesta guia

Aquesta informació està pensada per a ser utilitzada amb les opcions de gestió deIBM Cognos Analytics.

Cerca d'informació

Per cercar documentació de productes al web, inclosa tota la documentaciótraduïda, accediu a Knowledge Center de IBM (http://www.ibm.com/support/knowledgecenter).

Característiques d'accessibilitat

IBM Cognos Analytics té característiques d'accessibilitat que ajuden al usuaris quetenen una discapacitat física, com mobilitat restringida o visió limitada, a utilitzarproductes de tecnologia de la informació. No obstant, la disponibilitat de lescaracterístiques d'accessibilitat pot variar si altres pàgines i components no que noadmeten la disponibilitat s'afegeixen a la interfície d'usuari de IBM CognosAnalytics.

La documentació en format HTML de l'IBM Cognos té funcions d'accessibilitat. Elsdocuments en format PDF són complementaris i, com a tals, no inclouen capfunció d'accessibilitat.

Afirmacions per al futur

Aquesta documentació descriu la funcionalitat actual del producte. Pot ser ques'incloguin referències a elements que ara no estan disponibles. D'això no es derivacap implicació de disponibilitat futura. Aquestes referències no suposen capcompromís, promesa ni obligació legal per lliurar cap material, codi o funcionalitat.El desenvolupament, el lliurament i la planificació de subministrament de lesfuncions o la funcionalitat són decisió d'IBM.

Descàrrec de responsabilitat quant als exemples

L'empresa Great Outdoors Company, GO Sales i qualsevol altra variació del nomGreat Outdoors i l'exemple de planificació ilvlustren operacions empresarialsfictícies amb dades d'exemple utilitzades per desenvolupar aplicacions per a IBM iels clients d'IBM. Aquests registres ficticis inclouen dades d'exemple per atransaccions de vendes, distribució de productes, finances i recursos humans.Qualsevol semblança amb noms, adreces, números de contacte o valors detransacció reals és només una coincidència. Altres fitxers d'exemple poden contenirdades funcionals generades manualment o mitjançant una màquina, dades de fetscompilades de fonts acadèmiques o públiques, o dades utilitzades amb el permísdel propietari del copyright, per utilitzar-les com a dades d'exemple perdesenvolupar aplicacions d'exemple. Els noms de producte als quals es fareferència poden ser marques comercials dels propietaris respectius. Quedaprohibida la duplicació no autoritzada.

103

http://www.ibm.com/support/knowledgecenter


Índex

Aactivitats

gestionar 35activitats futures 37actuals

activitats 36entrades 36

Amazon Athena 26Amazon Redshift 26arrendataris

creació 52finalitzar sessions d'usuari actives 58habilitar 59inhabilitar 59personalitzar 56suprimir 59

autenticacióIBMid 10

Bbootstrap.properties, fitxer 32

Ccancelvlar l'execució d'entrades 36carpetes

nombre màxim d'usuaris 1Cloudera Impala

controlador JDBC 21connexions

servidor de dades 15connexions amb servidors de dades

Cloudera Impala 21connexions del servidor de dades

precarregar metadades 21controladors JDBC

Cloudera Impala 21crear informes

ús de llicències 41

DDenodo

versions admeses 22desplegament

magatzem de contingut 13distribució de continguts

remitent arrendatari 58

Eentrades

actuals 36cancelvlar-ne l'execució 36futures 37passades 36planificades 38prioritat d'execució 39

entrades (continuació)suspendre'n l'execució 36

entrades predefinides 49espai de noms de l'IBM Cognos Series 7 8espais de noms

Vegeu també proveïdors d'autenticaciódiversos 1IBM Cognos 1proveïdors d'autenticació 8

espais de noms externs 8

Ffi del suport

servidor de dades 22fus horari 58

Ggrups

creació 5gestionar 5

IIBM Cognos

espai de noms 1IBMid

configurar 10ID d'arrendatari

objecte públic 53idioma del contingut 58idioma del producte 58idiomes bidireccionals 58llicència

producció 101llicència productiu

no productiu 101tipus d'entorn 101

llicènciesinforme d'ús 41

Mmagatzem de dades d'Azure SQL 26magatzems de continguts

còpia de seguretat 13MariaDB 27MemSQL 27metadades

precarregar 21MongoDB Connector for BI 2.2.1 26multiarrendament

administració d'arrendataris 51arrendataris 51assignar contingut als arrendataris 52ID d'arrendatari 53regles de contenció 51

105

Nno productiu

tipus d'entorn 101

OOpenID Connect

afegir usuaris 10, 11

Pparàmetres de connexió 17passades

activitats 36entrades 36

personalitzararrendataris 56Cognos Analytics 61rols 7

Pivotal Greenplum i HDBconsultes estancades 21

planificacionsgestionar 38gestionar activitats futures 37

Presto 27prioritat d'execució 39proveïdors d'autenticació 1

espais de noms 8OpenID Connect 10

Rregistre

fitxers de registre 29tipus 29

registre d'auditoria 29registre de diagnòstic 29

resoldre problemes d'engegada del servei Cognos 32

registre de sessió 29remitent arrendatari 58resoldre problemes d'engegada del servei Cognos 32resolució de problemes

connexions del servidor de dades 21rols

creació 5gestionar 5personalitzar 7predefinits 49

Sseguretat

accés al contingut 1autenticació 1, 8entrades predefinides 49

Seguretat de transport estricte HTTP 29servidor de dades 15

actualitzacions per versió 24connexions de resolució de problemes 21creació de connexions 15Denodo 22fi del suport 22paràmetres de connexió 17Pivotal Greenplum i HDB 21

servidors de dadesCloudera Impala 21

Spark SQL 2.1 Thrift, servidor 26suspendre

entrades 36

Uusuaris

crear al Cognos Analytics 6gestionar 6pràctiques recomanades per agrupar els usuaris 1


Documents

V ersió 11 - IBM · 2020-03-24 · Els permisos d'accés inicials s'apliquen a tots els objectes pr edefinits. Podeu modificar els permisos des de les pr opietats d'objecte. Anònim