M2M Import by Command-line

1. Here is the M2M Import command line:

   call_extended "M2M IE Engine" "-m2mMode M2MImporter -filePath 'D:/export.arxml' -ruleset 'Arxml2SysML' -traceabilityReport true"

   The maximum number of characters of a Rhapsody command-line is 256 including the first part "call_extended "M2M IE Engine". Everything after the 256th characters is not transmitted to the M2M IE Engine.
   
   • m2mMode ['M2MExporter','M2MImporter']: (mandatory) this argument is used to determine if the M2M IE Engine have to import or export a model.
     
     
   • ruleset [full path name of the M2MImportRuleset in Rhapsody]: (mandatory) this is the full path name of the M2MImportRuleset which must be applied on the model for transformation. A project can contain multiple M2MImportRulesets, so only one must be selected.
     
     
   • filePath [ex:'C:/export.arxml']: (mandatory) this argument is for the path where the model will be exported.
     
     
   • targetPackageName [Package name]: this argument value is used to name the Rhapsody package where the model to import will be created. If the argument is not used, the target model is directly written at the Rhapsody project level.
     
     
   • traceabilityReport [‘True’, ‘False’]: this argument is to enable the generation of a TraceabilityReport. This report is a Rhapsody Table which display in the first column the source element, then, the target element, and the MappingRule which has been executed.
     
     
2. Rhapsody commands in a script file
   • The command line must be written in a script file *.txt, and then launched from the Windows Command Prompt. The -f switch can be used to call a script file consisting of a number of commands. Within a script file, there is no need for the "-cmd" before the command name. Comment lines in script files begin with a number sign (#).
     
     
   • Script file example
     

     # This is a sample script file

     setlog d:\log.txt

     open d:\rhapsody\samples\Dishwasher dishwasher.rpy

     call_extended "M2M IE Engine" "-m2mMode M2MImporter -filePath 'D:/export.arxml' -ruleset 'Sysml2Arxml' -traceabilityReport true"

     make

     save

     make

   • Calling a script file
     
     Launch the command rhapsody -f script.txt in the "Command Prompt":
     
     
     Or launched with a .bat file which contains the command: