check in data set

Description

Check in a data set.

Arguments

data set
Name of the data set (see Notes).
path
(Optional) Location to which the inline data set will be stored (see Notes).
comments
(Optional) Brief note explaining the changes (see Notes).

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Applicable Systems/Platforms

Use of this action is supported on the following systems/platforms: Windows, Linux.

Notes

  • The data set argument may specify a dedicated data set or inline data set that has already been defined within the test.
    • for a dedicated data set: the full TA path from the Data node must be specified, with forward slashes (/) delimiting each level of the hierarchy.
    • for an inline data set: only the name (no path) of the data set is necessary.
  • path argument:
    • This argument applies only to inline data sets. If data set specifies a dedicated data set, any value in path is ignored.
    • Value must always begin with a forward slash (/), which corresponds to the Data node.
    • If the data set is inline and this argument's value is omitted, the data set is automatically stored directly beneath the Data node of the project tree.
  • comments argument:
    • It is highly recommended that you add a brief note explaining the changes made to the data set before checking it in.
    • This comment can be helpful when querying changes made at each check-in, or to view a general history of changes to the item.
  • Versioning: If the specified data set already resides on a repository, and:
    • no data changes are made: check-in does not update the current version number of the data set.
    • data changes are made: check-in does update the current version number of the data set.
  • Check-in validation: TestArchitect issues a warning/error in response to this action if any of the following conditions hold:
    • the data set is currently checked out to another user;
    • the data set is already in a checked in state; or
    • the current user lacks permission to modify the data set.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.
Restriction: This action does not support multiple device execution.

Applicable Built-In Settings

The following settings are applicable to this action: remove double quotes from cellsnone.

Example

Scenario:
  1. Create an inline data set, Customers.
  2. Add columns and rows to the inline data set.
  3. Finally, check in the inline data set to create a data set node under the Customer info data set folder.
Action Lines

Result

Effect