Cameo Systems Modeler adapter - User manual

OPERATIONS MANUAL

This guide is to explain step by step the process to transfer values or objects from Cameo System Modeler/MagicDraw to COMET.

Before continuing further, please be aware of the limits of the adapter and of the troubleshooting page in the event an error should happen during the process.

OPERATIONS MANUAL

General

To setup the adapter, follow these simple steps:

Close any running instance of MagicDraw.
Unzip the content of the downloaded zip file with the root folder to “{your MagicDraw installation path}/plugins/”
Your “plugins” folder should now have a folder called “com.rheagroup.dehmdsysml” that contains 2 files: “DEHMDSYSMLPlugin.jar” and “plugin.xml”
Start MagicDraw. You can tell the plugin has been installed by looking at the common file toolbar and notice the COMET® button that appeared.
To update the MagicDraw SysML adapter follow the exact same steps as above.

Getting Started

From the main window pressed the COMET® button and connect to a e-TM-10-25 model from the panel that just opened. Once this is done, you should be able to browse the ElementDefinition tree as well as the RequirementsSpecification tree. You can then now open a SysML model.

Mode Selection and Control

From the impact panel of the adapter plugin, it is possible to:

To switch transfer direction
To preview the net change
To visualize trees from both models- To create/load a mapping configuration

From the main panel of the adapter plugin, it is possible to:

To refresh the E-TM-10-25 session
To Connect/Disconnect from the E-TM-10-25 session
From the ribbon button, it is possible to:
To show/hide the hub panels- To display the local exchange history

Security wise, login to a E-TM-10-25 source can be done with your COMET® login/password which your model administrator can also provide.

Normal Operations

The MagicDraw SysML adapter lets you transfer elements in one or the other direction. When configuring a mapping from MagicDraw to the Hub or from the Hub to MagicDraw, you can define or redefine the target 10-25 element definition of each selected element from any MagicDraw browser. But also redefine mapping by specifying element by element a different target element. The previous operations register themselves in a process where once you have defined what element to transfer to what element of destination, you have the possibility to preview the impact on the target model, but also to filter those impact view based on a selection from the source model. Then you can transfer your mapped values to their configured destination. When you choose to transfer, the mapped elements are then transferred to the configured target model. In the case anything goes wrong at this stage, you can cancel, and the adapter will delete every configured mapping in the state of pending to transfer. Then the adapter will reload and re-apply the loaded mapping configuration.

Mapping

Please refer to the limits page for more information on transferable parameters.

Normal Termination

After all transfer are complete the tree views are refreshed showing Parameters and Variables with their new value. From the main window terminating the program is simple in the way that all connections to MagicDraw and the hub are closed by the program automatically.

Error Conditions

In the case of the Hub session cease to live, for example if the server is not responding, or the connection dropped, the attempted transfers will fail, and you will see a notification in the notification window.

Recover Runs

If the E-TM-10-25 server is not responding, you will notice it when attempting transfer in this direction or if you try to refresh the session. You might want to reconnect to the COMET® server the way you connect the first time. If there is any pending transfer to E-TM-10-25, you can attempt them, but you will most likely have to cancel the transfer is any error are raised.