Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Nov 19, 2020 16:42

Welcome to Perfecto's Public Cloud! This article helps you get started with manual testing. It walks you through the process of logging in, selecting a device, installing an app, exploring testing options, and viewing test results in Perfecto Smart Reporting. In addition, we show you here how to perform the most common administrative tasks.

For more information on manual testing on devices in the cloud, see the Manual testing section.

1 | Log in

After completing the sign-up process, go to and log in using the username and password provided in the welcome email you received from Perfecto.

On this page:

2 | Select a device

  1. On the landing page, click OPEN DEVICE.

  2. In the Manual Testing view, find a device you want to work with.

    By default, the Manual Testing view opens in tile view , but you can switch to a row view  if you prefer.


    If you have been here before, you can select Recent in the left pane and choose a device you worked with previously. At any time, you can sort by manufacturer or use the search box at the top right if there is a specific device you would like to use.

  3. Do one of the following:

    • To select a mobile device:

      1. Make sure one of the mobile device folders is selected on the left, and then select the mobile device you want to test on to display the details pane on the right. This pane provides details on the device, such as availability, OS version, device ID, or location, and available capabilities.

      2. On the device tile or in the selected device row, click OPEN.

    • To select a web device:

      1. In the left pane, click the Web folder.

      2. Click OPEN NEW WEB SESSION.

      3. In the Open new web session panel, select the operating system type and version, the browser type and version, the resolution, and the location. If you want to use.

      4. At the bottom, enter a URL to test.

      5. To view Selenium capabilities generated for the selected configuration in all supported languages, click View capabilities

        You can copy those capabilities and use them in your scripts. To view the capabilities when the session has started, click the information icon  in the right vertical toolbar.

      6. Click OPEN.

3 | Test your app

The device session opens on a dedicated tab. Now you can begin testing on the device. For information on the testing functionality available in the public cloud, see Public Cloud updates

Expand the option that corresponds to the testing you want to perform.

Mobile app testing

Install your app

  1. On the device tab, in the device toolbar on the right, click the applications icon .

  2. In the Applications form, click INSTALL NEW.

  3. In the Install new app form, in the SELECT APP panel, select Computer.

  4. Add your file: 

    1. Click ADD FILE.

    2. Browse to the file you want to use.

    3. Select the file and click Open.
      The file loads.

  5. Click NEXT.

  6. In the CONFIGURE APP panel, turn on any of the following options, as required:

  7. (Optional) Select the Launch after installing checkbox.

  8. Click INSTALL APP
    Perfecto installs the application and launches it (if you selected this option).

Explore testing options

The device toolbar includes all or most of the following options. Take your time to explore and play with them.


Click to retrieve device information, including OS, device ID, location, and so on, and generate capabilities.

Click to copy the session ID. See also Share a session with an IDE script.

Click to install, run, stop, delete, or look for an application on the device. For details, see Manage apps.

Click to start and stop image injection.

Click to inject a fingerprint or face ID. For details, see Inject a fingerprint or face ID.

Click to set a location.

Click to perform text analysis.

Click to perform visual analysis.

Click to inject an audio file.


Click to connect the device to or disconnect the device from DevTunnel.

Click to initiate network virtualization.

Click to initiate a call to this device.

Click to initiate an SMS to this device.

Click to collect device or application vitals.

Click to transfer, download, upload, or delete a file.

Click to view the device log.

Click to rotate the device from portrait to landscape and vice versa.

Click to restart the device, for example when the device freezes or for a fresh start.

Click to open a case with Perfecto Support. The link opens in the context of your open device session.

Click to spy objects on the device screen. This opens the Object Spy in the right pane. 

Web app testing

The interactive experience is similar to what you would be getting if using your local browsers:

  • To type, click the desired field and start typing. You can type in any language that your workstation supports.
  • To view the context menu, right-click.

    Note: The target browser handles the right-click option (not your workstation browser). To use the right-click option handled by your workstation browser, right-click outside of the browser session space. 
  • Use familiar keyboard shortcuts, such as CTRL+A to select all text or CTRL+C and CTRL+V to cut and paste text, or other combinations supported by the OS.
  • Use your mouse wheel to scroll. 
  • Use the developer tools of your session browser, usually by pressing the F12 key. The session catches all keyboard activity. To use the developer tools of your workstation browser, click the address bar and then press F12, or select it using the menu in your workstation browser.
  • To take a screenshot, use your workstation snipping tool or any other graphic tool of your choice.
  • To close a session, click the X on the session tab.

For more information on desktop web testing, see Test web apps on desktop browsers and Share a session with an IDE script.

4 | View test results in a report

To view test results in a report, from the top menu, select Test Analysis.

The Test Analysis view presents your test results on the following tabs that present different views of the result data:

  • CI Dashboard: Displays the history of the test results, grouped based on the CI jobname identifier. Here, you can track your CI/CD pipeline and scheduled builds/jobs.
  • Heatmap: Displays a graphic overview of different cross-sections of the test results. You can group test results by two levels of characterizations – devices or specific tags. The different groups are color-coded based on the distribution of passed or failed tests.
  • Report Library: Displays a list of all single test reports for the Perfecto Lab, along with recorded videos and screenshots. You can filter the listing to focus on a set of tests with a particular tag or drill down to view the full report. The tags may be execution-level context tags or specific test tags. You can also export reports in PDF format or as JSON data.
  • Live Stream: Displays a list of test executions currently in progress and allows you to stop one or more executions at once if needed.

In addition, you can drill down to view the Single Test Report (STR) for a specific test. You can also export the generated Execution Summary or Single Test report (optional) as:

For more information, see Access and navigate the Test Analysis UI.

5 | Perform administrative tasks

Now that you have explored how manual testing works in Perfecto, let's take a quick look at how you can set up your team. The tasks in this step are typically performed by a user with an administrative role. They include adding members to your team, creating org groups and adding members to org groups, and adding roles.

Groups are useful for organizing users within Perfecto, for example by manager, project, or other criteria that work well for your team. Groups do not impact a user's access privileges within Perfecto. Those are controlled by roles.

Roles allow an administrator to determine the level of access a team member has within Perfecto. The roles available to your team are determined by the Public Cloud Package you have purchased. Standard roles might include:

  • Administrator: The Lab Admin with full privileges for your Perfecto Public Cloud. This would be a good role for the team lead or manager that is responsible for overall access to the Perfecto Public Cloud environment

  • Handset Viewer: A typical Perfecto user. This role allows a user to perform manual tests, view and stop executions, and view reports.

For more detailed information on these administrative tasks, see Manage users.

Add members to your team
  • Click the menu at the top and select Assets and Setup.

  • In the Assets and Setup view, click Admin to open the Users tab.

  • On the Users tab, above the table, click Add user .

  • In the Add user form, provide user information and assign a username and password. 

    For information on adding groups, see step 4.

  • To add additional users, turn on the Add one after another option.

  • Then click Add.

  • (Optional) To edit user information or delete a user:

    1. Select the user in the table.

    2. In the toolbar above the table, click More actions and select the required option.

Add org groups and assign members to groups
  1. To add a group to your cloud, in the Org groups pane on the left, click Add .

  2. In the Add Org group form, provide the following information:

    • Group name, for example My web team
      The group name cannot exceed 25 characters.

    • Description, for example Used by my web team
      The description cannot exceed 50 characters.

  3. Add users to the group using the Search field. You can enter a username or an email address.

  4. To add additional org groups, turn on the Add another when done option. You can also come back to adding users to a group later, whenever the need arises.

  5. Click ADD.

  6. (Optional) To edit a group:

    1. In the right pane, select the org group you want to edit.

    2. Click the pencil icon  on the right.

    3. In the Edit Org group form, make the required changes and click SAVE.

  7. (Optional) To delete a group:

    1. In the right pane, select the org group you want to delete.

    2. Click the trash can icon  on the right.

    3. When prompted for confirmation, click YES.

Add roles
  1. To add a role to a user, select a user in the table.

  2. In the details pane on the right, on the ROLES tab, turn on the role or roles you want to assign to the user.
    You can change a user's role settings at any time.