Diversity Sampling Plots

Scope of DiversitySamplingPlots within the Diversity Workbench

DiversitySamplingPlots is part of the database framework Diversity Workbench. Within this framework the application DiversitySamplingPlots is confined to the display of sampling plots in geographic areas. Any module within the Diversity Workbench is focused on a specific data domain. DiversitySamplingPlots keeps only data regarding sampling plots. Data of other realms like e.g. taxonomy are handled in separate modules.

DiversitySamplingPlots is based on Microsoft SQL-Server 2008 R2 and the .Net Framework, Version 4.8.

For licence and copyright see the licence section.

Diversity Workbench modules

Diversity sampling plots

Download

Upcoming version

4.5.2 (2023-10-??)

Inclusion of ExternalID for comparision in maintenance for links to DiversityScientificTerms

Current version

4.5.1 (2023-08-25)

Download

Inclusion of maintenance for links to DiversityScientificTerms
Inclusion of hierarchy of location properties
Show or hide query
Mainform shown as single dialog form

Previous versions

4.5 (2023-05-09)

Bugfixes in Workbench.dll
Bugfix for linked specimen and images from DiversityCollection

4.4.11 (2023-04-21)

Several bugfixes getting properties from databases
Improvements in error logging in WorkbenchUnit
Linked specimen and images from DiversityCollection
webBrowser replaced in:
- UserControlGeography
- UserControlGIS
Query
- Many order columns enabled
- Additional columns:
  - Plot type
  - Country
  - Property
  - Locality

Database updates

01.00.37: ViewLocality for query; SamplingPlotListForCurrentProject - add columns PlotType and CountryCache; ViewSamplingPlotListForCurrentProject - adding missing columns PlotType and CountryCache; Missing View ViewDiversityWorkbenchModule for linked server; Missing Grants; Missing Descriptions;

4.4.9

Transfer of selected projects
Bugfix hierarchy query
Bugfix LookupTable.cs
Menue - Transfer to project added

4.4.10

Table editors for:
- Plot
- Localisation
- Site
Spreadsheet for Plot

Tutorial

Tutorial - first steps

This tutorial will guide you through the first basic steps in DiversitySamplingPlots. After the installation, make sure, you have access to the database. To start the programm, double click on the DiversitySamplingPlots.exe in the directory where you copied the files of DiversitySamplingPlots. The main window will open.

If you open this window for the first time, you have to connect to the database. Click on the button or choose Connection -> Database… from the menu to open a window where you can enter your account information and choose the database (see image below, for further informations see databaseaccess).

After connecting to the server and choosing a database click on the OK button to return to the main form. As indicated by the symbol in the right upper corner, you are now connected to the database. The tooltip of the button will show your current login informations.

Tutorial Backlinks

Tutorial - module relations resp. backlinks

DiversityCollection

Message box To display dataset in the module DiversityCollection that are linked to the current plot, you can activate the query for these data in the menu Data - Scan modules - DiversityCollection (for the specimen) and Data - Scan modules - Images for the images. Please keep in mind that these backward query will increase the response time of the application.

Specimen

Message box All specimen within the DiversityCollection databases as listed in the connections and linked to the current plot will be listed as shown below.

Images

To show the images within a certain DiversityCollection database, linked to a plot, in the Message box images tab use the button to connect to the DiversityCollection database. Then all images will be listed as shown below.

Use the link beneath the image to show the image in a separate window. The EXIF tab contains the corresponding information of the image.

Tutorial Edit Plots

Tutorial - create or change plots

To create a new sampling plot click at the New icon of the tool bar. A Window will pop up and ask you to enter the identifier of the new plot.

The new plot will be created and shown on the screen.

Now you may edit the parameters and either add a geography of any kind using the GIS-Editor window or a certain point with WGS84 coordinates using the Localisation control.

For the usage of the GIS-Editor please see the Description in the second part of the help file. You may select an appropriate map style, navigate to your region of interrest by shiftig and zooming the map and create it as a background map by clicking the Add button. Then select Point, Line or Area mode and draw your geography on the background map. Add one or more geographies using the Add button. The geographies may be changed later on using the Editmode of the GIS-Editor. Finally save the geography to the database by clicking on the Save button of the GIS-Edit window ( not that of the Query toolbar!). A WGS84 localisation will be created automatically.

Alternatively you may create a WGS84 localisation using the New button in the Localisation tab below the GIS-Edit window. A dialog will pop up.

Select “Coord. WGS84” from the drop down list and then press the OK butten. The new localisation will be shown in the list of the Localisation tab.

Select the localisation in the list and click at the $Malta\nCross$ button. The coordinates window as known from other DiversityWorkbench modules will be shown.

Shift the map using the mouse to localise a certain coordinate point with the static cross in the center. Then press the OK button and the coordinate point will be shown in the WGS84 localisation tab.

Additionally an Altitude and a Named area localisation will be created automatically by calling the Geonames web service. Press the Save button of the Query toolbar to save the new localisation.

Tutorial Hierarchy

Tutorial - plot hierarchy

The plots may be hierarchical organised as a tree view. The location of the current plot within the hierarchy is displayed in the hierarchy window:

To add a new plot within the selected plot click on the $Message\nbox$ button.

To change to another plot within the hierarchy tree just select the plot in the tree view and click on the Message box button. The new plot will be displayed.

To set the superior plot for the current sampling plot click on the Message box button.

To remove the superior plot for the current sampling plot click on the Message box button.

Wizard Tutorial

Import wizard - tutorial

This tutorial demostrates the import of a small file into the database. The following data should be imported (the example file is included in the software): At the end of this tutorial you will have imported several datasets and practiced most of the possibilities provided by the import wizard. The import is done in 2 steps to demonstrate the attachment functionallity of the wizard.

Step1 - Import of the collection events

Choose Data -> Import -> Wizard Sampling plot … from the menu. A window as shown below will open. that will lead you through the import of the data. The window is separated in 3 areas. On the left side, you see a list of possible data related import steps according to the type of data you choosed for the import. On the right side you see the list of currently selected import steps. In the middle part the details of the selected import steps are shown.

Choosing the File

As a first step, choose the File from where the data should be imported. The currently supported format is tab-separated text. Than choose the Encoding of the file, e.g. Unicode. The Start line and End line will automatically be set according to your data. You may change these to restrict the data lines that should be imported. The not imported parts in the file are indicated as shown below with a gray background. If the First line contains the column definition this line will not be imported as well. If your data contains e.g. date information where notations differ between countries (e.g. 31.4.2013 - 4.31.2013), choose the Language / Country to ensure a correct interpretation of your data. Finally you can select a prepared Schema (see chapter Schema below) for the import.

Choosing the data ranges

In the selection list on the left side of the window (see below) all possible import steps for the data are listed according to the type of data you want to import.

Certain tables can be imported in parallel. To add parallels click on the button (see below). To remove parallels, use the button. Only selected ranges will appear in the list of the steps on the right (see below).

To import informations of logging columns like who created and changed the data, click on button in the header line. This will include a additional substeps for every step containing the logging columns (see below). If you do not import these data, they will be automatically filled by default values like the current time and user.

Attaching data

You can either import your data as new data or Attach them to data in the database. Select the import step Attachment from the list. All tables that are selected and contain columns at which you can attach data are listed (see below). Either choose the first option Import as new data or one of the columns the attachment columns offered like SeriesCode in the table Series in the example below.

If you select a column for attachment, this column will be marked with a blue backgroud (see below and chapter Table data).

Merging data

You can either import your data as new data or Merge them wih data in the database. Select the import step Merge from the list. For every table you can choose between Insert, Merge, Update and Attach (see below).

The Insert option will import the data from the file independent of existing data in the database.

The Merge option will compare the data from the file with those in the database according to the Key columns (see below). If no matching data are found in the database, the data from the file will be imported, otherwise the data will be updated..

The Update option will compare the data from the file with those in the database according to the Key columns. Only matching data found in the database will be updated.

The Attach option will compare the data from the file with those in the database according to the Key columns. The found data will not be changed, but used as a reference data in depending tables.

Table data

To set the source for the columns in the file, select the step of a table listed underneath the Merge step. All columns available for importing data will be listed in the central part of the window. In the example shown below, the first column is used to attach the new data to data in the database.

A reminder in the header line will show you what actions are still needed to import the data into the table:

Please select at least one column = No column has been selected so far.
Please select at least one decisive column = If data will be imported depends on the content of decisive colums, so at least one must be selected.
Please select the position in the file = The position in the file must be given if the data for a column should be taken from the file.
Please select at least one column for comparision = For all merge types other than insert columns for comparision with data in the database are needed.
From file or For all = For every you have to decide whether the data are taken from the file or a value is entered for all
Please select a value from the list = You have to select a value from the provided list
Please enter a value = You have to enter a value used for all datasets

The handling of the columns in described in the chapter columns.

Testing

To test if all requirements for the import are met use the Testing step. You can use a certain line in the file for you test and than click on the Test data in line: button. If there are still unmet requirements, these will be listed in a window as shown below.

If finally all requirements are met, the testing function will try to write the data into the database and display you any errors that occurred as shown below. All datasets marked with a red backgroud, produced some error.

To see the list of all errors, double click in the error list window in the header line (see below).

If finally no errors are left, your data are ready for import. The colors in the table nodes in the tree indicate the handling of the datasets: INSERT, MERGE, UPDATE, No difference. Attach, No data. The colors of the table colums indicate whether a colums is decisive , a key column or an attachment column.

Import

With the last step you can finally start to import the data into the database. If you want to repeat the import with the same settings and data of the same structure, you can save a schema of the current settings (see below).


Schedule for import of tab-separated text files into DiversityCollection
Target within DiversityCollection: Specimen
Schedule version:	1	Database version:	02.05.41
Lines:	2 - 3215	First line contains column definition:	?
Encoding:	Unicode	Language:	de

Tables

CollectionSpecimen (CollectionSpecimen)
Parent: CollectionEvent
Merge handling: Insert

Column in table	?	Key	Copy	Pre	Post	File pos.	Transformations	Value	Source	Table
CollectionSpecimenID									Database
AccessionNumber	?	?				0			File

IdentificationUnit_1 (IdentificationUnit)
Parent: CollectionSpecimen
Merge handling: Merge

Column in table	?	Key	File pos.	Value	Source
CollectionSpecimenID					Database
IdentificationUnitID					Database
LastIdentificationCache		?	2		File
+			3		File
+			4		File
+			5		File
TaxonomicGroup	?			fish	Interface

IdentificationUnitAnalysis_1_1 (IdentificationUnitAnalysis)
Parent: IdentificationUnit_1
Merge handling: Update

Column in table	?	Key	File pos.	Value	Source
CollectionSpecimenID					Database
IdentificationUnitID					Database
AnalysisID				94	Interface
AnalysisNumber				1	Interface
AnalysisResult	?	?	39		File

Lines that could not be imported will be marked with a red background while imported lines are marked green (see below).

If you want to save lines that produce errors during the import in a separate file, use the Save failed lines option. The protocol of the import will contain all settings acording to the used schema and an overview containing the number of inserted, updated, unchanged and failed lines (see below).

Tutorial Localisation

Tutorial - localisation

Different kinds of localisation may be assigned to the sampling plots:

To add a new localisation for the selected plot click at the $Message\nbox$ button. Select the desired kind of localisation from the drop down list and press the OK button.

Fill up the data fields in the right part of the window. Each kind of localisation can only be assigned once. The list will contain the remaining choices.

Some buttons are provided depending on the selected localisation:
Message box : Open a GoogleMaps window to select the coordinates.
: Convert coordinates to another coordinate system.
: Open an appropriate Diversity Workbench remote module.

To remove a localisation, select it and click at the $Message\nbox$ button. The localisation will disappear from the list.

Finally press the Message box item in the Query toolbar to store the localisation for the plot in the database.

Tutorial Maps

Tutorial - show plots on the maps

The results list box displays the current set of plots found by the database query. To show a certain plot on the map, just click at the entry. Due to the coordinates of the place the map will be adjusted to this area and build up. There are 3 choices how to display the plot: Message box Browser, GIS - View and GIS - Edit:

Message box Browser uses a GoogleMaps window and pins to show the geography of the plot, if any. This is rather fast and interactive, but there is currently no support of areas or line strings and no possibility to display more than one plot.

GIS - View uses the powerful GIS Editor tool of the Diversity Workbench, which can handle all kinds of geographies and display distribution maps of multiple plots. Depending on the internet connection and the map server it can take some seconds until the map tiles have been build. A message box will pop up to advice the user to wait, until the map is complete:

When all tiles of the background map are drawn, press OK to continue. Then the online map will be scanned and frozen and the plots should appear on the map:

Be aware that this mode is just a viewer of the GIS Editor’s geography objects. If multiple plots have been selected in the query list box, press the Message box reload button to display them. If you want a certain zoom level for the map, select the Use zoom level check box and adjust the desired level.

Message box GIS - Edit provides all controls and capabilities of the GIS Editor including editing the sample plot. Select a plot in the query list, then the map will be adjusted and a message box will pop up according to the GIS - View mode. Press OK to add the map and the plot to the sample list and display the geography:

Tutorial Properties

Tutorial - properties

Some kinds of properties may be assigned to the selected sampling plot.

To add a new property for the selected plot click at the $Message\nbox$ button. Select the desired kind of property from the drop down list and press OK.

Press the Message box button to open an appropriate Diversity Workbench remote module for the property data.

To remove a property, select it and click at the $Message\nbox$ button. The property will disappear from the list.

Finally press the Message box item in the Query toolbar to store the properties for the plot in the database.

Tutorial Query

Tutorial - query

To search for data in the database, use the query section in the left part of the window. To select the query conditions, click on the button in the top panel. A window as shown below will open.

With the Maximal number of results, you can limit the paket size that should be retrieved from the server. For a slow connection to the database server choose a low value (e.g. 100 as set by default).

Select the desired entries, e.g.:

Click OK to close the window. Your query conditions will look like the image below.

Within the query options you have several possibilities to specify your search restriction. Use the drop down button to change between the operators.

If the hierarchy operator Δ is selected, you may choose a desired hierarchy node by clicking at the drop down box on the right. Then a tree view of the current hierachy pops up, where you can select a given node with the mouse:

After all query conditions are set, click on the button to start the query. In the resultlist all plots will be displayed which matches your query and the selected maximal number of results.

Tutorial Query Results

Tutorial - query results

Pressing the Filter button will display all plots in the list box which matches the query conditions and the selected maximal number of results:

The kind of entries to be shown can be selected in the “order by” list box. They may be the plot identifiers, the plot descriptions or the plot hierarchy strings.

The data of the selected plot (identifier, description, ID, type, notes etc.) is displayed right of the query area. If a geography has been assigned, the place is shown on the map in the middle. The plot identifier is marked with yellow background, embedded in the hierarchy tree in the box below the map.

Tutorial Resources

Tutorial - resources

Resources (e.g. pictures) may be assigned to the selected sampling plot.

To add a new resource click at the Message box button. A browser will open where you can select and add the desired file.

Press the Message box button to open the DiversityAgents remote module, where you may select the responsible for the resource data. Annotations may be entered in the Notes field.

To remove a resource, select it and click at the $Message\nbox$ button. The resource will disappear from the list.

Finally press the Message box item in the Query toolbar to store the resource settings for the plot in the database.

Editing the data

Projects

Every plot can be assigned to any number of projects. To assign a plot to a project click on the button. To remove it from a project, select the project from the list and click on the button.

If there are projects, to which you have no access to, these will be listed in a separate list at the top as shown below.

Details upon the projects within the Diversity Workbench are stored in the database DiversityProjects. To edit the projects you need the application DiversityProjects.exe and access to the database DiversityProjects. If DiversityProjects is not available you can create a new project with the Administration - Projects … button.

Import Export

Fequently Asked Questions

Common
- How to link to data in DiversityCollection
  - see chapter Verknüpfte Datensätze und Bilder aus DiversityCollection and the video
    (Beispiel mit verknüpften Daten in DiversityCollection, Detaildarstellung von Datensatz, Bilder in DiversityCollection, Auswahl der Datenbank, mit Organismus verknüpfte Bilder zeigt zusätzlich Name des Taxon, Bild in separater Ansicht).
Wartung
- How to link to site properties from DST
  - see chapter Standorteigenschaften verknüpfen
  - and the video
    (Vorstellung der Beispieldaten in DSP und DST. Bearbeitung nicht verknüpfter Daten. Erläuterung der Optionen. Suche nach Daten mit übereinstimmenden Werten. Ansicht eines Einzeldatensatzes zur Kontrolle. Aktualisierung der Daten mittels Update. Neuabruf der Daten. Kontrolle im Hauptformular. Änderung der Hierarchie mittels Maintenance. Aufruf bereits verknüpfter Daten. Update der Hierarchie und Kontrolle im Hauptformular).

General

Overview of the menu in DiversitySamplingPlots:

Connection
- Database … Choose one of the databases available on the server. Only those databases will be listed to which the user has access
- Module connections … Edit the connections to the other modules within the Diversity Workbench.
- Transfer previous settings Transfer the settings for IP-Address and port of the server, name of the database, login etc. of a previous version of the client to the current version.
- Quit Quit the application and stop all processes started by the application
Data
- Backup database … Creating a backup of the currently connected database
- Import
  - Wizard Import data from tab-separated text files
  - Sampling plot … Import data into SamplingPlots database …
- Replication Synchronise the content of 2 databases
  - Add publisher … Define a publishing database
  - Database on Server List entry of an added publisher
  - Download … Download data from the data provider and server respectively in your local database
  - Merge … Merge data between the data provider and server respectively and your local database
  - Upload … Upload data from your local database to the replication provider and server respectively
  - Remove … Remove the replication publisher from the list
  - Clean database … Clean your local database
Administration
- Projects … Administration of the projects
- Database … Administration of the database
  - Logins … Administration of the users and their permissions in the database
  - Rename database … Rename the currently connected database
  - Set published DB address … Set the base URL address of the currently connected database
  - Documentation … Documentation of the structure of the database
  - Maintenance … Maintenance of the database
  - Database tools … Database tools
Update (Only visible, if a new version is available)
- Update database … Update to a new available database version
- Update client … Update to a new available client version
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

Internals

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

Feedback and Errors

Feedback

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

Click on the Insert image button to insert the screenshot and give a comment about your problem. Then click on the Sen feedback button to send your feedback to the administrator. If you want to receive a message, when the problem you described is solved, please enter your e-mail address in the field under the description.

To inspect your former feedbacks, choose $Feedback\nhistory$ Feedback history… from the menu. A window will open, where you can browse your old feedback together with the state of progress.

If you do not have access to the central database for the feedbacks, the program will open your mail client to send an e-mail. In case of bugs in the program it would help if you attach the file DiversitySamplingPlotsError.log located in your application directory (see below).

Error logging

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 DiversitySamplingPlotsError.log located in your application directory.

Maintenance Scientific Terms

To synchronize the entries with the module ScientificTerms choose Administration -> Database -> Maintenance from the menu. A window will open as shown below. On the tab page Synchonizing, you can synchronize the content in DiversitySamplingPlots with the linked resources or search for new links via text.

Linked data

To synchonize the content for linked data select the database, the project, the table and the target for which the entries should be synchronized. There are 2 targets for the synchronization: The term itself and the hierarchy. There is 1 table which may contain links to DiversityScientificTerms:

Site properties

To synchronize linked data start the query click on the Search for differences button. Terms with differing content will be listed as shown below.

To include the hierarchy in the comparision, check the Compare hierarchy option as well if the hierarchy derived from [DiversityScientificTerms ]should be from the option Top-> Detail or Detail -> Top . As shown below 2 more columns will be included, containing the hierarchies in DiversitySamplingPlots and DiversityScientificTerms.

Establish new links

To establish new connections for terms corresponding to terms in DiversityScientificTerms (see below) click on the Search for identical terms button. All matching terms will be listed. For comparision you may use the text (= default) or the external ID of the term.

As with the query for linked data, you may include the hierarchy. In addition there are two options to restrict the search: Restrict to terms like ... and Restrict to max. results ... . The option Include accession number will split the data according to the specimen as shown below. With this option set, you can inspect the content of single specimen in the list using the button (see below).

In the result list you can select the data that should be included in the update in the first column (OK ) by de/selection of single lines or with the buttons Select all resp. Select none. To update the database click on the [Start update] button.

Database

The database for DiversitySamplingPlots is based on Microsoft SQL-Server 2014 or higher.

Organisation of the data

The central table of the database is SamplingPlot. The image below shows the main tables of the database.

Further details: tables, views, …

Diversity SamplingPlots

TABLES, VIEWS, FUNCTIONS, PROCEDURES, ROLES

The following objects are not included:

Logging tables

Enumeration tables

System objects

Objects marked as obsolete

Previous versions of objects

TABLES

Table LocalisationSystem

The geographic localisation systems, e.g. coordinates

Column	Data type	Description	Nullable	Relation
LocalisationSystemID	int	Unique ID for the localisation system (= Primary key)	NO	-
LocalisationSystemParentID	int	LocalisationSystemID of the superior LocalisationSystem	YES	Refers to table LocalisationSystem
LocalisationSystemName	nvarchar (100)	Name of the system used for the determination of the place of the collection, e. g. Gauss-Krüger, MTB, GIS	NO	-
DefaultAccuracyOfLocalisation	nvarchar (50)	The default for the accuracy of values that can be reached with this method	YES	-
DefaultMeasurementUnit	nvarchar (50)	The default measurement unit for the localisation system, e.g. m, geograpic coordinates	YES	-
ParsingMethodName	nvarchar (50)	Internal value, specifying a programming method used for parsing text in fields Location1/Location2 in table SamplingPlotLocalisation	YES	-
DisplayText	nvarchar (50)	Short abbreviated description of the localisation system as displayed in the user interface	YES	-
DisplayEnable	bit	Specifies if this item is enabled to be used within the database. LocalisationSystems can be disabled to avoid seeing them, but to keep the definition for the future.	YES	-
DisplayOrder	smallint	The order in which the entries are displayed. The order may be changed at any time, but all values must be unique.	YES	-
Description	nvarchar (255)	Description of the localisation method	YES	-
DisplayTextLocation1	nvarchar (50)	Short abbreviated description of the attribute Location1 in the table CollectionGeography as displayed in the user interface	YES	-
DescriptionLocation1	nvarchar (255)	Description of the attribute Location1 in the table CollectionGeography as displayed in the user interface	YES	-
DisplayTextLocation2	nvarchar (50)	Short abbreviated description of the attribute Location2 in the table CollectionGeography as displayed in the user interface	YES	-
DescriptionLocation2	nvarchar (255)	Description of the attribute Location2 in the table CollectionGeography as displayed in the user interface	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	NO	-
LogCreatedBy	nvarchar (50)	Name of user who first entered (typed or imported) the data.Default value: user_name()	YES	-
LogCreatedWhen	datetime	Date and time when the data were first entered (typed or imported) into this database.Default value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Name of user who last updated the data.Default value: user_name()	YES	-
LogUpdatedWhen	datetime	Date and time when the data were last updated.Default value: getdate()	YES	-

Table ProjectUser

The projects a user has access to

Column	Data type	Description	Nullable	Relation
LoginName	nvarchar (50)	The login of the user	NO	-
ProjectID	int	The ID of the project the user has access to	NO	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	YES	-

Table Property

Properties of the site of the sampling plot as stored in DiversityScientificTerms

Column	Data type	Description	Nullable	Relation
PropertyID	int	The ID of the sampling property, Primary key	NO	-
PropertyParentID	int	LocalisationSystemID of the superior LocalisationSystem	YES	Refers to table Property
PropertyName	nvarchar (100)	Name of the system used for the determination of the place of the collection, e. g. Gauss-Krüger, MTB, GIS	NO	-
DefaultAccuracyOfProperty	nvarchar (50)	The default for the accuracy of values that can be reached with this method	YES	-
DefaultMeasurementUnit	nvarchar (50)	The default measurement unit for measured properties	YES	-
ParsingMethodName	nvarchar (50)	Internal value, specifying a programming method used for parsing text in fields Location1/Location2 in table CollectionLocalisation	NO	-
DisplayText	nvarchar (50)	Short abbreviated description of the localisation system as displayed in the user interface	YES	-
DisplayEnabled	bit	Specifies if this item is enabled to be used within the database. LocalisationSystems can be disabled to avoid seeing them, but to keep the definition for the future.	YES	-
DisplayOrder	smallint	The order in which the entries are displayed. The order may be changed at any time, but all values must be unique.	YES	-
Description	nvarchar (255)	Description of the localisation method	YES	-
LogCreatedBy	nvarchar (50)	Name of user who first entered (typed or imported) the data.Default value: user_name()	YES	-
LogCreatedWhen	smalldatetime	Date and time when the data were first entered (typed or imported) into this database.Default value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Name of user who last updated the data.Default value: user_name()	YES	-
LogUpdatedWhen	smalldatetime	Date and time when the data were last updated.Default value: getdate()	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	YES	-
PropertyURI	varchar (1000)	The link to the entry in a DiversityScientificTerms database	YES	-

Table ReplicationPublisher

For data replication - the links to publishers

Column	Data type	Description	Nullable	Relation
DatabaseName	varchar (255)	The name of the publishing database	NO	-
Server	varchar (255)	The name or address of the server where the publishing database is located	NO	-
Port	smallint	The port used by the server	YES	-
LogCreatedWhen	datetime	Point in time when this data set was createdDefault value: getdate()	YES	-
LogCreatedBy	nvarchar (50)	Name of the creator of this data setDefault value: user_name()	YES	-
LogUpdatedWhen	datetime	Point in time when this data set was updated lastDefault value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Name of the person to update this data set lastDefault value: user_name()	YES	-

Table SamplingPlot

A sampling plot with its geographical position and geometry

Column	Data type	Description	Nullable	Relation
PlotID	int	The ID of the sampling plot, Primary key	NO	-
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key	YES	Refers to table SamplingPlot
PlotIdentifier	nvarchar (500)	The identifier or name of the plot	NO	-
PlotGeography_Cache	geography	The cached geography of the plot as geographical entry, e.g. as a polygon derived from the geography in table SamplingPlotPoints	YES	-
PlotGeometry_Cache	geometry (MAX)	The cached geometry of a sampling plot, e.g. as a polygon derived from the geometry in table SamplingPlotPoints	YES	-
PlotDescription	nvarchar (MAX)	A short text, describing the sampling plot	YES	-
InternalNotes	nvarchar (MAX)	Internal notes regarding the sampling plot, not published on the web	YES	-
LogCreatedWhen	datetime	The time when this dataset was createdDefault value: getdate()	YES	-
LogCreatedBy	nvarchar (50)	Who created this datasetDefault value: user_name()	YES	-
LogUpdatedWhen	datetime	The last time when this dataset was updatedDefault value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Who was the last to update this datasetDefault value: user_name()	YES	-
PlotType	nvarchar (50)	The type of the plot, e.g. trap	YES	-
CountryCache	nvarchar (50)	The country where the collection sampling plot is located. Cached value derived from an entry in SamplingPlotLocalisation	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	NO	-

Table SamplingPlotLocalisation

The geographic localisation of a sampling plot

Column	Data type	Description	Nullable	Relation
PlotID	int	Refers to the ID of SamplingPlot (= Foreign key and part of primary key)	NO	Refers to table SamplingPlot
LocalisationSystemID	int	Refers to the ID of LocalisationSystem (= Foreign key and part of primary key)	NO	Refers to table LocalisationSystem
Location1	nvarchar (255)	Either a named location selected from a thesaurus (e. g. ‘Germany, Bavaria, Kleindingharting’) or altitude range or other values (e. g. 100-200 m)	YES	-
Location2	nvarchar (255)	Corresponding value to Location1 e.g. ID or URI of gazetteer or thesaurus	YES	-
LocationAccuracy	nvarchar (50)	The accuracy of the determination of this locality	YES	-
LocationNotes	nvarchar (MAX)	Notes on the location	YES	-
DeterminationDate	smalldatetime	Date of the determination of the geographical localisation	YES	-
DistanceToLocation	varchar (50)	Distance from the specified place to the real location of the sampling plot (m)	YES	-
DirectionToLocation	varchar (50)	Direction from the specified place to the real location of the sampling plot (Degrees rel. to north)	YES	-
ResponsibleName	nvarchar (255)	The name of the agent (person or organization) responsible for this entry.	YES	-
ResponsibleAgentURI	varchar (255)	URI of the person or organisation responsible for the data (see e.g. module DiversityAgents)	YES	-
Geography	geography	The geography of the localisation	YES	-
AverageAltitudeCache	float	Calculated altitude as parsed from the location fields	YES	-
AverageLatitudeCache	float	Calculated latitude as parsed from the location fields	YES	-
AverageLongitudeCache	float	Calculated longitude as parsed from the location fields	YES	-
LogCreatedWhen	datetime	The time when this dataset was createdDefault value: getdate()	YES	-
LogCreatedBy	nvarchar (50)	Who created this datasetDefault value: user_name()	YES	-
LogUpdatedWhen	datetime	The last time when this dataset was updatedDefault value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Who was the last to update this datasetDefault value: user_name()	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	NO	-

Depending on:

LocalisationSystem
SamplingPlot

trgInsSamplingPlotLocalisation

Table SamplingPlotProperty

Properties of the site of a sampling plot

Column	Data type	Description	Nullable	Relation
PlotID	int	The ID of the sampling plot, foreign key and part of primary key	NO	Refers to table SamplingPlot
PropertyID	int	ID of the property to which the sampling plot property belongs	NO	Refers to table Property
PropertyURI	varchar (255)	URI referring to an external datasource e.g. DiversityTerminology	NO	-
DisplayText	nvarchar (255)	The text for the property as shown e.g. in a user interface	YES	-
PropertyHierarchyCache	nvarchar (MAX)	A cached text of the complete name of the descriptor including superior categories if present	YES	-
PropertyValue	nvarchar (255)	The value of a captured feature e.g. temperature, pH, vegetation etc. If there is a range this is the lower or first value	YES	-
ResponsibleName	nvarchar (255)	The name of the agent (person or organization) responsible for this entry.	YES	-
ResponsibleAgentURI	varchar (255)	URI of the person or organisation responsible for the data (see e.g. module DiversityAgents)	YES	-
Notes	nvarchar (MAX)	Notes about the property of the colletion site.	YES	-
AverageValueCache	float	For numeric values - a cached average value according to the	YES	-
LogCreatedWhen	datetime	The time when this dataset was createdDefault value: getdate()	YES	-
LogCreatedBy	nvarchar (50)	Who created this datasetDefault value: user_name()	YES	-
LogUpdatedWhen	datetime	The last time when this dataset was updatedDefault value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Who was the last to update this datasetDefault value: user_name()	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	YES	-

Depending on:

Property
SamplingPlot

Table SamplingPlotResource

Resouces of the sampling plot, e.g. images

Column	Data type	Description	Nullable	Relation
PlotID	int	The ID of the sampling plot, foreign key and part of primary key	NO	Refers to table SamplingPlot
ResourceURI	varchar (255)	URI referring to the file or link of the resource	NO	-
ResponsibleName	nvarchar (255)	The name of the agent (person or organization) responsible for this entry.	YES	-
ResponsibleAgentURI	varchar (255)	URI of the person or organisation responsible for the data (see e.g. module DiversityAgents)	YES	-
Notes	nvarchar (MAX)	Notes about the resource.	YES	-
LogCreatedWhen	datetime	The time when this dataset was createdDefault value: getdate()	YES	-
LogCreatedBy	nvarchar (50)	Who created this datasetDefault value: user_name()	YES	-
LogUpdatedWhen	datetime	The last time when this dataset was updatedDefault value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Who was the last to update this datasetDefault value: user_name()	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	YES	-

Depending on:

SamplingPlot

Table SamplingProject

The projects to which a sampling plot is related

Column	Data type	Description	Nullable	Relation
PlotID	int	The ID of the sampling plot, foreign key and part of primary key	NO	Refers to table SamplingPlot
ProjectID	int	ID of the project to which the sampling plot belongs (Projects are defined in DiversityProjects)	NO	-
LogCreatedWhen	datetime	The time when this dataset was createdDefault value: getdate()	YES	-
LogCreatedBy	nvarchar (50)	Who created this datasetDefault value: user_name()	YES	-
LogUpdatedWhen	datetime	The last time when this dataset was updatedDefault value: getdate()	YES	-
LogUpdatedBy	nvarchar (50)	Who was the last to update this datasetDefault value: user_name()	YES	-
RowGUID	uniqueidentifier	-Default value: newsequentialid()	NO	-

Depending on:

SamplingPlot

VIEWS

View PlotID_UserAvailable

IDs of the plots a user has access to

Column	Data type	Description	Nullable
PlotID	int	The ID of the sampling plot, Primary key	NO

Depending on:

ProjectUser
SamplingPlot
SamplingProject

View ProjectList

The list of the projects a user has access to

Column	Data type	Description	Nullable
Project	nvarchar (50)	The name or title of the project as shown in a user interface (Projects are defined in DiversityProjects)	YES
ProjectID	int	ID of the project to which the specimen belongs (Projects are defined in DiversityProjects)	NO

Depending on:

ProjectProxy
ProjectUser

View SamplingPlotGeoInfo

Geographical properties of a plot extracted from column PlotGeography_Cache including up to 4 hierarchy levels

Column	Data type	Description	Nullable
Latitude	float	Latitude of the center of the plot	YES
Longitude	float	Longitude of the center of the plot	YES
Accuracy angle	varchar (32)	maximum angle between the center and the circumference as string	YES
AccuracyAngle	float	maximum angle between the center and the circumference as numeric value	YES
AreaM2	float	Area in square meters	YES
Area	varchar (34)	Area including unit	YES
Geography	nvarchar (MAX)	Geography of the plot or a parent plot	YES
CountryCache	nvarchar (50)	The country where the collection sampling plot is located. Cached value derived from an entry in SamplingPlotLocalisation	YES
PlotID	int	The ID of the sampling plot, Primary key	NO

Depending on:

SamplingPlot

View ViewBaseURL

Providing the BaseURL for linked servers

Column	Data type	Description	Nullable
BaseURL	varchar (255)	Content of function BaseURL	YES

Depending on:

BaseURL

View ViewDiversityWorkbenchModule

Provides the name of the DiversityWorkbench module as defined in function DiversityWorkbenchModule

Column	Data type	Description	Nullable
DiversityWorkbenchModule	nvarchar (50)	The name of the DiversityWorkbench module	YES

Depending on:

DiversityWorkbenchModule

View ViewLocality

Gazetteer data for query

Column	Data type	Description	Nullable
PlotID	int	Refers to the ID of SamplingPlot (= Foreign key and part of primary key)	NO
Locality	nvarchar (255)	Content of column Location1	YES

Depending on:

LocalisationSystem
SamplingPlotLocalisation

View ViewSamplingPlot

Providing the content of table SamplingPlot for linked servers with conversion of geography tables to text

Column	Data type	Description	Nullable
PlotID	int	The ID of the sampling plot, Primary key	NO
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key	YES
PlotIdentifier	nvarchar (500)	The identifier or name of the plot	NO
PlotGeography_Cache	nvarchar (MAX)	The cached geography of the plot as geographical entry, e.g. as a polygon derived from the geography in table SamplingPlotPoints	YES
PlotGeometry_Cache	nvarchar (MAX)	The cached geometry of a sampling plot, e.g. as a polygon derived from the geometry in table SamplingPlotPoints	YES
PlotDescription	nvarchar (MAX)	A short text, describing the sampling plot	YES
InternalNotes	nvarchar (MAX)	Internal notes regarding the sampling plot, not published on the web	YES
CountryCache	nvarchar (50)	The country where the collection sampling plot is located. Cached value derived from an entry in SamplingPlotLocalisation	YES
PlotType	nvarchar (50)	The type of the plot, e.g. trap	YES

Depending on:

SamplingPlot

View ViewSamplingPlotAllLocalisations

Providing the result of SamplingPlotAllLocalisations for linked servers

Column	Data type	Description	Nullable
PlotID	int	The ID of the sampling plot, Primary key	NO
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key	YES
LocalisationSystemID	int	Unique ID for the localisation system (= Primary key)	NO
Location1	nvarchar (255)	Either a named location selected from a thesaurus (e. g. ‘Germany, Bavaria, Kleindingharting’) or altitude range or other values (e. g. 100-200 m)	YES
Location2	nvarchar (255)	Corresponding value to Location1 e.g. ID or URI of gazetteer or thesaurus	YES
DisplayText	nvarchar (255)	Short abbreviated description of the localisation system as displayed in the user interface	YES

Depending on:

SamplingPlotAllLocalisations

View ViewSamplingPlotGeoInfo

Providing the result of SamplingPlotGeoInfo for linked servers

Column	Data type	Description	Nullable
Latitude	float	Latitude of the center of the plot	YES
Longitude	float	Longitude of the center of the plot	YES
Accuracy angle	varchar (32)	maximum angle between the center and the circumference as string	YES
AccuracyAngle	float	maximum angle between the center and the circumference as numeric value	YES
AreaM2	float	Area in square meters	YES
Area	varchar (34)	Area including unit	YES
Geography	nvarchar (MAX)	Geography of the plot or a parent plot	YES
CountryCache	nvarchar (50)	The country where the collection sampling plot is located. Cached value derived from an entry in SamplingPlotLocalisation	YES
PlotID	int	The ID of the sampling plot, Primary key	NO
URL	varchar (285)	URL as retrieved from BaseURL + PlotID	YES

Depending on:

SamplingPlot
ViewBaseURL

View ViewSamplingPlotHierarchy5

Basic for for ViewSamplingPlotHierarchy

Column	Data type	Description	Nullable
PlotID	int	The ID of the sampling plot, Primary key	NO
DisplayText	nvarchar (3015)	-	NO

Depending on:

SamplingPlot

View ViewSamplingPlotList

Providing the result of SamplingPlotList for linked servers

Column	Data type	Description	Nullable
PlotID	int	The ID of the sampling plot, Primary key	NO
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key	YES
PlotIdentifier	nvarchar (500)	The identifier or name of the plot	NO
PlotGeography_Cache	nvarchar (MAX)	The cached geography of the plot as geographical entry, e.g. as a polygon derived from the geography in table SamplingPlotPoints	YES
PlotGeometry_Cache	nvarchar (MAX)	The cached geometry of a sampling plot, e.g. as a polygon derived from the geometry in table SamplingPlotPoints	YES
PlotDescription	nvarchar (MAX)	A short text, describing the sampling plot	YES
InternalNotes	nvarchar (MAX)	Internal notes regarding the sampling plot, not published on the web	YES
DisplayText	nvarchar (MAX)	The combined Identifiers of the whole hierarchy related to a plot	NO

Depending on:

SamplingPlotList

View ViewSamplingPlotListForCurrentProject

Providing the result of SamplingPlotListForCurrentProject for linked servers

Column	Data type	Description	Nullable
PlotID	int	The ID of the sampling plot, Primary key	NO
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key	YES
PlotIdentifier	nvarchar (500)	The identifier or name of the plot	NO
PlotGeography_Cache	nvarchar (MAX)	The cached geography of the plot as geographical entry, e.g. as a polygon derived from the geography in table SamplingPlotPoints	YES
PlotGeometry_Cache	nvarchar (MAX)	The cached geometry of a sampling plot, e.g. as a polygon derived from the geometry in table SamplingPlotPoints	YES
PlotDescription	nvarchar (MAX)	A short text, describing the sampling plot	YES
InternalNotes	nvarchar (MAX)	Internal notes regarding the sampling plot, not published on the web	YES
DisplayText	nvarchar (MAX)	The combined Identifiers of the whole hierarchy related to a plot	NO
PlotType	nvarchar (50)	The type of the plot, e.g. trap	YES
CountryCache	nvarchar (50)	The country where the collection sampling plot is located. Cached value derived from an entry in SamplingPlotLocalisation	YES
ProjectID	int	The ID of the project the user has access to	NO

Depending on:

SamplingPlotListForCurrentProject

View ViewTest

Column	Data type	Description	Nullable
spid	smallint	-	NO
ecid	smallint	-	NO
status	nchar (30)	-	NO
loginame	nvarchar (128)	-	YES
hostname	nchar (128)	-	NO
blk	char (5)	-	YES
dbname	nvarchar (128)	-	YES
cmd	nchar (16)	-	NO
request_id	int	-	NO

FUNCTIONS

Function BaseURL

Provides the basic address for accessing the database

DataType: varchar (255)

Function DefaultProjectID

The ID of the current project selected by a user or first project available

DataType: int

Depending on:

ProjectUser
UserProxy

Function DiversityWorkbenchModule

The name of the module within the DWB

DataType: nvarchar (50)

Function PrivacyConsentInfo

The website providing information concerning the privacy consent

DataType: varchar (900)

Function SamplingPlotAllLocalisations

Returns a table that lists all the localisations of a plot included those inherited from a parent plot

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
LocalisationSystemID	int	Unique ID for the localisation system (= Primary key)
Location1	nvarchar (255)	Either a named location selected from a thesaurus (e. g. ‘Germany, Bavaria, Kleindingharting’) or altitude range or other values (e. g. 100-200 m)
Location2	nvarchar (255)	Corresponding value to Location1 e.g. ID or URI of gazetteer or thesaurus
DisplayText	nvarchar (255)	Short abbreviated description of the localisation system as displayed in the user interface

Depending on:

LocalisationSystem
SamplingPlot
SamplingPlotLocalisation

Function SamplingPlotAllProperties

Returns a table that lists all the properties of a plot included those inherited from a parent plot

Column	DataType	Description
PropertyID	int	ID of the property to which the sampling plot property belongs
PlotID	int	The ID of the sampling plot, Primary key
PropertyURI	varchar (255)	URI referring to an external datasource e.g. DiversityTerminology
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
DisplayText	nvarchar (255)	The text for the property as shown e.g. in a user interface
PropertyHierarchyCache	nvarchar (MAX)	A cached text of the complete name of the descriptor including superior categories if present

Depending on:

SamplingPlot
SamplingPlotProperty

Function SamplingPlotChildNodes

Returns a result set that lists all the items within a hierarchy starting at the topmost item related to the given item.

Parameter	DataType	Description
@ID	int	PlotID for which the children should be returned

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
PlotIdentifier	nvarchar (500)	The identifier or name of the plot

Depending on:

SamplingPlot

Function SamplingPlotGeography

Returns a table that lists all plots togeher with the geography possibly derived from the parent plot.

Parameter	DataType	Description
@PlotIDs	varchar (8000)	List of comma separated PlotIDs for which the geography should be returned

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
Geography	geography (MAX)	Content of column PlotGeography_Cache if available within the hierarchy

Depending on:

SamplingPlot

Function SamplingPlotHierarchy

Returns a table that lists all the plots related to the given plot

Parameter	DataType	Description
@PlotID	int	The ID of the sampling plot, Primary key

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
PlotIdentifier	nvarchar (500)	The identifier or name of the plot

Depending on:

SamplingPlot
SamplingPlotChildNodes

Function SamplingPlotList

Returns a table that lists all the SamplingPlot items related to the given SamplingPlot.

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
PlotIdentifier	nvarchar (500)	The identifier or name of the plot
PlotGeography_Cache	geography (MAX)	The cached geography of the plot as geographical entry, e.g. as a polygon derived from the geography in table SamplingPlotPoints
PlotGeometry_Cache	geometry (MAX)	The cached geometry of a sampling plot, e.g. as a polygon derived from the geometry in table SamplingPlotPoints
PlotDescription	nvarchar (MAX)	A short text, describing the sampling plot
InternalNotes	nvarchar (MAX)	Internal notes regarding the sampling plot, not published on the web
DisplayText	nvarchar (MAX)	The combined Identifiers of the whole hierarchy related to a plot

Depending on:

SamplingPlot

Function SamplingPlotListForCurrentProject

Returns a table that lists all the SamplingPlot items related to the given project.

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
PlotIdentifier	nvarchar (500)	The identifier or name of the plot
PlotGeography_Cache	geography (MAX)	The cached geography of the plot as geographical entry, e.g. as a polygon derived from the geography in table SamplingPlotPoints
PlotGeometry_Cache	geometry (MAX)	The cached geometry of a sampling plot, e.g. as a polygon derived from the geometry in table SamplingPlotPoints
PlotDescription	nvarchar (MAX)	A short text, describing the sampling plot
InternalNotes	nvarchar (MAX)	Internal notes regarding the sampling plot, not published on the web
DisplayText	nvarchar (MAX)	The combined Identifiers of the whole hierarchy related to a plot
PlotType	nvarchar (50)	The type of the plot, e.g. trap
CountryCache	nvarchar (50)	The country where the collection sampling plot is located. Cached value derived from an entry in SamplingPlotLocalisation
ProjectID	int	The ID of the project the user has access to

Depending on:

DefaultProjectID
ProjectList
SamplingPlot
SamplingProject

Function SamplingPlotSuperiorNodes

Returns a table that lists all the plots related to the given plot

Parameter	DataType	Description
@PlotID	int	The ID of the sampling plot, Primary key

Column	DataType	Description
PlotID	int	The ID of the sampling plot, Primary key
PartOfPlotID	int	The ID of the plot of which the current plot is a part of, Foreign key
PlotIdentifier	nvarchar (500)	The identifier or name of the plot
PlotHierarchyCache	nvarchar (4000)	The combined Identifiers of the whole hierarchy related to a plot

Depending on:

SamplingPlot

Function UserID

ID of the User as stored in table UserProxy

DataType: int

Depending on:

UserProxy

Function UserName

Name of the User as stored in table UserProxy

DataType: nvarchar (50)

Parameter	DataType	Description
@ID	varchar (10)	ID of the user

Depending on:

UserProxy

Function Version

The version of the database

DataType: nvarchar (8)

Function VersionClient

The version of the client compatible with the database

DataType: nvarchar (11)

PROCEDURES

Procedure procGetSiteProperties

Depending on:

SamplingPlot
SamplingPlotProperty

Procedure procInsertSamplingPlotCopy

Creation of a copy of a dataset in table SamplingProject including the content in depending tables

Parameter	DataType	Description
@PlotID	int	The ID of the sampling plot, Primary key
@OriginalPlotID	int	The ID of the original plot
@PlotIdentifier	nvarchar (50)	reserved for future, not used in current version

Depending on:

SamplingPlot
SamplingPlotLocalisation
SamplingPlotProperty
SamplingPlotResource
SamplingProject

Procedure ProcSamplingPlotLocalisationAll

Depending on:

LocalisationSystem
SamplingPlot
SamplingPlotLocalisation

Procedure SetUserProjects

Create database user and assign training projects

Parameter	DataType	Description
@User	varchar (50)	database user to assign training projects for

Depending on:

UserProxy

ROLES

Role DataManager

Permissions as Editor but with permission to delete data in table SamplingPlot

Permissions	SELECT	INSERT	UPDATE	DELETE	EXECUTE	Type
LocalisationSystem	Diversity Workbench User					TABLE
LocalisationSystem_log						TABLE
ProjectUser	Diversity Workbench User					TABLE
Property	Diversity Workbench Editor					TABLE
Property_log						TABLE
ReplicationPublisher	Diversity Workbench Editor					TABLE
SamplingPlot	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor	•		TABLE
SamplingPlot_log						TABLE
SamplingPlotLocalisation	Diversity Workbench User	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor		TABLE
SamplingPlotLocalisation_log	Diversity Workbench Editor	Diversity Workbench Editor				TABLE
SamplingPlotProperty	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor		TABLE
SamplingPlotProperty_log	Diversity Workbench Editor	Diversity Workbench Editor				TABLE
SamplingPlotResource	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor		TABLE
SamplingPlotResource_log						TABLE
SamplingProject	Diversity Workbench User	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor		TABLE
SamplingProject_log	Diversity Workbench Editor	Diversity Workbench Editor				TABLE
PlotID_UserAvailable	Diversity Workbench User					VIEW
ProjectList	Diversity Workbench User					VIEW
SamplingPlotGeoInfo	Diversity Workbench User					VIEW
ViewBaseURL	Diversity Workbench User					VIEW
ViewDiversityWorkbenchModule	Diversity Workbench User					VIEW
ViewLocality	Diversity Workbench User					VIEW
ViewSamplingPlot	Diversity Workbench User					VIEW
ViewSamplingPlotAllLocalisations	Diversity Workbench User					VIEW
ViewSamplingPlotGeoInfo	Diversity Workbench User					VIEW
ViewSamplingPlotHierarchy5	Diversity Workbench User					VIEW
ViewSamplingPlotList	Diversity Workbench User					VIEW
ViewSamplingPlotListForCurrentProject	Diversity Workbench User					VIEW
ViewTest						VIEW
BaseURL					Diversity Workbench User	FUNCTION
DefaultProjectID					Diversity Workbench User	FUNCTION
DiversityWorkbenchModule					Diversity Workbench User	FUNCTION
PrivacyConsentInfo					Diversity Workbench User	FUNCTION
SamplingPlotAllLocalisations	Diversity Workbench User					FUNCTION
SamplingPlotAllProperties	Diversity Workbench Editor					FUNCTION
SamplingPlotChildNodes	Diversity Workbench User					FUNCTION
SamplingPlotGeography	Diversity Workbench User					FUNCTION
SamplingPlotHierarchy	Diversity Workbench User					FUNCTION
SamplingPlotList	Diversity Workbench User					FUNCTION
SamplingPlotListForCurrentProject	Diversity Workbench User					FUNCTION
SamplingPlotSuperiorNodes	Diversity Workbench User					FUNCTION
UserID					Diversity Workbench User	FUNCTION
UserName					Diversity Workbench User	FUNCTION
Version					Diversity Workbench User	FUNCTION
VersionClient					Diversity Workbench User	FUNCTION
procGetSiteProperties						PROCEDURE
procInsertSamplingPlotCopy					Diversity Workbench Editor	PROCEDURE
ProcSamplingPlotLocalisationAll						PROCEDURE
SetUserProjects						PROCEDURE
Inheriting from roles:

DiversityWorkbenchEditor

Role DiversityWorkbenchAdministrator

Role with full permission to the content

Permissions	SELECT	INSERT	UPDATE	DELETE	EXECUTE	Type
LocalisationSystem	Diversity Workbench User					TABLE
LocalisationSystem_log	•	•				TABLE
ProjectUser	•	•		•		TABLE
Property	Diversity Workbench Editor	•	•	•		TABLE
Property_log	•	•				TABLE
ReplicationPublisher	•	•	•	•		TABLE
SamplingPlot	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor	•		TABLE
SamplingPlot_log						TABLE
SamplingPlotLocalisation	Diversity Workbench User	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor		TABLE
SamplingPlotLocalisation_log	Diversity Workbench Editor	Diversity Workbench Editor				TABLE
SamplingPlotProperty	Diversity Workbench Editor	•	•	•		TABLE
SamplingPlotProperty_log	Diversity Workbench Editor	Diversity Workbench Editor				TABLE
SamplingPlotResource	Diversity Workbench Editor	•	•	•		TABLE
SamplingPlotResource_log						TABLE
SamplingProject	Diversity Workbench User	Diversity Workbench Editor	Diversity Workbench Editor	Diversity Workbench Editor		TABLE
SamplingProject_log	Diversity Workbench Editor	Diversity Workbench Editor				TABLE
PlotID_UserAvailable	Diversity Workbench User					VIEW
ProjectList	Diversity Workbench User					VIEW
SamplingPlotGeoInfo	Diversity Workbench User					VIEW
ViewBaseURL	Diversity Workbench User					VIEW
ViewDiversityWorkbenchModule	Diversity Workbench User					VIEW
ViewLocality	Diversity Workbench User					VIEW
ViewSamplingPlot	Diversity Workbench User					VIEW
ViewSamplingPlotAllLocalisations	Diversity Workbench User					VIEW
ViewSamplingPlotGeoInfo	Diversity Workbench User					VIEW
ViewSamplingPlotHierarchy5	Diversity Workbench User					VIEW
ViewSamplingPlotList	Diversity Workbench User					VIEW
ViewSamplingPlotListForCurrentProject	Diversity Workbench User					VIEW
ViewTest						VIEW
BaseURL					Diversity Workbench User	FUNCTION
DefaultProjectID					Diversity Workbench User	FUNCTION
DiversityWorkbenchModule					Diversity Workbench User	FUNCTION
PrivacyConsentInfo					Diversity Workbench User	FUNCTION
SamplingPlotAllLocalisations	Diversity Workbench User					FUNCTION
SamplingPlotAllProperties	Diversity Workbench Editor					FUNCTION
SamplingPlotChildNodes	Diversity Workbench User					FUNCTION
SamplingPlotGeography	Diversity Workbench User					FUNCTION
SamplingPlotHierarchy	Diversity Workbench User					FUNCTION
SamplingPlotList	Diversity Workbench User					FUNCTION
SamplingPlotListForCurrentProject	Diversity Workbench User					FUNCTION
SamplingPlotSuperiorNodes	Diversity Workbench User					FUNCTION
UserID					Diversity Workbench User	FUNCTION
UserName					Diversity Workbench User	FUNCTION
Version					Diversity Workbench User	FUNCTION
VersionClient					Diversity Workbench User	FUNCTION
procGetSiteProperties						PROCEDURE
procInsertSamplingPlotCopy					Diversity Workbench Editor	PROCEDURE
ProcSamplingPlotLocalisationAll						PROCEDURE
SetUserProjects						PROCEDURE
Inheriting from roles:

DiversityWorkbenchEditor

Role DiversityWorkbenchEditor

Role for editing the content

Permissions	SELECT	INSERT	UPDATE	DELETE	EXECUTE	Type
LocalisationSystem	Diversity Workbench User					TABLE
LocalisationSystem_log						TABLE
ProjectUser	Diversity Workbench User					TABLE
Property	•					TABLE
Property_log						TABLE
ReplicationPublisher	•					TABLE
SamplingPlot	•	•	•			TABLE
SamplingPlot_log						TABLE
SamplingPlotLocalisation	Diversity Workbench User	•	•	•		TABLE
SamplingPlotLocalisation_log	•	•				TABLE
SamplingPlotProperty	•	•	•	•		TABLE
SamplingPlotProperty_log	•	•				TABLE
SamplingPlotResource	•	•	•	•		TABLE
SamplingPlotResource_log						TABLE
SamplingProject	Diversity Workbench User	•	•	•		TABLE
SamplingProject_log	•	•				TABLE
PlotID_UserAvailable	Diversity Workbench User					VIEW
ProjectList	Diversity Workbench User					VIEW
SamplingPlotGeoInfo	Diversity Workbench User					VIEW
ViewBaseURL	Diversity Workbench User					VIEW
ViewDiversityWorkbenchModule	Diversity Workbench User					VIEW
ViewLocality	Diversity Workbench User					VIEW
ViewSamplingPlot	Diversity Workbench User					VIEW
ViewSamplingPlotAllLocalisations	Diversity Workbench User					VIEW
ViewSamplingPlotGeoInfo	Diversity Workbench User					VIEW
ViewSamplingPlotHierarchy5	Diversity Workbench User					VIEW
ViewSamplingPlotList	Diversity Workbench User					VIEW
ViewSamplingPlotListForCurrentProject	Diversity Workbench User					VIEW
ViewTest						VIEW
BaseURL					Diversity Workbench User	FUNCTION
DefaultProjectID					Diversity Workbench User	FUNCTION
DiversityWorkbenchModule					Diversity Workbench User	FUNCTION
PrivacyConsentInfo					Diversity Workbench User	FUNCTION
SamplingPlotAllLocalisations	Diversity Workbench User					FUNCTION
SamplingPlotAllProperties	•					FUNCTION
SamplingPlotChildNodes	Diversity Workbench User					FUNCTION
SamplingPlotGeography	Diversity Workbench User					FUNCTION
SamplingPlotHierarchy	Diversity Workbench User					FUNCTION
SamplingPlotList	Diversity Workbench User					FUNCTION
SamplingPlotListForCurrentProject	Diversity Workbench User					FUNCTION
SamplingPlotSuperiorNodes	Diversity Workbench User					FUNCTION
UserID					Diversity Workbench User	FUNCTION
UserName					Diversity Workbench User	FUNCTION
Version					Diversity Workbench User	FUNCTION
VersionClient					Diversity Workbench User	FUNCTION
procGetSiteProperties						PROCEDURE
procInsertSamplingPlotCopy					•	PROCEDURE
ProcSamplingPlotLocalisationAll						PROCEDURE
SetUserProjects						PROCEDURE
Inheriting from roles:

DiversityWorkbenchUser

Role DiversityWorkbenchUser

Role with read only access

Permissions	SELECT	EXECUTE	Type
LocalisationSystem	•		TABLE
LocalisationSystem_log			TABLE
ProjectUser	•		TABLE
Property			TABLE
Property_log			TABLE
ReplicationPublisher			TABLE
SamplingPlot	•		TABLE
SamplingPlot_log			TABLE
SamplingPlotLocalisation	•		TABLE
SamplingPlotLocalisation_log			TABLE
SamplingPlotProperty	•		TABLE
SamplingPlotProperty_log			TABLE
SamplingPlotResource			TABLE
SamplingPlotResource_log			TABLE
SamplingProject	•		TABLE
SamplingProject_log			TABLE
PlotID_UserAvailable	•		VIEW
ProjectList	•		VIEW
SamplingPlotGeoInfo	•		VIEW
ViewBaseURL	•		VIEW
ViewDiversityWorkbenchModule	•		VIEW
ViewLocality	•		VIEW
ViewSamplingPlot	•		VIEW
ViewSamplingPlotAllLocalisations	•		VIEW
ViewSamplingPlotGeoInfo	•		VIEW
ViewSamplingPlotHierarchy5	•		VIEW
ViewSamplingPlotList	•		VIEW
ViewSamplingPlotListForCurrentProject	•		VIEW
ViewTest			VIEW
BaseURL		•	FUNCTION
DefaultProjectID		•	FUNCTION
DiversityWorkbenchModule		•	FUNCTION
PrivacyConsentInfo		•	FUNCTION
SamplingPlotAllLocalisations	•		FUNCTION
SamplingPlotAllProperties	•		FUNCTION
SamplingPlotChildNodes	•		FUNCTION
SamplingPlotGeography	•		FUNCTION
SamplingPlotHierarchy	•		FUNCTION
SamplingPlotList	•		FUNCTION
SamplingPlotListForCurrentProject	•		FUNCTION
SamplingPlotSuperiorNodes	•		FUNCTION
UserID		•	FUNCTION
UserName		•	FUNCTION
Version		•	FUNCTION
VersionClient		•	FUNCTION
procGetSiteProperties			PROCEDURE
procInsertSamplingPlotCopy			PROCEDURE
ProcSamplingPlotLocalisationAll			PROCEDURE
SetUserProjects			PROCEDURE

Diversity Sampling Plots

Scope of DiversitySamplingPlots within the Diversity Workbench

Diversity Workbench modules

Subsections of Diversity Sampling Plots

Diversity sampling plots

Download

Upcoming version

4.5.2 (2023-10-??)

Current version

4.5.1 (2023-08-25)

Previous versions

4.5 (2023-05-09)

4.4.11 (2023-04-21)

Database updates

4.4.9

4.4.10

Tutorial

Tutorial - first steps

Subsections of Tutorial

Tutorial Backlinks

Tutorial - module relations resp. backlinks

DiversityCollection

Specimen

Images

Tutorial Edit Plots

Tutorial - create or change plots

Tutorial Hierarchy

Tutorial - plot hierarchy

Wizard Tutorial

Import wizard - tutorial

Choosing the File

Choosing the data ranges

Attaching data

Merging data

Table data

Testing

Import

Tutorial Localisation

Tutorial - localisation

Tutorial Maps

Tutorial - show plots on the maps

Tutorial Properties

Tutorial - properties

Tutorial Query

Tutorial - query

Tutorial Query Results

Tutorial - query results

Tutorial Resources

Tutorial - resources

Editing the data

Subsections of Editing the data

Projects

Import Export

Fequently Asked Questions

General

Subsections of General

Menu

Internals

Subsections of Internals

Feedback and Errors

Feedback

Error logging

Maintenance Scientific Terms

Linked data

Establish new links

Database

Organisation of the data

Subsections of Database

Diversity SamplingPlots

TABLES, VIEWS, FUNCTIONS, PROCEDURES, ROLES

TABLES

Table LocalisationSystem

Table ProjectUser

Table Property

Table ReplicationPublisher

Table SamplingPlot

Table SamplingPlotLocalisation

Depending on:

trgInsSamplingPlotLocalisation

Table SamplingPlotProperty