analytics/configuration/icd/contributions/contrib/tm1_contribution.atom.sample

<?xml version="1.0" encoding="UTF-8"?>

<!-- 
This file contains the information needed for IBM Cognos Business Insight to connect to all versions of TM1 server.

Please MAKE SURE using the correct xts file in each atom entry. 
If you want to connect to pre TM1 10.2, using "m=tm1/PRE102/serverContent.xts"
If you want to connect to TM1 10.2GA, using "m=tm1/102GA/serverContent.xts"
If you want to connect to TM1 10.2FP1 or 10.2FP2, using "m=tm1/102FP1/serverContent.xts"
If you want to connect to TM1 10.2RP2 or 10.2RP2FP1, using "m=tm1/102RP2/serverContent.xts"
If you want to connect to TM1 10.3, using "m=tm1/103/serverContent.xts"
The sample below defaults for TM1 10.2RP2 and 10.2RP2FP1.

After you update this file, save it as tm1_contribution.atom. You should also update information in 
the tm1_<language_code>.properties file located in c10_location\configuration\icd\contributions\contrib directory 
on the computer where the IBM Cognos BI Application Tier Components are installed.

You must change the values in one <atom:entry> section for each TM1 server you want to access in Business Insight. If 
you have more TM1 servers you want to add, you must add <atom:entry> sections as required. All values for the atom:id 
must be unique and use the atom:title, and atom:summary to provide names and descriptions of these TM1 servers.  All .atom
entries should point to information defined in the tm1_<language_code>.properties file. 
You must comment out any extra <atom:entry> sections.

This sample file contains three <atom:entry> sections:
- The first <atom:entry> section is for a TM1Web accessing a TM1 server that does not use Cognos authentication.
- The second <atom:entry> section is for a TM1Web accessing a TM1 server that uses Cognos authentication.
- The third <atom:entry> section is commented out. It demonstrates the use of the TM1Toolbar option for TM1 servers 
version older than 9.5.2; this particular example is for a TM1 server that does not use Cognos authentication.

CAUTION: In configurations where TM1 is not using Cognos authentication, the TM1 credentials 
are passed as request parameters and are vulnerable to being logged. In such configurations, there 
can be proxies that pass the request en-route to the eventual TM1 Web Server. It is at the customers 
risk that these TM1 credentials might be exposed to outside parties.

In the appropriate <atom:entry> section for the authentication required, replace 
the TM1WebHostName and TM1HostName values with the name or IP address of the TM1 Web server and TM1 server. 

For a TM1 server that does not use IBM Cognos authentication, change the TM1DataServer variable and 
the credentials of the TM1 administrator account as follows:
TM1DataServer=TM1ServerHostWithoutCAM&amp;TM1username=admin&amp;TM1pass=apple

Note: Replace TM1ServerHostWithoutCAM with the name of the TM1 Data Server. For
example, if the name of the TM1 Data Server is Planning Sample, you would 
specify TM1DataServer=Planning%2520Sample. Replace admin and apple with the user ID 
and password of the administrator account that is used for the TM1 server.

For a TM1 server that uses IBM Cognos authentication, change the TM1DataServer variable as follows:
TM1DataServer=CamAuthenticatedTM1ServerHost

Note: Replace CamAuthenticatedTM1ServerHost with the name of the TM1 Data Server. For
example, if the name of the TM1 Data Server is Planning Sample, you would specify TM1DataServer=Planning%2520Sample.

FilterPackages: (CAN BE USED FROM TM1 10.2) TM1 iWidgets can interact with filters and facets and the optional parameter FilterPackages is available 
to permit this.  As most other iWidgets rely on package names to identify themselves to the filters and facets, the optional parameter 
FilterPackages can be added to the atom:link to permit TM1 iWidgets to use the same filters and facets as other iWidgets.
If the FilterPackages parameter is not passed or empty, the filters and facets will not be able to be shared with other iWidgets.

NavTreeDisplayServerView: (CAN BE USED FROM TM1 10.2) To prevent the Views node from being displayed, add the following optional parameter
which defaults to Y, NavTreeDisplayServerView=N

TM1HideDimBar: (CAN BE USED FROM TM1 10.2) With the BI 10.2 RP1 FP2 and the BI 10.3 release, the Cubeviewer iWidgets will default to display the TM1 dimension bar.  To get the
iWidgets to hide the dimension bar, set the TM1HideDimBar which defaults to 0, to 1, TM1HideDimBar=1

TM1WebPort: (CAN BE USED FROM TM1 10.2) This property is the number of the port on which TM1Web is running.  The default value of TM1WebPort is 9510.

If you are not using TM1 default values, you can change the following additional properties:

https: This property describes the protocol used for the TM1 Web server. If the TM1 Web 
is running with HTTP secure (https), replace 0 with 1.

TM1WebVirtualDirectory: This property is the name of the virtual directory for the TM1 Web. 
If the TM1 Web directory name is not tm1web, replace the value of the TM1WebVirtualDirectory property with the correct name.

TM1Toolbar: This property determines whether the internal toolbar is visible on top of widgets. Versions of TM1Web 
older than version 9.5.2 do not allow for an external toolbar. The default value of TM1Toolbar is 0. To display the internal toolbar, set the value to 1.
-->

<atom:feed xmlns:atom="http://www.w3.org/2005/Atom">
	
	<atom:entry>
		<atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_1</atom:id>
		<atom:published>2010-01-01T22:01:37Z</atom:published>
		<atom:updated>2010-01-01T22:01:37Z</atom:updated>
		<atom:title type="text">{tm1:rootfeed_title_1}</atom:title>
		<atom:summary>{tm1:rootfeed_summary_1}</atom:summary>
		<atom:category scheme="http://www.ibm.com/xmlns/prod/cognos/icd/contribution#type" term="rootfeed"/>
		<atom:link rel="alternate" type="application/atom+xml" href="{cgi}/xts.run?m=tm1/102RP2/serverContent.xts&amp;https=0&amp;TM1WebHost=TM1WebHostName&amp;TM1WebPort=9510&amp;TM1WebVirtualDirectory=tm1web&amp;TM1Host=TM1HostName&amp;FilterPackages=PackageName&amp;TM1DataServer=TM1ServerHostWithoutCAM&amp;TM1username=admin&amp;TM1pass=apple" title="">
		</atom:link>
		<atom:link rel="icon" type="image/gif" href="{web}/tm1/bux/images/server_connection.gif"/>
		<atom:link rel="thumbnail" type="image/gif" href="{web}/tm1/bux/images/server_connection_64.gif"/>
	</atom:entry>
	
	<atom:entry>
		<atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_2</atom:id>
		<atom:published>2010-01-01T22:01:37Z</atom:published>
		<atom:updated>2010-01-01T22:01:37Z</atom:updated>
		<atom:title type="text">{tm1:rootfeed_title_2}</atom:title>
		<atom:summary>{tm1:rootfeed_summary_2}</atom:summary>
		<atom:category scheme="http://www.ibm.com/xmlns/prod/cognos/icd/contribution#type" term="rootfeed"/>
		<atom:link rel="alternate" type="application/atom+xml" href="{cgi}/xts.run?m=tm1/102RP2/serverContent.xts&amp;https=0&amp;TM1WebHost=TM1WebHostName&amp;TM1WebPort=9510&amp;TM1WebVirtualDirectory=tm1web&amp;TM1Host=TM1HostName&amp;FilterPackages=PackageName&amp;TM1DataServer=CamAuthenticatedTM1ServerHost" title="">
		</atom:link>
		<atom:link rel="icon" type="image/gif" href="{web}/tm1/bux/images/server_connection.gif"/>
		<atom:link rel="thumbnail" type="image/gif" href="{web}/tm1/bux/images/server_connection_64.gif"/>
	</atom:entry>
	
	<!--atom:entry>
		<atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_pre102</atom:id>
		<atom:published>2010-01-01T22:01:37Z</atom:published>
		<atom:updated>2010-01-01T22:01:37Z</atom:updated>
		<atom:title type="text">{tm1:rootfeed_title_3}</atom:title>
		<atom:summary>{tm1:rootfeed_summary_3}</atom:summary>
		<atom:category scheme="http://www.ibm.com/xmlns/prod/cognos/icd/contribution#type" term="rootfeed"/>
		<atom:link rel="alternate" type="application/atom+xml" href="{cgi}/xts.run?m=tm1/PRE102/serverContent.xts&amp;https=0&amp;TM1WebHost=TM1WebOlderThan952HostName&amp;TM1WebVirtualDirectory=tm1web&amp;TM1Host=TM1HostName&amp;TM1DataServer=TM1ServerHostWithoutCAM&amp;TM1username=admin&amp;TM1pass=apple&amp;TM1Toolbar=1" title="">
		</atom:link>
		<atom:link rel="icon" type="image/gif" href="{web}/tm1/bux/images/server_connection.gif"/>
		<atom:link rel="thumbnail" type="image/gif" href="{web}/tm1/bux/images/server_connection_64.gif"/>
	</atom:entry-->
	
</atom:feed>