Automation Guide Action-based testing language Built-in actions Test Support actions Data sets

 check in data set

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.

Applicable Built-In Settings

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

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