-
Notifications
You must be signed in to change notification settings - Fork 3
TestMonitor
- ITestDataManager
- ITestResult
- ITestStep
- NamedValue
- ResultData
- Status
- StatusType
- StepData
-
TestDataManager
- #ctor()
- #ctor(configuration)
- AutoUpdateTotalTime
- CreateResult(resultData)
- CreateResultAsync(resultData)
- CreateStep(data)
- CreateStepAsync(data)
- CreateSteps(data)
- CreateStepsAsync(data)
- UpdateResult(resultId,resultData)
- UpdateResult(resultId,resultData,replace)
- UpdateResultAsync(resultId,resultData)
- UpdateResultAsync(resultId,resultData,replace)
NationalInstruments.SystemLink.Clients.TestMonitor
Represents common operations on test data.
Creates a test result from its associated data.
The created test result.
| Name | Type | Description |
|---|---|---|
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | Data elements describing the result to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates a test result from its associated data.
The created test result.
| Name | Type | Description |
|---|---|---|
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | Data elements describing the result to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Creates a new step by ID.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data does not have a Result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates a new step by ID.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data does not have a Result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Creates multiple new steps by ID.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element, or contains an element without a result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates multiple new steps by ID.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element, or contains an element without a result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates a test result by ID with new data.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultId with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates a test result by ID with new data, and optionally replaces keywords and properties.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultData with. |
| replace | System.Boolean | Whether to fully replace resultId's keywords and properties with the given data instead of merging them. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates a test result by ID with new data.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultId with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates a test result by ID with new data, and optionally replaces keywords and properties.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultData with. |
| replace | System.Boolean | Whether to fully replace resultId's keywords and properties with the given data instead of merging them. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
NationalInstruments.SystemLink.Clients.TestMonitor
Represents a single test result, which corresponds to a single test run or sequence.
Indicates whether or not to auto-calculate this result's TotalTimeInSeconds property when creating or updating steps.
Gets the user-defined data fields associated with this result.
Gets a unique identifier for this result.
Gets the time at which this result was most recently updated.
Creates a new step as a child of this result.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates a new step as a child of this result.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Creates multiple new steps as a child of this result.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates multiple new steps as a child of this result.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Automatically assigns a status to this result which is determined by the statuses of all its related steps.
The updated result.
This method has no parameters.
| Name | Description |
|---|---|
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously assigns a status to this result which is determined by the statuses of all its related steps.
The updated result.
This method has no parameters.
| Name | Description |
|---|---|
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates this test result with new data.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update this result with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates this test result with new data, and optionally replaces keywords and properties.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update this result with. |
| replace | System.Boolean | Whether to fully replace this result's keywords and properties with the given data instead of merging them. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates this test result with new data.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update this result with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates this test result with new data, and optionally replaces keywords and properties.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update this result with. |
| replace | System.Boolean | Whether to fully replace this result's keywords and properties with the given data instead of merging them. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
NationalInstruments.SystemLink.Clients.TestMonitor
Represents a Test Monitor step, which corresponds to a single test, test grouping, comparison, or action.
Gets the user-defined data fields associated with this step.
The StepId value of this step's parent, or null if this step is top-level.
The Id value of this step's associated test result.
Gets the time at which this step was most recently updated.
Creates a new step as a child of this step.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates a new step as a child of this step.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Creates multiple new steps as a child of this step.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates multiple new steps as a child of this step.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates this test step with new data.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | The new data to update this step with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates this test step with new data.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | The new data to update this step with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
NationalInstruments.SystemLink.Clients.TestMonitor
Represents a single named JSON value.
Initializes a named value from a name and a value.
| Name | Type | Description |
|---|---|---|
| name | System.String | The name of this named value. |
| value | System.Object | The value to log. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if name or value is null. |
The name associated with this logged value.
The JSON value, as a plain object.
NationalInstruments.SystemLink.Clients.TestMonitor
The data associated with a single test result. A test result corresponds to one test run or sequence.
A list of SystemLink File service IDs representing files associated with this result.
The hostname of the system upon which this test result was executed. If not provided, this value will automatically default to the current system's hostname.
A list of user-customizable queryable strings attached to this result.
An identifier for the individual or mechanism that is executing the test.
The type of unit under test.
The name of the test program, bucket, or sequence which produced this result.
A set of user-customizable queryable key-value-pairs attached to this result.
An identifier for the specific instance of the unit under test.
The time and date at which this test began executing. If not provided, this value is automatically determined by SystemLink.
Represents the current execution state of this result.
A unique identifier of the system upon which this test result was executed. In the case of a SystemLink managed system, this should be the system's Minion ID. If not provided, this value will automatically default to the Minion ID if the current system is registered.
The total time, in seconds, that this test was executing for. If not provided, this value is automatically determined by SystemLink.
NationalInstruments.SystemLink.Clients.TestMonitor
Represents the current state of a test result or step.
Constructs a Status from a StatusType. The StatusName value is automatically determined.
| Name | Type | Description |
|---|---|---|
| statusType | NationalInstruments.SystemLink.Clients.TestMonitor.StatusType | The StatusType to use. |
Constructs a Status with a provided StatusType, plus an overriding descriptive name.
| Name | Type | Description |
|---|---|---|
| statusType | NationalInstruments.SystemLink.Clients.TestMonitor.StatusType | The StatusType representing this status. |
| statusName | System.String | The override string name to use. |
Constructs a custom status given a user-defined string.
| Name | Type | Description |
|---|---|---|
| statusName | System.String | The user-defined name of the status. |
A descriptive string representing this status.
The StatusType representing this status.
NationalInstruments.SystemLink.Clients.TestMonitor
Represents the current state of a test result or step.
Used to represent a state which is not represented by any other StatusType.
Represents a generic completion state for a test or setup action.
Represents a test which failed to execute due to an error.
Represents a test which has completed and failed.
Represents a test that is waiting to be re-executed in some control flows.
Represents a test which has completed and passed.
Represents a test which is currently executing.
Represents a test that was acknowledged but not executed.
Represents a test which was manually stopped during execution.
Represents a test which was set to Running, but was not updated for over 24 hours, and therefore is assumed to have stopped executing.
Represents a test which is waiting for some event to occur before it can begin executing.
NationalInstruments.SystemLink.Clients.TestMonitor
Represents a single test, test grouping, comparison, or action.
Initializes the data members of a step.
This constructor has no parameters.
Initializes the data members of a step along with the step's identifiers.
| Name | Type | Description |
|---|---|---|
| stepId | System.String | The StepId of this step. |
| resultId | System.Guid | The Id of this step's associated result. |
| parentId | System.String | The StepId of this step's parent, or null if this step has no parent. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if stepId is null. |
| System.ArgumentException | if stepId or resultId is empty. |
A string name indicating the expected keys in Parameters
A collection of named JSON values which were passed to this test.
The name of this step.
A collection of named JSON values which were logged by this test.
A set of key-value-pair dictionaries used for storing measurements or other user-customized test data.
The StepId value of this step's direct parent, or null, if no such parent exists.
The Id value of this step's associated result.
The time and date at which this test began executing. If not provided, this value is automatically determined by SystemLink.
Represents the current execution state of this step.
A string used to uniquely identify this step among the other steps associated with a test result. If not provided, SystemLink will determine this identifier automatically. Most users should not provide this value themselves. Some exceptions include users who are uploading test data to SystemLink where data elements already have predefined unique identifiers.
The type of test or action that this step represents.
A user-customizable string field used for storing any text data associated with this test. For instance, this may be used for storing a stacktrace, or a test string.
The total time, in seconds, that this test was executing for. If not provided, this value is automatically determined by SystemLink.
NationalInstruments.SystemLink.Clients.TestMonitor
Represents common operations on test data over HTTP.
Initializes a new test data manager which will communicate over HTTP using the configuration provided by SystemLink Client. The system must be either be registered to a SystemLink Server, or it must be a SystemLink server itself.
This constructor has no parameters.
| Name | Description |
|---|---|
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the current system cannot communicate with a SystemLink Server, |
| or if the configuration provided by SystemLink Client cannot be found. |
Initializes a new test data manager which will communicate over HTTP using the configuration provided by configuration.
| Name | Type | Description |
|---|---|---|
| configuration | NationalInstruments.SystemLink.Clients.Core.IHttpConfiguration | Specifies the web server, authentication, and metadata to use for communication. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if configuration is null. |
Indicates whether or not to auto-calculate results' TotalTimeInSeconds property when creating or updating steps.
Creates a test result from its associated data.
The created test result.
| Name | Type | Description |
|---|---|---|
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | Data elements describing the result to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if ResultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates a test result from its associated data.
The created test result.
| Name | Type | Description |
|---|---|---|
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | Data elements describing the result to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if ResultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Creates a new step by ID.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data does not have a Result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates a new step by ID.
The created test step.
| Name | Type | Description |
|---|---|---|
| data | NationalInstruments.SystemLink.Clients.TestMonitor.StepData | Data elements describing the step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data does not have a Result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Creates multiple new steps by ID.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element, or contains an element without a result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously creates multiple new steps by ID.
The created test steps.
| Name | Type | Description |
|---|---|---|
| data | System.Collections.Generic.IEnumerable{NationalInstruments.SystemLink.Clients.TestMonitor.StepData} | Multiple sets of data elements, each describing a single step to create. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if data is null. |
| System.ArgumentException | if data contains a null element, or contains an element without a result ID. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates a test result by ID with new data.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultId with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Updates a test result by ID with new data, and optionally replaces keywords and properties.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultData with. |
| replace | System.Boolean | Whether to fully replace resultId's keywords and properties with the given data instead of merging them. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates a test result by ID with new data.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultId with. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |
Asynchronously updates a test result by ID with new data, and optionally replaces keywords and properties.
The updated test result.
| Name | Type | Description |
|---|---|---|
| resultId | System.Guid | The ID of the result to update. |
| resultData | NationalInstruments.SystemLink.Clients.TestMonitor.ResultData | The new data to update resultData with. |
| replace | System.Boolean | Whether to fully replace resultId's keywords and properties with the given data instead of merging them. |
| Name | Description |
|---|---|
| System.ArgumentNullException | if resultData is null. |
| NationalInstruments.SystemLink.Clients.Core.ApiException | if the Test Monitor API call fails. |