Resource: Automated Test Run Result Children ( /api/automatedtestrun/{runId}/node/{nodeId}/children )

A collection resource representing the child result ndes of an Automated Test Run Result node.

Methods

GET

Retrieves the children of a particular automated test run result node. This collection can optionally be filtered by outcome/status. Passing an empty GUID for the node ID will return the root nodes in a run.

Required Permissions

TestManagement/View

Supported Expansions

Metadata
Parameters
Children

For more details on expansions, please see the Expand help topic.

Status Codes

These are the expected status codes returned by the service - in addition, some other status codes may be returned if either an internal error occurs or there is an authentication issue (such as an expired OAuth token).

Status	Description
200 - OK	Returned if the request was completed successfully.
400 - BadRequest	Returned if the status filter included an invalid status.
403 - Forbidden	Returned if ET could not complete the request (normally due to a validation failure or the necessary permissions to complete the request have not been met).
404 - NotFound	Returned if the ID for the run or the node was not found in the database.

Example - GET

Retrieves run result children by parent node ID.

Request Headers

Key	Value	Description
Accept	application/json

Request Parameters

Key	Value	Description
{runId}	1459858c-9526-412e-afdd-09415593c2d3	The unique identifier (GUID) of the run to get results for.
{nodeId}	b8166143-c269-4bd8-876e-d2584edc4e2e	The parent node unique identifier (GUID) to find children for (or an empty GUID to find root nodes).

Response Headers

Key	Value	Description
Content-Type	application/json; charset=utf-8

Response Body

[
  {
    "HasAttachments": false,
    "HasIncidents": false,
    "HasChildren": true,
    "Id": "a1d456c4-3713-4f5e-906b-8d56fd977aa2",
    "Name": "Passing test run node",
    "Description": "A node that passes",
    "Notes": null,
    "Status": "Passed",
    "Iteration": 5,
    "StartedAt": "2008-12-25T01:24:00Z",
    "FinishedAt": "2008-12-25T01:29:00Z",
    "DurationInSeconds": 300.0,
    "Expands": [
      "Children",
      "Metadata",
      "Parameters"
    ],
    "Self": "http://localhost/api/automatedtestrun/1459858c-9526-412e-afdd-09415593c2d3/node/a1d456c4-3713-4f5e-906b-8d56fd977aa2"
  },
  {
    "HasAttachments": false,
    "HasIncidents": false,
    "HasChildren": false,
    "Id": "8b34026c-260e-4a8c-8bc5-60df88cf1c27",
    "Name": "Failed test run node",
    "Description": "A node that's failed",
    "Notes": null,
    "Status": "Failed",
    "Iteration": 5,
    "StartedAt": "2008-12-25T01:24:00Z",
    "FinishedAt": "2008-12-25T01:29:00Z",
    "DurationInSeconds": 300.0,
    "Expands": [
      "Children",
      "Metadata",
      "Parameters"
    ],
    "Self": "http://localhost/api/automatedtestrun/1459858c-9526-412e-afdd-09415593c2d3/node/8b34026c-260e-4a8c-8bc5-60df88cf1c27"
  },
  {
    "HasAttachments": false,
    "HasIncidents": false,
    "HasChildren": false,
    "Id": "12a4c6ad-5c99-4f61-974b-723543cb167c",
    "Name": "Not run test run node",
    "Description": "A node that's not been run",
    "Notes": null,
    "Status": "NotRun",
    "Iteration": 5,
    "StartedAt": "2008-12-25T01:24:00Z",
    "FinishedAt": "2008-12-25T01:29:00Z",
    "DurationInSeconds": 300.0,
    "Expands": [
      "Children",
      "Metadata",
      "Parameters"
    ],
    "Self": "http://localhost/api/automatedtestrun/1459858c-9526-412e-afdd-09415593c2d3/node/12a4c6ad-5c99-4f61-974b-723543cb167c"
  }
]

Status Code

200 - OK

Example - GET with statuses filter

Retrieves run result children by parent node ID, including only nodes that have (or with descendants that have) one of the specified statuses.