Breadcrumbs

Working with Builder Projects

Creating a New Builder Project

A Builder project in the BUILDER is a collection of UML models in a logical context.

builder_menu_new_project.png  
abstandshalter_360.png

To create a new Builder project select Builder > New Builder Project or select icon_new_project.png from the menu bar.


project_settings_general.png

The project settings dialog opens.

Enter Project Name (mandatory), Author (optional), and Project Description (optional).

project_settings_select_folder.png

The default path of the whole project (Save Project in) is based on your installation directory.

Builder projects may be stored in an arbitrary path - it does not need to be related to the location of your Builder installation.
You can change it by clicking  ... .

project_settings_select_folder_file_chooser.png

Select the folder of your choice or create one with 

icon_new_folder.png

and click OK.

project_settings_ok.png

After clicking OK the new Builder project will be created.

new_project_warning_existing.png

If a Builder project with this name already exists, the Builder warns, that some files will get overwritten.

In a Builder project, all XMI files of the project are stored. A new Builder project is always empty (no XMI files existing).

create_model_from_template.png
abstandshalter_360.png

To create a new UML model, the Builder offers two possibilities:

  • Creating a new model based on the Bridge template.

  • Importing an existing XMI file.

Regarding the Bridge template, refer to xUML Service Template. You can also start a UML model by importing WSDL/XSD files, IDocs, Java classes, or XSLT scripts/XSLT script archives.

UML models that are created by importing WSDL/XSD files, IDocs, Java classes, XSLT scripts/XSLT script archives, flat file definitions, or EDIFACT schemes are not based on the Bridge template. You may want to import such models into a UML model that is based on this template.

For detailed information regarding all import functions, refer to The Importers.

Changing the E2E Builder Project Settings

The settings of an existing Builder project can be edited.


builder_menu_settings.png

Select Builder > Settings.

project_settings_general.png
abstandshalter_360.png

The dialog that was already discussed in Working with Builder Projects will be opened.

The other tabs General and Model Compiler will be explained in chapter Changing the Model Compiler Settings.

Opening an Existing Project

There are three different ways to open an existing Builder project.

builder_menu_open_project.png

Select Builder > Open Builder Project ...

md_menu_open_project.png
abstandshalter_360.png

... or File > Model Execution & Integration > Open Builder Project.

In both cases pressing Ctrl + Shift + O will accomplish the same.

builder_menu_reopen.png
abstandshalter_360.png

Alternatively, if you have already worked on a Builder project before, you may select Builder > Reopen Builder Project to continue your work.

If you installed the Builder documentation as described on Unzipping the Builder Examples (default path C:\E2E Documentation 18), you will find there several sample projects that you can analyze to understand how the modeling approach works. Detailed information about the functions used in the examples is described in the xUML Services Reference Guide.  

open_example_file_chooser.png

If you want to open a sample project, select Builder > Open Builder Project and navigate to the folder where the examples are located. The Builder recognizes Builder projects in the file system and substitutes the folder symbol in the file chooser by an E2E logo.

open_example_select_model.png

If the Builder project is opened for the first time, you may select one of its contained UML models to open. Otherwise, the last XML file that was opened in the Builder project will directly be loaded in MagicDraw.


A Builder project can have one or more XMI files (UML models) that are related to each other in a logical context. However, a single XMI file in MagicDraw's terminology is also called a project. Do not be confused, a single UML model (XMI file) is the same as a MagicDraw project, whereas a Builder project is a collection of several UML models.


builder_menu_open_model.png

To open an additional XML model file select Builder > Open Model. All UML models of the currently open Builder project are listed. Select a UML from the list.

switch_model.png

Switch between open projects using the Switch Projects toolbar from the MagicDraw main toolbar.

md_menu_open_model.png

You may also open a UML model of a different Builder project using the MagicDraw function File > Open Project. However, keep in mind, that this model is not part of the currently open Builder project and can not be compiled and deployed.



Related Pages: