TG2-VALIDATION_COUNTRY_FOUND

[iDigBioBot]

TestField	Value
GUID	69b2efdc-6269-45a4-aecb-4cb99c2ae134
Label	VALIDATION_COUNTRY_FOUND
Description	Does the value of dwc:country occur in the bdq:sourceAuthority?
TestType	Validation
Darwin Core Class	dcterms:Location
Information Elements ActedUpon	dwc:country
Information Elements Consulted
Expected Response	EXTERNAL_PREREQUISITES_NOT_MET if the bdq:sourceAuthority is not available; INTERNAL_PREREQUISITES_NOT_MET if dwc:country is bdq:Empty; COMPLIANT if value of dwc:country is a place type equivalent to administrative entity of "nation" in the bdq:sourceAuthority; otherwise NOT_COMPLIANT
Data Quality Dimension	Conformance
Term-Actions	COUNTRY_FOUND
Parameter(s)	bdq:sourceAuthority
Source Authority	bdq:sourceAuthority default = "The Getty Thesaurus of Geographic Names (TGN)" {[https://www.getty.edu/research/tools/vocabularies/tgn/index.html]}
Specification Last Updated	2024-08-19
Examples	[dwc:country="Eswatini": Response.status=RUN_HAS_RESULT, Response.result=COMPLIANT, Response.comment="dwc:country is a valid country name in the bdq:sourceAuthority"]
	[dwc:country="Tasmania": Response.status=RUN_HAS_RESULT, Response.result=NOT_COMPLIANT, Response.comment="Tasmania is not found at the level of national in the bdq:sourceAuthority"]
Source	ALA, GBIF
References	Getty Research Institute (2017) Getty Thesaurus of Geographic Names Online. https://www.getty.edu/research/tools/vocabularies/tgn/index.html Chapman AD and Wieczorek JR (2020) Georeferencing Best Practices. Copenhagen: GBIF Secretariat. https://doi.org/10.15468/doc-gg7h-s853
Example Implementations (Mechanisms)
Link to Specification Source Code
Notes	Non-country information such as "high seas" will fail this test (High Seas should use dwc:countryCode = "XZ" and have dwc:country empty). Getty Place Types for administrative level "nation" are 81010 nation, 81011 independent sovereign nation, and 81012 independent nation. Multiple values in the dwc:country field (whether to signify on a border or in a list of possibilities) will fail this test. Locations outside of a jurisdiction covered by a country code should not have a value in the field dwc:countryCode. This test should find any matches at the Getty "nation" level including internationalized names and historical representations of that nation (where boundaries are same). This test must return NOT_COMPLIANT if there is leading or trailing whitespace or there are leading or trailing non-printing characters.

[iDigBioBot]

Comment by Anonymous migrated from spreadsheet: None

[iDigBioBot]

Comment by Arthur Chapman (@ArthurChapman) migrated from spreadsheet: Is this something that should be added to NOTES column?

[iDigBioBot]

Comment by Paula Zermoglio (@pzermoglio) migrated from spreadsheet: In cases where there is no country, test only useful AFTER interpretation of country from coordinates

[iDigBioBot]

Comment by Paul Morris (@chicoreus) migrated from spreadsheet: Treat "High Seas" as a valid country value. Country of origin, or high seas is critical information for Nagoya Protocol implementation.

[ArthurChapman]

Discussion from Gainesville meeting: Should we be using current country? of country at time of collection? For may reasons, it was agreed that for this test, the country should be current country.

For the Sequence - see Paula's comment above - run validations, run amendments - run validations again (Paul) Will handle a number of cases where concerned about sequence.

John: do we require country to be a written out version of a country code or can be other political entity - for example United Kingdom.n Important test. Not necessarily an error, but a warning that the country is not a standard modern country. French Indo-China could mean any one of a number of current countries.

Agreed to apply to current ISO countries. Question why ISO and not Getty Thesaurus. Geonames another suggestion. Getty Thesaurus has hierarchies.

Test for now could just as "in a vocabulary" and what vocabulary could change over time. DwC mentions Getty as a recommended vocabulary. We could thus go that way to be consistent with DwC. Put the ISO test to ISO, and the human readable "Country" to the richer Getty Thesaurus.

[tucotuco]

i suggest the Description:

'Does the value of dwc:country occur as the equivalent of a nation in the bdq:sourceAuthority?'

in place of:

'Does the value of dwc:country occur in bdq:sourceAuthority?'

[ArthurChapman]

That fits with the equivalent NAME tests

[Tasilee]

From the zoom meeting today, we agreed to align this test with the taxonomic counterparts by renaming "STANDARD" to "FOUND".

[Tasilee]

Added to Notes: "This test will fail if there are leading or trailing white space or non-printing characters."

[Tasilee]

Post Zoom 11/7/2023, I have aligned the Source Authority with the suggested syntax:

bdq:sourceAuthority default = "The Getty Thesaurus of Geographic Names (TGN)" [https://www.getty.edu/research/tools/vocabularies/tgn/index.html]

to

bdq:sourceAuthority default = "The Getty Thesaurus of Geographic Names (TGN)" {[https://www.getty.edu/research/tools/vocabularies/tgn/index.html]}

[Tasilee]

Splitting bdqffdq:Information Elements into "Information Elements ActedUpon" and "Information Elements Consulted"

[chicoreus]

Updated notes from "fail" to more specific: "This test must return NOT_COMPLIANT if there is leading or trailing whitespace or there are leading or trailing non-printing characters. "

[Tasilee]

Changed "was" to "is" to align with standard phrasing in ER as in "INTERNAL_PREREQUISITES_NOT_MET if dwc:country is EMPTY"