Module: CocinaDisplay::Concerns::Identifiers

Included in:
CocinaDisplay::CocinaRecord, RelatedResource
Defined in:
lib/cocina_display/concerns/identifiers.rb

Overview

Methods for extracting and formatting identifiers from Cocina records.

Instance Method Summary collapse

Instance Method Details

#doi ⇒ String?

The DOI for the object, if there is one – just the identifier part.

Examples:

record.doi #=> "10.25740/ppax-bf07"

Returns:

  • (String, nil) 


9
10
11
 
# File 'lib/cocina_display/concerns/identifiers.rb', line 9

def doi
  identifiers.find(&:doi?)&.identifier
end

#doi_url ⇒ String?

The DOI as a URL, if there is one. Any valid DOI should resolve via doi.org.

Examples:

record.doi_url #=> "https://doi.org/10.25740/ppax-bf07"

Returns:

  • (String, nil) 


17
18
19
 
# File 'lib/cocina_display/concerns/identifiers.rb', line 17

def doi_url
  URI.join("https://doi.org", doi).to_s if doi.present?
end

#folio_hrid(refresh: nil) ⇒ String? Also known as: catkey

Note:

This doesn’t imply the object is available in Searchworks at this ID.

The HRID of the item in FOLIO, if defined.

Examples:

With a link regardless of refresh:

record.folio_hrid #=> "a12845814"

With a link that is not refreshed:

record.folio_hrid(refresh: true) #=> nil

Parameters:

  • [Boolean] (refresh) —

    Filter to links with refresh set to this value.

Returns:

  • (String, nil) 


29
30
31
32
33
34
35
36
 
# File 'lib/cocina_display/concerns/identifiers.rb', line 29

def folio_hrid(refresh: nil)
  link = path("$.identification.catalogLinks[?(@.catalog == 'folio')]").first
  hrid = link&.dig("catalogRecordId")
  return if hrid.blank?
  return hrid if refresh.nil?

  (link["refresh"] == refresh) ? hrid : nil
end

#identifier_display_data ⇒ Array<DisplayData>

Labelled display data for identifiers.

Returns:



58
59
60
 
# File 'lib/cocina_display/concerns/identifiers.rb', line 58

def identifier_display_data
  CocinaDisplay::DisplayData.from_objects(identifiers)
end

#identifiers(type: nil) ⇒ Array<Identifier>

Note:

Type matching is case insensitive.

All identifier objects, optionally filtered by type.

Parameters:

  • type (String, nil) (defaults to: nil) —

    The type of identifier to filter by (e.g. “DOI”).

Returns:



52
53
54
 
# File 'lib/cocina_display/concerns/identifiers.rb', line 52

def identifiers(type: nil)
  type.present? ? all_identifiers.filter { |id| id.type&.casecmp?(type) } : all_identifiers
end

#searchworks_id ⇒ String?

Note:

This doesn’t imply the object is available in Searchworks at this ID.

The FOLIO HRID if defined, otherwise the bare DRUID.

Returns:

  • (String, nil)

See Also:



44
45
46
 
# File 'lib/cocina_display/concerns/identifiers.rb', line 44

def searchworks_id
  folio_hrid || bare_druid
end