You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

With the Blueriq Model Mapper it is possible to create and run test cases for Data Mappings. This Command Line Interface Test Runner is created to run the created tests in a Continuous Integration/ Continuous Deployment environment to enhance the quality control of your Blueriq Models. When the Test Runner is ran the test results are stored in a file which can be interpreted by a CI/CD like Jenkins. The file output format follows the Apache Ant's JUnit task XML Schema, which is widely used by different reporting tools. 

How to Use

The Test Runner is packaged as an executable for windows, which required command line arguments to be ran. Below all the command line arguments are listed which can be used by the Test Runner A example of the using the Test Runner would look like this.

Example
C:\model-mapper\cli-test-runner-win.exe --proxyServerUrl=http://localhost:1337 --studioUsername=username --studioPassword=password --repository=MyRepository --branch=Trunk --project=MyProject

When this configuration is used and the Test Runner is ran the test results will we available at C:\model-mapper\target\testresults.xml, it also possible to create a config.json which can be used to pass in the command line arguments.

config.json
{
  "proxyServerUrl": "http://localhost:1337",
  "studioUsername": "username",
  "studioPassword": "password",
  "repository": "MyRepository",
  "branch": "Trunk",
  "project": "MyProject"
}

To use the config.json the following command can be executed.

Example
C:\model-mapper\cli-test-runner-win.exe --config=config.json

Command Line Arguments

The Test Runner can be either configured by a JSON configuration file or by command line arguments. when running the Test Runner with the argument --help a list of configurable argumentis displayed.

ArgumentRequiredExplanationDefault value
--proxyServerUrlyes

The url of the proxy server(NGINX) of the Model Mapper

Example: http://myurl:port/

-
--studioUsernameyesThe studio username which is used to retrieve information from Blueriq Studio-
--studioPasswordyesThe studio password which is used to retrieve information from Blueriq Studio-
--repository, -ryesThe studio repository which is used to retrieve information from Blueriq Studio-
--branch, -byesThe studio branch which is used to retrieve information from Blueriq Studio-
--project, -pyesThe studio project which is used to retrieve information from Blueriq Studio-
--outputDirnoThe output directory where the ouput file will be created in<currentDirectory>/target
--outputFilenoThe output file where the result of the run will be stored intestresults.xml
-c ,--confignoThe location of a JSON config file containing configured test runner argument-
  • No labels