Element loop

An element loop is a component in a report template, indicating the need of looping (i.e. walking through) specific type(s) of diagram/model elements. For example, to loop all task and sub-process in a project. Element loop means nothing more than just to loop diagram/model element. The content to print for each diagram/model element being looped is to be determined by the children components of loop.

Looping model elements in project

To loop specific type(s) of model elements in project, create element loop at template root. To create element loop at template root:

1. In the template editor, click on any of the buttons in the toolbar depending on your need.
   

   Button Name Description Add Element Loop (Model) To loop through all models in the project root. In other words, model being contained by other model element will not be accessed. This is a shortcut for creating a root level element loop whose chosen element type is model. Add Element Loop (Package) To loop through all packages in the project root. In other words, package being contained by other model element will not be accessed. This is a shortcut for creating a root level element loop whose chosen element type is package. Add Root Level Element Loop To loop through any kind of model element in project root. By selecting this option, you can choose the type of model element to be looped. Add All Level Element Loop To loop through any kind of model element within the project, regardless of their leveling. By selecting this option, you can choose the type of model element to be looped.

   Description of available type of element loop

2. If you have chosen to add a model or a package loop, you do not need to perform any actions in further.
   If you have chosen to add either root level or all level element loop, select the type of element(s) to loop on the right hand side of the template editor and click  to confirm the selection.
   

   Select to loop pool

   NOTE:

   You can switch between a root level and a all-level loop by changing the option Root Level above the element list. Notice that changing the value of Root Level is not about changing available element selection, but also the end result, whether to access only root level elements or not.

Looping diagram elements in a diagram

Instead of looping model elements in a project, you can also place element loop under a diagram loop to loop for diagram elements in specific type(s) of diagram. To create element loop under a diagram loop:

1. Select the element loop that you want to loop for its sub-diagrams.
   

   Selecting a diagram loop

2. Click on the Add Element Loop button from the toolbar of element loop.

   Adding an element loop

   NOTE:

   Make sure you are clicking on the button from the toolbar of diagram loop. If you are clicking on the button at editor toolbar, you will create a loop at template root.

3. On the right hand side of the template editor, select the type of diagram element to loop and click to confirm the selection.

Switching from element loop to element summary table/paragraph

An element summary indicates the need of looping (i.e. walking through) specific type(s) of diagram/model element, and presenting their properties in tabular form, while an element paragraph indicates the need of looping specific type(s) of diagram/model element for constructing paragraphs of properties.

You can convert an element loop to element summary table or paragraph by right clicking on a element loop and selecting Change to Summary Table/Paragraph from popup menu.

To convert an element loop to element summary table/paragraph