Test Modeller

All code created using Test Modeller uses code templates that define the structure and type of code to be created. Test Modeller provides support for numerous open-source frameworks out-the-box, made available on the Curiosity Software GitHub page (https://github.com/CuriositySoftwareIreland).

The sample framework provides pre-configured code templates within the Code Template directory. To import these into Test Modeller, follow these steps. A video tutorial is also available:

To import code templates:

1. Log in to Test Modeller.

   

2. On the Workspace > Configuration tab, select code templates from the configuration view.

   
   

3. Upload both the page object and test case code templates by clicking Import to the right of the Code Template header.

   
   

4. Register a new automaton framework using the code templates. You need to select the code template and test case templates that you previously uploaded.

   

   

5. Create a new project within Test Modeller that will be used as a workspace for the page objects and models created for consumption by Perfecto, as follows:

   Go to Project & Releases’. Select to create a new project and enter a suitable name for the project.

   

   

   
   

   In the wizard select the automation framework you just created to bind to create the project. This tells Test Modeller to use this specific framework for generations (although it can be overridden at any time).

   Important: This is using the sample framework and configuration provided by Curiosity Software. You may have your own Perfecto based automation framework. This can be integrated into Test Modeller by configuring your own code templates. The following video tutorial is also available.

Within the sample framework, you need to specify your Perfecto API endpoint and the access token to connect to your Perfecto instance. In the sample framework, this is configured in the following class:

Framework\src\main\java\utilities\CapabilityLoader.java

You can specify the API key and token here, along with the device capabilities of the device within the Perfecto instance against which you wish to execute the tests.

Follow section 3 at https://testmodeller.io/tutorials/selenium-java or watch the following video.

Follow section 4 at https://testmodeller.io/tutorials/selenium-java or watch the following video.

Follow section 5 at https://testmodeller.io/tutorials/selenium-java or watch the following video.

Follow section 6 at https://testmodeller.io/tutorials/selenium-java or watch the following video.

Perform the steps described in this video tutorial:

Perform the steps described in this video tutorial:

Make sure to install the following required dependencies on your machine before starting to work with this project:

• Java 8

• An IDE to write your tests in, such as Eclipse or IDEA IntelliJ

• Maven

Depending on your IDE, you also need to install:

• Maven plugin for Eclipse
• Maven plugin for IDEA

The TestNG plugin is built into IntelliJ IDEA version 7 and later.

The following installations are optional:

• For source control management, you can install git.
• To be able to interact with a real device in the Perfecto cloud directly from your IDE, and to use Perfecto Smart Reporting, install the Perfecto CQ Lab Plugin for your IDE.

1. Clone the repository.

2. Download the project and unzip it to your computer.

3. In your IDE, open the project by choosing the folder that contains the pom.xml file.

Perform the following procedure to run the sample as is. Refer to official documentation on how to execute from your respective IDE (Eclipse or IntelliJ).

To run the sample as is:

1. Register the code templates to Test Modeller by following this tutorial.

2. Copy the generatedpage objectsinto theFramework\src\main\java\pagesdirectory.

3. Copy the generatedtestsinto theFramework\src\test\java\testsdirectory.

4. Open CapabilityLoader.java from the src/main/java/utilities package.

5. Update the cloud information as follows:

   1. Search for the following line:

      Copy

      String cloudName = "<<cloud name>>";

   2. Replace<<cloud name>>with the name of your Perfecto cloud (for example demo) or pass it as Maven properties, as follows:

      Copy

      -DcloudName=<<cloud name>>

6. Add your security token:

   1. Search for the following line:

      Copy

      String securityToken = "<<security token>>";

   2. Replace<<security token>>with your Perfecto security token or pass it as Maven properties, as follows:

      Copy

      -DsecurityToken=<<security token>>

7. Run the pom.xml file with the following Maven goals and properties. Maven will automatically kick-start the parallel execution of different examples inside the Perfecto package.

   • If credentials are hard-coded:

     Copy

     clean
     test

   • If credentials are passed as parameters:

     Copy

     clean
     test
     -DcloudName=${cloudName}
     -DsecurityToken=${securityToken}
     -DtestngXmlFile=testng.xml

8. To perform the CI dashboard integration, supplying the following properties to the top-level Maven targets:

   Copy

   clean
   test
   -DcloudName=${cloudName}
   -DtestngXmlFile=testng.xml
   -DsecurityToken=${securityToken}
   -Dreportium-job-name=${JOB_NAME} 
   -Dreportium-job-number=${BUILD_NUMBER} 
   -Dreportium-job-branch=${GIT_BRANCH} 
   -Dreportium-tags=${myTag}