A Web Query environment consists of a web server, a Web Query Client, and a Reporting Server. Adding Web Query environments lets you create and manage multiple environments, such as development, test, and production instances.

To add a Web Query environment, do the following:

• Specify a web server that includes a host name and port number.
• Configure the HTML alias/context root to access the Web Query Client.
• Provide the appropriate user credentials if web server authentication is required.

The following procedure provides the information you need to add a Web Query Environment.

1. On the Home tab, in the Utilities group, click Environments.

   The Environments List dialog box opens, as shown in the following image. This dialog box lists all Web Query environments defined for Developer Workbench.

   

2. Click Add.

   The Web Query Environment Properties dialog box opens, as shown in the following image.

   

   At the top of the dialog box is the Description field, followed by the Environments Settings area. The Environments Settings area contains a series of buttons that represent components in a Web Query environment, and the required parameter fields to configure that environment. When you configure an environment, the areas below the buttons can change according to the parameters that are required.

3. In the Description field, type a description for the Web Query environment. This description appears in the Configured Environments tree.

   Note: The description cannot contain special characters, such as ., /, \, ?, *, and others. A message with characters not allowed appears if one of the restricted characters is detected during validation.

4. In the Web Component area, specify the web server information.

   For some environments, once you specify the web server, all other settings default. If the Web Query environment you are accessing does not use default settings, or the components require authentication, click the appropriate button in the Environment Settings area to provide the parameters. The areas that follow explain the parameters available for each component.

   Note: Web Query environment properties must be supplied in a specific order. For example, if web server security is enabled, you cannot set the Web Query Client script name until you have provided valid web server credentials. Similarly, you cannot retrieve a list of Reporting Servers until you have provided a valid Web Query Client Path.

   As you select a component button in the Web Query Environment Properties dialog box, Developer Workbench ensures that it has the necessary information before it displays the properties of that component in the lower part of the dialog box. If the required information is not available, you cannot proceed to the next component.

5. Click OK.

   The Web Query Logon - Web Query dialog box, shown in the following image, opens and prompts you for a Web Query ID and password.

   

   There is a check box option on the logon dialog box for remembering the ID or password. By default, it is not selected. If you select this box, your credentials are stored and encrypted in the wfscom.xml file, the local configuration file that stores information processed by the Developer Workbench communication layer.

   To clear stored credentials, open the Web Query Environment Properties dialog box and select the environment that users need to make changes. Click Web Query Client. Under Web Query Credentials, delete the User ID and Password information, and then clear the Supply Credentials check box.

   Note: A logon dialog box can also open for connection to the web server, application server, or Reporting Server, depending on the security implemented in the Web Query environment that is being accessed.

6. Type the appropriate user name and password, and then click Logon. The Web Query Environment Properties dialog box closes.
7. In the Environments List dialog box, click OK.