UML to WinVMJ User Guide

Guide on creating UML projects and applying UML-DOP profiles in Papyrus within Eclipse.

Plugin Installation

  1. On the top toolbar, click Help → Install New Software.
  2. In the "Work with" field, add https://amanah.cs.ui.ac.id/priceside/uml-to-winvmj/staging/, click Add, and save with the name UML to WinVMJ.
  3. Open the drop-down menu and select UML to WinVMJ update site.
  4. Select UML to WinVMJ, click Next, approve all licenses, and then click Finish.

Creating a UML Project in Eclipse

  1. In Eclipse, go to New > Other > Papyrus Project.
  2. Select Checklist UML.
  3. Enter the desired Project Name.
  4. Choose Checklist Class Diagram.
  5. Click Browse Registered Profiles and select UML-DOP Profile.
  6. Click Finish to complete setup.

Refer to the Papyrus Tutorial for more information on creating UML diagrams.

Applying UML-DOP Profile

  1. Select the class you wish to edit.
  2. In the Properties menu, go to the Profile section.
  3. Click + in the Applied stereotypes area.
  4. Choose the applicable stereotypes, then click → to apply them.
  5. Click OK to save your changes.

Generating WinVMJ Modules

  1. Right-click on the UML model within your project.
  2. Select Acceleo Model to Text from the context menu.
  3. Click Generate WinVMJ.
    4. Generate WinVMJ
  4. Check the src-winvmj folder in your project; the WinVMJ files will be generated here.
  5. To use these modules in WinVMJ Project, copy the src-winvmj folder contents into the modules directory of your WinVMJ Project.

Example

  1. After setting up the project, open the modeling file (.di extension).
  2. Start with creating a package.
    3. Example 1
  3. Add the «vm» stereotype to the package.
    4. Example 2
  4. To create a core module, add a package with stereotype «module». The package name should be prefixed with M (e.g., MXyz, MAbc, etc.)
    5. Example 3
  5. Add interfaces and classes, properties, and operations to the package. The class should implement the interface using the Interface Realization. The class name should be in form of InterfaceNameImpl (e.g., AbcImpl, XyzImpl).
    6. Example 4
  6. To add a primary key to a class, use the «pk» stereotype on the property that should act as the primary key. Example PK Optionally, you can add UUID as datatype and then you can apply it like the following.
    7. Example PK Datatype
  7. Relation between classes can be made using the Association (Directed) edge.
    8. Example 5
  8. To create a delta module, add a package with stereotype «delta». The package name should be prefixed with D (e.g., DZyx, DCba, etc.)
    9. Example 6
  9. To create a class modification, create a class with stereotype «modifiedClass». Add a relation using the Association (Directed) edge with stereotype «modifies» between the class in the delta module and core module. Add properties or operations with stereotypes to model the modification of the class.
    10. Example 7