Für Esri Maps for IBM Cognos ist eine ArcGIS Online-Organisationssubskription oder eine lokale Portal for ArcGIS-Bereitstellung erforderlich. Es wird vorausgesetzt, dass die für den Zugriff auf die Plattform verwendete Authentifizierungsmethode ordnungsgemäß vom ArcGIS-Administrator konfiguriert wurde.
Hinweis:
Wenn das Portal for ArcGIS Ihrer Organisation per PKI- oder IWA-Authentifizierung gesichert ist und Benutzer in der Organisation keinen CORS-fähigen Browser (wie Microsoft Internet Explorer) verwenden, müssen Sie die Umgebung so konfigurieren, dass die Portal for ArcGIS- und Webserverkomponente Ihres Business Intelligence-Systems über dieselbe Quelle bereitgestellt werden, d. h., sie müssen sich auf demselben Host und in derselben Domäne befinden, denselben Port und dasselbe Protokoll verwenden.
Vorab benötigen Sie die folgenden Informationen:
Die URL Ihrer ArcGIS-Organisation.
Tipp:
Navigieren Sie in einem Browser zu <arcgisUrl>/sharing/?f=pjson; bei korrekter Angabe der arcgisUrl zeigt der Browser Informationen zur aktuellen Version an. Ein Beispiel sehen Sie unter http://www.arcgis.com/sharing/?f=json.
- Die bei der Registrierung Ihrer Anwendung generierte App-ID. Bei Verbindungen zu einer Portal for ArcGIS-Bereitstellung, die Webserver-Authentifizierung nutzt, oder zu einer Portal for ArcGIS-Bereitstellung vor 10.3 ist dies nicht erforderlich.
Konfigurationsdatei
Die Konfigurationsdatei befindet sich im EM4C Gateway im folgenden Verzeichnis: <em4c_location>\webcontent\esrimap\configuration\settings.js
Hinweis:
- Sollte Ihre Esri Maps for IBM Cognos-Implementierung mehr als ein Gateway enthalten, muss die settings.js-Datei für jedes Gateway aktualisiert werden. Die Einstellungen sollten in allen Gateways übereinstimmen.
- Wenn Sie Änderungen an settings.js vornehmen und nachfolgend die Standardverwaltungs- und Anmeldeeinstellungen aus irgendeinem Grund wiederherstellen möchten, können Sie dazu settings.js löschen und die Datei mit den Standardeinstellungen (settings.js.default) in settings.js umbenennen. Auf jedem Gateway in Ihrer Umgebung befindet sich die Datei settings.js.default am selben Speicherort wie settings.js.
Angeben der Anmeldeeigenschaften
In den meisten Fällen sind nur die folgenden Anmeldeeigenschaften zu konfigurieren:
arcgisUrl – ArcGIS Online-Organisation oder Portal for ArcGIS-Bereitstellung.
Für ArcGIS Online lautet der Standardwert http://www.arcgis.com. Um einen anderen Wert einzugeben, müssen Sie das Format http://[orgAccount].arcgis.com verwenden, bei dem [orgAccount] der Name des ArcGIS Online-Kontos Ihrer Organisation ist. Für Portal for ArcGIS lautet das Format http://[portalUrl]/[portalVirtualDirectory].
arcgisAuthType – Anmeldemethode. Verfügbare Werte sind user und app; der Standardwert lautet user.
arcgisAppId – Gibt eine eindeutige Anwendungs-ID an (ArcGIS Online oder Portal for ArcGIS 10.3 und höher).
Beispiel (ArcGIS Online):
arcgisUrl: "http://www.arcgis.com", arcgisAuthType: "user", arcgisAppId: "nvgHDDFXzMRWmKfY"Beispiel (Portal for ArcGIS 10.3 und höher, ohne Webserver-Authentifizierung):
arcgisUrl: "http://myportal.mycompany.com/arcgis", arcgisAuthType: "user", arcgisAppId: "nvgHDDFXzMRWmKfY"Beispiel (Portal for ArcGIS vor Version 10.3 oder bei Verwendung von Webserver-Authentifizierung):
arcgisUrl: "http://myportal.mycompany/arcgis", arcgisAuthType: "user", arcgisAppId: ""
Hinweis:
Lassen Sie bei der "arcgisUrl" die Angabe /home weg.
Weitere Anmeldeeinstellungen
In bestimmten Fällen können Sie optional ein Named User-Konto bereitstellen, das im Namen von Esri Maps for IBM Cognos agiert, indem Sie arcgisAuthType in App ändern und einen Benutzernamen (arcgisAppUser) und ein Kennwort (arcgisAppPassword) angeben. Beachten Sie, dass dieses Produkt als Berechtigung im Rahmen der ArcGIS Online-Subskription bzw. Named-User-Lizenz für Portal for ArcGIS bereitgestellt wird und dass alle Lizenzierungsanforderungen gelten. Alle Benutzer müssen über eine Named-User-Lizenz verfügen, um auf ArcGIS zuzugreifen und mit der Karte zu interagieren. Weitere Informationen erhalten Sie von Ihrem Ansprechpartner bei Esri.
Beispiel: arcgisUrl: "http://www.arcgis.com",
arcgisAuthType: "app",
arcgisAppUser: "arcgis_user",
arcgisAppPassword: "arcgis_pwd"
Hinweis:
Wenn Sie die arcgisAuthType App verwenden, sollten Sie die Eigenschaft arcgisSharing unbedingt auf false setzen; Näheres erfahren Sie unter Konfigurieren der Verwaltungseinstellungen.