Learn about the object model

3 minute readDeveloper productivity

Whether you are starting fresh in CloudBees CD/RO or learning a new concept, you can use the hierarchy menu to learn about the CloudBees CD/RO object model structure and product capabilities. This is a wizard-like menu that aids in application, microservice, and environment modeling in CloudBees CD/RO, by helping you to visualize the relationships between objects in a project and coaching you along the way by indicating the next required actions. This menu provides an easy-to-understand view of the model structure and where you are within it, highlights missing pieces, and streamlines navigation across objects.

The hierarchy menu is available in the Application Editor, the Microservice Editor, the Environment Editor, pipelines, and releases.

Viewing the hierarchy menu

To view the hierarchy menu for a project, open the Application Editor, the Microservice Editor, or the Environment Editor in that project. The hierarchy menu is expanded and visible by default. The following examples show the hierarchy menu:

Hierarchy menu
Figure 1. Hierarchy menu
Hierarchy menu - close up
Figure 2. Hierarchy menu - close up

The content of the menu dynamically updates when you create or edit an application, microservice, or environment. Child objects that are not configured do not have actions enabled.

Certain actions, such as selecting Requires Setup +, launch dialogs. Each of these dialogs has modal behavior, requiring that you exit it before continuing.

Expand and Collapse buttons

  • To collapse a menu, select Hide hier menu hide button.

  • To expand a menu, select Show hier menu show button.

Every object with one or more child objects has a Collapse button hier menu collapse button or an Expand button hier menu expand button to collapse or expand the visibility of its child objects.

The following example shows the Collapse button:

Collapse
Figure 3. Collapse

The following example shows the Expand button:

Expand
Figure 4. Expand

Popover menu

Some objects, or rows, contain a popover menu hier menu hover hambrgr menu, that is only visible when you hover over the object.

The following is an example of the popover menu:

Popover menu
Figure 5. Popover menu

The following example shows the expanded menu after you select the popover menu hier menu hover hambrgr menu:

Expanded popover menu
Figure 6. Expanded popover menu

The menu provides all actions that are available in the visual editor canvas for that object.

Add button

Some objects, or rows, have an Add button hier menu hover add button that is only visible when you hover over the object:

Add button
Figure 7. Add button

Select Add to open the dialog to add an object.

Visual editor button

If an object is editable in a visual editor, the hier menu visu edit button button appears next to it. For example:

Visual editor button
Figure 8. Visual editor button

The button opens the visual editor for that object.

Requires setup button

If you have not completed the definition of an application component, tier map, or environment resources, the Requires Setup + button appears for the object that needs to be defined. The following example shows the button for an application component that requires setup:

Component that requires setup
Figure 9. Component that requires setup

The button opens the dialog for adding an application component.

The following example shows the button for a tier map that requires setup:

Tier map that requires setup
Figure 10. Tier map that requires setup

The button opens the dialog for adding a tier map.

Application Run button

The Application Run button hier menu app run button opens the application runtime settings dialog that you can use to set up and start an application run. For example:

Application Run button
Figure 11. Application Run button

Property Browser button

The Property Browser button hier menu visu edit button allows you to navigate properties more easily by allowing you to view all properties on a hierarchy of objects in a project. For example:

hierarchy menu property browser

For details about this functionality, refer to Property Browser.