Entities, contexts, usage and languages

DiversityCollection may be used in diverse contexts like collection management, observations or field mapping. To ensure that a user working in a certain area will see the descriptions corresponding to his domain the DiversityWorkbench provides the possibility to define corresponding contexts.

To set the context and the language for the program choose Administration - Customize display ... from the menu. A window will open as shown below where you may select the language and the context which should be used. By default the language will be set according to the settings of your operating system, however, you may change it here. The default language within DiversityCollection is English. If you select a certain context, the tables in the lower part of the form will show you the special setting within this context. These settings are edited as described below.   

For the documentation of the tables used for the storage of the entity related data please see the section Entity tables.

To edit the entities choose Administration - Application description ... from the menu. A window will open as shown below where you may edit the entities defined for the program.

Group for the display of the entity

If in a user interface certain entities should be displayed in a group, enter the name of the group here. 

Usage

If nothing is defined for the usage of an entity, it will be handled according to the rights of the user. In certain context an entity may be set to e.g. read only, inapplicable or not used. In case of the later two possibilities the entity will not appear in the interface of the program. For example, transaction management (e.g. loan) will not be handled with a mobile device, thus the corresponding entities will be set to "not used". Use the [Insert new usage] button to insert a new usage for an entity. To edit the possible usages choose Administration - Usage ... from the menu.

• inapplicable: An entity which may not be applied in a certain context will not be shown in a user interface, e.g. the depositors accession number in the context observation. 
• preset: An entity will have a preset value, e.g. 'determination' for the identification category in the context observation.
• read only: An entity may not be changed.
• hidden: An entity should be hidden from the user interface.   

Context

The default context is General. Thus, in the beginning you will find all representations within this context. Within the representation, when a certain context is missing, the program will search for a representation in the parent context until a representation is found. To edit the context choose Administration - Context ... from the menu. A window will open as shown below where you may edit the context.

Representation

An entity may have differing representations in different contexts. For example a CollectionEvent may correspond to an observation or gathering in other contexts. Use the Entity and Representation menu to fill in missing entries. If an only if entity should receive a different title or description in the user interface, enter the values in the table. If nothing is defined in a certain context, the program will walk up the tree defined with the parent code (see the image above) to find available values for the title or description of the entity. The highest entry in the hierarchy is the context General with the language English. If you define deviating values for the display text, the abbreviation or the description, you must at least enter values in the highest entry (General, English) as a default value for all other entities. 

Language /font>