Set Up Scenario Specification

You can create a specification for a scenario in one of a number of ways:

  • Enter the specification yourself, as described here
  • Generate a specification from an Activity diagram created under a Use Case element
  • Generate a specification from the Notes text of the scenario in the Description tab
  • Generate a specification from text held on the clipboard

Access On a diagram or in the Project Browser, right-click on element and select:

Properties > Scenarios > Structured Specification or

Properties Page | Scenarios > Structured Specification

Enter the specification yourself, starting with the basic path



See also


In both the 'Scenario' and 'Type' fields, click on the drop-down arrow and select 'Basic Path'.


In the new step field in the 'Action' column, type the text of the first step or action.


Tab to the 'Uses' column and, if appropriate, type the name of each element used in this step. If the elements are highlighted in blue and underlined, it indicates that they are already listed in the 'Context References' tab.

You can also manage the list of elements as context references, and add to the list directly; see the Notes.


Tab to the Results column and, if appropriate, type the outcome of completing this step.


Tab to the State column and, if appropriate, type the name of the state into which the step moves the action.


When you move out of the 'Action' column, the next new step field displays underneath.

Repeat steps 2 to 5 as many times as is necessary.

The 'Structured Specification' tab should now resemble this:


Click on the (Save) icon in the Structured Specification toolbar.


  • By default, the steps begin with a user step (indicated by an 'Actor' icon) and alternate between user and system (indicated by a screen icon) steps. However, you can control the responsible entity assigned to a step by typing a keyword within the first 15 characters of the text in the 'Action' column; either 'User' or 'Actor' for a user step, or 'System' for a system step. Once a step has been saved, you can change the responsible entity by either double-clicking on the icon or right-clicking on the step, and selecting 'Set Step as 'System'' or 'Set Step as 'User'' as required
  • An entry for the basic path displays in the 'Entry Points' tab, as Step 0 with no value in the 'Join' column (the basic path does not rejoin itself)
  • The values in the 'Uses', 'Results' and 'State' columns, whilst optional, are significant if you want to generate a diagram from the specification; if you type the name of an element linked to the current element (and listed in the 'Context References' tab), the element name is highlighted and underlined
  • In the 'Uses' column, in edit mode, use the 'Manage Uses Context List' context menu option to enable and disable 'Uses' cells as linked element lists as well as text fields, across the whole model; when the feature is enabled, the column shows both context-linked elements and manually-entered text, and when disabled only text entries are listed (the context-linked entries are hidden and deactivated, but not deleted - they are re-activated when the feature is enabled)
  • As you develop the scenario, you can move steps to different positions in the scenario, and insert new step lines within the body of the scenario
  • You can also create constraints on the element that have an impact on the scenarios
  • Repeat this Set Up Scenario Specification procedure for each scenario you have created; you can now adapt, enhance and interrelate the scenario specifications using the facilities of the 'Structured Specification' tab:
         -  Structured Specification Toolbar
         -  Item context menu
         -  Selected Text context menu
         -  Entry Points context menu
         -  Floating Toolbar

Learn more