Creating diagrams in projects

This topic explains how to create new diagrams, and clone or rename existing diagrams,

Diagrams exist within the context of a project. You must create or open a project before you can create any new diagrams. If you create a Together project around an existing code base, Together automatically creates Package and Class diagrams when it parses your code. Before creating a project you may want to customize forward and reverse engineering and/or source code formatting (see Administrator's Guide: Configuring Together).

You can create any of the diagram types your license supports. Together Whiteboard supports only the Class diagram (which includes Packages and Objects).

When you begin a new project, or add new diagrams to an existing project, you can create UML diagrams using...

Using the Main Menu

You can use the File | New Diagram menu command to create a new diagram in any directory/package in your project.

  1. Select the destination directory or package in the Project Explorer Directory or Model tab.

  2. Choose File | New Diagram from the menu bar to display the New Diagram dialog (see figure below).

  3. Click on the icon for the type of diagram you want to create. (If you have Together Whiteboard you can only create a Class diagram).

  4. Enter a name for the diagram and optionally a description.

  5. Choose a destination for the new diagram file. Default is the package currently selected in the Explorer.

  6. Check Include in current diagram if you want to place an element with a logical link icon to the new diagram in the current diagram.

 

Creating a new diagram in the New Diagram dialog. (541)

Using Explorer speedmenus

When a package node is selected the Model tab in the Explorer, you can use the New | Diagram command on its speedmenu to display the New Diagram dialog box. Follow the same steps as above.

Using the Hyperlinking feature

The Hyperlink feature enables you to create a new diagram that is automatically linked to an existing diagram or diagram element.

You can do this in the Hyperlinks tab of the class Inspector (class speedmenu | Properties). For more information see Hyperlinking diagrams.

Cloning diagrams

The Clone command on the speedmenus of existing diagram nodes in the Explorer Model tab lets you quickly create a new diagram with the same content as the existing one. The new diagram is created with a unique default name in the same package as the first diagram. You can rename the clone diagram as described below.

Renaming diagrams

To rename an existing diagram:

  1. Open it for editing.

  2. Click on the background to display diagram properties in the diagram Inspector

  3. Modify the Name property in the diagram Inspector.

See also: