KDXplore Preferences

KDXplore Preferences

KDXplore preferences appear contextually throughout the general user interface of KDXplore in each module. For instance the preference for what constitutes a “low” seed-bag in the Seed Preparation module can be easily set from the first step of Seed Preparation. Although, as this is a KDXplore preference it can also be adjusted from the main preferences menu.

  1. The main preferences window can be accessed from anywhere in KDXplore by selecting the main “File” menu and then the Preferences preferences option appearing at the:
  • Top of screen on Mac; or
  • Top of KDXplore window frame on Windows.

Navigating to the preferences menu

  1. Selecting the option seen in circle1 in the above image will open the window seen below.

Preferences Window

Preferences Layout

KDXplore preferences are organised in a hierarchy, where preferences are grouped based on module such as “Seed Preparation”, then further grouped based on subsections, such as “User Interface”.

Preferences Window

  1. Selecting the arrow next to a preference group as seen in circle1 will expand the group. Alternatively, double clicking will perform the same action.
  2. Sub groups applicable to a module are now visible. Selecting a sub group as seen in circle2 displays the preferences within that subgroup as seen in circle3.

Preference subgroup display

  1. Further expanding the subgroup structure will present the preferences themselves. Selecting a preference as seen below in circle4 will show controls in circle5 for altering the selected preference. In the example below a colour preference has been selected.

Editing a preference in KDXplore

Resetting to Default

  1. Preferences in KDXplore can be reset to default by selecting the “Reset” button seen in circle1 in the main KDXplore preferences window.

Resetting all preferences to default

Offline Database Manager

KDXplore is capable of housing multiple different offline databases simultaneously. Every time KDXplore is connected to a new online Database a prompt will display requesting to create a new offline database to manage that connection in isolation. This simplifies managing multiple large datasets or online connections.

New database connection dialog

New Database Connection Dialog

  1. To explore the offline databases available in KDXplore navigate to the main “Trial Manager” window and select the button with the KDXplore symbol seen below in circle1.
  2. The displayed window lists the available databases in KDXplore. By selecting one and choosing the “Make Current” button seen in circle3 users can switch between offline databases.
  3. An option is also presented here in circle4 to delete the selected database entirely.
Opening the offline database manager

Opening The Offline Database Manager

Exploring Offline Databases

In KDXplore offline data in any number of offline databases can be seen and explored.

  1. By navigating to the Offline Database Manager as seen in the previous section, selecting a database and clicking the “View” button seen in circle1.
Opening the offline database explorer

Opening The Offline Database Explorer

  1. A dialog will open with the offline database explorer as seen below in area 2.
Opening the offline database explorer.
  1. In circle3 the selected database URL (for online connection) and User name can be seen.
  2. In area circle4 tabs are organised into groups. By selecting a tab, such as “Item-Related” the panel below in area 4. is populated with expandable panel containing the data.
  3. In circle5 a list of “General Units” or units of measurement that are currently in the offline database can be seen.
  4. In circle6 all downloaded trials can be seen. By selecting the tab label “Traits” at the top of circle6 all traits in the offline database can be seen.

Refresh Downloaded Data

When KDXplore is connected to KDDart for the first organisational data relating to vocabulary, units of measurement, items etc. is downloaded and stored for later use as context in KDXplore. This data can be refreshed at any time.

1. To refresh downloaded data from a KDDart database, navigate to the main offline database explorer (as seen in the previous section). Whilst the offline database explorer window is open an additional main menu will be presented for KDXplore labeled “Data” as seen in circle1. 3. Selecting this menu will present a drop down where the option “Refresh from Database” can be selected as seen in circle2.

How To Refresh Downloaded Offline Data

Refreshing Downloaded Offline Data

Clear Offline Cache Files

Performing some download actions in KDXplore will add additional cache isolated from the offline database. This seclusion is sometimes necessary to simplify complex relationships between multiple objects within KDXplore. This cache can be cleared (deleted permanently) at any time.

1. To delete cached Trial data navigate to the main offline database explorer (as seen in the previous section). Whilst the offline database explorer window is open an additional main menu will be presented for KDXplore labeled “Data” as seen in circle1. 3. Selecting this menu will present a drop down where the option “Delete Trial Cache” can be selected as seen in circle2.

How to delete Trial cache in KDXplore

Deleting Trial Cache in KDXplore

Backup Database

Tip

In KDXplore back up of the offline database can be performed at any time. Although there is no danger of KDXplore loosing data integrity, it is always recommended that database backup be stored on an alternative machine or backup medium.

  1. Navigate to the “Check for Updates” menu in KDXplore as seen in the Update section of the first chapter of KDXplore’s help.
  2. Select the “Backup Database” option to save the any of the offline databases.
Backing up the offline databases in KDXplore

Backing up the offline databases in KDXplore

  1. A dialog will open as seen in circle1 where the databases intended for backup can be selected. The file location of the backup can also be set here.