Diversity Exsiccatae

Scope of DiversityExsiccatae within the Diversity Workbench

DiversityExsiccatae is the module for administration of exsiccatal series within the Diversity Workbench. The DiversityExsiccatae is requiered by the module DiversityCollection and on the other hand uses services provided by the modules like DiversityReferences and DiversityAgents).

The modules communicate with each other to provide their services for the other modules.

Data managment sectors of the application

Sector Description
Evaluation The evaluation of an exsiccatal series
Editors The editors of an exsiccatal series
Publication span The publication span of an exsiccatal series
References The references related to an exsiccatal series
Examples The examples for an exsiccatal series

Usage example

An exsiccatal series is administrated or published by several agents using a list of references and examples.

Main form of DiversityExsiccatae

To start the application double click on DiversityExsiccatae.exe.

The first time you start the application you have to configure the connection to the database (Connection, Server … ) you want to work with. The header of your form allways shows you, with which database you are working, the version of the client, the database server and your login.

To see the descriptions for the fields of the database, simply move your mouse over it. A tooltip will appear with an explanation of the field.

Where you have to choose items from lists, type the beginning of the item name in the field and then click on the drop down button . This will start a query in the database and list the result in the combobox. If contents can be linked to an other module, click on the  button to start a query in this module.

Subsections of Diversity Exsiccatae

Diversity exsiccatae

Download

Current version

4.0.4 (2023-03-02)

Download

  • Several bugfixes
  • Several new order columns
  • Multicolumn resultlist enabled

Previous versions

4.0.3

  • Bugfix removing images of examples
  • Update for current Workbench
  • Optimized query enabled
  • Rember of Query enabled

 

Datebase updates

  • 02.00.07: Adding PrivacyConsent columns in UserProxy;
  • 02.00.08: Missing decriptions; Adding View_Coverage;

 

Tutorial

Tutorial - first steps

Editing the data

Subsections of Editing the data

Editors

To add a new editor to the list click on the  Button. To delete an selected editor from the list click on the  Button.

To open the module DiversityAgents to get more infomation about an editor, click on the  Button.

Evaluation

In the evaluation part, further informations on the exsiccatal series are entered like the taxonomic coverage or the purpose of the exsiccatal series.

    

The geographcal regions covered in the exsiccatal series are in the corresponding area. To insert a new region, click on the  Button and select a region offered by the module DiversityGazetteer. To delete a region, select it in the list and click on the  button.

Examples

The list of the examples is shown with their images in the list. If an example misses an image, this will be indicated with an  entry in the list.

To add a new example to the list click on the  Button. An window will open, where you can search for an image file. If you want to create an example without an image, just click OK without selecting any image. If you later want to add an image to you example click on the   button and select an image file. A form will open, where you can search for an image.

Click OK to take the image in your example.

To delete an selected example from the list click on the  Button. If you want to link to a collection specimen from the module DiversityCollection , click on the  Button.To zoom a sector of the image, just drag the mouse over the image. A red square will indicate the zoomed area. To adapt the size of the image to the available space in the form click on the  button. To change the orientation of the image use the appropriate buttons (  flip horizontal,  flip vertical,  rotate right,  rotate left).

Only the file names are stored in the database. The directory for the file must be set in the menu under Adminstraton - Image folder … .

Publication span

Details about the Publication span are entered in the area Publication span. The span of the numbers will be shown in the sequence overview.

 

References

To add a new reference to the list click on the  Button. To delete an selected reference from the list click on the  Button.

To open the module DiversityReferences to get more infomation about an reference, click on the  Button.

Import Export

Installation

Resources

To run a module of the Diversity Workbench you need the database and the client. All parts can be downloaded for free from http://www.microsoft.com/downloads/ and http://www.diversityworkbench.net/Portal/.

For an intoduction see a short tutorial with DiversityCollection as an example .

Client

The client is based on the .Net framework version 4.8 from Microsoft. If not already present, the software will ask you for installation. Download the installer from the Portal and start it. In case you get as message as shown below

Please click on Weitere Informationen. A button as shown below will appear

Please click on Trotzdem ausführen to install the software as shown below.

If you need to change the location of the software, this can be done in the next step (see below).

After the installation is done, the software will be included in the programm menu (see below) and a shortcut on the desctop will be created.

The software will be placed in the programs directory as shown below.

After the installation make sure to get the latest updates from http://windowsupdate.microsoft.com/.

 

Run program without installer

There are several reasons why you might prefer to run DiversityCollection without installation. E.g. if you lack administrative permissions on your computer or if you want to use several different versions of DiversityCollection in parallel. If the downloaded .zip file contains besides the installer DiversityCollectionSetup.msi the file unpack.bat, you can easlily unpack the program files to a directory on your desktop. Unpack the .zip file to a local directory and start the batch file unpack.bat with a double-click. You might get a security warning as shown in the section above, see there how to proceed. The batch file unpacks the program files to a folder on your desktop named DiversityCollection_x_x_x, where "x_x_x" stands for the program version. In the folder double-click on file DiversityCollection.exe to start the program

If the downloaded .zip file does not contain the file unpack.bat you can extract the files manually. Extract the content of the  .zip file, open the cmd and use msiexex to extract the files to the desired location as shown in the example below:

msiexex /a c:\\Downloads\\DiversityCollectionSetup.msi /qb TARGETDIR=c:\\DiversityWorkbench\\DiversityCollection

where  c:\\Downloads is the directory containing the msi file and c:\\DiversityWorkbench\\DiversityCollection is your target directory. Now you can start the program with a double click on DiversityCollection.exe located in your specified directory.

 

Database

For the installation of a local database see the section Installation of the database.

 

Display / Monitor settings

By default the program detects monitor resolution higher than 100% and will adapt to it. The icons of the windows may become somewhat blurry. If for any reason the whole program stays blurry it may help to let windows try to fix it (see image below).

 

Database login

Connect to a database

To access the database select from the menu. A dialog will open as shown below. If you have been connected to a database in previous sessions you can select on of these session with the option. Otherwise you can specify the name or IP-adress. For a test you can send a ping with a click on the button (see below).

Next enter the port number of the server and the authentication mode

  • Windows authentication: Using the Windows Login information.
  • SQL-Server authentication: User and password as defined in the database.

  

The standard port number for SQL-Server is 1433 and will be set as a default (see left image above). If the database server is configured using a port different from that port, you must give the port number in the field Port (see left image above). If the connection informations are valid, you can choose a database from the server. In the main form you can select the databases that are available under Connection - Database... Video starten

If you access a database for the first time you will be asked to consent to the storage and processing of your personal data (see below) according to the General Data Protection Regulation. Without your consent the access is not possible.

Encryption

The connection to the databases by default is encrypted, symbolized by the icon. To change to an not encrypted connection, click on the icon which will change to accordingly, indicating a not encrypted connection.

Query

Visibility

The query containing results and fields is positioned a the left of the window. To visibility of the query can be set in the menu: Query - Show query:

The query fields are displayed in the main form beneath the list of the result items. You can change this arrangement using the  /  button to place the query fields on the left side of the item list.

To hide the area containing the search fields click on the  button. If the search area is hidden and you want to start a new search, just click on the  button.

Searching

To search for data, enter the restrictions in the fields for the search conditions and click on the  button. The agents found in the database will be shown in the list. To add agents with differing search conditions click on the  button. If you want to remove entries from the selected list, choose them and click on the  button. This will not delete the data from the database, but remove them from your query result.

The option to provide a result list with many columns is described in chapter Many result columns.

To change the displayed fields for searching data click on the  button to change the query options. 

A window will open containing the command used to retrieve the data (see below).

To keep the values you entered for the query, you can click on the button. It will change to and when restarting the program your query values will be remembered

To speed up the query you may use the optimized version (Standard query: Optimized query: ). The optimized query in combination with the remembering option includes the functionality to preselect data depending on the query restrictions, e.g. if you search for an identification and enter a taxonomic name the first identification matching the restrictions will be preselected in the main window as shown below.

The set the option for optimized queries and the option to remember the query settings as default, choose Administration - Customize display... from the menu. In the tab Defaults and miscellaneous select the Optimized and Remember option. The buttons in the query will be hidden providing more space. 

Certain query fields provide the option to add up to 3 duplicates of themselves. Use the button to add and the button to remove duplicates. The restrictions can be combined with AND + and OR |. Just click on the + resp. | sign to change between the modes.

Within the query options you have several possibilities to specify your search restriction. Use the drop-down menu to switch between operators. The available operators are shown in the tables below.
Availability: t = text, n = numeric, d = date, h = hierarchy, x = XML, e = EXIF, g = geography, a = annotation, m = module
For an introduction see two short tutorials Video starten Video starten

Query operators

Op. Meaning Example Avail.
∼ search for an entry like… (you may use wildcards) Pinus s[iy]lvestris % tn---e--
= search for an entry exactly equal to … Pinus silvestris L. tndh----
≠ search for an entry not like... Pinus s[iy]lvestris % (you may use wildcards) tn------
∅ search for an entry where a value is missing … tndhxeg-
• search for an entry where a value is present … tndhxeg-
- search for an entry between … and … 2000 - 2003 tnd-----
| search within a list of entries, separated by "|" or one line per value. If wildcards ("%", "_") are included the query will search for values like the given values 2000 | 2003 ... | 2000 2003 tn------
∈ search with exclusion of a list of entries with one value per line. Wildcards will be ignored 2000 2003 tn—–m
∉ search with exclusion of a list of entries with one value per line. Wildcards will be ignored 2000 2003 tn—–m
± search for an entry where only parts of the date are present… -.-.2006 --d-----
Δ search including children in a hierarchy … M-Fungi ---h----
/ Search for entries containing a given XML node (not for EXIF) settings ----x---
¬ Search for entries not containing a given XML node (not for EXIF) settings ----x---
‡ Search for entries with a maximal distance of … POINT(24.24 45.243) | 50 km ------g-
O Search for entries within an area POLYGON(34.5 ... ------g-
¤ Search for entries outside an area POLYGON(34.5 ... ------g-
+H Search for entry including lower hierarchy Picea | Picea abies -------m
+S Search for entry including synonyms Picea abies | Pinus abies -------m
+HS Search for entry including lower hierarchy and symonyms Picea | Picea abies | Pinus abies -------m

Operators for text

Operator Meaning Example
∼ search for an entry like ... Pinus s[iy]lvestris % (you may use wildcards)
= search for an entry exactly equal to ... Pinus silvestris L.
≠ search for an entry not like ... Pinus s[iy]lvestris% (you may use wildcards)
∅ search for an entry where a value is missing ...
- search for an entry between ... and ... 2000 - 2003
| search within a list of entries, separated by "|" or one line per value. If wildcards ("%", "_") are included the query will search for values like the given values 2000 | 2003 ... | 2000 2003
∈ search with exclusion of a list of entries with one value per line. Wildcards will be ignored 2000 2003
∉ search with exclusion of a list of entries with one value per line. Wildcards will be ignored 2000 2003

Operators for numeric data

Operator Meaning Example
= search for an entry exactly equal to … Pinus silvestris L.
< search for an entry lower than ... 2006
> search for an entry higher than ... 2006
- search for an entry between ... and ... 2000 - 2003
| search within a list of entries, separated by "|" or one line per value 2000 | 2003
∈ search within a list of entries with one value per line 2000 2003
∉ search with exclusion of a list of entries with one value per line 2000 2003
∅ search for an entry where a value is missing ...
• search for an entry where a value is present

Operators for date values

Operator Meaning Example
= search for an entry exactly equal to ... 20.3.2006
< search for an entry lower than ... 20.3.2006
> search for an entry higher than ... 20.3.2006
- search for an entry between two dates... 20.3.2006 - 29.3.2006
± search for an entry where only parts of the date are present... -.-.2006
∅ search for an entry where the date is missing …
• search for an entry where the date is present and complete …

Oparators for hierachy

Operator Meaning Example
= search for an entry exactly equal to ... M-Fungi
≠ search for an entry which is not equal to … M-Fungi
∅ search for missing entry ...
• search for present entry ...
Δ search including children in a hierarchy ... M-Fungi

Operators for XML

Operator Meaning Example
~ Search for entries like a given text (for EXIF) RDF
/ Search for entries containing a given XML node (not for EXIF) settings
¬ Search for entries not containing agiven XML node (not for EXIF) settings
∅ search for missing entry ...
• search for present entry ...

Operators for geography

Use (via local files or manual creation) resp. (via DiversityGazetteer) button to set geography

Operator Meaning Example
‡ Search for entries with a maximal distance of ... POINT(24.24 45.243) | 50 km
O Search for entries within an area POLYGON(34.5 ...
¤ Search for entries outside an area POLYGON(34.5 ...
∅ search for missing entry...
• search for present entry ...

For yes/no fields exists a checkbox with 3 options: = yes, = no, = undefined

For a search within a lists (using the |, ∈ or ∉ operator) you may double click in the text field to open a window where you can enter your values. To separate the values either use the "|" sign or a new line as shown in the image below.

Query modules

In the query for values linked to another module click on the button to open a window where you can search for values within the linked module. A click on the button will show a list of the selected items. For some modules you can choose the cache database as source (if you have the proper permissions). This option provides a faster query esp. if e.g. the data of a related module are accessed via a linked server.

Tutorial: Video starten

Operator Meaning Example
∈ Search for entries with a list Rosa | Rosa caninia \
∉ Search for entries not within a list Rosa | Rosa caninia | ...
+H search for entry including lower ierarchy Picea | Picea abies | ...
+S search for entry including synonyms Picea abies | Pinus abies | ...
+HS search for entry including lower hierarchy and synonyms Picea | Picea abies | Pinus abies | ...
Change filter mode between link and text http://tnt.diversityworkbench.de/TaxonNames_Plants/4269 <> Picea abies L.

Wildcards in SQL

There are 4 different possibilities for wildcards in SQL:

Operator Description Example Result
%   any string consisting of no, one or many characters Pinus % will find anything like Pinus, Pinus sylvestris, Pinus strobus etc.
*  same effect as % (see above)
_  a single character Pinus s_lvestris will find Pinus sylvestris and Pinus silvestris etc.
[…] any character out of a given range like [abcde] or [a-e] Pinus s[iy]lvestris will find Pinus sylvestris and Pinus silvestris
[^…]   any character not in a given range like [^abcde] or [^a-e] Pinus s[^i]lvestris will find Pinus sylvestris but not Pinus silvestris

Many colunns

The option to include several columns in the result list is only available for optimized queries . To display several columns in the result list, click on the button next to the order by column (see below). A window will open where you can select the next column for the sorting. Underneath the order by column the second column for the sorting will be added. To remove this sorting column you can click on the    button. By default the width for the columns is set to 10. You can change this according to content. To set the width to the maximal length of the current content, click on the button. To change the sorting of the added order column click on the button. The colums are separated via " | " as shown in the image below.

 

General

Subsections of General

Menu

Overview of the menu in DiversityExsiccatae
Connection
  Database … Choose one of the databases available on the server. Only those databases will be listed to which the user has access permission
 Module connections … Edit the connections to the other modules within the Diversity Workbench.
Transfer previous settings Transfer the settings of a previous version
Quit Quit the application and stop all processes started by the application
Query
 Show query Show or hide the query list
Predefined queries Under this menu entry all predefined queries will be listed
Administration
  User … Administration of the users and their permissions in the database
 Image folder … setting the path for the central image folder
Resources directory … Setting the directory for the resources
Help
Manual Opens the online manual
Feedback … Opens a window for sending feedback
Feedback history … Opens a window for browsing former feedback
Info Show the version of the program and corresponding information

 

 

 

 

 

Feedback

If you have suggestions for improvement, need any changes in the programm or encouter an error you can give a feedback to the administrator. Click on the ALT and PRINT buttons to get a screen shot of your current form. After creating the screen shot choose Help - Feedback from the menu to open the feedback form as shown below.

 

Click on the Insert image button to insert the screen shot and give a comment about your problem. In the field Topic enter the topic of your feedback (will appear in response e-mail). The Priority can either be empty or set to 3 levels:

  • urgent
  • as soon as possible
  • nice to have

If necessary, enter a date in the field ToDo until when you would like to have the task described in you feedback be solved. Then click on the  Send feedback button to send your feedback to the administrator. If you would like to receive a message when the problem you described is solved, please enter you e-mail address in the field below the description.

To inspect your former feedbacks choose Feedback history from the menu. A window will open where you can browse your past feedback together with the state of progress.

Internals

For users that need more detailed information about the software including database design etc.

Subsections of Internals

Database

Organisation of the data

The main data are kept in the table Exsiccata. Editors are listed in the table ExsiccataEditor, examples in the table ExsiccataExample and geographicla regions in the table ExsiccataRegion.

Descriptions of tables and columns

Version



Version

For information about the version of the client application choose Help, Info…

The current version in the example above is 4.0.0 for the client and 2.1.13 for the database

 

 

License



License

This manual is copyrighted work licensed under a Creative Commons License.

All material in this manual is the property of the contributing authors and fully copyrighted. By choosing this way of publication, the contributing authors have agreed to license the work under a Creative Commons License permitting reproduction, distribution, and derivative works, requiring attribution, notice, and share-alike, and prohibiting commercial use.

 

For information about the license of the client software choose Help, Info…

The client software is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation.

The client software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License (GPL) for more details.

Data Access

Access to the data

To get access to the data, you have to fulfill several requirements. In DiversityCollection, you must be a member of one of the user groups. You can only access data, which is listed in the projects you have access to. For external users data may be blocked by entries in the data withholding reasons or due to a data embargo.

   

Subsections of Data Access

Login Administration



To administrate the logins on the database server, their permissions and roles respectively as well as access to projects choose Administration - Database - Logins ... from the menu. A window will open as shown below.

To set the website where information about details concerning the General Data Protection Regulation are shown, click on the button.   

To see the current activity on the server click on the button. A window as shown below will open listing all user related processes on the server.

To administrate the  linked servers, click on the button.   

To send a feedback click on the button.   

 

Statistics

To see the activity of a login click on the button. A window will open as shown below listing all databases and tables together with the time span (From - To) and the number of data sets where any activity of the current login has been found.

 

Creation of login

To create a new login click on the button. A window will open as shown below. A login that should be able to create new logins must to be a System administrator.

Here you can enter the name of the new login, the password and the information about the user which will be stored in a DiversityAgents database. You may either create a new entry in this database or select an existing one: Click on the button to search for a name in the database (see below).

 

Copy a login

To copy a login including all permissions etc. into a new login, select the original login in the list and click on the button.

 

Edit a login

To edit the access for a login on the server select the login in the list. If a login should be disabled , uncheck the enabled checkbox (see below).

All databases on the server will be listed with the current database showing a [yellow background]{style=“background-color: #FFFF00”}. The databases where the login has [no access] will be listed in [gray] while the databases accessible for a login are black.

 

Access of a login to a database

To allow the access to a database select the database from the list and choose database as shown below.

The state and date of the privacy consent according to the General Data Protection Regulation is shown in dependence of the selected database.

Roles of a login in a database

Use the > and < buttons to add or remove roles for the login in the database (see below).

To see the detailed permissions of a role, select it in the list of [Available] roles and click on the button. A window as shown below will open listing all objects in the database the role has permissions for (see below).

As a database owner you can edit the permissions and role memberships with the and buttons. Please keep in mind that any change of the permissions may cause serious troubles and should only be used for testing and bug fixing. The final setting of the permissions should be performed by a proper update script of the database. For every action you will get the code that is to be included in an update script (see below).

 

Projects for a login in a database

Depending on the database you can edit the list of projects accessible for a login (see below). Projects are related to the module DiversityProjects. To get additional information about a project select it in the list and click on the button. 

Starting with database version 02.05.35 next to the projects with [full access]{style=“color: #008000; font-weight: bold”}, a second list provides projects with [Read Only] access (see image below). Use the and buttons to move projects between [Accessible]{style=“color: #008000; font-weight: bold”} and [Read Only]{style=“color: #808080; font-weight: bold”}. If a project is set on [Read Only] a user can still add annotations. Starting with version 4.3.219 a project as a whole can be locked with the restriction of access to read only. For more details see chapter Project administration.

To load additional projects click on the Load projects button. A window will open as shown below. Projects already in the database will be listed in [green], [missing projects in red]{style=“color: #FF0000”} (see below). Check all projects you need in your database and click the Start download button.

To see an overview of the users within a project select one of the project in either list and click on the corresponding button . A window as shown below will open listing all users and their roles with access to the selected project.

To add or remove a role for a login, select the corresponding field and choose or from the context menu (see below).

 

Settings of a login in a database

Depending on the database you can edit the settings of a login as shown below.

If you wish to use settings already defined for another login, click on the Search template button. A window (see below) will open where you can choose among the settings defined for logins in the database.

 

Overview for a login

If you want to see an overview of all permissions and project for a login, click on the button. A window as shown below will open. It lists all modules and their databases, the roles, accessible projects and read only projects for a login. 

To copy the permissions and projects of the current login to another login, select the login where the settings should be copied to from the list at the base of the window and click on the button to copy the settings for all databases or the button to copy the settings of the selected database into this login. 

 

Overview for a database

If you see an overview of all user and roles in a database, click on the button. A window a shown below will open. It lists all user, roles and projects in the database. 

To remove a user, select it in the list and click on the button. 

 

Correction of logins

If you select one of the databases, at the base a button may appear. This indicates that there are windows logins listed where the name of the login does not match the logins of the server. This may happen if e.g. a database was moved from one server to another. To correct this, click on the button. A list of deviating logins will be shown, that can be corrected automatically.

If logins with the same name but different server are found, one of them has to be deleted to make the correction possible. You will get a list where you can select those that should be removed.

Select the duplicate logins that should be removed and click OK.

To find users within the database that have no valid login, click on the button. A window as shown below will open, listing the users without a login. Select those that should be removed and click OK. This will include a removal from the collection managers.

 

Update

Update of database and client

If either the database or the client needs to be updated, the menu will show an additional entry: Update.

Database update

To update the database, choose Update -> Update database … from the menu. See chapter Database update for details.

Client update

To update the client, choose Update -> Update client … and download the lastest version of the client. ee chapter Update client for details.

Subsections of Update

Update Client



Update of the client software

Replace the files and folders of your installation of DiversityCollection with the files you received by e-mail or downloaded from the DiversityWorkbench portal. The database will not be influenced by this replacement. After starting the new software you need to transfer the settings of the previous version. When you start the program and connect to a database, the program will check if it is compatible with the database or if the database needs an update. In any of these cases an update entry in the menu will appear. If a new version of the client is available, this menu will contain an update client … entry. Click on it to open the webpage where you may download the client as shown below.

 

Update Database

Update database to current version

If you are the owner of the database (Database role = dbo) and the database needs to be updated, the menu will contain an update database … entry. Select this entry to open a window as shown below to run the provided update scripts, delivered with the client software. These scripts need to run consecutively, so e.g. to update from version 2.5.1 to 2.5.4 you either have to run the script DiversityCollectionUpdate_020501_To_020504 or the scripts DiversityCollectionUpdate_020501_To_020502, DiversityCollectionUpdate_020502_To_020503 and DiversityCollectionUpdate_020503_To_020504. The program will guide you through these steps and check for the scripts. All you need to do is click the Start update button. 

Update of all databases on a server

If you are database owner and have a windows login to the database server (user=dbo), you have the option to update all DiversityCollection databases on this server by starting the application with command line parameters. Open a command line window, navigate to the program directory and start DiversityCollection with the keyword “UpdateDatebase”, the server name (or IP address) and the port number:

DiversityCollection.exe UpdateDatabase 127.0.0.1 5432

The program will connect to the server and update all available databases to the current version. If you want to exclude dedicated databases from update, create a text file named “ExcludeDb.txt” that contains the excluded database names - each name in a separate line - and locate it in the resources directory. The update will be done in the background without opening a program window. When the update processing is finished, an overview of the performed actions will be written into the protocol file “Updatereport.log” in directory resources/Updates.

Errorlog

If any error messages show up while working with the application, you can find further details concerning the part of the application where the error occurred and the parameters involved in the file e.g. DiversityCollectionError.log in the Module DiversityCollection located in your resources directory.

To open the errorlog, choose Help - ErrorLog from the menu. A window will open showing the content of the errolog. By default the errorlog will at program start. You can keep the errorlog if needed by chossing Help - Errorlog - Keep error log from the menu. A button will appear that allows you to clear the error log manually: Help - Clear ErrorLog.

Module connections

Connections between the modules of the Diversity Workbench

The DiversityWorkbench is a set of components for building and managing biodiversity information, each of which focuses on a particular domain. DiversityAgents is referred by several modules. To scan for references from these modules on data in DiversityAgents choose Data - Scan modules - from the menu (see image below).

With these options the program will scan all sources of the selected module as listed in the connections for references to the current agent. After selecting an agent in the tree, the sources of the selected modules together with the linked data will be listed as shown below.

Select a link to see a summary of the linked data (see below).

To get further information about an item click on the button. If so far the path to the respective application has not been set, you will get a corresponding message (see below).

Click on the button to set the path to the application (see below).

By default the path to the application is C:\Program Files (x86)\DiversityWorkbench\Diversity...\Diversity.…exe as shown.

Resources

The resources directory is set via the menu (Administration - Resources).

There are 3 possibilities for the resources directory:

  • Select any directory you have read/write access (User defined)
  • Select the "Home" directory of the user
  • Select the "My Documents" directory of the user

The default is set to Home. This directory will contain all files the user need access to (see image below).

Certain directories are hidden (Query) and are handled by the software i.e. the content should not be changed by the user. The other folders are generated by the software if missing, e.g. Export for any exports (see below).