PxPlus IDE (Integrated Development Environment)

IDE Main Launcher (Windows)

 

When launched from a Windows platform, the IDE Main Launcher presents all the PxPlus development tools, installation and setup components in a tree-like format with expandable/collapsible nodes. Expanding a "parent" node (e.g. Data Management) displays a list of different tasks that are available under that category. Tasks are launched one task at a time; however, you can launch multiple tasks.

As of PxPlus 2020, the IDE Main Launcher has been enhanced with new Web capability and streamlined access to Menu, History and Project tasks. A new ribbon toolbar can be customized with up to ten buttons for launching commonly used tasks. This is done by using the drag-and-drop method or by right clicking on a selected task in the Menu list. Web pages (up to ten) can be added so that frequently used web sites are just a single click away. The IDE Main Launcher includes maintenance utilities for managing ribbon toolbar buttons and Web page tabs. A single button switches the Main Launcher to the standard IDE view, which does not include Web capability.

A Web version of the PxPlus IDE Main Launcher is also available that provides easy access to many of these PxPlus development and setup tools. See IDE Main Launcher (Web).

(The Windows version of PxPlus IDE was added in PxPlus 2014.)
(The Web version of PxPlus IDE was added in PxPlus 2016.)

Important Note:
If you are running a version of PxPlus that is higher than your activation, you will not be allowed to process any NOMADS panels due to potential compatibility issues.

 


Enhanced View


Standard View

Note:
When you update your system with subsequent versions of PxPlus, the IDE Main Launcher will reflect any new development tools or utilities that have been added, while keeping intact any tasks you have previously defined.

The IDE Main Launcher can switch between enhanced or standard view as desired by using the Expand/Collapse button (double-arrow); however, the IDE ribbon toolbar and HTML folder tabs are available in enhanced view only. If an Internet connection is not available, the IDE Main Launcher will display in standard view only.

Only one instance of the IDE Main Launcher can be displayed at a time. The size and location of the IDE Main Launcher persist when the dialog is closed so that these remain the same the next time the dialog is opened.

IDE Header

The IDE title bar displays the PxPlus version associated with the IDE Main Launcher (i.e. PxPlus 2020 IDE) followed by the name of the current project.

If the IDE Main Launcher is running on WindX, the word "WindX" is included in the title (i.e. PxPlus 2020 IDE WindX).

(The capability to display "WindX" in the title when applicable was added in PxPlus 2016 Update 0001.)

Menu Bar Options

The menu bar consists of the following options: Projects, Menu, Update, About and Release Notes.

Projects

Create Project

Displays the Create Project dialog for creating a new project with the following details:

    

Name

Enter the name for the new project.

Directory

Enter the working directory for the project. Defaults to the path for the current working directory. You can enter a different pathname or click the Query button to select a different working directory.

Access

Select the level of accessibility to the project. Drop box selections are Private (default) and Public.

Edit Project

Displays the Edit Project dialog for modifying an existing project.

    

You can modify the Project, Name, Directory and Access fields for the current project (default) or select a different project from the Project drop box.

Note:
If the Default (Private) project is selected, only the Directory field can be changed. The Name and Access fields will be disabled.

If you modify a project that is not the current project, the current project will not be affected.

(Support to allow editing of the Directory for the "Default (Private)" project was added in PxPlus 2019 Update 1.)

(The capability to select any project for editing was added in PxPlus 2016 Update 0001.)

Delete Project

Displays a confirmation message prior to deleting the current project.

Note:
The Default (Private) project cannot be deleted.

Copy Project

Displays the Copy Project dialog (similar to the Edit Project dialog) for copying an existing project, including all its tasks, to a new project.

You can copy the current project (default) or select a different project from the Project drop box. Enter the new project Name and specify the Directory if it is different from the current working directory. Select the Access level for the new project (default is Private).

Note:
If the current project is copied, the Project drop box (on the IDE Main Launcher) switches to the new (copied) project automatically.

If a different project is copied, the Project drop box (on the IDE Main Launcher) is not changed and continues to display the current project.

Project Location

Launches the Define Project Data Location utility for specifying an alternate directory to store the project data files.

Menu

Task Definition

Launches the Task Definition dialog for creating and maintaining tasks.

Menu Maintenance

Launches the Menu Maintenance dialog.

Update

Launches the Update Manager dialog used for accessing the Online Update feature. See Online Update.

About

Launches a separate dialog with detailed licensing information about the current PxPlus installation. This information includes the Serial Number, PxPlus Software package, Expiry Date, User Count and Version.

(The About option was added in PxPlus 2017.)

Release Notes

Provides quick access to the Release Notes (in the PxPlus Online Help) that correspond with the current PxPlus installation.

(The Release Notes option was added in PxPlus 2019.)

Certain tasks are project related and therefore must be assigned to a project. Designating a task as project related is controlled by the Project Related? check box option on the Task Definition dialog. An icon precedes each of the tasks displayed on the Main Launcher. To distinguish between a project related and a non-project related task, different icons are used. For example, in the screen shot above, the icon for the project related task Data Dictionary Maintenance is a different color than the icon for the non-project related task CSV Import.

For a project related task, the current working directory is changed to the working directory defined for that project. If present, the Start_up program in that directory will be run prior to launching the task. Only one project can be worked on at a time.

The IDE Main Launcher can be customized to meet the needs of an individual or a company by using the tasks accessed through the IDE Maintenance category on the tree view. Those tasks consist of Task Definition, Menu Maintenance, Import Menu Structure and Export Menu Structure.

Project and Task Selection

When initially starting the IDE Main Launcher, a Default (Private) project is already provided. To create additional private and public projects, use the Create Project option on the Projects menu.

Tasks are launched one task at a time; however, multiple tasks can be launched. Tasks can be added to the IDE Ribbon Toolbar by dragging and dropping a selected task from the Menu list to the IDE ribbon toolbar, by using the Toolbar button or by selecting the Add to Toolbar option from the popup menu when right clicking on a task in the Menu list.

This section of the IDE Main Launcher consists of the following:

Project

Select the current project from the drop-down list of private and public projects that have been created. At least one project must be defined.

When a project is selected, the name of that project displays in the IDE header.

Hover the mouse pointer over the Project hyperlink to display a floating tip with the current Working Directory. Click the Project hyperlink to invoke the Edit Project dialog to modify the current project or select a different project.

Note:
When initially starting the IDE, a Default (Private) project will be created. This Default (Private) project cannot be deleted.

If the Default (Private) project is selected in the Edit Project dialog, only the Directory field can be changed.

(Support to allow editing of the Directory for the "Default (Private)" project was added in PxPlus 2019 Update 1.)

Toolbar

Click this button to launch the Maintain IDE Toolbar Buttons dialog.

(The Toolbar button was added in PxPlus 2020.)

Menu

Click this button to display a list of Menu tasks. Any number of tasks can be launched. See Menu Maintenance.

Note:
This button is not available in the PxPlus Web IDE.

The following grid side buttons are available:

(Open All/Close All)

Button that is used to toggle between opening or closing all tree view nodes.

(Refresh)

Button that is used to refresh the contents of the Menu display.

Right click on a Menu task to display the following popup menu:

Insert Task

Displays the Task Definition dialog for selecting the task to insert.

The task will be inserted below the selection currently highlighted on the tree view menu, depending on whether a parent node or a subordinate branch is highlighted.

Insert Task on Menu

(Available only when a parent node is highlighted)

Displays the Task Definition dialog for selecting the task to insert as a subordinate branch under the highlighted parent node.

Delete Task

(Available only when a subordinate branch is highlighted)

Removes the currently highlighted task from the tree view menu only.

Add to Toolbar

(Available only when a subordinate branch is highlighted)

Adds a button to the IDE Ribbon Toolbar for quick access to the highlighted task.

(The Menu button was added in PxPlus 2020.)

History

Click this button to display a list of the libraries, panels (windows and dialogs), programs, menus, queries, data dictionary tables and reports that have been recently accessed and/or created.

Note:
This button is not available in the PxPlus Web IDE.

A task type icon precedes each listed task. For a list that shows what these icons represent, hover the mouse pointer over the ? button beside the list box. Tasks are launched based on the current working directory to which they were associated at the time they were added to history.

Up to 25 tasks, including those flagged as favorites, can be saved to history. When this number is exceeded, the task list rolls forward to continuously reveal the most recent 25 tasks.

Note:
Programs and Data Dictionary tables are only updated to the History list when they have been modified.

The following grid side buttons are available:

Add/Remove from Favorites

Button that is used to toggle between adding or removing the "favorite" designation (star) to/from a highlighted task. Also available from the popup menu when right clicking on a highlighted task. Tasks flagged as "favorites" are repositioned to the top of the list.

Properties

Button that displays a Properties dialog with the following details about the highlighted task (for information only). Also available from the popup menu when right clicking on a highlighted task.

Task

Name of the highlighted task.

Type

Task type (i.e. library, window, data file, query, etc.).

Favorite

Indicates whether the task is flagged as "favorite".

Full Pathname

Path that indicates the file location.

Working Directory

Directory that was associated with the task at the time the task was saved to history (may not necessarily be the working directory for the project).

Projects

Lists all the projects in which the task is found.

Note:
Tasks may exist in multiple projects.

Refresh

Button that is used to refresh the contents of the History list with any new objects that have been recently accessed and/or created.

Task Type Icons

Button that displays a floating tip with a list of task type icons and their descriptions.

(The ? button was added in PxPlus 2017.)

Right click on a History task to display the following popup menu:

Add/Remove from Favorites

Same as the Add/Remove from Favorites grid side button.

Show Properties

Same as the Properties grid side button.

Add to Project xxxxxx

Adds the selected task to the current project xxxxxx displayed in the Project drop box, as well as the IDE Header. See Note below.

Add to another Project

Displays the Add to Project dialog for selecting another project to which the selected task will be added. See Note below.

Note:
The Add to Project xxxxxx option is not available for tasks that already exist in the current project.

For screen libraries, the Add to Project xxxxxx and Add to another Project options are not available. To add screen libraries to a project, double click on the screen library task to display the NOMADS Library Object Selection window. You can highlight only specific tasks and then select Projects > Add Selection(s) to Project from the menu bar or add all tasks by selecting Projects > Add All Objects to Project.

Project

Click this button to display a tree view list of all tasks for the current project, grouped into categories (i.e. screen libraries, programs, panels, reports, etc.).

Note:
This button is not available in the PxPlus Web IDE.

A task type icon precedes each listed task (same icons used to identify the History tasks). For a list that shows what these icons represent, hover the mouse pointer over the ? button beside the list box.

Refresh

Button that is used to refresh the contents of the Project display.

Task Type Icons

Button that displays a floating tip with a list of task type icons and their descriptions.

(The ? button was added in PxPlus 2017.)

Right click on a Project task to display the following popup menu:

Launch Task

Runs the selected task.

Remove from Project

Removes the selected task from the current project. When the last task listed under a main heading is removed, the main heading is removed at the same time.

Add to another Project

Displays the Add to Project dialog for selecting another project to which the selected task will be added.

(Enhanced/Standard IDE)

(Double arrow) Button that is used to toggle between the enhanced (with Web) or standard (without Web) IDE.

Note:
This button is not available in the PxPlus Web IDE.

(The Enhanced/Standard IDE toggle button was added in PxPlus 2020.)

Project Maintenance can be used to add one or more tasks of various types to a predefined project, as well as remove tasks, all at one time. To access this utility, select Project Maintenance from the PxPlus IDE category of the IDE Main Launcher tree view.

Only panels, queries, menus, programs and reports can be added to a project.

If adding a task to a project with a working directory that differs from the working directory for the task, a Working Directory Conflict message will display to notify you of this difference and inform you that continuing with this process may result in problems when accessing the task in the new project. At this point, you have the option to select OK to continue with adding this task to the project or select Cancel to terminate the process.

IDE Ribbon Toolbar and HTML Folders

The enhanced IDE Main Launcher includes a ribbon toolbar and HTML folder tabs, both of which can be easily customized so that commonly used tasks and information are readily accessible with just one click.

 


Toolbar button and IDE ribbon toolbar

 


Folders button and HTML folder tabs

This section of the IDE Main Launcher consists of the following:

(IDE Toolbar)

Ribbon toolbar that can be customized to display task buttons for quick access to commonly used PxPlus development tasks. See Maintain IDE Toolbar Buttons.

Folders

Button that launches the Maintain IDE HTML Tabs dialog for adding and maintaining HTML tabs.

Home
Back
Forward
Refresh

Buttons that are used to navigate and refresh the Web site that is associated with the currently selected HTML tab.

(The IDE ribbon toolbar, HTML tabs and navigation buttons were added in PxPlus 2020.)

Maintain IDE Toolbar Buttons

The Maintain IDE Toolbar Buttons dialog is used to add, maintain and delete task buttons in the IDE ribbon toolbar. A maximum of ten task buttons can be added.

To invoke this dialog, click the Toolbar button. Alternatively, right click on an existing task button in the ribbon toolbar and select Maintain Toolbar from the popup menu.




This dialog consists of the following:

Button#

Task button order.

Task

Task name. Click the Query button (magnifying glass) for a list of the tasks defined in Task Definition.

Description

Enter the task description (optional) that will display below the task button in the ribbon toolbar.

If the task is dragged and dropped from the Menu list to the ribbon toolbar, the description will default from Task Definition and can be modified if needed.

If the task is selected from the Query button, the description will not default. It can be manually entered or left blank.

Bitmap

Enter the bitmap (optional) to display for the task button in the ribbon toolbar.

If the task is dragged and dropped from the Menu list to the ribbon toolbar, the bitmap will default from Task Definition and can be modified if needed.

If the task is selected from the Query button, the bitmap will not default. It can be manually entered or left blank.

Move Up
Move Down

Rearranges the order of the task buttons in the ribbon toolbar.

Delete Row

Removes the selected task button from the ribbon toolbar only. The task definition is not removed.

OK

Saves any changes and closes the Maintain IDE Toolbar Buttons dialog. New buttons, if defined, are added to the ribbon toolbar (in Button# sequence).

Cancel

Cancels any changes and closes the Maintain IDE Toolbar Buttons dialog.

 

Note:
A task button can be added directly to the ribbon toolbar in other ways:

     Drag and drop a task from the Menu list to the ribbon toolbar. OR

     Right click on a task in the Menu list and select the Add to Toolbar option from the popup menu.

(The Maintain IDE Toolbar Buttons dialog was added in PxPlus 2020.)

Maintain IDE HTML Tabs

The Maintain IDE HTML Tabs dialog is used to add, maintain and delete HTML tabs in the IDE Main Launcher. A maximum of ten HTML tabs can be added.

To invoke this dialog, click the Folders button below the ribbon toolbar.







This dialog consists of the following:

Tab#

Tab order.

Tab Name

Enter the text to display on the tab or select a pre-defined tab name from the drop-down list.

Note:
The Help tab cannot be moved or deleted.

Tab URL

Specify the URL to use for the tab.

Note:
The URL can be any valid Web address.

Move Up
Move Down

Rearranges the order of the tabs.

Delete Row

Removes the selected tab.

OK

Saves any changes and closes the Maintain IDE HTML Tabs dialog. New tabs, if defined, are added (in Tab# sequence).

Cancel

Cancels any changes and closes the Maintain IDE HTML Tabs dialog.

(The Maintain IDE HTML Tabs dialog was added in PxPlus 2020.)

Task Definition

The Task Definition dialog is used to define tasks that are to be performed in an application. You can enter a new Task Name and Description or click the Query button (binoculars) to select an existing task name from the list.

This dialog is invoked by selecting IDE Maintenance > Task Definitions from the main tree view or by selecting Menu > Task Definition from the main menu bar.

The available options are presented on two tabs, Logic and Display:

Logic

Task type

Click the drop-down arrow for a list of transaction types:

Menu/Sub-Menu

These tasks are menus to be displayed on the Launcher. For example, select the task IDE_MAINT from the Task Name query list to see the Task type for this menu.

Object to instantiate

These tasks instantiate objects within a new session of PxPlus.

Program to run

A task that simply needs to run a program is defined using this Task type.

Report to produce

A task that needs to display a report in the Report Viewer.

Screen to process

A task that needs to process a NOMADS panel.

Web Service

A task to run a Web Service. 

(The Web Service task type was added in PxPlus 2017.)

Project Related?

Check box to indicate if the current task is assigned to a project.

Windows Only?

Check box to indicate if the current task is for Windows only. These tasks will not appear in the tree view when not in a Windows environment.

PxPlus Task?

Check box to indicate if the current task is a PxPlus task. Internal field.

Task for

Click the drop-down arrow for a list of possible locations from which this task can be launched: Both Desktop and Web, Desktop Only, Web Only.

Panel/Program

(Not Applicable for Menu/Sub-Menu Task Type)

Enter the panel/program that is associated with launching the task. See Examples - Panel/Program by Task Type.

Parameter 1 - 4

These four fields are used to define parameters to be passed when launching a program, panel or object.

Display

ICON/Image

If no bitmap is specified for a transaction, the standard menu and task bitmaps are used. However, these may be overridden for individual tasks by entering bitmap information in this field.

Wiki/URL

Used to enter a Wiki page or URL address containing online help associated with the current task.

Examples - Panel/Program by Task Type

The table below provides examples of Panel/Program entries for each applicable task type.

Task Type

Panel/Program

Object to instantiate

Enter the object pathname:

Example:

  *ide/tasks

This example instantiates the *ide/tasks object.

Program to run

Enter the program pathname:

Example:

  *plus/util/dictdef

This example runs the *plus/util/dictdef program.

Report to produce

Enter the report pathname:

Example:

  *plus/winutl/windows_services.pvr

This example displays the list of Windows Services defined in the Report Viewer.

Screen to process

Enter the screen and the screen library:

Example:

  Themes;*win/scrnlib.en

This example processes the Themes screen located in the *win/scrnlib.en library.

Web Service

Enter a Web Service ID or a URL. If entering a Web Service ID, a Web server other than localhost can be specified as Parameter 1. See PxPlus Web Services.

(The ability to enter a host URL was added in PxPlus 2018.)

Example 1:

  Panel/Program:  id=CLIENT_QRY

This first example processes the CLIENT_QRY Web Service (defined in Web Services Maintenance) by running the EZWeb Server locally.

Example 2:

  Panel/Program:  http://servername:8888/services/rpt.pxp?rpt=gl_trialbal.pvr&type=html

This second example processes the specified Web Service report using the "servername" Web server running on port 8888.

Example 3:

  Panel/Program:  id=CLIENT_QRY
  Parameter 1:      http://servername:8888

This third example processes the CLIENT_QRY Web Service (defined in Web Services Maintenance) using the "servername" Web server running on port 8888.

Once a Web Service task has been defined, you can add this task to a menu using Menu Maintenance and then launch it from the IDE Main Launcher. The results of the Web Service will be displayed on a resizable panel. If a Web Service ID is entered without a server name and port specified as Parameter 1, the task will be launched running the EZWeb Server locally.

Below is an example of the CLIENT_QRY Web Service launched from the IDE Main Launcher.

Note:
When selecting to launch a Web Service task, EZWeb Server will automatically start (if not already running), using the saved EZWeb Server settings. If a port for EZWeb to use has not been assigned, a message will prompt you to define the port.

When running WindX, the Web Service task will not be allowed to start, and a message will display.

Menu Maintenance

The Menu Maintenance dialog allows tasks previously defined through Task Definition to be added to a menu or sub-menu for display on an application launcher. Invoke this dialog by expanding the IDE Maintenance category on the tree view and selecting Menu Maintenance or by selecting Menu > Menu Maintenance from the Launcher menu bar.

This dialog consists of the following:

Menu Entry

This drop-down list is loaded with all tasks defined with the Task type Menu/Sub-Menu.

System Transactions
Transactions in selected menu

System Transactions (on the left) is a list of tasks that are not yet located on the selected menu.

Transactions in selected menu (on the right) is a list of tasks currently on the selected menu.

Double-click or drag-and-drop a task to move it from left to right.

Delete

Deletes a selected item from the Transactions in selected menu list (on the right). Pressing the Delete key also deletes a selected item.

Up
Down

Use these buttons to change the item order in the Transactions in selected menu list (on the right).

Reset

This button becomes available after a change has been made to the Transactions in selected menu list (on the right). Click this button to revert to the initial state of the menu.

Save

This button becomes available after a change has been made to the Transactions in selected menu list (on the right). Click this button to save the changes.

Close

Closes the Menu Maintenance dialog. If any unsaved changes are detected, you are prompted to save the changes.

Import Menu Structure

The Import Menu Structure dialog allows a menu structure to be imported. Invoke this dialog by expanding the IDE Maintenance category on the tree view and selecting Import Menu Structure.

In this dialog, the box on the left displays the existing menu structure. The box on the right displays the name and structure of the menu to be imported.

Export Menu Structure

The Export Menu Structure dialog allows either the entire existing menu structure or a portion of it to be exported. Invoke this dialog by expanding the IDE Maintenance category on the tree view and selecting Export Menu Structure.

In this dialog, click the Select All button to select all the menu items for export. To export only specific sub-menus or individual menu items, click the Unselect All button to clear all selections, and then click the check box beside only the desired items.

See Also

Project Maintenance
Adding Tasks to Projects from Other Locations
IDE Main Launcher (Web)