3.5.  Uploading Results

Table of Contents

3.5.1. Manual Upload via the Squish Test Center UI
3.5.2. Upload via the command line
3.5.3. Upload attachments via the command line
3.5.4. Interactive Upload from Squish IDE
3.5.5. Upload using the Jenkins Plugin

There are many ways to upload results to Squish Test Center, which are detailed in the sections below. For more details on how to pick Batch names and Labels see How to Group Results (Section 3.6)

3.5.1.  Manual Upload via the Squish Test Center UI

To upload your results manually using the Squish Test Center UI, you will first need to be logged into a user account with upload privileges. Next, hover over the User icon and name in the top right corner, and from the dropdown, choose Result Upload. You should see a page like the one below:

Uploading Results

From here, you can choose which project to add results to, enter a name for the Batch, and select a .zip or .xml file to upload. Optionally, you can upload arbitrary files as attachments to these results.

Finally, use the bottom box to select or add labels to the result, so that the results can be more easily selected from Reports and Tests.

3.5.2.  Upload via the command line

There are 2 ways to upload results to Squish Test Center by command line.

Option 1: From testcentercmd on the command line

For those users looking to upload their results by using the command line, the executable testcentercmd shipped with Squish Test Center is needed.

When invoking testcentercmd, the following are required:

  • an upload token (Creating and Managing Upload Token (Section 3.7.1)) or email and password of a Squish Test Center user with upload privileges

  • project name that identifies tests of the same software, project or module

  • path to the test result file or the result directory

The following are optional:

  • URL of the server instance, the default being http://localhost:8800.

  • One or more labels to filter the test results of the same project, the default being none.

  • Name of batch instead of a generated name

Example usage:

$ testcentercmd --url=http://localhost:8800 --token=MyToken upload Myproject
/path/to/results.zip --label=version=1.0.0 --label=OS=Linux --batch=MyBatch

While it is recommended to use an upload token (Creating and Managing Upload Token (Section 3.7.1)), it is also possible to authenticate with email and password using the command arguments --user=user@company.com and --password=password (Note that if the password argument is omitted, you will be prompted for your account password upon entering this command).

To see the full list of options to testcentercmd, issue testcentercmd --help in a prompt.

[Note]Note

You can also use the testcentercmd commandline tool to perform traceability actions (like pushing or pulling data from or to the external system) for integrations you have set up on Squish Test Center.

Option 2: Upload a report from squishrunner

Uploading test results of a squishrunner test suite execution is a two-step process. First, use the testcenter report generator for squishrunner.

squishrunner --reportgen testcenter,http://localhost:8800/project/Myproject?token=MyToken&label=version%3D1.0.0&label=OS%3Dlinux&batch=MyBatch

You must also specify either --local or a running squishserver instance as well as a testsuite to be run via --testsuite.

The label and batch are optional. See Creating and Managing Upload Token (Section 3.7.1) on how to create a token. Note that for labels, the equal sign (=) for the label value in the URL must be escaped and becomes %3D.

After squishrunner is finished, you should see the IMPORT_ID. With that, you can later add labels and/or add attachments to the report.

[Note]Note

Currently on linux the number of parallel connections to Squish Test Center is limited to 300. Keep this limit in mind when you run many tests in parallel, and plan on using the reportgen upload.

3.5.3.  Upload attachments via the command line

Once you have obtained an IMPORT_ID either from the result upload or from the Explore View (Section 3.2) you can use this ID to upload additional attachments.

testcentercmd --user=johndoe@mycompany.com add IMPORT_ID --attachment=MyFile1 --attachment=MyFile2

3.5.4.  Interactive Upload from Squish IDE

Within Squish IDE, navigate to the topmost menu bar, and choose Window - Show View - Other. In the filter text field, search for Squish Test Center, then click Open.

Clicking on the blue settings dial button in the top right corner of the Squish Test Center View will open the server dialog, where you can specify your Squish Test Center instance.

IDE Integration

Once a Test Center Instance is setup within the IDE the actual result upload can be found in the top right corner of the Test Result View.

IDE Integration Upload

Next, you will need to configure an instance of the server. Click on the Configure Squish Test Centers icon, click to Add Squish Test Center, and in the dialog presented, enter the server URL, email and password, and click OK.

3.5.5.  Upload using the Jenkins Plugin

How to configure the Jenkins Plugin to upload to Squish Test Center is part of the Plugin documentation: Jenkins Plugin Documentation