.. KDXplore Inventory .. include:: imagerefs.txt ===================== Offline Data Manager ===================== KDXplore is capable of housing multiple different offline databases simultaneously. The **Offline Data Manager** is a KDXplore tool that allows for the management of these databases. 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. |br| Navigating the Offline Database Manager ======================================== .. list-table:: Navigating the Preferences Window :widths: 1 70 :header-rows: 1 * - Step - Action * - **1.** - 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. .. figure:: images/PreferencesExtras/PreferencesImage8.png :scale: 50 % :alt: Opening the offline database manager Opening The Offline Database Manager |br| 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|. .. figure:: images/PreferencesExtras/PreferencesImage9.png :scale: 50 % :alt: Opening the offline database explorer Opening The Offline Database Explorer 2. A dialog will open with the offline database explorer as seen below in area 2. .. figure:: images/PreferencesExtras/PreferencesImage10.png :scale: 50 % :alt: Opening the offline database explorer. 3. In |circle3| the selected database URL (for online connection) and User name can be seen. 4. 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. 5. In |circle5| a list of "General Units" or units of measurement that are currently in the offline database can be seen. 6. 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. |br| 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|. .. figure:: images/PreferencesExtras/PreferencesImage11.png :scale: 100 % :alt: How To Refresh Downloaded Offline Data Refreshing Downloaded Offline Data |br| 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|. .. figure:: images/PreferencesExtras/PreferencesImage12.png :scale: 100 % :alt: How to delete Trial cache in KDXplore Deleting Trial Cache in KDXplore |br| 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. .. figure:: images/PreferencesExtras/PreferencesImage13.png :scale: 50 % :alt: Backing up the offline databases in KDXplore Backing up the offline databases in KDXplore 3. 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.