Data navigator panel

The home page of Data contains a navigation panel called the Data navigator panel. The Data navigator panel is a central hub for managing and organizing data definitions and datasets in multiple folders for your project.

Each folder in the Data navigator panel acts as a container for the existing Data definitions or datasets. Therefore, you can navigate and locate specific Data definitions or datasets within a folder of a project easily. Each folder can contain separate sections for the Data definitions or Datasets. You can click a Data definition or a dataset to open and manage the corresponding asset in the Data page for the project.

You can perform the following actions from Author > Data:

Actions Descriptions
Search You can search for a Data definition or a dataset in a branch by entering the name of the Data definition or dataset in the Search field.

View

You can view the contents of a Data definition or a dataset for a selected folder in a project. See Viewing a Data definition and its details and Viewing a dataset.

Create

You can create a Data definition or a dataset in a project. See Creating an empty Data definition and Creating a dataset.

Edit

You can modify a Data definition or a dataset when you want to run a test asset with different dataset values. See Modifying a Data definition and Editing a dataset.

Delete

You can delete a Data definition or a dataset when it is not required in your test environment. See Deleting Data definitions and Deleting a dataset.

Branch selection

You can view the Data definitions and datasets of a project that are saved in multiple branches of the repository by selecting the name of the branch from the Branch list. When you access the Data definition or dataset page for the first time after adding the repository, the global branch is set to the default branch of the repository.

When multiple repositories are added to the same project, the following events occur:

  • The Data definitions and datasets that are stored in the selected branch of all the repositories in the project are displayed in the Data navigator panel.

  • The branches in each of the repositories are listed in the Branch list.
You can use the following options to enhance your data navigation experience while managing and organizing data definitions and datasets across multiple folders of your project.
Icon Description

You can use the Virtual Folder icon to view folders at different levels. The available options are:

  • Root Folders: Displays virtual folders at the top, followed by the repository's folder structure.
  • Embedded Folders: Shows the repository's folder structure first, with files organized into virtual folders.
  • None: Excludes virtual folders entirely, and presents only the repository's orignal folder structure.
You can use the Link with editor icon to connect editor tabs to their corresponding locations in the navigator. By using this icon, you can easily navigate and quickly access specific sections within your project.

You can apply a filter to view folders by their asset type. You can select one or more of the following asset types and apply the filter:
  • Data Definitions
  • Database Queries
  • Datasets
  • Schemas
You can use the Save All icon to save all changes made to multiple assets or folders within your project.
Notes:

  • Only a Project Owner or a project member whose role is a Tester can edit a Data definition or a dataset.

  • To view the contents of an encrypted dataset, you must provide an encryption key that you set when you encrypted the dataset column.

  • As a Viewer, when you try to modify a Data definition or dataset, an error message is displayed because you do not have the permission to modify them.

To conclude, the Data navigator panel provides easy access to projects, Data definitions, and datasets in multiple branches. You can efficiently organize the Data definitions and datasets in HCL DevOps Test Hub (Test Hub).