For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content

KaneAI - Using Parameters

This guide provides a detailed walkthrough for utilizing parameters in KaneAI to streamline test case management and execute tests with various data inputs. By leveraging data parameters, testers and developers can manage configurations effortlessly. Follow the step-by-step instructions below for successful implementation.

Key Features of Parameters in KaneAI​

  • Dynamic Data Input : Use parameters to define and input test data dynamically during test execution.
  • Multiple Configurations : Simplify the execution of tests with different data sets.
  • Seamless Test Management : Centralized management of parameters improves efficiency and reduces redundancy.

Seed Value and test case values​

The Seed Value is defined with a global parameter in KaneAI > Variables > Parameters. It prepopulates a new parameter column when that parameter is first used in a test case. The test case stores its own value in row 1 of its Default Dataset, so you can use the same parameter with different values in different test cases without changing the global Seed Value.

KaneAI Parameters list with parameter names and Seed Value column

If a Dataset cell is empty, KaneAI uses the empty value; it does not fall back to the Seed Value.

Import parameters from a CSV​

When you have many parameters to create, such as the columns of a test data sheet, import them from a CSV file instead of creating them one at a time. Each column in the file becomes one parameter.

Prepare the CSV file​

Put each parameter's name in row 1 and its Seed Value in row 2:

user_name,email,city,plan
John Doe,john.doe@example.com,Bengaluru,Pro
  • Each import takes one .csv file, up to 5 MB and 500 columns. To import an Excel sheet, save it as CSV first.
  • Only rows 1 and 2 are read. A value in row 3 or below doesn't become a Seed Value, even if row 2 of that column is empty.
  • Parameter names can contain only letters, digits, and underscores. Names that don't follow this rule aren't corrected for you, so fix them in the file before you upload it.

Import the parameters​

  1. Go to KaneAI > Variables > Parameters.

  2. Open the dropdown next to Create new and select Import CSV.

  3. Drag your file into the panel, or click Browse CSV file. To start from a template, click Download Sample CSV.

    Import Parameters from CSV panel showing the recommended CSV layout, the file upload area, and the sample file link
  4. Review the preview, which lists every column in the file and what will happen to it. You can search by name and filter by outcome. Nothing is created until you confirm, so you can still cancel, or go back and upload a corrected file.

    Preview of an uploaded CSV with three columns to import, one that already exists, and one excluded from import
  5. Click Import Parameters. The new parameters are added to the Parameters list, and a confirmation shows how many were imported.

If every column already exists or is excluded, there is nothing to import and Import Parameters stays disabled.

Imported parameters work the same way as parameters you create one at a time. To load the rest of the rows from your file as test data, see Importing Data via CSV Files.

What happens to each column​

Preview outcomeWhen it appliesResult
Will be importedThe column has a valid new name and a Seed Value.A new parameter is created.
Already exist & skippedA parameter with the same name already exists. Letter case is ignored, so AGE matches age.The column is skipped. The existing parameter and its Seed Value don't change.
Excluded from importThe column breaks one of the rules below.No parameter is created.

A column is excluded from the import if:

  • Its name is empty, or contains spaces, symbols, or accented letters. Spaces before or after the name also count.
  • Its name repeats an earlier column in the file. Letter case is ignored, and the first column is the one imported.
  • Row 2 of the column is empty.
  • Its value in row 2 is longer than 255 characters.

To include an excluded column, fix it in the CSV and upload the file again.

Import an updated file​

Each import is a one-time copy of the file, so later changes to the CSV don't update your parameters. When your sheet gains new columns, upload it again: columns you already imported are skipped, and only the new ones are created. To change the Seed Value of an existing parameter, edit it in the Parameters list.

Keep sensitive values out of the file​

Parameters are visible to everyone in your organization, and the import doesn't flag columns that look sensitive. Remove passwords, tokens, and similar values from the CSV, and store them as Secrets instead.

Define Parameters in a Web or App Agent Test​

  • Navigate to the specific web agent test URL and configure the test to accept input parameters.
KaneAI Web Agent authoring session with a test form containing Name, Age, and Phone Number fields

Create a parameter in a test​

  1. Type / in the authoring input.
  2. Select Create Parameter to open the pop-up.
  3. Enter the parameter's Name and Seed value.
  4. Click Create Parameter to save.
Create Parameter dialog with the name phonenumber and seed value 123456789

Reference the parameter in test step​

Reference any parameter using dollar-curly braces syntax (e.g.,${phonenumber}). Enter the name in its designated input field.

The phonenumber parameter has a dashed border, with a message that it will use its seed value and an Edit option

Set or change the value while authoring​

When you use a parameter for the first time in an authoring session, KaneAI uses the Seed Value you defined when creating the parameter.

  • Dashed border: The parameter appears with a dashed border while it is using the Seed Value and you have not explicitly set a value for this test case.
  • Edit the value: Click the parameter or the Edit option beside the Seed Value message to enter a different value for this test case.

You can also change the value in an existing step:

  1. Pause the authoring session.
  2. Click the parameter in the step to open the Parameter Value dialog.
  3. Enter New value for this test case and click Save.

Saving a new value replaces row 1 for that parameter in the test case's Default Dataset. It does not change the global Seed Value or another test case's value.

Parameter Value dialog setting phonenumber to 9876543210 for this test case, with Seed, Cancel, and Save controls

To run the same test case with further values, add rows to a Dataset and select it for the run. See Using Datasets.

From a Manual Interaction step​

Availability

Converting selected text in a Manual Interaction step into a Parameter is supported only in Classic Experience. This feature is not available in New Experience.

You can also convert a hard-coded value in a Manual Interaction step into a Parameter directly, without deleting or re-recording the step. This flow is available on both Desktop and Mobile App sessions, and works while the session is Paused, where step editing is available.

  1. Open the recorded Manual Interaction step.
  2. Select the portion of the instruction text you want to parameterize (for example, highlight test.com).
Image
  1. In the Convert as popover that appears, switch to the {$} Parameter tab.
  2. Either pick an existing parameter from the searchable list, or click + Create Parameter to define a new one inline.
  3. The selected text in the step is replaced with the parameter reference (for example, {{search_query}}). The parameterized step is now ready for data-driven execution.
note

This flow is only supported for Click and Type commands. For the full Convert as popover behavior across Parameters, Variables, and Secrets, see Creating variables from a Manual Interaction step.

Test Summary Page​

Upon completing the test, review the Test Summary Page, where all utilized parameters are clearly displayed, and the corresponding generated code is readily available for seamless integration into future test scenarios.

Image

Using parameters for test runs​

Step 1: Navigate to Test Project​

Open the Test Project dashboard and go to the Test Run section.

Image

Step 2: Create a New Test Run​

  • Click Create New Test Run and name it (e.g., parameters test run).
  • Select the KaneAI-generated test cases.
  • Optionally, add a description or relevant tags.
  • Click Create Test Run.
Image

Step 3: Add Test Cases and Data Sets​

  • Select and add the desired test cases to the run.
  • Specify configurations (e.g., Windows 10 Chrome).
  • Attach the required data sets for the test run.
Image

Step 4: Apply Data Sets​

  • Ensure the data sets containing necessary parameters are pre-filtered and accessible.
  • Click Apply to confirm the Dataset selection.
Image

Step 5: Save and Prepare for Execution​

  • Save the test run with the selected parameters and Datasets. The system will create test instances ready for execution in a hybrid environment.
Image

Step 6: Execute Tests with Parameters​

Utilize the parameters to run your test cases with different data sets and inputs. You can manage and monitor execution using the TestMu AI Test Manager interface.

Image

Video Explanation​

Terminal First Testing With Kane CLI

Natural language browser & mobile app tests right from terminal.

×
Schedule Your Personal Demo
Kane CLI terminal

Help and Support

Related Articles