Generate user journey

After setting up the traffic agent, TrueTest collects and models user journeys that will in turn enable the generation of relevant flows.

TrueTest uses the MutationObserver API and Javascript Listener to track user interactions on the AUT, such as clicks, inputs, and selections by monitoring changes to the DOM and attaching a listener to DOM elements. The technology combination allows TrueTest to collect detailed data on user behavior. TrueTest then uses the data to generate user journey maps in your AUT.

To view the list of application domains with generated user journey map, on the TestOps navigation bar, click TrueTest.

You can click the ID of a map or View details to access its detail page. The detail page includes user flows. See: View user journey map.

Generate new user journey map

You can generate a new user journey map with different time frame.

On the User Journeys page, click Generate New User Journey Map and select a time period, or customize your preferred time period.

• Ignore previous flows and overwrite existing test cases: When this option is turned off and you generate a new map, TrueTest will compare all new flows from the new map with the previous map to determine the Flow Status. When selected, all new flows are generated independently of the previous map, and the list will display New flows only.

The user account that triggers to generate a new map will receive a notification email when the generation is finished.

A user journey map contain several flows built from user interaction with the AUT. You can select the flows to generate test cases.

View user journey map

This document shows you the details of a user journey map generated by Katalon TrueTest.

From the map list on the User Journeys page, you can click the ID of a map or View details to access its detail page.

A user journey detail page has two sections: visualized map and flows.

View visualized maps

Here you can find user journeys visualized as a map. The map contains pages and actions representing connections from the source pages to the target pages. You can:

• Select a flow to highlight it in the map.

• Click and drag the pages to re-organize the map.

• Switch on the Highlight traffic volume toggle to see the amount of user activity.

View flows

A flow represents an end-to-end path performed by a number of users on the AUT. For example, a common flow on e-commerce applications is: View a product > Add it to cart > View cart > Complete checkout.

A user journey map could have a number of different flows. To quickly view the test steps of a flow, click the see more arrow.

To view details of a flow, click the arrows to expand the Flows section.

You can filter the flows by their traffic level, availability of test cases, and by flow popularity. You can also search the flows by their summary and description text.

The flow popularity filter allows you to focus on the most frequently used flows by narrowing down the list of flows to a specific percentage.

Availability of test cases indicates whether the flows have generated test cases or not.

Click Export to export and download all user flows as CSV file.

To view the visualized flow in Map View, click the flow map icon.

Traffic level

Traffic level indicates the relative volume of user sessions that go through a particular flow. It is a good practice to test all flows regularly.

There are four levels based on the percentage of the highest traffic volume observed:

• High traffic flows: The most common use flows in your application. It means many users follow this path. For example, a highly common flow can be users logging in and checking their order history.
• Medium traffic flows: Common flows but not as heavily used as high traffic flows. For example, users browse products and then leave the site.
• Low traffic flows: Flows with fewer users, for example, users adding products to a wishlist.
• Trivial traffic flows: The least common paths that users take. For example, contacting support on an e-commerce site might happen less often in some cases.

Flow Status

From the second journey map generation onwards, TrueTest categorizes the flows as stable, new, or obsolete to simplify the review process.

• Stable: Flows with no changes that present in both the new and previous maps. Test artifacts remain intact and you can skip reviewing these flows.
• New: Flows that did not exist in the previous map and require review.
• Obsolete: Flows that appear in the previous map but are no longer in the new map. See more: Retain obsolete flows.

Generate test cases

After TrueTest has identified the flows from user interaction, you can decided which flows are relevant to generate test cases. In the Flow section, select the desired flow and click Generate Test Cases.

Once the test case generation has finished, you can revisit the flow and click View test case to view its details.

The generated test cases are stored in the registered script repository. Test case names are automatically generated based on the flow.

If you store test artifacts in Katalon Cloud and there is at least one test case generated, the download icon is shown and you can download the zipped file of the generated test case.

Retain obsolete flows

You can review obsolete flows which already have correspondingly generated test cases and decide to retain those flows or not. For obsolete flows with no test cases, TrueTest will archive within the Git repository.

A use flow is tagged as Obsolete in one of the following cases happen:

1. The features related to those flows no longer exist in the application
2. The application has been updated to introduce new flows
3. No users follow the flows during the period when data is collected

Follow these steps to retain obsolete flows.

1. In the User Journey Map summary page, click Review obsolete flows of the relevant map.
   
2. The Obsolete flows list appears. Select the checkbox of the flow you want to keep, then click Retain.
   
   A dialog appears to confirm your action. Select Proceed.

   

3. In case you don't want to keep any flows, select Archive All.

You are directed to the User Journey Map page where you can see the update process of the selected map.