Introduction

How to:

When the WebFOCUS GIS Adapter is invoked, one of the first steps it performs is to access the XML definition file (for example, esriconfig.xml). The adapter parses the XML and uses the information provided to generate JavaScript objects and methods that are returned to the web browser. The JavaScript that is returned is vital to the operation of the WebFOCUS GIS Flex Viewer, as well as any browser sessions used for report viewing.

As of WebFOCUS 8, the ESRI Configuration Utility is available as a new utility that provides a graphical interface to configure and edit XML definition files.


Top of page

x
Procedure: How to Open the ESRI Configuration Utility

The ESRI Configuration Utility is available from the WebFOCUS Business Intelligence (BI) Portal. To open the ESRI Configuration Utility:

  1. Type the following address in your web browser:
    http://server:port/ibi_apps

    where:

    server

    Is the name of the server on which WebFOCUS is installed.

    port

    Is the number of the port on which the server is listening.

    The WebFOCUS BI Portal page opens, as shown in the following image.

  2. Click Sign In from the menu bar.

    The Sign In to WebFOCUS dialog opens, as shown in the following image.

  3. Sign in using the following credentials:
    • User Name: admin
    • Password: admin

    You can also use a self-service login account to access the ESRI Configuration Utility. For more information, see How to Configure a Self-Service Login Account.

  4. Click Tools from the menu bar and select ESRI Configuration Utility.

    The ESRI Configuration Utility dialog opens.

    This initial dialog allows you to create a new XML definition file or edit an existing version that is available.

    • To create a new XML definition file, perform steps 5 through 7.
    • To edit an existing XML definition file, perform steps 8 through 10.
  5. To create a new XML definition file, click New File.

    The Browse Path dialog opens, as shown in the following image.

  6. Select an application folder on the WebFOCUS Reporting Server where the new XML definition file will be located when it is saved.
  7. Click OK.

    The ESRI Configuration Utility opens for a new XML definition file, as shown in the following image.

  8. To edit an existing XML definition file, click Edit File from the ESRI Configuration Utility dialog.

    The Open dialog is displayed, as shown in the following image.

  9. Browse to an application folder on the WebFOCUS Reporting Server where an existing XML definition file is located.
  10. Click Open.

    The ESRI Configuration Utility opens for the selected XML definition file, as shown in the following image.

    The path to the XML definition file is displayed at the top of the window. For example:


Top of page

x
Procedure: How to Configure a Self-Service Login Account

The ESRI Configuration Utility can also be accessed from the WebFOCUS BI Portal using a self-service login account. To configure a self-service login account:

  1. Log in to the WebFOCUS BI Portal as an administrator.
  2. Click Administration from the menu bar and select Security Center.

    Adminimstration menu

    The Security Center dialog box opens.

    Security Center dialog box

  3. Click the Roles tab.
  4. Click the New Role button.

    The New Role dialog box opens.

  5. Type ESRI Configuration Utility in the Name field and select Display ESRI Configuration Utility from the list of available privileges, as shown in the following image:

    New Role dialog box

  6. Click OK.

    The ESRI Configuration Utility role now appears in the Roles list.

  7. Click the Users & Groups tab.
  8. Click the New Group button.

    The New Group dialog box opens.

  9. Populate the Group Name and Description fields and click OK.

    The new group appears in the list Groups list.

  10. Right-click the new group, point to Security, and click Rules.

    The Security Rules dialog box opens.

  11. Select your new group from the list. In the Roles list, click ESRI Configuration Utility and select Permitted from the Access drop-down menu, as shown in the following image.

    Security Rules dialog box

    Click OK.

  12. In the Security Center, create a new user and assign this user to the new group with the ESRI Configuration Utility privileges.

    For more specific information on how to use the Security Center to create a new user, see the WebFOCUS Security and Administration manual.

  13. Log in to the WebFOCUS BI Portal using the new user account.
  14. Click Tools from the menu bar.

    Notice that ESRI Configuration Utility is available as a menu option that can be selected, as shown in the following image.

    Tool menu


WebFOCUS