Integration with HeadSpin – ACCELQ

ACCELQ provides the ability to execute tests on your existing HeadSpin subscription. You simply configure your ACCELQ Local Agent integration by following the steps described here.

When running tests on ACCELQ, if the Agent is configured to point to HeadSpin, your application browser is invoked remotely, but the remaining execution and the results workflows remain the same. You continue to manage the test execution cycle from ACCELQ.

If you haven't already installed ACCELQ Agent, follow this article.

API Token from HeadSpin

To integrate with Headspin, you need a HeadSpin API token. Login to your HeadSpin account and click on your profile icon; then click the Settings button as shown in the screenshot below:

Configuring HeadSpin integration from Agent Dashboard:

If you haven't installed ACCELQ Agent already, follow this article.

Open your ACCELQ Agent Dashboard. In your target Agent, Click on Edit Configuration.

As shown in the screenshot below, select the checkbox for "Use external device provider for Web" and/or "Use external device provider for Mobile" depending on your need. Populate the HeadSpin authentication information and save/restart the agent.

Configuring HeadSpin integration from Command Line:

If you are using Command Line to set Agent properties, you should configure the following properties in your Agent properties file.

Properties for Browser-based executions:

web_provider_type=HEADSPIN
web_provider_password [Access Key read from your HeadSpin subscription]

Properties for mobile device executions:

mobile_provider_type=HEADSPIN
mobile_provider_password [Access Key read from your HeadSpin subscription]

Use the following command to set Agent properties. The "--agent" flag is optional in case only one agent is present in the system.

$ acc properties --agent <name> --set <property_name>=<value>

Scenario step to provide App information

When working against a Headspin device infrastructure, the user should install the test app on a Headspin device and generate app information, then pass that value in the first step of the Scenario as shown below.

Executing a test

When the agent is ready and configured with HeadSpin integration, you will be able to select the browser or Mobile OS/Device from the list supported by HeadSpin.

In the Run modal, select the agent from the AGENT/HOST section and then select the browser and device from the respective sections.

Capturing a Mobile View

For Mobile Automation, you could use a device hosted on HeadSpin for recording Views and for setting up element identification. Follow the steps here:

In the View capture dialog, Select Cloud Provider
In the Provider dropdown, select HeadSpin and provide Access key and click Authenticate
On successful authentication, HeadSpin devices will be available for selection.
Once all the fields are ready, click start capture and the capture session with the selected device will begin.

Creating Mobile Driver Profile

For passing additional desired capabilities like 'headspin:capture' for video recording, you can create driver profiles in ACCELQ and set them before execution. Learn more about driver profiles.