Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions docs/modules/automation-testing/pages/start-a-mixed-session.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,16 @@ image:automation-testing:launch-mixed-session-session-list-right-click.png[width

Now you can view your script running on the device and fix issues in realtime.

== Convert a mixed session to a Test Case

A completed mixed session can be converted into a single Test Case. The Test Case keeps the manual steps and the automation steps in the order they were recorded, so the combined flow can be rerun without recreating the session.

Convert a mixed session from Session Explorer or from the *+New Test Case* pop-up on the Test Cases list page. The session must be complete before it can be converted.

A Revisit of the converted Test Case replays each step through the execution path that matches its source, manual or automation, and reports per-step results. Steps with no replayable equivalent, such as an unsupported Appium endpoint, are skipped with a reason and the run continues.

For the full conversion procedure, see xref:test-management:test-cases.adoc#_convert_to_test_case[Convert a session to a Test Case].

== Limitations/Notes

* In a mixed session, both the Manual and Automation session must be initiated by the same user.
Expand All @@ -63,9 +73,11 @@ Now you can view your script running on the device and fix issues in realtime.

include::automation-testing:partial$mixed-sessions-basic-appium-limitations.adoc[]

* Session Explorer is not available for Mixed Sessions; i.e. it's not possible to view detailed steps and screenshots for Mixed Sessions.
* Session Explorer supports converting a completed mixed session to a Test Case. Viewing detailed steps and screenshots for a mixed session in Session Explorer is not supported.

* Appium script generation is not available for Test Cases converted from mixed sessions.

* Mixed sessions cannot be turned into test cases. They cannot be used for our AI functionality: Scriptless, generating Appium Scripts, self-healing xref:automation-testing:capabilities/add-flexcorrect.adoc[self-healing].
* Mixed sessions cannot use xref:automation-testing:capabilities/add-flexcorrect.adoc[self-healing].

* When you have a mixed Session on a Public Device, you will be charged minutes for the total time usage on the device; you will not be double-charged for an automation and a manual session.

Expand Down
24 changes: 15 additions & 9 deletions docs/modules/test-management/pages/test-cases.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,25 +4,31 @@

A Test Case represents a reusable test flow created from a baseline session.

Test Cases store the interactions captured during a manual session and serve as the definition used for automated execution. Once created, a Test Case can be run repeatedly without recreating the original session.
Test Cases store the interactions captured during a session and serve as the definition used for automated execution. Once created, a Test Case can be run repeatedly without recreating the original session.

[#_convert_to_test_case]
== Convert a session to a Test Case

Test Cases are created by converting completed manual sessions.
Test Cases are created by converting completed sessions. The following session types are convertible:

After you run a manual session with capture enabled, Kobiton can convert the captured interactions into a reusable Test Case.
* Manual sessions
* Appium automation sessions
* Mixed sessions, which combine manual and automation testing in a single session

A session must be complete before it can be converted. Sessions that are still running are not eligible.

You can convert a session to a Test Case from either of the following locations:

* Session Explorer, after a completed manual session
* Test Management, by selecting *New Test Case* and choosing from the list of completed manual sessions
* Session Explorer, after a completed session
* Test Management, by selecting *New Test Case* and choosing from the list of completed sessions

In Test Management, completed sessions are listed from newest to oldest. Select the session you want to convert, then select *Convert*.

In Test Management, completed manual sessions are listed from newest to oldest. Select the session you want to convert, then select *Convert*.
In both cases, the captured interactions from the baseline session define the test flow.

In both cases, the Test Case is created from a captured manual session. The captured interactions from the baseline session define the test flow.
When a mixed session is converted, the Test Case holds both the manual steps and the automation steps in the order they were recorded. Each step is tagged with its source, so a Revisit replays it through the matching execution path. Test Cases converted from a mixed session show *Mixed* as the Source type.

Converting a manual session to a Test Case unlocks additional capabilities, including generating an Appium script and running the test across other devices.
Converting a session to a Test Case unlocks additional capabilities, including running the test across other devices. Appium script generation is available for Test Cases converted from manual sessions.

After conversion, the option to view the Test Case becomes available. Selecting this opens the Test Case details view, where the captured steps and interactions can be reviewed and managed.

Expand All @@ -47,7 +53,7 @@ The following actions are available for each Test Case in the list:
* *Clone Test Case* — create a duplicate that can be modified independently.
* *Delete Test Case* — remove the Test Case from the list and from any test suites it was assigned to.

To create a new Test Case from a past session, select *New Test Case* in the Test Cases view. Completed manual sessions that have not yet been converted are available for selection.
To create a new Test Case from a past session, select *New Test Case* in the Test Cases view. Completed sessions that have not yet been converted are available for selection. Use a keyword search such as `type:mixed` to narrow the list to a specific session type.

=== Test Case details

Expand Down
Loading