Getting started with the Cognos TM1 Web URL API

You create a URL by using a base URL and specific TM1® parameters and then pass the completed URL to the TM1 Web server. The completed URL opens and displays a Websheet or CubeViewer object. You can also use the URL API to apply various actions on these objects.

The base URL and the parameters are separated by the hashtag symbol (#) and assembled in the following format:


If you want to include multiple parameters in the same URL, separate them with the ampersand symbol (&).


Web browser address bar example

Copy and paste the following URL into the address bar of your web browser to see a simple example of the URL API.


Using the URL API in web pages

The URL API uses HTML inline frames (<iframe> tag) to display CubeViewer and Websheet objects in your custom web pages. The <iframe> tag is the primary way to display CubeViewer and Websheet objects with the URL API.

After a TM1 Web object is displayed in an iframe, you can then apply actions on that object by updating the src (source) property of the iframe with a new URL.

For more information, see Using HTML <iframe> tags to display Cognos TM1 Web objects.