This document covers the following topics:

• General Information on Local Mode

• Using the Natural Navigator View

• Customizing the Natural Navigator View

• Filtering Natural Objects and Libraries

• Using the Details View

---

General Information on Local Mode

When working in local mode, you have to deal with Natural projects that are shown in the Project Explorer and Natural Navigator views. Projects are essential parts of the Eclipse environment. In Eclipse, the resources (folders and files) in the workspace are always organized in projects.

The Project Explorer view is a standard Eclipse view and always shows a project as it is physically stored in the file system. The Natural Navigator view, however, allows you to manage, view and/or filter your Natural projects in several Natural-specific ways; see Using the Natural Navigator View for more information.

The following example shows how the projects that are displayed in the Project Explorer view can be displayed in the Natural Navigator view. According to the settings of the toggle buttons, the Natural Navigator view shows only Natural projects, the root folder "Natural-Libraries" is hidden and the objects are logically grouped by type.

A Natural project contains the contents of one or more Natural libraries, and also other folders and files which are added by other components of NaturalONE, such as Ajax Developer. A Natural project is indicated by the following icon: .

By default, the environment to which a Natural project pertains is shown next to the project name. The number in parentheses which is also shown next to the project name indicates the number of Natural libraries in this project. This is part of the so-called label decoration.

Important information for this environment (such as the Natural parser settings or whether the environment is protected by Natural Security) is stored in the properties of the project. See Changing the Project Properties.

Using the Natural Navigator View

The Natural Navigator view is a Natural-specific view. If it is currently not displayed, you can display it as described in Showing a View of the NaturalONE Perspective.

Unlike the Project Explorer view, which always shows projects as they are physically stored in the file system, the Natural Navigator view can be configured to display projects logically. It lets you enable or disable various Natural-specific options for displaying Natural projects in the tree. In addition, it provides enhanced support, such as copying and pasting Natural objects. For more information, see Copying and Pasting Objects and Libraries.

The local toolbar of the Natural Navigator view provides the toggle buttons as described below. The view menu of the Natural Navigator view (drop-down menu at the top right of the view) contains the corresponding menu commands. When no toggle button is selected in the local toolbar of the Natural Navigator view, the Natural Navigator displays the same information as the standard Eclipse Project Explorer view.

Toggle Button	View Menu Command	Description
N	Show Natural Projects Only	When selected, only the Natural projects are displayed. When not selected, all projects in your Eclipse workspace (including, for example, your Java projects) are displayed.
R	Hide Root Folders	When selected, the root folders are not displayed. When not selected, all root folders (for example, "Natural-Libraries") are displayed in the Natural projects.
L	Show Library View	When selected, all objects in a Natural library are displayed as they would be stored on the server. The special folders SRC, ERR and RES are not displayed. When library folders have been defined, they are not displayed. When not selected, the Natural libraries and all objects in a library are displayed as they are physically stored in your Eclipse workspace in the file system. If library folders have been defined, their names are displayed (if more than one library folder has been defined for a single library, more than one node is displayed for the same library). This is similar to the representation in the Project Explorer view.
G	Group Objects by Type	When selected, all objects in a Natural library are logically grouped into different nodes, according to their object types. This is similar to the Natural Server view. For example, programs are grouped into a Programs node and subprograms are grouped into a Subprograms node. The special folders SRC, ERR and RES are not displayed. When not selected, all objects in a library are displayed as they are physically stored in your Eclipse workspace in the file system. However, whether the special folders SRC, ERR and RES are displayed depends on the setting of the Show Library View command (L toggle button). Note When the option Group new objects by object type has been selected for a Natural project, the physical representation may be the same as the logical representation. See also Group Folders.
U	Show Objects with Update Flags Only	When selected, only the modified Natural objects which still need to be updated in the Natural environment are displayed for a Natural project. These are the objects which contain specific flags in the label decoration. For more information, see Flags in a Label Decoration. When not selected, all objects of a Natural project are displayed.
F	Hide File Extension	When selected, the file extensions of the Natural objects are not displayed. When not selected, the file extensions of the Natural objects are displayed (for example, ".NSP" for a Natural program).

When the Natural Navigator view shows the objects in a logical way (that is, when they are not displayed as they are physically stored in the file system), the icons for the virtual libraries and group folders are displayed in gray.

Customizing the Natural Navigator View

You can customize the Natural Navigator view to hide items that you do not want to see.

To customize the Natural Navigator view

1. From the view menu of the Natural Navigator view (drop-down menu at the top right of the view), choose Customize View.

   The Available Customizations dialog box appears.

   

   In addition to the standard Eclipse filters, you can define the following filters which are displayed in the dialog box:

   Option	Description
   Items filtered by active Natural filters	When selected, the Natural filters that have been applied to a node are active and it is possible to set additional filters. The items that you do not want to see in the Natural Navigator view are not shown. This corresponds to the Activate Natural filters option in the Natural Filters dialog box. For more information, see Filtering Natural Objects and Libraries.
   Natural objects without update flags	When selected, all Natural objects are hidden which do not have update flags. Only the modified objects which still need to be updated in the Natural environment are shown. This corresponds to the Show Objects with Update Flags Only command in the view menu (U toggle button in the local toolbar) of the Natural Navigator view.
   Non-Natural projects	When selected, non-Natural projects (for example, Java projects) are hidden and only the Natural projects are shown. This corresponds to the Show Natural Projects Only command in the view menu (N toggle button in the local toolbar) of the Natural Navigator view.

2. Select the filters that you want to apply.

3. Click OK.

Filtering Natural Objects and Libraries

You can reduce the number of items that are displayed in the Natural Navigator view by using a filter. You must first define a filter and then set the filter on a node of the Natural Navigator view (for example, on a project or library node).

Detailed information is provided in the topics below.

• Managing the Natural Filters

• Defining a New Natural Filter

• Setting a Natural Filter

• Removing a Natural Filter

Managing the Natural Filters

To define a new Natural filter, you first have to invoke the Natural Filters dialog box as described below. Using this dialog box, you can also edit and delete existing Natural filters, or deactivate all Natural filters that have already been set in the Natural Navigator view.

To manage the Natural filters

1. From the view menu of the Natural Navigator view (drop-down menu at the top right of the view), choose Natural Filters.

   The Natural Filters dialog box appears.

   

   When the Activate Natural filters checkbox is selected (default), it is possible to add new filters, and to edit or delete existing filters. In addition, all Natural filters that have been set in the Natural Navigator view are active and it is possible to set further filters. See also Setting a Natural Filter.

   Notes:

   1. When you change the setting of the Activate Natural filters checkbox, the setting of the Items filtered by active Natural filters option in the Available Customizations dialog box is adapted accordingly (see Customizing the Natural Navigator View).
   2. The Natural Filters dialog box can also be invoked from the Set Natural Filters dialog box (see Setting a Natural Filter). However, the Activate Natural filters checkbox is not available in this case.

   When filters are already defined, they are displayed in the Natural Filters dialog box. When you move the mouse pointer over a filter, a tooltip is displayed to provide information on this filter. When you expand the node for a filter, you can see more detailed information on the filter. When the filter is currently active in the Natural Navigator view, a Set for node is displayed, informing you on which nodes this filter has been set. For example:

   

   The following command buttons are provided:

   Command Button	Description
   New	Defines a new filter. See also Defining a New Natural Filter.
   Edit	Edits the selected filter.
   Delete	Deletes the selected filter. See also Removing a Natural Filter.

2. Click OK to save the setting of the Activate Natural filters checkbox and to close the Natural Filters dialog box.

Defining a New Natural Filter

When you define a new Natural filter, you specify a name, a pattern (for example, that only items starting with the letter "L" are to be displayed), and additional optional filter attributes. The filters that you define can then be set on a node of a Natural project in the Natural Navigator view.

To define a new Natural filter

1. Invoke the Natural Filters dialog box as described above.

2. Make sure that the Activate Natural filters checkbox is selected. Otherwise, it is not possible to define a new filter.

3. Click New.

   The Define Natural Filter dialog box appears.

   

4. Specify the following information:

   Option	Description
   Filter name	The name for the filter. You can use any name (for example, "My Libraries").
   Filter pattern	The pattern for the filter, that is, the names of all items to be filtered. You can use wildcards (? or *) within the names if you do not want to enter each name individually. The question mark (?) may be specified at any position inside the name. The asterisk (*) is only allowed at the end of a name. You can also use the escape character (/) for literals. Note A tooltip for the wildcard and escape characters is displayed when you move the mouse pointer over this text box.
   Case sensitive	If selected, only items which match exactly the defined uppercase or lowercase letters in the pattern are displayed.
   Regular expression	If selected, the filter pattern is interpreted as a regular expression. In this case, you can press CTRL+SPACEBAR to invoke content assist for the regular expression.

5. Optional. Expand Filter scope and/or Filter type.

   Further filter attributes are shown in the dialog box.

   

6. To define the filter scope, select one or more of the following checkboxes:

   Option	Description
   Natural objects	If selected (default), the filter applies to the names of the Natural objects selected in the Restrict to group box. This group box is only visible when Natural objects is selected.
   Natural libraries	If selected, the filter applies to the names of Natural libraries.
   Files	If selected (default), the filter applies to the physical file names of Natural objects and non-Natural files.
   Folders	If selected, the filter applies to the names of library folders and non-Natural folders.
   All children (recursive)	If selected (default), all children of the selected node are filtered.

   Make sure to define a reasonable filter scope. By default, the filter applies to the names of all Natural objects, the corresponding physical file names, and the names of all child nodes. If you would select, for example, the Natural libraries checkbox in addition to the default setting, the filter would also apply to the names of the Natural libraries, which is redundant.

7. To define the filter type, select one of the following option buttons:

   Option	Description
   Include only	An Include only filter (default) allows only items that match the filter condition to be displayed in the Natural Navigator view. If multiple Include only filters exist, the items displayed will be those which match any of the existing Include only filters.
   Exclude all	An Exclude all filter prevents all items that match the filter condition to be shown in the Natural Navigator view. If multiple Exclude all filters exist, the items excluded will be those which match any of the existing Exclude all filters.

   If both Include only and Exclude all filters exist in a given folder or project, only items that match any of the Include only filters and do not match any of the Exclude all filters will be displayed in the Natural Navigator view.

8. Click OK to save your changes and to close the Define Natural Filter dialog box.

   The following settings are stored after the dialog box has been closed: size and position of the dialog box, and collapsed or expanded state of the Restrict to, Filter Scope and Filter Type group boxes.

Setting a Natural Filter

Each Natural filter can be set on a node of a Natural project in the Natural Navigator view.

When a Natural filter has been set, the icons that are displayed for the nodes contain additional plus signs. The background color of a plus sign indicates where the filter has been set. A green background indicates that the filter has been set on that node. A gray background indicates that the filter has been set on a parent node. Example:

To set a Natural filter

1. In the Natural Navigator view, select the node on which you want to set a Natural filter.

   When you select a project node, you can reduce the number of Natural objects, Natural libraries, Natural library folders, files or folders in this node.

   When you select a library node or a library folder node, you can reduce the number of Natural objects, files or folders in this node.

2. Invoke the context menu and choose NaturalONE > Set Natural Filters.

   Note
   This command is only available if the use of Natural filters has been enabled in the Natural Filters dialog box (see Managing the Natural Filters) or in the Available Customizations dialog box (see Customizing the Natural Navigator View).

   The Set Natural Filters dialog box appears. It lists all filters that are currently defined. The type and name of the node on which you are about to set the filter is displayed at the top of the dialog box.

   

3. Select the checkbox for each filter that you want to set.

   As in the Natural Filters dialog box, tooltips are provided for the defined filters, and you can see more information when you expand the node for a filter. See also Managing the Natural Filters.

   Note
   When you click Natural Filters, the Natural Filters dialog box is displayed for you to define additional filters or change the existing filters.

4. Click OK.

   The content of the selected node in the Natural Navigator view changes so that only the items that match your filter are displayed. These filter settings are always applied to the node, regardless of which toggle buttons are selected in the toolbar of the Natural Navigator view.

Removing a Natural Filter

You can either deactivate a filter for a node or you can delete a filter so that it is no longer available.

To deactivate a Natural filter for a node

1. In the Natural Navigator view, select the node for which you want to deactivate a filter. Make sure to select the parent node, which has a plus sign icon with a green background.

2. Invoke the Set Natural Filters dialog box as described above (see Setting a Natural Filter).

3. Deselect the checkbox for each filter that you want to deactivate.

4. Click OK.

To delete a Natural filter

1. Invoke the Natural Filters dialog box as described above (see Managing the Natural Filters).

2. Make sure that the Activate Natural filters checkbox is selected. Otherwise, it is not possible to delete a filter.

3. Select the filter that you want to delete.

4. Click Delete.

   A delete confirmation message is displayed. If the filter is currently used on a node of the Natural Navigator view, a corresponding message is shown.

5. Click Yes to delete the filter.

Using the Details View

The Details view is a Natural-specific view. If it is currently not displayed, you can display it as described in Showing a View of the NaturalONE Perspective.

This view shows detailed information on the children of the project, library, or folder that is currently selected in the Project Explorer or Natural Navigator view. Example:

You can sort a column by clicking on its column header, and move a column by dragging the column header to another location.

Using the Pin Details command in the view menu (or the corresponding button in the local toolbar), you can freeze the content of the Details view so that the content of this view does not change when you select a different node in the Project Explorer or Natural Navigator view.

By default, the Details view is updated automatically if one of the values shown in this view changes. You can switch off this behavior by deactivating the Refresh Automatically command in the view menu. In any case, you can always refresh the view manually by pressing F5 or by using the Refresh command in the view menu (or the corresponding button in the local toolbar).

The Details view only displays columns that currently contain at least one value. A column is not displayed if it does not contain any value. For example, the Size column is not displayed if only folders are contained in the view.

The following columns can be shown in the Details view.

Column Name	Description
Resource Name	The Eclipse resource name, which is either a file name or a folder name.
Type	Either the type of a Natural object (for example. "Program") or the type of a folder (for example, "Library Folder").
Object Name	The Natural object name. This column is only filled for Natural objects.
Long Name	The long name of a Natural object. This column is only filled for Natural objects which have a long name (for example, DDMs).
Library	The Natural library to which a Natural object or folder belongs. For folders that are not assigned to a specific library, this column is not filled.
Private-mode Library	The name of the private-mode library for Natural objects and folders when private mode has been defined for the project or library. This column is not filled for projects and libraries with defined shared mode.
Mode	The programming mode of a Natural object. This can be either "Structured" or "Reporting".
Count	The number of direct children for libraries and folders.
Size	The size of a file. This column is not filled for libraries and folders.
Server Encoding	The server encoding of a Natural object. This column is not filled for libraries, folders, and Natural objects for which a server encoding has not been defined.
Last Modification Date	The date and time of the last modification of the Eclipse resource.
Path	The path to the Eclipse resource. In the case of a virtual library or group folder (Natural Navigator view), the string "<virtual>" is shown.

You can invoke a context menu for each item that is currently selected in the Details view. For example, you can use the NaturalONE > Update command to upload and stow selected sources. Keep the following in mind when working with the context menu:

• Selecting several items
  When you select several items in the Details view, the context menu only contains the commands which are allowed for all selected items.

• Open command (or double-click)
  When you use the Open command with a folder or library, or double-click a folder or library, the children of that folder or library are displayed in the Details view. When you then select an item in the Details view and choose Show Details for Parent Folder from the view menu (or choose the corresponding button in the local toolbar), the parent folder of the selected item is displayed in the Details view.

  When you use the Open command with a file or double-click a file, the file is opened in the appropriate editor.

• Copy command
  Using the Copy command, you can copy the visible columns of all selected rows to the clipboard and paste them into an application of your choice. The column headers are also copied. The contents of the individual columns are separated by semicolons (;).