Module: Dor::Editable
- Extended by:
- ActiveSupport::Concern
- Included in:
- AdminPolicyObject
- Defined in:
- lib/dor/models/concerns/editable.rb
Overview
This is basically used just by APOs. Arguably “editable” is the wrong name.
Constant Summary collapse
- CREATIVE_COMMONS_USE_LICENSES =
these hashes map short (“machine”) license codes to their corresponding URIs and human readable titles. they also allow for deprecated entries (via optional :deprecation_warning). clients that use these maps are advised to only display undeprecated entries, except where a deprecated entry is already in use by an object. e.g., an APO that already specifies “by_sa” for its default license code could continue displaying that in a list of license options for editing, preferably with the deprecation warning. but other deprecated entries would be omitted in such a selectbox. TODO: seems like Editable is not the most semantically appropriate place for these mappings? though they’re used by methods that live in Editable. TODO: need some way to do versioning. for instance, what happens when a new version of an existing license comes out, since it will presumably use the same license code, but a different title and URI?
{ 'by' => { :human_readable => 'Attribution 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by/3.0/' }, 'by-sa' => { :human_readable => 'Attribution Share Alike 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by-sa/3.0/' }, 'by_sa' => { :human_readable => 'Attribution Share Alike 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by-sa/3.0/', :deprecation_warning => 'license code "by_sa" was a typo in argo, prefer "by-sa"' }, 'by-nd' => { :human_readable => 'Attribution No Derivatives 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by-nd/3.0/' }, 'by-nc' => { :human_readable => 'Attribution Non-Commercial 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by-nc/3.0/' }, 'by-nc-sa' => { :human_readable => 'Attribution Non-Commercial Share Alike 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by-nc-sa/3.0/' }, 'by-nc-nd' => { :human_readable => 'Attribution Non-Commercial, No Derivatives 3.0 Unported', :uri => 'https://creativecommons.org/licenses/by-nc-nd/3.0/' }, 'pdm' => { :human_readable => 'Public Domain Mark 1.0', :uri => 'https://creativecommons.org/publicdomain/mark/1.0/'} }.freeze
- OPEN_DATA_COMMONS_USE_LICENSES =
{ 'pddl' => { :human_readable => 'Open Data Commons Public Domain Dedication and License 1.0', :uri => 'http://opendatacommons.org/licenses/pddl/1.0/' }, 'odc-by' => { :human_readable => 'Open Data Commons Attribution License 1.0', :uri => 'http://opendatacommons.org/licenses/by/1.0/' }, 'odc-odbl' => { :human_readable => 'Open Data Commons Open Database License 1.0', :uri => 'http://opendatacommons.org/licenses/odbl/1.0/' } }.freeze
Instance Method Summary collapse
-
#add_default_collection(val) ⇒ Object
Add a collection to the listing of collections for items governed by this apo.
-
#add_roleplayer(role, entity, type = :workgroup) ⇒ Object
Adds a person or group to a role in the APO role metadata datastream.
- #agreement ⇒ Object
- #agreement=(val) ⇒ Object
- #copyright_statement ⇒ Object
- #copyright_statement=(val) ⇒ Object
- #creative_commons_license ⇒ Object
- #creative_commons_license=(use_license_machine) ⇒ Object
- #creative_commons_license_human ⇒ Object
- #creative_commons_license_human=(use_license_human) ⇒ Object
-
#default_collections ⇒ Array
get all collections listed for this APO, used during registration.
-
#default_rights ⇒ String
RightsMetadataDS::RIGHTS_TYPE_CODES.keys (so this is essentially the inverse of RightsMetadataDS.upd_rights_xml_for_rights_type).
-
#default_rights=(rights) ⇒ Object
Set the rights in default object rights.
-
#default_rights_for_indexing ⇒ String
A description of the rights defined in the default object rights datastream.
-
#default_workflow=(wf) ⇒ Object
set a single default workflow.
-
#default_workflows ⇒ Array
List of default workflows, used to provide choices at registration.
- #desc_metadata_format ⇒ Object
- #desc_metadata_format=(format) ⇒ Object
- #desc_metadata_source ⇒ Object
- #desc_metadata_source=(source) ⇒ Object
- #metadata_source ⇒ Object
- #metadata_source=(val) ⇒ Object
- #mods_title ⇒ Object
- #mods_title=(val) ⇒ Object
- #open_data_commons_license ⇒ Object
- #open_data_commons_license=(use_license_machine) ⇒ Object
- #open_data_commons_license_human ⇒ Object
- #open_data_commons_license_human=(use_license_human) ⇒ Object
-
#purge_roles ⇒ Object
remove all people groups and roles from the APO role metadata datastream.
- #remove_default_collection(val) ⇒ Object
-
#roles ⇒ Hash
Get all roles defined in the role metadata, and the people or groups in those roles.
- #to_solr(solr_doc = {}, *args) ⇒ Object
- #use_license ⇒ Object
-
#use_license=(use_license_machine) ⇒ Object
If set to ‘:none` then Use License is removed.
- #use_license_human ⇒ Object
- #use_license_uri ⇒ Object
- #use_statement ⇒ Object
- #use_statement=(val) ⇒ Object
Instance Method Details
#add_default_collection(val) ⇒ Object
Add a collection to the listing of collections for items governed by this apo.
109 110 111 112 113 114 115 116 117 118 119 120 |
# File 'lib/dor/models/concerns/editable.rb', line 109 def add_default_collection(val) xml = administrativeMetadata.ng_xml administrativeMetadata.ng_xml_will_change! reg = xml.search('//administrativeMetadata/registration').first unless reg reg = Nokogiri::XML::Node.new('registration', xml) xml.search('/administrativeMetadata').first.add_child(reg) end node = Nokogiri::XML::Node.new('collection', xml) node['id'] = val reg.add_child(node) end |
#add_roleplayer(role, entity, type = :workgroup) ⇒ Object
Adds a person or group to a role in the APO role metadata datastream
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 |
# File 'lib/dor/models/concerns/editable.rb', line 61 def add_roleplayer(role, entity, type = :workgroup) xml = roleMetadata.ng_xml roleMetadata.ng_xml_will_change! group = type == :workgroup ? 'group' : 'person' nodes = xml.search('/roleMetadata/role[@type=\'' + role + '\']') if nodes.length > 0 group_node = Nokogiri::XML::Node.new(group, xml) id_node = Nokogiri::XML::Node.new('identifier', xml) group_node.add_child(id_node) id_node.content = entity id_node['type'] = type.to_s nodes.first.add_child(group_node) else node = Nokogiri::XML::Node.new('role', xml) node['type'] = role group_node = Nokogiri::XML::Node.new(group, xml) node.add_child group_node id_node = Nokogiri::XML::Node.new('identifier', xml) group_node.add_child(id_node) id_node.content = entity id_node['type'] = type.to_s xml.search('/roleMetadata').first.add_child(node) end end |
#agreement ⇒ Object
353 354 355 |
# File 'lib/dor/models/concerns/editable.rb', line 353 def agreement agreement_object ? agreement_object.pid : '' end |
#agreement=(val) ⇒ Object
357 358 359 360 |
# File 'lib/dor/models/concerns/editable.rb', line 357 def agreement=(val) fail ArgumentError, 'agreement must have a valid druid' if val.blank? self.agreement_object = Dor.find val.to_s, :cast => true end |
#copyright_statement ⇒ Object
161 162 163 |
# File 'lib/dor/models/concerns/editable.rb', line 161 def copyright_statement defaultObjectRights.copyright.first end |
#copyright_statement=(val) ⇒ Object
165 166 167 |
# File 'lib/dor/models/concerns/editable.rb', line 165 def copyright_statement=(val) defaultObjectRights.update_term!(:copyright, val.nil? ? '' : val) end |
#creative_commons_license ⇒ Object
169 170 171 |
# File 'lib/dor/models/concerns/editable.rb', line 169 def creative_commons_license defaultObjectRights.creative_commons.first end |
#creative_commons_license=(use_license_machine) ⇒ Object
203 204 205 206 207 |
# File 'lib/dor/models/concerns/editable.rb', line 203 def creative_commons_license=(use_license_machine) defaultObjectRights.initialize_term!(:creative_commons) defaultObjectRights.creative_commons = use_license_machine defaultObjectRights.creative_commons.uri = CREATIVE_COMMONS_USE_LICENSES[use_license_machine][:uri] end |
#creative_commons_license_human ⇒ Object
173 174 175 |
# File 'lib/dor/models/concerns/editable.rb', line 173 def creative_commons_license_human defaultObjectRights.creative_commons_human.first end |
#creative_commons_license_human=(use_license_human) ⇒ Object
209 210 211 212 |
# File 'lib/dor/models/concerns/editable.rb', line 209 def creative_commons_license_human=(use_license_human) defaultObjectRights.initialize_term!(:creative_commons_human) defaultObjectRights.creative_commons_human = use_license_human end |
#default_collections ⇒ Array
get all collections listed for this APO, used during registration
103 104 105 |
# File 'lib/dor/models/concerns/editable.rb', line 103 def default_collections administrativeMetadata.term_values(:registration, :default_collection) end |
#default_rights ⇒ String
RightsMetadataDS::RIGHTS_TYPE_CODES.keys (so this is essentially the inverse of RightsMetadataDS.upd_rights_xml_for_rights_type).
247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 |
# File 'lib/dor/models/concerns/editable.rb', line 247 def default_rights xml = defaultObjectRights.ng_xml machine_read_access = xml.search('//rightsMetadata/access[@type="read"]/machine') machine_discover_access = xml.search('//rightsMetadata/access[@type="discover"]/machine') machine_read_access_node = machine_read_access.length == 1 ? machine_read_access.first : nil machine_discover_access_node = machine_discover_access.length == 1 ? machine_discover_access.first : nil if machine_read_access_node && machine_read_access_node.search('./group[text()="Stanford" or text()="stanford"]').length == 1 if machine_read_access_node.search('./group[@rule="no-download"]').length == 1 'stanford-nd' else 'stanford' end elsif machine_read_access_node && machine_read_access_node.search('./world').length == 1 if machine_read_access_node.search('./world[@rule="no-download"]').length == 1 'world-nd' else 'world' end elsif machine_read_access_node && machine_read_access_node.search('./location[text()="spec"]').length == 1 'loc:spec' elsif machine_read_access_node && machine_read_access_node.search('./location[text()="music"]').length == 1 'loc:music' elsif machine_discover_access_node && machine_discover_access_node.search('./world').length == 1 # if it's not stanford restricted, world readable, or location restricted, but it is world discoverable, it's "citation only" 'none' elsif machine_discover_access_node && machine_discover_access_node.search('./none').length == 1 # if it's not even discoverable, it's "dark" 'dark' else # if none of the above, the rights xml structure is unsupported/unintelligible nil end end |
#default_rights=(rights) ⇒ Object
Set the rights in default object rights
290 291 292 293 294 295 296 297 |
# File 'lib/dor/models/concerns/editable.rb', line 290 def default_rights=(rights) rights = rights.downcase raise(ArgumentError, "Unrecognized rights value '#{rights}'") unless RightsMetadataDS.valid_rights_type? rights rights_xml = defaultObjectRights.ng_xml defaultObjectRights.ng_xml_will_change! RightsMetadataDS.upd_rights_xml_for_rights_type(rights_xml, rights) end |
#default_rights_for_indexing ⇒ String
Returns A description of the rights defined in the default object rights datastream. Can be ‘Stanford’, ‘World’, ‘Dark’ or ‘None’.
284 285 286 |
# File 'lib/dor/models/concerns/editable.rb', line 284 def default_rights_for_indexing RightsMetadataDS::RIGHTS_TYPE_CODES.fetch(default_rights, 'Unrecognized default rights value') end |
#default_workflow=(wf) ⇒ Object
set a single default workflow
333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 |
# File 'lib/dor/models/concerns/editable.rb', line 333 def default_workflow=(wf) fail ArgumentError, 'Must have a valid workflow for default' if wf.blank? xml = administrativeMetadata.ng_xml administrativeMetadata.ng_xml_will_change! nodes = xml.search('//registration/workflow') if nodes.first nodes.first['id'] = wf else nodes = xml.search('//registration') unless nodes.first reg_node = Nokogiri::XML::Node.new('registration', xml) xml.root.add_child(reg_node) end nodes = xml.search('//registration') wf_node = Nokogiri::XML::Node.new('workflow', xml) wf_node['id'] = wf nodes.first.add_child(wf_node) end end |
#default_workflows ⇒ Array
List of default workflows, used to provide choices at registration
327 328 329 |
# File 'lib/dor/models/concerns/editable.rb', line 327 def default_workflows administrativeMetadata.term_values(:registration, :workflow_id) end |
#desc_metadata_format ⇒ Object
299 300 301 |
# File 'lib/dor/models/concerns/editable.rb', line 299 def administrativeMetadata..first end |
#desc_metadata_format=(format) ⇒ Object
303 304 305 306 307 308 309 310 |
# File 'lib/dor/models/concerns/editable.rb', line 303 def (format) # create the node if it isnt there already unless administrativeMetadata..first administrativeMetadata.ng_xml_will_change! administrativeMetadata.add_child_node(administrativeMetadata.ng_xml.root, :metadata_format) end administrativeMetadata.update_values({[:metadata_format] => format}) end |
#desc_metadata_source ⇒ Object
312 313 314 |
# File 'lib/dor/models/concerns/editable.rb', line 312 def administrativeMetadata..first end |
#desc_metadata_source=(source) ⇒ Object
316 317 318 319 320 321 322 323 |
# File 'lib/dor/models/concerns/editable.rb', line 316 def (source) # create the node if it isnt there already unless administrativeMetadata..first administrativeMetadata.ng_xml_will_change! administrativeMetadata.add_child_node(administrativeMetadata.ng_xml.root, :metadata_source) end administrativeMetadata.update_values({[:metadata_source] => format}) end |
#metadata_source ⇒ Object
141 142 143 |
# File 'lib/dor/models/concerns/editable.rb', line 141 def administrativeMetadata..first end |
#metadata_source=(val) ⇒ Object
145 146 147 148 149 150 151 |
# File 'lib/dor/models/concerns/editable.rb', line 145 def (val) if administrativeMetadata.descMetadata.nil? administrativeMetadata.ng_xml_will_change! administrativeMetadata.add_child_node(administrativeMetadata, :descMetadata) end administrativeMetadata.update_values({[:descMetadata, :source] => val}) end |
#mods_title ⇒ Object
93 94 95 |
# File 'lib/dor/models/concerns/editable.rb', line 93 def mods_title descMetadata.term_values(:title_info, :main_title).first end |
#mods_title=(val) ⇒ Object
97 98 99 |
# File 'lib/dor/models/concerns/editable.rb', line 97 def mods_title=(val) descMetadata.update_values({[:title_info, :main_title] => val}) end |
#open_data_commons_license ⇒ Object
177 178 179 |
# File 'lib/dor/models/concerns/editable.rb', line 177 def open_data_commons_license defaultObjectRights.open_data_commons.first end |
#open_data_commons_license=(use_license_machine) ⇒ Object
214 215 216 217 218 |
# File 'lib/dor/models/concerns/editable.rb', line 214 def open_data_commons_license=(use_license_machine) defaultObjectRights.initialize_term!(:open_data_commons) defaultObjectRights.open_data_commons = use_license_machine defaultObjectRights.open_data_commons.uri = OPEN_DATA_COMMONS_USE_LICENSES[use_license_machine][:uri] end |
#open_data_commons_license_human ⇒ Object
181 182 183 |
# File 'lib/dor/models/concerns/editable.rb', line 181 def open_data_commons_license_human defaultObjectRights.open_data_commons_human.first end |
#open_data_commons_license_human=(use_license_human) ⇒ Object
220 221 222 223 |
# File 'lib/dor/models/concerns/editable.rb', line 220 def open_data_commons_license_human=(use_license_human) defaultObjectRights.initialize_term!(:open_data_commons_human) defaultObjectRights.open_data_commons_human = use_license_human end |
#purge_roles ⇒ Object
remove all people groups and roles from the APO role metadata datastream
87 88 89 90 91 |
# File 'lib/dor/models/concerns/editable.rb', line 87 def purge_roles roleMetadata.ng_xml.search('/roleMetadata/role').each do |node| node.remove end end |
#remove_default_collection(val) ⇒ Object
122 123 124 125 126 |
# File 'lib/dor/models/concerns/editable.rb', line 122 def remove_default_collection(val) xml = administrativeMetadata.ng_xml administrativeMetadata.ng_xml_will_change! xml.search('//administrativeMetadata/registration/collection[@id=\'' + val + '\']').remove end |
#roles ⇒ Hash
Get all roles defined in the role metadata, and the people or groups in those roles. Groups are prefixed with ‘workgroup:’
130 131 132 133 134 135 136 137 138 139 |
# File 'lib/dor/models/concerns/editable.rb', line 130 def roles roles = {} roleMetadata.ng_xml.search('/roleMetadata/role').each do |role| roles[role['type']] = [] role.search('identifier').each do |entity| roles[role['type']] << entity['type'] + ':' + entity.text end end roles end |
#to_solr(solr_doc = {}, *args) ⇒ Object
48 49 50 51 52 53 54 |
# File 'lib/dor/models/concerns/editable.rb', line 48 def to_solr(solr_doc = {}, *args) solr_doc = super(solr_doc, *args) add_solr_value(solr_doc, 'default_rights', default_rights_for_indexing, :string, [:symbol]) add_solr_value(solr_doc, 'agreement', agreement, :string, [:symbol]) if agreement_object add_solr_value(solr_doc, 'default_use_license_machine', use_license, :string, [:stored_sortable]) solr_doc end |
#use_license ⇒ Object
185 186 187 188 189 |
# File 'lib/dor/models/concerns/editable.rb', line 185 def use_license return creative_commons_license unless creative_commons_license.blank? return open_data_commons_license unless open_data_commons_license.blank? nil end |
#use_license=(use_license_machine) ⇒ Object
If set to ‘:none` then Use License is removed
227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 |
# File 'lib/dor/models/concerns/editable.rb', line 227 def use_license=(use_license_machine) if use_license_machine.blank? || use_license_machine == :none # delete use license by directly removing the XML used to define the use license defaultObjectRights.update_term!(:creative_commons, ' ') defaultObjectRights.update_term!(:creative_commons_human, ' ') defaultObjectRights.update_term!(:open_data_commons, ' ') defaultObjectRights.update_term!(:open_data_commons_human, ' ') elsif CREATIVE_COMMONS_USE_LICENSES.include? use_license_machine self.creative_commons_license = use_license_machine self.creative_commons_license_human = CREATIVE_COMMONS_USE_LICENSES[use_license_machine][:human_readable] elsif OPEN_DATA_COMMONS_USE_LICENSES.include? use_license_machine self.open_data_commons_license = use_license_machine self.open_data_commons_license_human = OPEN_DATA_COMMONS_USE_LICENSES[use_license_machine][:human_readable] else fail ArgumentError, "'#{use_license_machine}' is not a valid license code" end end |
#use_license_human ⇒ Object
197 198 199 200 201 |
# File 'lib/dor/models/concerns/editable.rb', line 197 def use_license_human return creative_commons_license_human unless creative_commons_license_human.blank? return open_data_commons_license_human unless open_data_commons_license_human.blank? nil end |
#use_license_uri ⇒ Object
191 192 193 194 195 |
# File 'lib/dor/models/concerns/editable.rb', line 191 def use_license_uri return defaultObjectRights.creative_commons.uri.first unless defaultObjectRights.creative_commons.uri.blank? return defaultObjectRights.open_data_commons.uri.first unless defaultObjectRights.open_data_commons.uri.blank? nil end |
#use_statement ⇒ Object
153 154 155 |
# File 'lib/dor/models/concerns/editable.rb', line 153 def use_statement defaultObjectRights.use_statement.first end |
#use_statement=(val) ⇒ Object
157 158 159 |
# File 'lib/dor/models/concerns/editable.rb', line 157 def use_statement=(val) defaultObjectRights.update_term!(:use_statement, val.nil? ? '' : val) end |