Utility Programs

Project Maintenance

Project Maintenance is used to add one or more tasks of various types to a predefined project, as well as remove tasks -- all at one time. This provides the convenience of organizing and managing your projects from one central location.

However, you may find that, while working on a specific task, you need to add that task to a project. This is done either by using Project Maintenance or by accessing the Projects menu from within your current working location. See Adding Tasks to Projects from Other Locations.

(The Project Maintenance utility was added in PxPlus 2014 - Feature Pack 1.)

When a project is created, the data that defines the project contents are by default stored in two data files, wkids.dat and wkseq.dat, in the *plus/proj directory. To provide flexibility when managing your projects, you have the option to specify an alternate directory for storing these project data files instead of using the default *plus/proj directory. See Define Project Data Location utility.

(The Define Project Data Location utility was added in PxPlus 2017 Update 0002.)

Invoke the Project Maintenance utility from the PxPlus IDE Main Launcher by selecting Project Maintenance (near the bottom of the PxPlus IDE tree view).

The following Task Types can be selected:

These Task Types, along with the options and buttons available in this window, are explained below.

Project

Select the project to be maintained from the list of available Public and Private projects.

The Project hyperlink launches the Edit Project window for editing the name and directory of the selected project.

Working Directory

Displays the working directory for the selected project.

This pathname is also used as the starting directory when you select the Query button (see Type below) to locate a Library or Directory.

Type

Selections are:

Library

(Default) Used to specify a NOMADS library file. Enter the full pathname for the library file or select the Query button.

Directory

Used to specify the directory containing the NOMADS library files to use. Enter the full pathname for the directory or select the Query button.

See Task Types to Maintain below.

Include Sub-Directories

(Available When Type is Directory)

Select this check box to include tasks (based on the Task Types selections) found in the sub-directories of the specified directory. (By default, this check box is not selected.)

When Type is Library, this check box is not displayed.

Note:
The Include Sub-Directories check box does not apply to data dictionary entries. Only the data dictionary in the specified directory can be maintained using this utility.

(The Include Sub-Directories check box was added in PxPlus 2017.)

Task Types to Maintain

If the selected Type is Library, only the Library Objects check box is selected. All other Task Types (Programs, Reports, Data Files, Data Dictionary) are not applicable.

If the selected Type is Directory, all the Task Types check boxes are selected by default. These Task Types are explained below.

Library Objects

Library objects (Windows, Dialogs, Popup Menus and Queries) in the selected library/directory are loaded into the list box.

Programs

All programs in the selected directory (except some PxPlus system programs) are loaded into the list box.

Reports

All Report Writer reports in the selected directory are loaded into the list box.

Data Files

All data files in the selected directory (except some PxPlus system files) are loaded into the list box.

Data Dictionary

If a PxPlus data dictionary exists in the selected directory, all entries in the data dictionary file (except the Global Dictionary) are loaded into the list box.

HTML Pages

The Webster+ File Maintenance HTML pages in the selected directory (or sub-directories, if included) are loaded into the list box.

When selecting a directory for loading HTML pages, keep in mind that generated HTML pages are stored in a predefined Webster+ directory. See the Webster+ > Directory menu option in Library Object Selection.

(The HTML Pages task type was added in PxPlus 2021.)

Note:
When you select/deselect any of the Task Types check boxes, the list box is reloaded, and any previous selections are lost.

Select Tasks for Project

A list box showing a tree view display of the tasks found in the specified library or directory, based on the Task Types to Maintain selections. Each "parent" node represents a selected Task Type. Expand/collapse a single "parent" node by clicking the adjacent + plus or - minus sign.

If a check mark exists next to a task when you expand the "parent" node, this indicates that the task is already associated with the selected project.

To add a task to the selected project, select the check box next to that task.

To remove a task from the selected project, deselect the check box next to that task.

Note:
If the selected directory contains a large number of files and/or libraries, the list box may take a few moments to load. When loading is complete, the list box will display all applicable tasks, based on the selections.

Expand/Collapse

Toggle button that is used to either expand or collapse all the "parent" nodes for the tasks in the tree view.

Expand/collapse a single "parent" node by clicking the adjacent + plus or - minus sign.

Reset

Discards any unapplied changes and reloads the Select Tasks for Project list box. When it reloads, only the changes that were previously saved remain intact.

Ok

Saves the changes to the selected project and returns to the PxPlus IDE Main Launcher.

At the same time, a Tasks Added/Removed message box reports the number of tasks added or deleted from the selected project.

Apply

Saves the changes to the selected project without exiting Project Maintenance.

At the same time, a Tasks Added/Removed message box reports the number of tasks added or deleted from the selected project. In addition, the selections for Project, Type and Task Types persist (remains unchanged). This allows you to continue selecting/deselecting tasks for the project using the same settings.

Cancel

Clears the current entry, except for Project, Working Directory and Type. (The Task Types to Maintain selections and Include Sub-Directories check box are not changed.)

Exit

Closes Project Maintenance and returns to the PxPlus IDE Main Launcher without saving any current changes.