Class: ScormEngine::Models::Course

Inherits:
Base
  • Object
show all
Defined in:
lib/scorm_engine/models/course.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Methods inherited from Base

#to_hash

Instance Attribute Details

#course_learning_standard ⇒ String

The course's learning standard.

Returns:

  • (String) —

    (SCORM_11, SCORM_12, SCORM_2004_2ND_EDITION, SCORM_2004_3RD_EDITION, SCORM_2004_4TH_EDITION, AICC, XAPI, CMI5)



15
16
17
 
# File 'lib/scorm_engine/models/course.rb', line 15

def course_learning_standard
  @course_learning_standard
end

#description ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def description
  @description
end

#id ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def id
  @id
end

#registration_count ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def registration_count
  @registration_count
end

#scaled_passing_score ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def scaled_passing_score
  @scaled_passing_score
end

#title ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def title
  @title
end

#updated ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def updated
  @updated
end

#version ⇒ Object

TODO: Not sure we want this to be settable. Will depend on how we go about creating/updating records. For now it makes it easier to create instances from API options hash.



9
10
11
 
# File 'lib/scorm_engine/models/course.rb', line 9

def version
  @version
end

#web_path ⇒ String

The web path at which the course's contents is hosted. For AICC courses, refer to the href proprety of the child activities as this value will not be available.

Returns:

  • (String) 


22
23
24
 
# File 'lib/scorm_engine/models/course.rb', line 22

def web_path
  @web_path
end

Class Method Details

.get_scaled_passing_score_from_api(options = {}) ⇒ Integer

Extract and normalize the scaled passing score from the API options.

Parameters:

  • options (Hash) (defaults to: {}) —

    The API options hash

Returns:

  • (Integer) —

    An integer between 0 and 100 or nil if undefined.



67
68
69
70
71
72
73
74
 
# File 'lib/scorm_engine/models/course.rb', line 67

def self.get_scaled_passing_score_from_api(options = {})
  first_child = options.fetch("rootActivity", {}).fetch("children", [{}]).first
  score = first_child.is_a?(Hash) ? first_child["scaledPassingScore"] : nil
  return if score.nil?
  score = score.to_f
  score *= 100 if score <= 1.0
  score.to_i
end

.get_title_from_api(options = {}) ⇒ String

Extract and sanitize the title from the API options.

Special consideration is given to two commonly found, but useless titles which if found will result in a blank title.

Parameters:

  • options (Hash) (defaults to: {}) —

    The API options hash

Returns:

  • (String) 


52
53
54
55
56
 
# File 'lib/scorm_engine/models/course.rb', line 52

def self.get_title_from_api(options = {})
  title = ScormEngine::Utils.sanitized_text(options["title"])
  title = "" if ["Title", "Captivate E-Learning Course"].include?(title)
  title
end

.new_from_api(options = {}) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/scorm_engine/models/course.rb', line 24

def self.new_from_api(options = {})
  this = new

  this.options = options.dup
  this.id = options["id"]
  this.version = options["version"]
  this.title = get_title_from_api(options)
  this.registration_count = options["registrationCount"]
  this.updated = Time.parse(options["updated"]) if options.key?("updated")
  this.description = options.fetch("metadata", {})["description"]
  this.scaled_passing_score = get_scaled_passing_score_from_api(options)
  this.course_learning_standard = options["courseLearningStandard"]
  this.web_path = options["webPath"]

  this
end