toolbars_and_plugins.rst 3.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. .. _toolbars_and_plugins:
  2. Toolbar/Plugin Documentation
  3. ============================
  4. This section describes the operation of the add-on toolbars and plugins available within AToMPM.
  5. Exporter of AToMPM's Metamodels and Models to Ecore
  6. ---------------------------------------------------
  7. This implementation allows you to export metamodels and models from AToMPM to Ecore.
  8. Copyright (c) 2017 Khady FALL
  9. (khady.fall@umontreal.ca)
  10. .. Installation
  11. .. ^^^^^^^^^^^^
  12. .. In the \\implementation folder, there are two folders: \Ecore and \Plugins.
  13. .. To install the exporting files, do the following :
  14. .. 1. Copy and paste the \Ecore folder in your AToMPM installation at \atompm\users\[your_username]\Toolbars.
  15. .. 2. Copy and paste the two files ExportMM2Ecore.js and ExportM2Ecore.js located in \Plugins in your AToMPM installation at \atompm\plugins.
  16. .. All the files have been properly installed.
  17. Utilisation
  18. ^^^^^^^^^^^
  19. To export metamodels or models in AToMPM, follow these steps:
  20. 1. Open a new session in AToMPM.
  21. 2. Click on the "(re-)load a toolbar" button.
  22. 3. In the \\Toolbars\\Ecore folder, choose "Export2Ecore.buttons.model" then click the "ok" button.
  23. 4. Load your metamodel or model in the current canvas.
  24. 5. If you want to export a metamodel, click on the "MM -> Ecore" button of the loaded toolbar (the first button). If you want to export a model, rather click on the "M -> Ecore" button (the second button).
  25. 6. If you want to export a model, you will be asked to enter the name of the model, the name of the metamodel and its URI. Also, you will be asked if you want a dynamic instance or a static one. There are default values:
  26. * The model's name will be the current model name
  27. * The metamodel's name and URI will be composed as follows:
  28. * "[name_of_current_model]Metamodel"
  29. * "http://[name_of_current_model]"
  30. 7. If you want to export a metamodel, you will be asked to enter the name of the metamodel and its URI. There are default values:
  31. * The name of the current metamodel
  32. * A URI composed as follows: "http://[name_of_(meta)model]".
  33. 8. After entering that information, click the "ok" button.
  34. 9. A file .ecore for a metamodel, or a file .xmi for a model, has been created. That file is in a folder \\exported_to_ecore located in the \\atompm folder of your AToMPM installation.
  35. 10. If you want to use the exported file in Eclipse, you have to register the metamodel.
  36. ModelVerse Toolbar
  37. ------------------
  38. .. warning:: The ModelVerse toolbar is currently in an alpha state. It is only intended as a prototype and should not be used for everyday use, as data loss is certain to occur.
  39. The ModelVerse toolbar is intended to allow for the user to load and save models to/from AToMPM to the Modelverse.
  40. .. warning:: Currently, only metamodels in the SimpleClassDiagram formalism can be loaded and saved, along with instance models.
  41. The first button on the toolbar connects to a running ModelVerse instance running on the current machine.
  42. The second button loads a model from the ModelVerse into the current AToMPM canvas.
  43. The third button saves the current AToMPM model to the ModelVerse.