Migrate EXPLORE_TABS

Changes to Spotfire for Apple iOS 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 Favorites view and the Recently viewed view, you can use the keys HideFavorites 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 iOS 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 Spotfire Deployment Kit for Apple iOS 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 iOS 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 iOS 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 iOS 2.5.x, there is no Featured tab, so this tab does not migrate to Spotfire for Apple iOS 2.5.x.

The two custom tabs can be reconfigured as follows in the Spotfire for Apple iOS 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 iOS 2.5.x.