Updating the System Definition File

This section describes how to update the system definition file.

Introduction

A typical change to the system model is to add or delete a component. To generate a new system model diagram using the System Model Manager, you must update the system definition file.

In this section, an example is used to explain the procedure for updating the system definition file. In the example two new components, the SyncML Data Provider and the Backup and Restore Provider, are added to the Remote Management block.

Procedure

  1. Prepare the hierarchy and the properties of the new components.

    We have decided to add our two new components to Remote Management. They will appear in the green oval in the Remote Management block diagram.

    Remote Management block


    Remote Management block

    The following illustration shows the hierarchy of the components:

    Component Hierarchy


    Component Hierarchy

    The following table summarises the properties of the components:

    Property

    Value

    name

    SyncML Data Provider

    introduced

    v9.6

    plugin

    Y (use Y for yes, leave out for no)

    mrp

    common/generic/mtp/dataproviders/syncdp/group/mtp_syncdp.mrp

    bldFile

    common/generic/mtp/dataproviders/syncdp/group

    Property

    Value

    name

    Backup and Restore Provider

    introduced

    v9.6

    plugin

    Y (use Y for yes, leave out for no)

    mrp

    common/generic/mtp/dataproviders/backupnrestoredp/group/mtp_backupnrestoredp.mrp

    bldFile

    common/generic/mtp/dataproviders/backupnrestoredp/group/

  2. Open System_Definition_Template.xml located under\src\common\Generic\tools\build\variability\vp_data\templates\ in a text editor and add the SynML Data Provider component as follows:

    <collection name="MTP Data Providers" level="services">
     <component name="MTP File and Folder Provider" plugin="Y" introduced="9.4">
        <unit bldFile="common/generic/mtp/dataproviders/filedp/group" mrp="common/generic/mtp/dataproviders/filedp/group/mtp_filedp.mrp"/>
      </component>
            <component name="SyncML Data Provider" plugin="Y" introduced="9.6">
        <unit bldFile="common/generic/mtp/dataproviders/syncdp/group" mrp="common/generic/mtp/dataproviders/syncdp/group/mtp_syncdp.mrp"/>
      </component>
    </collection>

    Note: The SyncML Data Provider is at the same level as the MTP File and Folder Provider.

  3. Similarly, add the Backup and Restore Provider component as follows:

    <collection name="MTP Data Providers" level="services">
     <component name="MTP File and Folder Provider" plugin="Y" introduced="9.4">
        <unit bldFile="common/generic/mtp/dataproviders/filedp/group" mrp="common/generic/mtp/dataproviders/filedp/group/mtp_filedp.mrp"/>
      </component>
            <component name="SyncML Data Provider" plugin="Y" introduced="9.6">
        <unit bldFile="common/generic/mtp/dataproviders/syncdp/group" mrp="common/generic/mtp/dataproviders/syncdp/group/mtp_syncdp.mrp"/>
      </component>
       <component name="Backup and Restore Provider" plugin="Y" introduced="9.6">
        <unit bldFile="common/generic/mtp/dataproviders/backupnrestoredp/group/" mrp="common/generic/mtp/dataproviders/backupnrestoredp/group/mtp_backupnrestoredp.mrp"/>
      </component>
    </collection>
  4. Save your changes to System_Definition_Template.xml and run SMM to rebuild the system diagram.

Result

The system definition file is updated with the details of the new components. The following figure shows the Remote Management block with two new components added.

Remote Management block with two new com...


Remote Management block with two new components added