Running Pairwise
-
Open the folder containing
Pairwise
. -
Double click Pairwise jar to run Pairwise UI.
Figure 1. User Interface -
Provide configuration file with data to Pairwise, use the most efficient way for you to do it:
-
drag and drop file into Pairwise area,
Figure 2. Provide input file using drag and drop feature. -
choose file with file explorer […],
Figure 3. Provide input file using file explorer. -
Provide file path into text field.
Figure 4. Provide input file path into text field.
-
-
Choose folder for output file if you want to save it in different location than input file
-
Provide path into text field or choose folder from file explorer:
Figure 5. Provide output file using file explorer.
-
-
Choose custom name for result CSV file
-
Provide custom name into test field.
Figure 6. Provide custom filename.
-
-
Provide additional setup if needed.
-
You may use custom charset, delimiter and additional output file.
Figure 7. Set custom preferences.
-
-
Generate test suite.
-
Hit
Generate
button or use hotkeys.Figure 8. Generate button.Figure 9. Hotkeys.
-
-
Check your results!.
-
Check your result file in output folder or directly with link provided by Pairwise.
Figure 10. Output file link.
-
-
Check other UI additional features.
Running Pairwise with terminal
Runtime Parameters
There are several parameters which can be passed into AnkrPt Pairwise to control how test generation works. They are:
Parameter | Required | Example | Description |
---|---|---|---|
source |
yes |
pairwise/abc.csv |
source file for the pairwise criteria |
output |
no |
see below |
output path or file for the test data to be generated to |
delimiter |
no |
-delimiter=";" |
overrides the csv delimiter if your default doesn’t work |
charset |
no |
-charset="UTF-8" |
overrides the csv delimiter if your default isn’t sufficient |
additionalOutput |
no |
-additionalOutput="json" |
generates additional output file, available formats are json and xml. |
Using Pairwise
to generate XML files if criteria names don’t meet XML specification requirements may be ineffective and end with getting an XML file that is not parsing (criteria names are converted to XML tags).
XML file still will be generated but will need fixes on the user side.
Output
The optional output parameter can define a relative or absolute file or folder. This is how:
-
If output is not included, the output file has "-output" appended to its name before the extension
-
The system determines relative versus absolute (C: is absolute for Windows, for example)
-
If it has an extension (meaning .csv or similar), it is a file and is written directly to that file. If the file already exists, it will be overwritten.
-
If it is not a file, it is a folder.
-
If it is a relative folder, the relative portion is based on your source file, not the executable path.
-
Tests are written with the same filename as the source filename.
-
-
If the output file already exists, the new filename includes " (copy 999)" before the extension
Outputing a relative folder keeps generated tests together and your source folder clean. |
Refer to: running examples.
Custom Delimiters and charset
Using custom DELIMITERS and various CHARSET for CSV
files:
-
running Pairwise from terminal with option -delimiter="[delimiter]" (i.e. -delimiter="|") following parameters allows to execute input
CSV
file with custom delimiter. -
running Pairwise from terminal with -charset="[charset]" (i.e. -charset="UTF-8") following parameters allows to execute with allowed charset[i.e. UTF-8 or ISO-8859-1].
-
Fill proper fields (Charset/Delimiter) in Pairwise UI
There are some challenges while working with CSV
files that are not created with your locale settings.
It may be needed to use combination of delimiter & charset setup to run Pairwise
correctly.