Newman AIO Tests Reporter

AIO Tests has introduced a custom reporter for Newman. The newman-reporter-aiotests simplifies reporting results from Newman with an easy setup.

For details on field mapping and case mappings, please refer to Postman via Newman Report.

In this documentation, you’ll understand:

1 Install
2 Usage
3 CLI Options
- 3.1 With Newman CLI
- 3.2 With Newman as a Library

Install

The reporter works as a plugin with Newman so ensure that you have already installed that package globally, using npm install -g newman.

To globally install the aiotests package:

npm install -g newman-reporter-aiotests

To use aiotests as a library, install the package as a dependency into a nodejs project's package.json file using:

npm install -S newman-reporter-aiotests

Usage

In order to enable this reporter, specify aiotests in Newman's -r or --reporters option. The following command would run the reporter:

newman run collection.json -r aiotests 
--reporter-aiotests-jiraProjectId=AUT --reporter-aiotests-aioApiToken=<yourAPIToken>

CLI Options

With Newman CLI

CLI Option	Description	Example

CLI Option	Description	Example
`--reporter-aiotests-enableReporting`	To enable or disable reporter for a particular run. Defaults to true.	`newman run collection.json -r aiotests --reporter-aiotests-enableReporting=false`
`--reporter-aiotests-enableReporting`	To enable or disable reporter for a particular run. Defaults to true.	`newman run collection.json -r aiotests --reporter-aiotests-enableReporting=false`
`--reporter-aiotests-jiraProjectId`	Jira Project key - the Jira project to which the results need to be reported	`newman run collection.json -r aiotests --reporter-aiotests-jiraProjectId=AUT`
`--reporter-aiotests-aioApiToken`	Only for Jira Cloud API Token generated from AIO Tests.	`newman run collection.json -r aiotests --reporter-aiotests-apiToken=<yourapitoken>`
`--reporter-aiotests-jiraServer`	Only for Jira Server/DC Hosted Jira Server URL	`newman run collection.json -r aiotests --reporter-aiotests-jiraServer=https://myhostat.myco.com`
`--reporter-aiotests-jiraPat`	Only for Jira Server/DC Personal Access Token generated from Jira Server	`newman run collection.json -r aiotests --reporter-aiotests-jiraServer=https://myhostat.myco.com --reporter-aiotests-jiraPAT=<yourPAT>`
`--reporter-aiotests-createNewCycle`	Set to true to create new cycle for run.	`newman run collection.json -r aiotests --reporter-aiotests-createNewCycle=true`
`--reporter-aiotests-cycleKey`	If createNewCycle is false, then the cycleKey identifies the existing AIO Tests Cycle to be updated	`newman run collection.json -r aiotests --reporter-aiotests-cycleKey=AUT-CY-23`
`--reporter-aiotests-newCycleTitle`	If createNewCycle is true, the newCycleTitle specifies the name of the cycle to create	`newman run collection.json -r aiotests --reporter-aiotests-newCycleTitle="API Smoke Run 24Nov"`
`--reporter-aiotests-createNewRun`	Defaults to false. Set to true to create a new run for each execution.	`newman run collection.json -r aiotests --reporter-aiotests-createNewRun=false`
`--reporter-aiotests-createCase`	Defaults to true. Set to false, if cases without case Key mapping should be reported as failures.	`newman run collection.json -r aiotests --reporter-aiotests-createCase=false`
`--reporter-aiotests-bddForceUpdateCase`	Defaults to true. Set to true to override data from report to overwrite the manual case in AIO Tests. Set to false, if case should not be updated. e.g If a new assertion is added in Postman, if bddForceUpdateCase is true, it would be added as a new step, else it would be reported as failure.	`newman run collection.json -r aiotests --reporter-aiotests-bddForceUpdateCase=false`

With Newman as a Library

All the CLI functionality is available for programmatic use within a nodejs script.

Install the required node modules using npm i -S newman newman-reporter-aiotests

For further queries and suggestions, feel free to reach out to our customer support via help@aiotests.com.