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
4 changes: 2 additions & 2 deletions docs/antora.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@ nav:
- modules/apps/nav.adoc
- modules/manual-testing/nav.adoc
- modules/automation-testing/nav.adoc
- modules/scriptless-automation/nav.adoc
- modules/_scriptless-automation/nav.adoc
- modules/debugging/nav.adoc
- modules/kobiton-cli/nav.adoc
- modules/session-explorer/nav.adoc
- modules/profile/nav.adoc
- modules/organization/nav.adoc
- modules/test-management/nav.adoc
- modules/_test-management/nav.adoc
- modules/reporting/nav.adoc
- modules/device-lab-management/nav.adoc
- modules/supported-platforms/nav.adoc
Expand Down
13 changes: 13 additions & 0 deletions docs/modules/_scriptless-automation/_nav.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
.xref:index.adoc[]

* xref:_scriptless-automation:create-a-baseline-session.adoc[]

* Get a session ID
** xref:_get-a-session-id/using-the-kobiton-portal.adoc[]
** xref:_get-a-session-id/using-the-kobiton-api.adoc[]

* xref:run-scriptless-with-the-kobiton-portal.adoc[]
* xref:run-scriptless-with-the-kobiton-api.adoc[]
* xref:automation-testing:scripting/auto-generate-an-appium-script.adoc[]
* xref:scriptless-best-practices.adoc[]
* xref:scriptless-requirements.adoc[]
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ image:manual-testing:install-apps-context.png[width=1000,alt="Install Apps"]
[IMPORTANT]

====
Make sure your app aligns with the Scriptless xref:scriptless-automation:scriptless-requirements.adoc#_application_requirements[application requirements] before proceeding.
Make sure your app aligns with the Scriptless xref:_scriptless-automation:scriptless-requirements.adoc#_application_requirements[application requirements] before proceeding.
====

You can upload a xref:apps:supported-filetypes.adoc[supported filetype] from your computer, install an app from a URL, or choose an app from xref:apps:manage-apps.adoc[your app repository].
Expand All @@ -35,7 +35,7 @@ include::scriptless-requirements.adoc[tag=supported-actions]

== Follow scriptless best practices

For best results, follow the xref:scriptless-automation:scriptless-best-practices.adoc[] while running your tests.
For best results, follow the xref:_scriptless-automation:scriptless-best-practices.adoc[] while running your tests.

== Exit your session

Expand Down
10 changes: 10 additions & 0 deletions docs/modules/_scriptless-automation/_pages/_index.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
= Scriptless Automation
:navtitle: Scriptless Automation

Automate your tests without writing scripts.

image:automation-testing:automation-testing-index-context.png[width=1000,alt="A context to Scriptless Automation"]

== In this section

include::../nav.adoc[lines=2..]
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Learn how to run Scriptless Automation using the Kobiton portal.
You'll need to complete the following:

* xref:create-a-baseline-session.adoc[Create a baseline session].
* xref:test-management:create-a-test-case.adoc[] using your baseline session.
* xref:_test-management:create-a-test-case.adoc[] using your baseline session.

== Open Scriptless Automation

Expand All @@ -21,30 +21,30 @@ For more information, see xref:session-explorer:session-metadata.adoc[].

Select *Automated Test Case*.

image:scriptless-automation:scriptless-automated-test-case-button.png[width=1000,alt="The session overview page with the Automated Test Case button"]
image:_scriptless-automation:scriptless-automated-test-case-button.png[width=1000,alt="The session overview page with the Automated Test Case button"]

Select *Rerun*.

image:scriptless-automation:scriptless-rerun-button.png[width=1000,alt="Select Rerun in the Automated Test Case screen"]
image:_scriptless-automation:scriptless-rerun-button.png[width=1000,alt="Select Rerun in the Automated Test Case screen"]

[TIP]
For best results, select Rerun when the message _Congratulations! Your test case is good to go now_ appears on screen. If a different message is showing, you may need to xref:test-management:remediation/annotate-a-test-step.adoc[annotate the test steps].
For best results, select Rerun when the message _Congratulations! Your test case is good to go now_ appears on screen. If a different message is showing, you may need to xref:_test-management:remediation/annotate-a-test-step.adoc[annotate the test steps].

== Configure your scriptless session

=== Device Bundles

In the *Rerun Configurations* window, select *Device Bundles*.

image:scriptless-automation:scriptless-rerun-configurations-device-bundles-context.png[width=600,alt="The select device bundles dropdown list"]
image:_scriptless-automation:scriptless-rerun-configurations-device-bundles-context.png[width=600,alt="The select device bundles dropdown list"]

Select the dropdown and choose a bundle.

image:scriptless-automation:scriptless-select-device-bundles.png[width=600,alt="The select device bundles dropdown list"]
image:_scriptless-automation:scriptless-select-device-bundles.png[width=600,alt="The select device bundles dropdown list"]

If you'd like to remove any devices for this session, de-select the checkbox next to each device.

image:scriptless-automation:scriptless-deselect-device-from-bundles.png[width=1000,alt="A device is de-selected from the device bundles"]
image:_scriptless-automation:scriptless-deselect-device-from-bundles.png[width=1000,alt="A device is de-selected from the device bundles"]

[NOTE]
If you'd like to make more changes to this bundle, select *Configure Bundle*. For more information, see xref:organization:device-bundles/manage-device-bundles.adoc[].
Expand All @@ -53,30 +53,30 @@ If you'd like to make more changes to this bundle, select *Configure Bundle*. Fo

Data-driven testing allows you to define custom data sets and replace values from your baseline session. In the *Rerun Configurations* window, select *Data Driven Testing*.

image:scriptless-automation:rerun-configurations-data-driven-testing-context.png[width=1000,alt="The Data Driven Testing section under Rerun Configurations"]
image:_scriptless-automation:rerun-configurations-data-driven-testing-context.png[width=1000,alt="The Data Driven Testing section under Rerun Configurations"]

Select the *+* button to add new test data.

image:scriptless-automation:data-driven-new-dataset.png[width=1000,alt="Select the plus icon to add new test data"]
image:_scriptless-automation:data-driven-new-dataset.png[width=1000,alt="Select the plus icon to add new test data"]

The new test data is only applied to a specific device in the bundle. Choose the device to apply by selecting it from the *Assign Device* dropdown.

image:scriptless-automation:data-driven-assign-device.png[width=500,alt="The Assign Device dropdown"]
image:_scriptless-automation:data-driven-assign-device.png[width=500,alt="The Assign Device dropdown"]

To replace a value used for a specific test step, select the test step with a value input action, then enter a new value.

image:scriptless-automation:data-driven-replace-value.png[width=500,alt="Replacing a value in a test step"]
image:_scriptless-automation:data-driven-replace-value.png[width=500,alt="Replacing a value in a test step"]

Once a value has been modified, it will be marked as *Edited*.

image:scriptless-automation:data-driven-test-step-edited.png[width=500,alt="The value is marked as edited"]
image:_scriptless-automation:data-driven-test-step-edited.png[width=500,alt="The value is marked as edited"]

== Run Scriptless Automation

When you're finished configuring your scriptless session, select *Rerun*.

image:scriptless-automation:rerun-configurations-data-driven-testing-context.png[width=1000,alt="Select Rerun after finishing the configurations"]
image:_scriptless-automation:rerun-configurations-data-driven-testing-context.png[width=1000,alt="Select Rerun after finishing the configurations"]

You'll be redirected to your test run where you can view live updates for your run.

image:scriptless-automation:test-run-view.png[width=1000,alt="The test run view"]
image:_scriptless-automation:test-run-view.png[width=1000,alt="The test run view"]
Original file line number Diff line number Diff line change
Expand Up @@ -103,15 +103,15 @@ _Only English is supported, excluding the emoji keyboard._

If an unsupported action is performed, the Scriptless Automation stops capturing, and subsequent steps after the unsupported action are not captured and executable in rerun/revisit or in the auto-generated scripts.

image:scriptless-automation:scriptless-unsupported-action.png[width=1000,alt="An unsupported action performed in a manual session"]
image:_scriptless-automation:scriptless-unsupported-action.png[width=1000,alt="An unsupported action performed in a manual session"]

In the Session Explorer, the unsupported actions are highlighted in red:

image:scriptless-automation:unsupported-action-session-explorer.png[width=1000,alt="An unsupported action displayed in Session Explorer"]
image:_scriptless-automation:unsupported-action-session-explorer.png[width=1000,alt="An unsupported action displayed in Session Explorer"]

In the Automated Test Case, only test steps before the unsupported action are included:

image:scriptless-automation:unsupported-action-automated-test-case.png[width=1000,alt="An unsupported action displayed in Automated Test Case"]
image:_scriptless-automation:unsupported-action-automated-test-case.png[width=1000,alt="An unsupported action displayed in Automated Test Case"]

// end::supported-actions[]

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 9 additions & 0 deletions docs/modules/_test-management/nav.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.xref:index.adoc[]
* xref:_test-management:create-a-test-case.adoc[]
* xref:_test-management:manage-test-steps.adoc[]

* xref:_test-management:remediation/index.adoc[]
** xref:_test-management:remediation/annotate-a-test-step.adoc[]
** xref:_test-management:remediation/crash-remediation.adoc[]
** xref:_test-management:remediation/element-selection-remediation.adoc[]
** xref:_test-management:remediation/ignore-remediation.adoc[]
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
= 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].
Learn how to create a test case so you can run xref:_scriptless-automation:index.adoc[Scriptless Automation].

== Before you start

You'll need to complete the following:

* xref:scriptless-automation:create-a-baseline-session.adoc[Create a baseline session].
* xref:_scriptless-automation:create-a-baseline-session.adoc[Create a baseline session].
* If applicable, xref:remediation/annotate-a-test-step.adoc[annotate any flagged test steps].

== Create a test case
Expand Down
15 changes: 15 additions & 0 deletions docs/modules/_test-management/pages/index.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
= Test management
:navtitle: Test management
:page-aliases: test-management:validation:index.adoc, test-management:validation:color-text-validation.adoc, test-management:validation:performance-validation.adoc, test-management:validation:text-validation.adoc

NOTE: Text color validation, performance validation, and text validation are no longer supported.

Manage test cases for you or your team.

image:_test-management:test-case-management-context.png[width=1000, alt="The test management context"]

== In this section

include::../nav.adoc[lines=2..]


Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Learn how to manage the test steps, so you can improve your test case before run

== Before you start

You'll need to xref:test-management:create-a-test-case.adoc[create a test case] from a baseline session.
You'll need to xref:_test-management:create-a-test-case.adoc[create a test case] from a baseline session.

== Open a test case

Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
= Annotate a test step for Scriptless Automation
:navtitle: Annotate a test step

Learn how to annotate a test step from your xref:scriptless-automation:create-a-baseline-session.adoc[baseline session], so you can...
Learn how to annotate a test step from your xref:_scriptless-automation:create-a-baseline-session.adoc[baseline session], so you can...

== Before you start

You'll need to xref:scriptless-automation:create-a-baseline-session.adoc[create a baseline session].
You'll need to xref:_scriptless-automation:create-a-baseline-session.adoc[create a baseline session].

== Annotate a test step

Expand Down Expand Up @@ -33,5 +33,5 @@ image:test-case-ready-to-go-context.png[width=1000,alt="Test cases are ready to

These are the different options for annotating a test step:

** xref:test-management:remediation/crash-remediation.adoc[]
** xref:test-management:remediation/element-selection-remediation.adoc[]
** xref:_test-management:remediation/crash-remediation.adoc[]
** xref:_test-management:remediation/element-selection-remediation.adoc[]
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@

The User Interface (UI) of an element often changes across multiple devices. This can interrupt revisits on different devices because it's challenging to manage the appearance of an element through various device ratios, like 18:9, 17:9, and 16:9. But, with Scriptless Automation, you can easily handle these challenges through the UI without any scripting.

image:scriptless-automation:ui-remediation-window.png[width=700,alt="UI Remediation window"]
image:_scriptless-automation:ui-remediation-window.png[width=700,alt="UI Remediation window"]

When revisiting on a Galaxy J5, a blocker is raised because a UI change covers and makes the **Login** button un-clickable. You can resolve this by manually selecting the **Login** button in the Scriptless Automation Remediation. This selection becomes the new 'baseline' for the test case, ensuring smooth execution.

image:scriptless-automation:ui-remediation2.png[width=700,alt="Another view of UI Remediation window"]
image:_scriptless-automation:ui-remediation2.png[width=700,alt="Another view of UI Remediation window"]

In situations where different screen ratios crop a list view cell, making it undetectable, this would typically result in a failed test case with other “Record & Playback” technologies. However, with Scriptless Automation, you can select the correct list view cell and submit the remediation to continue the test.
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

If you come across a non-annotated remediation and are certain it's an application issue that needs fixing for the next release, you can use the *Ignore* option. This will exclude the execution from the Scriptless Automation process, so you won't face the remediation again.

image:test-management:remediation-ignore-action.png[width=500,alt="The Ignore option under Blocker remediation's available actions"]
image:_test-management:remediation-ignore-action.png[width=500,alt="The Ignore option under Blocker remediation's available actions"]

[width="100%",cols="15%,85%",options="header"]
|===
Expand Down
11 changes: 11 additions & 0 deletions docs/modules/_test-management/pages/remediation/index.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
= Remediation
:navtitle: Remediation

Remediate your test cases before running Scriptless Automation.

== In this section

* xref:_test-management:remediation/annotate-a-test-step.adoc[]
* xref:_test-management:remediation/crash-remediation.adoc[]
* xref:_test-management:remediation/element-selection-remediation.adoc[]
* xref:_test-management:remediation/ignore-remediation.adoc[]
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Learn how to generate an Appium script from a manual session, so you can start b

== Before you start

* xref:scriptless-automation:create-a-baseline-session.adoc[]
* xref:_scriptless-automation:create-a-baseline-session.adoc[]

[#_export_your_script]
== Export your script
Expand All @@ -14,7 +14,7 @@ After creating the baseline session, search for your session, open the session o

image:automation-testing:export-appium-script-context.png[width=1200, alt="The automated test case for the selected session."]

Next, select the *Export Appium Script* icon. If you don't see an icon, check if your session xref:test-management:remediation/index.adoc[requires remediation].
Next, select the *Export Appium Script* icon. If you don't see an icon, check if your session xref:_test-management:remediation/index.adoc[requires remediation].

image:automation-testing:export-appium-script-closeup.png[width=750, alt="Session overview tabs, including Automated Test Case, Jira Integration, Rerun, and the Appium Export icon."]

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
= Create a device bundle
:navtitle: Create a device bundle

Learn how to create a new device bundle so users in your organization can run xref:scriptless-automation:index.adoc[Scriptless Automation] on devices in parallel.
Learn how to create a new device bundle so users in your organization can run xref:_scriptless-automation:index.adoc[Scriptless Automation] on devices in parallel.

[NOTE]
Device bundles are operating system (OS) specific so Android and iOS devices cannot be bundled together.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
= Manage device bundles
:navtitle: Manage device bundles

Learn how to manage the device bundles in your organization so users can use them to run xref:scriptless-automation:index.adoc[Scriptless Automation] on devices in parallel. You can only manage device bundles xref:device-bundles/create-a-device-bundle.adoc[you or your team created].
Learn how to manage the device bundles in your organization so users can use them to run xref:_scriptless-automation:index.adoc[Scriptless Automation] on devices in parallel. You can only manage device bundles xref:device-bundles/create-a-device-bundle.adoc[you or your team created].

== View a device bundle

Expand Down
10 changes: 5 additions & 5 deletions docs/modules/reporting/pages/usage-report/report-metadata.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -44,23 +44,23 @@ xref:manual-testing:start-a-mixed-session.adoc[Mixed test sessions].

=== Scriptless on Manual

xref:scriptless-automation:index.adoc[Scriptless test sessions] that use a manual test session as the base.
xref:_scriptless-automation:index.adoc[Scriptless test sessions] that use a manual test session as the base.

=== Scriptless on Automation

xref:scriptless-automation:index.adoc[Scriptless test sessions] that use an automation test session as the base.
xref:_scriptless-automation:index.adoc[Scriptless test sessions] that use an automation test session as the base.

=== Test Case

xref:test-management:index.adoc[Test cases].
xref:_test-management:index.adoc[Test cases].

=== Text Validation

xref:test-management:validation/text-validation.adoc[Text validation] within a Scriptless session.
xref:_test-management:validation/text-validation.adoc[Text validation] within a Scriptless session.

=== Color Validation

xref:test-management:validation/color-text-validation.adoc[Color text validation] within a Scriptless session.
xref:_test-management:validation/color-text-validation.adoc[Color text validation] within a Scriptless session.

=== Font Size (WBI)

Expand Down
15 changes: 4 additions & 11 deletions docs/modules/scriptless-automation/nav.adoc
Original file line number Diff line number Diff line change
@@ -1,13 +1,6 @@
.xref:index.adoc[]

* xref:scriptless-automation:create-a-baseline-session.adoc[]

* Get a session ID
** xref:get-a-session-id/using-the-kobiton-portal.adoc[]
** xref:get-a-session-id/using-the-kobiton-api.adoc[]

* xref:run-scriptless-with-the-kobiton-portal.adoc[]
* xref:run-scriptless-with-the-kobiton-api.adoc[]
* xref:automation-testing:scripting/auto-generate-an-appium-script.adoc[]
* xref:scriptless-best-practices.adoc[]
* xref:scriptless-requirements.adoc[]
* xref:scriptless-automation:baseline-session.adoc[]
* xref:scriptless-automation:run-scriptless.adoc[]
* xref:scriptless-automation:run-scriptless-api.adoc[]
* xref:scriptless-automation:best-practices.adoc[]
Loading
Loading