Working with Application Designer Projects in PTF Client

The PTF client enables you to inspect and maintain the test contents of an Application Designer project, and complete the following tasks:

Create new Application Designer projects.
Open existing Application Designer projects.
Insert tests into Application Designer projects.
Remove tests from Application Designer projects.
Set the upgrade action type for the tests within Application Designer projects.

Access to this feature is limited to PTF Administrators. In addition, the appropriate PeopleTools security roles and permissions necessary to administer Application Designer projects are required. Only test-related data within a project is modified; any other content that exists within the project is not affected.

Note: This section assumes you are already familiar with Application Designer projects. For detailed information about Application Designer Projects, see Application Designer Developer’s Guide.

Use the Projects dialog box to manage Application Designer projects within the PTF client.

To access the Projects dialog box, select the @<PTF Environment Name> > Projects menu command.

Use these fields and controls to open or create a project:

Field or Control	Definition
Project	Select a project.
Open	Click to open the selected project. This option is not available if the Project field is blank, or a project with pending changes is open.
New	Click to create a new project. At the prompt, enter a unique project name. This option is not available if a project with pending changes is open. Note: •New projects are not saved until a test object is inserted and you click the Apply button.

Field or Control

Definition

Project

Select a project.

Open

Click to open the selected project. This option is not available if the Project field is blank, or a project with pending changes is open.

New

Click to create a new project. At the prompt, enter a unique project name.

This option is not available if a project with pending changes is open.

Note: •New projects are not saved until a test object is inserted and you click the Apply button.

The grid area serves as a worksheet that lists the following information about the project’s tests.

Field or Control	Definition
Test	The test name.
Folder	The name of the folder the test belongs to.
Upd By	The user ID of the person that last updated the test.
Updated	The date and time the test was last modified.
Version	The test version.
Action	The upgrade action associated with this project test record, either `Copy` or `Delete`. By default, the action is set to `Copy` when the test is initially inserted into the project. To change the upgrade action, click the Action - Copy or Action - Delete button.
Status	The status of the project test record. This updates automatically while you interact with the project using this dialog box to show the changes made during the current session. Once you apply the changes, the status resets. Values are: `New` Indicates the test record was inserted during this session. `Changed` Indicates the upgrade action was changed during this session. `Removed` Indicates the test record was set to Removed during this session. No entry (blank). Indicates no changes were made during this session.

Initially, when you open the Projects dialog box, the grid is empty. It populates when you:

Open a project that contains tests.
Add tests by using the Insert button.

Use these buttons to interact with the project worksheet.

Field or Control	Definition
Select All	Click to select all of the tests in the grid.
Deselect All	Click to deselect all of the tests in the grid.
Action - Copy	Click to set the upgrade action type to copy.
Action - Delete	Click to set the upgrade action type to delete.
Remove	Click to remove selected tests from the project.
Insert Tests	Click to insert tests into the current project. A window appears that enables you to select the tests from to insert. Currently active filters are applied to the view. You can select multiple tests or folders. If a parent folder is selected, tests from its associated child folders are included.
Apply	Click to commit all pending changes to the project. The Projects dialog box remains open.
Close	Click to close the dialog box. If there are any pending changes, you are prompted to save.

Important! Project content is not dynamic; it is a snapshot of the test data at the time it was inserted into the project. If you modify a test after you have included it in a project, you must re-insert that test into the project in order for the project to contain the revised test data.

Creating a New Project

To create a new project:

Select the @<PTF Environment Name> > Projects menu command.
The Projects dialog box opens.
Click the New button.
At the prompt, enter a name for the new project, and click OK.
The Projects dialog box reappears. The Project field displays the new project name, and becomes unavailable. The Open and New buttons are disabled.

Opening an Existing Project

To open an existing project:

Select the @<PTF Environment Name> > Projects menu command.
The Projects dialog box opens.
Select a project from the Projects list box.
Click the Open button.

If any tests are currently associated with the project, they appear in the grid.

Inserting Tests into a Project

To insert tests into a project:

Select the @<PTF Environment Name> > Projects menu command.
The Projects dialog box opens.
Open an existing project, or create a new project.
Click the Insert button.

The PTF Explorer tree appears in the PTF Suite window.
Expand folders as needed to access and select the tests to insert (use Ctrl-Click to select multiple tests).
Click OK.
Click Apply to insert the tests into the project.

Removing Tests from a Project

To remove tests from a project:

Open an existing project.
Select one or more tests in the grid.
Click Remove.
Click Apply.

Setting the Upgrade Action Type for Test(s) in a Project

To set the upgrade action type for test(s) in a project: