BOMI Modeling Tool

Setup the Development Workspace

1. Get an Eclipse Modeling Tools for your operating system from https://www.eclipse.org/downloads/packages/
2. Install all Sirius and Xtext Components via Help -> Install New Software.... In the corresponding wizard, select, e.g., Latest Eclipse Simultaneous Release in the topmost dropdown box. After loading has finished, type in Sirius and simply select and install all the resulting components. Do the same with typing Xtext and install the "Xtext Complete SDK".
3. Pull this repo and import all the projects in the folder plugins. Best done directly in the Eclipse Git perspective (open via, e.g., Window -> Perspective -> Open Perspective -> Git), but you can also pull the repo in a different way and then import the projects.
4. Create an empty folder src for the project se.gu.cse.idxse.bomi via Right-click -> New -> Folder.
5. In the project se.gu.cse.idxse.bomi.text, navigate to the file src/se.gu.cse.idxse.bomi.text/Bomi.xtext. Generate the Xtext editor infrastructure by right-clicking Bomi.xtext and selecting Run as -> Generate Xtext Artifacts (ignore the warning that there are errors in the project, because the errors will get removed after the code generation).

Setup the Runtime Workspace

1. Right-click one of the projects in the development workspace and select Run -> Run As -> Eclipse Application. This launches the Eclipse runtime with an empty runtime workspace.
2. If a dark theme is applied: For a better representation, switch the dark theme to a bright one via Window -> Preferences -> General -> Appearance. Under Theme, switch to Classic or Light.

Import an Existing BOMI Model Example

1. From the folder examples in this repository, import the project se.gu.cse.idxse.bomi.examples.
2. Open the file CompanyA_UserStories.aird by double-clicking it. Under Representations, you can find diagrams for all BOMI view types that you can now explore. The actual BOMI model is persisted in the file CompanyA_UserStories.bomi.

Create a BOMI Model from Scratch

1. Create a new general project (File -> New -> Project... -> General -> Project).
2. In this project, create a new .bomi file (File -> New -> File). Say "OK" on the prompt when asked whether the project should be converted to an Xtext project.
3. In the project, create a representation file (right-click .bomi file -> Representations File).
   • In the wizard, select Initialization from a semantic resource
   • Finish the wizard by creating an .aird file.
4. Open the .aird file by double-clicking it. In the middle, select BOMI Detailed Diagram and create a new diagram via New... and complete the subsequent wizard.
5. The empty BOMI editor opens. Create new nodes and edges by using the palette on the right-hand side, and fill out the details with the property editor in the bottom.