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/.

Generate an application ID

When specifying the user login method on ArcGIS Online, administrators must register the application with the ArcGIS Online platform and include the generated application ID in the Esri Maps configuration settings file. To configure user logins for use with an ArcGIS organization, you must first add Esri Maps for IBM Cognos as an application, and register it with the organization. This process generates a unique application ID, which identifies Esri Maps for IBM Cognos to your ArcGIS Onlineorganization. You use this application ID to set the arcgisAppId property in the Esri Maps for IBM Cognos configuration settings file. For more information, see Adding applications.

The following procedures should be performed by an administrator or publisher in the ArcGIS Online organization.

Add Esri Maps for IBM Cognos as an application to the ArcGIS Online organization

  1. Sign in to your ArcGIS Online organization.
  2. Open My Content and click Add Item.

    The Add Item window appears.

  3. From the The item is option, choose An Application.
  4. Choose Web Mapping for the type of item.
  5. Type the URL of the Esri Maps for IBM Cognos implementation in your organization.

    For example, http://<myHostName.com>/c.10.2_64.

  6. For the Purpose, choose Ready to use.
  7. For the web mapping API, choose JavaScript.
  8. Type a title for the application, for example, Esri Maps for IBM Cognos.
  9. Type tags—words or short phrases that describe your application. Separate items with commas.
  10. Click Add Item.

    Your application is now added to ArcGIS Online. It appears on My Content, and you can edit item details and share the application.

    To generate a unique ID for your application, you must now register it with your ArcGIS Online organization.

Register Esri Maps for IBM Cognos with your ArcGIS Online organization

  1. Verify that you are logged in to your ArcGIS Online organization and click My Content.
  2. Click the title of the application you want to register to view its item details.
  3. Scroll down to the App Registration section and click Register.
  4. For the App Type, select Browser.
  5. For each redirect URI, enter the address in the format http://<server>[:port] and click Add.

    Redirect URIs are valid base URIs—addresses to which Esri Maps for IBM Cognos users are redirected after they successfully log in. In most organizations, your Business Intelligence platform can accessed in many ways; for example, using fully qualified domain names, IP addresses, development/test/production environments, and so on. Be sure to list all possible redirect URIs.

    The following is a sample list of base URIs:

    http://app

    http://app.mycompany.com

    https://app.mycompany.com

    https://app

    http://10.69.1.57

    http://app.mycompany.com:8080

  6. Click Register.

    When your application is successfully registered, it is assigned a unique app ID.

  7. Scroll down to the App Registration section to view the app ID. If you don't see the app ID, click Registered Info.
    Make note of the app ID; you will use this ID to specify the arcgisAppId parameter in the administrative settings configuration file.

Configure Esri Maps for IBM Cognos login settings

  1. Using a text editor, open the settings.js configuration file.

    For details, see Configure login settings.

  2. Modify the following properties:

    arcgisUrl: "[URL to your ArcGIS organization]"

    For example: "https://myorganization.argis.com"

    arcgisAuthType: "user"

    arcgisAppId: "[app ID generated upon application registration]"

    For example: "nvgHDDFXzMRWmKfY"

  3. Save the settings.js file.