Diagrams

Threats Manager Studio (TMS) provides a Diagram tool, which represents the main interface to create Threat Models for typical uses. With Diagrams, it is possible to represent the system and how the information flows among its components.

The Home ribbon contains the main buttons to work with Diagrams:

• Iterate Diagrams
• Create Diagram
• Reorder Diagrams

Iterate Diagrams

Button Iterate Diagrams represents the main button to access the diagrams included in the Threat Model.

If there is no diagram, then it is disabled, as shown in the Figure above.

If there is at least a diagram, it is enabled and has a button with the head of an arrow pointing down. In that case, if you click Iterate Diagrams and there is no open diagram, then the first one is opened. If you click Iterate Diagrams again, the same diagram is shown: that may be useful if you have other pages, to get to the main diagram fast.

If there are multiple open diagrams, then clicking Iterate Diagrams iterates among them.

To access a specific diagram, you must click the arrow button below Iterate Diagrams.

Create Diagram

Button Create Diagram allows to create a new Diagram.

The newly created diagram shows an empty canvas. For details on how to create a diagram, please refer to Diagramming Basics and to the Introductory Topics.

The diagram shows the following ribbon.

The Diagram ribbon contains the following sections and buttons.

Section	Button	Description
Add	New External Interactor	Creates a new External Interactor in an empty space in the diagram.
	New Process	Creates a new Process in an empty space in the diagram.
	New Data Store	Creates a new Data Store in an empty space in the diagram.
	New Trust Boundary	Creates a new Trust Boundary in an empty space in the diagram.
	New Threat Type	Creates a new Threat Type.
Layout	Align Horizontally	Aligns the selected objects horizontally.
	Align Vertically	Aligns the selected objects vertically.
	Align Top	Aligns the tops of the selected objects.
	Align Botton	Aligns the bottoms of the selected objects.
	Align Left	Aligns the lift sides of the selected objects.
	Align Right	Aligns the right sides of the selected objects.
	Automatic Layout	Performs an automatic layout. It is available only for Expert or Pioneer Execution Modes because it has the problem of applying a layout that may not be the best for your uses.
View	Toggle Markers	Hides or shows the Threat markers to Entities and Flows.
Zoom	Zoom In	Increases the size of the diagram on the screen.
	Zoom Out	Decreases the size of the diagram on the screen.
	100%	Reverts the diagram to the original size on the screen.
	Zoom to Fit	Zooms the diagram to fit the visible space.
Create Snapshot	Copy to Clipboard	Copies the image of the diagram to the Clipboard.
	Copy to File	Saves the image of the diagram to file.
Remove	Remove Current Diagram	Removes the current diagram. Entities, Flows, and Trust Boundaries will not be affected.
Copy	Copy	Copies the selected objects to the clipboard. To paste the objects, you have to use the context menu on an empty space of another diagram, by clicking the right mouse button and selecting action Paste.
	Cut	Copies the selected objects to the clipboard and then removes them from the diagram. To paste the objects, you have to use the context menu on an empty space of another diagram, by clicking the right mouse button and selecting action Paste.

Tips & Tricks

If you need to maximize the size of the Drawing Pane to increase the readability of the diagram, you can minimize the Ribbon by double-clicking any of the titles of the tabs, like “Home” or “View”. Moreover, you can move the mouse over the separator between the Drawing Pane and the Stencils Pane, which you can find on the left of the Diagram page, and then click to close it. You can also move the mouse over the separator between the Drawing Pane and the Item Editor, which you can find on the right of the Diagram page, and then click to close it.

Reorder Diagrams

Button Reorder Diagrams shows dialog Sort Diagrams, which allows to reorder the diagrams by dragging and dropping them in the desired position.