Skip to Main Content
Return to Navigation

Creating Test Maintenance Reports

This section discusses how to create test maintenance reports using the Create Test Maintenance Report wizard.

Access the Create Test Maintenance Report wizard (PeopleTools, Lifecycle Tools, Test Framework, Create Test Maintenance Report).

The wizard consists of four steps:

Step 1 of 4: Manual Tasks

For a given change project the tasks for Step 1 only need to be executed once.

The first step in creating a test maintenance report comprises five manual tasks that you will complete in Application Designer to create a compare report that PTF will use as a basis for the maintenance report.

Perform these tasks to create a compare report from a project file.

Access the Create Test Maintenance Report wizard (PeopleTools, Lifecycle Tools, Test Framework, Create Test Maintenance Report).

Image: Create Test Maintenance Report Wizard: Step 1 of 4

This example illustrates the fields and controls on the Create Test Maintenance Report Wizard: Step 1 of 4. You can find definitions for the fields and controls later on this page.

Create Test Maintenance Report Wizard: Step 1 of 4

As you progress through the Test Maintenance wizard the wizard tracks which tasks you have completed and which page you are on. When you exit the wizard and then return to the wizard again, the wizard sends you to the last visited page.

This tracking is done according to user ID. This means that if two users share the same user ID, the second user might not enter the first page when accessing the wizard. The wizard will take the second user to where the previous user left the wizard.

If two users with different user IDs work on the same project, the wizard does not track the state for the second user. For instance, if the first user completed the tasks for Step 1, the second user needs to check the five tasks on Step 1 to bypass that step.

Task 1: Import only the project definition for the change project.

Suppose you are about to apply a change project named SA_PROJ_ UPGD. Before the change project is applied, import the change project, SA_PROJ_ UPGD, as a project definition only.

  1. In Application Designer, select select Tools, then select Copy Project, then select From File.

  2. In the selection box, highlight the change project, SA_PROJ_UPGD.

  3. Click Select.

    The Copy From File dialog box appears.

  4. Click the Deselect All button to deselect all of the definition types so that only the empty project structure is imported.

    At this point, you are importing only the names of the definitions into the project. None of the actual definitions in the upgrade project are copied.

    If a definition exists in the original database with the same name as a definition in the upgrade project, the upgrade project in the database will (correctly) contain the original, unmodified definition of the object.

  5. Click Copy.

Task 2: Rename the change project imported in Task 1 to create the snapshot project.

Create a copy of the change project, SA_PROJ_UPGD.

Select select File, then select Save Project As and name the new project SA_PROJ_SNAP.

Creating the Snapshot Project is required to avoid naming conflicts later in the process.

Task 3: Create a snapshot of the original metadata definitions by exporting the snapshot project created in Task 2 to file.

Export the snapshot project, SA_PROJ_SNAP, to file:

  1. Select Tools, Copy Project to File.

  2. If this project is large, as upgrades often are, you can save time during the compare process by deselecting all definitions in the Copy Options window, except for the five definitions that are referenced by PTF tests:

    • Menus

    • Components

    • Pages

    • Records

    • Fields

  3. Accept the defaults and click OK.

Task 4: Import the change project (definition and objects).

Import the original change project, SA_PROJ_UPGD, from file:

  1. Select Tools, Copy Project From File.

  2. Include all the definition types.

At this point, the database contains the new metadata.

Task 5: Compare the snapshot project (from file) to the database, saving the compare output to tables.

Compare the current (target) database with the pre-change (source) project, SA_PROJ_SNAP:

  1. Select select Tools, then select Compare and Report, then select From File.

  2. Highlight the snapshot project, SA_PROJ_SNAP, and click the Select button.

    The Replace existing SA_PROJ_SNAP? dialog box appears.

  3. Click Yes.

    The Compare and Report From File dialog box appears.

  4. Click Options to access the Upgrade Options dialog box.

  5. Select the Report Options tab.

  6. Select the Generate Output to Tables check box.

  7. Select the Report Filter tab.

  8. Click Select All.

  9. Click OK.

  10. Click Compare.

The wizard will use data from this compare report to create the test maintenance report.

Step 2 of 4: Analyze Compare Data

This example shows Step 2 of 4:

Image: Create Test Maintenance Report Wizard: Step 2 of 4

This example illustrates the fields and controls on the Create Test Maintenance Report Wizard: Step 2 of 4. You can find definitions for the fields and controls later on this page.

Create Test Maintenance Report Wizard: Step 2 of 4

For a given change project the tasks for Step 2 only need to be executed once. This analysis is based only on the compare data, not on the test data, so changes to tests do not affect the result. The relationship between this analysis and test data is calculated in Step 3: Generate Impact Report. You may generate multiple Impact Reports based on a single analysis as tests change.

In this step, PTF analyzes data from the compare you performed in Wizard Step 1, Task 5.

  1. For the project compare report you created in Wizard Step 1, Task 5, specify whether the Compare Type is From File or To Database.

  2. Click Analyze.

    This will launch the Application Engine program PSPTANALYSIS.

  3. When the analysis is complete a pop-up appears. Click Next to continue.

Note: A project name can appear more than once in the list because the Compare Output to Table feature stores data by both project name and compare date/time. The most recent compare will appear first in the list.

Step 3 of 4: Select an Analyzed Project

This example shows Step 3 of 4:

Image: Create Test Maintenance Report Wizard: Step 3 of 4

This example illustrates the fields and controls on the Create Test Maintenance Report Wizard: Step 3 of 4. You can find definitions for the fields and controls later on this page.

Create Test Maintenance Report Wizard: Step 3 of 4

Use this page to select the analysis data PTF will use to generate the report.

Sets of compare data are listed by project name, the date and time the compare was generated, and the date and time the analysis was run.

Select the Delete check box and click Delete Selected to delete analyses.

Step 4 of 4: Generate Report

This example shows Step 4 of 4:

 

Image: Create Test Maintenance Report Wizard: Step 4 of 4

This example illustrates the fields and controls on the Create Test Maintenance Report Wizard: Step 4 of 4. You can find definitions for the fields and controls later on this page.

Create Test Maintenance Report Wizard: Step 4 of 4

For a given change project you will use this page to generate multiple reports as changes are made to the PTF test metadata. As you make changes to tests based on the results of this report, rerun the report to verify that the issues were corrected. You can run this report repeatedly as you make changes to tests without having to redo Step 1 through 3.

Follow these steps to generate a report:

  1. Select the test or tests to use to generate the report.

    Click Select All to select all tests.

  2. Select the report format.

  3. Click Generate Report to have PTF create the test maintenance report.

Running a Test Report from PTF Client

As you modify a test based on the results of a maintenance report, you can validate the test by running a test report from the PTF client. The report is generated for a single test, using analyses generated in Step 2 of the Test Maintenance Wizard.

  1. In PTF Explorer, right-click on a test.

  2. From the context menu, select Validate Test.

  3. The Validate Test – Analysis Project list dialog box appears.

  4. Select an analysis from the list and click Open.

    The test maintenance report opens in a new window in the PTF client.