Parameterized URL Method

The parameterized URL method performs tasks or starts specific components using parameters typed in the Web browser address bar.

Using both get and post methods, the launch.xts or cc.xts parameter starts the specified component.

This method requires that the parameters use the following format:

&ArgumentName=ArgumentValue

The ArgumentName parameter specifies the type, and the ArgumentValue parameter specifies the value of the called arguments. All names and values must be character strings.

This method is easier to begin using than the cognosLaunch method because it does not require advance preparation. However, the longer URL-encoded entries are restrained by browser character limits.

You can use these commands to browse content or view pages.

Mandatory Parameterized URL Parameters

If you are using the parameterized URL method to start any component, you must use the following parameters with this syntax: 


http://localhost/bi/v1/disp?b_action=xts.run&m=portal/launch.xts

followed by the specific component parameters you want to use.

If you want to start the viewer using the parameterized URL method, use the following parameters with this syntax:


http://localhost/bi/v1/disp?b_action=cognosViewer

If you want to start the portal using the parameterized URL method, use the following URL: 


http://localhost/bi/v1/disp?b_action=xts.run&m=portal/cc.xts

The mandatory building blocks for parameterized URL commands are as follows:

  • gateway

    This is the mandatory argument value that specifies the gateway. The gateway name in this example is http://server/ibmcognos/bi/v1/disp?.

    IBM® Cognos® Application Firewall validation is enforced on URLs that contain this parameter. For more information see, URL Validation.

  • b_action=xts.run

    Identifies the action. To specify the viewer, b_action=cognosViewer. For more information see, Starting IBM Cognos Viewer.

  • m=portal/launch.xts&ui.tool=tool_name

    Identifies the component interface that displays the result. To start the portal, use m=portal/cc.xts.

  • ui.action

    Specifies the action to take. Acceptable values for the Studio components are new and edit. The default is new. Acceptable values for the viewer are run and view. The default is view.