User Tools

Site Tools


EASAP Objects

By now, you may know that items on the tree in EASAP Builder are known as “objects”. There are well over 100 different objects available in EASAP Builder, and each of these objects has been designed for a particular purpose in defining the overall functionality of an EASAP.

However, you will not need to use all of these objects to produce a high-quality EASAP. Using less than half of these objects will often suffice. As an author, you will create objects on the tree and then edit them to perform as desired by setting “Values” for any object “Parameters” that are available.


Note: EASA Objects are processed in the order in which they appear on the tree from top to bottom. For objects that affect the User Interface, you can check the effect of their tree location on the appearance of the GUI by using the ‘Toggle to Preview’ button.


Tip: You should find that the ‘Copy’, ‘Cut’ and two ‘Paste’ buttons prove to be very useful in populating the tree of an EASAP with the necessary objects in the necessary order.


Object Types

Each of the different objects has a unique function, but these objects can also be grouped into two object types:

  • Singletons
  • Standard objects

Singletons are characterized by names that are all capital letters and cannot be modified. As their name implies, only a single instance of a particular singleton object is allowed as a child object to a particular parent object. This means that a singleton object can appear more than once on the EASAP tree, but only once per parent object.

Conversely, standard objects can occur multiple times under the same parent, and their names can be modified and made up of a combination of upper and lower case letters.

Naming Objects

For standard objects, EASAP Builder automatically provides a default name for each newly created object. However, you have the ability to rename a standard object to something more representative of its purpose. You modify an object’s name in one of two ways:

  1. Edit its name after double-clicking the object on the tree, or
  2. Edit its name shown in the input box at the top of the parameter editing area to the right of the tree.

When renaming an object, there are a couple of restrictions to be aware of:

  1. All object names need to be unique.
  2. If the object is to be referenced in an expression, then the object name must follow special naming rules related to expressions.

To aid you with finding a unique object name when a repeat name is entered, a drop down showing existing object names that are the same or similar to the current name will appear below the object name box in EASAP Builder. An example of the object naming aid is shown below.

Object Parameters

The behavior of an object is controlled by specifying the values for its parameters. There are two types of parameters: 1) Essential and 2) Optional. Setting the value for any Essential parameter is mandatory and EASAP Builder will return error messages when an unspecified Essential parameter is detected. As their name implies, setting the values for Optional parameters is indeed optional. However, setting Optional parameters will often be extremely useful, and even necessary, for proper functioning of an EASAP.

Parameter Information

For every parameter in every object, EASAP Builder contains readily available information to help you in the setting of Parameter Values. To access this information, you select the Parameter Name for the parameter of concern in the first column of the Parameter table. Once a Parameter Name is selected, information will appear below the table. An example of parameter information that will appear is shown below.


Note: When a Parameter Name is selected, its Parameter Information will remain visible until another Parameter Name is selected for the same object or until a different object is selected on the EASAP tree.


Adding Objects to Tree

All new objects are added to the EASAP tree in a similar manner. The following steps provide the generic method for adding objects to the EASAP tree.

  1. Select the object on the tree below which you want to add the new object as either a sibling or child.
  2. Next, you perform one of two possible actions:
    1. Click on the appropriate Add Object button found on the EASAP Builder toolbar above. Make sure you choose correctly between sibling and child buttons.
    2. Right-click on an object in the tree and select either Sibling or Child on the pop- up form, and then click on the appropriate Add Object selection.
  3. After the new object appears on the tree, fill in all of its Essential Parameters and also any Optional Parameters you deem necessary.

Finding Objects on Tree

Once the EASAP tree has been populated with objects, it is often important to find objects so that they can be referenced properly by other objects. The Find capability within EASAP Builder, accessed by clicking on the Find button in the toolbar or selecting Find under the Edit menu, helps to locate objects. When Find is accessed, a form appears, as shown below, that allows you to specify the text to find and the location to find it in, either object names or parameter values. In addition to just finding text within object names and parameter values, the Replace tab on the Find form allows you to find and replace text within objects on the EASAP tree.

Manipulating Objects on Tree

Due to the importance of creating and defining objects on an EASAP’s tree, EASAP Builder contains a variety of methods for adding, copying, cutting, pasting and deleting objects.

Copying Objects

The methods for copying objects are as follows:

  • With an object selected, click on the Copy button.
  • With an object selected, type Ctrl-C.
  • Right-click on the object and then click on the Copy selection.
  • Hold down the Ctrl key, left-click on the object and hold, then drag to new location and release left mouse button to paste.

Cutting Objects

The methods for cutting objects are as follows:

  • With an object selected, click on the Cut button.
  • With an object selected, type Ctrl-X.
  • Right-click on the object and then click on the Cut selection.

Pasting Objects

To paste an object that has been cut or copied as a child, select an object one level above the intended location for the new object and then do one of the following:

  • Click on the Paste as Child button.
  • Type Ctrl-V.
  • Right-click and then click on the Paste as Child selection.

To paste an object that has been cut or copied as a sibling, select an object on the same level as the intended location for the new object and then do one of the following:

  • Click on the Paste as Sibling button.
  • Type Ctrl-B.
  • Right-click and then click on the Paste as Sibling selection.

Exporting Objects

You can export an object and all of its children objects for use in a different EASAP. The methods for exporting objects are as follows:

  • With an object selected, click on the Save Object to File button.
  • With an object selected, right-click and then click on the Export selection.

Upon invoking either of the methods described above, you will be prompted to provide a folder location and file name in which to save the object information. These exported object files will have the .ccl file extension.

Importing Objects

To compliment the object exporting capability described above, you also have the ability to import previously saved objects, including any children objects saved with it, into an EASAP. There are two steps in importing an object: 1) read in the saved object file (*.ccl), and 2) paste the object into the Tree in the appropriate location. The methods for first reading the saved object file are as follows:

  • Click on the Import Object from File button.
  • With an object selected, right-click and then click on the Import selection.

Upon invoking either of the methods described above, you will be prompted to provide a folder location and file name in which to read the object information. These saved object files will have the .ccl file extension. Once the object file has been read, you then paste the object into the Tree as you would when using the Copy or Cut methods detailed above.

Moving Objects

There are a couple of quick ways to reorder existing objects on the EASAP tree.

  • The first method is to move them using the up and down arrows (pictured below) located next to the object icon at the top of the parameter editing area to the right of the tree.


Note: When object movement is not valid, the buttons will be disabled.


  • The second method is to “drag-and-drop” objects by left-clicking on an object and holding down the button, and then by dragging the cursor to the object’s new location and releasing the left mouse button.

Commenting Objects

The Add/Edit Comments button on the EASAP Builder toolbar is used to add comments to objects on the EASAP tree. Adding comments to objects may prove useful to you or other authors, by making it easier to determine what is being defined in the different parts of the tree. To add a comment to an object, just perform the following steps:

  1. Select the object to be commented.
  2. Click on the Add/Edit Comments button ().
  3. Type in the comment in the text entry box that appears.
  4. Click off the object in another part of the tree.

The newly inserted comment will now be displayed as a tool tip when the cursor is hovered over the object. Also, commented objects are denoted by a small red triangle placed in the upper right corner of the object’s icon on the tree.


Page Tools