Quantum Java Online Training Preparations

Introduction
Your Perfecto training is coming up soon. This quick guide will get you connected and ready to
start. Please complete all the steps and inform your manager that you are all setup 2 days before
the training date. If you encounter any problem, contact your trainer for assistance. The training
sessions begin with an assumption that all attendees have a working environment

Training Knowledge Check

This course is designed for automation testers who have some programming background and can
write simple Java methods. Previous knowledge of Selenium & Appium is recommended but not
required.

Setup Instructions

Follow the below instructions to setup your machine. This guide contains all the steps you need,
don’t worry if the framework itself is not totally clear, we will explain fully during the training.
1. Perfecto Lab Credentials & Access
1. Contact your Perfecto administrator and request Perfecto access.
2. You will receive credentials and the URL of your Perfecto Lab.
3. Open a browser and navigate to the Perfecto Lab URL.
4. After you login, click Open Device

5. Select a device and open it

Congratulations! Your Perfecto user is working and you are ready for the next step.
2. Java installation
Quantum requires Java installed on your machine.
Follow these instructions:
Java Version 8 JDK must be installed on your workstation. If you are unsure if it is installed,
open command line and type java –version.
If you see something similar to the below, you’re good to go.

If Java is not installed, Install JDK8 from here:

https://www.oracle.com/in/java/technologies/javase/javase-jdk8-downloads.html
3. IDE Installation

Writing tests with Perfecto is done by writing in an IDE. We’ll cover all of that in the training.
For now, all you need is to select an IDE and set it up. Perfecto supports the two major IDE’s in
the Market, Eclipse & IntellijIDEA.
Both offer the same functionality. We recommend IntellijIDEA but you can choose the IDE you
prefer. Select the IDE you prefer and follow the instructions in the document per IDE.

Intellij IDEA Installation

1. Follow these instructions to download and install
- http://developers.perfectomobile.com/display/PD/IntelliJ+IDEA
2. Open IntelliJ and validate it opens with no errors.
3. Install plugins –
a. Cucumber Plugin (Community version only)
To access the plugins dialog click on file->settings and then select plugins.
 Eclpse Installation
1. Download Eclipse from https://www.eclipse.org/downloads/?
2. Open Eclipse and validate it opens with no errors.
3. Install Eclipse plugins
o Maven Plugin - http://marketplace.eclipse.org/content/m2e-connector-maven-
dependency-plugin
o TestNG Plugin - http://dl.bintray.com/testng-team/testng-eclipse-release/
o QAF Cucumber Plugin.- https://marketplace.eclipse.org/content/qaf-bdd-editors

These plugins are all part of the Eclipse marketplace and can simply be dragged into
eclipse for the installation window to pop up.
4. The Quantum Training Course Project

We will use a training project to get started. The Git URL for the project is -
https://github.com/Perfecto-Quantum/Quantum-Starter-Kit.git

Follow the below instructions to clone the project

Intellij IDEA
1. Open Intellij and click on get from Version control
2. Enter Repository URL and select Clone
Eclipse
1. Open Eclipse and select File->Import->Git->Projects from Git

Select Clone URI and provide the repository URI

https://github.com/Perfecto-Quantum/Quantum-Starter-Kit.git
2.

3. Select Next until the window that requires selecting Wizard type. Choose
Import as General Project.
5. Running our first script
Our project is ready. All we have left is to quickly run a sample test to validate our
environment has everything it needs.
1. Open the application.properties file under the resources folder. Use the security
token property to set your token. To generate the token -
https://developers.perfectomobile.com/display/PD/Generate+security+tokens
perfecto.capabilities.securityToken=Mytoken

2. Enter the Lab name in the remote server property

3. remote.server=https://<<CQ_LAB_NAME>>.perfectomobile.com/nexperie
nce/perfectomobile/wd/hub/fast

2. Go to the 01_firstRun.xml file located in src/main/resources/config

2. Right click the file and select run or run as TestNG Suite

3. In the console you will see that the script is running.

4. At the end of the execution, there will be a URL for the report in the console log
 5. Open the report.

That’s it! Your Quantum framework is setup and ready to go.

6. Chrome Browser
Selenium & Appium scripts work with objects that are identified with an XPath expression.
We’ll cover this extensively in the training. Right now, all we need to do is ensure you have
the Chrome browser with access to developer tools.

You are now all setup with a working environment! We look forward to meeting you in
the training.
7. TroubleShooting
There are several issues that could happen as you setup your environment, below are
resources and info on common issues.

Resources
1. Developer site with guides - http://developers.perfectomobile.com/
2. Quantum guide - https://github.com/Project-Quantum/Quantum-Starter-Kit

Common issues
1. Proxy – in some organization access to the Internet is via a proxy. To configure -
https://developers.perfectomobile.com/display/PD/Add+a+proxy+to+Quantum+te
sts#expand-Addproxyconfigurationusingalistener

2. Network Requirements -
https://developers.perfectomobile.com/display/PD/Network+best+practices

Getting Help
If you encounter an issue you cannot solve, follow these instructions:
1. For issues relating to Perfecto credentials & permissions contact your Perfecto
administrator or Perfecto customer success manager.
2. For Java installation issues – contact your IT department.
3. For other issues open a case. In the case specify the following:
a. Your Perfecto Lab URL
b. Your Trainer’s name and date of training
c. Details of the problem encountered.
d. Which steps in this guide succeeded and the step # of the problem.
Cases are opened online from the Perfecto application or in the link -
https://support.perfecto.io/