Create a run configuration

Create a run configuration

In this topic ...

Run Configuration Dialog
Creating Run Configurations
Run Configuration Field Values

In the Designer, we can set the Run Configuration properties, which are used when you run a model from within the Designer.

Run Configuration Dialog

The standard Eclipse Run Configurations dialog lets you define the parameters that are used when running (launching) a program from within Eclipse environment. Running a model is a distinct Run configuration type. Therefore, define a new Run configuration of type Factory Model before we can run a model.
We can use the Run Configuration dialog only from a Factory, Java, or Plug-in Development perspective.
We can configure the Factory Model type to run as:

The current model (i.e., whatever model is in the currently open Model Editor).
A specifically-named model (i.e., the model does not have to be in the Model Editor).

We can create both types of Run modes.
As part of the Run configuration, you supply information about the Factory server on which to run the model, as well as the browser to use. We can also specify whether you want Factory server tracing turned on.

Create Run Configurations

To create a Factory Model configuration type:

Choose Run... from the Run menu.
In the Run Configurations dialog, choose Factory Model from the Run Configurations list and click New.
In the Name input field, enter a name for this configuration type, such as "Factory Model".
In the Main tab, choose either:

run model from current active model editor
run named model

If you choose the run named model option, click Browse... to select a model from the Model to Run chooser.
For the other four tabs (Server, Browsing, Tracing, Common), either accept the defaults or enter the required information (see the table below for explanations of the fields).
Click Apply to save the configuration.
Click Close to exit the dialog.

To delete a Factory Model configuration type:

Choose Run... from the Run menu.
In the Run Configurations dialog, choose an existing configuration from the Run Configurations list.
Click Delete.
Click Yes at the Confirm Run Configuration Deletion dialog.
Click Close to exit the dialog.

Run Configuration Field Values

The table below describes the property values that we can set in the various tabs of the Run Configurations dialog.

Main Tab Description
Model to run We can configure the Factory Model type to run in one of two modes:

run model from current active editor &#8212 The model to be run is the model in the currently open Model Editor. Note that a run-time error will occur if there is no Model Editor open when the model is later run.
run named model &#8212 The model to be run is a specific model that you name in the Name: input box. Use the Browse button to select the model from the Model to Run chooser.

Server Tab Description
Server Host Enter the host name of the server running the Factory servlet to which you want to connect. We can use localhost if the Factory servlet and the Designer are on the same machine.
Server Port Enter the port number on which the Portlet Factory listens for requests.
Example: 9080
Browser Tab Description
Browser Command Enter the path to the Web browser to Run when running models.
Tracing Tab Description
Run with system tracing Enable this checkbox to print system tracing information about the method and page actions whenever you run a model.
See System Tracing for more information.
Common Tab Description
Type of Run configuration This field defines the location of the file with the Run configuration settings:
Local specifies that the Run configuration file is stored locally, thus making the Run configuration private for a single user.
Shared specifies that the Run configuration file is stored in the workspace, and can be shared in a repository via standard team mechanisms. Use the Browse button to select a folder from the Folder Selection chooser.
Perspective to switch to or open when Runed in Models are Runed in run mode (debug mode is not supported). In run mode, the program executes, but the execution may not be suspended or examined.
This field lets you choose which perspective becomes active when the Run configuration is Runed.
Display in favorites menu Check the Run box to specify that the Run configuration should appear in the Run favorites list.

Main Tab	Description
Model to run	We can configure the Factory Model type to run in one of two modes: run model from current active editor &#8212 The model to be run is the model in the currently open Model Editor. Note that a run-time error will occur if there is no Model Editor open when the model is later run. run named model &#8212 The model to be run is a specific model that you name in the Name: input box. Use the Browse button to select the model from the Model to Run chooser.
Server Tab	Description
Server Host	Enter the host name of the server running the Factory servlet to which you want to connect. We can use localhost if the Factory servlet and the Designer are on the same machine.
Server Port	Enter the port number on which the Portlet Factory listens for requests. Example: 9080
Browser Tab	Description
Browser Command	Enter the path to the Web browser to Run when running models.
Tracing Tab	Description
Run with system tracing	Enable this checkbox to print system tracing information about the method and page actions whenever you run a model. See System Tracing for more information.
Common Tab	Description
Type of Run configuration	This field defines the location of the file with the Run configuration settings: Local specifies that the Run configuration file is stored locally, thus making the Run configuration private for a single user. Shared specifies that the Run configuration file is stored in the workspace, and can be shared in a repository via standard team mechanisms. Use the Browse button to select a folder from the Folder Selection chooser.
Perspective to switch to or open when Runed in	Models are Runed in run mode (debug mode is not supported). In run mode, the program executes, but the execution may not be suspended or examined. This field lets you choose which perspective becomes active when the Run configuration is Runed.
Display in favorites menu	Check the Run box to specify that the Run configuration should appear in the Run favorites list.