Workbench 0.18 User Guide

Object Explorer

Data Object

Overview

A Workbench data object is abstracted from the data file it represents.  What this means is that the data object that appears in the Object Explorer is a reference to the file rather than a direct link to it in the way that a file appears in Windows Explorer.  This is because one object in the Object Explorer may reside on disk in several forms, for example an ETL, a pcapng and a CSV file.  In this case, the ETL file was the original version and the other two are cached files produced by Transformers.

A design objective for Workbench is to simplify the analysis of data; removing the need to worry about various versions of the same data also fits this objective.

Files can be added to a data set or be imported into it.  If we add the file it remains in its existing location and Workbench adds a pointer to it.  If we import a file it is copied from its existing location into the Files sub-directory of the workspace.  Importing is useful if we intend to share the workspace with colleagues or suppliers.

Link Data

A file is added to a data set.  To add a file to a data set:

  • Right click on a data set
  • Choose Link Data
  • Browse for the folder (directory) containing the data files
  • Highlight the files to link
  • Click Open

Add a file

Note that we are only able to add files with a file extension of the types listed for the data type container; in this case pcap, pcapng and etl.  If we want Workbench to allow us to add another file type we need to amend the extension list for the data type – see Adding a File Extension to a Data Type.

Import Data

The steps to importing are almost identical to those for adding a file:

  • Right click on a data set
  • Choose Import Data
  • Browse for the folder (directory) containing the data files
  • Highlight the files to add
  • Click Open

As with linking a file, if the Open dialogue doesn’t allow the file type to be selected, amend the extension list for the data type – see Adding a File Extension to a Data Type.

Rename

A data object can be renamed in any of three ways: 

  • Double-click on the file label to produce an editable version
  • Click on the data object and press F2
  • Right-click on the file label and choose Rename from the menu

Rename a file

Renaming the file in the Object Explorer does not change the name of the underlying files.

Delete

A data set or a directory data set can be deleted in two ways:

  • Click on the object so it is highlighted and then press the Delete key
  • Right click on a file and choose Delete

Deleting an object from the Object Explorer does not delete the underlying file from the file system.

Properties

You can view the properties of a data object in three ways:

  • Click on the file so it is highlighted and then press Alt-Enter
  • Right-click on the file and choose Properties
  • Use the View -> Properties Window to display properties, float or dock the window so that the Object Explorer is visible and then click on the object