34.1 How to Run Your Opkey Tests from Opkey App

OpKey-Continous Test Automation is available with a whole new experience to the test automation community.

Record your test cases using the powerful OpKey recorder extension available in the Chrome store.
Create and manage your entire test automation scripts.
Run the recorded test cases from Salesforce itself.
Access real-time mobile devices and browsers using our pCloudy integration.
OpKey Impact Analysis will save your precious debugging time by which the user can simply validate the change and update the scripts accordingly.
The Salesforce Scanner lets the user create Function Libraries of the Salesforce Objects

Install OpKey Agent

OpKey Execution Agent is a functional test execution engine that helps you to execute your test script. Let’s quickly follow the procedure to install the OpKey agent.

Double click on the downloaded setup file of OpKey Agent and wait for the setup file to extract.

Click on Next button to initiate the Agent installation process.

Here, you can read the End User License Agreement. Check the “I accept the terms of the License Agreement” checkbox and click on Next.

You can customize the installation of OpKey Execution Agent features during installation. If you want to install the full version of OpKey Execution Agent then select ‘Full‘ and select ‘Custom‘ if you want to customize it. Click on ‘Next to proceed.

In this step, OpKey Execution Agent calculate the available, required & remaining space on your machine. Click on ‘Next‘ to proceed.

From here, you can customize usage of this OpKey Execution Agent being installed on your machine for All users of this computer or Just me. If you select All users of this computerthen it will be accessible to all users working on this computer whereas if you select ‘Just me’ then it will be accessible only to the current user of this computer.
You can check Create Installation Logsto view installation logs on completion of Agent installation. Click on Next to proceed.

Once OpKey Execution Agent has installed on your machine successfully, you need to configure it for executing your test on OpKey Web. Follow the below given instructions to configure your OpKey Agent:

Double click on OpKey Execution AgentIcon to launch it.
Go to the Authorize Web Execution Agentsection.
Here we have two methods to configure OpKey Agent:
OpKey Server Credential
Authentication Code

Configure OpKey Agent

Double click on OpKey Execution Agent Icon to launch it.
Go to the Authorize Web Execution Agent section.
Here we have two methods to configure OpKey Agent:
OpKey Server Credential
Authentication Code

Configure OpKey Agent: OpKey Server Credential (Method 1)

In this OpKey Agent authentication mode, the user needs to select OpKey Server Credential as Authentication Mode.

Provide all the valid credentials:
Server URL: The server URL is your registered OpKey Web Domain.
Agent Name: You can provide any name here. This name will be displayed in the list of OpKey Agents for which the OpKey Web domain has been configured.
Username: This is your registered user name (it’s generally your email address) through which you can log in on the particular registered OpKey Web domain.
Password: This is the password corresponding to the registered User Name for the particular registered OpKey Web domain.
Comments(optional)

Click Login. A popup message will be displayed.
Click Yesto re-launch OpKey Agent so that all the configured changes shall be reflected.

Configure OpKey Agent: Authentication Code (Method 2)

In this OpKey Agent authentication mode, the user needs to select Authentication Code as Authentication Mode.

Provide valid Authentication Code.
Authentication Code: Authentication Code (a unique alphanumeric key) available on the Agent Information page under Download Center.

Click Login. A popup message will be displayed.

Click Yes to re-launch OpKey Agent so that all the configured changes shall be reflected.

Once the OpKey Agent get authenticated successfully, your Agent will be online. The name of the Agent will be visible in the Execution wizard on which you will be able to trigger test execution.

Run test from OpKey-Continuous Test Automation

As we have already recorded our first test case, let’s understand how to run the test from Salesforce and view its result.

Open the previously recorded test “Test Case 1” from the project workspace tree.

Click on the “Run” button available on the test case toolbar.

Fill all the required fields on run wizard:
Provide value in “Choose or Create Build” field. (say “Test Run”)
Provide value in “Session Name” field. (say Test 1)
Select an online agent which is connected with the domain. (say “MASTER AGENT”). This is the agent which you configured earlier for OpKey runs.
Set step timeout = 90sec
Set snapshot frequency = All Steps. (This selection will capture snapshot of all the steps executed in your run.)
Set snapshot quality = High
Select or deselect “Highlight Object” checkbox as per your requirement to highlight the running step’s object when the run is in progress.

Click on “Finish” button to start run when all the mandatory fields are filled. “Run” will be initiated successfully.
Wait for the run to complete.
After successful completion of run, go to “Execution Result” option available on top-bar in “Test Automation” tab.

Select Build (i.e. Test Run) under which the run was initiated.
Open the session run result which was run under the Build “Test Run”.

Expand the result hierarchy to view the status of executed steps.
Click on “View” option available inside the action dropdown of any step to view detailed information about the executed step:

Name of the step.
Step status
Total time taken for the step to run.
Snapshot of the executed step during the run.

Input data that was passed to the step during the run.

Output fetched by the step after step’s run completion.