In this section:
How to: |
As you set up access to WebFOCUS environments, your settings are retained in a file named wfscom.xml. WebFOCUS environment settings are typically stored in the following locations.
Windows 7:
drive:\Users\user_id\ AppData\Roaming\Information Builders\wfscom.xml
where:
Is your Windows user ID.
You can choose to remove this environment from your configuration files or leave the environment, and continue to develop against other environments that you configure. If you choose to remove the environment from your configuration files, you must restart App Studio.
A WebFOCUS environment consists of a web server, a WebFOCUS Client, and a Reporting Server. Adding WebFOCUS environments lets you create and manage multiple environments, such as development, test, and production instances.
The following procedure provides the information you need to add a WebFOCUS Environment.
The Environments List dialog box opens, as shown in the following image. This dialog box lists all WebFOCUS environments that are defined for App Studio.
The WebFOCUS Environment Properties dialog box opens, as shown in the following image.
You can also access the WebFOCUS Environment Properties dialog box using by right-clicking on the Configured Environments node and using the shortcut menu to click Add.
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 WebFOCUS 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.
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.
For some environments, once you specify the web server, all other settings default. If the WebFOCUS 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 parameters available for each component are explained in the following sections.
Note: WebFOCUS environment properties must be supplied in a specific order. For example, if web server security is enabled, you cannot set the WebFOCUS Client name until you have provided valid web server credentials. Similarly, you cannot retrieve a list of Reporting Servers until you have provided a valid WebFOCUS Client Path.
As you select a component button in the WebFOCUS Environment Properties dialog box, App Studio 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.
The WebFOCUS Logon dialog box opens and prompts you for a WebFOCUS ID and password, as shown in the following image.
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 App Studio communication layer.
To clear stored credentials, open the WebFOCUS Environment Properties dialog box and select the environment that users need to make changes. Click WebFOCUS Client. Under WebFOCUS 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 WebFOCUS environment that is being accessed.
The WebFOCUS Environment Properties dialog box closes.
Local Machine properties are optional. Click the Local Machine button to access the WebFOCUS Environment Caching area. Select the options in this area to cache remote directory and file information, and enable file-content caching.
The following image shows the WebFOCUS Environment Caching area of the WebFOCUS Environment Properties dialog box. The file content caching location path, shown in the following image, is for a Windows 7 machine.
In caching, copies of files or information stored on a remote machine are temporarily stored on your local App Studio machine. App Studio then works with the locally stored files.
Caching increases the App Studio performance speed, because remote machines are not accessed and queried every time you request information. This is especially useful when accessing mainframes or when a network connection is slow.
Note: Caching should not be used when multiple developers are working with the same files because they could overwrite changes made by other developers. By default, caching is not enabled.
Two properties are available:
App Studio retrieves information and files the first time you request them and then caches them locally. App Studio then uses the cached copies until App Studio is restarted, or you click the Clear buttons for each level.
Note:
The Web Components button is typically selected by default. Web Component properties specify how App Studio accesses the web server. The web server must be identified before any other components. The following image shows the Web Component area of the WebFOCUS Environment Properties dialog box.
The following properties are available:
/ibi_apps/ibi_html
where:
Is customizable.
Is constant.
/ibi_apps/WFServlet
where:
Is customizable.
Is constant.
If the WebFOCUS environment uses a non-default context path, clear the Use Default check box and provide the correct Client Path. For example:
/ibi_apps8/WFServlet
If the Client Path is incorrect for the environment, you receive an error when you click the WebFOCUS button at the top of the page, or when you click OK to exit and save your changes.
If you do not know your Client Path, ask your WebFOCUS Administrator or check the WebFOCUS Administration Console of the environment to which you want to connect. The Client Path settings for the environment are located under Utilities and Client Selection.
Use Default. Specifies that the default HTML alias is used. Keep this option selected unless you change the HTML Alias value.
Note:
HTML Alias:
/ibi_apps8/ibi_html
Client Path:
/ibi_apps8/WFServlet
Note: ClearTrust, SiteMinder, WebSEAL, and Oracle Access Manager require templates. Sample templates are provided with the WebFOCUS product. For more information, see the WebFOCUS Security and Administration manual.
When you click the WebFOCUS button, App Studio makes a connection to your web server to retrieve information about the WebFOCUS environment. Therefore, you have to first specify Web Component properties, and your web server must be running. The following image shows the WebFOCUS area of the WebFOCUS Environment Properties dialog box.
You are prompted to sign in to WebFOCUS to verify your configuration. You are also prompted to sign in to WebFOCUS if you click OK to exit the dialog box.
The following properties are available:
When the correct WebFOCUS Client Path is provided, you can specify properties for the remaining components.
You can set authentication and view available Reporting Servers by clicking the Data Servers button. When you select Data Servers, App Studio connects to the WebFOCUS Client and retrieves a list of servers from its communication configuration file (odin.cfg).
The following image shows the Data Servers area of the WebFOCUS Environment Properties dialog box.
The following property is available:
Note: Managed Reporting is not enabled in WebFOCUS Version 8.
Note: These properties only apply to self-service application development, and when performing project development.
If you use remote Project-based development and your remote environment has multiple Reporting Servers, click the Project Development button to specify which server to use when processing requests. This server is referred to as the Project Development Server. The Project Development Server and the WebFOCUS Client must be installed on the same machine or use the same Application Root directory (APPROOT directory) as each other.
The following image shows the Project Development Server area of the WebFOCUS Environment Properties dialog box.
The following property is available:
The Environments List dialog box opens, as shown in the following image.
The WebFOCUS Environment Properties dialog box opens, as shown in the following image.
WebFOCUS |