TG2-VALIDATION_CLASS_FOUND

[iDigBioBot]

TestField	Value
GUID	2cd6884e-3d14-4476-94f7-1191cfff309b
Label	VALIDATION_CLASS_FOUND
Description	Does the value of dwc:class occur at rank of Class in bdq:sourceAuthority?
TestType	Validation
Darwin Core Class	dwc:Taxon
Information Elements ActedUpon	dwc:class
Information Elements Consulted
Expected Response	EXTERNAL_PREREQUISITES_NOT_MET if the bdq:sourceAuthority is not available; INTERNAL_PREREQUISITES_NOT_MET if dwc:class is bdq:Empty; COMPLIANT if the value of dwc:class is found as a value at the rank of Class in the bdq:sourceAuthority; otherwise NOT_COMPLIANT
Data Quality Dimension	Conformance
Term-Actions	CLASS_FOUND
Parameter(s)	bdq:sourceAuthority
Source Authority	bdq:sourceAuthority default = "GBIF Backbone Taxonomy" {[https://doi.org/10.15468/39omei]} {API endpoint [https://api.gbif.org/v1/species?datasetKey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&name=]}
Specification Last Updated	2023-09-18
Examples	[dwc:class="Insecta": Response.status=RUN_HAS_RESULT, Response.result=COMPLIANT, Response.comment="dwc:class has an equivalent at the rank of Class in the bdq:sourceAuthority"]
	[dwc:class="Magnoleopsida": Response.status=RUN_HAS_RESULT, Response.result=NOT_COMPLIANT, Response.comment="dwc:class does not have an equivalent at the rank of Class in the bdq:sourceAuthority"]
Source
References	GBIF Secretariat (2023) GBIF Backbone Taxonomy. Checklist dataset. https://doi.org/10.15468/39omei
Example Implementations (Mechanisms)	Kurator/FilteredPush sci_name_qc Library
Link to Specification Source Code	https://github.com/FilteredPush/sci_name_qc/blob/v1.1.2/src/main/java/org/filteredpush/qc/sciname/DwCSciNameDQ.java#L1349
Notes	The purpose of this test is to check whether the value is a name that is a result of a nomenclatural act at this rank. This excludes unpublished names, misspellings and vernacular names. It is expected that the test will designate the source authority against to check. The same test might return distinct results when using distinct source authorities.

[Tasilee]

I have updated the specs for this test (Source Authority) by taking the ref in the Notes (updated by References) to the Source Authority.

To me, this conflicts with for example #187 in that we provide values for bdq terms in the Parameters vs Source Authority.

We also now often have three refs to bdq:sourceAuthority (Parameters, Source Authority and References) which strikes me as a tad redundant.

[Tasilee]

@chicoreus has now amended the Parameters and Source Authority as if all agree, we will use this format as a template for similar tests.

Parameters should follow the same format as Information Elements if there is more than one (1/line)

[Tasilee]

I changed the Example

dwc:class="Herps"

to

dwc:class="Mammalia"

to better align with the reflection of "NOT_FOUND" to "FOUND". This may likely apply to other Examples (which I will check).

[Tasilee]

I've changed Example 2 to align with test data.

[Tasilee]

Restructured Parameter(s) and Source authority

[Tasilee]

Amended Source Authority values to align with @chicoreus syntax

From

bdq:sourceAuthority default = "GBIF Backbone Taxonomy" [https://doi.org/10.15468/39omei] |
| | API endpoint [https://api.gbif.org/v1/species?datasetKey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&name=]

to

bdq:sourceAuthority default = "GBIF Backbone Taxonomy" {[https://doi.org/10.15468/39omei]} {API endpoint [https://api.gbif.org/v1/species?datasetKey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&name=]}

[Tasilee]

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

Also changed "Field" to "TestField", "Output Type" to "TestType" and updated "Specification Last Updated"