Migrate EXPLORE_TABS

Changes to Spotfire for Apple iPad 2.5.2 required changes in the MyConfiguration.plist structure from earlier versions.

The key EXPLORE_TABS is no longer supported in the file MyConfiguration.plist. Instead, to control the visibility of the Gallery (formerly known as Favorites) view and the Recently Viewed view, you can use the new keys HideGallery and HideRecentlyViewed. Setting these to YES hides these views in the app. See Disable user actions and views for more information.

Another feature of the key EXPLORE_TABS was the ability to create and display custom views in the app. This is possible in Spotfire for Apple iPad 2.5.x using the new CustomMenuItems key. See Adding custom menu items to the sidebar for more information.

The following example demonstrates an EXPLORE_TABS key configuration for a TIBCO Spotfire® Deployment Kit for Apple iPad version 2.x, specifying that the Servers tab, the Featured tab, and two custom tabs be present in the Explore view.

<key>EXPLORE_TABS</key>
<array>
		<dict>
			<key>Type</key>
			<string>SERVERS_TAB</string>
		</dict>
		<dict>
			<key>Type</key>
			<string>FEATURED_TAB</string>
		</dict>
		<dict>
			<key>Identifier</key>
			<string>my_custom_tab1</string>
			<key>Type</key>
			<string>CUSTOM_TAB</string>
			<key>Url</key>
			<string>setting: my_custom_tab1_url</string>
			<key>Title</key>
			<string>string: my_custom_tab1_title</string>
			<key>Icon</key>
			<string>string: my_custom_tab1_icon</string>
			<key>IconSelected</key>
			<string>string: my_custom_tab1_iconselected</string>
		</dict>
		<dict>
			<key>Identifier</key>
			<string>my_custom_tab2</string>
			<key>Type</key>
			<string>CUSTOM_TAB</string>
			<key>Url</key>
			<string>http://www.google.com</string>
			<key>Title</key>
			<string>My Tab 2</string>
			<key>Icon</key>
			<string>tab2.png</string>
			<key>IconSelected</key>
			<string>tab2_selected.png</string>
		</dict>
</array>

In Spotfire for Apple iPad 2.5.x, the list of Spotfire libraries (previously known as Servers tab) is now presented in the sidebar menu by default. If you want to prevent users from adding and editing libraries in Spotfire for Apple iPad 2.5.x, in the file MyConfiguration.plist, specify the new key DisableAddEditLibraries. See Preventing users from adding or editing libraries for more information.

In Spotfire for Apple iPad 2.5.x, there is no Featured tab, so this tab does not migrate to Spotfire for Apple iPad 2.5.x.

The two custom tabs can be reconfigured as follows in the Spotfire for Apple iPad 2.5.x file MyConfiguration.plist.

Key			Type	Value
CustomMenuItems			Array	(2 items)
	Item 0		Dictionary	(4 items)
		icon	String	`string: my_menuitem_icon1_filename`
		iconSelected	String	`string: my_menuitem_icon1selected_filename`
		title	String	`setting: my_test_menuitem1_title`
		url	String	`http://spotfire.tibco.com`
	Item 1		Dictionary	(4 items)
		icon	String	`test_menuitem_icon2.png`
		iconSelected	String	`test_menuitem_icon2_active.png`
		title	String	`My Test Menuitem 2`
		url	String	`http://www.google.com`

Note: In the Source Code view, this section appears as follows.

<key>CustomMenuItems</key>
   <array>
      <dict>
         <key>icon</key>
         <string>string: my_custom_tab1_icon</string>
         <key>iconSelected</key>
         <string>string: my_custom_tab1_iconselected</string>
         <key>title</key>
         <string>string: my_custom_tab1_title</string>
         <key>url</key>
         <string>setting: my_custom_tab1_url</string>
      </dict>
      <dict>
         <key>icon</key>
         <string>tab2.png</string>
         <key>iconSelected</key>
         <string>tab2_selected.png</string>
         <key>title</key>
         <string>My Tab 2</string>
         <key>url</key>
         <string>http://www.google.com</string>
      </dict>
   </array>

The two custom menu items show up in the sidebar menu in Spotfire for Apple iPad 2.5.x.