Exercise 2: Buy a laptop

This exercise guides you through automating the process of buying a new laptop from the Advantage Online Shopping site using LeanFT.

This exercise assumes that you now have an Advantage Online Shopping account.

You can use the account you created in Exercise 1: Create an account, or create a new one before completing the steps below.

Tip: You may want to switch your IDE for this exercise to learn how to use LeanFT in different environments.

For example, if you used Eclipse in Exercise 1: Create an account, try this exercise in Visual Studio.

Step 1: Create a new testing project in your IDE

  1. Create a new testing project using one of the LeanFT templates for your IDE as you did in Exercise 1 (Step 3: Create a new testing project).

    Give your project a meaningful name.

  2. Your project is created with a blank test method, which you will use to include the test logic.

    Rename this test method with a more meaningful name.

Note: If you decided to use the same IDE as in Exercise 1, you can add a new test to your existing project instead of creating a new project.

Back to top

Step 2: Add code to open the Advantage Online Shopping site

In the blank test method, add code as you did in Exercise 1 (Step 4: Add code to open the Advantage Online Shopping site) to:

Use the LeanFT SDK for your IDE.

Back to top

Step 3: Add code to find a Windows 10 laptop

  1. Add code to click on the LAPTOPS category on the Advantage Online Shopping home page.

    1. Use the Object Identification Center (OIC) to generate and copy the recommended identification code, and paste it into your script.

    2. Call the Click method of the pasted test object code.

  2. Add code to filter and view Windows 10 laptops only.

    1. Add code to expand the OPERATING SYSTEM filter category.

      Use the OIC to build a unique identification for the Operating System category title object. This time, enter the identification code manually into your script instead of using the Generate Code to Clipboard button.

      Then, call the Click method to expand the category.

    2. Add code to select the Windows 10 check box in the filter.

      Your code should use XPath to identify the Windows 10 check box.

      Use the OIC's Edit mode to obtain this XPath value. (Click the Edit/Simple mode button in the OIC to toggle between modes.)

      Note: Check boxes have a specific method to enable selection. Use this method in your code.

Back to top

Step 4: Add code to buy a specific laptop

  1. Add code to identify the laptop you want to buy.

    In this step, we describe how to use Insight to identify the specific laptop you want to buy, based on a saved image file you provide.

    Use Insight when LeanFT cannot identify an object using its properties, and you want to identify the object based on its appearance instead.

    1. Use an image editor to capture and save an image of the laptop with the green cover.

    2. Add code to identify the laptop using Insight and the image you saved. For more details, see Insight image-based identification (Windows only).

  2. Add code to read the price of the laptop.

    This time, do not identify the price using LeanFT's recommendations in the OIC.

    Instead, look for a better and more robust identification using the OIC's Edit mode.

  3. Store the laptop price in a variable.

    You'll use this variable later when you are verifying your subtotal.

  4. Add code to click the laptop.

    Use the Insight code you created in step 1.

  5. Add code to verify that the image presented after clicking the laptop in step 4 is what you expected.

    Use the VerifyImageMatch method to do this.

    For more details, see Verifications.

  6. Update the laptop quantity to 2.

    Add code to click the + button again:

    Identify this button using the CSS Selector property.

  7. Add code to click the ADD TO CART button and add the laptops to the cart.

    For the sake of this exercise, let's pretend that you are unable to identify this object as usual.

    Instead, identify the area of the button using an OCR step that looks for the ADD TO CART text, and click the area using low level replay operations.

    Do the following:

    1. Get the location of the text using LeanFT's OCR mechanism. Do this by using the GetTextLocations method, called on the test object for the button's parent.

      Provide the method with the text you want to find. Remember: The OCR mechanism is case sensitive.

      For more details, see Tips & tricks - OCR methods (Windows only).

    2. Use the Mouse class to perform the actual click on the area where the text is found.

      Note: The GetTextLocations returns the location of the text relative to the text object it was called from.

      However, the Mouse class requires absolute coordinates, so you will have to modify this data.

      For more details, see the SDK reference for your development language.

Back to top

Step 5: Add code to check out

Add code to click the CHECKOUT button on the cart dropdown that appears on the top-right.

Then, add code to verify the total price of the order, using the variable you stored earlier.

This total is displayed on the page that opens when clicking the CHECKOUT button.

Do the following:

  1. Use the OIC to retrieve LeanFT's recommendation to identify the price element.

    To do this, switch to the OIC's Edit mode and spy the price element, which is the number to the right of the laptop image in your cart.

    Then, select all the properties recommended (starred) by LeanFT.

  2. Change the value of the InnerText property from a fixed value to a regular expression.

    The regular expression should represent a text string that starts with a $ sign, such as: \$.*

    Make sure to mark the asterisk * adjacent to the InnerText property's Value field.

  3. Test the identification from the OIC by clicking the Highlight button to ensure that it identifies the price correctly.

  4. Click Generate Code to Clipboard , and paste the code into your test script.

    Then, read the value of the price element using the relevant SDK method.

    Tip: Read the InnerText property value for the element.

  5. Add the verification code to your test using the Verify class.

    For details, see Verifications.

    Note: Remember that you bought two laptops, so the total price should be twice the amount of the variable you stored earlier.

Back to top

Step 6: Add code to log in to your account

In this step, add code to enter the Username and Password field values on the left and click the LOGIN button.

Instead of providing the object descriptions in the code as you did earlier, add all the required test objects to an Application Model, and then refer to these test objects in your code.

Tip: For more details throughout this exercise, see Application models.

Do the following:

  1. Create an Application Model and give it a meaningful name.

  2. Add test objects to the Application Model for the Username and Password fields, and the LOGIN button.

    Tip: You can add these objects one by one, or use the Application Model's Learn child objects option.

    To use the Learn child objects option, in the OIC, select the Page object as the parent (container) object. Then, select Add object to Application ModelLearn child objects.

  3. Edit the names and code names of the added objects as needed.

    If you are working in Eclipse, save the Application Model before moving on.

  4. Add code to your test to perform the required operation for each of the objects, entering values in the fields, and clicking the button.

Back to top

Step 7: Run your test

  1. Customize your test settings to save snapshots during the test run for each step performed and include them in the LeanFT run results.

    Test settings are defined in the test settings file referenced by your testing project:

    • Eclipse/IntelliJ: leanft.properties
    • Visual Studio: App.config

    For details, see Customize test settings.

    If you already did this in Exercise 1: Create an account, and are working in the same IDE and testing project, you can skip this step.

  2. Build your project and run your test directly from your IDE as you did in Exercise 1: Create an account.

Back to top

Step 8: View, analyze, and customize the report

Open the generated run results from your IDE and review them.

For more details, see Analyze run results.

Back to top

See also: