Laserfiche WebLink
TSTool Documentation Commands <br /> Commands - 15 <br /> <br />The command processor uses properties to manage controlling information. These properties can be set <br />with commands to facilitate overall workflow logi c, for example to allow configuration information to be <br />defined at the start of a command file, and be used by other commands. TSTool commands will continue <br />to be enhanced to utilize these properties. <br /> <br />The RunCommands() command can be used to create a “ma ster” command file that runs other <br />command files. This approach is used to create test suites to validate the TSTool software. Commands <br />also are available to run external programs, Python scripts, and the Army Corps of Engineers DSSUTL <br />software, which pr ovides time series processing capabilities. <br /> <br />4.2 1 General Commands – Test Processing <br /> <br />The Commands…General – Test Processing menu provides choices to insert commands related to <br />software and process testing. A test case can be a simple test (e.g., test of a single command with a <br />specific combination of parameters) or a more complex test (e.g., a test of a command file used to process <br />a data set file). T he CreateRegressionTestCommandFile() can be used to search a folder and <br />sub -folders for command files mat ching a pattern (e.g., Test_*.TSTool ). This will create a master <br />command file that includes RunCommands() commands. These commands are used by software <br />developers to create test suites to verify TSTool software functionality and can also be used by softw are <br />users to verify that a process is certified and gives expected results . Comparing the results from a specific <br />software version with expected results is useful for diagnos ing errors . <br /> <br /> Menu_Commands_General _Testing <br />Commands…General – Test Processing M enu <br /> <br />The following is an example command file to run the CreateRegressionTestCommandFile() <br />command: <br /> <br /># <br /># Create the regression test runner for the <br /># TSTool/test/regression/TestSuites/commands_general files. <br /># <br /># Only command files that match Test_*.TSTool a re included in the output. <br /># Don't append the generated commands, in order to force the old file to be <br /># overwritten. <br /># <br />CreateRegressionTestCommandFile(SearchFolder="..\..\..\commands \general", <br />OutputFile="..\run \RunRegressionTest_commands_general.TSTool",Append=False) <br /> <br /> <br />The following command file is generated from the above and can be run to execute the individual tests. <br />Typically each test uses the CompareTimeSeries() or CompareFiles() command to generate a <br />warning if results are not as expected. <br /> <br />69