To begin modeling with Together you need to create a project. At minimum, a project consists of:
a primary
root directory
a project
file (.tpr
file extension and
icon)
a default package diagram
The primary root directory stores the project file and any initial diagram created along with the project. It also provides a storage location for project-level configuration properties files (see User's Guide: Multi-level Configuration).
When you create a project, the primary root can be either a new or an existing directory. By default, Together round-trip engineers any source code it finds in the primary root directory and any subdirectories below it. If you specify the top-level directory of an extremely large code base as the primary root, you may find the reverse engineering process too slow. In such cases, you can redefine how project resources are parsed. See the topics Creating and opening a project and Large projects.
The project file gets the name of
the project as the filename and a .tpr
extension. It displays the
icon in the Explorer.
When you create a new project, Together
generates a diagram that presents a view of the physical project
content contained in the primary root package. The generated diagram
is named <default> and displays the default diagram icon
.
The name of the nderlying diagram file is [Project
Name].dfPackage.
The <default> diagram shows Package icons representing
subdirectories of the primary root directory, as well as the classes
etc. of any source code files found in the primary root.
When creating a new project, you can also optionally specify an initial diagram that Together creates along with the project. 'Class diagram' is the default type. If your license supports creation of other UML diagrams, you can specify another type of diagram as the initial diagram, or <none> for no initial diagram. Together always generates the <default> diagram.
Note that there is no default diagram that opens every time you open a project (a change from 2.x). The diagrams that open along with a project, if any, are controlled by the configuration setting for Saved Desktop (see Administrator's Guide: Configuring Together). If set to true, Together remembers what diagrams were open when the project was closed and re-opens those diagrams when the project next opens.
Together version 3 broadens the scope of projects compared to previous versions. You are not limited to a single root directory - you can specify multiple directories as being project root directories, include or exclude subdirectories of any root, and exert some initial control over how these directories are treated during round-trip engineering. You can include individual Zip and Jar archive files in the project as well. You do this using the Advanced mode of the New Project dialog (File | New Project). For more information, see Creating and opening a project.