From 9b22f00c2834f82d8332193f5a622af9bda60ed0 Mon Sep 17 00:00:00 2001 From: tiffany-kobiton Date: Fri, 17 Jul 2026 16:34:02 -0400 Subject: [PATCH 1/2] docs(test-management): add convert automation session page (KOB-54075) Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/modules/test-management/nav.adoc | 1 + .../pages/convert-automation-session.adoc | 46 +++++++++++++++++++ .../test-management/pages/test-cases.adoc | 2 + 3 files changed, 49 insertions(+) create mode 100644 docs/modules/test-management/pages/convert-automation-session.adoc diff --git a/docs/modules/test-management/nav.adoc b/docs/modules/test-management/nav.adoc index f6303642..df7d8ff4 100644 --- a/docs/modules/test-management/nav.adoc +++ b/docs/modules/test-management/nav.adoc @@ -1,6 +1,7 @@ .xref:index.adoc[] * xref:test-management:test-cases.adoc[] +* xref:test-management:convert-automation-session.adoc[] * xref:test-management:generate-appium.adoc[] * xref:test-management:test-runs.adoc[] * xref:test-management:test-suites.adoc[] diff --git a/docs/modules/test-management/pages/convert-automation-session.adoc b/docs/modules/test-management/pages/convert-automation-session.adoc new file mode 100644 index 00000000..6df5c3ee --- /dev/null +++ b/docs/modules/test-management/pages/convert-automation-session.adoc @@ -0,0 +1,46 @@ += Convert an automation session to a Test Case +:navtitle: Convert an automation session + +You can convert a completed automation session into a Test Case from Kobiton Portal. This lets you reuse the same test flow as a Test Case that can be run repeatedly and organized into Test Suites. + +== Before you begin + +* Your automation session is complete. Running sessions cannot be converted. +* Your automation session type is convertible. The following types are not convertible: +** Revisit Sessions +** XCUI +** UIAutomator +** Gaming +** GameDriver +** Emulator +* Recommended: set `kobiton:scriptlessCapture` in your initial script for the most complete data capture. Without it, some session data might not be captured. + +== Convert from Session Explorer + +. Open the automation session in Session Explorer. +. Select *Convert to Test Case*. + +== Convert from the Test Case List + +. In Kobiton Portal, open the Test Case List in Test Management. +. Select *+New Test Case*. +. In the pop-up, find the automation session you want to convert. To narrow the list, search for `type:appium`. +. Select the session, then select *Convert*. + +== Confirmation and data capture + +Kobiton confirms the conversion with a toast message. The wording depends on whether your automation session had `kobiton:scriptlessCapture` set. + +* With `kobiton:scriptlessCapture` set: "Test Case converted with kobiton:scriptlessCapture! Full data captured for optimal test case." +* Without `kobiton:scriptlessCapture`: "Some session data might be limited. Add 'kobiton:scriptlessCapture' for better results next time." + +After conversion, you can open the new Test Case to review the captured steps and interactions. + +// API note: The same convert operation is available via the Kobiton API. The API is documented in a separate framework and is not included in the public docs, so no API section appears here. See KOB-43478 for internal reference. + +== See also + +* xref:test-management:test-cases.adoc[Test Cases] +* xref:scriptless-automation:baseline-session.adoc[Create a baseline session] +// TODO: uncomment when the scriptlessCapture capability doc lands (tracked as KOB-41142) +// * xref:[`kobiton:scriptlessCapture` capability] diff --git a/docs/modules/test-management/pages/test-cases.adoc b/docs/modules/test-management/pages/test-cases.adoc index f32da05f..b150ea2d 100644 --- a/docs/modules/test-management/pages/test-cases.adoc +++ b/docs/modules/test-management/pages/test-cases.adoc @@ -28,6 +28,8 @@ After conversion, the option to view the Test Case becomes available. Selecting image::tm-newtcscreen.png[width=700,alt="Create a New Test Case in Test Management] +You can also convert completed automation sessions to Test Cases. For the steps, see xref:test-management:convert-automation-session.adoc[]. + == Manage Test Cases Test Cases are managed through Test Management in the Kobiton platform. From d64e734e21a79fef3b98184431d9f7b696203640 Mon Sep 17 00:00:00 2001 From: tiffany-kobiton Date: Tue, 21 Jul 2026 09:42:59 -0400 Subject: [PATCH 2/2] Remove API note from convert automation session doc Removed note about API conversion operation and internal reference. --- .../test-management/pages/convert-automation-session.adoc | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/modules/test-management/pages/convert-automation-session.adoc b/docs/modules/test-management/pages/convert-automation-session.adoc index 6df5c3ee..0ac81db7 100644 --- a/docs/modules/test-management/pages/convert-automation-session.adoc +++ b/docs/modules/test-management/pages/convert-automation-session.adoc @@ -36,8 +36,6 @@ Kobiton confirms the conversion with a toast message. The wording depends on whe After conversion, you can open the new Test Case to review the captured steps and interactions. -// API note: The same convert operation is available via the Kobiton API. The API is documented in a separate framework and is not included in the public docs, so no API section appears here. See KOB-43478 for internal reference. - == See also * xref:test-management:test-cases.adoc[Test Cases]