Module: Dor::Identifiable
- Extended by:
- ActiveSupport::Concern
- Includes:
- SolrDocHelper
- Included in:
- Abstract
- Defined in:
- lib/dor/models/concerns/identifiable.rb
Defined Under Namespace
Modules: ClassMethods
Constant Summary collapse
- CATKEY_TYPE_ID =
ids for previous and current catkeys
'catkey'.freeze
- PREVIOUS_CATKEY_TYPE_ID =
'previous_catkey'.freeze
- @@collection_hash =
Module-level variables, shared between ALL mixin includers (and ALL their includers/extenders)! used for caching found values
{}
- @@apo_hash =
{}
Instance Method Summary collapse
-
#adapt_to_cmodel ⇒ Object
Override ActiveFedora::Core#adapt_to_cmodel (used with associations, among other places) to preferentially use the objectType asserted in the identityMetadata.
- #add_other_Id(type, val) ⇒ Object
-
#add_tag(tag) ⇒ Object
Add an administrative tag to an item, you will need to seperately save the item to write it to fedora.
-
#catkey ⇒ String
Convenience method to get the current catkey.
-
#catkey=(val) ⇒ String
Convenience method to set the catkey.
-
#content_type_tag ⇒ Object
helper method to get just the content type tag.
-
#druid_regex ⇒ Regex
a regex that can be used to identify a full druid with prefix (e.g. druid:oo000oo0001).
- #get_related_obj_display_title(related_obj, default_title) ⇒ Object
-
#identity_metadata_source ⇒ String
Calculated value for Solr index.
- #initialize(attrs = {}) ⇒ Object
-
#normalize_tag(tag_str) ⇒ Object
take a tag string and return a normalized tag string.
-
#normalize_tag_arr(tag_arr) ⇒ Object
turn a tag array back into a tag string with a standard format.
-
#pid_regex ⇒ Regex
a regex that can be used to identify the last part of a druid (e.g. oo000oo0001).
-
#previous_catkeys ⇒ Array
Convenience method to get the previous catkeys (will be an array).
-
#remove_druid_prefix(druid = id) ⇒ String
Since purl does not use the druid: prefix but much of dor does, use this function to strip the druid: if needed.
- #remove_other_Id(type, val = nil) ⇒ Object
- #remove_tag(tag) ⇒ Object
-
#source_id ⇒ Object
Convenience method.
-
#source_id=(source_id) ⇒ String
(also: #set_source_id)
Convenience method.
-
#split_tag_to_arr(tag_str) ⇒ Object
turns a tag string into an array with one element per tag part.
-
#tags ⇒ Object
helper method to get the tags as an array.
- #to_solr(solr_doc = {}, *args) ⇒ Object
- #update_other_Id(type, new_val, val = nil) ⇒ Object
- #update_tag(old_tag, new_tag) ⇒ Object
-
#validate_and_normalize_tag(tag_str, existing_tag_list) ⇒ Object
take a proposed tag string and a list of the existing tags for the object being edited.
-
#validate_tag_format(tag_str) ⇒ Array
Ensure that an administrative tag meets the proper mininum format.
Methods included from SolrDocHelper
Instance Method Details
#adapt_to_cmodel ⇒ Object
Override ActiveFedora::Core#adapt_to_cmodel (used with associations, among other places) to preferentially use the objectType asserted in the identityMetadata.
248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 |
# File 'lib/dor/models/concerns/identifiable.rb', line 248 def adapt_to_cmodel object_type = identityMetadata.objectType.first object_class = Dor.registered_classes[object_type] if object_class self.instance_of?(object_class) ? self : self.adapt_to(object_class) else if ActiveFedora::VERSION < '8' result = super if result.class == Dor::Abstract self.adapt_to(Dor::Item) else result end else begin super rescue ActiveFedora::ModelNotAsserted self.adapt_to(Dor::Item) end end end end |
#add_other_Id(type, val) ⇒ Object
126 127 128 129 130 131 |
# File 'lib/dor/models/concerns/identifiable.rb', line 126 def add_other_Id(type, val) if identityMetadata.otherId(type).length > 0 raise 'There is an existing entry for ' + type + ', consider using update_other_Id().' end identityMetadata.add_otherId(type + ':' + val) end |
#add_tag(tag) ⇒ Object
Add an administrative tag to an item, you will need to seperately save the item to write it to fedora
197 198 199 200 201 |
# File 'lib/dor/models/concerns/identifiable.rb', line 197 def add_tag(tag) = identityMetadata normalized_tag = validate_and_normalize_tag(tag, .) .add_value(:tag, normalized_tag) end |
#catkey ⇒ String
Convenience method to get the current catkey
96 97 98 |
# File 'lib/dor/models/concerns/identifiable.rb', line 96 def catkey identityMetadata.otherId(CATKEY_TYPE_ID).first end |
#catkey=(val) ⇒ String
Convenience method to set the catkey
103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 |
# File 'lib/dor/models/concerns/identifiable.rb', line 103 def catkey=(val) if val != catkey && !catkey.blank? # if there was already a catkey in the record, store that in the "previous" spot (assuming there is no change) identityMetadata.add_otherId("#{PREVIOUS_CATKEY_TYPE_ID}:#{catkey}") end if val.blank? # if we are setting the catkey to blank, remove the node from XML remove_other_Id(CATKEY_TYPE_ID) elsif catkey.blank? # if there is no current catkey, then add it add_other_Id(CATKEY_TYPE_ID,val) elsif # if there is a current catkey, update the current catkey to the new value update_other_Id(CATKEY_TYPE_ID,val) end val end |
#content_type_tag ⇒ Object
helper method to get just the content type tag
36 37 38 39 |
# File 'lib/dor/models/concerns/identifiable.rb', line 36 def content_type_tag content_tag = .select {|tag| tag.include?('Process : Content Type')} content_tag.size == 1 ? content_tag[0].split(':').last.strip : '' end |
#druid_regex ⇒ Regex
a regex that can be used to identify a full druid with prefix (e.g. druid:oo000oo0001)
235 236 237 |
# File 'lib/dor/models/concerns/identifiable.rb', line 235 def druid_regex /druid:#{pid_regex}/ end |
#get_related_obj_display_title(related_obj, default_title) ⇒ Object
221 222 223 224 225 |
# File 'lib/dor/models/concerns/identifiable.rb', line 221 def (, default_title) return default_title unless .full_title || default_title end |
#identity_metadata_source ⇒ String
Returns calculated value for Solr index.
70 71 72 73 74 75 76 77 |
# File 'lib/dor/models/concerns/identifiable.rb', line 70 def if identityMetadata.otherId('catkey').first || identityMetadata.otherId('barcode').first 'Symphony' else 'DOR' end end |
#initialize(attrs = {}) ⇒ Object
23 24 25 26 27 28 |
# File 'lib/dor/models/concerns/identifiable.rb', line 23 def initialize(attrs = {}) if Dor::Config.suri.mint_ids && !attrs[:pid] attrs = attrs.merge!({:pid => Dor::SuriService.mint_id, :new_object => true}) end super end |
#normalize_tag(tag_str) ⇒ Object
take a tag string and return a normalized tag string
161 162 163 |
# File 'lib/dor/models/concerns/identifiable.rb', line 161 def normalize_tag(tag_str) normalize_tag_arr(split_tag_to_arr(tag_str)) end |
#normalize_tag_arr(tag_arr) ⇒ Object
turn a tag array back into a tag string with a standard format
156 157 158 |
# File 'lib/dor/models/concerns/identifiable.rb', line 156 def normalize_tag_arr(tag_arr) tag_arr.join(' : ') end |
#pid_regex ⇒ Regex
a regex that can be used to identify the last part of a druid (e.g. oo000oo0001)
229 230 231 |
# File 'lib/dor/models/concerns/identifiable.rb', line 229 def pid_regex /[a-zA-Z]{2}[0-9]{3}[a-zA-Z]{2}[0-9]{4}/ end |
#previous_catkeys ⇒ Array
Convenience method to get the previous catkeys (will be an array)
122 123 124 |
# File 'lib/dor/models/concerns/identifiable.rb', line 122 def previous_catkeys identityMetadata.otherId(PREVIOUS_CATKEY_TYPE_ID) end |
#remove_druid_prefix(druid = id) ⇒ String
Since purl does not use the druid: prefix but much of dor does, use this function to strip the druid: if needed
241 242 243 244 |
# File 'lib/dor/models/concerns/identifiable.rb', line 241 def remove_druid_prefix(druid=id) result=druid.match(/#{pid_regex}/) result.nil? ? druid : result[0] # if no matches, return the string passed in, otherwise return the match end |
#remove_other_Id(type, val = nil) ⇒ Object
141 142 143 144 145 146 147 |
# File 'lib/dor/models/concerns/identifiable.rb', line 141 def remove_other_Id(type, val = nil) identityMetadata.ng_xml.search('//otherId[@name=\'' + type + '\']') .select { |node| val.nil? || node.content == val } .each { identityMetadata.ng_xml_will_change! } .each(&:remove) .any? end |
#remove_tag(tag) ⇒ Object
203 204 205 206 207 208 209 210 |
# File 'lib/dor/models/concerns/identifiable.rb', line 203 def remove_tag(tag) normtag = normalize_tag(tag) identityMetadata.ng_xml.search('//tag') .select { |node| normalize_tag(node.content) == normtag } .each { identityMetadata.ng_xml_will_change! } .each(&:remove) .any? end |
#source_id ⇒ Object
Convenience method
80 81 82 |
# File 'lib/dor/models/concerns/identifiable.rb', line 80 def source_id identityMetadata.sourceId end |
#source_id=(source_id) ⇒ String Also known as: set_source_id
Convenience method
88 89 90 |
# File 'lib/dor/models/concerns/identifiable.rb', line 88 def source_id=(source_id) identityMetadata.sourceId = source_id end |
#split_tag_to_arr(tag_str) ⇒ Object
turns a tag string into an array with one element per tag part. split on “:”, disregard leading and trailing whitespace on tokens.
151 152 153 |
# File 'lib/dor/models/concerns/identifiable.rb', line 151 def split_tag_to_arr(tag_str) tag_str.split(':').map {|str| str.strip} end |
#tags ⇒ Object
helper method to get the tags as an array
31 32 33 |
# File 'lib/dor/models/concerns/identifiable.rb', line 31 def identityMetadata.tag end |
#to_solr(solr_doc = {}, *args) ⇒ Object
46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/dor/models/concerns/identifiable.rb', line 46 def to_solr(solr_doc = {}, *args) assert_content_model solr_doc = super(solr_doc, *args) solr_doc[Dor::INDEX_VERSION_FIELD] = Dor::VERSION solr_doc['indexed_at_dtsi'] = Time.now.utc.xmlschema datastreams.values.each do |ds| add_solr_value(solr_doc, 'ds_specs', ds.datastream_spec_string, :string, [:symbol]) unless ds.new? end add_solr_value(solr_doc, 'title_sort', label, :string, [:stored_sortable]) rels_doc = Nokogiri::XML(datastreams['RELS-EXT'].content) ns_hash = {'hydra' => 'http://projecthydra.org/ns/relations#', 'fedora' => 'info:fedora/fedora-system:def/relations-external#', 'rdf' => 'http://www.w3.org/1999/02/22-rdf-syntax-ns#'} apos = rels_doc.search('//rdf:RDF/rdf:Description/hydra:isGovernedBy', ns_hash) collections = rels_doc.search('//rdf:RDF/rdf:Description/fedora:isMemberOfCollection', ns_hash) (solr_doc, apos, @@apo_hash, 'apo_title', 'nonhydrus_apo_title', 'hydrus_apo_title') (solr_doc, collections, @@collection_hash, 'collection_title', 'nonhydrus_collection_title', 'hydrus_collection_title') solr_doc['public_dc_relation_tesim'] ||= solr_doc['collection_title_tesim'] if solr_doc['collection_title_tesim'] solr_doc['metadata_source_ssi'] = solr_doc end |
#update_other_Id(type, new_val, val = nil) ⇒ Object
133 134 135 136 137 138 139 |
# File 'lib/dor/models/concerns/identifiable.rb', line 133 def update_other_Id(type, new_val, val = nil) identityMetadata.ng_xml.search('//otherId[@name=\'' + type + '\']') .select { |node| val.nil? || node.content == val } .each { identityMetadata.ng_xml_will_change! } .each { |node| node.content = new_val } .any? end |
#update_tag(old_tag, new_tag) ⇒ Object
212 213 214 215 216 217 218 219 |
# File 'lib/dor/models/concerns/identifiable.rb', line 212 def update_tag(old_tag, new_tag) normtag = normalize_tag(old_tag) identityMetadata.ng_xml.search('//tag') .select { |node| normalize_tag(node.content) == normtag } .each { identityMetadata.ng_xml_will_change! } .each { |node| node.content = normalize_tag(new_tag) } .any? end |
#validate_and_normalize_tag(tag_str, existing_tag_list) ⇒ Object
take a proposed tag string and a list of the existing tags for the object being edited. if the proposed tag is valid, return it in normalized form. if not, raise an exception with an explanatory message.
168 169 170 171 172 173 174 175 176 177 178 179 |
# File 'lib/dor/models/concerns/identifiable.rb', line 168 def validate_and_normalize_tag(tag_str, existing_tag_list) tag_arr = validate_tag_format(tag_str) # note that the comparison for duplicate tags is case-insensitive, but we don't change case as part of the normalized version # we return, because we want to preserve the user's intended case. normalized_tag = normalize_tag_arr(tag_arr) dupe_existing_tag = existing_tag_list.detect { |existing_tag| normalize_tag(existing_tag).casecmp(normalized_tag) == 0 } if dupe_existing_tag raise "An existing tag (#{dupe_existing_tag}) is the same, consider using update_tag?" end normalized_tag end |
#validate_tag_format(tag_str) ⇒ Array
Ensure that an administrative tag meets the proper mininum format
184 185 186 187 188 189 190 191 192 193 |
# File 'lib/dor/models/concerns/identifiable.rb', line 184 def validate_tag_format(tag_str) tag_arr = split_tag_to_arr(tag_str) if tag_arr.length < 2 raise ArgumentError, "Invalid tag structure: tag '#{tag_str}' must have at least 2 elements" end if tag_arr.detect {|str| str.empty?} raise ArgumentError, "Invalid tag structure: tag '#{tag_str}' contains empty elements" end tag_arr end |