Manage Project Versions

Each project that you create in the CA TDM Portal gets associated with at least one version, which is created at the time of project creation. For simple applications, you can work with a single version. However, if you have a complex application, create multiple project versions to address different scenarios. You can add multiple versions to the same project as and when required.
tdm40
Each project that you create in the CA TDM Portal gets associated with at least one version, which is created at the time of project creation. For simple applications, you can work with a single version. However, if you have a complex application, create multiple project versions to address different scenarios. You can add multiple versions to the same project as and when required.
2
2
Version Types
The following are the two types of versions:
  • Normal
    A project can have any number of normal versions. Each normal version includes information that is specific to that project version. This information is not common to all the project versions.
  • Generic
    A project can have only one generic version. A generic version contains common information that is applicable to all the versions. For example, you can use a generic version to define generic rules that other versions can inherit. 
    Note:
    You cannot create a generic version in the CA TDM Portal. However, if a project in DataMaker includes a generic version, the Portal displays that generic version as a first row in the
    Versions
    table. Also, no Upgrade Version icon is available for a generic version (in the Portal). This information helps you distinguish a generic version from a normal version in the Portal.
Version Considerations
Review the following version-related considerations. This information helps you understand and implement the version functionality in an efficient way:
  • The order of a version is determined by the sequence in which it is created.
  • Tables are always registered against a version.
  • A table registered against an older version can be inherited by a newer version if the option to inherit tables is enabled during the project creation.
  • Table definitions are specific to a version. However, newer versions can inherit them during the upgrade version process.
Add More Versions to an Existing Project
If you have a requirement to add more versions to a project after the project is created, you can do so. 
  1. Access the CA TDM Portal.
  2. Select the Project Manager icon (gear icon) in the top blue bar.
    The
    Manage Projects
    dialog opens.
  3. Identify the project for which you want to create a version.
  4. Click the plus icon (+) in the row corresponding to the project for which you want to create a version.
    The
    Create New Version
    page opens.
  5. Provide the following information for the version that you want to create:
    • Name
      Lets you specify the name of the version.
    • Description
      Lets you specify the meaningful information about the version. 
    • Upgrade Version
      Lets you copy information (for example, data definitions, variables) from an older version to the version that you are creating. When you select this option, the following option becomes available in the CA TDM Portal:
      • Upgrade From
        Lets you specify the version from which you want to copy the information to the version that you are creating.
  6. Click
    Save
    .
    A message appears after the version is created successfully. 
  7. Click the forward arrow (>) before the project name (
    Manage Projects
    dialog).
    The project view is expanded and lists all the applicable versions for the project. 
  8. Verify that the newly created version is present in the list.
    You have successfully added a new version to an existing project.
Perform Actions on Versions
You can perform the following actions on a version after you create it:
Note:
For more information about creating variables at a version level, see Create and Manage Variables.
Edit a Version
After you create a version, you can edit its name and description if you want to do so.
  1. Access the CA TDM Portal.
  2. Select the Project Manager icon (gear icon) in the top blue bar.
    The 
    Manage Projects
     dialog opens.
  3. Identify the project that includes the version that you want to update.
  4. Click the forward arrow (>) before the project name to view all the available versions for the project.
  5. Click the row corresponding to the version that you want to update.
    A dialog with all the version details opens.
  6. Move the mouse pointer to the following places in the dialog:
    • <Version_Name> 
      Click the Edit icon (pencil) and specify a new name for the version. Then, click the Save icon to save the updated name.
    • Description
      Click the Edit icon (pencil) and specify a new description for the version. Then, click the Save icon to save the updated description.
  7. Review the updated information.
    You have successfully edited a version.
Upgrade a Version
Upgrading a project version copies the following information from an older version (source version) to a newer version (target version):
  • Copies data generators if data generators with the same name do not exist in the target version.
  • Copies variables at various levels if variables with the same name do not exist in the target version.
  • Copies CA Agile Requirements Designer flows if flows with the same name in the same hierarchy do not exist in the target version.
  • Copies publish actions if the corresponding data generator is not present in the target version.
Upgrade is applicable only for those projects for which the
All new versions inherit tables from previous version
 option was enabled during the project creation. This option is available in the project creation page. Additionally, you can upgrade only a normal version, not a generic version.
Note:
 Registered tables and foreign keys are not copied during the version upgrade.
  1. Access the CA TDM Portal.
  2. Select the Project Manager icon (gear icon) in the top blue bar.
    The 
    Manage Projects
     dialog opens.
  3. Identify the project that includes the version that you want to upgrade.
  4. Click the forward arrow (>) before the project name to view all the available versions for the identified project.
  5. Identify the version (target version) that you want to upgrade with the information from a previous version (source version).
  6. Click the Upgrade Version icon (up arrow) in the row that corresponds to the version that you want to upgrade.
    The
    Upgrade Version <Version_Name>
    dialog opens.
    Note:
    No Upgrade Version icon is available for a generic version (if it exists) and for an initial version of a project. For example, if
    Version 1
    is the first version in the project, the upgrade icon is not available for
    Version 1
    . Similarly, if
    Version 2
    is a generic version, then
    Version 2
    appears before
    Version 1
    in the versions list and the
    Version 2
    row does not display the upgrade icon.
  7. Select the source version (from which you want to inherit the information) from the
    Upgrade From
    drop-down list.
    This drop-down list displays all versions that you had already created before this version (which you are upgrading). For example, if you are upgrading version
    6.0
    , then all versions that are created before version
    6.0
    become available for selection from this drop-down list.
  8. (Optional) Select the 
    Remove Existing Data
     option to remove the existing data from the target version; that is, the version that you are upgrading. Otherwise, the data in the target version is merged with the data from the source version.
  9. Click the
    Upgrade
    button.
    A message appears at the top of the dialog. You have successfully upgraded a project version.
Delete a Version
If you no longer need a specific project version, you can delete it from your CA TDM Portal environment. You must have appropriate privileges to delete a version. The CA TDM Portal also deletes data generators that are available under the version when you delete it (version).
  1. Access the CA TDM Portal.
  2. Select the Project Manager icon (gear icon) in the top blue bar.
    The 
    Manage Projects
     dialog opens.
  3. Identify the project that includes the version that you want to delete.
  4. Click the forward arrow (>) before the project name to view all the available versions for the project.
  5. Click the cross icon (X) in the row that corresponds to the version that you want to delete.
    A confirmation dialog opens. 
  6. Click
    Delete
    to proceed with the delete process.
    A message appears after the successful deletion of the version.
    Note:
    You cannot delete a version if the jobs associated with the version are in the running state.
  7. Review the versions list to verify that the deleted version is no longer available in the table.
    You have successfully deleted a version.