Using the Command Line Model Importer

The FTMImporter.cmd/.sh script has the following parameters:

FTMImporter <RSA_WORKSPACE> <PROJECT_NAME> <MODEL_FILE_NAME> <DB_PROP_FILE_NAME> <TARGET_PACKAGE_NAME> [<OUTPUT_DIRECTORY>] [-mv]

where:
RSA_WORKSPACE
is the existing Rational® Software Architect (RSA) workspace containing the FTM models. For example: C:\RSA9workspace
PROJECT_NAME
is the name of the project or folder for the model in the RSA workspace. For example, FTM ODM Sample Model.
MODEL_FILE_NAME
is the name of the *.emx file for the model. For example, FSM Model.emx.
DP_PROP_FILE_NAME
is the name of the properties file containing the database connection attributes.
The layout of this file is identical to the database properties files used by the purgeDB and URT utilities. For example, it must have a minimum of the following lines: 
                              connection.url= 
                              connection.schema=
It can also contain other database vendor specific connection properties. This file must be encrypted.
TARGET_PACKAGE_NAME
is the name of the package in the model where the imported model objects are created.
OUTPUT_DIRECTORY
is the name of a directory where the validation report will be written. For example, C:\FTMImporter\output. This is an optional parameter. If it is not supplied, the output is written to the model's project or folder in the workspace for the model.
-mv
This parameter determines whether the specified model is validated. This is an optional parameter. If it is not supplied, the model is not validated.

Any model validation issues found will be written to a report file called ValidationReport.txt. This report file is written to the directory specified in the optional OUTPUT_DIRECTORY parameter. If this parameter is not supplied, the file is written to the model's project/folder in the workspace. If the report file already exists, the importer fails with return code 12 and displays [Model Importer] File already exists [<filespec>].

FTM importer return codes:
  • 0 = The importer completed successfully.
  • 2 = The importer completed with model validation information messages.
  • 4 = The importer completed with model validation warning messages.
  • 8 = The importer completed with model validation error messages.
  • 12 = The importer completed with a severe issue.
Note:
  • A sample script (runFTMImporter.cmd/.sh) has been supplied to demonstrate how to call the FTM importer.