This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.

Configure administrative settings

As the Esri Maps for IBM Cognos administrator, you can modify the application's configuration file (settings.js) to specify a variety of user options. Available options are described below.

Use a standard text editor to modify the application's configuration file.

The settings file is on the EM4C Gateway in the following location: <em4c_location>\webcontent\esrimap\configuration\settings.js

Administrative settings

The following properties are used to define user options.

  • arcgisSharing—Controls whether web maps and layers can be shared with ArcGIS (as specified by arcgisUrl). Acceptable values are true and false; the default is false. This is a Boolean property value and does not require quotation marks.

    For example: arcgisSharing: false

  • selectionColor—Specifies the color to use for areas that define a selection on the map. Colors are defined using hexadecimal values; the default value is #FF0000 (red). This property value is a string that must be enclosed in quotation marks.

    For example: selectionColor: "#FF0000"

  • infographicsEnabled—Controls whether infographics can be configured and accessed from pop-up windows in Esri Maps for IBM Cognos. Supported values are true and false; the default is true. This is a Boolean property value and does not require quotation marks.

    Because using infographics consumes ArcGIS service credits, system administrators may want to restrict user access to this service.

    If infographicsEnabled is set to true, authors will be able to configure infographics for a report and infographics will be available to consumers from pop-ups. If false is specified, both configuration and pop-up access will be disabled.

    For example: infographicsEnabled: false

  • corsEnabledServers—Optionally specifies one or more URLs for known CORS-enabled servers. For more information, see Work with proxies.
  • docRoot—This value defines the default location from which the Esri Maps for IBM Cognos documentation is retrieved when designers or consumers click the Help button. By default, this value points to the most recent version of the online help, in the language defined by the user's locale.

    For example: docRoot: "http://doc.arcgis.com/{LOCALE}/maps-for-cognos/"

    If localized documentation is not available for the user's locale, the Help button launches the English online help. Contact Esri Support to verify the languages in which the documentation is available.

    If no Internet connection is available, you can change the docRoot property to specify the locally installed help.

    For example: docRoot: "installed"

    The Help button will launch the appropriate installed help system for the report author and report consumer.