Diagram navigator

Diagram navigator is the location where diagrams are listed. You can create your own diagrams easily as they are listed by categories, such as UML Diagrams, Requirements Capturing, Database Modeling, Business Process Modeling and Others. With diagram navigator, you can create, open and delete diagrams.

The diagram navigator

The toolbar

Name	Icon	Description
New diagram		Create a new diagram through the New Diagram dialog box.
Collapse		Collapse the selected diagram.
Expand		Expand the selected diagram.
Show Diagram View		Overview the diagram elements in the selected diagram.
Sort Diagram Element By Name		Sort diagram elements by their name in alphabetical order.
Sort Diagram Element By Type		Sort diagram elements by their type, disregard their name.
Move Selected Diagram		Move the selected diagram down or up. This option only works within the same diagram type when there are multiple diagrams.
Refresh		Update the content of diagram tree.

The description of icons on diagram navigator

Pop-up menu

Pop-up menu of diagram navigator

The pop-up menu of diagram navigator

Menu Title	Description
Filter Model Element...	Open the Model Element Filter dialog box to filter the diagram elements to appear in the diagram navigator.
Show Carriage Return Character	Display line breaks of multi-lined diagram name as carriage return character.
Sorting	Select the way to sort diagram elements in diagram navigator.
Group by Category	Categorize diagrams based on their types.
Teamwork	Perform teamwork activities.
Manage Dependent Project...	Add or remove dependent project.
Refresh	Refresh diagram navigator content.
Collapse All	Collapse all tree nodes.
Expand All	Expand all tree nodes.
Show Diagram View	Make the Diagram Navigator to expand all diagram types' nodes to show the diagrams nodes, but do not display any diagram element nodes.

The description of pop-up menu of diagram navigator

Pop-up menu of project node

The pop-up menu of project node in diagram navigator

Menu Title	Description
No View Model Elements...	It lists the model element(s) that either has not been visualized (no view) or has no master view.
Rename...	Rename the project.
Nicknames	Configure or switch to another nickname.
New Diagram...	Create a diagram.
Configure Programming Language...	Change to another programming language or configure the type mapping for a language.
Group by Category	Categorize diagrams base on their types.
Sorting	Select the way to sort diagram elements in diagram explorer.
Teamwork	Perform teamwork activities.
Refresh	Refresh diagram navigator.
Collapse All	Collapse the project node.
Expand All	Expand the project node.

The description of pop-up menu of project node

Pop-up menu of diagram category

The pop-up menu of diagram category in diagram navigator

Menu Title	Description
New Diagram...	Create a diagram.
Export Agilian Project...	Export all diagrams in the selected category as Agilian project.
Export XML...	Export all diagrams in the selected category as XML.
Export as Image...	Export all diagrams in the selected category as image files.
Print...	Print the diagrams in the selected category.
Collapse	Collapse the selected diagram category node.
Expand	Expand the selected diagram category node.
Show Diagram View	Make the Diagram Navigator to expand all diagram types' nodes to show the diagrams nodes, but do not display any diagram element nodes.

The description of pop-up menu of diagram category

Pop-up menu of diagram type

The pop-up menu of diagram type in diagram navigator

Menu Title	Description
New [diagram type]	Create a new diagram in the selected type.
New Diagram...	Create a new diagram with popup dialog box.
Export Agilian Project...	Export all diagrams in the selected type as Agilian project.
Export XML...	Export all diagrams in the selected type as XML.
Export as Image...	Export all diagrams in the selected type as image files.
Print...	Print the diagrams in the selected type.
Sort [diagram type] by name	Sort the diagram nodes of the selected type node in specific way.
Collapse	Collapse the selected diagram type node.
Expand	Expand the selected diagram type node.

The description of pop-up menu of diagram type

Pop-up menu of diagram

The pop-up menu of diagram in diagram navigator

Menu Title	Description
Open [diagram name] Specification...	Open the specification of the selected diagram.
Open [diagram name]	Open the selected diagram if closed or inactive.
Close [diagram name]	Close the selected diagram if opened.
Use Case Scheduling...	Open Use Case Scheduling dialog box.
Rename...	Rename the selected diagram.
Delete	Delete the selected diagram.
Edit Nickname...	A pop-up a dialog box for defining the nickname of model elements will appear in the diagram. This option is available only after you have configured a nickname.
Analysis	An analysis diagram will be formed to analyze the selected diagram with others and the result will be seen. Relationship like diagram transition can also be found.
Export Agilian Project...	Export the selected diagram as Agilian project.
Export XML...	Export the selected diagram as XML.
Export Selected as Image...	Export the selected diagram as image Excel.
Export as Image...	Export diagram(s) as image via the Diagram Exporter.
Export to Excel...	Export the selected diagram as image Excel.
Print...	Print the selected diagram.
Move Up	Move the selected diagram node upwards.
Move Down	Move the selected diagram node downwards.
Collapse	Collapse the selected diagram node.
Expand	Expand the selected diagram node.
Sorting	Change the way of sorting diagram elements.

The description of pop-up menu of diagram

Closing and opening the diagram navigator

Diagram navigator is opened by default. To close it, press the X button at the top right corner. On the other hand, it can be opened by selecting View > Panes > Diagram Navigator from the main menu.

Creating a diagram

Approach 1 – Direct creation
If you want to create a diagram in a quick way and don't need to supply the documentation of diagram (for time-saving), use this approach. To create a diagram:

Right click on the diagram type that you want to create.
Select New [diagram type] from the pop-up menu. Here, diagram type means the type of diagram you want to create.

NOTE: You can immediately enter the diagram name at the top left corner of diagram.

Approach 2 – Through the New Diagram dialog box
This approach let you create a diagram and enter the name and documentation simultaneously. To create a diagram:

Right click on the diagram type that you want to create.
Select New Diagram from the pop-up menu.

In the New Diagram dialog box, you can enter the name and documentation of diagram, and click OK to proceed.

New Diagram dialog box

Opening a diagram

Double click the diagram you want to view in the diagram tab.

Sorting diagram elements

In diagram navigator, diagram elements are listed under diagram nodes. You can sort diagram elements by their names, or by their types (e.g. use case, package, etc.)

To sort by name, click Sort Diagram Element by Name button. The elements will be listed by name, in alphabetical order.

Click Sort Diagram Element by Name

To sort by type, click Sort Diagram Element by Type button. As a result, the elements will be listed by type.

NOTE:

The sort function applies to the entire diagram tree instead of the selected node.

Reordering diagrams

Select the diagram(s) you want to reorder. If there are multiple diagrams you want to select, just click one while pressing Ctrl button and make the other selection.
Click Move Selected Diagram Up button to move the selection upwards, or Move Selected Diagram Down button to move the selection downwards.

Filtering model elements

You can choose which model elements you want to be displayed or not on the diagram tree.

Right click on the diagram navigator's background and check Filter Model Element.... Model Element Filtering Dialog will then be pop-up.

Select the types of model element(s) you want to be displayed by checking to the type. Otherwise, uncheck the one you don't want to be displayed.

Model Element Filtering dialog box

NOTE:

You can check Display model element types in-use to list only types of model elements used in project. The text box Filter enables you to filter model element type base on the type name (e.g. enter class to list only class)

Showing/hiding carriage return character

If it is the case that the name of the diagram and diagram elements is in multi-line, the character ¶ will be revealed.

When Show Carriage Return Character is selected, line break will be shown.

Show carriage return character

When deselected, the character ¶ is hidden.

If you want to hide it, right click on the diagram navigator's background and uncheck Show Carriage Return Character from the pop-up menu. As a result, the character will automatically be unshown.

Grouping or ungrouping by category

As it is said before, default groups are automatically arranged by category.
If you want to ungroup diagram:

Right click on the diagram navigator's background.
Uncheck Group by Category if there is a tick in the box, and then all diagram types will be ungrouped.

Ungrouped diagrams

Connecting to server for team collaboration

Agilian's team collaboration support enables your team members work together on projects. To connect to server and perform related activities:

Right click on the diagram navigator's background.
Select Teamwork and the action you want to perform (e.g. commit and update, etc) from the pop-up menu.

Perform teamwork

Displaying only diagram nodes but not diagram elements

If you only want the diagram nodes to be shown but not the diagram elements under them, just click on Show Diagram View button on its toolbar.

NOTE:

This option applies to all diagram nodes, but not just the selected one.