Design forms

Forms are the pages in which users create and edit entities in ALM Octane. Admins can choose which fields are included in a form, and design the form’s layout.


Admins can:

  • Create or modify forms so that users see only what they need.

  • Create rules so that ALM Octane uses the relevant forms. For details, see Set up rules.

Use the form designer to create and edit your forms. The form designer has a form management area and a design area.

Note: Name and Type fields cannot be accessed in the form designer.

You can design different forms for the same entity type:

  • You can design different forms based on context. For example, you can design a form for use when creating a new user story and another form for editing a user story. These forms include different fields.

  • You can also create forms for users with different roles. For example, a dev team manager is interested in different fields than a tester.

Tip: Non-admin users can add and remove fields to forms when creating or editing an entity. For details, see Edit forms.

Back to top

Sharing forms between spaces

Admins can define forms for: 

  • All workspaces associated with a shared space.

    The shared space admin creates and modifies these forms for a shared space. The form is then available to all associated workspaces.

  • For individual workspaces.

    The workspace admin creates and modifies these forms for a specific workspace.

ALM Octane users working in a specific workspace can access both the forms defined for the corresponding shared space and also the forms defined specifically for that workspace.

Within a shared space or a workspace, form names must be unique. However a form defined for a shared space may have the same name as a form defined for the shared space's workspaces. To distinguish between the forms, ALM Octane displays the shared icon and non-shared icon accordingly.

Back to top

Predefined forms

For each entity type, ALM Octane provides predefined forms. ALM Octane uses these forms by default when you create and edit entities.

  • Default form for Edit

  • Default form for New

Note: Some entities do not have a Default form for New.

You can make other forms the default forms instead of these.

You can modify these forms, but you cannot rename them.

Back to top

Working with forms

This section describes how to create, and work with, forms.

Shared space admin or workspace admin permissions are required.

Forms can be defined on a space level and a workspace level.

Before working with forms, define any custom fields you need. For details, see Customize fields.

  1. In Settings , click Spaces and select the shared space or workspace where you want to create a new form.

  2. Click Entities and select an item.

  3. Click Forms. The form designer is divided into the management area and the design area.

  4. In the management area, modify the attributes for each field or section using the design area toolbar.

    You can also duplicate a form, rename a form, and reset a form's layout.

  5. In the design area, do one of the following:

    • Choose the relevant section, and the item before which you want to add a field, and click Add field.

    • Choose the section before which you want to add a section, and click Add section.

    Choose either Regular or Full in the Size drop-down to determine if the field takes up an entire row or if ALM Octane can put it on a row with other fields.

    When finished adding fields, click outside the list to close the list.

    Note: Required fields must be on the form, ALM Octane automatically adds them. You can move them but you cannot delete them.

  6. Click Set as default if you want to use this form as the default.

Back to top

Next steps: