Vuktilar And i can find the ecore file of my DSL ,which generate by xtext. Reference will create a non contained EReference with a A wizard will be opened to guide you through the process of creating this XMI file, once the file is created the EMF Reflective Editor will be opened to edit it. You will get an empty diagram saying double click here to load at the left top. I tk case of EAttribute instances, some typing shortcuts are available. Post as a guest Name.

Author:Digul Vule
Language:English (Spanish)
Published (Last):11 April 2015
PDF File Size:15.25 Mb
ePub File Size:6.90 Mb
Price:Free* [*Free Regsitration Required]

Designing Ecore Models Getting Started Once EcoreTools is installed in your environment, you can start using it either to create a new Ecore model from scratch or to edit an already existing model. Creating a new Ecore EcoreTools provide a wizard setting up your Ecore project. The next page request a project name. The general convention is to use a java namespace notation for your project name.

The project which is going to be created actually is an Eclipse plugin project, the name will be used for the plugin identification. Changing the project name afterward is possible though error-prone and not without impact. Its better to get it right from the beginning.

The next page request information about your Ecore model. Here again, you can keep the default nsURI but keep in mind that its going to be the identifier of your domain within the EMF world. Changing it afterward might requires to update several files. The next wizard page request which Viewpoints should be enabled. Viewpoints are a way to adapt the tooling regarding your current activity for instance Designing or Reviewing your Ecore model.

The Viewpoints you might enable are : Design : when you want to create or adapt an Ecore model. Review : for all the tools which are supporting further analysis of your Ecore model. It contributes a new layer on the Entities diagram to display and edit documentation annotations. It also provides a table editor to fill the documentation for every model elements and at last but not least it provides a Dependencies diagram you can use to inspect cross EPackage dependencies.

Generation : is available if a GenModel is loaded. It provides a table editor for GenPackage instances to tweak some attributes which are visible in the generated editor : the property category and the end user documentation.

If you are really getting started, Design is a good choice, in case of doubt, select everything. Once you clicked on Finish and the wizard prepared the project, this is what you should have. Working with the Modeling Project What is it? The Modeling Project is a facility provided by Sirius which handles models within the scope of a project.

What does that mean? Any model which is in the project is going to be loaded by Sirius behind the scene and its elements will be available in your editors. This mode of usage is designed so that you can work with your models easily, but you might want to have more control. In this case, you can use EcoreTools just by creating Representations Files.

Selecting Viewpoints Each modeling project has a set of viewpoints which are enabled. This controls what kind of representations you can create on the Ecore models inside the project.

To select which viewpoints are enabled on your project, simply use the Viewpoints Selection action in the context menu of the project itself. A dialog box will open which will show you all the viewpoints which are compatible with your project depending on the kind of models it contains. You can check or un-check each viewpoint individually to enable or disable it, and click OK to validate your choice.

Creating a Representation Once the Viewpoints are selected you can create representations : diagrams or tables. All these representations are stored in the. There are several ways to create a representation. You can browse a model in a modeling project and right click on New Representation. Depending on the type of model element you clicked on, different types or representations might be provided. For instance if you right-click on an EPackage you will have : And other representations might be created on a GenPackage : You can also create a new representation by clicking on the Modeling Project itself : And then select the kind of representation you want to create.

In this case the tool will guide you to select a model element for which this representation makes sense. Loading External Models It is possible to load models which are not in the current project by adding Project Dependencies.

You can right click on the Project Dependencies item and add another Ecore file or type the complete URI Creating diagrams from an existing Ecore Entities Diagram Editor The Entities diagram editor has several purpose : this is the main tool to create and edit an Ecore model. When clicking on Add Related Elements from the background of the diagram, all the EClasses which are contained in the current EPackage will be proposed.

This is a convenient way to import all the EClasses of a given EPackage into a diagram. References, super types, attributes and operations are automatically imported in the diagram, if you want to remove some of them from a diagram you can either use the Hide contextual action or leverage one of the filters to hide, for instance, all the derived references.

Overview of the editor Here is the palette of the Entities diagram editor when both the Design and Review Viewpoints have been enabled. Working with Layers Several layers are provided by the editor. When activating a layer some shapes and colors will changes and specific tools will be available to address your current concern. For example, activating the Documentation layer will transform the shape of all the model elements to add a red border if it is not documented.

Two new tools are appearing then in the palette so that you can create the doc annotations. Navigating in the Diagram Once your diagram gets populated it might get harder to find a specific EClass. Just like in most of the other Eclipse editors, CTRL-O will summon a small popup which is very convenient to find an element.

You can select the element in the list and when validating with ENTER the diagram editor will select and reveal this element. Modeling References Shortcuts are available in the palette to create different kind of EReferences : Reference will create a non contained EReference with a Bi-directional Reference will create two EReference instances each one being specified as the eOpposite of the other one.

Containment will create a containment EReference with a You can adapt the EReference properties at any time and the diagram will reflect your changes. If a non-contained reference is changed into a containment reference then the decorator at the source of the EReference will be adapted. Modeling Attributes Shorcuts are available in the palette to create difference kind of EStructuralFeatures, notably: Attribute will create an EAttribute with a default name when used on an EClass.

I the case of EAttribute instances, some typing shortcuts are available. Modeling Operations Using the Operation tool from the palette and clicking on an EClass in the diagram you can create a new EOperation instance. To edit the EOperation signature you have several choices, you can directly type it in the diagram, EcoreTools expects a format like : name param1 : TypeOfParam1, param2 TypeOfParam2 : returnType You can also directly set the values and create new EParameter instances through the Properties View.

Deleting elements Hitting DEL on the keyboard will delete the selected model element and reset all the cross references to it. If you want to remove an element from a given diagram without actually deleting the element, you can either use the Remove tool which is available in the palette or the Delete from Diagram contextual action available with a right click. Validating the model If the layer Validation is enabled, then any invalid element will have red borders.

To understand what is the error exactly, just keep your mouse pointer above the element and the tooltip will provide you a textual feedback. Editing Shortcuts A lot of shortcuts are available to be more efficient when editing an Ecore model. From a general point of view, just edit the label of a given shape and the diagram editor will try to figure out what you want to edit.

For instance: typing 1 on an EAttribute or EReference will switch the cardinality to Shortcuts appearing contextually to a given EClass will allow you to quickly switch the EClass to being abstract or interface Exploring Existing Models EcoreTools provides features which are specifically designed to ease the exploration of an existing Ecore model and assit you in creating a diagram to document this exploration.

Setting properties At any time you have several means to edit the element properties. You can either use the contextual action Show Properties View and then edit from this view or double-click on an element to open a wizard dedicated to the edition of the properties. When used on an EClass this tool will create a new Type parameter. Once it is created you can directly use it in EOperation signatures or even create an EReference targeting this parameter.

Modeling Constraints You can specify domain constraints on an EClass. To do so you need to enable the Constraints layer. Any constraint which is already defined in the model will be automatically imported in the diagram.

You can add a new one and bind it to an EClass using the Constraint and Constraint Assignment tools available then in the palette. Constraints are stored in the model using the EAnnotation format supported by the EMF code generation and runtime. The input which is expected when you edit a constraint note is a comma separated list of names representing those constraints. For instance : isWrittenByAnAuthorizedAuthor, isAvailable EMF will detect these annotations and generate dedicated Java methods based on this name, you will have to implement them then.

Documentation Annotations Documentation Table Editor The documentation table displays all the EPackage elements as a hieararchy in the first column and the corresponding documentation annotation in the second one.

To edit an existing annotation or to create a new one, select the corresponding cell and type using the keyboard. Dependencies Diagram Editor A Depdencies diagram can be created from en EPackage when the Review viewpoint is enabled for your project. This diagram is helpfull to visualize and analyze the direct dependencies between two EPackage. To leverage it, use the Add These instances will be displayed as list containers. If any dependency exist between two EPackages then an edge appears in the diagram.

Within the EPackage representation list the EClasses instances which are involved in this dependency will automatically be displayed by the tool. Hovering your mouse over such an EClass to have an explanation of the dependency.

Leveraging Ecore Model EcoreTools directly edits the Ecore model in a standard way, no special operation is required to leverage the model itself. A specific tool in the palette named Dynamic Instance allows you to quickly create an instance of your domain model without requiring any code generation. To use it select the tool Dynamic Instance and apply it on the EClass of your choice in your diagram. A wizard will be opened to guide you through the process of creating this XMI file, once the file is created the EMF Reflective Editor will be opened to edit it.

Exporting Diagrams You can export an existing diagram in several format by right-clicking on the diagram itself. You can also export all the representations stored in a. FAQ What should I do with my. Indeed from version 2. Writing a migration tool from. As I said, this is technically doable so if you have hundreds of diagrams and want a financial quote related to this work feel free to ask.

To ease the transition both implementations have been provided with EcoreTools 2.


Subscribe to RSS

How to open ecorediag files? File type specification: The kmt file extension is associated with the Kermeta for Eclipse. Kermeta is used to create meta models. The kmt file contains saved ecore diagram information.


User Guide

Designing Ecore Models Getting Started Once EcoreTools is installed in your environment, you can start using it either to create a new Ecore model from scratch or to edit an already existing model. Creating a new Ecore EcoreTools provide a wizard setting up your Ecore project. The next page request a project name. The general convention is to use a java namespace notation for your project name.


How to open ECOREDIAG files on your device


Related Articles