To access the PROPATH properties page, right-click an OpenEdge project name in the Project Explorer view and choose Properties from the context menu. Expand the Progress OpenEdge node in the tree view, and then click the PROPATH node.
Note: If you chose the shared AVM for the currently selected project, the settings on this property page will appear dimmed. They cannot be changed on this page, and they may also be inaccurate. You must go to the PROPATH page under the Shared OpenEdge AVM preference page to view or to change these settings. Select Window > Preferences from the main menu bar. Then open Progress OpenEdge > Shared AVM > PROPATH from the tree view. Also, be aware that settings changed on the Shared OpenEdge AVM/PROPATH preference page affect all projects that use the shared AVM.

The PROPATH tab lets you control where the AVM searches for files and procedures. The following controls are available on the PROPATH tab:

PROPATH viewer Displays PROPATH settings in a tree view format. You can expand nodes to see more detail about a particular setting. It usually opens with a default list of typical settings, which you can modify with the controls on the left of the page.

The settings should include all locations that might contain files needed for your application, and should be arranged in an appropriate search order.

A PROPATH entry can be either a directory or a procedure library.

By default all PROPATH entries are part of the OpenEdge tooling. To exclude a PROPATH entry from OpenEdge tooling, select the Exclude from OpenEdge tooling node under the PROPATH entry that you want to exclude. The Exclude from OpenEdge tooling node appears as a child node for each PROPATH entry.

Move Up, Move Down Changes the position in the list of a current entry, and thus changes the search order.
Remove Deletes an entry from the list.
Edit Changes the value of the current entry.
Add Procedure Library Adds a procedure library from the selected project.
Add External Library Adds a procedure library from the file system.
Add Workspace Directory Adds a directory from the current workspace.
Add External Directory Adds a directory from the file system.
Add Standard Paths Displays a list of common locations that you can choose to add to your PROPATH setting.

Elements and attributes

The .propath file present in an Progress Developer Studio for OpenEdge (PDSOE) consists of the following attributes with their possible values.

Element Attribute Description
propath

The root element of the project.
version

This represents the OpenEdge version.
propathentry

This element represents a propath entry.
platform

The operating system used by the project.

Select from the following values:
  • All
  • Linux
  • Window
kind

The references used by the project.

Select from the following values:
  • con
  • src
  • lib
  • dir
  • proj
  • folder
  • file

For more information, see kind attribute values topic.
name

The standard paths referenced by the project.

In some cases, PDSOE defines standard path in the following ways:
  • kind="con" name="Standard Source Paths" path="com.openedge.pdt.text.SRC_PATHS"
  • kind="con" name="Standard WebSpeed Paths" path="com.openedge.pdt.text.WEB_LIBRARIES"
env

The environment used by the project.

Select from the following values:
  • all
  • gui
  • tty
  • web

For more information, see env attribute values topic.
path

The path of the propath.

If kind=con, this attribute is the ID of the standard path.

For more information, see Standard paths topic.
output

The build location (in case of kind-src).

If the output location is not provided the project uses the default build location.
excluding

The pattern excluded while building the project (in case of kind=src). Use “|” symbol to enter multiple entires.
includeTooling

The flag used to determine whether the propath entry must be considered for the OpenEdge tooling support in PDSOE.

Select from the following values:
  • true
  • false

kind attribute values

This table provide additional information about the various kind attribute values.

kind attribute value

 Description Example

con

 This is a reference to a standard path container. The path represents the name of the container that is used to resolve the actual PROPATH entries. <propathentry env="gui" kind="con" path="com.openedge.pdt.text.GUI_LIBRARIES" platform="All"/>

src

 This is a reference to a source directory. <propathentry env="all" kind="src" path="@{ROOT}" platform="All"/>

lib

 This is a reference to a procedure library. This may be a fully qualified path to a procedure library in the local file system.
Note: In PDSOE, the Add External Library option is used to add this entry.
<propathentry env="all" kind="lib" path="C:\Progress\OpenEdge\tty\ablunit.pl" platform="Windows"/>

dir

 This is a reference to a directory. This may also be the fully qualified path of a local file system directory.
Note: In PDSOE, the Add External Directory option is used to add this entry.
<propathentry env="all" kind="dir" path="@{ROOT}\propathDir" platform="All"/>

<propathentry env="all" kind="dir" path="C:\Users\user-name\eclipse-workspaces\runtime-New_configuration\p1\src2" platform="Windows"/>

proj

 This is a project reference in the PROPATH. If this is included in a PROPATH, this means that the PROPATH from the referenced project is to be inserted at the position of this propath entry. <propathentry env="all" kind="proj" path="pp2" platform="All"/>

folder

 This is a reference to a folder resource. The path points to a workspace relative location of a folder within the workspace. The referenced folder may or may not actually exist. Variable substitution is not performed on the path.
Note: In PDSOE, the Add External Directory option is used to add this entry.

<propathentry env="all" kind="folder" path="\propathAtt\src1" platform="All"/>

<propathentry env="all" kind="folder" path="\p1" platform="All"/>

file

 This is a reference to a file resource. The path points to a workspace relative location of a file within the workspace. The referenced file may or may not actually exist. The referenced file is typically a procedure library but is not required to be. Variable substitution is not performed on the path.
Note: In PDSOE, the Add External Library option is used to add this entry.

<propathentry env="all" kind="file" path="\p1\prodict.pl" platform="All"/>

<propathentry env="all" kind="file" path="\p1\OpenEdge.Net.pl" platform="All"/>

env attribute values

This table provide additional information about the various env attribute values.

env attribute value

 Description Example

gui

 This environment setting represents the PROPATH entry that must be included in the PROPATH only when using the GUI executable. <propathentry env="gui" kind="con" path="com.openedge.pdt.text.GUI_LIBRARIES" platform="All"/>

tty

 This environment setting represents the PROPATH entry that must be included in the PROPATH in a TTY environment. <propathentry env="tty" kind="con" path="com.openedge.pdt.text.TTY_LIBRARIES" platform="All"/>

web

 This environment setting represents the PROPATH entry that must be included in the PROPATH only in a Webspeed environment. <propathentry env="web" kind="con" name="Standard WebSpeed Paths" path="com.openedge.pdt.text.WEB_LIBRARIES" platform="All"/>

all

 This is the default environment setting for all propath entries. This environment setting represents the PROPATH entry that must included in all PROPATHs. <propathentry env="all" kind="src" output="@{ROOT}\rcode" path="@{ROOT}\src" platform="All"/>

Special variables

The .propath file can also use the following special variables:
  • ROOT—This is an OEA variable substitution that represents the directory location of the containing project. It is equivalent to IProject.getLocation() in PDSOE.
  • WORK—This is an OEA variable substitution that represents the directory location of the working directory specified for an OpenEdge project. It is equivalent to OEProject.getRuntimeConfiguration().getWorkingDirectory() in PDSOE.
  • RCODE—This represents the build destination of the project.

Standard paths

This table provide additional information about the various standard paths that can be in a .propath file.

See oeide\src\com.openedge.pdt.project\src\com\openedge\pdt\project\standardpaths.xml file for the complete list of paths.

id Name env

com.openedge.pdt.text.GUI_LIBRARIES

 Standard GUI Libraries gui

com.openedge.pdt.text.TTY_LIBRARIES

 Standard TTY Libraries tty

com.openedge.pdt.text.DLC_PATHS

 Installation Paths all

com.openedge.pdt.text.WEB_LIBRARIES

 Standard WebSpeed Paths web

com.openedge.pdt.text.DYNAMICS_LIBRARIES

 Standard Progress Dynamics Libraries gui

com.openedge.pdt.text.SRC_PATHS

 Standard Source Paths all

com.openedge.pdt.text.ADERES

 Graphical Results Procedure Library gui