SpiraPlan: REST Web Service (v5.0)

See all operations

POST: projects/{project_id}/test-runs/record

Description

Records the results of executing an automated test

You need to use this overload when you want to be able to set Test Run custom properties

How to Execute

To access this REST web service, you need to use the following URL (make sure to replace any parameters (eg {project_id}) with the relevant value (eg 1):

https://api.inflectra.com/Spira/Services/v5_0/RestService.svc/projects/{project_id}/test-runs/record

Request Parameters

Name Description
project_id The id of the current project

Request Body

Property Description
TestRunFormatId The format of the automation results (1=Plain Text, 2=HTML) stored in the 'RunnerStackTrace' field - required
RunnerName The name of the external automated tool that executed the test - required
RunnerTestName The name of the test case as it is known in the external tool - required
RunnerAssertCount The number of assertions/errors reported during the automated test execution
RunnerMessage The summary result of the test case - required
RunnerStackTrace The detailed trace of test results reported back from the automated testing tool - required
AutomationHostId The id of the automation host that the result is being recorded for
AutomationEngineId The id of the automation engine that the result is being recorded for
AutomationEngineToken The token of the automation engine that the result is being recorded for (read-only)
AutomationAttachmentId The id of the attachment that is being used to store the test script (file or url)
Parameters The list of test case parameters that have been provided
ScheduledDate The datetime the test was scheduled for
TestRunSteps The list of test steps that comprise the automated test These are optional for automated test runs. The status of the test run steps does not change the overall status of the automated test run. They are used to simply make reporting clearer inside the system. They will also update the status of appropriate Test Step(s) if a valid test step id is provided.
TestRunId The id of the test run
Name The name of the test run (usually the same as the test case)
TestCaseId The id of the test case that the test run is an instance of
TestRunTypeId The id of the type of test run (automated vs. manual)
TesterId The id of the user that executed the test The authenticated user is used if no value is provided
ExecutionStatusId The id of overall execution status for the test run Failed = 1; Passed = 2; NotRun = 3; NotApplicable = 4; Blocked = 5; Caution = 6;
ReleaseId The id of the release that the test run should be reported against
TestSetId The id of the test set that the test run should be reported against
TestSetTestCaseId The id of the unique test case entry in the test set
StartDate The date/time that the test execution was started
EndDate The date/time that the test execution was completed
BuildId The id of the build that the test was executed against
EstimatedDuration The estimated duration of how long the test should take to execute (read-only) This field is populated from the test case being executed
ActualDuration The actual duration of how long the test should take to execute (read-only) This field is calculated from the start/end dates provided during execution
ProjectId The id of the project that the artifact belongs to The current project is always used for Insert operations for security reasons
ConcurrencyDate The datetime used to track optimistic concurrency to prevent edit conflicts
CustomProperties The list of associated custom properties/fields for this artifact

Return Data

The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.

Property Description
TestRunFormatId The format of the automation results (1=Plain Text, 2=HTML) stored in the 'RunnerStackTrace' field - required
RunnerName The name of the external automated tool that executed the test - required
RunnerTestName The name of the test case as it is known in the external tool - required
RunnerAssertCount The number of assertions/errors reported during the automated test execution
RunnerMessage The summary result of the test case - required
RunnerStackTrace The detailed trace of test results reported back from the automated testing tool - required
AutomationHostId The id of the automation host that the result is being recorded for
AutomationEngineId The id of the automation engine that the result is being recorded for
AutomationEngineToken The token of the automation engine that the result is being recorded for (read-only)
AutomationAttachmentId The id of the attachment that is being used to store the test script (file or url)
Parameters The list of test case parameters that have been provided
ScheduledDate The datetime the test was scheduled for
TestRunSteps The list of test steps that comprise the automated test These are optional for automated test runs. The status of the test run steps does not change the overall status of the automated test run. They are used to simply make reporting clearer inside the system. They will also update the status of appropriate Test Step(s) if a valid test step id is provided.
TestRunId The id of the test run
Name The name of the test run (usually the same as the test case)
TestCaseId The id of the test case that the test run is an instance of
TestRunTypeId The id of the type of test run (automated vs. manual)
TesterId The id of the user that executed the test The authenticated user is used if no value is provided
ExecutionStatusId The id of overall execution status for the test run Failed = 1; Passed = 2; NotRun = 3; NotApplicable = 4; Blocked = 5; Caution = 6;
ReleaseId The id of the release that the test run should be reported against
TestSetId The id of the test set that the test run should be reported against
TestSetTestCaseId The id of the unique test case entry in the test set
StartDate The date/time that the test execution was started
EndDate The date/time that the test execution was completed
BuildId The id of the build that the test was executed against
EstimatedDuration The estimated duration of how long the test should take to execute (read-only) This field is populated from the test case being executed
ActualDuration The actual duration of how long the test should take to execute (read-only) This field is calculated from the start/end dates provided during execution
ProjectId The id of the project that the artifact belongs to The current project is always used for Insert operations for security reasons
ArtifactTypeId The type of artifact that we have
ConcurrencyDate The datetime used to track optimistic concurrency to prevent edit conflicts
CustomProperties The list of associated custom properties/fields for this artifact
IsAttachments Does this artifact have any attachments?