39. Managing Source references¶

A specific administration module has been developed to allow administrators to manage metadata and citations associated with each biological occurrence record.

Only registered users with super user status are able to access Source References, typically the administrators.

All biodiversity data served need to have associated Metadata, which is visible in the metadata table in the dashboards. This metadata allows the users to establish exactly where the data originated from and to navigate to the study reference if desired.

39.1 Types of source references¶

Multiple sources of taxon occurrence data generally exist, although this is highly dependent on the country. Potential sources of biodiversity data include the following source reference categories:

• Peer-reviewed scientific articles
• Theses
• Published reports
• Databases
• Unpublished data

The following sections provide details of the recommended processes for sourcing taxon occurrence data from the different reference categories. This is done by all users adding data and by administrators.

39.1.1 Peer-reviewed scientific article¶

Data from peer-reviewed scientific articles are best sourced by undertaking a literature search using Google Scholar. To ensure that relevant papers are identified, appropriate search term combination should be used. For example, for all native freshwater fishes in South Africa: “Genus species” & “South Africa” (where “Genus species” represents the scientific name for each taxon). It is important that search terms are clearly-defined and consistent, so that the process is repeatable and defensible.

39.1.2 Thesis¶

University theses are easily searched using relevant university search engines. Often local experts also know of relevant theses and can be contacted directly. Where possible, electronic data should be sourced directly from individuals, as this saves significant time that would otherwise be occupied in transcription of paper to digital records during data consolidation.

39.1.3 Published report¶

Technical and consultancy reports are often difficult to source and requires knowledge of local experts who have undertaken relevant studies. Where possible, electronic data should be sourced directly from individuals, as this saves significant time during data consolidation.

39.1.4 Database¶

Identify and contact relevant organisations who may have data to share that is already in a database. Data sharing agreements may be needed depending on the organisation. For organisation that regularly add data it is useful to set up a database in the organisation’s name.

39.1.5 Unpublished data¶

Identify individuals who may have data to share. Where possible, electronic data should be sourced directly from individuals, as this saves significant time during data consolidation.

Source reference system can store either an electronic document (e.g. by attaching a PDF to the document record) or a link to an online resource (URL). The order of preference should be:

1. Use DOI based citations wherever possible (in which case the URL attribute described below should not be needed).
2. Use documents with references to external resources (i.e. a URL that points to a published PDF on a web site).
3. Used documents with attached PDF as a last resort (this will require first uploading the document in the document management system and then providing the link to the uploaded document in the metadata table described below).

39.2 Adding source references to occurrence data¶

Source references are either added when data are added using the data capture forms on FBIS, or when uploading occurrence data using the data upload excel file. (See Preparing and checking an Occurrence Data File before uploading).

39.2.1 Adding a source reference using data capture forms¶

When adding data, three data capture forms are shown in sequence, namely 1) an occurrence record form, where you capture which taxa were present; 2) an abiotic data form where you capture physico-chemical and other abiotic data; and 3) a source reference for records form, where you capture the source reference or metadata for the biological record.

39.2.2 Peer-reviewed scientific articles¶

Select the reference category and insert the DOI or URL and click the search button. The citation is then retrieved via an online citation management system and inserted. Click Submit to save.

39.2.3 Published reports and theses¶

Select the reference category and select from the dropdown list of titles, if the published report or thesis is already uploaded, or select “Upload new” to add a new published report or thesis.

When uploading a new published report or thesis, complete the fields using the format indicated including Author(s), Year, Source, Title, Description (if desired) and Url or upload file. Confirm that you are owner of the document being added and Upload. This is then submitted.

39.2.4 Databases¶

Select the reference category and select from the dropdown list of databases, if the database is already created, or select “Add new” to add a new database.

When adding a new database, complete the name and provide a description. Add the url if it exists and click create. Add notes if desired.

39.2.5 Unpublished data¶

Select the reference category and select from the dropdown list under notes. If the unpublished dataset exists, select the unpublished dataset name, or if the unpublished dataset needs to be created, select “Add new” to add a new unpublished dataset. In the notes, add the name of the person, details of the study and date if possible or applicable.

39.3 Adding a source reference using occurrence upload excel files¶

Where data are uploaded using the Data Upload Templates, the data capturer needs to specify the following:

• Author(s): Surname + Initials
• Year: Year of study
• Source: Details such as journal name, report, thesis, database and unpublished data.
• Title: Title of the report. thesis, database or unpublished dataset.
• Reference category: Select from dropdown options
• URL: Thesis handle, or article link if no DOI available
• DOI: DOI for reference ( e.g. 10.2989/16085914.2018.1491385) – the citation for articles with DOIs is done automatically.
• Document Upload Link: Link to "Source Reference" page after uploading PDF or URL of published report or thesis.

When adding occurrence data using the upload excel files, the following columns are populated for each reference category:

39.3.1 Using Source References as an administrator¶

Errors can arise when source references are added to the information system by users. These can be picked up and fixed by undertaking various filters, checking and edits, including those listed below.

• Search for a reference type or category
• Search by author(s)
• Search using free text

Once the source reference has been found, it can be updated, deleted (only if there are not records associated with it), and the Document ID can be copied. This is needed when uploading occurrence records using the excel template.

By clicking on the records button you can check exactly which sites and data are linked to the source reference.