Command line functions for the iManager

Updating results
Report creation
Removing old results

The iManager allows you to control the programs key functions from the command line prompt. This allows you to control the iManager remotely, use scripts to maintain it or simply perform tasks quickly.

The command to use these functions is:

run-silent.cmd

The three functions that can be performed are:
UPDATE
REPORT
CLEAN

Each function has its own options that are often needed to complete the action, these will be discussed below.

For help at any time type: run-silent.cmd /?
This will bring up a help menu that lists the commands, options and syntax needed to run the functions.

Updating Results

To update your results (download them from the mail server) the command syntax is:

run-silent.cmd UPDATE

This will download the results from the POP account specified in the Settings tab of the iManager (see XXX). If you have not entered your password for this account or you have not set the iManager to remember the password you can enter it using the option "-PASSWORD=":

run-silent.cmd UPDATE "-PASSWORD=xxxx"

Just replace the xxxx with the correct password.

NOTE: This way your password will be not be hidden at all. If you do not enter the password but one is required a pop up window will appear and ask you to enter the password.

Report Creation

To create a report using the command line you must enter the REPORT command and specify which type of report, the time period and which tests to include. To do this there are three options that need to be added
"-Report="
"-Timeframe="
"-Test="

The "-Report=" option specifies what type of report to create this is done by giving the file name of the report without the extension. Here is a list of report types and names included with iManager:

Report name
Results by date
Results by accuracy
Results by speed
Results by user
Results by test name
Full user information

File name
results_by_date
results_by_accuracy
results_by_accuracy
results_by_user
results_by_testname
userinfo_results

e.g. "-REPORT=results_by_date"

The next option is to specify the time frame for the report, this is done with the "-TIMEFRAME" option. The available time periods are

AllEntries | Today | Last7Days | Last30Days

e.g. "-TIMEFRAME=Today"

The last option is to choose which tests should be included in the report. To do this you simply add the name of the test to the "-TEST=" option

e.g. "-TEST=Strategic Alliances with Competitors"

As you can easily rename and add new tests the example given here may not apply to the tests you have set in the iManager. To check what the name is for a test start the iManager and go to the Tests tab select the test you wish to view the name for, and look what is written next to the Name field.

If you wish to include all tests in the report simple do not enter anything after the = sign i.e. "-TEST=". This will select all results for all tests.

Here is an example of how to make a report using the options specified above:

run-silent.cmd REPORT "-REPORT=results_by_accuracy" "-TIMEFRAME=Last7Days" "-TEST="

This example creates a report that lists the results by accuracy, includes all results less than 7 days old and includes all tests. Remember you must give valid values for all the options so that the report can be created.

Removing Old Results

You can remove old results using the command line with the CLEAN command followed by the "-TIMEFRAME=" option.

The possible timeframe variables are:

e.g. run-silent.cmd CLEAN "-TIMEFRAME=3Months"

Remember that these options specified to remove results LESS THAN the time given, so run-silent.cmd CLEAN "-TIMEFRAME=1Day" will remove all results older than today's date.

NOTE: For all options that require a "-TIMEFRAME=" option, results are organised by the date they were updated. So for example if you update results on Monday this may include results from tests taken on Saturday and Sunday. If you then try to remove all results older than one day you will still have these results from Saturday and Sunday as they we included in Monday's update. This method is used as often peoples' computer clocks are set with the wrong time and date.