This documentation explains how to work with NaturalONE, which is the Eclipse-based development environment for Natural. It explains the basic functionality for Natural application development. Special topics such as the creation of rich internet applications or web services are explained in other parts of the NaturalONE documentation.
Note
The descriptions and screenshots in this documentation are based on the Windows
version of Eclipse, but they also apply to the Linux version of Eclipse.
This document covers the following topics:
To start NaturalONE in Windows
Open your Start menu and type "NaturalONE <version>" in the search box.
To start NaturalONE under Linux
Run the start script naturalone from a shell.
This start script is located in the bin directory of your installation directory. By default, this is /opt/softwareag/bin. All parameters that are specified on the command line are passed to NaturalONE.
Or:
Double-click the start script. NaturalONE will then be started using the default
parameters.
When you start NaturalONE for the very first time, you will see a so-called "Welcome" page. If this page is not visible, you can open it by choosing the command from the menu of Eclipse.
From the welcome page, you can switch to the NaturalONE perspective and you can invoke the NaturalONE documentation.
From the welcome page, you can also install sample applications. When you click on a sample application, it is copied to your workspace and shown as a new project there. For further information, see Sample Applications.
In order to work with NaturalONE, you have to open the NaturalONE perspective. For further information, see Opening the NaturalONE Perspective.
NaturalONE is protected by a license key if the NaturalONE Runtime is installed. When you install NaturalONE with the NaturalONE Runtime, you are prompted to specify the path to your license file. The license file will then be copied to the common/conf directory of your NaturalONE installation.
Moreover, you must use the NaturalONE license file for Windows NDV servers, if you want to map the server from a NaturalONE client.
The Natural Server view is restored when the NaturalONE perspective is shown after NaturalONE has been started (or the first time you switch from another perspective to the NaturalONE perspective after NaturalONE has been started). When Natural environments have already been mapped (see
Accessing a Remote Development Environment) and the option Restore Natural server view is selected on the Runtime Execution page of the Natural preferences, this may take a while, especially when a large number of objects is stored on a server. A dialog box is shown in this case, indicating the restore progress. During the restore progress, you can already work with objects in other views. Up to a certain point, it is also possible to cancel the restore process.
As long as the Natural Server view has not fully been restored, the tree in this view appears gray, indicating that you cannot yet work with this view.
Natural projects which have been created with Natural for Eclipse (NFN) cannot be used immediately with NaturalONE. You have to enable them first. For further information, see Enabling a Natural Project for NaturalONE.
