Expose full citation object for NameUsage.publishedIn

17779
Reporter: mdoering
Type: NewFeature
Summary: Expose full citation object for NameUsage.publishedIn
Priority: Critical
Status: Open
Created: 2015-08-27 23:33:35.1
Updated: 2016-03-17 17:15:53.783
        
Description: For the citation reference of the original name publication we only expose a simple String field on NameUsage. The CLB db model does allow to store an identifier and a link in addition to the citation string. We should expose those 2 attributes to allow richer literature links in both our API and the portal pages.

The ideal solution would just change the type of NameUsage.publishedIn from String to Citation, but that is a breaking API change we probably cannot do.

Consider other alternatives, for example a new CitationService that returns a Citation object based on the id or entire String.]]>
    

Author: mdoering@gbif.org
Created: 2015-08-27 23:37:11.424
Updated: 2015-08-27 23:37:56.041
        
The gbif-api currently only contains a somewhat legacy checklistbank.Reference class which the CLB db has no matching fields for. There is no Citation class.

From the following fields only the ones marked with an asterisk do actually exist in the db:
{noformat}
  String citation *
  String title
  String author
  String date
  String link *
  String doi *(identifier in general, not just dois)
  String type *
  String remarks *
  String source
  Integer sourceTaxonKey *
{noformat}