v unix ist eine eingetragene marke von the open gr oup in ......pe ist ein benutzerverbund....

IBM Cognos AnalyticsVersion 11.0

Verwaltung - Benutzerhandbuch

IBM

©

Produktinformation

Dieses Dokument bezieht sich auf IBM Cognos Analytics Version 11.0.0 und gegebenenfalls auch auf nachfolgendeReleases.

Copyright

Licensed Materials - Property of IBM

© Copyright IBM Corp. 2015, 2018.

IBM, das IBM Logo und ibm.com sind Marken oder eingetragene Marken der International Business Machines Cor-poration in den USA und/oder anderen Ländern. Weitere Produkt- und Servicenamen können Marken von IBModer anderen Herstellern sein. Eine aktuelle Liste der IBM Marken finden Sie auf der Webseite „Copyright andtrademark information” unter www.ibm.com/legal/copytrade.shtml.

Die folgenden Namen sind Marken oder eingetragene Marken anderer Unternehmen:v Adobe, das Adobe-Logo, PostScript und das PostScript-Logo sind Marken oder eingetragene Marken der Adobe

Systems Incorporated in den USA und/oder anderen Ländern.

v Microsoft, Windows, Windows NT und das Windows-Logo sind Marken der Microsoft Corporation in den USAund/oder anderen Ländern.

v Intel, das Intel-Logo, Intel Inside, das Intel Inside-Logo, Intel Centrino, das Intel Centrino-Logo, Celeron, IntelXeon, Intel SpeedStep, Itanium und Pentium sind Marken oder eingetragene Marken der Intel Corporation oderihrer Tochtergesellschaften in den USA oder anderen Ländern.

v Linux ist eine eingetragene Marke von Linus Torvalds in den USA und/oder anderen Ländern.

v UNIX ist eine eingetragene Marke von The Open Group in den USA und anderen Ländern.

v Java und alle auf Java basierenden Marken und Logos sind Marken oder eingetragene Marken der Oracle Corpo-ration und/oder ihrer verbundenen Unternehmen.

Screenshots aus Microsoft-Produkten werden mit Genehmigung von Microsoft verwendet.

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

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

Inhaltsverzeichnis

Kapitel 1. Verwalten von Konten . . . . . . . . . . . . . . . . . . . . . . . . . 1Der Cognos-Namespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Erstellen und Verwalten von Gruppen und Rollen . . . . . . . . . . . . . . . . . . . . . . 4Erstellen und Verwalten von Benutzern . . . . . . . . . . . . . . . . . . . . . . . . . 6Anpassen von Rollen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Authentifizierungsprovider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8OpenID Connect-Namespaces verwalten . . . . . . . . . . . . . . . . . . . . . . . . . 9

Suchen von Benutzern, Gruppen und Rollen . . . . . . . . . . . . . . . . . . . . . . . . 12

Kapitel 2. Verwalten von Inhalten . . . . . . . . . . . . . . . . . . . . . . . . 13

Kapitel 3. Datenserververbindungen . . . . . . . . . . . . . . . . . . . . . . . 15Herstellen einer Datenserververbindung . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Cognos-spezifische Verbindungsparameter . . . . . . . . . . . . . . . . . . . . . . . . 17Vorheriges Laden von Metadaten von einer Datenserververbindung . . . . . . . . . . . . . . . . 21Referenz und Fehlerbehebung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

JDBC-Treiber von Cloudera Impala . . . . . . . . . . . . . . . . . . . . . . . . . . 21Blockierte Abfragen in der Pivotal HDB-Engine . . . . . . . . . . . . . . . . . . . . . . 22Denodo 5.5- und Denodo 6.0-Datenserver . . . . . . . . . . . . . . . . . . . . . . . . 22In Cognos Analytics nicht mehr unterstützte Datenquellen . . . . . . . . . . . . . . . . . . 22

Aktualisierungen nach Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Cognos Analytics 11.0.13 - neue und geänderte Features . . . . . . . . . . . . . . . . . . . 25Cognos Analytics 11.0.9 - neue und geänderte Features . . . . . . . . . . . . . . . . . . . . 25Cognos Analytics 11.0.8 - neue Features . . . . . . . . . . . . . . . . . . . . . . . . . 27Cognos Analytics 11.0.7 - neue und geänderte Features . . . . . . . . . . . . . . . . . . . . 27

Kapitel 4. Verwalten von Systemeinstellungen . . . . . . . . . . . . . . . . . . . 29Verwalten von Datendateiuploads . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Durchsetzen von HTTP Strict Transport Security . . . . . . . . . . . . . . . . . . . . . . . 29Protokollierungstypen und -dateien . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Protokollierung zu Diagnosezwecken . . . . . . . . . . . . . . . . . . . . . . . . . . 30Sitzungsprotokollierung einrichten. . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Aktivieren oder Inaktivieren traditioneller Komponenten . . . . . . . . . . . . . . . . . . . . 33

Kapitel 5. Verwalten von geplanten Aktivitäten. . . . . . . . . . . . . . . . . . . 35Verwalten von aktuellen Aktivitäten . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Verwalten von vergangenen Aktivitäten . . . . . . . . . . . . . . . . . . . . . . . . . . 36Verwalten bevorstehender Aktivitäten für einen bestimmten Tag. . . . . . . . . . . . . . . . . . 37Verwalten von geplanten Aktivitäten . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Verwalten der Ausführungspriorität für Einträge . . . . . . . . . . . . . . . . . . . . . . . 39

Kapitel 6. Verwalten von Lizenzen . . . . . . . . . . . . . . . . . . . . . . . . 41Lizenzrollen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Standardberechtigungen auf der Basis von Lizenzen . . . . . . . . . . . . . . . . . . . . . . 42Zuweisen von Funktionen auf der Basis von Lizenzrollen . . . . . . . . . . . . . . . . . . . . 50Upgradeszenario: Wenn die Namen der angepassten Rollen identisch mit den Namen der neueren Cognos-Lizenz-rollen sind. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Kapitel 7. Tenantverwaltung. . . . . . . . . . . . . . . . . . . . . . . . . . . 51Einschlussregeln für die Multi-Tenant-Funktionalität. . . . . . . . . . . . . . . . . . . . . . 51Erstellen von Tenants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Zuordnen von Tenant-IDs zu vorhandenem Inhalt . . . . . . . . . . . . . . . . . . . . . . 52Festlegen einer Tenant-ID für ein öffentliches Objekt. . . . . . . . . . . . . . . . . . . . . . 53Delegierte Tenantverwaltung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

iii

Einrichten der Rolle 'Tenantadministratoren' . . . . . . . . . . . . . . . . . . . . . . . 54Einrichten von virtuellen Tenants für die gemeinsame Nutzung von Inhalten zwischen Tenants . . . . . . . 55Anpassen von Tenants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Definieren von Regionseinstellungen für Tenants . . . . . . . . . . . . . . . . . . . . . . . 57Einrichten von Benachrichtigungen für Tenants . . . . . . . . . . . . . . . . . . . . . . . 58Beenden aktiver Benutzersitzungen für Tenants . . . . . . . . . . . . . . . . . . . . . . . 58Inaktivieren und Aktivieren von Tenants . . . . . . . . . . . . . . . . . . . . . . . . . 59Löschen von Tenants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Kapitel 8. Anpassen von Cognos Analytics für alle Rollen. . . . . . . . . . . . . . 61Anpassungsbeispiele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Erstellen von Motiven . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Beispielmotive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Erstellen von Erweiterungen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Hinzufügen einer Schaltfläche oder eines Menüelements . . . . . . . . . . . . . . . . . . . 66Hinzufügen eines Menüs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Entfernen eines Benutzerschnittstellenelements . . . . . . . . . . . . . . . . . . . . . . 72Hinzufügen von Dashboardformen . . . . . . . . . . . . . . . . . . . . . . . . . . 73Erstellen einer Bildergalerie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Hinzufügen eines Dashboard-Widgets . . . . . . . . . . . . . . . . . . . . . . . . . 77Beispielerweiterungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Erstellen von Ansichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Erstellen einer Ansicht (mit Ausnahme von Anmeldeansichten) . . . . . . . . . . . . . . . . . 82Erstellen einer Anmeldeansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Anmeldeansicht mit einer Namespace-Eingabeaufforderung erstellen . . . . . . . . . . . . . . . 88Beispielansichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Verwalten von Motiven, Erweiterungen, Ansichten und Parameter . . . . . . . . . . . . . . . . . 91Ausführen von Cognos Analytics mit inaktivierten Erweiterungen und Ansichten . . . . . . . . . . . 93

Beschreibung der Datei spec.json . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93JSON-Schemaprüfung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Bestimmen der ID eines Benutzerschnittstellenobjekts . . . . . . . . . . . . . . . . . . . . 101

Kapitel 9. Aktivieren einer Produktionsumgebung. . . . . . . . . . . . . . . . . 103

Zu diesem Handbuch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

iv IBM Cognos Analytics Version 11.0: Verwaltung - Benutzerhandbuch

Kapitel 1. Verwalten von Konten

In IBM® Cognos Analytics können Sie die Benutzerauthentifizierung und den Zu-griff auf Inhalte und Produktfunktionen verwalten.

Der Administrator, der die Cognos Analytics-Anwendung konfiguriert, richtet dieersten Sicherheitseinstellungen ein. Dazu gehört das Konfigurieren von Authentifi-zierungsprovidern, um die vorhandene Sicherheitsinfrastruktur Ihres Unterneh-mens nutzen zu können. Jeder Authentifizierungsprovider, der für die Verwendungmit Cognos Analytics konfiguriert ist, wird als Namespace oder externer Name-space bezeichnet.

Neben Namespaces, die die externen Authentifizierungsprovider darstellen, verfügtIBM Cognos Analytics über einen integrierten, internen Namespace mit dem Na-men Cognos. Der Cognos-Namespace erleichtert den Prozess der Verwaltung vonZugriffsberechtigungen und der Bereitstellung von Inhalten.

Cognos Analytics kann zudem für den anonymen Zugriff konfiguriert werden, beidem Benutzer für den Zugriff auf die Anwendung weder Benutzernamen nochKennwort bereitstellen müssen. Informationen zum Aktivieren des anonymen Zu-griffs finden Sie in der Veröffentlichung IBM Cognos Analytics - Installation und Kon-figuration.

Wichtig: Möglicherweise verfügt Ihre Umgebung über eine große Anzahl an Be-nutzern. Es hat sich bewährt, die Benutzer in Ordnern zu gruppieren, wobei jederOrdner maximal 1000 Benutzer enthalten sollte.

Die Administrationsberechtigung Benutzer, Gruppen und Rollen ist für das Ver-walten von Konten erforderlich. Weitere Informationen finden Sie im Abschnitt zugeschützten Funktionen und Features in der Veröffentlichung IBM Cognos Analytics- Verwaltung und Sicherheit.

Der Cognos-NamespaceDer Cognos-Namespace enthält vordefinierte Objekte, die das Einrichten erster Si-cherheitseinstellungen erleichtern.

Die vordefinierten Objekte und andere Features des Cognos-Namespace verwen-den Sie für das fortlaufende Sicherheitsmanagement.

Der Cognos-Namespace kann Benutzer, Gruppen und Rollen enthalten. Eine Grup-pe ist ein Benutzerverbund. Mitglieder von Gruppen können Benutzer und andereGruppen sein. Eine Rolle ist eine Sammlung von Funktionen, die die Tasks identifi-zieren, zu deren Ausführung ein Benutzer berechtigt ist. Mitglieder von Rollenkönnen Benutzer, Gruppen und andere Rollen sein. Ein Benutzer kann mehrerenGruppen oder Rollen angehören. Wenn ein Benutzer Mitglied von mehreren Grup-pen ist, werden die Zugriffsberechtigungen zusammengeführt.

Im folgenden Diagramm ist die Struktur von Gruppen und Rollen im Cognos-Na-mespace dargestellt.

1

Sie können Gruppen und Rollen im Cognos-Namespace erstellen. Die Möglichkeitzum Erstellen von Benutzern im Cognos-Namespace ist nur verfügbar, wenn beider Installation von IBM Cognos Analytics die Option Easy install verwendet wur-de.

Vordefinierte und integrierte Objekte im Cognos-Namespace

Die ursprünglichen Zugriffsberechtigungen werden auf alle vordefinierten Objekteangewendet. Sie können die Berechtigungen über die Objekteigenschaften ändern.

AnonymDiese Benutzerberechtigung ist für die Erstkonfiguration bestimmt, bei derder anonyme Zugriff aktiviert ist und Benutzer nicht zum Angeben vonBerechtigungsnachweisen aufgefordert werden. Wenn der anonyme Zugriffin Cognos Configuration inaktiviert ist, melden sich Benutzer unter Ver-wendung der eigenen Berechtigungsnachweise an.

Alle authentifizierten BenutzerDiese Gruppe stellt Benutzer dar, die durch Authentifizierungsprovider au-thentifiziert wurden. Die Mitgliedschaft dieser Gruppe wird vom Produktverwaltet und kann nicht angezeigt oder geändert werden.

Alle Diese Gruppe umfasst alle authentifizierten Benutzer und das Benutzer-konto 'Anonym'. Die Mitgliedschaft dieser Gruppe wird vom Produkt ver-waltet und kann nicht angezeigt oder geändert werden. Sie können dieGruppe 'Alle' zum schnellen Einrichten von Standardberechtigungen ver-wenden. Wenn Sie beispielsweise einen Bericht schützen möchten, könnenSie der Gruppe 'Alle' die Berechtigungen zum Lesen, Schreiben oder Aus-führen für den Bericht erteilen. Nachdem dieser Zugriffsschutz besteht,können Sie anderen Benutzern, Gruppen oder Rollen Zugriff auf den Be-richt erteilen und die Gruppe 'Alle' aus der Sicherheitsrichtlinie für diesenBericht entfernen.

Analysis-BenutzerMitglieder dieser Rolle besitzen dieselben Zugriffsberechtigungen wie Kon-sumenten. Darüber hinaus können sie IBM Cognos Analysis Studio ver-wenden.

Analytics-Administratoren

Mitglieder besitzen dieselben Zugriffsberechtigungen wie Analytics-Explo-rer. Darüber hinaus haben sie Zugriff auf:v Verwalten > Datenserververbindungen

v Datenquellenverbindungen in der Administrationkonsolev IBM Cognos Software Development Kit.

Diese Rolle ist nur nach einer angepassten Installation verfügbar.

Abbildung 1. Struktur von Gruppen und Rollen

2 IBM Cognos Analytics Version 11.0: Verwaltung - Benutzerhandbuch

Analytics-Explorer

Mitglieder besitzen dieselben Zugriffsberechtigungen wie Analytics-Benut-zer. Darüber hinaus können sie auf Cognos Analysis for Microsoft Excel,Cognos Framework Manager, Cognos Cube Designer und Dynamic QueryAnalyzer, Transformer sowie TM1 Writeback, das mit FLBI TM1-Server ver-wendet wird, zugreifen.


Analytics-Benutzer

Mitglieder besitzen dieselben Zugriffsberechtigungen wie Mitglieder derInformationsverteilung. Sie können neue Berichte, Dashboards, Storys,neue Jobs, Datenserververbindungen und Datenmodule erstellen. Sie kön-nen Berichte ausführen, auf Eingabeaufforderungen antworten und Dateienhochladen. Außerdem können Sie auf Cognos for Microsoft Office, CognosWorkspace, Cognos Insight, Cognos Event Studio, Cognos Query Studiound Cognos Analysis Studio zugreifen.


AutorenMitglieder dieser Rolle besitzen dieselben Zugriffsberechtigungen wie Ab-fragebenutzer und Analysis-Benutzer. Sie können Reporting, Query Studiound Analysis Studio verwenden und öffentlichen Inhalt, zum Beispiel Be-richte und Berichtsausgaben, speichern.

KonsumentenMitglieder dieser Rolle können öffentlichen Inhalt, zum Beispiel Berichte,lesen und ausführen.

VerzeichnisadministratorenMitglieder dieser Rolle können die Inhalte von Namespaces verwalten. ImCognos-Namespace verwalten sie Gruppen, Konten, Kontakte, Verteilerlis-ten, Datenquellen und Drucker.

Informationsverteilung

Mitglieder besitzen dieselben Zugriffsberechtigungen wie Abfragebenutzerund Analysis-Benutzer. Sie können Reporting, Query Studio und AnalysisStudio verwenden und öffentlichen Inhalt, wie Berichte und Berichtsausga-ben, speichern.


BibliotheksadministratorenMitglieder dieser Rolle können auf die Inhalte der Registerkarte Bibliothekin IBM Cognos Administration zugreifen und diese importieren und ver-walten.

Mobile-AdministratorenMitglieder dieser Rolle können IBM Cognos Mobile-Anwendungen verwal-ten.

Mobile-BenutzerMitglieder dieser Rolle können über IBM Cognos Mobile-Anwendungenauf IBM Cognos-Inhalt, zum Beispiel Berichte, zugreifen.

ModelliererMitglieder dieser Rolle haben Zugriff auf webbasierte Modellierungsfunkti-onen.

Kapitel 1. Verwalten von Konten 3

PortaladministratorenMitglieder dieser Rolle können die Cognos-Portlets und andere Portletsverwalten. Dazu gehört auch das Anpassen von Portlets, das Definierenvon Portlet-Stilen und das Festlegen von Zugriffsberechtigungen für Port-lets.

PowerPlay-AdministratorenMitglieder dieser Rolle können den öffentlichen Inhalt verwalten, auf densie über uneingeschränkten Zugriff verfügen. Darüber hinaus können SieIBM Cognos PowerPlay verwalten und verwenden.

PowerPlay-BenutzerMitglieder dieser Rolle besitzen dieselben Zugriffsberechtigungen wie Kon-sumenten. Darüber hinaus können Sie IBM Cognos PowerPlay verwenden.

AbfragebenutzerMitglieder dieser Rolle besitzen dieselben Zugriffsberechtigungen wie Kon-sumenten. Darüber hinaus können Sie IBM Cognos Query Studio verwen-den.

Leser Mitglieder dieser Rolle verfügen über Lesezugriff auf IBM Cognos-Soft-ware. Sie können durch bestimmte Teile des Content Store navigieren, ge-speicherte Berichtsausgaben im Portal anzeigen und bestimmte Berichtsop-tionen verwenden, wie beispielsweise Drillthrough.

BerichtsadministratorenMitglieder dieser Rolle können den öffentlichen Inhalt verwalten, auf densie über uneingeschränkten Zugriff verfügen. Darüber hinaus können SieIBM Cognos Analysis Reporting und IBM Cognos Query Studio verwen-den.

ServeradministratorenMitglieder dieser Rolle können Server, Dispatcher und Jobs verwalten.

Systemadministratoren

Mitglieder dieser Rolle gelten als Rootbenutzer oder Superuser. Sie könnenauf sämtliche Objekte im Content Store zugreifen und diese ändern, unge-achtet etwaiger Sicherheitsrichtlinien, die für das entsprechende Objektfestgelegt wurden. Nur Mitglieder der Rolle 'Systemadministratoren' kön-nen die Mitgliedschaft dieser Rolle ändern.

Die Erstkonfiguration für diese Rolle enthält die Gruppe 'Alle'. Sie müssendie ursprünglichen Zugriffsberechtigungseinstellungen für diese Rolle än-dern und die Gruppe 'Alle' aus ihrer Mitgliedschaft entfernen. Wenn Siedie Erstkonfiguration nicht ändern, haben alle Benutzer unbeschränktenZugriff auf den Content Store.

TenantadministratorenMitglieder dieser Rolle können Administrationsaufgaben von Tenants aus-führen.Diese Rolle wird in einer IBM Cognos-Umgebung mit mehreren Te-nants verwendet. In der Erstkonfiguration besitzt diese Rolle keine Mitglie-der und keine Funktionen. Nur Systemadministratoren können dieser RolleMitglieder hinzufügen und ihr Zugriffsberechtigungen und Funktionen zu-ordnen.

Erstellen und Verwalten von Gruppen und RollenSie können neue Gruppen und Rollen im Cognos-Namespace erstellen. Diese Rol-len sind nicht von den Authentifizierungsprovidern abhängig und können nur inIBM Cognos Analytics verwaltet werden.


Sie können Benutzer, Gruppen und Rollen von mehreren externen Namespacesund vom Cognos-Namespace als Mitglieder zu den Cognos-Gruppen und -Rollenhinzufügen.

Vorbereitende Schritte

Wenn Sie planen, Einträge von mehreren Namespaces als Mitglieder zu den Cog-nos-Gruppen und -Rollen hinzuzufügen, melden Sie sich bei jedem dieser Name-spaces an, bevor Sie den Vorgang beginnen.

Informationen zu diesem Vorgang

Wenn Sie eine Cognos-Gruppe oder -Rolle löschen, sind die darauf basierendenZugriffsberechtigungen von Benutzern nicht mehr aktiv. Sie können Zugriffsberech-tigungen wiederherstellen, indem Sie eine Gruppe oder Rolle mit demselben Na-men erstellen.

Sie müssen über die Administrationsberechtigung Benutzer, Gruppen und Rollenverfügen, um Konten verwalten zu können. Weitere Informationen finden Sie imAbschnitt zu geschützten Funktionen und Features in der Veröffentlichung IBMCognos Analytics - Verwaltung und Sicherheit.

Vorgehensweise1. Klicken Sie auf Verwalten > Konten.2. Klicken Sie auf den Cognos-Namespace, um diesen zu öffnen.

3. Klicken Sie auf das Symbol zum Erstellen neuer Gruppen

oder auf das

Symbol zum Erstellen neuer Rollen , geben Sie einen eindeutigen Namenim entsprechenden Bereich ein und drücken Sie die Eingabetaste. Die Gruppeoder Rolle wird zur Liste mit Einträgen im Cognos-Namespace hinzugefügt.

Tipp: Sie können Gruppen und Rollen auch in Ordnern erstellen. Klicken Sie

auf das Symbol zum Erstellen neuer Ordner , um einen neuen Ordner zuerstellen.

4. Fügen Sie wie folgt Mitglieder zu der neuen Gruppe oder Rolle hinzu:a. Suchen Sie die neue Gruppe oder Rolle im Cognos-Namespace. Klicken Sie

zum schnellen Finden des Eintrags auf das Suchsymbol

oder auf das

Filtersymbol , um die angezeigten Einträge einzugrenzen.

b. Klicken Sie im Gruppen- oder Rollenkontextmenü

auf Mitglieder anzei-gen und anschließend auf das Symbol zum Hinzufügen von Mitgliedern

.c. Klicken Sie im Fenster Mitglieder hinzufügen auf den erforderlichen Na-

mespace und suchen Sie nach dem Benutzer, der Gruppe oder der Rolle,den/die Sie hinzufügen möchten. Sie können Mitglieder von einem beliebi-gen Namespace oder mehreren Namespaces hinzufügen, bei dem/denen Sieangemeldet sind. Verwenden Sie bei Bedarf die Such- und Filterfunktionen,um den Benutzer, die Gruppe oder die Rolle zu finden, den/die Sie hinzu-fügen möchten.

d. Wählen Sie die erforderlichen Benutzer, Gruppen oder Rollen aus. Sie kön-nen mehrere Einträge auswählen. Klicken Sie auf OK. Die ausgewähltenEinträge werden auf der Registerkarte Mitglieder angezeigt.


e. Wenn Sie weitere Mitglieder zu der Gruppe oder Rolle hinzufügen möchten,klicken Sie auf das Symbol zum Hinzufügen von Mitgliedern auf der Regis-terkarte Mitglieder und wiederholen Sie die Schritte c und d. Ziehen Siezum Entfernen eines Mitglieds den Mauszeiger auf dessen Namen und kli-

cken Sie auf das Symbol zum Entfernen .f. Schließen Sie die Eigenschaftsanzeige.

Die Gruppe oder Rolle schließt jetzt Mitglieder ein. Sie kann auch zu eineranderen Gruppe oder Rolle hinzugefügt werden.

Nächste Schritte

In den Gruppen- und Rollenkontextmenüs

werden Optionen zur Verwaltungdieser Einträge zur Verfügung gestellt. Unter Eigenschaften können Sie auf derRegisterkarte Berechtigungen Zugriffsberechtigungen für die Gruppen und Rollenfestlegen. Mit der Option Mitglieder anzeigen können Sie Mitglieder zu einerGruppe oder Rolle hinzufügen oder von dieser entfernen. Mit der Option Hinzufü-gen zu können Sie den Eintrag zu einer anderen Gruppe oder Rolle oder auch zueinem Ordner hinzufügen. Verwenden Sie zum Löschen der Gruppe oder Rolle dieOption Löschen.

Erstellen und Verwalten von BenutzernSie können Benutzer im Cognos-Namespace erstellen, wenn die Option Easy Ins-tall bei der Installation von IBM Cognos Analytics verwendet wurde.

Vorgehensweise1. Klicken Sie auf Verwalten > Konten.2. Klicken Sie auf den Cognos-Namespace, um diesen zu öffnen.

3. Klicken Sie auf das Symbol zum Erstellen neuer Benutzer

und geben Sieim Dialogfeld Neuer Benutzer die erforderlichen Informationen einschließlichBenutzer-ID und Kennwort ein. Klicken Sie auf OK.Der Benutzername wird zur Liste mit Einträgen im Cognos-Namespace hinzu-gefügt. Sie können den Benutzer jetzt zu einem Ordner, einer Gruppe oder ei-ner Rolle hinzufügen. Der Benutzer kann sich mit der Benutzer-ID und demKennwort bei IBM Cognos Analytics anmelden, die Sie ihm zugewiesen haben.

Nächste Schritte

Das Benutzerkontextmenü

stellt Optionen zum Verwalten des Benutzereintragszur Verfügung. Unter Eigenschaften können Sie auf der Registerkarte Allgemeinim Eigenschaftenbereich Erweitert das Benutzerkennwort ändern. Unter Eigen-schaften können Sie außerdem auf der Registerkarte Berechtigungen Zugriffsbe-rechtigungen für den Benutzer festlegen. Mit der Option Hinzufügen zu könnenSie den Benutzer zu einer Gruppe, einer Rolle oder einem Ordner hinzufügen. Ver-wenden Sie zum Löschen des Benutzers die Option Löschen.

Anpassen von Rollen

Wenn Sie die Rollen verwenden, die im Cognos-Namespace vordefiniert sind, kön-nen Sie Motive, Startseiten und Berichtsparameter anpassen, die für die einzelnenCognos-Rollen spezifisch sind.


Anmerkung: Nur Cognos-Rollen können angepasst werden. Sie können eine Rollenur dann anpassen, wenn sie zum Cognos-Namespace gehört - entweder als vor-definierte Cognos-Rolle oder als Rolle, die Sie selbst erstellt haben. Weitere Infor-mationen zu Cognos-Rollen finden Sie in der Veröffentlichung IBM Cognos Analy-ticsVerwaltung und Sicherheit.

Sie können angeben, dass eine benutzerdefinierte Startseite, ein bestimmter Berichtoder ein bestimmtes Dashboard angezeigt wird, wenn ein Benutzer mit einer be-stimmten Cognos-Rolle IBM Cognos Analytics öffnet. Sie können Standardbenut-zerschnittstellenfeatures für Rollen entfernen. Darüber hinaus können Sie Parame-ter, die in allen Berichten verwendet werden können, an jede Benutzerrolleanpassen.

Vor dem Festlegen von benutzerdefinierten Motiven und Startseiten (außer Dash-boards oder Berichten) müssen Sie die benutzerdefinierten Motive bzw. Startseitenerstellen und hochladen. Weitere Informationen finden Sie in Kapitel 8, „Anpassenvon Cognos Analytics für alle Rollen”, auf Seite 61.

Wenn Sie einzelne Rollen anpassen möchten, klicken Sie unter Verwalten > Kontenauf einen Namespace, um die Liste der Rollen für den Namespace anzuzeigen.Wenn Sie auf eine Rolle klicken, enthält das Slideout-Fenster für diese Rolle dieRegisterkarte Anpassung.

Anmerkung: Wenn Sie Anpassungen für alle Rollen festlegen möchten, verwendenSie das Slideout-Fenster Verwalten > Anpassung. Weitere Informationen finden Siein „Verwalten von Motiven, Erweiterungen, Ansichten und Parameter” auf Seite91.

Festlegen einer Standardstartseite

Klicken Sie auf

neben der Standardstartseite. Nun können Sie nach einem Dash-board oder Bericht suchen, das bzw. der als Standardstartseite verwendet werdensoll, oder Sie können eine Ansicht in der Liste der Ansichten auswählen, die alsStandardstartseite für alle Benutzer in dieser Rolle verwendet werden soll.

Entfernen von Features

Sie können Benutzerschnittstellenfeatures auswählen, die für Benutzer in einer be-

stimmten Rolle entfernt werden sollen. Klicken Sie auf

neben Features. EineListe mit Ansichten wird angezeigt. Diese Liste enthält sowohl die integrierten An-sichten als auch alle benutzerdefinierten Ansichten, die hochgeladen wurden. Kli-cken Sie auf eine Ansicht, um eine allgemeine Gruppierung der Features für die

Ansicht anzuzeigen. Klicken Sie auf

neben einer Gruppierung, um die Featureseiner unteren Ebene einzublenden. Sie können beliebige Features in dieser Listeoder in den darunter liegenden Ebenen abwählen. Klicken Sie auf Anwenden, umdie Änderungen zu speichern. Mit Auf Standardwerte zurücksetzen können Siedie Änderungen zurücksetzen.

Festlegen eines Standardmotivs

Klicken Sie auf

neben dem Standardmotiv. Sie können ein Motiv in der Listeder Motive auswählen, das als Standardmotiv für alle Benutzer in dieser Rolle ver-wendet werden soll.


Erstellen eines benutzerdefinierten Ordners

Klicken Sie neben Benutzerdefinierter Ordner auf , um einen benutzerdefinier-ten Inhaltsordner für Benutzer mit dieser Rolle anzugeben. Wenn sich ein Benutzermit dieser Rolle anmeldet, wird der benutzerdefinierte Ordner in der Navigations-leiste unter Teaminhalt angezeigt.

Standardparameter für Rollen festlegen

Klicken Sie neben Parameter auf Einstellungen. Es wird eine Liste von Parame-tern, die Sie angepasst haben, angezeigt. Wählen Sie die Parameter aus, die Sie fürdie Rolle konfigurieren möchten. Wählen Sie dann die Standardwerte aus, die füralle Benutzer in dieser Rolle angezeigt werden sollen. Klicken Sie auf Anwendenund dann auf OK, wenn Sie fertig sind.

Weitere Informationen finden Sie in Verwenden angepasster Parameter in Berichter-stellung.

Lösen von Konflikten bei Benutzern mit mehreren Rollen

Einem Benutzer können mehrere Rollen zugewiesen sein, die unterschiedlicheStandardmotive oder Standardstartseiten umfassen. Zur Lösung dieses Problemsklicken Sie beim Festlegen von Anpassungen für eine Rolle auf Erweitert und le-gen Sie eine Priorität von 0 bis 10 für die Rolle fest. Im Falle eines Konflikts wer-den die Anpassungen für die Rolle mit der höchsten Priorität verwendet. Der RolleSystemadministrator ist eine fest codierte Priorität von 1000 zugeordnet.

AuthentifizierungsproviderDie Benutzerauthentifizierung in IBM Cognos Analytics wird mit Authentifizie-rungsprovidern verwaltet. Authentifizierungsprovider definieren Benutzer, Grup-pen und Rollen für die Authentifizierung. Zu den in den Providern gespeichertenInformationen gehören unter anderem Benutzernamen, IDs, Kennwörter, regionaleEinstellungen und persönliche Präferenzen.

In der Cognos Analytics-Benutzerschnittstelle werden Authentifizierungsprovider

durch Namespaces

dargestellt.

Cognos Analytics unterstützt die folgenden Typen von Authentifizierungsprovi-dern:v Active Directoryv OpenID Connectv Benutzerdefinierter Java-Providerv OpenID Connect-Authentifizierungsproxyv IBM Cognos Series 7v LDAPv SAPv SiteMinder


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

Authentifizierungsprovider werden in IBM Cognos Configuration unter der Kate-gorie Security > Authentication konfiguriert. Nachdem der Provider-Namespacedort hinzugefügt und der IBM Cognos-Service erneut gestartet wurde, wird derNamespace-Name unter Verwalten > Konten angezeigt und Benutzer können sichmit diesem Namespace bei Cognos Analytics anmelden. Weitere Information zumKonfigurieren von Authentifizierungsprovidern finden Sie in der VeröffentlichungIBM Cognos Analytics - Installation und Konfiguration.

Sie können keine Benutzer, Gruppen oder Rollen in Namespaces von Authentifizie-rungsprovidern aus Cognos Analytics erstellen. Sie können jedoch Benutzer, Grup-pen und Rollen von diesen Namespaces zu Gruppen und Rollen im Cognos-Namespace hinzufügen.

Mehrere Namespaces

Wenn mehrere Namespaces für Cognos Analytics konfiguriert sind, müssen Sie amAnfang einer Sitzung einen Namespace auswählen. Sie können sich jedoch auchnoch zu einem späteren Zeitpunkt in der Sitzung bei anderen Namespaces anmel-den. Beim Festlegen von Zugriffsberechtigungen möchten Sie beispielsweise even-tuell Einträge aus verschiedenen Namespaces referenzieren. Um sich bei einem an-deren Namespace anzumelden, müssen Sie sich nicht bei dem aktuell verwendetenNamespace abmelden. Sie können bei mehreren Namespaces gleichzeitig angemel-det sein.

Ihre primäre Anmeldung sind der Namespace und die Berechtigungsnachweise,die Sie am Anfang der Sitzung verwendet haben. Die Namespaces, bei denen sichsich zu einem späteren Zeitpunkt in der Sitzung anmelden, sowie die entsprechen-den Berechtigungsnachweise sind Ihre sekundären Anmeldungen.

Wenn Sie einen der Namespaces löschen, können Sie sich mit einem anderen Na-mespace anmelden. Wenn Sie alle Namespaces mit Ausnahme desCognos-Name-space löschen, werden Sie nicht zur Anmeldung aufgefordert. Wenn der anonymeZugriff aktiviert ist, werden Sie automatisch als anonymer Benutzer angemeldet.Ist der anonyme Zugriff nicht aktiviert, haben Sie keinen Zugriff auf die Anmelde-seite. Aktivieren Sie in diesem Fall den anonymen Zugriff über Cognos Configura-tion.

OpenID Connect-Namespaces verwaltenVerwenden Sie den Namespacetyp OpenID Connect, um die OpenID Connect-Authentifizierung für IBM Cognos Analytics zu implementieren.

Cognos Analytics unterstützt die folgenden OpenID Connect-Identitätsprovider.Diese Liste kann im Laufe der Zeit erweitert werden:

11.0.6 und höherIBMid

11.0.7 und höherOkta

Google

ADFS (Active Directory Federation Services)

Azure AD (Active Directory)

Salesforce

PingFederate


Site Minder

IBMid ist der IBM Identitätsservice, eine cloudbasierte ID-Zugriffs- und Manage-mentlösung, die Identitäts- und Single Sign-on-Services für IBM Anwendungen be-reitstellt.

Nach der Konfiguration des OpenID Connect-Namespace in IBM Cognos Configu-ration haben alle OpenID Connect-Benutzer Zugriff auf Cognos Analytics. Bei derAnmeldung werden die Namen der Benutzer automatisch im Namespace ange-zeigt.

Als Systemadministrator müssen Sie möglicherweise basierend auf der Anzahl derAnzahl der Lizenzen oder anderen Faktoren die Anzahl der Benutzer beschränken,die auf das Produkt zugreifen können. Führen Sie dazu die folgenden optionalenSchritte durch:v Fügen Sie eine begrenzte Anzahl von Benutzern zum OpenID Connect-Name-

space hinzu.Sie können die Benutzer entweder einzeln hinzufügen oder mehrere Benutzeraus einer CSV-Datei importieren. Weitere Informationen finden Sie in „Erstelleneiner CSV-Datei” auf Seite 11.

v Fügen Sie die OpenID Connect-Benutzer zu Gruppen oder Rollen im Cognos-Namespace hinzu.Durch die Verwendung der Cognos-Gruppen und Rollen können Sie schnell dieerforderlichen Zugriffsberechtigungen für verschiedene Benutzer zuweisen.

v IBM Cognos Configuration, unter Sicherheit > Authentifizierung, setzen Sie Zu-griff auf Mitglieder des integrierten Namespace begrenzen auf 'true'.Nur Mitglieder des integrierten Cognos-Namespace haben jetzt Zugriff auf Cog-nos Analytics.

Vorgehensweise1. Melden Sie sich bei IBM Cognos Analytics als Systemadministrator an.2. Melden Sie sich beim OpenID Connect-Namespace an.3. Navigieren Sie zu Verwalten > Konten und öffnen Sie den OpenID Connect-

Namespace.

4. Wählen Sie das Symbol 'Benutzer hinzufügen'

aus, um Benutzer zum Na-mespace hinzuzufügen.v Um einen einzelnen Benutzer hinzuzufügen, geben Sie die E-Mail des Benut-

zers und den bevorzugten Namen ein und klicken Sie auf Hinzufügen.v Um Benutzer aus einer CSV-Datei zu importieren, klicken Sie auf Importie-

ren und wählen Sie die entsprechende Datei aus. Weitere Informationen fin-den Sie in „Erstellen einer CSV-Datei” auf Seite 11.Dieselbe CSV-Datei kann mehrfach importiert werden. Wenn ein Benutzer-konto bereits im Namespace vorhanden ist, wird das Konto aktiviert. Siekönnen den Importvorgang auch wiederholen, falls zuvor importierte Einträ-ge falsch zu sein scheinen.Wenn Sie mehrere Dateien haben, wiederholen Sie diesen Schritt für die an-deren Dateien.

5. Fügen Sie die OpenID Connect-Benutzer zu Gruppen oder Rollen im Cognos-Namespace hinzu.


a. Öffnen Sie den Cognos-Namespace und suchen Sie nach der Gruppe oderRolle, der Sie Benutzer aus dem OpenID Connect-Namespace hinzufügenmöchten.

b. Wählen Sie im Kontextmenü

der Gruppe oder Rolle Eigenschaften undanschließend die Registerkarte Mitglieder aus.

c. Klicken Sie auf das Symbol 'Mitglied hinzufügen' .d. Wählen Sie das Fenster Mitglieder hinzufügen, wählen Sie Ihren OpenID

Connect-Namespace und dann die entsprechenden Benutzer aus. Sie kön-nen mehrere Benutzer gleichzeitig auswählen.

e. Klicken Sie auf Hinzufügen. Die ausgewählten Mitglieder werden auf derRegisterkarte Mitglieder angezeigt.

f. Wiederholen Sie die Schritte, um die OpenID Connect-Benutzer zu anderenCognos-Gruppen oder -Rollen hinzuzufügen.

6. Zum Löschen eines Eintrags klicken Sie im Kontextmenü

neben der betref-fenden Gruppe, Rolle oder dem betreffenden Ordner auf Löschen.

Ergebnisse

Benutzer, die den OpenID Connect-Namespace für die Anmeldung bei CognosAnalytics verwenden, werden an eine externe Anmeldeseite weitergeleitet, auf dersie ihre Berechtigungsnachweise eingeben können. Wenn die Berechtigungsnach-weise akzeptiert werden, können die Benutzer auf Cognos Analytics zugreifen.

Erstellen einer CSV-DateiDie CSV-Datei, die die Liste der Benutzer enthält, die in den OpenID Connect-Na-mespace importiert werden sollen, muss ordnungsgemäß formatiert sein, damit derImport erfolgreich durchgeführt werden kann.

Die erste Zeile in dieser Datei ist der Header. Diese Zeile muss die Spalte emailenthalten und kann die folgenden optionalen Spalten aufweisen: defaultName,businessPhone, faxPhone, givenName, homePhone, mobilePhone, pagerPhone, pos-talAddress, surname, userName.

Tipp: Alle Spaltennamen sind Eigenschaften der Kontoklasse ('account') in IBMCognos Analytics. Bei den Namen muss die Groß-/Kleinschreibung beachtet wer-den und sie müssen genau wie in diesem Dokument angegeben eingegeben wer-den.

Alle anderen Zeilen in der Datei enthalten Werte, die den in der ersten Zeile ange-gebenen Werten entsprechen.

Nachfolgend finden Sie ein Beispiel einer CSV-Datei mit zwei Benutzern:v Zeile 1: email,defaultName,givenName,surnamev Zeile 2: [email protected],Andy Bergin,Andy,Berginv Zeile 3: [email protected],Kirsten Vaughan,Kirsten,Vaughan

Sie können alle Ihre Benutzer in eine CSV-Datei einfügen oder mehrere Dateien mitweniger Namen in jeder Datei erstellen.

Nachdem die Datei importiert wurde, wird der Wert für defaultName für den Be-nutzer folgendermaßen festgelegt:v Wenn defaultName in der CSV-Datei angegeben ist, wird der Name verwendet.


v Wenn defaultName nicht in der CSV-Datei angegeben ist, jedoch givenName undsurname angegeben sind, wird der Standardname als givenName surname festge-legt.

v Wenn weder defaultName noch givenName oder surname angegeben ist, wird derWert für email als Standardname verwendet.

Mehrere Benutzer können den gleichen Vor- und Nachnamen haben. Um poten-zielle Konflikte zu vermeiden, legen Sie entweder einen anderen Wert fürdefaultName für die Benutzer fest oder geben Sie nicht surname und givenName fürsie an. Sie können auch den Wert für surname ändern, indem Sie dem Nachnamenein eindeutiges Zeichen oder eine eindeutige Zahl hinzufügen, wie Simpson1 oderSimpson2.

Suchen von Benutzern, Gruppen und RollenAls Administrator müssen Sie häufig die Benutzer, Gruppen und Rollen lokalisie-ren, die Sie verwalten.

In der Ansicht Namespaces unter Konten werden alle Namespaces, die für dieVerwendung mit IBM Cognos Analytics konfiguriert sind, und der Cognos-Name-space angezeigt. Sie können nur in den Namespaces, bei denen Sie angemeldetsind, und im Cognos-Namespace navigieren.

Suchen von Einträgen

Ein Namespace enthält möglicherweise tausende Benutzer und zahlreiche Grup-pen, Rollen und Ordner. Sie können diese Einträge nur finden, indem Sie die Such-funktion unter Konten verwenden. Sie können immer nur in einem Namespacenach Einträgen suchen. Sie müssen also zunächst den Namespace auswählen und

dann auf das Suchsymbol

klicken. Die Suche wird ebenfalls verwendet, wennSie Gruppen- und Rollenmitglieder hinzufügen, Zugriffsberechtigungen angebenusw.

Filtern von Einträgen

Sie können Benutzer, Gruppen und Rollen filtern, um die angezeigten Einträge ein-zugrenzen. Geben Sie bei Verwendung im Rahmen der Suche für schnellere Ant-

worten die Filterkriterien an. Klicken Sie auf das Filtersymbol

und wählen Siedie Filteroptionen aus oder ab.


Kapitel 2. Verwalten von Inhalten

Am häufigsten wird eine Sicherung und Wiederherstellung von Inhalt durchge-führt, weil Inhalt innerhalb des Anwendungsentwicklungsprozesses von einer Test-umgebung in eine Produktionsumgebung verschoben werden soll oder weil einUpgrade auf eine neue Produktversion vorbereitet wird.

Zum Verwalten von Inhalten ist die Administrationsberechtigung System konfigu-rieren und verwalten erforderlich.

Bereitstellungsplanung

Der Prozess des Sicherns und Wiederherstellens von Inhalt wird als Bereitstellungbezeichnet. In der Quellenumgebung und in der Zielumgebung müssen dieselbenNamespaces für Richtlinien, Benutzer, Rollen und Gruppen verwendet werden, da-mit Zugriffsberechtigungseinstellungen beim Bereitstellen von Inhalt einwandfreifunktionieren. Der Cognos-Namespace wird beim Erstellen einer Sicherung einge-schlossen. Stellen Sie sicher, dass die übrigen erforderlichen Namespaces vor demWiederherstellen des Inhalts in der Zielumgebung konfiguriert sind.

Falls die Bereitstellung im Rahmen eines Upgrades erfolgt, können Sie vor dem Er-stellen einer Sicherung eine Konsistenzüberprüfung durchführen, um Inkonsisten-zen innerhalb des Content Stores oder zwischen dem Content Store und externenNamespaces zu finden und zu korrigieren. Eine Konsistenzüberprüfung können Sieüber die Option Administrationskonsole > Konfiguration > Inhaltsadministration> Neue Konsistenzüberprüfung ausführen.

Sichern von Inhalt

Zum Schutz sensibler Informationen werden alle Sicherungen verschlüsselt. WennSie den Inhalt wiederherstellen möchten, müssen Sie das Kennwort angeben, dasbeim Erstellen der Sicherung festgelegt wurde.

Die Sicherung wird als Archivdatei (.zip) an der in Cognos Configuration angege-benen Bereitstellungsarchivposition gespeichert. Als Standardposition wird dasVerzeichnis Installationsposition\deployment verwendet. Wenn der Content Store ineiner anderen Instanz von IBM Cognos Analytics bereitgestellt werden soll, bei-spielsweise auf dem für die Produktionsumgebung verwendeten Computer, kopie-ren Sie die Archivdatei in die Speicherposition der Bereitstellungsdateien auf demZielcomputer, damit die Datei für die Wiederherstellung verfügbar ist.

Eine Sicherung umfasst den folgenden Inhalt.v Öffentliche Ordnerv Packagesv Berichtev Datenquellenv Verteilerlisten und Kontaktev Druckerkonfigurationv Zugriffsberechtigungseinstellungenv Den Cognos-Namespacev Bereitstellungsspezifikationen

13

Persönliche Einträge zu den einzelnen Benutzern, zum Beispiel Berichte und Ord-ner aus dem Bereich Eigene Inhalte eines Benutzers, sind nicht in der Sicherungenthalten.

Wiederherstellen von Inhalt

Für die Wiederherstellung von Inhalt muss sich die Sicherungsdatei, die Sie ver-wenden möchten, an der in Cognos Configuration angegebenen Bereitstellungsar-chivposition befinden. Als Standardposition wird das VerzeichnisInstallationsposition\deployment verwendet. Sie müssen das beim Erstellen der Si-cherung festgelegte Kennwort angeben.

Beim Wiederherstellen von Inhalt werden die Inhalte des Ziel-Content Stores ent-fernt und durch die Inhalte des Quellen-Content Stores ersetzt.


Kapitel 3. Datenserververbindungen

Ein Datenserver definiert die physische Verbindung zu einer Datenbank.

Die Datenserverbindung gibt die Parameter an, die zum Herstellen einer Verbin-dung mit der Datenbank erforderlich sind, beispielsweise die Position der Daten-bank und das Zeitlimit. Eine Datenserververbindung kann Authentifizierungsinfor-mationen umfassen.

IBM Cognos Analytics unterstützt mehrere relationale Datenquellen und OLAP-Datenquellen. Die Liste unterstützter Datenquellen kann sich zwischen den Relea-ses ändern. Informationen zu den gegenwärtig unterstützten Datenquellen findenSie auf der Website Unterstützte Softwareumgebungen (www.ibm.com/support/docview.wss?uid=swg27047186).

Wenn Sie Datenbankauthentifizierungsinformationen, wie Cognos Analytics-Be-rechtigungsnachweise oder eine Anmeldung für die Verbindung, einschließen,müssen Benutzer nicht bei jeder Verwendung der Verbindung Datenbankauthentifi-zierungsinformationen eingeben. Die beim Erstellen einer Datenserververbindungerzeugte Anmeldung ist standardmäßig für die Gruppe Alle verfügbar. Sie könnendie Berechtigungen für die Anmeldung über die Eigenschaften der Datenserverver-bindung ändern.

Herstellen einer DatenserververbindungEine Datenserververbindung gibt die Parameter an, die zum Herstellen einer Ver-bindung mit der entsprechenden Datenbank erforderlich sind.

Jeder Datenserver kann über eine oder mehrere Verbindungen verfügen. Die Ver-bindungsnamen müssen eindeutig sein.


Für die meisten Datenserververbindungen ist ein von einem Datenbankanbieter be-reitgestellter JDBC-Treiber erforderlich. Verwenden Sie eine Version des JDBC-Trei-bers, die mit Java™ Runtime Environment Version 8 kompatibel ist. Kopieren Sieden Treiber in das Cognos Analytics-Verzeichnis Installationsposition\driversund starten Sie den Abfrageservice erneut. Ein Neustart des vollständigen IBMCognos-Service ist nicht erforderlich.

Für die Erstellung von Datenserververbindungen benötigen Sie die Administrati-onsberechtigung Datenquellenverbindungen. Weitere Informationen finden Sie inder Veröffentlichung IBM Cognos Analytics - Verwaltung und Sicherheit.


In der Benutzerschnittstelle Verwalten > Datenserververbindungen stehen die zurDefinition der folgenden Verbindungsfeatures benötigten Steuerelemente nicht zurVerfügung:v Verbindungsbefehlsblöckev Db2 LUW, Db2 for z/OS, dashDB, IBM Big SQL - vertrauenswürdige Verbindun-

gen

15

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

v Db2 for z/OS - Identitätsweitergabev Oracle - einfache Verbindungen (Befehlsblöcke erforderlich)

Wenn Sie Verbindungen definieren möchten, die diese Features umfassen, verwen-den Sie die Administrationskonsole. Weitere Informationen finden Sie in der Ver-öffentlichung IBM Cognos Analytics - Verwaltung und Sicherheit.

Vorgehensweise1. Klicken Sie auf Verwalten > Datenserververbindungen.2. Klicken Sie im Fensterbereich Datenserververbindungen auf das Symbol Da-

tenserver hinzufügen .3. Wählen Sie den Datenservertyp in der Liste der unterstützten Typen aus.4. Geben Sie im Feld Neue Datenserververbindung einen eindeutigen Namen für

die Verbindung ein.5. Klicken Sie neben Verbindungsdetails auf Bearbeiten und geben Sie die Ver-

bindungsdetails für den Typ der Verbindung ein, die Sie erstellen.Für die meisten Verbindungen müssen Sie die JDBC-URL angeben. Unter denVerbindungsdetails können Sie die Syntax und eine Beispiel-URL anzeigen.Möglicherweise müssen Sie sich an den Datenbankadministrator wenden, umweitere Details zu erhalten, oder die Informationen in der Dokumentation desDatenbankanbieter lesen.Geben Sie im Feld Verbindungseigenschaften den Namen der unterstützten Ei-genschaft ein. Informationen zu den unterstützten JDBC-Eigenschaften findenSie in „Cognos-spezifische Verbindungsparameter” auf Seite 17. Geben Sie fürPlanning Analytics-Verbindungen den Host und die HTTP-Portnummer derTM1-Datenbank ein. Wenn Sie eine SSL-Verbindung verwenden möchten, wäh-len Sie das Feld SSL verwenden aus.

6. Geben Sie unter Authentifizierungsmethode an, wie auf den Datenserver zuge-griffen werden soll. Sie können eine der nachfolgend aufgeführten Optionenauswählen.

'Anonyme Verbindung herstellen' oder 'Integrierte Sicherheit'Wählen Sie die Option Anonyme Verbindung herstellen, wenn der an-onyme Zugriff auf den Datenserver zulässig ist.

Wählen Sie die Option Integrierte Sicherheit aus, wenn die TM1-Da-tenbank für den integrierten Sicherheitsmodus 4 oder 5 konfiguriert ist.Diese Option ist nur für Planning Analytics-Verbindungen anwendbar.

Zur Eingabe der Benutzer-ID und des Kennworts auffordernWählen Sie diese Option aus, wenn der Benutzer bei jeder Anmeldungzur Eingabe der Datenbank-Berechtigungsnachweise aufgefordert wer-den soll.

IBM Cognos Analytics-Berechtigungsnachweise verwendenWählen Sie diese Option aus, um die Berechtigungsnachweise an denDatenserver zu übergeben, die auch für die Authentifizierung für Cog-nos Analytics verwendet werden.

Die folgende Anmeldung verwendenWählen Sie diese Option, um eine Anmeldung für die Verbindung zu-zuweisen. Wählen Sie eine Anmeldung in der Dropdown-Liste aus odererstellen Sie eine neue Anmeldung, indem Sie auf das Symbol Hinzufü-

gen klicken. Geben Sie im Fenster Neue Datenserververbindungauf der Registerkarte Berechtigungsnachweise eine Benutzer-ID und


ein Kennwort ein. Um die Anmeldung auf bestimmte Benutzer, Rollenoder Gruppen zu beschränken, klicken Sie auf der Registerkarte Be-

rechtigungen auf und geben Sie die Zugriffsberechtigungen fürdie Anmeldung an.

7. Klicken Sie auf Testen, um die Datenserververbindung zu überprüfen, und an-schließend auf Speichern, um die neue Datenserververbindung zu speichern.

Ergebnisse

Der neue Verbindungsname wird im Fenster Datenserververbindungen angezeigt.Sie können die Datenserververbindung bearbeiten, beispielsweise durch Hinzufü-gen oder Ändern der entsprechenden Anmeldung, indem Sie auf ihren Namen kli-cken.

Cognos-spezifische VerbindungsparameterSie können eine Reihe optionaler, für Cognos spezifische Parameter für JDBC-Ver-bindungen angeben.

Sie können diese Parameter beim Erstellen oder Aktualisieren von JDBC-Verbin-dungen für Datenquellen in IBM Cognos Administration oder IBM Cognos Frame-work Manager oder beim Erstellen oder Aktualisieren von Datenserververbindun-gen in der Verwaltungsschnittstelle Verwalten > Datenserververbindungen in IBMCognos Analytics Version 11.0.x angeben.

In anderen Verbindungseditoren können diese Parameter als Verbindungseigen-schaften oder JDBC-Verbindungsparameter angegeben werden.

ibmcognos.fetchBufferSize

Mit diesem Parameter wird der Abrufumfang des JDBC-Treibers für Datenquellen-verbindungen in IBM Cognos Analytics festgelegt.

Wenn der dynamische Abfragemodus in IBM Cognos Analytics Abfragen mithilfevon JDBC ausführt, wird der Wert des Abrufumfangs, der an einen JDBC-Treiberübergeben wird, dynamisch berechnet. Die Unterstützung für den Abrufumfanghängt von den Datenbankanbietern ab. Die Anbieter entscheiden zudem, was derAbrufumfang bedeutet und wie der Umfang lautet, wenn er intern im Treiber undServer verwendet wird. Weitere Informationen finden Sie in der JDBC-Dokumenta-tion des entsprechenden Anbieters.

Der dynamische Abfragemodus berechnet einen Wert für eine Abfrage mit der fol-genden Formel: maximum( (bufferSize / 'row-size'), 10)

Der Standardwert für die Puffergröße ist 100 Kilobyte (KB). Die Zeilenlänge wirdanhand des Umfangs der Spalten berechnet, die durch den Ergebnissatz in einerAbfrage projiziert werden. Abfragen, die Spalten mit hoher Genauigkeit oder vieleSpalten projizieren, verwenden einen geringeren Abrufumfang als die Abfragen,die weniger Spalten oder Spalten mit einer geringeren Genauigkeit projizieren.

Wenn das Abrufen eines Ergebnissatzes durch die Verwendung einer größeren Puf-fergröße verbessert werden kann, kann ein Cognos-Administrator die Verbindungs-eigenschaft ibmcognos.fetchBufferSize angeben. Wenn der Wert für diese Eigen-schaft kleiner als 10 Kilobyte oder größer als 10 Megabyte ist, passt derdynamische Abfragemodus diesen Wert automatisch an.

Kapitel 3. Datenserververbindungen 17

Wenn 'ibmcognos.fetchBufferSize' > 1024 * 10240 ist, dann ist 'bufferSize' = 1024 *10240.

Wenn 'ibmcognos.fetchBufferSize' < 10240 ist, dann ist 'bufferSize' = 10240.

Größere Abrufumfänge sind nicht immer zu empfehlen, da sie die Speicherbele-gung durch den JDBC-Treiber potenziell erhöhen können und damit nicht zu eineLeistungsverbesserung führen. Lesen Sie stets die Dokumentation des Daten-bankanbieters und empfohlene Verfahren, bevor Sie große Werte für die Eigen-schaft ibmcognos.fetchBufferSize verwenden.

ibmcognos.decfloat

Wenn dieser Parameter angegeben wird, erhält der dynamische Abfragemodus dieAnweisung, einen dezimalen Gleitkommadatentyp, DECFLOAT 128, zu verwen-den, mit dem Werte mit einer Genauigkeit von bis zu 34 Stellen präzise dargestelltwerden. Wenn eine Spalte mit großer Genauigkeit festgestellt wird, wird ihr Typintern in DECFLOAT geändert und der Datentyp im Modell oder Bericht wird alsDECIMAL(0,0) beschrieben.

Geben Sie zum Aktivieren dieses Features den Verbindungsparameteribmcognos.decfloat=true für die Datenbankverbindung an, die vom dynamischenAbfragemodus verwendet wird. In bereits vorhandenen Modellen müssen die Spal-ten mit DECIMAL(0,0) anstelle von DOUBLE erneut zugeordnet werden.

Damit der dynamische Abfragemodus die von einer Abfrage zurückgegebenen Zei-len lesen kann, muss der JDBC-Treiber die Spaltenwerte mit einem bestimmten Ja-va-Datentyp zurückgeben. In früheren Releases konnte eine Datenbank wie ORAC-LE eine numerische Spalte zurückgeben, bei der die Genauigkeit dazu führte, dassdie dynamische Abfrage den Datentyp DOUBLE verwendete. Wenn die von einerAbfrage zurückgegebenen Werte eine Genauigkeit von mehr als 16 Stellen aufwie-sen, konnte die Konvertierung einen ungenauen Wert ergeben.

Beispiel: Wenn für eine ORACLE-Spalte der Datentyp NUMBER (ohne Angabe derGenauigkeit) festgelegt war oder wenn ein Aggregat wie z. B. SUM berechnet wur-de, das ORACLE als NUMBER zurückgab, konnte der zurückgegebene Wert1234567890123456789 in den Wert 1.23456789012345677E18 konvertiert werden. Diebeiden Werte sind nicht identisch.

Wenn die Datenbank keine großen Werte zurückgibt, aktivieren Sie diese Eigen-schaft nicht und stellen Sie sicher, dass die Modelle keine Spalten mit dem Daten-typ DECIMAL(0,0) enthalten. Dies ermöglicht es dem dynamischen Abfragemodus,einen Datentyp zu verwenden, der weniger Speicher benötigt als der DatentypDECFLOAT.

ibmcognos.qualifier_list

Mit diesem Parameter können beim Ausführen von dynamischen Abfragen Meta-daten vereindeutigt werden. Dabei wird eine Liste mit mindestens einem Qualifi-kationsmerkmal Datenquellen zugeordnet, die in IBM Cognos Analytics definiertsind.

Die folgenden Beispiele zeigen die zu verwendende Syntax bei Angabe des Para-meters ibmcognos.qualifier_list sowie die Werte, die für diesen Parameter zuge-wiesen werden können:v ibmcognos.qualifier_list=CATALOG1.SCHEMA1, CATALOG2.SCHEMA2


v ibmcognos.qualifier_list=SCHEMA1, SCHEMA2v ibmcognos.qualifier_list=CATALOG1.SCHEMA1, SCHEMA2v ibmcognos.qualifier_list=CATALOG1, CATALOG2

Mit einem Punkt im Qualifikationsmerkmale werden die Katalog- und Schema-komponenten voneinander getrennt. Wenn kein Punkt vorhanden ist und die Da-tenbank Schemas unterstützt, wird der Wert als Schema behandelt. Andernfallswird der Wert als ein Katalog verarbeitet, wenn die Datenbank Kataloge unter-stützt.

Der Abfrageservice durchsucht die Liste in der angegebenen Reihenfolge und ver-wendet die Spaltenmetadaten, die er für das erste übereinstimmende Qualifikati-onsmerkmal findet. Wird keine Übereinstimmung gefunden, wird ein Fehler zumehrdeutigen Metadaten ausgelöst.

Der Administrator muss bestätigen, dass die Liste der für diesen Parameter bereit-gestellten Qualifikationsmerkmale in Reihenfolge und Inhalt identisch ist mit allenSuchlisten, die für die Datenbanksitzung des Benutzers definiert wurden. Die Listeder Qualifikationsmerkmale wird nur angewendet, wenn die Sitzung versucht, Me-tadaten zu vereindeutigen, die von einem JDBC-Treiber zurückgegeben wurden.Qualifizierte Namen in dynamischen SQL-Anweisungen spiegeln die Werte wider,die Katalog- oder Schemaeigenschaften zugewiesen sind, die die Datenquelle desPackages während der Abfrageplanung verwendet hat.

ibmcognos.authentication

Mit diesem Parameter können bei der Verwendung der Kerberos-AuthentifizierungDatenquellenverbindungen konfiguriert werden.

Geben Sie für die verschiedenen Datenquellenverbindungstypen den Parameteribmcognos.authentication=java_krb5 an und fügen Sie dann die Eigenschaftenhinzu, die bei Bedarf vom JDBC-Treiber für die Kerberos-Authentifizierung benö-tigt werden. Die folgenden Beispiele veranschaulichen, wie dieser Parameter für ei-nige Datenquellenverbindungen festgelegt werden kann:v Geben Sie für Teradata-Verbindungen

ibmcognos.authentication=java_krb5;LOGMECH=KRB5; an.v Geben Sie für SAP-HANA-Verbindungen ibmcognos.authentication=java_krb5;

an.v Geben Sie für Microsoft SQL Server-Verbindungen

ibmcognos.authentication=java_krb5;authenticationScheme=JavaKerberos; an.

ibmcognos.maxvarcharsize

Für die dynamische Abfrage kann ein größerer VARCHAR-Standardgenauigkeits-wert verwendet werden als der Standardwert, der durch die Datenbank unterstütztwird. Dieser Parameter wird zum Überschreiben des VARCHAR-Standardgenauig-keitswerts für Datenbanken für den dynamischen Abfragemodus verwendet.

Um diesen Parameter anzugeben, müssen Sie die folgende Syntax verwenden; da-bei ist N ein ganzzahliger Wert größer als null, der vom Datenbankanbieter unter-stützt wird:ibmcognos.maxvarcharsize=N

Der SQL-Standard arbeitet mit dem CLOB-Datentyp sowie mit dem NCLOB-Typ(National Character Large Object), um große Zeichenwerte aufzunehmen. Unter-


schiedliche Datenbanken unterstützen den CLOB-Datentyp bzw. ihre eigenen Versi-onen dieses Typs mit ähnlichen Merkmalen. Der CLOB-Datentyp beinhaltet einigeEinschränkungen hinsichtlich der Arten von SQL-Konstrukten, die in Abfragen ver-wendet werden können. Außerdem können Datenbankanbieter weitere Einschrän-kungen für diesen Datentyp bestimmen, z. B. was die Handhabung von CLOB-Spalten in den Clientschnittstellen betrifft, z. B. bei der JDBC. Zur VermeidungCLOB-bezogener Einschränkungen werden durch den dynamischen AbfragemodusCLOB-Spalten automatisch in VARCHAR-Spalten konvertiert, und zwar mit derFunktion CAST. Daraus folgt dann, dass die ersten N Zeichen des CLOB-Typs alsVARCHAR an die dynamische Abfrage zurückgegeben werden.

Tipp: Die automatische Konvertierung mit CAST wird nicht durchgeführt, wenn einJDBC-Treiber die Spalte als VARCHAR und nicht als CLOB beschreibt und wenndie Spaltenreferenz über eine benutzerdefinierte Funktion des Typs CAST verfügt.

Wenn die CLOB-Länge in einer Zeile größer ist als die CAST-Genauigkeitsdaten,kommt es zu einer Abschneidung.

In einigen Fällen unterstützt ein Datenbankanbieter möglicherweise eine größereGenauigkeit, sofern bestimmte Datenbankkonfigurationseinstellungen erfüllt sind,z. B. Seiten- und Zeilenlänge oder Servereinstellungen. Sind diese Vorbedingungenerfüllt, kann für eine Datenserverbindung ein größerer Wert angegeben werden.Sind diese Vorbedingungen bei der Verwendung eines Werts, der größer als dervon der Datenbank unterstützte Wert ist, nicht erfüllt, können die SQL-Anweisun-gen nicht ausgeführt werden. Lesen Sie die Dokumentation des Datenbankanbie-ters, bevor Sie größere VARCHAR-Genauigkeitswerte verwenden, und lassen Sieden Wert vom Datenbankadministrator bestätigen.

Bei der dynamischen Abfrage werden die folgenden VARCHAR-Standardgenauig-keitswerte für die unterschiedlichen Datenbanken verwendet:

Tabelle 1. VARCHAR-Standardgenauigkeitswerte bei dynamischem Abfragemodus

Datenbank VARCHAR-Standardgenauigkeit

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

Andere Anbieter 1024


Ist der Wert für ibmcognos.maxvarcharsize größer als die maximale Java-Ganzzahl(2147483647) oder ist er überhaupt keine Ganzzahl, wird der Wert ignoriert.

Ist der Wert für ibmcognos.maxvarcharsize kleiner als der Standardwert 1024 unddie VARCHAR-Größe des Anbieters, wird der kleinste dieser beiden Werte undnicht der Wert für ibmcognos.maxvarcharsize verwendet.

Vorheriges Laden von Metadaten von einer DatenserververbindungWenn ein Datenserver als Quelle für ein Datenmodul angegeben wird, werden Me-tadaten vom Datenserver in den Content Store geladen. Dieser Prozess kann zeit-aufwendig sein und lässt sich durch vorheriges Laden von Metadaten beschleuni-gen.

Durch die zuvor geladenen Metadaten wird die Datenmodellierung beschleunigt,da das System auf der Basis der geladenen Metadaten Standardeinstellungen, zumBeispiel Nutzung und Aggregation, intelligent angeben kann.

Vorgehensweise1. Klicken Sie auf Verwalten > Datenserververbindungen. Im Slideout-Fenster

wird eine Liste mit Datenserververbindungen angezeigt.2. Klicken Sie im Fenster Datenserververbindungen auf eine Datenserververbin-

dung und anschließend auf der Registerkarte Verbindungen auf einen Verbin-dungsnamen.

3. Klicken Sie auf der Registerkarte Schemas neben einem Schemanamen auf das

Symbol Mehr , um Daten zu laden oder die Ladeoptionen zu ändern.4. Klicken Sie auf Ladeoptionen, um den Umfang der zu ladenden Daten zu än-

dern.Auf der Registerkarte Tabellen können Sie angeben, welche Tabellen vorher ge-laden werden.

5. Klicken Sie auf Metadaten laden, um Metadaten zu laden.6. Wenn die Metadaten für ein Schema bereits geladen sind, klicken Sie auf Meta-

daten löschen, um die Metadaten aus dem Content Store zu entfernen.

Referenz und FehlerbehebungBeim Herstellen und Verwalten von Datenserververbindungen in IBM Cognos Ana-lytics können Probleme mit JDBC-Treibern, mit der Datenserverversionsunterstüt-zung, mit der Authentifizierung usw. auftreten.

Die Verbindungsinformationen variieren abhängig vom jeweiligen Datenservertyp.Weitere Informationen finden Sie in der Dokumentation des Datenbankanbieters.

JDBC-Treiber von Cloudera ImpalaIBM Cognos Analytics unterstützt Verbindungen zu Cloudera Impala-Datenser-vern, die JDBC-Treiber der Version 2.5.34 und höher verwenden. JDBC-Treiberversi-onen vor Version 2.5.34 werden nicht unterstützt.

Beim Herstellen einer Verbindung zu Cloudera Impala überprüft die Abfrageengi-ne die Version des JDBC-Treibers. Bei Versionen vor Version 2.5.34 wird eine Feh-lernachricht zurückgegeben.


Ersetzen Sie zur Vermeidung potenzieller Probleme ältere JDBC-Treiberversionenfür Impala in der Cognos Analytics-Umgebung durch neuere Versionen. Der Trei-ber kann von der Cloudera-Website (www.cloudera.com/downloads/connectors/impala/jdbc/2-5-34.html) heruntergeladen werden. Weitere Informationen findenSie in der Cloudera-Dokumentation.

Blockierte Abfragen in der Pivotal HDB-EngineAbfragen können in der Pivotal HDB-Engine aufgrund eines Defekts im Pivotal-Optimierungsprogramm blockiert werden.

Zur Behebung des Problems kann der Pivotal-Administrator die Serverstandardein-stellungen ändern oder den folgenden Befehlsblock für die Verbindung in IBM Co-gnos Administration hinzufügen.<commandBlock>

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

</commandBlock>

Wenn eine Tabelle in HDB mit Partitionierung erstellt wurde, gibt der Pivotal-JDBC-Treiber Metadaten für jede Partition der Tabelle zurück. Zum gegenwärtigenZeitpunkt ist in der Pivotal-Software keine Möglichkeit vorhanden, die Rückgabeder zusätzlichen Metadaten zu verhindern. Ein Modellierer in IBM Cognos Analy-tics muss diese zusätzlichen Metadaten nicht einbeziehen, damit Abfragen funktio-nieren.

Denodo 5.5- und Denodo 6.0-DatenserverDie Denodo 5.5- und Denodo 6.0-Datenservertypen werden über den Denodo-JDBC-Treiber unterstützt.

Die unterstützte Mindestversion von Denodo 5.5 ist die Aktualisierung 20160322mit angewendetem Denodo-Hotfix #26682. Vorgängerversionen von Denodo 5.5werden nicht unterstützt.

Das erste Release von Denodo 6.0 GA erfordert die Anwendung des Hotfix #26681.

Denodo benötigt einen JDBC-Treiber der Version 6.0 für den Zugriff auf einen Ser-ver der Version 6.0 und einen JDBC-Treiber der Version 5.5 für den Zugriff auf ei-nen Server der Version 5.5.

JDBC-Treiber der Denodo-Version 5.5 verhindern die Herstellung von Verbindun-gen zu einem Server der Version 6.0 nicht. Tritt eine solche Situation auf, löst derServer der Version 6.0 möglicherweise Ausnahmebedingungen aus, wenn Abfragenausgeführt werden oder wenn versucht wird, Metadaten zu importieren.

In Cognos Analytics nicht mehr unterstützte DatenquellenBestimmte Datenquellen werden in IBM Cognos Analytics nicht mehr unterstützt.

Alle Datenquellenverbindungen, die in früheren Releases von Cognos Analytics de-finiert wurden, verbleiben im Content Store, bis sie manuell gelöscht oder ggf. ineinen unterstützten Typ geändert werden. Diese Verbindungen sind in den Verwal-tungsschnittstellen sichtbar. Wenn solche Verbindungen in IBM Cognos Administ-ration geöffnet werden, werden sie im Verbindungseditor vom Typ Anderer Typ


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

angezeigt. Dieser Verbindungseditor stellt eine eingeschränkte Schnittstelle zumAnzeigen oder Bearbeiten der Verbindungen sowie für den Zugriff auf die zugehö-rigen Anmeldungen bereit.

Jede Datenquellenverbindung im Content Store wird durch eine Zeichenfolge mitverschiedenen angepassten Namen und Werten dargestellt. Diese Zeichenfolge istin den Verbindungseditoren in Cognos Analytics sichtbar. Beim Testen einer Ver-bindung wird beispielsweise die folgende Zeichenfolge angezeigt:^User ID:^?Password:;LOCAL;PG;DSN=MyDataSourceName;UID=%s;PWD=%s;MyODBCDSN@ASYNC=0@0/0@COLSEQ=

Der Verbindungstyp wird in der Zeichenfolge nach dem Wert LOCAL angezeigt. Imoben genannten Beispiel ist der Verbindungstyp PG.

Wenn Ihre aktuelle Version von Cognos Analytics Verbindungen zu Datenquellenverwendet, die nicht mehr unterstützt werden, können Sie in einigen Fällen dieVerbindungen in die unterstützten Typen ändern.

Cognos Analytics 11.0.8

Die folgenden Datenquellen werden ab Release 11.0.8 nicht mehr unterstützt:v Hitachi Advanced Data Binder Platform (JDBC)v IBM Domino (JDBC)v MongoDB Connector for BI Version 1

Aktualisieren Sie etwaige Verbindungen für Version 1 auf die Verwendung vonMongoDB Connector for BI Version 2.2.1. Aktualisieren Sie außerdem vorhande-ne Cognos-Modelle, während eine Verbindung mit Version 2.2.1 besteht. Auf die-se Weise wird sichergestellt, dass die Modellmetadaten Unterschiede in Datenty-pen und Skalierung widerspiegeln, die in MongoDB Connector for BI 2.2.1eingeführt wurden.


Die folgenden Datenquellen werden ab Release 11.0.6 nicht mehr unterstützt:v Actian Matrix (ODBC und JDBC)

Generische ODBC-Verbindungstypen können verwendet werden, um auf einenODBC-Datenquellennamen zu verweisen, der einen ODBC-Treiber unter Mi-crosoft Windows-Betriebssystemen für den Zugriff auf einen Actian Matrix-Ser-ver verwendet. Sie können keine vorhandene JDBC-Verbindung verwenden.

v Actian Vector (ODBC)Generische ODBC-Verbindungstypen können verwendet werden, um auf einenODBC-Datenquellennamen zu verweisen, der einen ODBC-Treiber unter Mi-crosoft Windows-Betriebssystemen für den Zugriff auf einen Actian Vector-Ser-ver verwendet.

v IBM® IMS™ (JDBC)


Die folgenden Datenquellen werden ab Release 11.0.3 nicht mehr unterstützt:v IBM Cognos Finance - Verbindungstyp CLv Microsoft SQL Server Analysis Services 2005 und 2008 (ODBO) - Verbindungsty-

pen YK und M8


Anwendungen unter Windows-Betriebssystemen sollten den ODBO-Client ver-wenden, der mit der unterstützten Version von Microsoft Analysis Services frei-gegeben wurde. Anwendungen auf anderen Plattformen (nicht Windows) kön-nen eine XMLA-Verbindung (Verbindungstyp X8) verwenden. Die ODBO-Clients, die mit SQL Server Analysis Services 2005, 2008 und 2008 R2 freigege-ben wurden, werden nicht mehr unterstützt. Die Verbindungen für die Versionen2012 (Verbindungstyp M12) und 2014 (Verbindungstyp M14) werden beide un-terstützt. Neue Verbindungen, die auf 2012- oder 2014-Clients verweisen, dürfennur für die Versionen 2012 und 2014 der entsprechenden SQL Server AnalysisServices-Server verwendet werden.Ab Cognos Analytics 11.0.0 unterstützen nur Server mit dem dynamischen Ab-fragemodus SQL Server Analysis Services. Der kompatible Abfragemodus bietetkeine Unterstützung für SQL Server Analysis Services.

v Microsoft SQL Server 2005 und 2008 Native Clients und OLE DB (Verbindungs-typ OL und Provider=SQLNCLI oder SQLNCLI10)Ältere Versionen der Microsoft SQL Server-Clientbibliotheken werden nicht mehrunterstützt (https://msdn.microsoft.com/en-us/library/cc280510.aspx). Für An-wendungen, die über OLE DB auf SQL Server zugreifen müssen, können Sie Na-tive Client-Verbindungen verwenden, die Provider=SQLNCLI11 enthalten. DieseVerbindungen sind parallel zur aktuellen SQL Server Native Client Version 11,die mit SQL Server 2016, 2014 und 2012 unterstützt wird. Alternativ können Ver-bindungen verwendet werden, die den Microsoft-ODBC-Treiber für SQL Serververwenden.

v SAP ECC


Die folgenden Datenquellen werden ab Release 11.0.2 nicht mehr unterstützt:v Composite (ODBC)

Composite (Verbindungstyp CS): Generische ODBC-Verbindungstypen (OD)können verwendet werden, um auf einen ODBC-Datenquellennamen zu verwei-sen, der möglicherweise einen ODBC-Treiber unter Windows-Betriebssystemenfür den Zugriff auf Siebel-Server verwendet. Der dynamische Abfragemodus un-terstützt mehrere Technologien, zum Beispiel Cisco Information Server und De-nodo über JDBC, die potenziell zum Bereitstellen von föderiertem Zugriff aufSiebel-Systeme verwendet werden können.

v IBM Cognos Now! - Real-time Monitoring-Cube (Verbindungstyp LA)Es steht kein alternativer Verbindungstyp zur Verfügung.

v IBM Cognos Planning - Series 7 (Verbindungstyp CR)Es steht kein alternativer Verbindungstyp zur Verfügung.

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

Aktualisierungen nach ReleaseCognos Analytics unterstützt zahlreiche unterschiedliche Datenserver. In den unter-schiedlichen Releases werden Datenserver hinzugefügt, geändert oder entfernt.


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

Zum Anzeigen einer aktuellen Liste mit Datenservern, die für bestimmte Versionenvon Cognos Analytics unterstützt werden, rufen Sie die Seite IBM Cognos Analy-tics 11.0.0 Supported Software Environments auf. Klicken Sie im Abschnitt für dasentsprechende Release, zum Beispiel 11.0.8, auf einen der folgenden Links, um ei-nen detaillierten Bericht über unterstützte Datenquellen anzuzeigen:v Klicken Sie unter Requirements by type (Anforderungen nach Typ) auf den

Link Software. Klicken Sie auf der Registerkarte Supported Software (Unter-stützte Software) auf den Abschnitt Data Sources (Datenquellen). Daraufhinwerden alle unterstützten Datenquellen in einer Tabelle angezeigt.

v Klicken Sie unter Requirements by platform (Anforderungen nach Plattform)auf den Namen des entsprechenden Betriebssystems, zum Beispiel Linux. Kli-cken Sie auf der Registerkarte Supported Software (Unterstützte Software) aufden Abschnitt Data Sources (Datenquellen). Daraufhin werden alle Datenquel-len, die für das ausgewählte Betriebssystem unterstützt werden, in einer Tabelleaufgelistet.

Cognos Analytics 11.0.13 - neue und geänderte FeaturesIBM Cognos Analytics unterstützt den JDBC-Treiber 1.1.1001 von Amazon Athena.Dieser neue Treiber unterstützt den Treiberklassennamen sowie die Verbindungsei-genschaften nicht, die der Vorgängertreiber (1.1.0) unterstützt hat.

JDBC-Treiber 1.1.1001 von Amazon Athena

Der Treiber 1.1.1001 nutzt einen anderen Treiberklassennamen für die einzelnen be-reitgestellten JDBC 4.0-, 4.1- und 4.2-Implementierungen. Bereits vorhandene Ver-bindungen müssen so aktualisiert werden, dass der Treiberklassenname 'com.ama-zonaws.athena.jdbc.AthenaDriver' in eine der folgenden Treiberklassen geändertwird, in Abhängigkeit von der Version:v com.simba.athena.jdbc4.Driverv com.simba.athena.jdbc41.Driverv com.simba.athena.jdbc42.Driver

Der Treiber 1.1.1001 nutzt andere Namen, um den Amazon-Bereich und den S3-Ausgabebucket zu empfangen.

Anmerkung: Bereits vorhandene Verbindungen müssen so aktualisiert werden,dass die erforderlichen Eigenschaften 'AwsRegion' und 'S3OutputLocation' überge-ben werden. Weitere Details zum JDBC-Treiber von Amazon Athena finden Sie inder JDBC-Dokumentation sowie in den Releaseinformationen von Amazon Athenaunter https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html.

Cognos Analytics 11.0.9 - neue und geänderte FeaturesDurch die Änderungen verbessert sich die IBM Cognos Analytics-Serverleistungund die Kompatibilität mit unterstützten Datenbankprodukten wird sichergestellt.

Teradata-JDBC-Verbindungen - verbesserte Abfrageparallelität

Der dynamische Abfragemodus wurde entsprechend geändert um sicherzustellen,dass nur jeweils eine Abfrage für eine Teradata-JDBC-Verbindung ausgeführt wer-den kann. Durch diese Änderung wird die Abfrageparallelität verbessert. Dies istim Abschnitt für Multithreading in der Veröffentlichung Teradata JDBC Driver Re-ference beschrieben.




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

Datenbankadministratoren, die die Datenbankauslastung überwachen, bemerkenmöglicherweise einen Zunahme der Anzahl von Datenbankverbindungen im Ver-gleich zu früheren Releases von Cognos Analytics.

Snowflake-Verbindungen - geänderter Treiberklassenname

In früheren Releases von Cognos Analytics lautete der standardmäßige Treiberklas-senname für neue Snowflake-Verbindungen com.snowflake.cli-ent.jdbc.SnowflakeDriver. Ab Cognos Analytics Version 11.0.9 lautet der standard-mäßige Treiberklassenname für neue Snowflake-Verbindungen net.snowflake.cli-ent.jdbc.SnowflakeDriver.

Bestehende Verbindungen werden weiterhin die Snowflake-Treiberklassecom.snowflake.client.jdbc.SnowflakeDriver referenzieren. Wenn Snowflake die-sen Klassennamen vom Treiber entfernt, muss für diese Verbindungen die Eigen-schaft Treiberklassenname in net.snowflake.client.jdbc.SnowflakeDriver geän-dert werden.

Tipp: Wählen Sie zum Bearbeiten einer Datenserververbindung Verwalten > Ad-ministrationskonsole aus. Wählen Sie auf der Registerkarte Konfiguration die Op-tion Datenquellenverbindungen aus. Suchen Sie die Datenserververbindung undöffnen Sie sie. Sie können bestehende Verbindungen nicht über Verwalten > Da-tenserververbindungen bearbeiten.

Amazon Redshift-Verbindungen - geänderter Treiberklassename

In früheren Releases von Cognos Analytics lautete der standardmäßige Treiberklas-senname für neue Amazon Redshift-Verbindungencom.amazon.redshift.jdbc41.Driver. Hierfür war die Datei RedshiftJDBC41.*.jarerforderlich.

Ab Cognos Analytics Version 11.0.9 lautet der standardmäßige Treiberklassennamefür neue Amazon Redshift-Verbindungen com.amazon.redshift.jdbc.Driver. Die-ser Treiberklassenname wird von Amazon-JDBC-Treiber Version 1.2.1 oder höherverwendet. Die zugehörige Treiberdatei ist RedshiftJDBC.jar.

Sie können bestehende Verbindungen aktualisieren, indem Sie die Eigenschaft Trei-berklassenname in com.amazon.redshift.jdbc.Driver ändern.

Tipp: Wählen Sie zum Bearbeiten einer Datenserververbindung Verwalten > Ad-ministrationskonsole aus. Wählen Sie auf der Registerkarte Konfiguration die Op-tion Datenquellenverbindungen aus. Suchen Sie die Datenserververbindung undöffnen Sie sie. Sie können bestehende Verbindungen nicht über Verwalten > Da-tenserververbindungen bearbeiten.

PostgreSQL-Verbindungen können mit Amazon Aurora-Post-greSQL verwendet werden

Ab diesem Release können Sie den bereits vorhandenen PostgreSQL-Verbindungs-editor sowie den JDBC-Treiber für die Erstellung und Pflege von Datenserverver-bindungen mit Amazon Aurora-PostgreSQL verwenden.


Cognos Analytics 11.0.8 - neue FeaturesIn IBM Cognos Analytics wurde Unterstützung für die folgenden Datenserver hin-zugefügt: MongoDB Connector for BI 2.2.1, Spark SQL 2.1 Thrift-Server, Azure SQLData Warehouse, Amazon Redshift und Amazon Athena.

MongoDB Connector for BI 2.2.1

Cognos Analytics unterstützt MongoDB Connector for BI Version 2.2.1 durch denJDBC-Treiber für MySQL, der für MongoDB erforderlich ist. MongoDB Connectorfor BI 2.2.1 verwendet nicht den JDBC-Treiber für Postgres oder Servertechnologiefür den Zugriff auf MongoDB 3.x-Server.

MongoDB Connector for BI Version 1 wird nicht mehr unterstützt. AktualisierenSie etwaige Verbindungen von Version 1 in die Verwendung der neuen Version.Aktualisieren Sie außerdem vorhandene Cognos-Modelle, während eine Verbin-dung mit Version 2.2.1 besteht. Auf diese Weise wird sichergestellt, dass die Mo-dellmetadaten Unterschiede in Datentypen und Skalierung widerspiegeln, die inMongoDB Connector for BI 2.2.1 eingeführt wurden.

Spark SQL 2.1 Thrift-Server

Cognos Analytics unterstützt den Spark SQL 2.1 Thrift-Server durch den JDBC-Treiber SIMBA (Magnitude) für Spark SQL.

Azure SQL Data Warehouse

Verbindungen zu Azure SQL Data Warehouse werden unter Verwendung des Mi-crosoft SQL Server-Verbindungseditors verwaltet.

Amazon Redshift

Standardmäßig müssen die Benutzer von Amazon Redshift eine Version der DateiRedshiftJDBC41*.jar in das Cognos Analytics-Verzeichnis Installationsposition\drivers kopieren. Da keine Anforderung zur Verwendung eines 4.0- oder 4.2-Trei-bers besteht, können Sie den standardmäßigen Treiberklassennamen so bearbeiten,dass er den von Amazon unterstützten Treiberklassennamen entspricht. JDBC-Trei-ber für Amazon unterstützen ab Version 1.2.1 den generischen Treiber com.ama-zon.redshift.jdbc. Dieser Treiber kann anstelle der vorherigen Treiberklassenna-men verwendet werden.

Amazon Athena

Cognos Analytics unterstützt Amazon Athena durch den JDBC-Treiber für AmazonAthena. Für eine Verbindung muss eine gültige Amazon S3-Position unter Verwen-dung der Amazon Athena-Verbindungseigenschaft s3_staging_dir angegeben wer-den, von der der Treiber Abfrageergebnisse abruft.

Cognos Analytics 11.0.7 - neue und geänderte FeaturesMemSQL und Presto werden als unterstützte Datenservertypen hinzugefügt undMariaDB beinhaltet einen eigenen Verbindungseditor.

MemSQL

Ab diesem Release werden MemSQL-Datenservertypen unterstützt. Verwenden Siezum Verwalten einer Verbindung für diesen Datenserver den Verbindungstyp


MySQL und den JDBC-Treiber Connector/J.

Presto

Ab diesem Release werden Presto-Datenservertypen (Version 0.167 und höher) un-terstützt. Es können die JDBC-Treiber von Presto und von Teradata Presto verwen-det werden. Verbindungen zu diesem Datenserver werden abhängig vom verwen-deten JDBC-Treiber durch Verwendung des Presto- oder Teradata Presto-Verbindungseditors verwaltet.

Tipp: Die aktuellen Releases von Presto bieten begrenzte Unterstützung für Zei-chentypen mit fester Länge (CHAR). Die Verwendung solcher Typen kann zu fal-schen Ergebnissen führen. Sie können diese Einschränkung umgehen, indem SieAusdrücke erstellen, die Zeichentypen variabler Länge verwenden.

MariaDB

Ab Cognos Analytics 11.0.7, verfügt der MariaDB-Datenserver über einen eigenenVerbindungseditor, der den JDBC-Treiber Connector/J für MariaDB unterstützt.

In früheren Releases wurden Verbindungen zu MariaDB unter Verwendung desVerbindungseditors MySQL und des JDBC-Treibers Connector/J für MySQL defi-niert.

Der MariaDB-Treiber Connector/J gibt Versionsdetails zurück. Hierdurch könnenim dynamischen Abfragemodus die SQL-Erweiterungen verwendet werden, die inMariaDB 10.2.4 eingeführt wurden. Wenn Verbindungen unter Verwendung desJDBC-Treibers für MySQL definiert werden, können diese Features nicht verwendetwerden, und es erfolgt möglicherweise mehr lokale Verarbeitung im dynamischenAbfragemodus.


Kapitel 4. Verwalten von Systemeinstellungen

Sie können Systemeinstellungen konfigurieren, die sich auf alle Benutzer und Kom-ponenten in Ihrer Cognos Analytics-Umgebung auswirken.

Verwalten von DatendateiuploadsSie können steuern, wie Datendateien in IBM Cognos Analytics hochgeladen wer-den.

Vorgehensweise1. Wechseln Sie zu Verwalten > Konfiguration > System und wählen Sie die Re-

gisterkarte Dateiuploads aus.2. Ändern Sie ggf. beliebige der folgenden Einstellungen:v Pfad der Datendateiv Datendateiverschlüsselung (ein oder aus)v Größenbegrenzung pro Uploadv Größenbegrenzung für gespeicherte Daten pro Benutzer

Tipp: Wenn Größenbegrenzungen aktualisiert werden, dauert es einen Mo-ment, bis die Aktualisierung angezeigt wird.

3. Klicken Sie auf OK.

Durchsetzen von HTTP Strict Transport SecuritySie können angeben, dass alle HTTP-Anforderungen, die über Web-Browser vonBenutzern gesendet werden, als HTTPS-Anforderungen weitergeleitet werden. Mitdieser Konfiguration wird HTTP Strict Transport Security (HSTS) durchgesetzt,indem sichergestellt wird, dass alle Verbindungen das SSL-Protokoll (Secure So-ckets Layer) verwenden.


gisterkarte Sicherheit aus.2. Aktivieren Sie die Einstellung HTTP Strict Transport Security (HSTS).3. Klicken Sie auf OK.

Protokollierungstypen und -dateienProtokollnachrichten enthalten Informationen zum Status von Komponenten undwichtigen Ereignissen. Administratoren und Benutzer können diese Nachrichtenzur Fehlerbehebung einsetzen.

IBM Cognos Analytics unterstützt verschiedene Arten der Protokollierung, darun-ter die folgenden Protokollierungstypen: Auditprotokollierung, Protokollierung zuDiagnosezwecken, Protokollierung für Benutzersitzung und Leistungsprotokollie-rung für Berichte.

Standardmäßig sendet der IBM Cognos-Service für jede Installation Informationenan das lokale Verzeichnis installationsposition/logs. Die Auditnachrichten wer-

29

den in der Datei cogaudit.log gespeichert und die Diagnosenachrichten in denDateien cognosserver.log und dataset-service.log. Für Auditprotokolle kann derAdministrator die Position, Größe und die Anzahl der Protokolldateien in IBM Co-gnos Configuration angeben. Für die Protokollierung zu Diagnosezwecken ist dieGröße und Anzahl der Protokolldateien im Teil Verwalten von Cognos Analyticsfestgelegt. Protokolle zu Diagnosezwecken werden immer in das Verzeichnisinstallationsposition/logs geschrieben. Die Auditprotokollierung kann so konfi-guriert werden, dass sie auch in eine Datenbank, einen fernen Protokollserver oderin ein Systemprotokoll schreibt. Weitere Informationen finden Sie in „Protokollie-rung zu Diagnosezwecken”.

Die Sitzungsprotokollierung kann von einzelnen Benutzern für eine einzige CognosAnalytics-Sitzung aktiviert werden, nachdem Administratoren diese Art der Proto-kollierung für das System aktiviert haben. Die Nachrichten werden in den folgen-den Protokolldateien im Verzeichnis installationsposition/logs protokolliert:cognosserver-session-sitzungs-id.log und dataset-service-session-sitzungs-id.log. Weitere Informationen finden Sie in „Sitzungsprotokollierung einrichten”auf Seite 32.

Leistungsprotokollierung für Berichte

Diese Art der Protokollierung wird in IBM Cognos Analytics - Reporting für Ein-zelberichte unterstützt. Ein Berichtsersteller aktiviert die Option für die Protokollie-rung von Leistungsdetails, indem er die Berichtserstellungsoption Leistungsdetailseinbeziehen auswählt. Die folgenden Details können in der Berichtsausgabe ange-zeigt werden: Gesamte Ausführungszeit, Abfrageausführungszeit und Ausgabe-zeit. Kunden können diese Informationen verwenden, um die Leistung selbst zudiagnostizieren oder Probleme zu beheben, bevor sie eine Serviceanforderung ab-setzen.

Weitere Informationen finden Sie in den Abschnitten zum Ausführen von Berichtenund zur Anzeige von Leistungsdetails im IBM Cognos Analytics - Reporting-Hand-buch.

Protokollierung zu DiagnosezweckenDie Protokollierung zu Diagnosezwecken kann von Administratoren so konfigu-riert werden, dass sie zur Behebung von intermittierenden oder Service-spezifi-schen Problemen verwendet werden kann. Dieselbe Protokollierungskonfigurationwird automatisch für alle Server festgelegt.

Die Nachrichten für die Protokollierung zu Diagnosezwecken werden in den Datei-en cognosserver.log und dataset-service.log im Verzeichnisinstallationsposition/logs protokolliert. Die Administratoren können die maxi-male Größe für Protokolldateien und die maximale Anzahl von Protokolldateienangeben, die beibehalten werden müssen, um negative Auswirkungen auf die Leis-tung zu vermeiden.

Diese Art der Protokollierung ist ein Ersatz für die JAVA-IPF-Protokollierung (ipfc-lientconfig.xml) aus früheren Versionen von Cognos Analytics. Cognos Analyticsverarbeitet die Protokollnachrichten aus den Produktservices mithilfe intern defi-nierter Protokollfunktionen. Diese Protokollfunktionen werden in Protokollierungs-themen abstrahiert, die in der Schnittstelle Verwalten aktiviert werden können.

Die Protokollierung zu Diagnosezwecken hat keine Auswirkungen auf die Sit-zungsprotokollierung oder die Auditprotokollierung.


Tipp: Sie können weiterhin 'ipfclientconfig.xml' für native Codekomponenten ver-wenden, wie z. B. Berichtsserver oder Framework Manager. 'ipfclientconfig.xml'kann die Auditprotokollierung beeinträchtigen, weshalb es mit Vorsicht zu verwen-den ist.

Diagnoseprotokollierung konfigurierenAdministratoren können Einschränkungen bezüglich der Größe und Anzahl derProtokolldateien, die für die Protokollierung zu Diagnosezwecken verwendet wer-den, angeben.


gisterkarte Protokollierung zu Diagnosezwecken aus.2. Geben Sie die erforderlichen Werte für die folgenden Einstellungen an:v Größenbeschränkung für Serverprotokolldatei

v Maximale Anzahl von Sicherungsserverprotokolldateien

3. Klicken Sie auf OK.Sie müssen den IBM Cognos-Service nicht erneut starten, um die Protokollie-rung zu Diagnosezwecken zu ändern.

Protokollierung zu Diagnosezwecken für unterschiedliche The-menSie können die Protokollierung zu Diagnosezwecken für eine bestimmte Pro-duktkomponente oder Funktion oder einen bestimmten Service aktivieren, indemSie den Protokollierungsabschnitt ändern.

IBM Cognos Analytics verarbeitet die Protokollnachrichten aus den Produktser-vices mithilfe intern definierter Protokollfunktionen. Diese Protokollfunktionenwerden in Protokollierungsthemen abstrahiert. Das Thema Standardprotokollie-rung, das für die Protokollierung zu Diagnosezwecken festgelegt ist, verwendet ei-nen Satz von Protokollfunktionsnamen, die in bestimmten Fehlerkategorien festge-legt sind. Dies geschieht, damit die Standardprotokollierung nicht zu ausführlichwird und nur die wichtigsten Nachrichten aufzeichnet.

Sie können die Protokollierung zu Diagnosezwecken für ein integriertes Themaoder ein benutzerdefiniertes Thema aktivieren. Um ein benutzerdefiniertes Themazu erstellen, können Sie eine JSON-Spezifikation für ein integriertes Thema herun-terzuladen und es als Basis für die Erstellung Ihres angepassten Abschnitts ver-wenden. Benutzerdefinierte Themen können geändert werden, integrierte Themenhingegen nicht.

Vorgehensweise1. Wechseln Sie zu Verwalten > Konfiguration.2. Wählen Sie die Registerkarte Protokollierung zu Diagnosezwecken aus.3. Wählen Sie eins der integrierten oder benutzerdefinierten Themen aus, für das

Sie die Protokollierung aktivieren möchten.Um beispielsweise die Protokollierung von Authentifizierungsproblemen zu ak-tivieren, wählen Sie das Thema AAA aus.

4. Klicken Sie auf Anwenden.Um die Standardprotokollierung wiederherzustellen, klicken Sie auf Zurück-setzen.Sie müssen den Cognos Analytics-Service nicht erneut starten, wenn Sie denProtokollierungsabschnitt geändert haben.

Kapitel 4. Verwalten von Systemeinstellungen 31

Ergebnisse

Die Protokolle werden jetzt in die Dateien cognosserver.log unddataset-service.log im Verzeichnis installationsposition/logs geschrieben.

Verwenden der Diagnoseprotokollierung zum Beheben von Feh-lern beim Start des Cognos-ServiceProbleme beim Starten des IBM Cognos-Service sind ein Beispiel für eine Situation,in der die Protokollierung zu Diagnosezwecken Ihnen beim Ermitteln der Fehlerur-sache helfen kann.

Wenn der Start des Cognos-Service fehlschlägt, bevor der Dispatcher bereit ist,müssen Sie direkt vor einem erneuten Startversuch des Service die detailliertereProtokollierung zu Diagnosezwecken in Ihrer Installation aktivieren. Standardmä-ßig ist die Protokollebene 'Minimal' aktiviert.

Vorgehensweise1. Öffnen Sie im IBM Cognos Analytics-Verzeichnis Installationsposition/wlp/

usr/servers/cognosserver die Datei bootstrap.properties.2. Fügen Sie in dieser Datei die Systemeigenschaft

com.ibm.bi.logging.glug.hint.isready=false hinzu, um die detaillierte Proto-kollierung zu aktivieren.

3. Starten Sie den Cognos-Service neu (von Cognos Configuration oder von einerBefehlszeile).Beim Start wird die Systemeigenschaftcom.ibm.bi.logging.glug.hint.isready=false vom Protokollierungsservice ge-prüft, bevor weitere Services verfügbar sind. Der Neustart schlägt wieder fehl,dieses Mal enthält die Datei Installationsposition/logs/cognosserver.log al-lerdings detaillierte Protokolle. Beheben Sie anhand dieser Protokolle den Feh-ler.

4. Nach dem Beheben des Problems entfernen Sie die Systemeigenschaftcom.ibm.bi.logging.glug.hint.isready=false aus der Datei bootstrap.proper-ties, um die detaillierte Protokollierung zu inaktivieren. Starten Sie den Cog-nos-Service anschließend erneut. Nach dem Neustart wird die standardmäßigeminimale Protokollierung wiederhergestellt.

Tipp: Wenn die benötigte Zeit zum Starten des Cognos-Service für Sie nichtvon Bedeutung ist und ausreichend Speicherplatz verfügbar ist, können Sie denWert 'false' für diese Eigenschaft belassen. Auf diese Weise bleibt die detaillierteProtokollierung aktiviert, bis die Nachricht über den bereiten Dispatcher ange-zeigt wird.

Sitzungsprotokollierung einrichtenDie Sitzungsprotokollierung wird verwendet, um detaillierte Benutzeraktivitäten injeder Komponente und jedem Service von IBM Cognos Analytics zu protokollieren,die der Anforderung des Benutzers zugeordnet ist.

Der Benutzer muss die Komponenten, Services oder Protokollierungskonfigurati-onsdetails nicht kennen. Es gibt keine Leistungsauswirkungen für andere Benutzer.

Die Sitzungsprotokollierung wird normalerweise dann verwendet, wenn ein Benut-zer ein Problem reproduzieren kann. Sie kann für maximal eine Stunde eingerichtetwerden und jederzeit vom Benutzer gestoppt werden.


Eindeutige Protokolldateien werden für jeden Benutzer generiert, der die Sitzungs-protokollierung aktiviert. Die Dateinamen enthalten eine eindeutige Protokoll-ID,die generiert wird, wenn die Sitzungsprotokollierung vom Benutzer aktiviert wird.

Der Administrator muss die Sitzungsprotokollierung für das System aktivieren.Dann können einzelne Benutzer es selbst aktivieren oder inaktivieren.

Vorgehensweise1. Wählen Sie Verwalten > Konfiguration > System aus.2. Wählen Sie die Registerkarte Protokollierung zu Diagnosezwecken aus.3. Aktivieren Sie die Einstellung Protokollierung für Benutzersitzung aktivieren.

Wenn diese Einstellung aktiviert ist, wird die Option Eigene Sitzung protokol-lieren für alle Benutzer in ihren persönlichen Einstellungen verfügbar.

4. Geben Sie die erforderlichen Werte für die folgenden Einstellungen an:v Größenbeschränkung für Protokolldatei für Benutzersitzungen (pro Benut-

zer)

v Maximale Anzahl von Sicherungsprotokolldateien (pro Benutzersitzung)

5. Klicken Sie auf OK, um die Änderungen zu übernehmen.Sie müssen den IBM Cognos Analytics-Service nicht neu starten.

Nächste Schritte

Benutzer können jetzt die Sitzungsprotokollierung in ihren persönlichen Einstellun-gen aktivieren, indem sie die Option Eigene Sitzung protokollieren auswählenund die Einstellung Sitzungsprotokollierung aktivieren. Benutzer sollten die fürdie Sitzung generierte Protokoll-ID aufzeichnen, bevor sie die Anmeldung inakti-vieren oder den Browser schließen. Der Administrator benötigt diese ID zum Su-chen der Sitzungsprotokolldateien cognosserver-session-protokoll-id.log unddataset-service-session-sitzungs-id.log im Verzeichnis installationsposition/logs.

Aktivieren oder Inaktivieren traditioneller KomponentenSie können die traditionellen Cognos Business Intelligence-Komponenten AnalysisStudio, Event Studio und Query Studio aktivieren oder inaktivieren.

Vorgehensweise1. Starten Sie Cognos Analytics und melden Sie sich als Systemadministrator an.2. Geben Sie im Browser http://CA-Servername:Port/bi/utils/

ConfigSetter.html ein.3. Geben Sie im Feld Name Configuration.LegacyLaunchable ein.4. Klicken Sie auf das Feld Wert.v Wird der Wert 0 zurückgegeben, sind die traditionellen Komponenten nicht

aktiviert.v Wird der Wert 1 zurückgegeben, sind die traditionellen Komponenten akti-

viert.5. Wenn Sie den aktuellen Wert ändern möchten, führen Sie einen der folgenden

Schritte aus:a. Geben Sie 1 im Feld Wert ein, um die traditionellen Komponenten zu akti-

vieren.

Kapitel 4. Verwalten von Systemeinstellungen 33

b. Geben Sie 0 im Feld Wert ein, um die traditionellen Komponenten zu inak-tivieren.

6. Klicken Sie auf Übergeben.

Anmerkung: Die Konfigurationsänderung wird an alle Dispatcher weitergelei-tet.

Ergebnisse

Wenn Cognos Analytics-Benutzer die Option Neu > Andere auswählen, werdendie Komponenten Analysis Studio, Event Studio und Query Studio angezeigt oderausgeblendet, abhängig davon, ob Sie sie aktiviert oder inaktiviert haben.


Kapitel 5. Verwalten von geplanten Aktivitäten

Sie können eine Liste der von Benutzern geplanten Aktivitäten anzeigen, die an ei-nem bestimmten Tag aktuell sind, vergangen sind oder noch bevorstehen.

Sie können die Liste so filtern, dass nur die von Ihnen gewünschten Einträge ange-zeigt werden. Ein Balkendiagramm zeigt Ihnen eine Übersicht der Routineaktivitä-ten nach Stunde. Mithilfe des Diagramms können Sie das optimale Datum zurNeuterminierung von Aktivitäten auswählen. Sie können auch die Ausführungspri-orität für Einträge festlegen. Ferner können Sie den Ausführungsverlauf für Einträ-ge anzeigen, angeben, wie lange die Verlaufsprotokolle aufgehoben werden sollenund fehlgeschlagene Einträge erneut ausführen.

Sie können sehen, wer jeden Eintrag ausgeführt hat und ggf. erforderliche Aktio-nen für Einträge durchführen. So bietet es sich möglicherweise an, einen umfang-reichen Job eines Benutzers abzubrechen oder auszusetzen, wenn dieser zum Bei-spiel wichtige Einträge in der Warteschlange aufhält. Sie können auch die Prioritäteiner Eintragsinstanz überschreiben oder permanent für den Eintrag selbst ändern.

Wenn Sie zu anderen Ansichten wechseln, müssen Sie diese aktualisieren, damitdie aktuellen Daten angezeigt werden. Wenn Sie zum Beispiel von Vergangene Ak-tivitäten zu Bevorstehende Aktivitäten wechseln, müssen Sie die Ansicht aktuali-sieren, damit Sie die aktuellen Daten in den Fenstern sehen.

Administratoren können die Verwaltungsfunktion über Verwalten > Aktivitätenoder IBM Cognos Administration verwenden, um Aktivitäten für alle Benutzer-einträge zu verwalten.

Verwalten von aktuellen AktivitätenAktuelle Aktivitäten sind Aktivitäten, die derzeit in der IBM Cognos-Software ver-arbeitet werden.

Jeder Eintrag wird nach Name aufgelistet und zeigt die Anforderungszeit, den Sta-tus und die Priorität für Hintergrundaktivitäten an. Das Balkendiagramm zeigt dieGesamtzahl der Einträge aufgeteilt nach der Anzahl anstehender, ausgeführter,wartender und ausgesetzter Einträge. Während der Verarbeitung der Aktivität wirddie Prozessnummer angezeigt.

Sie können die Spalten Anforderungszeit, Status und Priorität sortieren. AufWunsch können Sie auch eine Liste der Hintergrund- oder der interaktiven Aktivi-täten anzeigen.

Sie können die Einträge filtern, sodass nur die von Ihnen gewünschten Einträgeangezeigt werden. Sie können auswählen, dass nur diejenigen Einträge mit einembestimmten Status oder einer bestimmten Priorität oder Einträge eines bestimmtenTyps oder Bereichs angezeigt werden sollen.

Bei interaktiven, aktuellen Einträgen können Sie nach dem Status und dem Dispat-cher filtern, in dem die Aktivität derzeit ausgeführt wird. Bei aktuellen Einträgenim Hintergrund können Sie nach Folgendem filtern: Status, Priorität, Typ, Bereich,Benutzer, der den Eintrag ausgeführt hat, und nach dem Besitzer des Eintrags.

35

Während ein Eintrag ausgeführt wird, werden Dispatcher, Prozess-ID und Startzeitangezeigt. Beachten Sie, dass Prozess-ID und Dispatcher von derzeit im Hinter-grund ausgeführten Einträgen möglicherweise nicht verfügbar sind, wenn die Akti-vität erstmalig angezeigt wird. Aktualisieren Sie die Seite, um die aktualisiertenWerte für Prozess-ID und Dispatcher anzuzeigen.

Wenn Sie einen Eintrag abbrechen, der weitere Einträge wie einen Job oder einenAgenten enthält, werden bisher noch nicht abgeschlossene Schritte oder Aufgabenabgebrochen. Bereits abgeschlossene Schritte oder Aufgaben bleiben jedoch abge-schlossen.

Sie können die Priorität von Einträgen ändern und den Ausführungsverlauf anzei-gen.

Vorgehensweise1. Klicken Sie in Verwalten auf Aktivitäten.

2. Klicken Sie auf das Typsymbol

und dann auf Aktuell.3. Geben Sie im Abschnitt Filter die Filteroptionen an, die Sie verwenden möch-

ten.

Tipp: Wenn Sie erweiterte Filteroptionen verwenden möchten, klicken Sie aufErweiterte Optionen.

4. Klicken Sie auf Anwenden.In der Liste werden die von Ihnen ausgewählten Einträge angezeigt.

Verwalten von vergangenen AktivitätenVergangene Aktivitäten sind Einträge, deren Verarbeitung in der IBM Cognos-Soft-ware abgeschlossen ist.

Jeder Eintrag wird nach Name aufgelistet und zeigt die Anforderungszeit und denStatus an. Sie können die Spalten Anforderungszeit und Status sortieren. Das Bal-kendiagramm zeigt die Gesamtzahl der Einträge aufgeteilt nach Status. Wenn einEintrag fehlgeschlagen ist, wird eine Schaltfläche mit dem Schweregrad des Fehlersangezeigt. Außerdem wird der Benutzer aufgelistet, der den Eintrag ausgeführthat.

Sie können die Einträge filtern, sodass nur die von Ihnen gewünschten Einträgeangezeigt werden. Sie können eine Liste aller Aktivitäten anzeigen, die über einenbestimmten Zeitraum aufgetreten sind, zum Beispiel in den letzten vier Stundenoder während des letzten Tages, oder Sie können ein bestimmtes Datum oder ei-nen bestimmten Zeitraum angeben. Sie haben die Möglichkeit, nach Status, Typoder Bereich zu filtern. Außerdem können Sie nach dem Benutzer filtern, der denEintrag ausgeführt hat, nach dem Besitzer des Eintrags und nach dem Dispatcher,in dem die Aktivität ausgeführt wurde.

Sie können den Ausführungsverlauf anzeigen.



und dann auf Vergangen.3. Halten Sie auf der Fehlerschaltfläche neben dem Status an, um den Schwere-

grad des Fehlers anzuzeigen.


Verwalten bevorstehender Aktivitäten für einen bestimmten TagAuf Wunsch können Sie eine Liste aller bevorstehenden Aktivitäten anzeigen, diefür einen bestimmten Tag geplant sind.

Jeder Eintrag wird nach Name aufgelistet und zeigt die Anforderungszeit und diePriorität an. Ein Balkendiagramm zeigt die Gesamtzahl der geplanten und abge-brochenen Einträge für jede Stunde des Tages. Die Diagrammlegende zeigt die Ge-samtzahl der geplanten und abgebrochenen Einträge für den Tag.

Sie können die Spalten Anforderungszeit, Status und Priorität sortieren. AufWunsch können Sie auch eine Liste der Hintergrund- oder der interaktiven Aktivi-täten anzeigen.

Jeder Eintrag zeigt den Benutzer, der ihn geplant hat. Sie können nach Benutzersortieren.

Sie können die Einträge filtern, sodass nur die von Ihnen gewünschten Einträgeangezeigt werden. Sie können das Datum und die Zeit auswählen, für das/die Siebevorstehende Aktivitäten anzeigen möchten. Sie haben die Möglichkeit, nachStatus, Priorität, Typ oder Bereich zu filtern.

Außerdem können Sie nach dem Benutzer filtern, der den Eintrag geplant hat, undnach dem Besitzer des Eintrags.

Sie können die Priorität eines Eintrags in der Warteschlange ändern.



und dann auf Bevorstehend.3. Klicken Sie im Abschnitt Filter auf die Filteroptionen, die Sie verwenden möch-

ten.

Tipp: Wenn Sie erweiterte Filteroptionen verwenden möchten, klicken Sie aufErweiterte Optionen. Klicken Sie auf Auf Standard zurücksetzen, um alle Op-tionen auf die Standardeinstellungen zurückzusetzen.

4. Klicken Sie auf Anwenden.v In der Liste werden die von Ihnen ausgewählten Einträge angezeigt.v Die Filterstatuszeile zeigt die Kriterien, die zum Generieren der Liste ver-

wendet wurden.v Das Balkendiagramm zeigt die geplanten und abgebrochenen Einträge nach

Stunde für den angegebenen Tag.Die Liste der Einträge, die Filterstatuszeile und das Diagramm werden aktuali-siert, sobald Sie den Filter neu definieren und auf Anwenden klicken. Die Listeder Einträge und die Filterstatuszeile ändern sich nicht, wenn Sie das Dia-gramm nach einem anderen Datum durchsuchen.

Verwalten von geplanten AktivitätenSie können eine Liste der geplanten Einträge für alle Benutzer anzeigen.

Kapitel 5. Verwalten von geplanten Aktivitäten 37

Jeder Eintrag wird nach Name, Status und Priorität aufgelistet. Ein Balkendia-gramm zeigt Ihnen eine Übersicht der Aktivitäten aufgeteilt nach aktivierten undinaktivierten Zeitplänen.

Zudem werden Datum und Uhrzeit der Zeitplanänderung und der Benutzer, derden Eintrag geplant hat, aufgelistet.

Sie können die Einträge filtern, sodass nur die von Ihnen gewünschten Einträgeangezeigt werden. Sie können auswählen, dass nur die Einträge mit einem be-stimmten Status oder einer bestimmten Priorität oder Einträge eines bestimmtenTyps oder Bereichs angezeigt werden sollen. Außerdem können Sie nach dem Be-nutzer filtern, der den Eintrag geplant hat, oder nach dem Besitzer des Eintrags.

Sie können Eigenschaften festlegen, den Zeitplan einmal ausführen, geplante Ein-träge inaktivieren und aktivieren, den Zeitplan ändern, den Zeitplan entfernen, diePriorität festlegen und den Ausführungsverlauf anzeigen. Je nach Eintrag könnenSie möglicherweise auch noch andere Funktionen ausführen, wie das Anzeigen vonAusgaben oder Ereignislisten.



und dann auf Zeitplan.3. Klicken Sie im Abschnitt Filter auf die Filteroptionen, die Sie verwenden möch-

ten.

Tipp: Wenn Sie erweiterte Filteroptionen verwenden möchten, klicken Sie aufErweiterte Optionen.

4. Klicken Sie auf Anwenden.In der Liste werden die von Ihnen ausgewählten Einträge angezeigt.

5. Klicken Sie zum Ausführen einer Aktion für einen einzelnen Eintrag auf Mehr (

) neben dem Eintrag und wählen Sie die Aktion aus.Die folgende Tabelle enthält die für Einträge verfügbaren Aktionen und die zu-gehörigen Symbole:

Tabelle 2. Aktionen und Symbole für geplante Aktivitäten

Aktion Symbol

Eigenschaften

Diesen Zeitplan ändern

Versionen anzeigen

Diesen Zeitplan inaktivieren

Diesen Zeitplan entfernen

Priorität festlegen

Eigene Berechtigungsnachweise verwenden

Tipp: Wählen Sie zum Auswählen aller Einträge in der Liste das Kontrollkäst-chen für die Liste aus.


Verwalten der Ausführungspriorität für EinträgeSie können geplanten Einträgen eine Priorität von 1 bis 5 zuordnen.

Ein Eintrag mit der Priorität 1 wird zum Beispiel vor einem Eintrag mit der Priori-tät 5 ausgeführt. Wenn mehrere Einträge mit derselben Priorität vorliegen, wirdderjenige, der zuerst in die Warteschlange eingereiht wurde, auch zuerst ausge-führt. Die Standardpriorität ist 3.

Interaktive Einträge werden immer sofort ausgeführt und die Priorität kann nichtmehr geändert werden, sobald sie ausgeführt werden.

Sie legen die Priorität für einen Eintrag fest, wenn Sie ihn planen. Wenn sich einEintrag in der Warteschlange für aktuelle, bevorstehende oder geplante Einträgebefindet, können Sie die Priorität ändern.

Für Einträge, die lange Zeit zur Ausführung benötigen, empfiehlt sich eine niedri-ge Priorität, sodass es für andere Einträge in der Warteschlange nicht zu Verzöge-rungen kommt.

Wenn Sie einen Job planen, legen Sie die Priorität für den gesamten Job fest undnicht für einzelne Einträge im Job. Für einen Job mit vielen Einträgen empfiehltsich eine niedrige Priorität, sodass es für andere Einträge in der Warteschlangenicht zu Verzögerungen kommt.

Sie planen die Priorität für den übergeordneten Job. Wenn der Job ausgeführt wird,übernehmen alle untergeordneten Einträge die Priorität des übergeordneten Jobs.Solange sich der Job in einer Warteschlange befindet und noch nicht ausgeführtwird, können Sie die Priorität aktualisieren. Für die einzelnen Einträge im Job istdies nicht möglich. Durch das Ändern der Priorität für den Job wird auch die Prio-rität aller untergeordneten Einträge im Job geändert. Sie können den Ausführungs-verlauf während der Ausführung anzeigen und so erkennen, welche der Einträgebereits beendet sind, welche gerade ausgeführt werden und welche noch anstehen.

Die Priorität der Einträge in der Warteschlange wirkt sich nicht auf einen Eintragaus, der bereits ausgeführt wird. Der Eintrag wird abgeschlossen und dann wirddie Warteschlangenpriorität für den nächsten auszuführenden Eintrag geprüft.


Sie müssen über die Funktion Aktivitäten und Zeitpläne ausführen verfügen, umdie Ausführungspriorität für Einträge verwalten zu können.



und dann auf Zeitplan.

3. Klicken Sie zum Ändern der Priorität für einen Eintrag auf Mehr ( ) nebendem Eintrag und wählen Sie Priorität festlegen aus.

4. Klicken Sie im Menü auf die gewünschte Priorität und dann auf OK.

Ergebnisse

Die neue Priorität wird in der Spalte Priorität neben den ausgewählten Einträgenangezeigt.

Kapitel 5. Verwalten von geplanten Aktivitäten 39

Kapitel 6. Verwalten von Lizenzen

Systemadministratoren müssen die IBM Cognos Analytics-Lizenznutzung überwa-chen.

In den Lizenzinformationen in IBM Cognos Analytics werden die Lizenzen ange-zeigt, die von einzelnen Benutzern bei ihrer letzten Anmeldung verwendet wur-den. Geänderte Funktionen von Benutzern werden in deren Lizenznutzung nichtberücksichtigt, bis die Benutzer sich erneut anmelden. Für bestehende Benutzersind die Informationen zur Lizenznutzung außerdem unvollständig, bis alle Benut-zer sich erneut anmelden.

Ein Bericht zur Lizenznutzung wird erstellt, wenn die Lizenzseite unter Verwalten> Lizenzen zum ersten Mal geöffnet, die Schaltfläche Aktualisieren angeklicktoder das Produkt neu gestartet wird.

Der grundlegende Bericht enthält Informationen zur Lizenznutzung nach Benut-zern. Einige Kunden möchten möglicherweise zusätzliche Berichtsfunktionen nut-zen, zum Beispiel für Informationen zur Lizenznutzung nach Tenants.

IBM Cognos Analytics verfügt über verschiedene Typen von lizenzierten Rollen,wobei jeder Typ anderen Funktionen zugeordnet ist. Beachten Sie diesen Artikel(www.ibm.com/support/docview.wss?uid=swg21684890), um die Matrix der Funk-tionen und Berechtigungen anzuzeigen, auf der das IBM Cognos Analytics-Lizen-zierungsmodell basiert.

Die Lizenznutzung kann in einer Produktions- und Nicht-Produktionsumgebungüberwacht werden. Weitere Informationen zu diesen zwei Umgebungstypen findenSie in Kapitel 9, „Aktivieren einer Produktionsumgebung”, auf Seite 103.

Vorgehensweise1. Klicken Sie auf Verwalten > Lizenzen, um auf die Lizenzseite in IBM Cognos

Analytics zuzugreifen.2. Klicken Sie auf das Feld Eigene für die lizenzierte Rolle, um die Anzahl eigener

Lizenzen einzugeben. Geben Sie die Anzahl ein und klicken Sie anschließendauf Anwenden, um den Wert zu speichern.Dieser Wert wird nur zu Informationszwecken verwendet und nicht in den Be-richt zur Lizenznutzung einbezogen.

3. Klicken Sie auf Aktualisieren, um den Bericht zur Lizenznutzung zu erstellen.Sie können den Bericht beliebig oft erstellen.

4. Klicken Sie auf das Symbol zum Anzeigen von Details , um die Lizenzinfor-mationen für eine bestimmte Rolle anzuzeigen.Bei diesen Informationen handelt es sich um eine Teilmenge der Informationenaus dem Gesamtbericht.

5. Wenn Sie den Gesamtbericht anzeigen möchten, klicken Sie auf Exportieren,um die Informationen in einer CSV-Datei zu speichern, und öffnen Sie anschlie-ßend die Datei.

Tipp: Die Werte in der Spalte Ebene der exportierten Datei entsprechen be-stimmten Lizenzrollen wie folgt:

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

Ebene Lizenzrolle

3 Analytics-Administrator2 Analytics-Explorer1 Analytics-Benutzer0 Informationsverteilung-1 Die Lizenzrolle ist unbekannt, da sich der

Benutzer noch nicht angemeldet hat.

Nächste Schritte

Weitere Informationen enthalten die folgenden Abschnitte:v Predefined license rolesv Assigning capabilities based on license rolesv Upgrade scenario: If your customized roles have the same names as the new li-

cense roles

LizenzrollenAls Hilfe beim Abgleichen von Funktionen mit Lizenzvoraussetzungen stellt Cog-nos Analytics auch vordefinierte Rollen bereit, die auf Lizenzberechtigungen basie-ren.

In der folgenden Tabelle sind die vordefinierten Lizenzrollen aufgeführt.

Tabelle 3. Vordefinierte Cognos-Lizenzrollen

Lizenzrolle Beschreibung

Analytics-Administratoren Mitglieder besitzen dieselben Zugriffsberechtigungen wieAnalytics-Explorer. Darüber hinaus besteht Zugriff auf dasIBM Software Development Kit.

Analytics-Explorer Mitglieder besitzen dieselben Zugriffsberechtigungen wieAnalytics-Benutzer. Darüber hinaus besteht Zugriff aufPlanning Analytics for Microsoft Excel, Cognos FrameworkManager, Cognos Cube Designer und Dynamic QueryAnalyzer sowie Transformer.

Analytics-Benutzer Mitglieder können neue Berichte, Dashboards, Storys, neueJobs, Datenserververbindungen, Datenquellenverbindungenoder Datenmodule erstellen. Sie können Berichte ausführen,auf Eingabeaufforderungen antworten und Dateienhochladen. Sie verfügen darüber hinaus über Zugriff aufCognos for Microsoft Office, Cognos Workspace, CognosEvent Studio, Cognos Query Studio und Cognos AnalysisStudio.

Informationsverteilungsbenut-zer

Mitglieder können öffentlichen Inhalt, wie z. B. Berichte,lesen. Öffentlichen Inhalt können Mitglieder jedoch nichtausführen.

Standardberechtigungen auf der Basis von LizenzenIn IBM Cognos Analytics basiert die Anzahl der Lizenzen in Verwalten > Lizenzenauf den Funktionen, die einem Benutzer, einer Gruppe oder einer Rolle erteilt wer-den.


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

Anmerkung: Wenn Änderungen an den Standardberechtigungen vorgenommenwerden, kann ein Benutzer in eine Lizenzstufe verschoben werden, die höher istals die standardmäßig erteilte.

In der folgenden Tabelle sind die Funktionen zugeordnet, die für die jeweiligen Li-zenzen erteilt werden. Die Funktionen sind in geschützte Features unterteilt. DerBuchstabe X gibt an, dass eine Berechtigung für ein bestimmtes geschütztes Featureerteilt wird.

Tabelle 4. Cognos Analytics 11 - Funktionen unterteilt nach Lizenzrollen

FunktionGeschütz-tes Feature

Informations-verteilung

Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

AdaptiveAnalytics

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Verwaltung X X X

AdaptiveAnalytics-Verwaltung

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Verwaltungs-aufgaben

X

Systemkonfigurie-ren undverwalten

X

Controller-Verwaltung

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

SeparateBerechti-gung für

IBMConnectionserforderlich

Datenquellen-verbindun-gen

X X X

Verteilerlistenund Kon-takte

X

Metric Stu-dio-Verwal-tung

X

Mobile-Verwaltung

X

Planning-Verwaltung

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend


IBMPlanning

Contributorerforderlich

Kapitel 6. Verwalten von Lizenzen 43

Tabelle 4. Cognos Analytics 11 - Funktionen unterteilt nach Lizenzrollen (Forts.)



Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

PowerPlay-Server

X X X SeparateLizenz fürPowerPlayerforderlich

Drucker X

Abfrageservice- Verwal-tung

X

AktivitätenundZeitpläneausführen

X

FunktionenfestlegenundBenutzerscnitt-stellenprofi-leverwalten

X

Stile undPortlets

X

Benutzer,Gruppenund Rollen

X

AnalysisStudio

X X X

CognosInsight

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

CognosViewer

X X X X

Kontextmenü X X X X

Mit Optio-nen aus-führen

X X X

Auswahl X X X X

Symbolleis-te

X X X X

Zusam-menarbeiten

X X X SeparateBerechti-gung für






Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

Featuresfür die Zu-sammenarbeitzulassen



Tools fürdie Zusam-menarbeitstarten



ControllerStudio

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend



Dashboard X X X

Data Ma-nager

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Desktop-Tools

X X

Datasets X X X X

DetaillierteFehler

X X X X Wenn einAdminist-rator dieseBerechti-gung er-

teilt, kannder Benut-zer detail-

lierteFehlernachrich-

ten inCognos

Viewer undReport Stu-dio anzei-

gen.





Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

Drillthrough-Assistent

X X X Wenn einAdminist-rator dieseBerechti-gung er-

teilt, kannder Benut-

zer überdie Seite'Gehe zu'

mithilfe desDrillthrough-

Assistentenanzeigen,

welche Pa-rametervon derQuelle

übergebenwurden

und wie sieim

Zielobjektzugeordnet

sind.

Event Stu-dio

X X X

Indexsucheausführen

X X X X

ExecutiveDashboard

X X X

ErweiterteDashboard-Featuresverwenden

X X X

InteraktiveDashboard-Featuresverwenden

X X X





Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

ExternaeRepositorys

X X X X Der Admi-nistratormuss dieBerechti-gungen

festlegen,damit derBenutzerauf archi-vierte Da-

teienzugreifen

kann.

Repository-Verbindun-genverwalten

X

ExterneDokumenteanzeigen

X X X X

CSV-Aus-gabe gene-rieren

X X X X

PDF-Aus-gabe gene-rieren

X X X X

XLS-Aus-gabe gene-rieren

X X X X

XML-Aus-gabe gene-rieren

X X X X

Glossar X X X X Integrationmit IBM

InfoSphereBusinessGlossary.DirekteVerwen-

dung überCognosViewer

möglich.

Einträgeausblenden

X X X X

RelationaleMetadatenimportieren

X





Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

Herkunft X X X X Wenn dieseBerechti-

gung erteiltwird, ver-fügt derBenutzerüber Zu-griff vonCognos

Viewer aus.

Inhalt ver-walten

X

EigeneDatenquellenan-meldungenverwalten

X X X

Metric Stu-dio

X X

Ansichtbearbeiten

X X

Mobile X X X X

PlanningContributor

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend

Nicht zu-treffend


IBMPlanning

Contributorerforderlich

PowerPlayStudio

X X X SeparateLizenz fürPowerPlayerforderlich

Query Stu-dio

X X X

Erweitert X X X

Erstellen X X X

Report Stu-dio

X X X

ExterneDaten zu-lassen

X

Zielgruppen-verteilung

X X X

Erstellen/Löschen

X X X





Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

HTML-Elementeim Bericht

X X X

Benutzerde-finiertesSQL

X X X

Zeitplanung X X X

Zeitplannach Tagen

X X X

Zeitplannach Stun-den

X X X

Zeitplannach Minu-ten

X X X

Zeitplannach Mo-naten

X X X

Zeitplandurch Aus-löser

X X X

Zeitplannach Wo-chen

X X X

Zeitplannach Jah-ren

X X X

Zeitplannach Prio-rität

X

Self ServicePackage-Assistent

X

Eingabespe-zifischeFunktionenfestlegen

X

Moment-aufnahmen

X X X X

Spezifikations-ausführung

X

Dateienhochladen

X X X

Überwachungs-regeln

X X X





Analytics-Benutzer

Analytics-Explorer

Analytics-Administ-

ratorKommen-

tare

WebbasierteModellie-rung

X X X

Zuweisen von Funktionen auf der Basis von LizenzrollenFunktionen können auf der Basis von Lizenzrollenberechtigungen zugewiesen wer-den.v Wenn Sie die bei der Installation automatisch eingerichteten, vordefinierten Rol-

len verwenden möchten, führen Sie die im Dokument How do you restrict usersbased on their License Roles in Cognos Analytics (version 11.0.7 +) beschriebe-nen Schritte aus.

v Wenn Sie diese Rollen manuell einrichten möchten, führen Sie die Schritte aus,die im Dokument How do you restrict users based on their License Roles in Co-gnos Analytics (versions 11.0.0 to 11.0.6) beschrieben sind.

Upgradeszenario: Wenn die Namen der angepassten Rollen identischmit den Namen der neueren Cognos-Lizenzrollen sind

Wenn Sie zuvor Rollen erstellt haben, deren Namen mit den Namen der neuerenCognos-Lizenzrollen identisch sind, und die Durchführung eines Upgrades planen,legen Sie fest, welche Funktionen den Rollen nach dem Upgrade zugewiesen wer-den sollen.

Weitere Informationen finden Sie in „Lizenzrollen” auf Seite 42v Wenn Sie weiterhin die Funktionen verwenden möchten, die Sie zuvor den Rol-

len zugeordnet haben, können Sie das Upgrade durchführen, ohne diese Funkti-onen zu verlieren.

v Wenn Sie jedoch die Funktionen der neuen Lizenzrollen übernehmen möchten,müssen Sie Ihre vorhandenen Rollen zuerst löschen oder umbenennen, bevorSie das Upgrade durchführen.


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




Kapitel 7. Tenantverwaltung

Tenantverwaltungsaufgaben werden von Systemadministratoren und beauftragtenTenantadministratoren ausgeführt.

Systemadministratoren müssen Mitglieder der Rolle Systemadministratoren imCognos-Namespace sein. Systemadministratoren können alle Objekte im ContentStore anzeigen und ändern. Sie können außerdem Tenantverwaltungsaufgaben anandere Administratoren delegieren, die Mitglieder der Rolle Tenantadministrato-ren im Cognos-Namespace sind.

Mitglieder der Rolle Systemadministratoren können die folgenden Aufgaben in ei-ner IBM Cognos Analytics-Multi-Tenant-Umgebung ausführen:v Erstellen, Ändern und Löschen von Tenantobjekten.v Ändern der Tenanteigenschaften für ein beliebiges Objekt im Content Store.v Verschieben von Tenants.v Beenden von Sitzungen für Tenants.

Das Zentrum der Tenantverwaltung bildet die Registerkarte Multi-Tenant-Funktio-nalität in Verwalten. Auf dieser Registerkarte kann der Administrator alle Tenantsanzeigen und verwalten, die in der aktuellen Umgebung von Cognos Analytics re-gistriert sind. Nur Mitglieder der Rolle Systemadministratoren haben Zugriff aufdie Registerkarte Multi-Tenant-Funktionalität.

Tipp: Die Registerkarte Multi-Tenant-Funktionalität in IBM Cognos Administrati-on kann auch für die Tenantverwaltung verwendet werden.

Einschlussregeln für die Multi-Tenant-FunktionalitätIn einem Content Store können mehrere Tenants gleichzeitig vorhanden sein. Mitden Einschlussregeln für Tenants werden die Sicherheit und Isolation zwischen deneinzelnen Tenants sichergestellt. Diese Regeln legen fest, wie Inhalte erstellt werdenund wo sie sich befinden dürfen.

Jedes Objekt im Content Store verfügt über einen Wert für die Tenant-ID, der an-gibt, zu welchem Tenant das Objekt gehört. Informationen zum Erstellen von Te-nant-IDs finden Sie in „Erstellen von Tenants” auf Seite 52.

Die Tenant-ID eines Objekts muss der Tenant-ID des jeweils übergeordneten Ob-jekts entsprechen, es sei denn, die übergeordnete Tentant-ID ist öffentlich zugäng-lich. Ist dies der Fall, kann die Tenant-ID des untergeordneten Objekts in einen be-liebigen Wert geändert werden. Weitere Informationen finden Sie in „Festlegeneiner Tenant-ID für ein öffentliches Objekt” auf Seite 53.

Wenn der aktuell angemeldete Benutzer ein Objekt erstellt, entspricht die Tenant-ID des Objekts der Tenant-ID des Benutzers.

Objekte des Typs 'model' und 'modelView' erben ihre Tenant-ID vom Package. Bei-spielsweise sind Modelle, die in einem öffentlichen Package publiziert werden,immer öffentlich.

51

Erstellen von TenantsBevor die Tenantbenutzer auf IBM Cognos Analytics zugreifen können, müssenSystemadministratoren das Tenantobjekt erstellen und aktivieren.


Die Multi-Tenant-Funktionalität muss bereits in IBM Cognos Configuration akti-viert sein.


Der Systemadministrator erstellt das Tenantobjekt in der Verwaltungsschnittstelle(Verwalten) von Cognos Analytics auf der Registerkarte Multi-Tenant-Funktionali-tät und ordnet dem Objekt eine eindeutige Tenant-ID zu.

Die Tenant-IDs werden im Authentifizierungsprovider, wie LDAP, Active Directoryoder einem benutzerdefinierten Authentifizierungsprovider, definiert. Weitere Infor-mationen finden Sie in Konfigurieren der Multi-Tenant-Funktionalität.

Vorgehensweise1. Wählen Sie in Verwalten die Registerkarte Multi-Tenant-Funktionalität aus.

2. Wählen Sie das Symbol Tenant hinzufügen aus.3. Geben Sie die Parameter Name und Tenant-ID an.

Stellen Sie sicher, dass Sie eine gültige Tenant-ID angeben, die im Authentifizie-rungsprovider vorkonfiguriert wurde.Die anderen Parameter auf dieser Seite sind optional.

4. Wählen Sie Hinzufügen aus.

Ergebnisse

Der Name des Tenants wird auf der Registerkarte Multi-Tenant-Funktionalität an-

gezeigt. Der Tenant ist standardmäßig inaktiviert . Nachdem er vollständigkonfiguriert ist, können Sie den Tenant aktivieren.

Zuordnen von Tenant-IDs zu vorhandenem InhaltNachdem die Multi-Tenant-Funktionalität aktiviert wurde, weist der Systemadmi-nistrator den vorhandenen Content Store-Objekten Tenant-IDs zu. Alle Objekte, dieeinem Tenant angehören, weisen dieselbe Tenant-ID auf.

Wenn ein Benutzer aus einem bestimmten Tenant sich bei IBM Cognos Analyticsanmeldet, sieht sich das System die Tenant-ID an und filtert den Inhalt.

Für die Erstellung von Tenants und die Zuweisung von Tenant-IDs kann das Soft-ware-Development-Kit (SDK) verwendet werden.


In einer Umgebung mit mehreren Tenants sind alle Objekte im Content Store ent-weder öffentlich oder gehören zu einem einzelnen Tenant. Als Systemadministratormüssen Sie sicherstellen, dass vorhandene Objekte über eine richtige Tenant-ID


verfügen oder öffentlich sein sollen. Beispielsweise können Sie Tenant-IDs Inhaltenin einem Ordner zuweisen, jedoch den Ordner an sich öffentlich belassen.

Sie können auch Tenant-IDs für einzelne Objekte zuweisen, z. B. für Berichte,Dashboards, Datenserververbindungen, Benutzergruppen und Rollen usw.

Vorgehensweise1. Melden Sie sich bei IBM Cognos Analytics als Systemadministrator an.2. Suchen Sie in Teaminhalt nach Containereinträgen, wie Ordner oder Packages,

deren Nachkommen derselben Tenant-ID zugewiesen werden sollten.Beim Zuweisen von Tenant-IDs für Objekte wie Datenserververbindungen,Gruppen oder Rollen, suchen Sie die Objekte im entsprechenden Bereich in derVerwaltungsschnittstelle.

3. Öffnen Sie das Fenster Eigenschaften für das Objekt, für das Sie die Tenant-IDzuweisen möchten.

4. Klicken Sie auf der Registerkarte Allgemein im Abschnitt Erweitert auf denLink neben Tenant.

5. Wählen Sie eine Tenant-ID aus der Liste der verfügbaren IDs aus und klickenSie auf Anwenden.

Ergebnisse

Die Tenant-ID wird auf den Eintrag angewendet. Handelt es sich bei dem Eintragum einen Container, wie ein Ordner oder Package, wird die Tenant-ID auf den Ein-trag und seine Nachkommen angewendet.

Der Name des Tenants wird auf der Seite der Objekteigenschaften auf der Register-karte Allgemein im Abschnitt Erweitert angezeigt.

Festlegen einer Tenant-ID für ein öffentliches ObjektSie können eine Tenant-ID für Objekte zuweisen, deren übergeordnetes Objekt öf-fentlich ist.

Vorgehensweise1. Öffnen Sie das Fenster Eigenschaften für das Objekt, beispielsweise eine Daten-

serverbindung, für das Sie die Tenant-ID festlegen möchten.2. Klicken Sie auf der Registerkarte Allgemein im Abschnitt Erweitert auf den

Link neben Tenant.3. Wählen Sie eine Tenant-ID aus der Liste der verfügbaren IDs aus.4. Klicken Sie auf Anwenden.

Delegierte TenantverwaltungSystemadministratoren können Verwaltungsaufgaben für Tenants an Mitglieder derRolle Tenantadministratoren delegieren.

Wenn die Eigenschaft Einschließender Satz für Tenant - Zuordnung konfiguriertist, haben Tenantadministratoren nur Zugriff auf Tenants, die im einschließendenSatz definiert sind. Sie unterliegen ferner den Cognos Analytics-Sicherheitsrichtlini-en, die Systemadministratoren für die Inhalte festlegen. In diesem Fall werdenTenantadministratoren als Tenantadministratoren mit Einschließung bezeichnet.

Kapitel 7. Tenantverwaltung 53

Ist die Eigenschaft Einschließender Satz für Tenant - Zuordnung nicht konfigu-riert, umgehen Tenantadministratoren die Tenantprüfung und unterliegen nur denCognos Analytics-Sicherheitsrichtlinien, die Systemadministratoren für die Inhaltefestlegen. In diesem Fall werden Tenantadministratoren als Tenantadministratorenohne Einschließung bezeichnet.

Weitere Informationen zur Eigenschaft Einschließender Satz für Tenant - Zuord-nung finden Sie in den Abschnitten zur erweiterten Muli-Tenant-Funktionalität inder Veröffentlichung IBM Cognos Analytics - Verwaltung und Sicherheit.

Tenantadministratoren können die Tenantverwaltungsaufgaben ausführen, die ih-nen der Systemadministrator zuweist.

Tenantadministratoren können die folgenden Aufgaben nicht ausführen:v Zugreifen auf die Registerkarte Multi-Tenant-Funktionalität in Verwalten und

in IBM Cognos Administration.v Erstellen, Löschen, Bereitstellen und Inaktivieren von Tenants.v Beenden von Benutzersitzungen und Anpassen von Tenants.v Ändern der Tenantzugehörigkeit für Objekte im Content Store.

Tipp: Die Rolle Tenantadministratoren ist einer der integrierten Einträge im Cog-nos-Namespace.

Weitere Informationen zu der Rolle Systemadministratoren in einer Multi-Tenant-Umgebung finden Sie in Kapitel 7, „Tenantverwaltung”, auf Seite 51.

Einrichten der Rolle 'Tenantadministratoren'Im ursprünglichen Content Store hat die Rolle Tenantadministratoren keine Mit-glieder und nur die Systemadministratoren verfügen über Zugriffsberechtigungenfür diese Rolle. Systemadministratoren müssen Mitglieder hinzufügen und die ur-sprünglichen Zugriffsberechtigungen für diese Rolle ändern, damit sie für die dele-gierte Tenantverwaltung verwendet werden können.


Wenn Sie Mitglieder zu der Rolle Tenantadministratoren hinzufügen, wählen Siedie Benutzer, Gruppen oder Rollen aus den entsprechenden Tenants aus.

Vorgehensweise

Gehen Sie folgendermaßen vor, um Mitglieder zur Rolle Tenantadministratorenhinzuzufügen oder aus ihr zu entfernen.1. Melden Sie sich bei IBM Cognos Analytics als ein Systemadministrator an, der

Mitglied der Rolle Systemadministratoren ist.2. Wählen Sie in Verwalten > Konten > Namespaces den Cognos-Namespace

aus.3. Suchen Sie in der Liste der Einträge nach der Rolle Tenantadministratoren und

klicken Sie im entsprechenden Kontextmenü

auf Mitglieder anzeigen.4. Wählen Sie auf der Registerkarte Mitglieder das Symbol 'Mitglied hinzufügen'

aus. Blättern Sie durch die Hierarchie der Sicherheits-Namespaces, um dieBenutzer, Gruppen oder Rollen auszuwählen, die Mitglieder dieser Rolle seinsollen.


Ergebnisse

Nachdem Sie die entsprechenden Benutzer, Gruppen oder Rollen zur Rolle Tenant-administratoren hinzugefügt haben, können Sie mithilfe dieser Rolle Sicherheits-richtlinien und -funktionen für Objekte im Content Store einrichten.

Einrichten von virtuellen Tenants für die gemeinsame Nutzung von In-halten zwischen Tenants

Wenn Sie virtuelle Tenants einrichten, sind Objekte im Content Store für Benutzeraus unterschiedlichen Tenants zugänglich.

Virtuelle Tenants enthalten wirkliche Tenants, die bereits in Cognos Analytics kon-figuriert sind.


Multi-Tenant-Funktionalität ist für IBM Cognos Analytics aktiviert und die Tenantswerden in Verwalten > Multi-Tenant-Funktionalität erstellt. Weitere Informationenfinden Sie in „Erstellen von Tenants” auf Seite 52.


Auf der Registerkarte Multi-Tenant-Funktionalität sehen die Einträge für virtuelleTenants und wirkliche Tenants identisch aus. Um virtuelle Tenants abzuheben, ver-wenden Sie beim Erstellen dieser Tenants aussagekräftige Namen und eine entspre-chende Beschreibung.

Beispiel: Sie möchten die gemeinsame Nutzung für Tenants namens 'Nordamerika','Mittelamerika' und 'Südamerika' konfigurieren. Sie erstellen einen virtuellen Te-nant namens 'Nord- und Südamerika' und können diesem Tenant die drei Tenantshinzufügen. Benutzer, die einem dieser drei Tenants angehören, haben Zugriff aufdie Inhalte des eigenen Tenants, der beiden anderen Tenants sowie auf öffentlicheInhalte.

Wenn Sie einen virtuellen Tenant löschen, werden alle Inhalte, die diesem Tenantzugeordnet sind, ebenfalls gelöscht.

Weitere Informationen finden Sie in Erweiterte Multi-Tenant-Funktionen(www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_config_mt_advanced.html).

Vorgehensweise

Führen Sie die folgenden Schritte durch, um einen virtuellen Tenant und einenOrdner für die Inhalte des virtuellen Tenants zu erstellen.1. Melden Sie sich bei IBM Cognos Analytics als Mitglied der Rolle Systemadmi-

nistratoren an.2. Wählen Sie in Verwalten die Registerkarte Multi-Tenant-Funktionalität aus.

3. Wählen Sie das Symbol Tenant hinzufügen aus.4. Geben Sie die Parameter Name und Tenant-ID an.

Die virtuelle Tenant-ID muss nicht vorkonfiguriert sein. Sie kann ein beliebi-ger Wert sein.


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

Geben Sie als Beschreibung eine Zeichenfolge, wie Virtueller Tenant ein, an-hand derer Sie den Tenant von anderen Tenants in Cognos Analytics unter-scheiden können.

5. Wählen Sie Hinzufügen aus. Der Name des virtuellen Tenants wird in derListe der Tenants angezeigt, wobei der Tenant standardmäßig inaktiviert ist.Nachdem Sie ihn konfiguriert haben, können Sie den Tenant aktivieren.

6. Wählen Sie für den virtuellen Tenant, den Sie erstellt haben, über sein Kon-

textmenü

die Option Mitglieder anzeigen aus.7. Wählen Sie auf der Registerkarte Mitglieder das Symbol 'Mitglied hinzufügen'

aus.8. Wählen Sie die Tenants aus, die Sie zum virtuellen Tenant hinzufügen möch-

ten, und klicken Sie auf Hinzufügen.

Tipp: Sie können inaktivierte Tenants hinzufügen. Benutzer haben jedoch erstZugriff auf Inhalte inaktivierter Tenants, wenn diese aktiviert wurden.

9. Erstellen Sie einen neuen Ordner. Der Ordnername sollte zur leichteren Identi-fizierung dem Namen des virtuellen Tenants ähneln.

10. Ändern Sie auf der Seite mit den Ordnereigenschaften auf der RegisterkarteAllgemein im Abschnitt Erweitert den Wert für die Tenant-ID in den Wertder Tenant-ID des virtuellen Tenants, indem Sie die ID aus der Liste der ver-fügbaren IDs auswählen. Wenn beispielsweise Ihre virtuelle Tenant-ID Nord-und Südamerika lautet, wählen Sie diese ID aus der Liste aus und weisen Siesie dem Ordner zu.

Anpassen von TenantsSie können Motive auf einzelne Tenants anwenden. Sie können außerdem angeben,dass eine benutzerdefinierte Startseite, ein bestimmter Bericht oder ein bestimmtesDashboard angezeigt wird, wenn ein Benutzer mit einer bestimmten Tenant-IDIBM Cognos Analytics öffnet. Darüber hinaus können Sie Standardbenutzerschnitt-stellenfeatures für Tenants entfernen.

Vor dem Festlegen von benutzerdefinierten Motiven und Startseiten (außer Dash-boards oder Berichten) müssen Sie die benutzerdefinierten Motive bzw. Startseitenerstellen und hochladen. Weitere Informationen finden Sie in Kapitel 8, „Anpassenvon Cognos Analytics für alle Rollen”, auf Seite 61.

Klicken Sie in Verwalten > Multi-Tenant-Funktionalität auf einen Tenant. Das Sli-deout-Fenster für diesen Tenant enthält eine Registerkarte Anpassung. Weitere In-formationen finden Sie in „Verwalten von Motiven, Erweiterungen, Ansichten undParameter” auf Seite 91.

Festlegen einer Standardstartseite

Klicken Sie auf das Symbol für 'Weiter'

neben der Standardstartseite. Nun kön-nen Sie nach einem Dashboard oder Bericht suchen, das bzw. der als Standardstart-seite verwendet werden soll, oder Sie können eine Ansicht in der Liste der Ansich-ten auswählen, die als Standardstartseite für alle Benutzer dieses Tenantsverwendet werden soll.


Entfernen von Features

Sie können Benutzerschnittstellenfeatures auswählen, die für den Tenant entfernt

werden sollen. Klicken Sie auf das Symbol für 'Weiter'

neben Features. Eine Lis-te mit Ansichten wird angezeigt. Diese Liste enthält sowohl die integrierten An-sichten als auch alle benutzerdefinierten Ansichten, die hochgeladen wurden. Kli-cken Sie auf eine Ansicht, um eine allgemeine Gruppierung der Features für die

Ansicht anzuzeigen. Klicken Sie auf

neben einer Gruppierung, um die Featureseiner unteren Ebene einzublenden. Sie können beliebige Features in dieser Listeoder in den darunter liegenden Ebenen abwählen. Klicken Sie auf Anwenden, umdie Änderungen zu speichern. Mit Auf Standardwerte zurücksetzen können Siedie Änderungen zurücksetzen.


Klicken Sie auf

neben dem Standardmotiv. Sie können ein Motiv in der Listeder Motive auswählen, das als Standardmotiv für diesen Tenant verwendet werdensoll.

Erstellen eines benutzerdefinierten Ordners

Klicken Sie neben Benutzerdefinierter Ordner auf , um einen benutzerdefinier-ten Inhaltsordner für diesen Tenant anzugeben. Wenn sich ein Benutzer mit dieserTenant-ID anmeldet, wird der benutzerdefinierte Ordner in der Navigationsleisteunter Teaminhalt angezeigt.

Parameter

Fügen Sie hier Inhalt für Rollen ein.

Definieren von Regionseinstellungen für TenantsEin Systemadministrator kann Regionseinstellungen für einen Tenant angeben.

Die Regionseinstellungen gelten für alle IBM Cognos Analytics-Komponenten wiez. B. Reporting, Dasbhoarding, Modellierung, Administration usw. Ferner geltendiese Einstellungen für Begleitanwendungen wie IBM Cognos Analysis Studio,IBM Cognos Event Studio usw.

Die folgenden Einstellungen können angegeben werden:

ZeitzoneDie Zeitzone für den Tenantbenutzer.

ProduktspracheDie Sprache der IBM Cognos Analytics-Benutzerschnittstelle.

InhaltsspracheDie Sprache, die zum Anzeigen und Erstellen von Inhalt in IBM CognosAnalytics verwendet wird, wie z. B. für Daten in Berichten, Dashboardsund Storys.

Unterstützung bidirektionaler SprachenDiese Einstellung gilt für Sprachen wie Arabisch, Hebräisch, Urdu oderFarsi. Mit dieser Einstellung können Sie die Textrichtung in Eintragsnamen,Beschreibungen, Beschriftungen und QuickInfos, Eingabefeldern, Kommen-


taren sowie in gegliedertem Text wie E-Mail-Adressen, Dateipfade, Naviga-tionspfade, URLs und Datums-/Zeitformate steuern.

Wählen Sie eine der folgenden Optionen in Basisrichtung für Text aus:Von rechts nach links, Von links nach rechts, Kontextbezogen. Wenn dieOption Kontextbezogen ausgewählt wird, hängt die Textrichtung vom ers-ten Buchstaben im Text ab. Gehört der Buchstabe zu einer Rechts-nach-Links-Schrift, ist die Textrichtung von rechts nach links. Andernfalls ist dieTextrichtung von links nach rechts. Zahlen und Sonderzeichen haben kei-nen Einfluss auf die Textrichtung. Wenn der Text zum Beispiel mit einerZahl gefolgt von einem arabischen Buchstaben beginnt, ist die Richtungvon rechts nach links. Wenn der Text dagegen mit einer Zahl gefolgt voneinem lateinischen Buchstaben beginnt, ist die Richtung von links nachrechts.

Vorgehensweise1. Wählen Sie in Verwalten die Registerkarte Multi-Tenant-Funktionalität aus.2. Klicken Sie um Tenantkontextmenü auf Eigenschaften.3. Klicken Sie auf die Registerkarte Regional und geben Sie die Einstellungen an.

Ergebnisse

Standardmäßig werden diese Einstellungen von allen Tenantbenutzern übernom-men. Abhängig von ihren Zugriffsberechtigungen können die Benutzer diese Ein-stellungen später individuell gestalten.

Einrichten von Benachrichtigungen für TenantsEin Systemadministrator kann ein E-Mail-Konto mit dem Namen Tenantabsenderkonfigurieren, von dem die Tenantbenutzer E-Mails empfangen.

Das Tenantabsenderkonto setzt das beim Konfigurieren des E-Mail-Servers für IBMCognos Analytics angegebene Standardabsenderkonto außer Kraft.

Tipp: Der Standardabsender wird in IBM Cognos Configuration unter Datenzu-griff > Benachrichtigung konfiguriert.

Vorgehensweise1. Wählen Sie in Verwalten die Registerkarte Multi-Tenant-Funktionalität aus.2. Klicken Sie im Tenantkontextmenü auf Eigenschaften.3. Wählen Sie auf der Registerkarte Benachrichtigungen die Option Tenantabsen-

der aus und geben Sie die zugehörige E-Mail-Adresse an. Klicken Sie auf An-wenden.

Ergebnisse

Das E-Mail-Konto für den Tenantabsender ist jetzt für die Verteilung von IBM Cog-nos Analytics-Inhalten zugeordnet.

Beenden aktiver Benutzersitzungen für TenantsBevor Sie einen Tenant löschen oder Wartungsoperationen für Tenants durchfüh-ren, müssen Sie die aktiven Benutzersitzungen für Tenants beenden.



Bevor Sie die aktiven Benutzersitzungen eines Tenants beenden, inaktivieren Sieden Tenant, damit keine neuen Benutzersitzungen gestartet werden können. Weite-re Informationen finden Sie in „Inaktivieren und Aktivieren von Tenants”.


Beenden Sie mit dieser Aktion alle aktiven Benutzersitzungen für die angegebenenTenants. Der Zugriff für die anderen Tenants ist davon nicht betroffen.

Vorgehensweise1. Suchen Sie in Verwalten > Multi-Tenant-Funktionalität nach dem entsprechen-

den Tenant.

2. Klicken Sie im Kontextmenü des Tenants

auf Sitzungen beenden.

Ergebnisse

Es wird eine Nachricht mit der Anzahl der beendeten Benutzersitzungen angezeigt.

Inaktivieren und Aktivieren von TenantsSie können einen Tenant inaktivieren, wenn Sie Benutzer von Tenants darin hin-dern möchten, auf IBM Cognos Analytics zuzugreifen und den Inhalt des Tenantszu ändern.


Ein neu erstellter Tenant ist standardmäßig inaktiviert und muss nach seiner Konfi-guration aktiviert werden.

Sie sollten einen Tenant inaktivieren, bevor Sie ihn und seinen Inhalt bereitstellen.Weitere Informationen finden Sie in Bereitstellen von Tenantinhalt (www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_mt_deployment.html).

Als Best Practice sollten Sie einen Tenant auch inaktivieren, bevor Sie seine aktivenBenutzersitzungen beenden. Weitere Informationen finden Sie in „Beenden aktiverBenutzersitzungen für Tenants” auf Seite 58.

Vorgehensweise1. Suchen Sie in Verwalten > Multi-Tenant-Funktionalität nach dem entsprechen-

den Tenant.


auf Inaktivieren.Ein Symbol, das den inaktivierten Status anzeigt, wird zum Tenantsymbol hin-

zufügt .Sie können den Tenant aktivieren, indem Sie Aktivieren auswählen.


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

Löschen von TenantsSie können einen Tenant aus IBM Cognos Analytics löschen. Dies kann erforderlichsein, wenn der Tenant permanent in eine andere Instanz von IBM Cognos Analy-tics verschoben wurde.


Bevor Sie einen Tenant löschen, müssen Sie die aktiven Benutzersitzungen des Te-nants beenden. Andernfalls kann der Tenant nicht gelöscht werden. Weitere Infor-mationen finden Sie in „Beenden aktiver Benutzersitzungen für Tenants” auf Seite58.


Beim Löschen eines Tenants werden auch alle zugehörigen Inhalten, wie Berichteoder Dashboards, gelöscht.

Vorgehensweise1. Suchen Sie in Verwalten > Multi-Tenant-Funktionalität nach dem Tenant, den

Sie löschen möchten.


auf Löschen.


Kapitel 8. Anpassen von Cognos Analytics für alle Rollen

Die IBM Cognos Analytics-Benutzerschnittstelle basiert auf einem erweiterbarenModell. In diesem Modell sind die Benutzerschnittstellenanzeigen als Ansichtendefiniert (z. B. home, authoring, dashboard oder modeller). Sie können dieseAnsichten für alle Benutzer und Rollen anpassen, indem Sie Benutzerschnittstellen-elemente, wie z. B. Schaltflächen und Menüs, hinzufügen und entfernen. Sie kön-nen neue Ansichten zur Erweiterung der Cognos Analytics-Benutzerschnittstelledefinieren. Darüber hinaus können Sie die Standardstartseite und die Standardan-meldeseite ersetzen oder in allen Ansichten das Standardbranding durch ein eige-nes Branding (mit Farben, Logos und Brandingtext) ersetzen.

Anpassungen werden als komprimierte Dateien gepackt, die eine Datei mit demNamen spec.json enthalten, mit der die Anpassung definiert wird. Abhängig vomTyp der Anpassung kann die komprimierte Datei auch andere Dateien enthalten.Anpassungen können auch in Bereitstellungen enthalten sein.

Verwenden Sie zum Verwalten von Anpassungen für alle Benutzer und Rollen dasSlideout-Fenster Verwalten > Anpassungen. Über dieses Fenster können Sie IhreAnpassungen auf den Cognos Analytics-Server hochladen und auswählen, welcheAnpassungen verwendet werden sollen.

Hinweis:

Wenn Sie das Slideout-Fenster Verwalten > Anpassungen verwenden, werden Ihre Anpas-sungen auf alle Benutzer und Rollen angewendet.

Wenn Sie z. B. die Beispielerweiterung mit dem NamenSampleExtensionExcludeNotifications.zip hochladen, wird das Symbol Benachrichtigun-

gen aus der Anwendungsleiste in der Perspektive Home für alle Benutzer und Rol-len entfernt. Außerdem wird hiermit das Kontrollkästchen Benachrichtigungen aus derFeatureliste entfernt, wenn ein Administrator die Eigenschaften einer beliebigen Rolle aus-wählt, auf die Registerkarte Anpassung klickt und zu Features > Home >Anwendungsleiste navigiert.

Aus diesem Grund sollten Sie eine Erweiterung verwenden, falls Sie beabsichtigen, ein Fea-ture für jeden Nutzer in Ihrer Cognos-Umgebung hinzuzufügen oder zu entfernen. FallsSie jedoch beabsichtigen, unterschiedliche Features für Benutzer und Rollen bereitzustellen,sollten Sie einzelne Rollenanpassungen anstelle einer Erweiterung verwenden.

Wenn Sie Rollenanpassungen zum Festlegen bestimmter Features für Benutzerrollen ver-wenden und dann eine Erweiterung anwenden, die auf diesen Features basiert, setzt dieErweiterung alle Ihre Rollenanpassungen außer Kraft.

Zum Zuweisen von Startseiten, Funktionen, Motiven, benutzerdefinierten Ordnernund Parametern zu bestimmten Rollen verwenden Sie das Slideout-Fenster Verwal-ten > Konten > Namespaces. Weitere Informationen finden Sie in „Anpassen vonRollen” auf Seite 6.

Im Slideout-Fenster Verwalten > Multi-Tenant-Funktionalität können Sie benut-zerdefinierte Motive und Startseiten bestimmten Tenants zuweisen. Wählen Sie

61

dazu in der Eigenschaftsanzeige des entsprechenden Tenants die Registerkarte An-passung aus. Weitere Informationen finden Sie in „Anpassen von Tenants” auf Sei-te 56.

Bei einigen Anpassungen müssen Sie JavaScript als Programmiersprache verwen-den. Diese Anpassungen sind in den folgenden Abschnitten beschrieben.v „Erstellen eines benutzerdefinierten Aktionscontrollers” auf Seite 70v „Erstellen einer Ansicht (mit Ausnahme von Anmeldeansichten)” auf Seite 82v „Erstellen einer Anmeldeansicht” auf Seite 85

Bei den anderen Anpassungsarten sind keine Programmierungskenntnisse erforder-lich.

Die für die Definition der Anpassungen verwendeten JSON-Schemas weisen einenvorläufigen Status auf und werden möglicherweise in zukünftigen Releases vonCognos Analytics so geändert, dass sie mit früheren Versionen nicht kompatibelsind.

AnpassungsbeispieleEs stehen Anpassungsbeispiele zur Verfügung, die das Erstellen von Motiven, Er-weiterungen und Ansichten veranschaulichen. Sie können diese Beispiele ändern,um eigene Anpassungen zu erstellen.

Bei einer einfachen Installation (Easy Install) werden diese Beispieldateien zusam-men mit dem Produkt installiert, bei einer angepassten Installation können Sie alsOption ausgewählt werden. Nach der Produktinstallation finden Sie die Dateien imOrdner Installationsverzeichnis/samples.

Die Anpassungsbeispiele sind in den folgenden Abschnitten beschrieben.v „Beispielmotive” auf Seite 65v „Beispielerweiterungen” auf Seite 78v „Beispielansichten” auf Seite 89

Verwenden von Beispielen

Die Anpassungsbeispiele veranschaulichen die Implementierung häufig verwende-ter Anpassungen. Sie können den Beispielcode anzeigen und ändern, um Anpas-sungen für Benutzer zu erstellen. Extrahieren Sie zum Prüfen der Inhalte eines An-passungsbeispiels die ZIP-Datei. Jedes Beispiel beinhaltet eine spec.json-Datei, diedie Logik für die Anpassung enthält. Abhängig von der Anpassung können auchweitere Dateien oder Ordner mit Bilddateien, JavaScript-Dateien und HTML-Datei-en vorhanden sein.

Beachten Sie zum Hochladen und Verwenden eines Beispielmotivs oder einer Bei-spielerweiterung die Anweisungen in „Verwalten von Motiven, Erweiterungen, An-sichten und Parameter” auf Seite 91.

Erstellen von MotivenSie können das IBM Cognos Analytics-Standardmotiv für die Cognos Analytics-Benutzerschnittstelle mit einem Motiv überschreiben, das Ihr Unternehmensbran-ding widerspiegelt.


Die Beispielanpassung SampleTheme.zip veranschaulicht das Erstellen eines Motivs.Das ZIP-Archiv enthält die Datei spec.json mit der Definition des Motivs und denOrdner images, der die diesem Motiv zugeordneten Abbildungen enthält. Bildda-teinamen können keine Leerzeichen enthalten.

Anmerkung: Ihr bestimmtes Thema kann aus einem Ordner wie z. B. „myTheme”bestehen, der eine Datei JSON-Datei und images (mit Ihren Grafiken) enthält. WennSie die ZIP-Datei erstellen, schließen Sie den Ordner (z. B. „myTheme”) nicht indie ZIP-Datei ein. Cognos Analytics kann sie nicht verarbeiten. Wählen Sie statt-dessen die JSON-Datei und den Ordner images ein und verwenden Sie dann einArchivierungsprogramm, um die ZIP-Datei zu erstellen. Verwenden Sie nicht Win-dows Explorer-Funktion „Senden an komprimierten Ordner”, um die ZIP-Datei zuerstellen. Das Ergebnis wäre eine nicht kompatible Datei.

Die Datei spec.json ist hier dargestellt.{

"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"

}}

Die aktuellen Beispiele enthalten die Elemente brandTextSmall und favicon nicht.Sie sind hier zu Dokumentationszwecken aufgeführt.

Die Objekte in dieser Datei entsprechen den hier aufgeführten Cognos Analytics-Benutzerschnittstellenelementen. Wenn im Motiv Motivelemente weggelassen wer-den, wird das Cognos Analytics-Standardmotivelement verwendet.

Kapitel 8. Anpassen von Cognos Analytics für alle Rollen 63

Diese Tabelle ordnet die Benutzerschnittstellenelemente den JSON-Objekten zu.

Tabelle 5. Objekte für Motive

Benutzerschnittstel-lenreferenz JSON-Beschreibung Definition

1 brandText Brandingtext. Wenn Sie für diesenEintrag keine Angabe machenmöchten, geben Sie eine leereZeichenfolge ein.

2 brandTextSmall Kurzer Brandingtext. Wird hierkeine Angabe gemacht, wirdbrandText verwendet. Wenn Sie fürdiesen Eintrag keine Angabe ma-chen möchten, geben Sie eine leereZeichenfolge ein.

3 brandIcon Brandingsymbol

4 brandIconSmall Kleines Brandingsymbol

5 appbarBackground Hintergrundfarbe für dieAnwendungsleiste

5 appbarForeground Vordergrundfarbe für dieAnwendungsleiste

5 appbarSelectLine Linienfarbe für dieAnwendungsleistenauswahl

5 appbarPushButtonBackground Hintergrundfarbe für eineSchaltfläche in derAnwendungsleiste

6 navbarBackground Hintergrundfarbe derNavigationsleiste

6 navbarForeground Vordergrundfarbe derNavigationsleiste

6 navbarSelectLine Linienfarbe für dieNavigationsleistenauswahl


Tabelle 5. Objekte für Motive (Forts.)

Benutzerschnittstel-lenreferenz JSON-Beschreibung Definition

6 navbarPushButtonBackground Hintergrundfarbe für eineSchaltfläche in derNavigationsleiste

favicon Symbol für die Anzeige auf derRegisterkarte des Web-Browsers.

BeispielmotiveDie folgenden Beispiele veranschaulichen die Verwendung von Motiven.

Diese Beispiele sind im Ordner <installationsposition>/samples/themes instal-liert.

SampleTheme.zipEin Motiv, mit dem das Branding und das Farbschema für die CognosAnalytics-Benutzerschnittstelle geändert werden.

SampleThemeBlueGreen.zipEin Motiv, mit dem das Farbschema für die Cognos Analytics-Benutzer-schnittstelle geändert wird.

SampleThemeDarkBlue.zipEin Motiv, mit dem das Farbschema für die Cognos Analytics-Benutzer-schnittstelle geändert wird.

SampleThemeLight.zipEin Motiv, mit dem das Farbschema für die Cognos Analytics-Benutzer-schnittstelle geändert wird.

Erstellen von ErweiterungenSie können Erweiterungen erstellen, mit denen neue Funktionen zur IBM CognosAnalytics-Benutzerschnittstelle hinzugefügt werden. So können Sie beispielsweiseSchaltflächen hinzufügen, mit denen ein bestimmter Bericht oder ein bestimmtesDashboard geöffnet wird, wenn darauf geklickt wird. Darüber hinaus können SieStandardschaltflächen von der Benutzerschnittstelle entfernen.

Zum Erstellen und Hochladen von Erweiterungen müssen Sie die Berechtigungeneines Portal- oder Systemadministrators besitzen.

Erweiterungen sind in einer Datei mit dem Namen spec.json definiert, die sich imStammverzeichnis der ZIP-Datei für die Erweiterung befindet. Abhängig von derjeweiligen Erweiterung sind möglicherweise auch Ordner vorhanden, in denen Bil-der, HTML-Dateien und JavaScript-Dateien enthalten sind. Struktur und Inhalt derDatei spec.json sind in „Beschreibung der Datei spec.json” auf Seite 93 beschrie-ben. Die allgemeine Struktur der Datei ist hier dargestellt.{"name":"...","schemaVersion": "1.0","extensions": [{"perspective": "common","features": [{"id": "...","toolItems": [<Toolelement1>,<Toolelement2>,...],"collectionItems": [<Gruppenelement1>,<Gruppenelement2>,...],


"excludeFeatures": [<auszuschließendes Feature1>,<auszuschließendes Feature2>,...],"excludeItems": [<auszuschließendes Element1>,<auszuschließendes Element2>,...]}]}}

Der Wert des Elements perspective gibt an, welche Ansichten diese Erweiterungverwenden. Der Wert common bedeutet, dass die Erweiterung für alle Ansichten ver-wendet wird. Die Elemente im Array features werden der Aktion der Erweiterungentsprechend verwendet. Sie werden in den folgenden Abschnitten veranschau-licht.

Durch das Erstellen von Erweiterungen können Sie vorhandene Ansichten ändernund neue Ansichten erstellen. Die Aktionen, die mit einer Erweiterung ausgeführtwerden können, sind hier aufgeführt und in den folgenden Abschnitten beschrie-ben. Mit einer einzelnen Erweiterung können eine oder mehrere Aktionen ausge-führt werden.v Hinzufügen einer Schaltfläche zur Anwendungs- oder Navigationsleiste, über

die eine Aktion ausgeführt werden kann, z. B. Anzeigen einer Website, Ausfüh-ren eines Berichts oder Öffnen eines Dashboards, einer Story oder eines Ordners.

v Hinzufügen eines Menüelements zu einem vorhandenen Menü, über das eineAktion ausgeführt werden kann, z. B. Anzeigen einer Website, Ausführen einesBerichts oder Öffnen eines Dashboards, einer Story oder eines Ordners.

v Hinzufügen eines Menüs zusammen mit den zugehörigen Menüelementen.v Entfernen eines Standardbenutzerschnittstellenfeatures oder -elements.v Hinzufügen benutzerdefinierter Formen zur Verwendung in Dashboards.v Hinzufügen benutzerdefinierter Widgets zur Verwendung in Dashboards.

Hinzufügen einer Schaltfläche oder eines MenüelementsSie können Schaltflächen und Menüelemente hinzufügen, mit denen eine Reiheverschiedener Aktionen durchgeführt werden kann, z. B. Anzeigen einer Website,Ausführen eines Berichts oder Öffnen eines Dashboards, einer Story oder einesOrdners. Sie können auch benutzerdefinierte Aktionen erstellen.

Für alle Schaltflächen ist ein Aktionscontroller erforderlich. Es sind vier integrierteAktionscontroller zur Ausführung allgemeiner Aktionen verfügbar. Diese Aktionensind nachfolgend aufgeführt.

bi/glass/api/IFrameOpenerÖffnet eine Webseite.

bi/glass/api/ReportOpenerFührt einen Bericht aus.

bi/glass/api/DashboardOpenerÖffnet ein Dashboard.

bi/glass/api/FolderOpenerÖffnet einen Ordner.

Sie können benutzerdefinierte Aktionscontroller auch mit JavaScript schreiben.

Der Inhalt der Datei json.spec ist für Schaltflächen und Menüelemente ähnlich,daher wird er nicht separat beschrieben. Der Hauptunterschied besteht darin, dassder Wert des Elements type für eine Schaltfläche button lautet, für ein Menüele-ment dagegen menuItem. Weitere Unterschiede sind in den folgenden Abschnittendokumentiert.


Verwenden integrierter AktionscontrollerEs sind vier integrierte Aktionscontroller verfügbar. Mit diesen Aktionscontrollernkann eine Webseite geöffnet, ein Bericht ausgeführt, ein Ordner geöffnet und einDashboard oder eine Story geöffnet werden. Die Aktionscontroller werden in denfolgenden Abschnitten beschrieben.

Öffnen einer Webseite

Verwenden Sie den Aktionscontroller bi/glass/api/IFrameOpener, um eine Websei-te zu öffnen. Die verfügbaren Optionen sind hier aufgeführt.

url Gibt die URL der zu öffnenden Webseite an.

title Gibt den anzuzeigenden Webseitentitel an.

Mit der Beispielerweiterung SampleExtensionButtonWebsite.zip wird eine Websei-te geöffnet. Die Datei spec.json ist hier dargestellt.{"name":"Sample_Button_Website","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Es steht eine spezielle Metaperspektive mit der Bezeichnung COMMON zur Verfügung.

Das Hinzufügenvon Beiträgen zu dieser Perspektive bewirkt, dass die Erweiterungauf alle Perspektiven angewendet wird.",

"features": [{"id": "sample.common.button.openWebsite","toolItems": [{"comment": "Mit diesem Code wird eine benutzerdefinierte Schaltfläche für die Website angezeigt,

über die die angegebene URL in einem iFrame geöffnet wird.","id": "sample.iframeOpener.website","containerId": "com.ibm.bi.glass.navbarTrailingGroup","label": "Website","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": "Website"

}}]}]}]}

Die Schaltflächenbeschriftung lautet Website und als Schaltflächensymbol wird dasBild web.png verwendet, das sich im Ordner images befindet. Der Aktionscontrollerist bi/glass/api/IFrameOpener, der zwei Optionen erfordert: die URL der Webseite(url) und den Titel der Webseite, der beim Öffnen der Seite angezeigt wird (title).Die anderen Elemente in der Datei spec.json werden in „Beschreibung der Dateispec.json” auf Seite 93 beschrieben.

Ausführen eines Berichts

Mit dem Aktionscontroller bi/glass/api/ReportOpener können Sie einen Berichtausführen. Die verfügbaren Optionen sind hier aufgeführt. Es muss entweder idoder path angegeben werden.

id Gibt die Speicher-ID des auszuführenden Berichts an.


path Gibt den Pfad des auszuführenden Berichts an.

Mit der Beispielerweiterung SampleExtensionButtonReport.zip wird ein Berichtausgeführt. Die Datei spec.json ist hier dargestellt.{"name":"Sample_Button_Report","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Es steht eine spezielle Metaperspektive mit der Bezeichnung COMMON zur Verfügung.

Das Hinzufügen von Beiträgen zu dieser Perspektive bewirkt, dass dieErweiterung für alle Perspektiven angewendet wird.",

"features": [{"id": "sample.common.button.openReport","toolItems": [{"comment": "Hiermit wird eine Schaltfläche hinzugefügt, über die ein gängiger Bericht direkt geöffnet werden kann.","id": "sample.report.opener","containerId": "com.ibm.bi.glass.navbarLeadingGroup","label": "QTD revenue","type": "Button","icon": "common-report","weight": 800,"comment": "Je höher der Wert für ’weight’ ist, desto weiter oben wird das Element im Container angezeigt.","actionController": "bi/glass/api/ReportOpener","options": {"path": ".public_folders/Samples/Extensions/QTD revenue"}}]}]}]}

Der Aktionscontroller ist bi/glass/api/ReportOpener, der eine Option erfordert:den Pfad des Berichts (path). .public_folders ist der Stammordner für Teaminhaltund .my_folders ist der Stammordner für Eigener Inhalt. Wenn der Berichtsnameeinen Schrägstrich (/) enthält, muss dieser als %2F codiert werden. Die anderen Ele-mente in der Datei spec.json werden in „Beschreibung der Datei spec.json” aufSeite 93 beschrieben.

Öffnen eines Dashboards oder einer Story

Verwenden Sie den Aktionscontroller bi/glass/api/DashboardOpener, um ein Dash-board oder eine Story zu öffnen. Die verfügbaren Optionen sind hier aufgeführt.Es muss entweder id oder path angegeben werden.

id Gibt die Speicher-ID des Dashboards oder der Story an, das/die geöffnetwerden soll.

path Gibt den Pfad des Dashboards oder der Story an, das/die geöffnet werdensoll.

Mit der Beispielerweiterung SampleExtensionButtonDashboard.zip wird ein Dash-board geöffnet. Die Datei spec.json ist hier dargestellt.{"name":"Sample_Button_Dashboard","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Es steht eine spezielle Metaperspektive mit der Bezeichnung COMMON zur Verfügung.


"features": [{"id": "sample.common.button.openDashboard",


"toolItems": [{"comment": "Mit diesem Code wird eine Schaltfläche hinzugefügt, über die ein

zentrales Dashboard direkt geöffnet werden kann.","id": "sample.dashboard.opener","containerId": "com.ibm.bi.glass.navbarLeadingGroup","label": "Line dashboard","type": "Button","icon": "common-dashboard","weight": 900,"comment": "Je höher der Wert für ’weight’ ist, desto weiter oben wird das Element im Container angezeigt.","actionController": "bi/glass/api/DashboardOpener","options": {"path": ".public_folders/Samples/Extensions/Line dashboard"}}]}]}]}

Der Aktionscontroller ist bi/glass/api/DashboardOpener; die einzige erforderlicheOption ist der Pfad des Dashboards (path), der auf dieselbe Weise bestimmt wirdwie der Pfad für einen Bericht. Die anderen Elemente in der Datei spec.json wer-den in „Beschreibung der Datei spec.json” auf Seite 93 beschrieben.

Öffnen eines Ordners

Verwenden Sie den Aktionscontroller bi/glass/api/FolderOpener, um einen Ord-ner zu öffnen. Die verfügbaren Optionen sind hier aufgeführt. Es muss entwederid oder path angegeben werden.

id Gibt die Speicher-ID des zu öffnenden Ordners an.

path Gibt den Pfad des zu öffnenden Ordners an.

skipAncestorsGibt an, ob Vorfahrenordner beim Öffnen des Ordners angezeigt (false)oder ausgeblendet (true) werden sollen. Der Standardwert ist false.

Mit der Beispielerweiterung SampleExtensionButtonFolder.zip wird ein Ordnergeöffnet. Die Datei spec.json ist hier dargestellt.{"name":"Sample_Button_Folder","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Es steht eine spezielle Metaperspektive mit der Bezeichnung COMMON zur Verfügung.


"features": [{"id": "sample.common.button.openFolder","toolItems": [{"comment": "Mit diesem Code wird eine Schaltfläche für den einfachen Zugriff

auf einen wichtigen Ordner hinzugefügt.","id": "sample.folder.opener","containerId": "com.ibm.bi.glass.navbarLeadingGroup","label": "2016 reports","type": "Button","icon": "common-folder","weight": 700,"push": "true","comment": "Je höher der Wert für ’weight’ ist, desto weiter oben wird das Element im Container angezeigt.","actionController": "bi/glass/api/FolderOpener","options": {"path": ".public_folders/Samples/Extensions"}


}]}]}]}

Diese Beispiel enthält das Element "push": "true". Dieses Element ist beim Öffneneines Ordner erforderlich, da sich eine Schaltfläche zum Öffnen eines Ordners ineinem von zwei Status befinden kann: geöffnet oder geschlossen. (Dieses Elementwird für ein Menüelement nicht verwendet.) Wenn nach dem Öffnen eines Ordnerserneut auf die Schaltfläche geklickt wird, wird der Ordner geschlossen. Der Akti-onscontroller ist bi/glass/api/FolderOpener; die einzige erforderliche Option istder Pfad des Ordners (path), der auf dieselbe Weise bestimmt wird wie der Pfadfür einen Bericht. Die anderen Elemente in der Datei spec.json werden in „Be-schreibung der Datei spec.json” auf Seite 93 beschrieben.

Erstellen eines benutzerdefinierten AktionscontrollersSie können benutzerdefinierte Aktionscontroller für die Ausführung von Aktionenerstellen, die mit den integrierten Aktionscontrollern nicht zur Verfügung stehen.Benutzerdefinierte Aktionscontroller werden in JavaScript geschrieben, wobei dieAMD-API (Asynchronous Module Definition) verwendet wird.

Mit der Beispielerweiterung SampleExtensionContextMenuItem.zip wird ein benut-zerdefinierter Aktionscontroller implementiert, durch den ein Menüelement zumKontextmenü für alle Berichtsobjekte hinzugefügt wird. Die Datei spec.json isthier dargestellt.{"name":"Sample_Context_Menu_Item","comment": "Mit dieser Erweiterung wird ein neues Menüelement zum Kontextmenü

für alle Berichtsobjekte hinzugefügt.","comment": "Mit dem Menüelement wird ein Alertfeld geöffnet, das Informationen

zum ausgewählten Bericht enthält.","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Es steht eine spezielle Metaperspektive mit der Bezeichnung COMMON zur Verfügung.


"features": [{"id": "sample.home.context.item","toolItems": [{"id": "custom.context.menu.item1","containerId" : "com.ibm.bi.contentApps.listViewMenu","comment": "containerId ist die ID des übergeordneten Menüs.","type": "MenuItem","actionController": "v1/ext/Sample_Context_Menu_Item/js/controllers/SampleContextMenuItem","label": "Sample menu item","icon": "common-properties","weight":950}]}]}]}

Bei dem benutzerdefinierten Aktionscontroller handelt es sich um die Datei Samp-leContextMenuItem.js, die sich im Ordner js/controllers in der Erweiterung be-findet. Diese Datei ist hier dargestellt./*** Licensed Materials - Property of IBM** IBM Cognos Products: BI Glass


** Copyright IBM Corp. 2015** US Government Users Restricted Rights - Use, duplication or disclosure restricted byGSA ADP Schedule Contract with IBM Corp.*/define([], function() {’use strict’;

var SampleAction = function(){

/*** Wird bei jeder Erstellung dieser Ansicht von AppController aufgerufen.** @public* @returns {Promise} - Promise, das in das DOM-Stammelement für diese Ansicht aufgelöst wird.*/this.isVisible = function(context, target) {return target.options[0].type === ’report’;},

/*** Wird bei jedem Löschen dieser Ansicht von AppController aufgerufen.** @public*/this.execute = function(context, target) {var info = ’Dieses Beispielmenüelement öffnet einen Alert.\nDer Alert enthält Informationen zum ausgewählten Bericht.\n\nType: ’ + target.options[0].type + ’\nName: ’ + target.options[0].name+ ’\nID: ’ + target.options[0].id;alert(info);}

};

return SampleAction;

});

Dieser JavaScript-Code verwendet die Aktions-API in einem JavaScript-AMD-Mo-dul. Für diese Module ist die JavaScript Q-Bibliothek erforderlich. Die Aktions-APIbesteht aus zwei Methoden.

void execute(context, target)

contextDieses Objekt enthält Dienstprogramm-Methoden.

target Dieses Objekt enthält Informationen zu der Schaltfläche oder demMenüelement, die bzw. das durch die Erweiterung erstellt wird.v Für eine Schaltfläche oder ein Menüelement in einem Anwen-

dungsleisten- oder Navigationsleistenmenü enthält dieses Objektdie Optionseigenschaft für das Element.

v Für ein Menüelement in einem Kontextmenü eines Objekts ent-hält dieses Objekt ein Array mit dem Typ, dem Namen und derSpeicher-ID des Objekts.

boolean isVisible(context, target)Diese Methode ist nur für Menüelemente anwendbar. Das Menüelementwird angezeigt, wenn für diese Methode der Wert true zurückgegebenwird; andernfalls wird das Menüelement ausgeblendet.


Hinzufügen eines MenüsSie können ein Menü und die zugehörigen Menüelemente zur Anwendungs- oderNavigationsleiste hinzufügen.

Mit der Beispielerweiterung SampleExtensionMenuQuicklinks.zip werden ein Menüund sechs Menüelemente hinzugefügt. Ein Teil der Datei spec.json ist hier darge-stellt.{"name":"Sample_Menu_Quicklinks","schemaVersion": "1.0","extensions": [{"perspective": "common","comment": "Es steht eine spezielle Metaperspektive mit der Bezeichnung COMMON zur Verfügung.


"features": [{"id": "sample.common.menu.openMulipleItems","toolItems": [{"comment": "Mit diesem Code wird ein benutzerdefiniertes Menüelement zur Anwendungsleiste

in der abschließenden Gruppe hinzugefügt.","id":"custom.appbar.trailingGroup.menu","containerId": "com.ibm.bi.glass.appbarTrailingGroup","type": "Menu","label": "Quick links","icon": "images/debug.svg","weight": 650},{"comment": "Mit diesem Code wird ein Untermenüelement zum erstellten benutzerdefinierten Menü hinzugefügt.","id": "custom.appbar.trailingGroup.menuItem1","containerId" : "custom.appbar.trailingGroup.menu","comment": "containerId ist die ID des übergeordneten Menüs.","type": "MenuItem","actionController": "v1/ext/Sample_Menu_Quicklinks/js/controllers/SampleMenuQuicklinks","comment": "actionController bestimmt die Aktionen für die Menüelemente.","label": "Home","icon": "common-home","weight":900},{"comment": "Mit diesem Code wird ein Untermenüelement zum erstellten benutzerdefinierten Menü hinzugefügt.","id": "custom.appbar.trailingGroup.menuItem2","containerId" : "custom.appbar.trailingGroup.menu","comment": "containerId ist die ID des übergeordneten Menüs.","label": "Line dashboard","type": "MenuItem","icon": "common-dashboard","weight":800,"actionController": "bi/glass/api/DashboardOpener","comment": "actionController bestimmt die Aktionen für die Menüelemente.","options": {"path": ".public_folders/Samples/Extensions/Line dashboard"}},...]}]}]}

In diesem Beispiel befindet sich das Menü in der abschließenden Gruppe der An-wendungsleiste.

Entfernen eines BenutzerschnittstellenelementsSie können Standardbenutzerschnittstellenelemente aus allen Ansichten oder ausbestimmten Ansichten, die Sie angeben, entfernen.


Mit der Beispielerweiterung SampleExtensionExcludeNotifications.zip wird dieSchaltfläche Benachrichtigungen aus der Navigationsleiste entfernt. Die Dateispec.json ist hier dargestellt.{"name":"Sample_Exclude_Notifications","schemaVersion": "1.0","extensions": [{"perspective": "home","comment": "Dieser Code wird nur für die Perspektive HOME angewendet.","features": [{"id": "sample.home.exclude.notifications","excludeItems":["com.ibm.bi.share.notifications"],"comment": "Mit EXCLUDEITEMS wird die Benachrichtigungsschaltfläche von der

Navigationsleiste der Perspektive HOME entfernt.","comment": "EXCLUDEITEMS muss auf der Ebene der einzelnen Perspektive angewendet werden.

Die globale Anwendung über die Perspektive COMMON ist nicht möglich."}]}]}

Informationen zur Bestimmung der ID, die in den Werten für das ElementexcludeItems zu verwenden ist, finden Sie in „Bestimmen der ID einesBenutzerschnittstellenobjekts” auf Seite 101.

Hinzufügen von Dashboardformen

Sie können benutzerdefinierte Formen zur Verwendung in Dashboards erstellen.

Mithilfe des Beispiels SampleExtensionCustomShape.zip werden drei neue Formenzur Verwendung in Dashboards erstellt. Dieses Beispiel wird wie jede andere Er-weiterung installiert. Nach der Installation werden die folgenden drei neuen For-men in der Anzeige Formen angezeigt.

Anmerkung: Nur .svg-Dateien können als Dashboardformen verwendet werden.

Der Inhalt der Datei spec.json ist nachfolgend dargestellt.{"name":"Sample_Custom_Shape","comment":"Mit diesem Beispiel werden 3 benutzerdefinierte Bilder zum unteren Bereich des Fensters in Dashboarding hinzugefügt.","schemaVersion": "2.0","extensions": [{"perspective": "dashboard","comment": "Die benutzerdefinierten Formen sind nur für die Dashboardperspektive anwendbar.","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"

}}]}]}]}

Die benutzerdefinierten Formen sind im Ordner images des Beispiels enthalten.

Erstellen einer Bildergalerie

Sie können eine Bildergalerie erstellen, die benutzerdefinierte Bilder für die Ver-wendung in Dashboards und Berichten enthalten.

Mit den Beispielen in SampleExtensionCustomMedia.zip undSampleExtensionCustomMediaAll.zip werden neue Bilder für die Verwendung inDashboards und Berichten erstellt. Diese Beispiele werden wie jede andere Erweite-rung installiert.

Nachdem Sie die Bildergalerie erstellt haben, können Benutzer die Bilder wie folgtauswählen:v Dashboardautoren können die Registerkarte Bildbibliothek im Fenster Widgets

auswählen. Weitere Informationen finden Sie im Benutzerhandbuch zu Dashboardsund Storys.

v Berichtsersteller können das Toolbox-Symbol

und dann Layout auswählen,

das Bildobjekt in den Bericht ziehen und anschließend doppelklicken. Wei-tere Informationen finden Sie im Reporting-Handbuch.

Die in der Bildbibliothek verfügbaren Bilder haben die folgenden Beschreibungen:v Blitze über einer Stadt bei Nachtv Blitze an einem dunkelvioletten Himmelv Starker Verkehr in einer Stadt bei Nachtv Wanderer auf einem Hügel im Waldv Mehrere Zelte auf einem Bergv Graph mit hervorgehobenem steigendem Umsatzv Graph mit steigendem Umsatzv Gruppe von Personen in einem Call-Center


Sample_Custom_Media

Der Inhalt der Datei spec.json für Sample_Custom_Media ist nachfolgend darge-stellt.{

"name": "Sample_Custom_Media","comment":"Mit diesem Beispiel werden benutzerdefinierte Bilder zum unteren Bereich des Fensters MEDIEN in Dashboarding hinzugefügt.","comment":"Derzeit unterstützen wir nur das Hinzufügen von JPG- und PNG-Dateien.","schemaVersion": "1.0","extensions": [{

"perspective": "dashboard","comment": "Die benutzerdefinierten Bilder sind nur für die DASHBOARD-Perspektive vorgesehen.","features": [{

"id": "com.ibm.bi.common.media","comment": "Dies ist die ID für das Fenster MEDIEN. Es ist der Container für die Bilder unten.","collectionItems": [{

"containerId": "com.ibm.bi.common.media","id": "customImage1","name": "Blitze über Stadt",

"comment": "NAME ist der Text der QuickInfo für das Bild.","options": {

"altText": "Blitze über eine Stadt bei Nacht.","comment": "ALTTEXT wird als Eigenschaft für das ausgewählte Bild angezeigt.",

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

}, {"containerId": "com.ibm.bi.common.media","id": "customImage2","name": "Blitze am Himmel","options": {

"altText": "Blitze an einem dunkelvioletten Himmel.","imageLink": "v1/ext/Sample_Custom_Media/images/weather_background3.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage3","name": "Stadtverkehr bei Nacht","options": {

"altText": "Starker Verkehr in einer Stadt bei Nacht.","imageLink": "v1/ext/Sample_Custom_Media/images/story_scene1_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage4","name": "Wanderer auf Hügel","options": {

"altText": "Wanderer auf einem Hügel im Wald.","imageLink": "v1/ext/Sample_Custom_Media/images/login_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage5","name": "Zelte auf Berg","options": {

"altText": "Mehrere Zelte auf einem Berg.","imageLink": "v1/ext/Sample_Custom_Media/images/welcome_background.jpg"}

}, {"containerId": "com.ibm.bi.common.media","id": "customImage6","name": "Hervorgehobener steigender Umsatz","options": {

"altText": "Graph mit hervorgehobenem steigendem Umsatz.","imageLink": "v1/ext/Sample_Custom_Media/images/story_scene5_background2.jpg"}

}, {


"containerId": "com.ibm.bi.common.media","id": "customImage7","name": "Steigender Umsatz","options": {

"altText": "Graph mit steigendem Umsatz.","imageLink": "v1/ext/Sample_Custom_Media/images/story_scene5_background.jpg"}

}]}]

}]}

Sample_Custom_Media_All

Der Inhalt der Datei spec.json für Sample_Custom_Media_All ist nachfolgend dar-gestellt.{

"name": "Sample_Custom_Media_All","comment":"Mit dieser Beispielerweiterung werden 8 benutzerdefinierte Bilder zur Registerkarte BILDBIBLIOTHEK der Anzeige WIDGETS in Dashboarding und Storys hinzugefügt. ,

"comment":"Darüber hinaus werden dieselben 8 benutzerdefinierten Bilder zum Bildauswahldialog unter BILDERGALERIE in der Berichterstellung hinzugefügt. ,"comment":"Zum gegenwärtigen Zeitpunkt werden nur JPG- und PNG-Dateien unterstützt.","comment":"Erweiterungen dieses Typs sind nicht kumulativ. Sie müssen alle benötigten benutzerdefinierten Bilder in einer Erweiterung angeben.","comment":"Andernfalls erhält die zuletzt hochgeladene (nicht aktualisierte) Erweiterung Priorität und wird als endgültige Bildbibliothek verwendet." ,

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

"perspective": "common","comment": "Die benutzerdefinierten Bilder werden für alle Perspektiven angewendet - Berichterstellung, Dashboarding und Storys." ,"features": [{

"id": "com.ibm.bi.common.media","comment": "Dies ist die ID für die Widgetanzeige. Es handelt sich um den Container für die nachfolgenden Bilder.",

"collectionItems": [{"containerId": "com.ibm.bi.common.media","id": "customImage1","name": "Blitze über Stadt",

"comment": "NAME ist der Text der QuickInfo für das Bild auf der Bildbibliotheksregisterkarte.","options": {

"altText": "Blitze über einer Stadt bei Nacht.","comment": "Der alternative Text wird in der Beschreibungseigenschaft für das ausgewählte Bild angezeigt, sobald es in das Dashboard eingefügt wird.",

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

}, {"containerId": "com.ibm.bi.common.media","id": "customImage2","name": "Blitze am Himmel","options": {

"altText": "Blitze an einem dunkelvioletten Himmel.","imageLink": "v1/ext/Sample_Custom_Media_All/images/weather_background3.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage3","name": "Stadtverkehr bei Nacht","options": {

"altText": "Starker Verkehr in einer Stadt bei Nacht.","imageLink": "v1/ext/Sample_Custom_Media_All/images/story_scene1_background.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage4","name": "Wanderer auf Hügel","options": {

"altText": "Wanderer auf einem Hügel im Wald.","imageLink": "v1/ext/Sample_Custom_Media_All/images/login_background.jpg"

}}, {

"containerId": "com.ibm.bi.common.media",


"id": "customImage5","name": "Zelte auf Berg","options": {

"altText": "Mehrere Zelte auf einem Berg.","imageLink": "v1/ext/Sample_Custom_Media_All/images/welcome_background.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage6","name": "Call-Center","options": {

"altText": "Gruppe von Personen in einem Call-Center.","imageLink": "v1/ext/Sample_Custom_Media_All/images/call_center.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage7","name": "Hervorgehobener steigender Umsatz","options": {

"altText": "Graph mit hervorgehobenem steigendem Umsatz.","imageLink": "v1/ext/Sample_Custom_Media_All/images/story_scene5_background2.jpg"

}}, {

"containerId": "com.ibm.bi.common.media","id": "customImage8","name": "Steigender Umsatz","options": {

"altText": "Graph mit steigendem Umsatz.","imageLink": "v1/ext/Sample_Custom_Media_All/images/story_scene5_background.jpg"

}}

]}

]}

]}

Hinzufügen eines Dashboard-Widgets

Sie können benutzerdefinierte Widgets zur Verwendung in Dashboards erstellen.

Sie können benutzerdefinierte Widgets zur Verwendung in Dashboards erstellen.Benutzerdefinierte Widgets werden wie andere Erweiterungen installiert. Die Wid-getaktion wird durch eine JavaScript-Datei bestimmt, die beliebige JavaScript-Akti-onen ausführen und die Ergebnisse im Widget anzeigen kann.

Ein einfaches benutzerdefiniertes Widget enthält eine Datei mit dem Namenspec.json, eine JavaScript-Datei und einen Ordner, der vom Widget verwendeteBilder enthält. Die Datei spec.json ist hier dargestellt.{"name":"SampleWidgetExt_old","schemaVersion": "1.0","extensions": [{"perspective": "dashboard","comment": "Beispiele für benutzerdefinierte Widgets für Dashboards","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"

}}]}]}]}

Mit diesem Widget wird die JavaScript-Datei helloParam.js aufgerufen, die hierdargestellt wird.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;});

Der Ordner images enthält die Abbildung ibm.png.

Nach Installation der Erweiterung wird Benutzern, die ein Dashboard erstellen, ein

neues Symbol angezeigt: Benutzerdefinierte Widgets ( ). Nach dem Anklicken

von Benutzerdefinierte Widgets ( ) können die Benutzer das benutzerdefinierteWidget auf den Erstellungsbereich für Dashboards ziehen. Das benutzerdefinierteWidget ist hier dargestellt.

BeispielerweiterungenDie folgenden Beispiele veranschaulichen die Verwendung von Erweiterungen.

Bei einer einfachen Installation (Easy Install) werden diese Beispieldateien zusam-men mit dem Produkt installiert, bei einer angepassten Installation können Sie als


Option ausgewählt werden. Nach der Produktinstallation finden Sie die Dateien imOrdner Installationsverzeichnis/samples/extensions.

SampleExtensionButtonDashboard.zipEine Erweiterung, mit der eine Schaltfläche zum Öffnen eines Dashboardsin allen Ansichten hinzugefügt wird.

SampleExtensionButtonFolder.zipEine Erweiterung, mit der eine Schaltfläche zum Öffnen eines Ordners inallen Ansichten hinzugefügt wird.

SampleExtensionButtonOpenPerspective.zipEine Erweiterung, mit der eine benutzerdefinierte Ansicht erstellt und eine

Schaltfläche ( ) zum Öffnen der benutzerdefinierten Ansicht zur Navi-gationsleiste aller Ansichten hinzugefügt wird.

SampleExtensionButtonReport.zipEine Erweiterung, mit der eine Schaltfläche zum Öffnen eines Berichts inallen Ansichten hinzugefügt wird.

SampleExtensionButtonWebsite.zipEine Erweiterung, mit der eine Schaltfläche zum Öffnen einer Website inallen Ansichten hinzugefügt wird.

SampleExtensionContextMenuItem.zip

Eine Erweiterung, mit der ein Menüelement ( ) zum Popup-Menü füralle Berichtsobjekte hinzugefügt wird. Wenn das Menüelement ausgewähltwird, öffnet es einen Alert, der Informationen zum Bericht anzeigt.

SampleExtensionCustomMedia.zipEine Erweiterung, mit der in Dashboards verwendbare benutzerdefinierteBilder hinzugefügt werden.

SampleExtensionCustomMediaAll.zipEine Erweiterung, mit der sowohl in Dashboards als auch in Berichten ver-wendbare benutzerdefinierte Bilder hinzugefügt werden.

SampleExtensionCustomShape.zipEine Erweiterung, mit der in Dashboards verwendbare benutzerdefinierteFormen hinzugefügt werden.

SampleExtensionExcludeDelete.zipEine Erweiterung, mit der die Schaltfläche Löschen von allen Objekten inallen Ansichten entfernt wird.

SampleExtensionExcludeNotifications.zipEine Erweiterung, mit der die Schaltfläche Benachrichtigungen von allenAnsichten entfernt wird.

SampleExtensionMenuQuicklinks.zipEine Erweiterung, mit der ein Menü zu allen Ansichten hinzugefügt wird.

SampleExtensionMenuUrlLinks.zipEine Erweiterung, die veranschaulicht, wie ein Menü zur App-Leiste hin-zugefügt wird, das 2 Menüelemente zum Öffnen externer URLs enthält.

SampleExtensionOpenFolderShowHideParent.zipEine Erweiterung, die die Verwendung der Option skipAncestors beimÖffnen eines Ordners zeigt.

SampleExtensionsAll.zipIn dieser Erweiterung sind die Erweiterungen SampleExtensionButtonDash-


board.zip, SampleExtensionButtonFolder.zip, SampleExtensionButtonWeb-site.zip, SampleExtensionButtonReport.zip, SampleExtensionContextMenu-Item.zip, SampleExtensionExcludeDelete.zip,SampleExtensionMenuQuicklinks.zip undSampleExtensionExcludeNotifications.zip kombiniert.

SampleExtensionTabs.zipEine Erweiterung, mit der eine Gruppe Registerkarten, die schnellen Zu-griff auf bestimmte Berichte und Dashboards bieten, zur Startansicht hin-zugefügt wird.

Verwenden der Erweiterung für die Registerkartensammlung

Diese Aufgabe enthält eine Beschreibung der Installation und Verwendung der Er-weiterung für die Registerkartensammlung.


Die Erweiterung für die Registerkartensammlung emuliert die in älteren Versionenvon IBM Cognos Business Intelligence verfügbaren Portalseiten. Mit dieser Erwei-terung werden drei Schaltflächen wie hier gezeigt zur Navigationsleiste hinzuge-fügt.

Jede Schaltfläche entspricht einer Registerkarte auf einer Portalseite. Klicken Sie aufdie Schaltfläche Übersicht, um einen Unterordner anzuzeigen, der zwei Elementeenthält: das Dashboard Produktreihe je Jahr und den Bericht Absatzmenge. DerUnterordner ist äquivalent zu einer untergeordneten Registerkarte auf einer Portal-seite.

Klicken Sie auf die Schaltfläche Einnahmen, um einen Unterordner anzuzeigen,der drei Elemente enthält: das Dashboard Nach Jahr, den Ordner Nach Quartalmit vier Berichten und den Bericht Quartal bisher.


Klicken Sie auf die Schaltfläche Einzelhändler, um ein Dashboard zu öffnen.

Vorgehensweise

Laden Sie das Bereitstellungsarchiv Samples_for_Install hoch. (Falls dies bereitsgeschehen ist, können Sie diesen Schritt überspringen.)1. Öffnen Sie IBM Cognos Administration über Verwalten > Administrations-

konsole.2. Klicken Sie auf der Registerkarte Konfiguration auf Inhaltsadministration.3. Klicken Sie in der Symbolleiste auf die Schaltfläche Neuer Import.4. Wählen Sie im ersten Schritt des Assistenten Neuer Import die Option Samp-

les_for_Install aus und führen Sie die verbleibenden Schritte im Assistentenaus.

Laden Sie die Beispielerweiterung SampleExtensionTabs.zip hoch.5. Wählen Sie im Slideout-Fenster Verwalten > Anpassungen die Registerkarte

Erweiterungen aus, klicken Sie auf Erweiterung hochladen ( ), navigierenSie zum Ordner <Installationsverzeichnis>/samples/extensions und wählenSie SampleExtensionTabs.zip aus.

Ergebnisse

Sie können diese Erweiterung jetzt verwenden.

Erstellen von AnsichtenDie Benutzerschnittstelle von IBM Cognos Analytics besteht aus Ansichten. Dazugehören beispielsweise die Startansicht, die Anmeldeansicht, die Authoring-An-sicht, die Dashboardansicht und die Modellierungsansicht. Sie können benutzerde-finierte Ansichten erstellen und damit die integrierten Ansichten erweitern.

Ansichten sind in einer Datei mit dem Namen spec.json definiert, die sich imStammverzeichnis der ZIP-Datei für die Ansicht befindet. Benutzerdefinierte An-sichten enthalten auch das HTML-Element div, durch das das zentrale Fenster derBenutzerschnittstelle von Cognos Analytics ersetzt wird. Darüber hinaus könnenbenutzerdefinierte Ansichten dazu verwendet werden, Menüs und Schaltflächenzur Anwendungsleiste und zur Navigationsleiste hinzuzufügen bzw. von diesen zuentfernen oder die Anwendungsleiste und/oder die Navigationsleiste selbst zu ent-fernen. Struktur und Inhalt der Datei spec.json sind in „Beschreibung der Dateispec.json” auf Seite 93 beschrieben. Die allgemeine Struktur der Datei ist hier dar-gestellt.{"name": "<Name>","schemaVersion": "2.0","extensions": [{"perspective":"<Ansichtsname>","type":"<Start- oder Anmeldeansicht>","features": [{


"id": "<ID>","toolItems": [<Toolelement1>,<Toolelement2>,...],"collectionItems": [<Gruppenelement1>,<Gruppenelement2>,...],"excludeFeatures": [<auszuschließendes Feature1>,<auszuschließendes Feature2>,...],"excludeItems": [<auszuschließendes Element1>,<auszuschließendes Element2>,...]"content": {"type":"<Pfad der JavaScript-Datei>","options": {...}

}},"cssStyles": ["<Pfad der CSS-Datei>"]

}]}]}

Ansichten sind als Erweiterungen gepackt und die ZIP-Datei einer Ansicht kannauch Erweiterungselemente enthalten. So wird mit BeispielSampleExtensionButtonOpenPerspective.zip z. B. eine benutzerdefinierte Ansichtdefiniert und darüber hinaus eine Schaltfläche zur Navigationsleiste der Startan-sicht hinzugefügt, über die die benutzerdefinierte Ansicht aufgerufen wird.

Das Element content enthält den Pfad und den Namen der JavaScript-Datei, diezur Erstellung der benutzerdefinierten Ansicht ausgeführt wird. Das Elementoptions enthält alle Optionen, die für die JavaScript-Datei erforderlich sind. DieJavaScript-Dateien nutzen die AMD-API (Asynchronous Module Definition).

Bei einer Anmeldeansicht handelt es sich um einen speziellen Ansichtstyp. DieserAnsichtstyp ermöglicht es Ihnen, eine benutzerdefinierte Anmeldeseite für CognosAnalytics zu erstellen. Der Wert des Elements type bestimmt, ob es sich bei einerAnsicht um eine Anmeldeansicht (der Wert ist login) handelt oder nicht (der Wertist home).

Im Gegensatz zu Erweiterungen müssen Ansichten explizit aufgerufen werden, da-mit sie geöffnet werden. Es gibt drei Möglichkeiten, eine Ansicht aufzurufen.v Zum Öffnen der Ansicht kann eine Schaltfläche oder ein Menüelement definiert

werden.v Die Ansicht kann über eine URL wie folgt geöffnet werden.

http://<Server>:<Port>/bi/?perspective=<Ansichtsname>

v Die Ansicht kann als Standardstartansicht für einen Benutzer, für eine Rolle oderfür alle Benutzer festgelegt werden. Weitere Informationen finden Sie in „Ver-walten von Motiven, Erweiterungen, Ansichten und Parameter” auf Seite 91.

Erstellen einer Ansicht (mit Ausnahme von Anmeldeansichten)Das Beispiel SampleWelcome.zip ist ein Beispiel für eine Ansicht, die die integrierteStartansicht durch eine alternative Version ersetzt, die das Branding für die Bei-spielfirma für Outdoor-Ausrüstung enthält.

Das Beispiel SampleWelcome.zip enthält eine spec.json-Datei zur Definition derAnsicht. Diese Datei ist hier dargestellt.{

"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"]

}]}]

}

Die Ansicht wird in den Anpassungsverwaltungsanzeigen als Sample welcome be-zeichnet. Die Datei spec.json ist über einen Link mit der DateiSampleWelcomeView.js im Unterordner js/views der Ansicht verknüpft. Der Ein-trag "type":"home" gibt an, dass diese Ansicht als Standardstartansicht festgelegtwerden kann. Das Element cssStyles definiert die CSS-Datei, die bei der Anzeigeder Ansicht verwendet wird.

Die Datei SampleWelcomeView.js ist hier dargestellt./*** 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(){

/*** Wird bei jeder Erstellung dieser Ansicht von AppController aufgerufen.** @public* @returns {Promise} - Promise, das in das DOM-Stammelement für diese Ansicht aufgelöst wird.*/

this.open = function(context, options) {this.logger = context.logger;this.options = options;var deferred = Q.defer();


promise open(content. options)Diese Methode wird beim Öffnen der Ansicht aufgerufen. Sie gibt ein Qpromise-Objekt zurück, wobei das DOM-Element, das die Ansicht darstellt,der aufgelöste Wert ist.

contextEnthält das Kontextobjekt.

optionsEnthält die Optionen, die in der Datei spec.json enthalten sind.

void close()Wird unmittelbar vor dem Schließen der Ansicht aufgerufen.

void onShow()Wird unmittelbar vor dem Anzeigen der Ansicht aufgerufen.

void onHide()Wird unmittelbar vor dem Ausblenden der Ansicht aufgerufen.

getDisplayInfo()Gibt den Titel und das zugehörige Symbol der Ansicht zurück.

Erstellen einer AnmeldeansichtMit einer benutzerdefinierten Anmeldeansicht können Sie die Standardanmeldesei-te von IBM Cognos Analytics ersetzen. Sie können ein eigenes Branding verwen-den und weitere Änderungen an der Anmeldeseite vornehmen.

Nachfolgend finden Sie einen allgemeinen Überblick über die Struktur des Ja-vaScript-Codes, der zum Durchführen einer Anmeldung erforderlich ist.

Das Beispiel SampleLogin.zip enthält eine Beispielansicht, mit der die integrierteAnmeldeansicht durch eine alternative Version ersetzt wird. Das BeispielSampleWelcome.zip enthält eine spec.json-Datei zur Definition der Ansicht. DieseDatei ist hier dargestellt.{"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"]}]}]}

Diese spec.json-Datei ähnelt der Datei mit demselben Namen im Beispiel Sample-Welcome.zip; der Unterschied besteht darin, dass das Element type den Wert loginaufweist und diese Ansicht keine Anwendungs- und Navigationsleiste enthält.



/*** @typedef {Object} LoginError* @property {string} message - Fehlernachricht*//*** performs a login** @public* @param {Object[]} loginPrompts - Objekt, das den Anmeldedialog enthält* @param {string} loginPrompts[].name - Name des Anmeldedialogs* @param {string} loginPrompts[].value - Wert des Anmeldedialogs* @return {Promise<undefined|LoginError} Promise ohne Objekt aufgelöst, wenn* die Anmeldung erfolgreich ist; wenn die Anmeldung fehlschlägt, wird das Promise mit einem Fehler abgelehnt.**/signin: function(loginPrompts)

Die Datei SampleLoginView.js ist hier dargestellt./*** 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(){

/*** Wird bei jeder Erstellung dieser Ansicht von AppController aufgerufen.** @public* @returns {Promise} - Promise, das in das DOM-Stammelement für diese Ansicht aufgelöst wird.*/

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;},

/*** Wird bei jedem Löschen dieser Ansicht von AppController aufgerufen.** @public*/

this.close = function() {this.logger.info(’close’);

},

/*** Wird bei jeder Anzeige dieser Ansicht von AppController aufgerufen.** @public*/

this.onShow = function() {this.logger.info(’onShow’);

},

/**** Der nachfolgend dargestellte Live-Code ruft die Fehlernachricht des Produkts ab.* Wenn Sie eine eigene Fehlernachricht verwenden möchten, verwenden Sie* stattdessen den folgenden Kommentarcode:** this._loginError = function() {* document.getElementsByClassName(’sampleIncorrectLoginText’)[0].innerHTML=* ’You have entered an invalid username/password combination.’;* this.logger.error(’loginError’,arguments);* },***/

this._loginError = function(error) {document.getElementsByClassName(’sampleIncorrectLoginText’)[0].innerHTML=error.message;this.logger.error(’loginError’,arguments);

},

/*** Wird bei jedem Ausblenden dieser Ansicht von AppController aufgerufen.** @public*/

this.onHide = function() {this.logger.info(’onHide’);

},

/*** Wird von AppController aufgerufen, wenn Anzeigeinformationen für diese Ansicht erforderlich sind.** @public* @returns {Object} displayInfo - displayInfo für diese Ansicht* @returns {string} displayInfo.title - Titel* @returns {string} displayInfo.icon - Symbol*/

this.getDisplayInfo = function() {this.logger.info(’getDisplayInfo’);return {’title’:this.options.info.title,’icon’: this.options.info.icon

};}

};


return ContentView;

});

Bei einer Anmeldeansicht wird eine zusätzliche Methode verwendet.

promise login(credentials)Mit dieser Methode wird eine Anmeldeanforderung übergeben und einpromise-Objekt zurückgegeben, das zurückgewiesen wird, falls der Anmel-deversuch fehlschlägt.

credentialsEnthält die Anmeldeinformationen.[{name:’CAMNamespace’,value:’<Namespace>’},{name:’h_CAM_action’,value:’logonAs’},{name:’CAMUsername’,value:<Benutzername>},{name:’CAMPassword’,value:<Kennwort>}]

Anmeldeansicht mit einer Namespace-Eingabeaufforderungerstellen

Mit einer benutzerdefinierten Anmeldeansicht mit Namespace-Eingabeaufforde-rung können Sie die Standardanmeldeseite von IBM Cognos Analytics ersetzen. Siekönnen angeben, dass der Benutzer aus einer Liste von Namespaces auswählenmuss, wenn er sich anmeldet. Sie können auch ein eigenes Branding verwendenund weitere Änderungen an der Anmeldeseite vornehmen.


Das Beispiel SampleLoginMultiple.zip enthält eine Beispielansicht, mit der die in-tegrierte Anmeldeansicht durch eine alternative Version ersetzt wird. Das BeispielSampleLoginMultiple.zip enthält eine spec.json-Datei zur Definition der Ansicht.Diese Datei ist hier dargestellt.{"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"]}]}]}

Diese spec.json-Datei ähnelt derselben Datei für das Beispiel SampleLogin.zip in-sofern, als diese Ansicht keine Anwendungs- und Navigationsleiste enthält.


BeispielansichtenDie folgenden Beispiele veranschaulichen die Verwendung von Ansichten.

Bei einer einfachen Installation (Easy Install) werden diese Beispieldateien zusam-men mit dem Produkt installiert, bei einer angepassten Installation können Sie alsOption ausgewählt werden. Nach der Produktinstallation finden Sie die Dateien imOrdner Installationsverzeichnis/samples/extensions.

SampleLogin.zipEine Ansicht, die die Cognos Analytics-Anmeldeseite ersetzt.

SampleLoginMultiple.zipEine Ansicht als Ersatz für die Cognos Analytics-Anmeldeseite, die den Be-nutzer zur Angabe eines Namespace auffordert.

SampleWelcome.zipEine Ansicht, die die Cognos Analytics-Eingangsseite ersetzt.

Verwenden der benutzerdefinierten EingangsansichtDiese Aufgabe enthält eine Beschreibung der Installation und Verwendung der be-nutzerdefinierten Eingangsansicht.

Vorgehensweise

Laden Sie das Bereitstellungsarchiv Samples_for_Install hoch. (Falls dies bereitsgeschehen ist, können Sie diesen Schritt überspringen.)1. Öffnen Sie IBM Cognos Administration über Verwalten > Administrations-

konsole.2. Klicken Sie auf der Registerkarte Konfiguration auf Inhaltsadministration.3. Klicken Sie in der Symbolleiste auf die Schaltfläche Neuer Import.4. Wählen Sie im ersten Schritt des Assistenten Neuer Import die Option Samp-

les_for_Install aus und führen Sie die verbleibenden Schritte im Assistentenaus.

Laden Sie die Beispielerweiterungen hoch.5. Wählen Sie im Slideout-Fenster Verwalten > Anpassungen die Registerkarte

Erweiterungen aus, klicken Sie auf Erweiterung hochladen ( ), navigierenSie zum Ordner <Installationsverzeichnis>/samples/extensions und wählenSie SampleWelcome.zip aus.

6. Wiederholen Sie den vorherigen Schritt für SampleExtensionsAll.zip.7. Geben Sie im Web-Browser <Name des Web-Servers>:<Portnummer>/bi/

?perspective=sampleWelcome ein, um die benutzerdefinierte Eingangsansichtaufzurufen.

Ergebnisse

Die benutzerdefinierte Eingangsansicht ist hier dargestellt. Sie enthält ein neuesMenü (Quick Links) in der Anwendungsleiste und neue Schaltflächen in der Navi-gationsleiste (Dashboard für Produktreihe, Einnahmen Quartal bisher, 2016 Be-richte und Website). Die Schaltfläche Benachrichtigungen in der Navigationsleistewird entfernt. Die Hauptanzeige enthält ein neues Bild, neuen Text und einen Linkzu einem Video.


Verwenden der benutzerdefinierten AnmeldeansichtDiese Aufgabe enthält eine Beschreibung der Installation und Verwendung der be-nutzerdefinierten Anmeldeansicht.

Vorgehensweise1. Extrahieren Sie die Dateien in SampleLogin.zip.2. Öffnen Sie login/js/views/SampleLoginView.js zur Bearbeitung und suchen

Sie die Zeile, die die Angabe {name:’CAMNamespace’,value:’CognosEx’} enthält.3. Ersetzen Sie CognosEx durch den Namen eines Ihrer Authentifizierungsname-

spaces (wie in IBM Cognos Configuration definiert).4. Speichern Sie SampleLoginView.js und erstellen Sie die .zip-Datei neu.5. Wählen Sie im Slideout-Fenster Verwalten > Anpassungen die Registerkarte

Erweiterungen aus, klicken Sie auf Erweiterung hochladen ( ), navigierenSie zum Ordner <Installationsverzeichnis>/samples/extensions und wählenSie SampleLogin.zip aus.

6. Klicken Sie auf der Registerkarte Ansichten neben der Standardanmeldeansicht

auf . Wählen Sie die Ansicht Beispielanmeldung als die Standardansicht fürdie Anmeldung.

7. Melden Sie sich von IBM Cognos Analytics ab.8. Greifen Sie auf den Cognos Analytics-Server zu.

Ergebnisse

Die benutzerdefinierte Anmeldeansicht ist hier dargestellt. Sie verfügt über einenbenutzerdefinierten Hintergrund und neuen Text im Anmeldedialogfeld.


Verwalten von Motiven, Erweiterungen, Ansichten und ParameterVerwalten Sie Motive, Erweiterungen, Ansichten und Parameter mit dem Slideout-Fenster Verwaltung > Anpassung. Sie können Motive, Erweiterungen, Ansichtenund Parameter hochladen, löschen und ändern. Darüber hinaus können Sie einStandardmotiv für alle Benutzer sowie eine Standardstartansicht und eine Standar-danmeldeansicht festlegen.

Das Slideout-Fenster Verwaltung > Anpassung enthält vier Registerkarten Motive,Erweiterungen, Ansichten und Parameter. Motive werden auf der RegisterkarteMotive hochgeladen, Erweiterungen und Ansichten auf der Registerkarte Erweite-rungen.

Hochladen von Motiven

Zum Hochladen eines Motivs klicken Sie auf der Registerkarte Motive auf Motiv

hochladen ( ) und navigieren Sie im Dateisystem zum gewünschten Motiv. DasMotiv wird hochgeladen und validiert. Wenn das Motiv ungültig ist, wird eineFehlernachricht angezeigt. Andernfalls wird das Motiv zur Liste der verfügbaren

Motive hinzugefügt. Sie können auf Mehr ( ) neben einem Motiv klicken, umdas Motiv zu aktualisieren, herunterzuladen oder zu löschen.

Tipp: Wenn Sie ein Motiv für eine verteilte Umgebung anwenden, müssen Siemindestens 5 Minuten warten, bis die Änderung wirksam wird.



Sie können ein Motiv auswählen, das als Standardmotiv für alle Benutzer verwen-det werden soll. Wählen Sie auf der Registerkarte Motive des Slideout-FenstersVerwaltung > Anpassung das Kontrollkästchen neben einem Motiv aus und kli-cken Sie dann auf Anwenden.

Über das Slideout-Fenster Verwalten > Konten können Sie auch Standardmotivefür Rollen festlegen. Wenn einem Benutzer eine Rolle mit einem Standardmotiv zu-gewiesen ist, wird dieses Motiv anstelle des für alle Benutzer ausgewählten Motivsverwendet. Weitere Informationen finden Sie in „Anpassen von Rollen” auf Seite 6.

Hochladen von Erweiterungen und Ansichten

Zum Hochladen einer Erweiterung oder einer Ansicht klicken Sie auf der Register-

karte Erweiterungen auf Erweiterung hochladen ( ) und navigieren Sie imDateisystem zur gewünschten Erweiterung bzw. Ansicht. Die Erweiterung oderAnsicht wird hochgeladen und validiert. Wenn die Erweiterung ungültig ist, wirdeine Fehlernachricht angezeigt. Andernfalls wird die Erweiterung zur Liste der

hochgeladenen Erweiterungen hinzugefügt. Sie können auf Mehr ( ) neben einerErweiterung oder Ansicht klicken, um die Erweiterung bzw. Ansicht zu aktualisie-ren, herunterzuladen oder zu löschen.

Festlegen einer Standardstartansicht

Klicken Sie auf der Registerkarte Ansichten des Slideout-Fensters Verwaltung >

Anpassung auf

neben der Standardstartansicht. Nun können Sie nach einemDashboard oder Bericht suchen, das bzw. der als Standardstartansicht verwendetwerden soll, oder Sie können eine Ansicht in der Liste der Startansichten auswäh-len, die als Standardstartansicht für alle Benutzer verwendet werden soll.

Über das Slideout-Fenster Verwalten > Konten können Sie auch Standardstartan-sichten für Rollen festlegen. Wenn einem Benutzer eine Rolle mit einer Standard-startansicht zugewiesen ist, wird diese Ansicht anstelle der für alle Benutzer ausge-wählten Startansicht verwendet. Weitere Informationen finden Sie in „Anpassenvon Rollen” auf Seite 6.

Ein Benutzer kann auch eine persönliche Standardstartansicht von einer beliebigenAnsicht aus auswählen. In einer beliebigen Ansicht kann ein Benutzer auf Mehr (

) und anschließend auf Als Startansicht festlegen klicken, um eine persönlicheStandardstartansicht zu definieren. Diese Standardstartansicht hat Vorrang gegen-über den Standardstartansichten, die für Rollen oder für alle Benutzer erstellt wur-den.

Festlegen einer Standardanmeldeansicht

Klicken Sie auf der Registerkarte Ansichten des Slideout-Fensters Verwaltung >

Anpassung auf

neben der Standardanmeldeansicht. Nun können Sie eine An-sicht in der Liste der Anmeldeansichten auswählen, die als Standardanmeldean-sicht für alle Benutzer verwendet werden soll.


Parameter festlegen, die in verschiedenen Berichten verwendetwerden können

Klicken Sie auf die Registerkarte Parameter des Slideout-Fensters Verwaltung >Anpassung.v Um Parameter von vorhandenen Berichten verwenden, klicken Sie auf Importie-

ren und navigieren Sie zu einem Bericht, von dem Sie wissen, dass er Parameterenthält. Wählen Sie einen Parameter zur Anpassung aus und klicken Sie aufWerte festlegen. Wählen Sie den gewünschten Wert als Standardwert aus.

v Zum Erstellen eines neuen Parameters klicken Sie auf Neu und geben Sie einen

Parameternamen ein. Klicken Sie auf Mehr ( ) und anschließend auf Eigen-schaften. Klicken Sie im Abschnitt Benutzerdefinierte Werte auf Werte fest-legen. Für jeden Parameterwert klicken Sie auf Neu und geben Sie einen Wertein.

Über das Slideout-Fenster Verwalten > Konten können Sie auch Standardbe-richtsparameter für Rollen festlegen. Wenn ein Benutzer über eine Rolle mit benut-zerdefinierten Parametern verfügt und mit diesen Parametern einen Bericht aus-führt, werden ihm die von Ihnen festgelegten Standardwerte angezeigt. WeitereInformationen finden Sie in „Anpassen von Rollen” auf Seite 6.

Ausführen von Cognos Analytics mit inaktivierten Erweiterun-gen und Ansichten

Wenn eine hochgeladene Erweiterung oder Ansicht Fehler enthält, kann dies dazuführen, dass IBM Cognos Analytics nicht mehr verwendet werden kann. In diesemFall können Sie Cognos Analytics mit inaktivierten benutzerdefinierten Erweiterun-gen und Ansichten ausführen.

Vorgehensweise

Starten Sie Cognos Analytics, indem Sie die URL <Name des Web-Servers>:<Portnummer>/bi/?factoryMode=true eingeben.

Ergebnisse

Beim Start von Cognos Analytics sind alle Erweiterungen inaktiviert. Sie könnennun die benutzerdefinierten Erweiterungen oder Ansichten korrigieren oder lö-schen und anschließend mit der Standard-URL einen Neustart von Cognos Analy-tics durchführen.

Beschreibung der Datei spec.jsonDie Datei spec.json in einer Erweiterung definiert die Elemente, die durch die Er-weiterung zur IBM Cognos Analytics-Standardbenutzerschnittstelle hinzugefügtbzw. aus dieser entfernt werden. Die Struktur und die Inhalte dieser Datei werdenim Folgenden erläutert.

Die Struktur und die Inhalte, die hier beschrieben werden, weisen einen vorläufi-gen Status auf. Sie werden möglicherweise in zukünftigen Releases von CognosAnalytics geändert. Diese Änderungen sind möglicherweise nicht abwärtskompati-bel.

name Gibt den Namen der Erweiterung an. Der Name kann alphanumerischeZeichen, Unterstreichungszeichen (_) und Leerzeichen ( ) enthalten.


schemaVersionGibt einen numerischen Wert für die Schemaversion an. Der Wert kann 1.0oder 2.0 lauten. Der Standardwert lautet 1.0.

extensionsEnthält ein Array von Objekten des Typs perspective.

perspectiveGibt die Ansicht an, die erweitert wird. Die Optionen sind nachfol-gend aufgeführt.

common Wird für alle Ansichten angewendet.

<Ansichtsname>Wird für die Ansicht <Ansichtsname> angewendet. Hierbeikann es sich um eine integrierte Ansicht (home, authoring,dashboard oder modeller) oder um eine hochgeladene An-sicht handeln.

type Gibt den Typ an, wenn es sich bei der Erweiterung um eine An-sicht handelt. Die möglichen Werte sind login für eine Anmeldean-sicht und home für eine Startansicht. Dieses Element wird nur inder Schemaversion 2.0 verwendet. Wenn dieses Element weggelas-sen wird und die Schemaversion 2.0 angegeben ist, wird die An-sicht nicht in der Liste möglicher Standardstartansichten oder Stan-dardanmeldeansichten aufgeführt.

lensableBei der Angabe false wird diese Ansicht nicht in der Liste der An-sichten aufgeführt, für die Features weggelassen werden können.Weitere Informationen finden Sie in „Anpassen von Rollen” aufSeite 6.

Der Standardwert lautet true.

commentOptionaler Kommentar.

featuresEnthält ein Array mit Featuregruppierungen.

id Gibt die eindeutige ID des Features an.

toolItemsEnthält ein Array mit Benutzerschnittstellenelementen, diehinzugefügt werden.

id Die eindeutige ID für das neue Benutzerschnittstel-lenelement.

containerIdGibt die Position des Benutzerschnittstellenele-ments an.v Wenn es sich bei dem Benutzerschnittstellenele-

ment um ein Menü oder eine Schaltfläche han-delt, befindet sich das Element in der Anwen-dungs- oder Navigationsleiste, wie in derfolgenden Abbildung dargestellt.


Die Werte für containerId, die der Positionie-rung der Schaltfläche oder des Menüs entspre-chen, werden in der folgenden Liste angezeigt.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 Wenn es sich bei dem Benutzerschnittstellenele-ment um ein Menüelement handelt, ist der Wertfür containerId die id des Menüs, das dasMenüelement enthält. Informationen zur Bestim-mung einer id finden Sie in „Bestimmen der IDeines Benutzerschnittstellenobjekts” auf Seite 101.

label Gibt die Textbeschriftung für das Benutzerschnitt-stellenelement an. Dieser Text kann nicht lokalisiertwerden.

type Gibt den Typ des Benutzerschnittstellenelementsan. Die möglichen Werte sind nachfolgend aufge-führt.v Button

v Menu

v MenuItem

icon Gibt das Bild an, das für das Benutzerschnittstel-lenelement angezeigt werden soll. Die Pfadangabeist relativ zu der Bilddatei im ZIP-Archiv der Er-weiterung.

weight Gibt einen numerischen Wert an, der die Positiondes Benutzerschnittstellenelements im Containerbestimmt. Durch einen höheren Wert wird das Ele-ment im Container nach oben verschoben.

push Gibt an, ob die Aktion der ersten Auswahl bei er-neutem Auswählen derselben Schaltfläche rückgän-gig gemacht wird. Beispiel: das Öffnen und an-schließende Schließen eines Ordners. Der Wertkann true oder false sein. Für eine Schaltflächezum Öffnen eines Ordners muss der Wert truesein.


coachMarkGibt eine Coachmarkierung an.

title Gibt den Titel der Coachmarkierung an.

contentsGibt die Inhalte der Coachmarkierung an.

actionControllerGibt die Aktion an, die ausgeführt werden soll,wenn auf das Benutzerschnittstellenelement ge-klickt wird. Die verfügbaren Aktionen sind hieraufgeführt.

bi/glass/api/IFrameOpenerÖffnet eine Webseite.

bi/glass/api/ReportOpenerÖffnet einen bestimmten Bericht.

bi/glass/api/DashboardOpenerÖffnet ein bestimmtes Dashboard.

bi/glass/api/FolderOpenerÖffnet einen bestimmten Ordner.

v1/ext/<Name>/js/controllers/ControllernameFührt den im Erweiterungspackage enthal-tenen benutzerdefinierten Controller aus.Beim Controller handelt es sich um die Da-tei js/controllers/Controllername.js.

optionsEnthält ein Array mit Optionen, die an den Akti-onscontroller übergeben werden sollen. Die verfüg-baren Option hängen vom verwendeten Aktions-controller ab. Informationen zu den von denintegrierten Aktionscontrollern verwendeten Optio-nen finden Sie in „Verwenden integrierterAktionscontroller” auf Seite 67.

collectionItemsEnthält ein Array mit Benutzerschnittstellenelementen, diehinzugefügt werden.

containerIdGibt an, wo das Benutzerschnittstellenelement lo-kalisiert ist.

id Gibt die eindeutige ID des Benutzerschnittstellen-elements an.

contentEnthält Definitionen für eine Ansicht.

type Enthält einen Link zu der JavaScript-Datei, die aus-geführt werden soll, wenn diese Ansicht aufgeru-fen wird.

optionsEnthält Parameter, die an die JavaScript-Datei über-geben werden sollen.


cssStylesEnthält ein Array mit Links zu .css-Dateien, die für dieseAnsicht verwendet werden sollen.

excludeFeaturesEnthält ein Array mit IDs der Benutzerschnittstellenfea-tures, die ausgeschlossen werden sollen. Dieses Featurekann für die Ansicht common nicht angewendet werden.

Informationen zur Bestimmung einer id finden Sie in „Be-stimmen der ID eines Benutzerschnittstellenobjekts” aufSeite 101.

excludeItemsEnthält ein Array mit IDs der Benutzerschnittstellenele-menten, die ausgeschlossen werden sollen. Dieses Featurekann für die Ansicht common nicht angewendet werden.

Informationen zur Bestimmung einer id finden Sie in „Be-stimmen der ID eines Benutzerschnittstellenobjekts” aufSeite 101.

JSON-SchemaprüfungWenn Sie eine Datei spec.json hochladen, wird sie anhand des folgenden Schemasgeprüft.{

"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": {


"$ref": "#/definitions/noEmptyString"},"excludeItems": {


"$ref": "#/definitions/noEmptyString"}

},"excludeFeatures": {


"$ref": "#/definitions/noEmptyString"}

},"toolItems": {


"$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"

]}

Bestimmen der ID eines BenutzerschnittstellenobjektsSie müssen die id eines vorhandenen Benutzerschnittstellenelements bestimmen,wenn Sie Erweiterungen erstellen, die Features oder Elemente ausschließen oderdie Menüelemente zu einem vorhandenen Menü hinzufügen.

Vorgehensweise1. Wenn Sie Cognos Analytics 11.0.7 oder höher ausführen, führen Sie die folgen-

den Schritte aus:a. Öffnen Sie das Fenster für Windows-Dienste und stoppen Sie den Service

IBM Cognos.b. Öffnen Sie die Datei Installationsverzeichnis\wlp\usr\servers\

cognosserver\bootstrap.properties.c. Fügen Sie die folgende Zeile hinzu:

disableXSRFCheck=true

d. Speichern Sie die Datei.e. Starten Sie den Service IBM Cognos erneut.

2. Melden Sie sich bei Ihrem IBM Cognos Analytics-Server an.3. Geben Sie die folgende URL in einem Web-Browser ein: http://

<Servername>:<Port>/bi/v1/perspectives/<Ansicht>. Dabei ist <Ansicht> dieAnsicht (home, authoring, dashboard oder modeller), die das Benutzerschnitt-stellenobjekt enthält. Eine JSON-Datei wird zurückgegeben, die eine Beschrei-bung aller Benutzerschnittstellenelemente in der Ansicht enthält.

4. Suchen Sie nach dem Kurzinfotext für das Benutzerschnittstellenelement. DieAngaben für id und featureId der Benutzerschnittstellenelemente werden nachdem Kurzinfotext angezeigt.

Beispiel

Wenn Sie in der für die Startansicht zurückgegebenen JSON-Datei nach Delete su-chen, wird der folgende Teil der Datei angezeigt.


"label": "Delete","id": "com.ibm.bi.contentApps.deleteAction.DeleteAction","featureId": "com.ibm.bi.contentApps.deleteAction"

Die Werte für id und featureId können in der Erweiterung verwendet werden,um bei Bedarf diese Schaltfläche oder dieses Feature auszuschließen.


Kapitel 9. Aktivieren einer Produktionsumgebung

IBM Cognos-Programme werden unter bestimmten Vertragsbedingungen lizen-ziert. Sie müssen über die entsprechende Berechtigung verfügen, um den Produkti-onsumgebungstyp auswählen zu können.

Zum Verwalten von Systemeinstellungen ist die Administrationsberechtigung Sys-tem konfigurieren und verwalten erforderlich.

Beschränkung bei der nicht produktiven Nutzung

Wenn das IBM Cognos-Programm als "Non-Production" gekennzeichnet ist, kannes nur als Teil der internen Entwicklungs- und Testumgebung des Lizenznehmersfür interne, nicht produktionsbezogene Aktivitäten implementiert werden, ein-schließlich aber nicht abschließend zum Testen, zur Leistungsoptimierung, zur Feh-lerdiagnose, zum internen Benchmarking, zur Bereitstellung, Qualitätssicherungund/oder Entwicklung intern verwendeter Zusätze oder Erweiterungen zum Pro-gramm unter Verwendung veröffentlichter Anwendungsprogrammierschnittstellen.Der Lizenznehmer ist nicht berechtigt, irgendwelche Bestandteile des Programmsfür andere Zwecke zu nutzen, ohne die entsprechenden Produktionsberechtigun-gen zu erwerben.

103

Zu diesem Handbuch

Die vorliegenden Informationen sind für die Verwendung mit den Verwaltungsop-tionen in IBM Cognos Analytics bestimmt.

Suchen von Informationen

Zugriff auf die Produktdokumentation im Web, einschließlich der gesamten über-setzten Dokumentation, besteht über das IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

Funktionen zur behindertengerechten Bedienung

IBM Cognos Analytics verfügt über Funktionen zur behindertengerechten Bedie-nung (Eingabehilfen), die Benutzer mit körperlichen Behinderungen, wie z. B. ein-geschränkter Bewegungsfähigkeit oder Sehkraft, beim Einsatz von Informations-technologieprodukten unterstützen. Die Verfügbarkeit von Funktionen zurbehindertengerechten Bedienung kann sich jedoch ändern, wenn andere Seiten undKomponenten, die keine Eingabehilfen unterstützen, zur Benutzerschnittstelle vonIBM Cognos Analytics hinzugefügt werden.

Die HTML-Dokumentation von IBM Cognos verfügt über Funktionen zur behin-dertengerechten Bedienung. PDF-Dokumente sind ergänzende Dokumente undenthalten demzufolge keine Funktionen zur behindertengerechten Bedienung.

Zukunftsgerichtete Aussagen

In dieser Dokumentation wird die Funktionalität des Produkts zum gegenwärtigenZeitpunkt beschrieben. Möglicherweise finden sich Verweise auf Funktionen, diederzeit nicht verfügbar sind. Dies bedeutet jedoch nicht, dass die betreffendenFunktionen in Zukunft zwangsläufig zur Verfügung stehen werden. Solche Verwei-se stellen keinerlei Verpflichtung, Zusage oder rechtliche Verbindlichkeit dar, Mate-rial, Code oder Funktionen bereitzustellen. Die Entwicklung und Bereitstellung vonFeatures und Funktionen sowie der Zeitpunkt hierfür liegen ausschließlich im Er-messen von IBM.

Haftungsausschluss für Beispiele

Die Beispielfirma für Outdoor-Ausrüstung, das Unternehmen 'Abenteuer und Frei-zeit (AUF)', dessen Vertriebsabteilung, alle Variationen der Namen 'Beispielfirmafür Outdoor-Ausrüstung' und 'Abenteuer und Freizeit' sowie das Planungsbeispielstellen fiktive Geschäftsvorgänge mit Beispieldaten dar, mit denen die Beispielan-wendungen für IBM und IBM Kunden erstellt wurden. Zu diesen fiktiven Daten-sätzen gehören Beispieldaten für Verkaufstransaktionen, Produktvertrieb, Finanz-wesen und Personalwesen. Ähnlichkeiten mit tatsächlichen Namen, Adressen,Kontaktdaten oder Transaktionswerten sind rein zufällig. Andere Beispieldateienkönnen Daten folgender Art enthalten: manuell oder vom System generierte fiktiveDaten, aus wissenschaftlichen oder öffentlichen Quellen zusammengestellte Faktensowie Daten, die mit Zustimmung der Copyrightinhaber als Beispieldaten zur Ent-wicklung von Beispielanwendungen genutzt werden dürfen. Referenzierte Pro-duktnamen können Marken der jeweiligen Rechtsinhaber sein. Nicht autorisiertesKopieren dieser Daten ist unzulässig.

105

http://www.ibm.com/support/knowledgecenter

Index

AAktivitäten

Verwaltung 35Aktuell

Aktivitäten 36Einträge 36

Amazon Athena 27Amazon Redshift 27Anpassen

Cognos Analytics 61Tenants 56

AnpassungRollen 7

Auditprotokollierung 29Ausführungspriorität 39Aussetzen

Einträge 36Authentifizierung

IBMid 10Authentifizierungsprovider 1

Namespaces 8OpenID Connect 10

Azure SQL Data Warehouse 27

BBenutzer

Best Practices für Benutzergruppierungen 1Erstellung in Cognos Analytics 6Verwaltung 6

BereitstellenContent Store 13

BerichterstellungLizenznutzung 41

Bevorstehende Aktivitäten 37Bidirektionale Sprachen 58bootstrap.properties, Datei 32

CCloudera Impala

JDBC-Treiber 21Content Stores

Sicherung 13

DDatenserver 15

Aktualisierungen nach Release 25Cloudera Impala 21Denodo 22Ende der Unterstützung 22Fehlerbehebung für Verbindungen 21Herstellen von Verbindungen 15Pivotal Greenplum und HDB 22Verbindungsparameter 17

DatenserververbindungenMetadaten vorher laden 21

Denodounterstützte Versionen 22

EEinträge

aktuell 36Ausführung abbrechen 36Ausführung aussetzen 36Ausführungspriorität 39bevorstehend 37geplant 38vergangene 36

Eintragsausführung abbrechen 36Ende der Unterstützung

Datenserver 22Externe Namespaces 8

FFehlerbehebung

Datenserververbindungen 21Fehlerbehebung bei Problemen beim Starten des Cognos-Ser-

vice 32

GGruppen

Erstellung 5Verwaltung 5

HHTTP Strict Transport Security 29

IIBM Cognos

Namespace 1IBM Cognos Series 7-Namespace 8IBMid

festlegen 10Inhalt verteilen

Tenantabsender 58Inhaltssprache 58

JJDBC-Treiber

Cloudera Impala 21

KKeine Produktionsumgebung

Umgebungstyp 103

107

LLizenz

Produktion 103Lizenz Produktion

keine Produktionsumgebung 103Umgebungstyp 103

LizenzenNutzungsbericht 41

MMariaDB 27MemSQL 27Metadaten

voheriges Laden 21MongoDB Connector for BI 2.2.1 27Multi-Tenant-Funktionalität

Einschlussregeln 51Inhalte Tenants zuweisen 52Tenant-ID 53Tenants 51Tenantverwaltung 51

NNamespaces

siehe auch AuthentifizierungsproviderAuthentifizierungsprovider 8IBM Cognos 1mehrere 1

OOpenID Connect

Benutzer hinzufügen 10, 11Ordner

Maximale Anzahl an Benutzern 1

PPivotal Greenplum und HDB

blockierte Abfragen 22Presto 27Produktsprache 58Protokollierung

Protokolldateien 29Typen 29

Protokollierung zu Diagnosezwecken 29Fehlerbehebung bei Problemen beim Starten des Cognos-

Service 32

RRollen

Anpassung 7Erstellung 5Verwaltung 5vordefiniert 50

SSicherheit

Authentifizierung 1, 8vordefinierte Einträge 50Zugriff auf Inhalte 1

Sitzungsprotokollierung 29Spark SQL 2.1 Thrift-Server 27

TTenant-ID

öffentliches Objekt 53Tenantabsender 58Tenants

aktive Benutzersitzungen beenden 59aktivieren 59anpassen 56Erstellung 52inaktivieren 59löschen 60

VVerbindungen

Datenserver 15Verbindungen mit Datenservern

Cloudera Impala 21Verbindungsparameter 17Vergangen

Aktivitäten 36Einträge 36

Vordefinierte Einträge 50

ZZeitpläne

bevorstehende Aktivitäten verwalten 37Verwaltung 38

Zeitzone 58


v unix ist eine eingetragene marke von the open gr oup in ......pe ist ein benutzerverbund....

Documents