Starting IBM Cognos BI Components in a Specified Browser Window

To do this, you must use the following parameters with this syntax:

cognosLaunchInWindow(windowName, windowProperties, "ui.gateway","
gateway","ui.tool","component")

The windowName and windowProperties parameters represent the values specific to starting an IBM Cognos BI component in a named browser window.

The windowName string is the name of the browser window, frame, or iframe in which to start the specified component. If the specified name does not exist, a newly created pop-up browser window appears with the name. To create a new pop-up window, use "_blank" as the value.

The windowProperties string defines the properties applied to the new pop-up window. This only applies to newly created windows. The available values depend on the type of the Web browser you are using, and correspond to the values supported by the JavaScript window.open() function. Some options may not work in all browsers.

The windowProperties parameter consists of a comma-separated list. Each item consists of an option and a value, separated by the equals sign (=). For example, "fullscreen=yes , toolbar=yes". Some common examples include:

• channelmode

  Specifies whether to display the window in theater mode, and show the channel band. The default is no. Acceptable values are yes and no.

• directories

  Specifies whether to add directory buttons. The default is yes. Acceptable values are yes and no.

• fullscreen

  Specifies whether to display the browser in full-screen mode. This mode hides the browser's title bar and menus. A window in full-screen mode must also be in channelmode. The default is no. Acceptable values are yes and no.

• height

  This integer specifies the height of the window, in pixels. The minimum value is 100.

• left

  This integer specifies the left position, in pixels, relative to the upper-left corner of the screen.

• location

  Specifies whether to display the input field for entering URLs directly into the browser. The default is yes. Acceptable values are yes and no.

• menubar

  Specifies whether to display the menu bar. The default is yes. Acceptable values are yes and no.

• resizable

  Specifies whether to display resize handles at the corners of the window. The default is yes. Acceptable values are yes and no.

• scrollbars

  Specifies whether to display horizontal and vertical scroll bars. The default is yes. Acceptable values are yes and no.

• status

  Specifies whether to display a status bar at the bottom of the window. The default is yes. Acceptable values are yes and no.

• titlebar

  Specifies whether to display a title bar for the window. This parameter is only valid if the calling application is an HTML Application, or a trusted dialog box. The default is yes. Acceptable values are yes and no.

• toolbar

  Specifies whether to display the browser toolbar. The default is yes. Acceptable values are yes and no.

• top

  This integer specifies the top position, in pixels. This value is relative to the upper-left corner of the screen.

• width

  This sets the width of the window, in pixels. The minimum value is 100.

The ui.gateway, ui.tool, along with some additional parameter values are described in Start Parameters.