Inserting an Entity into a Procedure

Use the Insert Entity dialog box to insert an entity into the current procedure.

To insert an entity into a procedure:

1. In the Procedure Diagram Pane of the Procedure Editor, click the entity that precedes the insertion point for the new entity.
2. Click the Insert Entity button on the Icon Button Bar to open the Insert Entity dialog box.
3. Click the entity to insert from the Entity list.
   

Using the Entity Dialog Box

The Insert Entity dialog box provides the fields listed below. Take the default values of these fields, or modify the values to work correctly with your procedure.

Entity List
The Entity box lists all the entities in the current table. Click an entity name to insert it at the current location.

A green ball identifies those entities that can be successfully traversed from the insertion point. A red X indicates Host Integrator cannot navigate to that entity; there is a problem with either the navigation path or input parameters. You can add an entity with a red X, but you need to correct its navigation or parameters to provide a way to traverse to the added entity.

New Entity or a Sandbox Entity Radio Buttons
These radio buttons affect the entity list by listing all the entities available or a sandbox entity. A New Entity is a modeled host screen containing attributes or recordsets that you want to make part of the procedure.

A Sandbox Entity is one that has been removed from the procedure, but retains all the customization you have done on that entity. For example, you may have added an entry and mapped its attributes, but later you need to move it to a different location in the procedure. You can delete the entity, which moves it to the sandbox, and then insert the entity without losing the mapping. The Sandbox Entity radio button is disabled if there are no sandbox entities.

Insert after entities
The new entity is inserted after the selected entity with a path between the two. If there is a branching operation prior to the insertion point of a new entity, and you wish to have multiple paths to the new entity, select additional originations here.

Path to entity
Specify a dynamic or static path to the entity. Select a dynamic path to allow Host Integrator to determine the best path to this entity based on the defined entities and operations. If a path cannot be found, the Host Integrator will return an error message. A static path requires you to select an operation from the list. Note: Only static paths can have branching.

Path from entity
Specify a dynamic or static path from the entity. Select a dynamic path to allow Host Integrator to determine the best path to this entity based on the defined entities and operations. If a path cannot be found, Host Integrator will return an error message. A static path requires you to select an operation from the list. Note: Only static paths can have branching.

Preview Pane
As you build the procedure, the Preview pane displays a visual layout of the relationship of the entities, operations, and recordsets in the procedure.