Skip to content

docs(KOB-43479): convert an automation session into a test case (IQS) #511

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
IT-Kobiton wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(KOB-43479): convert an automation session into a test case (IQS) #511

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
35 changes: 31 additions & 4 deletions docs/modules/test-management/pages/create-a-test-case.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
= Create a test case
:navtitle: Create a test case

Learn how to create a test case so you can run xref:scriptless-automation:index.adoc[Scriptless Automation].
Convert a completed session into a test case so you can run xref:scriptless-automation:index.adoc[Scriptless Automation]. You can convert manual sessions and automation (Appium) sessions.

== Before you start

You'll need to complete the following:
You'll need a completed, convertible session:

* xref:scriptless-automation:create-a-baseline-session.adoc[Create a baseline session].
* For a manual test case, xref:scriptless-automation:create-a-baseline-session.adoc[create a baseline session].
* For an automation test case, use a completed Appium session.
* If applicable, xref:remediation/annotate-a-test-step.adoc[annotate any flagged test steps].

== Create a test case
== Convert a session from Session Explorer

In *Sessions*, xref:session-explorer:search-for-a-session.adoc[search for a session], then select a session.

Expand All @@ -28,4 +29,30 @@ When you're ready, select *Convert to Test Case*.

image:convert-to-test-case-context.png[width=1000,alt="Click Convert to Test case"]

=== Automation session eligibility

*Convert to Test Case* is available for convertible automation (Appium) sessions in addition to manual sessions. It is not available for unsupported automation types, such as XCUITest.

== Convert a session from the Test Case list

You can also start from the Test Case list:

. Select *+New Test Case*.
. In *Choose Session to Convert to Test Case*, select a manual or automation session. Sessions appear in the same order as Session Explorer, with the most recent session first.
. To narrow the list to Appium sessions, search `type:appium`.
. Select *Convert*.

== Conversion result

After conversion, a success message appears with a *View Test Case →* link.

For automation sessions, the message reflects the session's capture quality:

* With the `kobiton:scriptlessCapture` capability: "Test Case converted with kobiton:scriptlessCapture! Full data captured for optimal test case."
* Without the `kobiton:scriptlessCapture` capability: "Some session data might be limited. Add 'kobiton:scriptlessCapture' for better results next time."

To capture more complete test data, add the `kobiton:scriptlessCapture` capability to your automation session before you run it.

Manual sessions show "Test Case converted successfully."

If you'd like to make changes to your test case before running Scriptless Automation, see xref:manage-test-steps.adoc[].
Loading