Siebel Database Upgrade Guide > Performing the Siebel Incremental Repository Merge >

About Migrating the XML Manifest Data for Siebel Open UI from Previous Releases to the New Manifest Data in the Database

Platforms: Windows, UNIX, and IBM z/OS.

In Siebel Open UI, before Siebel CRM version 8.1.1.11 or version 8.2.2.4 (Siebel Innovation Pack 2013), files to be downloaded for an applet were configured in one of the following ways:

• Through the Applet object properties Presentation_Model and Physical_Renderer in Siebel Tools.
• By adding entries under the Presentation Model and Physical Renderer sections in the manifest_extensions.map file in the SIEBSRVR_ROOT\objects folder on the Siebel Server.

The files were then configured against the key in the custom_manifest.xml file or in an application-specific custom manifest file.

Starting with Siebel CRM version 8.1.1.11 and version 8.2.2.4, Siebel Open UI replaces the XML manifest file with manifest data that it stores in the Siebel database, as noted in Upgrading a Custom Database Schema. You cannot modify this predefined manifest data, but you can use the Manifest Administration screen in the client to configure the manifest data that your customizations require. Applets are mapped directly to files, and expressions are configured to determine under what conditions the applets use a given file.

The following example illustrates how data from the XML manifest file is migrated. The example uses the applet Activity HI Calendar Applet, which is used for calendar functionality in Siebel Open UI. It has separate renderings in mobile and desktop applications.

NOTE:  The migration described in this topic applies only to upgrades with custom Siebel Open UI manifest files for Siebel CRM version 8.1.1.9 or 8.1.1.10, and version 8.2.2.2 or 8.2.2.3.

Figure 2 shows the UI Objects view with two Activity HI Calendar Applet UI object entries. One of these entries has a usage type of Renderer, while the other entry has a usage type of Presentation Mode. Two object expressions are shown in the Object Expression view: Mobile and Desktop, and in the Files view, the required JavaScript file is shown.

Figure 2. Activity HI Calendar Applet in UI Objects View, with Object Expressions and Files

As the following example from an earlier version shows, the two separate renderings were implemented in the XML manifest file for the applet using the CalPR key:

<PLATFORM Name="IsMobileApplication()">
<KEY Name="SignViewPM"
<KEY Name="SignViewPR"
<KEY Name="AppletPR"
<KEY Name="CalPR">
<FILE Name>siebel/jqmcallistrenderer.js</FILE_NAME>"
</KEY>
<KEY Name="GridPR"
<KEY Name="RestOfUIPR"
</PLATFORM>
<PLATFORM Name="IsDesktopApplication()">
<KEY Name="AppletPR">
<KEY Name="ListPR">
<KEY Name="GridPR">
<KEY Name="TaskPanePR">
<KEY Name="TreePR">
<KEY Name="TileRenderer">
<KEY Name="CalPR">
<FILE Name>siebel/jqfullcalrenderer.js</FILE_NAME>"
</KEY>

As shown in the example, separate files for mobile and desktop platforms are configured using the CalPR key. However, for the new manifest data in the Siebel database, there are two required configured entries: Mobile and Desktop. Both expressions correspond to a single UI object, and they are evaluated sequentially by their level number. If the setting is True for either entry, then the respective file is downloaded, and further evaluation does not take place.

However, if a record is an Application type UI object, with a usage type of Common, then all expressions set to True are considered, not just the first in Object Expression list. All True expressions are then aggregated and downloaded to the browser. For information on modifying manifest data, see Configuring Siebel Open UI.

Manifest File Migration Rules

The migration rules for this example are as follows. For each applet mapped to a manifest key in either of the following ways, an entry is made in the UI Objects applet.

• By using the Presentation_Model and Physical_Renderer user properties under the Applet object in Siebel Tools.
• By adding entries under the [Presentation Model] and [Physical Renderer] sections in the manifest_extensions.map file, in the SIEBSRVR_ROOT\objects folder on the Siebel Server.

  Each time the manifest key is used in the legacy XML file, an entry is made in the new Manifest screen, and a record is also added to the Object Expression and Files views, using the rules shown in Table 32.

  Table 32. Key Usage Rules

  Use of Keys in Legacy XML Files	Record Created in the Object Expression and Files Applets
  Under a PLATFORM subsection within the PLATFORM_KEY_SPECIFIC section in the custom_manifest.xml	The record in the Object Expression applet with an expression value that evaluates to True only for the specified platform. The record also exists in the Files applet for any files associated with the record.
  Under the KEY_COMMON section in the custom_manifest.xml	The record in the Object Expression applet with no entry in the Expression field. The record also exists the Files applet for any files associated with the record.
  Under a PLATFORM section within the PLATFORM_KEY_SPECIFIC section in a custom Application Manifest XML file	The following records are created in the Object Expression applet: A record for Group Expression A record with an Expression value that evaluates to True only for the given platform A record with an Expression value that evaluates to True only for the given application The records in the Files applet are associated with the Group Expression.
  Under the KEY_COMMON section in a custom Application Manifest XML file	The record in the Object Expression applet with an Expression value that evaluates to True only for the given application and a record in the Files applet for the file associated with the record.