AutoAction

Run the auto actions from "flat lines" scripts based on Selenium WebDriver

This plugin is used to simplify the usage of Selenium WebDriver which is main tool for Automate testing and other tasks.

For example, to complete below form:

{width="826" height="578"}

We just need few lines as below:

Script content

Open https://accounts.google.com/SignUp?lp=1&hl=en
Input Auto First Name
Input Action Last Name
Input autoaction2019 Username
Input autoaction123 Password
Input autoaction123 Confirm
Click Next

instead of complex coding by Java, or Python ...

Prerequisites

(warning) To avoid some issues with Windows security, please start JENKINS server from WAR file (not from Window service mode)

Install browser ( in case the browser is installed at different machine, please refer to Selenium Grid and Selenium Grid config samples and skip this step)

AutoAction plugin will open real browser and execute the actions, so the browser is required to be installed at the machine hosting Jenkins server

Download browser driver

Download required libs

The plugin requires the libs(*.jar)  in for executing the AutoAction scripts

Download the workspace

The plugin requires the workspace folder for the cofigurations

Preparing

  • Copy above required libs to a folder
  • Copy above worksapce to a folder
  • Copy above Firefox driver (geckodriver.exe) file to folder drivers under workspace folder

Your first AutoAction running

Below steps will help you run the auto action script via Jenkins job

  • Create new project (Freestyle project is prefered)
  • Open Configuration
  • Go to Build
  • Add build step: "Run AutoAction"

{height="250"}

  • Filling values (as below): Lib path, Root path, Browsers, Scripts, Run script only

{height="400"}

Script content

Open https://accounts.google.com/SignUp?lp=1&hl=en
Input Auto First Name
Input Action Last Name
Input autoaction2019 Username
Input autoaction123 Password
Input autoaction123 Confirm
Click Next
  • Click Save and Click "Build Now" to run the job
  • After few seconds, a browser window would be openned and go to Google account site up page, filling the values to the form and go to the next page
  • View the statuses of steps

{height="400"}

Sample AutoAction scripts from workspace

For complex cases (e.g. auto testing purpose), multiple test cases need to be run. Please put the content of test cases to files with extension is "chl" and copy them to anywhere in workspace folder. When running, the plugin will find them and run the script content from them.

  • Change the configuration of above Jenkin project as below (clear content of Script text area and uncheck "Run script only" checkbox)

{height="400"}

  • Click Save and Click "Build Now" to run the job

  • Now, system will find 2 files in workspace: creategoogleaccount.chl and createmicrosoftaccount.chl and run the script content of them.

Config browsers field

The value for "Browsers" field could be:

  • firefox → Firefox browser
  • chrome → Chrome browser
  • edge → Edge browser
  • http://[hub-ip]:[port]/wd/hub,[browser] for Selenium Grid case, e.g. http://hub:4441/wd/hub,firefox

AutoAction syntax

Each line in script is an action. Currently, below list is the supported acions:

[TABLE]

Please refer to sample scripts from creategoogleaccount.chl and createmicrosoftaccount.chl

System would skip all lines which contains unsupported actions.

To make the script more readable, the complex text (e.g. url, value with spaces) can be put in dictionary files (any file with extension *.dic) with format: key = value. Please refer to sample dictionaries files under workspace folder: form.dic and url.dic