Creating an AFT Suite to run mobile tests on the Perfecto cloud

When you want to run multiple mobile tests recorded on a mobile application, you can create an AFT. You can configure the AFT Suite with details of the tests, devices to use, and the location from where the tests must be initiated. You can then run the mobile tests on devices that are connected to the Perfecto Cloud.

Before you begin

You must have completed the following tasks:
  • Created or recorded mobile tests for the mobile application that you want to test.
  • Set up your account to access the Perfecto Mobile Cloud. You must have valid credentials such as the host name or the URL of the Perfecto Mobile Cloud instance and the security token to authenticate the connection.
  • Noted the IDs or names of the devices connected to the BitBar Cloud that you want to use.
  • Noted the IP address of the remote agent computer if the mobile cloud is connected to the remote computer.

Procedure

  1. Open the UI Test perspective in HCL OneTest UI if it is not already open.
  2. Go to File > New > Other.

    The Select a wizard dialog is displayed.

  3. Perform the following actions in the Select a wizard dialog:
    1. Select the XML File option in the XML folder.
    2. Click Next.

      The projects that contain the tests are displayed.

    3. Select the project where you want to save the XML file.
    4. Enter a name for the XML file in the File name field.
    5. Click Next.
    6. Select the Create XML file from an XML template option.
    7. Click Finish.
      An XML document is displayed for editing in the Source view tab.
      Note: Open the Source view tab if the Design view tab is displayed.
      A sample of the syntax or structure of the XML is as follows:
      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <inits id="<any_alphanumeric_value>" type="com.ibm.rational.test.ft.aftSuite">
       <group>
        <tests>
           <test path="<path_to_mobile_test_1>"/>
           <test path="<path_to_mobile_test_2>"/>
        </tests>
        <devices>
           <device id="<name of the device 1>”/>
        </devices>
        <locations>
           <location host="<location_where_test_is_run>"/>
        </locations>
       </group>
      </inits>
      
    Refer to the following table to know the variables for the attributes mentioned in the XML sample:
    Element Attribute Variable Description
    inits id <any_alphanumeric_value> Specifies that you can enter any alphanumeric value that helps to identify the XML file.
    test path <path_to_mobile_test_1><path_to_mobile_test_2><path_to_mobile_test_3> Specifies the path to the mobile test in your project.
    Note: You can right-click the test, and then go to Properties > Resource to find the path.
    device id <name_of_the_device_1> Specifies the name or id of the device that is connected to the device cloud.
    location host <location_where_test_is_run> Specifies the location as the computer that runs the test. The host can be the computer that is running HCL OneTest UI or the remote agent computer.
  4. Create the following elements in the XML document:
    Note: You can copy the sample syntax, and then edit the values in the UI. Alternatively, you can create the elements in the XML in the UI.
    1. <group>

      The start and end tags are automatically inserted.

    2. Create <tests> within the <group> tag.
    3. Create <test> within the <tests> tag.
    4. Add the attribute path to the <test> as follows:
      <test path="">
      Note: You must enclose all values that you enter for the attributes within a double quotation mark.
    5. Add additional rows for each mobile test.
    6. Create <devices> within the <group> tag.
    7. Create <device> within the <devices> tag.
    8. Add the attribute id as follows:
      <device id=""></device>
    9. Create <locations> within the <group> tag.
    10. Create <location> within the <locations> tag.
    11. Add the attribute host as follows:
      <location host=""></location>
  5. Refer to the following table for the values of the attributes that you can use in the XML file:
    Element Attribute Example of a value Explanation
    test path MyProject\test_1 The path in the workspace that contains the project with the test. You can find the path of the test from the Test Navigator by right-clicking the test, and then go to Properties > Resource.
    device id Perfecto:8D3E35CF16D8D827E4827ABBCD0E582E2761CADA The name of the Android device is 8D3E35CF16D8D827E4827ABBCD0E582E2761CADA that is connected to the Perfecto Cloud.
    Perfecto:R48904TNSAZ The name of the iOS device is Perfecto : R48904TNSAZ that is connected to the Perfecto Cloud.
    location host localhost The host is localhost if the device cloud is connected to the computer that runs HCL OneTest UI.
    1.20.30.40 The host is the IP address of the remote agent computer, if the device cloud is connected to the remote agent computer.
  6. Enter the values for the attributes for your tests, device, and location in the XML file.
  7. Save the XML file.

Results

You have created an AFT Suite for mobile tests, which you can use to run the mobile tests on devices that are connected to the Perfecto cloud.

What to do next

You can run the AFT suite on mobile devices connected to Perfecto mobile device clouds. See Running mobile tests as an AFT Suite on Perfecto Cloud.