Skip to main content

Command Line Script Type

Appvance IQ is a platform that supports running any Command-Line commands. Here are the steps that we need to follow to run the command line command from Appvance IQ.

Running a Command-Line Functional Test

Please follow the below steps.

  1. In AIQ navigate to Scenario Editor.

  2. Click File and select New to create a new scenario

  3. Select Functional Test in the Scenario Test Type dropdown.

  4. Click the Test Management tab and check: "Repeat scenario's test cases 1 time"

  5. Click the Test Cases tab and click Add Testcase to add an execution.

  6. Enter the Test Case Name and Script Name.

  7. Select Command Line from the Script Type dropdown

  8. Type the command that needs to be executed, Following are some of the commands that can be run, but any command-line command can be used.

    For example

    • ls
    • mkdir "C:/Users/User1/FolderName"
    • ipconfig
    • ping http://www.google.com
    • taskkill /f /im firefox.exe
    • taskkill /f /im java.exe
    • dir
    • Tasklist
    • Powercfg

  9. Navigate to the Options tab and select the Scenario section.

  10. Make sure that Enable logging, and Always save logs (failures only) are selected.

  11. Click File > Save to save the new scenario.

  12. Click Play Scenario.

  13. The Controller window will open in a new tab, and display the tests while they are running. The pass / fail status of the tests will be displayed upon test completion.

    The left part shows the steps and the duration in milliseconds and the right side shows the test run status under the Output tab.

  14. Navigate to the Test Case(s) Execution tab and click the test case result. Then click the Output tab below to see the output.

  15. On the Transactions tab, you can find the request/response. Click on the Error tab to drill down further into the results.

Additional Example - ping command

Additional Example - tracert command


Running a Command-Line Performance Test

Please follow the below steps:

  1. In AIQ navigate to Scenario Editor.

  2. Click File and select New to create a new scenario

  3. Select Performance Test in the Scenario Test Type dropdown.

  4. Click the Test Management tab.

  5. Enter an Iteration name and then select Executions Per User from the Completion Type dropdown.

  6. Click the Test Cases tab and click Add Testcase to add an execution.

  7. Enter the Test Case Name and the Script Name.

  8. Provide the command line command. Click Save.

  9. Enter 5 in the Users field and 5 in the Executions field.

  10. Navigate to the Options tab and select the Scenario section.

  11. Make sure that Enable logging, and Always save logs (failures only) are selected.

  12. Click File > Save to save the new scenario.

  13. Click Play Scenario.

  14. The Controller window will open in a new tab, and display the tests while they are running. The pass / fail status of the tests will be displayed upon test completion.

    The left part shows the steps and the duration in milliseconds and the right side shows the test run status under the Output tab.

  15. Navigate to the Test Case(s) Execution tab and click the test case result. Then click the Output tab below to see the output.

Command-Line Resource

Command-Line Resource is another Script Type that requires the resource to be browsed.

Files with .cmd, .sh extension can be used with this Script type just like designer scripts (.ds) etc. This file will be added as a resource file in the Resources Panel of the Scenario Builder.

An example could be to open a swing or JavaFX application from a shell or command script.

  • cd /opt/utp/MyScripts/SwingSet2

  • sh Swing.sh


Last updated: December 13, 2023

If you have any feedback on this topic, please contact us at documentation@appvance.ai