Updating the metadata models for Rational Quality Manager

After you upgrade to Rational® Insight 1.0 Fix Pack 1 and to Rational Quality Manager 1.0.1.1 or 2.0, you must update the metadata models for Rational Quality Manager by importing the new models into the IBM® Cognos® Framework Manager project and correcting the duplicate references.
About this task
Remember: This task is needed only if you are using Rational Quality Manager 1.0.1.1 or 2.0 as a data source.
To upgrade the Rational Quality Manager metadata models, you must rename the data sources, import the new models into IBM Cognos Framework Manager projects, reorder the elements in the Business View folder, remove duplicate data sources, and add columns to query subjects.

To upgrade the metadata models:

  1. Import the XML data configuration file for Rational Quality Manager.
    1. Start XML Data Configuration.
    2. Click File > Open and open the existing XML data configuration file of Rational Quality Manager that you were using before the upgrade.
    3. After the file is open, click File > Import and select the XML data configuration file for your version of Rational Quality Manager.
      • If you are using Rational Quality Manager 1.0.1.1, select the rqm1011.xdc file.
      • If you are using Rational Quality Manager 2.0, select the rqm.xdc file.
      The default file location is rational_insight_installation_directory\dataconfig\configs\live data config.
    4. Select Merge attributes of elements with matching identifiers and click OK.
  2. Rename the data sources.
    1. Start Cognos Framework Manager and open your Rational Quality Manager project.
    2. Expand Rational Insight Reporting Data Model (RQM) > Data Sources, and click RQM.
    3. On the Properties page, change RQM to RQM1.
    4. If a warning message is displayed, click OK.
    5. Save the changes.
    6. Repeat steps b through e for the RQM_System data source and rename it to RQM_System1.
  3. Import the latest models into IBM Cognos Framework Manager projects.
    1. Right-click the Rational Quality Manager namespace and click Run Metadata Wizard.
    2. Click IBM Cognos 8 Model and click Next.
    3. Browse and select the Rational Insight Reporting Data Model (RQM).cpf file of the latest Rational Quality Manager project and click Next.
    4. Select Rational Quality Manager and, for duplicate elements, select Do not import this object. Click Next.
    5. Click Next. After the import process is over, click Finish.
  4. Reorder the elements in the Business View folder.
    1. Expand the Rational Quality Manager namespace and click Business View.
    2. Right-click a folder and click Reorder. Repeat for all folders in the Business View folder.
    3. Close Cognos Framework Manager.
  5. Rename the data sources back to their previous names.
    1. In a text editor, open the model.xml file of the project. The default location of the file is rational_insight_instllation_directory\framemgr\Rational Insight Reporting Data Model (RQM).
    2. Find the XML element <dataSources>. Copy the text between the opening and closing tags of the XML element and paste to a temporary text file.
    3. In the model.xml file, find all occurrences of RQM1 and replace with RQM.
    4. In the model.xml file, find all occurrences of RQM_System1 and replace with RQM_System.
    5. Copy the text from the temporary file in step b and paste it within the <dataSources> tags of the model.xml file.
    6. Save the model.xml file and close it.
  6. Remove the duplicate data sources.
    1. Start Cognos Framework Manager and open your Rational Quality Manager project.
    2. Expand Rational Insight Reporting Data Model (RQM) > Data Sources.
    3. Delete RQM1 and RQM_System1.
  7. Add columns to query subjects.
    1. Expand the Rational Quality Manager > Physical Metadata.
    2. Double-click TestCase, click OK, specify the value of the property to be RQM, and click OK. Several columns are added to the TestCase query.
    3. Expand Physical Metadata > TestCase, right-click Description, and click Show Object Dependencies. All calculation definitions that are defined as [Physical Metadata].[TestCase].[Description] are listed in the Dependent Objects view. To see a query item in Project Viewer, click on a result in the Dependent Objects. The query subject to which the query item belongs is the dependent object of TestCase.
    4. For each of the dependent query subjects that are found in step c, double-click to open the Query Subject Definition page and drag all the undefined columns of Physical Metadata > TestCase in the Available Model Objects box to the Query Items and Calculations box. Change the column name to something meaningful.
    5. Save the changes.
    6. Select all the attributes of the query object, right-click, and select Reorder.
    7. Save the changes.
    8. Repeat step b through f for the following query subjects:

      TestPlan, Requirement, TestPhase, ExecutionWorkItem, ExecutionResult, Configuration, TestSuiteLog, Request, ResourceCollection, ResourceGroup, LabResource, LabResourceSoftwareLookup, JobResult, TeamArea, Contributor, WorkItem

    9. Close Cognos Framework Manager.
  8. Delete the jobs that are no longer needed.
    1. Expand Rational Quality Manager > Business View > Contributor Area and delete Contributor Related Jobs.
    2. In Rational Quality Manager > Business View > Job Area, delete Job Related Contributors.
    3. In Rational Quality Manager > Business View > Test Plan Area, delete Test Plan Related Test Plans.
    4. Expand Rational Quality Manager > Consolidate View and delete Contributor Related Jobs, Job Related Contributors, and Test Plan Related Test Plans.
    5. Expand Rational Quality Manager > Physical Metadata and delete JobContributorLookup and TestPlanTestPlanLookup.
    6. Expand Rational Quality Manager > Business View > Project Area, drag and drop Project in Business View and delete the empty Project Area folder in Rational Quality Manager > Business View > Project Area

Feedback