Module: ScormEngine::Api::Endpoints::Dispatches

Included in:
ScormEngine::Api::Endpoints
Defined in:
lib/scorm_engine/api/endpoints/dispatches.rb

Instance Method Summary collapse

Instance Method Details

#delete_dispatch(options = {}) ⇒ ScormEngine::Response

Delete a dispatch.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The ID of the dispatch to delete.

Returns:

See Also:



207
208
209
210
211
212
213
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 207

def delete_dispatch(options = {})
  require_options(options, :dispatch_id)

  response = delete("dispatches/#{options[:dispatch_id]}")

  Response.new(raw_response: response)
end

#get_dispatch(options = {}) ⇒ ScormEngine::Models::Dispatch

Get a dispatch.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The ID of the dispatch to get.

Returns:

See Also:



128
129
130
131
132
133
134
135
136
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 128

def get_dispatch(options = {})
  require_options(options, :dispatch_id)

  response = get("dispatches/#{options[:dispatch_id]}")

  result = response.success? ? ScormEngine::Models::Dispatch.new_from_api(response.body) : nil

  Response.new(raw_response: response, result: result)
end

#get_dispatch_enabled(options = {}) ⇒ ScormEngine::Response

Get the enabled status of a dispatch.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The ID of the dispatch to delete.

Returns:

See Also:



227
228
229
230
231
232
233
234
235
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 227

def get_dispatch_enabled(options = {})
  require_options(options, :dispatch_id)

  response = get("dispatches/#{options[:dispatch_id]}/enabled")

  result = response.success? ? response.body : nil

  Response.new(raw_response: response, result: result)
end

#get_dispatch_zip(options = {}) ⇒ ScormEngine::Models::DispatchZip

Get the ZIP dispatch package.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The ID of the dispatch to delete.

  • :type (String) — default: SCORM12 —

    The type of dispatch package to export (SCORM12, SCORM2004-3RD or AICC)

Returns:

See Also:



277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 277

def get_dispatch_zip(options = {})
  require_options(options, :dispatch_id)

  options = options.dup
  dispatch_id = options.delete(:dispatch_id)
  options[:type] ||= "SCORM12"

  response = get("dispatches/#{dispatch_id}/zip", options)

  result = if response.success?
             ScormEngine::Models::DispatchZip.new(
               dispatch_id: dispatch_id,
               type: options[:type],
               filename: response.headers["content-disposition"].match(/; filename="(.*?)"/)&.captures&.first,
               body: response.body,
             )
           end

  Response.new(raw_response: response, result: result)
end

#get_dispatches(options = {}) ⇒ Enumerator<ScormEngine::Models::Dispatch>

Get a list of dispatches.

Parameters:

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

Options Hash (options):

  • :course_id (String) —

    Limit the results to dispatches of the specified course.

  • :since (DateTime) —

    Only dispatches updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, the server’s time zone will be used.

Returns:

See Also:



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

def get_dispatches(options = {})
  options = options.dup

  response = get("dispatches", options)

  result = Enumerator.new do |enum|
    loop do
      response.success? && response.body["dispatches"].each do |course|
        enum << ScormEngine::Models::Dispatch.new_from_api(course)
      end
      break if !response.success? || response.body["more"].nil?
      response = get(response.body["more"])
    end
  end

  Response.new(raw_response: response, result: result)
end

#post_dispatch(options = {}) ⇒ ScormEngine::Response

Create a dispatch.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The dispatch ID.

  • :destination_id (String) —

    The destination ID.

  • :course_id (String) —

    The course ID.

  • :allow_new_registrations (Boolean) — default: false —

    If true, then new registrations can be created for this dispatch.

  • :instanced (Boolean) — default: false —

    If true, then a new registration instance will be created if the client LMS doesn’t provide launch data for an existing one. Otherwise, the same instance will always be used for the given cmi.learner_id.

  • :registration_cap (Integer) — default: 0 —

    The maximum number of registrations that can be created for this dispatch, where ‘0’ means ‘unlimited registrations’.

  • :expiration_date (Date) — default: "none" —

    The date after which this dispatch will be disabled as an ISO 8601 string, or "none" for no expiration date.

  • :external_config (String) — default: "" —

    Serialized external configuration information to include when launching the dispatched package.

Returns:

See Also:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 80

def post_dispatch(options = {})
  require_options(options, :dispatch_id, :destination_id, :course_id)

  options = options.dup

  options[:allow_new_registrations] = false unless options[:allow_new_registrations]
  options[:instanced] = false unless options[:instanced]
  options[:registration_cap] = [0, options[:registration_cap].to_i].max
  options[:expiration_date] = begin
                                date = options[:expiration_date]
                                date = date.is_a?(String) ? Date.parse(date) : date
                                date&.iso8601 # might be nil
                              rescue ArgumentError
                                "none"
                              end

  body = {
    dispatches: [
      id: options[:dispatch_id],
      data: {
        destinationId: options[:destination_id],
        courseId: options[:course_id],
        allowNewRegistrations: options[:allow_new_registrations],
        instanced: options[:instanced],
        registrationCap: options[:registration_cap],
        expirationDate: options[:expiration_date],
        externalConfig: options[:external_config],
      },
    ]
  }

  response = post("dispatches", {}, body)

  Response.new(raw_response: response)
end

#put_dispatch(options = {}) ⇒ ScormEngine::Response

Update a dispatch.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The dispatch ID.

  • :destination_id (String) —

    The destination ID.

  • :course_id (String) —

    The course ID.

  • :allow_new_registrations (Boolean) — default: false —

    If true, then new registrations can be created for this dispatch.

  • :instanced (Boolean) — default: false —

    If true, then a new registration instance will be created if the client LMS doesn’t provide launch data for an existing one. Otherwise, the same instance will always be used for the given cmi.learner_id.

  • :registration_cap (Integer) — default: 0 —

    The maximum number of registrations that can be created for this dispatch, where ‘0’ means ‘unlimited registrations’.

  • :expiration_date (Date) — default: "none" —

    The date after which this dispatch will be disabled as an ISO 8601 string, or "none" for no expiration date.

  • :external_config (String) — default: "" —

    Serialized external configuration information to include when launching the dispatched package.

Returns:

See Also:



177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 177

def put_dispatch(options = {})
  require_options(options, :dispatch_id, :destination_id, :course_id)

  body = {
    destinationId: options[:destination_id],
    courseId: options[:course_id],
    allowNewRegistrations: options[:allow_new_registrations],
    instanced: options[:instanced],
    registrationCap: options[:registration_cap],
    expirationDate: options[:expiration_date],
    externalConfig: options[:external_config],
  }

  response = put("dispatches/#{options[:dispatch_id]}", {}, body)

  Response.new(raw_response: response)
end

#put_dispatch_enabled(options = {}) ⇒ ScormEngine::Response

Enable or disable the dispatch.

Parameters:

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

Options Hash (options):

  • :dispatch_id (String) —

    The ID of the dispatch

  • :enabled (Boolean) —

    The enabledness of the dispatch

Returns:

See Also:



252
253
254
255
256
257
258
259
260
 
# File 'lib/scorm_engine/api/endpoints/dispatches.rb', line 252

def put_dispatch_enabled(options = {})
  require_options(options, :dispatch_id, :enabled)

  body = options[:enabled].to_s

  response = put("dispatches/#{options[:dispatch_id]}/enabled", {}, body)

  Response.new(raw_response: response)
end