Datapools are edited using the Datapool Editor. The editor contains the following tabs:
This tab provides an overview of the datapool, including its general information, variables, and equivalence classes.
This tab contains the following sections:
General Information
Contains the datapool's name, description, and file path within the workspace. The datapool's name1 and description are editable.
Variables
Contains the variables associated with the datapool.
Variables can be added to the list by clicking the Add button.
Selected variables can be removed (Remove), moved up (Up), or moved down (Down).
Variable names can be edited by double-clicking the variable or selecting the variable and pressing F2.
Equivalence Classes
Contains the equivalence classes associated with the datapool.
Equivalence classes can be added to the list by clicking the Add button.
Selected equivalence classes can be removed (Remove), moved up (Up), moved down (Down), or opened in the associated tab (Open...).
Equivalence class names can be edited by double-clicking the equivalence class or selecting the equivalence class and pressing F2.
[1] Datapools have a file name and logical name. The logical name is used in the Test Navigator of the Test Perspective, dialogs, editors, and wizards to represent the datapool. The file name represents the datapool file (*.datapool) within the workspace. When the datapool is created, the logical name defaults to the file name (excluding the .artifact file extension) and may be modified without modifying the file name. The logical name allows customization of the datapool name without affecting the file name within the workspace.
This tab contains the datapool table with the variables (or columns) for the datapool, records (or rows) for the equivalence class, and cells for the records:
Variables
Each variable has an associated name and type (for example, String, Number, Boolean, Enumeration, and Complex) that are used in the variable column name (for example, <variable name>::<variable type>) in the datapool table. Each variable is positioned in the datapool table relative to the other variables in the datapool. Variables may be encrypted for sensitive data, such as user identifiers. Variables are encrypted with a password for the datapool.
Variables can be inserted (right-click on the datapool table and select Insert Variable... or Ctrl+Insert), removed (right-click a variable column in the datapool table and select Remove Variable or Ctrl+Delete), and their properties (name, type, position, encryption, and password) edited (right-click a variable column in the datapool table and select Edit Variable... or select the variable column name in the datapool table).
Records
Each record has an associated number displayed in the first column in the datapool table. Each record is positioned in the datapool table relative to the other records in the equivalence class.
Records can be inserted (right-click on the datapool table and select Insert Record or select record number in the first column in the datapool table and Insert or select the last record in the datapool table and Enter), removed (right-click the record number in the first column in the datapool table and select Remove Record or select record number in the first column in the datapool table and Delete), and their properties (position) edited (right-click the record number in the first column in the datapool table and select Edit Record...).
Multiple records can be selected (hold Ctrl and click multiple record numbers in the first column in the datapool table or select a starting record number in the first column in the datapool table, hold Shift, and press Up or Down) and deleted (press Delete).
Individual records can be selected (click the record number in the first column in the datapool table) and cut (right-click and select Cut, Ctrl+X, or select Edit > Cut from the file menu), copied (right-click and select Copy, Ctrl+C, or select Edit > Copy from the file menu), and deleted (press Delete). A copied record can be pasted (right-click the record number in the first column in the datapool table and select Paste, Ctrl+V, or select Edit > Paste from the file menu).
Cells
Cells can be edited by double-clicking the cell in the datapool table or selecting the cell in the datapool table and pressing F2.
Individual cells can be selected (click the cell in the datapool table) and cut (right-click and select Cut Ctrl+X, Ctrl+X, or select Edit > Cut Ctrl+X from the file menu), copied (right-click and select Copy Ctrl+C, Ctrl+C, or select Edit > Copy Ctrl+C from the file menu), and deleted (press Delete or Backspace or Insert or typing or pasting new content). A copied cell or the system clipboard can be pasted (right-click the cell and select Paste Ctrl+V, Ctrl+V, or select Edit > Ctrl+V Paste from the file menu).
Cells can be searched and replaced (right-click and select Find/Replace... Ctrl+F, Ctrl+F, or select Edit > Find/Replace... Ctrl+F from the file menu). When searching, the next cell containing one or more occurrences of the search string is selected. When replacing, all occurrences of the search string are replaced by the replace string in the selected cell. Note, encrypted cells are not searched or replaced due to the sensitive nature of the data. To search and replace encrypted cells, decrypt the variable, perform the search and replace operations, and re-encrypt the variable.
[2] Each equivalence class has an associated tab named <Equivalence Class Name>.
Related tasks
Creating a datapool
Importing a Comma-Separated Value (CSV) file as a Datapool
Exporting a Datapool as a Comma-Separated Value (CSV) file
Related samples
Tutorial: Accessing a datapool from a TPTP JUnit test