SysML Diagrams

Activity Diagram Modifications & Settings

Modifying the Activity Diagram and its constructs.

Action Constructs Editing A review of the Action Constructs Editing Options
Actor Branch Construct Editing  A review of the Actor Branch Construct Editing Options
Guard Construct Editing A review of the Guard Construct Editing Options
Swimlane Construct Editing A review of the Swimlane Construct Editing Options
Multiple Entities Editing A review of the Multiple Entities Selected Editing Options
Activity Diagram Settings A review of the Activity Diagram's Wrench Icon and Setting Options

 

activity diagram

The previous article on the Activity Diagram provides users with an introductory explanation of the constructs and their functionality on the canvas. In the following section, we will delve into more detail about the options available for the canvas constructs connections, the toolbar frame options that change dependent on the selected constructs and the Activity Diagram's settings.

Action Constructs (Entity,Fork/Join,Decisions (Loop and OR))

activity diagram act2act-1

Any of the four Action constructs in the Activity Diagram can be connected to each other on the canvas. When you make these connections, it creates an input/output relationship between the first action, which generates the output, and the second action, which receives the output. You can confirm this relationship in the left sidebar after making the connection on the canvas.

io activity diag

Actions can only connect to each other in the Activity Diagram.

Entity & Decision (Loop) Construct Options

Upon selecting an Entity construct, the top of the toolbar frame changes so users may modify it.

activty editing  options

The buttons on the top toolbar frame are focused in the image below. Most of these options are available for  all of the action constructs, when selected. We will cover all these options then reference specific options for specific action constrcuts below that.

activty editing  options 2

Open

bold activty editing  options

The Open button allows users to open the entity up into another view.

Bold

bold activty editing  options 

This option will Bold the name of the entity construct selected on the canvas.

Italicize

italicize activty editing options

This option will Italicize the name of the construct selected on the canvas.

Change Text Fill Color

change text color activty editing  options

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the text color of the construct selected on the canvas by selecting the color associated close to the desired color simply inputting in the Hex, R, G, B fields the proper codes and numbers.

Change Fill Color

change fill color activty editing  options

Using the HTML Color Picker that drops down from the Fill Color Option, users can change the color of the construct selected on the canvas.

Change Stroke/line color

change line color activty editing  options

Using the HTML Color Picker that drops down from the Change Line/Stroke Color Option, users can change the color that borders the construct selected on the canvas.

Reset Color back to default

reset color activty editing  options

The Reset color back to default option will change the entity selected on the canvas back to the default gray and black colors.

Flatten

flatten decompostion activity diagram option

When an Action Entity is decomposed by children entities, a Flatten button will appear so users may 'flatten' the hierarchy and have the children actions appear on the diagram in the parent's place. This will remove the decomposed by relationship between the Parent and Children entities.

Script

script option activity diagram

For more on the Script button, please see this article.

Decision (Or) Additional Option

or construct activity diagram editing options

Above is the top toolbar frame when a Decision (Or) entity is selected. All of the options are explained in the section above. However, the newest addition is the 'Add Branch' button.

add branch option or construct activity diagramThe 'Add Branch' feature allows users to easily add additional branches to the Decision (Or) entity. By default, the Decision (Or) entity includes two branches.

‘Fork/Join (Parallel)’

fork join parallel activity diag options

Upon selecting the ‘Fork/Join (Parallel)’ construct, users may modify the black bar construct on the diagram by selecting the black bar on the canvas. Upon doing so, users will see the top of the toolbar frame change to provide options for modification. These options are focused below.

fork join parallel activity diag options 2

Change Fill Color

change fill color fork join parallel activity diag

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the color of the construct selected on the canvas.

Change Stroke/line color

change line color fork join parallel activity diag

Using the HTML Color Picker that drops down from the Change Line/Stroke Color Option, users can change the color that borders the construct selected on the canvas.

Reset Color back to default

reset color fork join parallel activity diag

 The Reset color back to default option will change the bar selected on the canvas back to the default black color.

Add Branch

add branch fork join parallel activity diag

The 'Add Branch' feature allows users to easily add additional branches to the ‘Fork/Join (Parallel)’ construct. By default, the entity includes two branches.

Actor Branch Editing

actor branch editing options

When you add a Branch Actor to a parallel branch, the top toolbar frame will automatically change (highlighted below) and present users with a variety of options to customize the actor's appearance on the canvas. The relationship created when adding a Branch Actor is that the Branch Actor is performs the Action min Note, as shown below, if you click on the branch actor and drag it on the canvas a line will appear. 

actor branch label example

The options highlighted below will be covered in this section.

actor branch editing options 2

Bold

bold actor branch editing option 

This option will Bold the name of the construct selected on the canvas.

Italicize

italicize actor branch editing option

This option will Italicize the name of the construct selected on the canvas.

Change Text Fill Color

change text color actor branch editing option

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the text color of the construct selected on the canvas by selecting the color associated close to the desired color or simply inputting in the Hex, R, G, B fields the proper codes and numbers.

Change Stroke/line color

change line color actor branch editing option

Using the HTML Color Picker that drops down from the Change Line/Stroke Color Option, users can change the line of the color and the branch selected on the canvas. An example of this change to red is the orthogonal dashed line shown below.

change line color actor branch editing option

Reset Color back to default

reset color actor branch editing option

The Reset color back to default option will change the construct selected on the canvas back to the default black.

Line Options

line options menu activity diagram

For the line to the Actor Branch label, users with the Line Options dropdown have the option to hide the label, change the connecting line to straight or orthogonal, or reset the label to reflect the defaulted settings of applying the label to the branch with no line connector and revert back to the defaulted black color (not including the branch color if that has changed).

Guard

guard editing options

The Guard's options are textual, given the nature of the construct. Below will go over the editing options for the Guard that are provided on the top of the toolbar frame.

Bold

bold guard editing options 

This option will Bold the name of the Guard selected on the canvas.

Italicize

italcize guard editing options

This option will Italicize the name of the Guard selected on the canvas.

Change Text Fill Color

change text color guard editing options

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the text color of the multiple entities selected on the canvas by selecting the color associated close to the desired color or by simply inputting in the Hex, R, G, B fields the proper codes and numbers.

Reset Color back to default

reset color guard editing options

The Reset color back to default option will change the entity selected on the canvas back to the default black.

Swimlane

swimlane editing options

As highlighted below, the options for the Swimlane construct will be covered.

swimlane editing options 2

Bold

bold swimlane editing option 

This option will Bold the name of the Guard selected on the canvas.

Italicize

italicize swimlane editing option

This option will Italicize the name of the Guard selected on the canvas.

Change Text Fill Color

 change text color swimlane editing option

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the text color of the multiple entities selected on the canvas by selecting the color associated close to the desired color simply inputting in the fields the proper codes and numbers.

Change Fill Color

change fill color swimlane editing option

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the color of the constructs of the multiple entities selected on the canvas.

Change Stroke/line color

change line color swimlane editing option

Using the HTML Color Picker that drops down from the Change Line/Stroke Color Option, users can change the color that borders the constructs of the multiple entities selected on the canvas.

Reset Color back to default

reset color swimlane editing option

The Reset color back to default option will change the entity selected on the canvas back to the default black.

Veritcal/Horizontal Swimlane

vertical horizontal swimlane options

Selecting this option on the toolbar frame will turn the selected swimlane to be vertical or horizontal, depending on its current orientation.

Send Swimlane to Background

send to background swimlane construct activity diagram

This particular button is helpful when handling multiple swimlanes when they're both vertical and horizontal. This will allow the selected swimlane to be in the background behind another swimlane.

Multiple Entities Selected

mult action selected activ diag

Users may drag their cursor outside of the constructs and a box will appear to select as many multiple entites the user desires. Many features on the top toolbar will appear upon doing so for the user to utilize. Let's go over each option as highlighted below.

mult action selected activ diag 2

Bold

bold text mult action selected activ diag 

This option will Bold all the names of the multiple entities selected on the canvas.

Italicize

italicize text mult action selected activ diag

This option will Italicize all the names of the multiple entities selected on the canvas.

Change Text Fill Color

change text color mult action selected activ diag

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the text color of the multiple entities selected on the canvas by selecting the color associated close to the desired color simply inputting in the fields the proper codes and numbers.

Change Fill Color

change fill color mult action selected activ diag

Using the HTML Color Picker that drops down from the Text Fill Color Option, users can change the color of the constructs of the multiple entities selected on the canvas.

Change Stroke/line color

change line color mult action selected activ diag

Using the HTML Color Picker that drops down from the Change Line/Stroke Color Option, users can change the color that borders the constructs of the multiple entities selected on the canvas.

Reset Color back to default

reset color mult ent act diag

The Reset color back to default option will change the multiple entities selected on the canvas back to the default gray and black colors.

Align Vertically

align vertically mult ent select act diag canvas

This selection will align the constructs vertically for the multiple entities selected on the canvas.

Align Horizontally

align horizontally mult ent select act diag canvas

This selection will align the constructs horizontally for the multiple entities selected on the canvas.

Group Apply Duration Attribute

group apply duration attribute activity diagram

The Group Apply Duration Attribute option is a pop up that allows users to apply the same number to the Duration Attribute for the multiple entities selected:

group apply duration attribute window activity diagram

Decompose

decompose mult ent select act diag canvas

The Decompose Button will turn the multiple entities selected into a child diagram. A new entity will appear in the place of the constructs on the canvas and by default will be called "Parent of XYZ entities." Users may of course at this point change the name of the Parent Entity.

Settings Wrench/Dropdown

Activity Diagram settings menu

The wrench icon is a fixed dropdown at the top right of the toolbar is where more options and settings are available for users to utilize.

Generate Asset Diagram

generate asset diagram from Activity Diagram settings menu

Users may Generate an Asset Diagram from their Activity Diagram, given the proper relationships were made to the Actions and Branch Actors are present in the Diagram.

Cross Project Indicators

show xproject indicators Activity Diagram settings menu

This setting will hide or show the cross project indicators on entities that are from another project.

SysML Frame Edits

edit sysml frame Activity Diagram settings menu

⚠️The SySML Frame is the green space the model is placed in on the canvas.

sysml frame act diag

The Edit SysML Frame option will bring up the following modal.

edit sysml frame window activity diagram

Users may select the color of the frame with the color picker button indicated in green (the green color on the button will change to whatever color a user is set to). Or bring it back to the defaulted green with the reset option reset color.

The remaining options on the Modal are in relation to the Diagram Header located at the top left of the SysML frame, example below.  

sysml frame header activity diagram

The changes made to the Select SysML Diagram option refer to the Model Element Type in the first brackets (ex. [Block] in the picture above. Note, the example above is from an Activity Diagram but shows the Block option as displayed in the aforementioned Modal. Therefore it is important to note, users may select a different digram type here, even if you're in a different diagram. The text will change but this option will not change the diagram itself.

The Select Parent option is dropdown to select the Parent entity for the Model Element Name. This will change the text in between the bracketed texts. In the example above it is the 'Provide Alerts' text.

Hide/Show SysML Frame

hide sysml frame setting

Users may use this option to hide or show the SysML Frame as they wish.

Auto Number, Layout and Reset Diagram

auto number setting

Users may also Auto Number their diagrams, where a pop up shows up to allow users to use the action order to determine the number sequence, provide a Prefix or enumerate the single level, as shown below.

auto number window acitivity diagram

Lastly, the final options provide users to reset their diagram and layout the diagram after changes have been made.

The very last option, 'Help,' will send users directly to the Help Center page for the Activity Diagram for convenience.

layour diagram setting activity diagram

Frame Fix

frame fix indicator activity diagram

When a construct is ouside of the SysML Frame, Innoslate will detect that and bring up a fix for this as indicaited with the orange exclamation point that appears next to the Settings dropdown.

When selected, a modal pops up to provide users the ability to fix or ignore the issue.

sysml frame window fix activity diagram

 

To continue learning about SysML Diagrams, Click Here.

(Next Article: Block Definition Diagram (BDD))