rustici_software_cloud_v2 1.1.0 → 2.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (147) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +1 -1
  3. data/README.md +355 -356
  4. data/lib/rustici_software_cloud_v2/api/about_api.rb +4 -4
  5. data/lib/rustici_software_cloud_v2/api/application_management_api.rb +190 -62
  6. data/lib/rustici_software_cloud_v2/api/authentication_api.rb +9 -17
  7. data/lib/rustici_software_cloud_v2/api/course_api.rb +903 -196
  8. data/lib/rustici_software_cloud_v2/api/dispatch_api.rb +458 -268
  9. data/lib/rustici_software_cloud_v2/api/invitations_api.rb +212 -170
  10. data/lib/rustici_software_cloud_v2/api/learner_api.rb +48 -48
  11. data/lib/rustici_software_cloud_v2/api/ping_api.rb +2 -0
  12. data/lib/rustici_software_cloud_v2/api/registration_api.rb +255 -269
  13. data/lib/rustici_software_cloud_v2/api/reporting_api.rb +19 -23
  14. data/lib/rustici_software_cloud_v2/api/xapi_api.rb +81 -66
  15. data/lib/rustici_software_cloud_v2/api/zoomi_api.rb +124 -55
  16. data/lib/rustici_software_cloud_v2/api_client.rb +2 -2
  17. data/lib/rustici_software_cloud_v2/configuration.rb +3 -3
  18. data/lib/rustici_software_cloud_v2/models/about_schema.rb +3 -1
  19. data/lib/rustici_software_cloud_v2/models/activity_result_schema.rb +8 -36
  20. data/lib/rustici_software_cloud_v2/models/application_info_schema.rb +234 -0
  21. data/lib/rustici_software_cloud_v2/models/application_list_schema.rb +3 -1
  22. data/lib/rustici_software_cloud_v2/models/application_request_schema.rb +186 -0
  23. data/lib/rustici_software_cloud_v2/models/application_schema.rb +3 -1
  24. data/lib/rustici_software_cloud_v2/models/application_token.rb +3 -1
  25. data/lib/rustici_software_cloud_v2/models/asset_file_schema.rb +194 -0
  26. data/lib/rustici_software_cloud_v2/models/batch_tags_schema.rb +3 -1
  27. data/lib/rustici_software_cloud_v2/models/comment_schema.rb +3 -1
  28. data/lib/rustici_software_cloud_v2/models/completion_amount_schema.rb +3 -1
  29. data/lib/rustici_software_cloud_v2/models/course_activity_schema.rb +5 -29
  30. data/lib/rustici_software_cloud_v2/models/course_list_non_paged_schema.rb +3 -1
  31. data/lib/rustici_software_cloud_v2/models/course_list_schema.rb +4 -1
  32. data/lib/rustici_software_cloud_v2/models/course_reference_schema.rb +3 -1
  33. data/lib/rustici_software_cloud_v2/models/course_schema.rb +5 -29
  34. data/lib/rustici_software_cloud_v2/models/create_dispatch_id_schema.rb +2 -19
  35. data/lib/rustici_software_cloud_v2/models/create_dispatch_list_schema.rb +3 -1
  36. data/lib/rustici_software_cloud_v2/models/create_dispatch_schema.rb +4 -2
  37. data/lib/rustici_software_cloud_v2/models/create_private_invitation_schema.rb +4 -2
  38. data/lib/rustici_software_cloud_v2/models/create_public_invitation_schema.rb +4 -2
  39. data/lib/rustici_software_cloud_v2/models/create_registration_schema.rb +3 -1
  40. data/lib/rustici_software_cloud_v2/models/credential_created_schema.rb +3 -1
  41. data/lib/rustici_software_cloud_v2/models/credential_list_schema.rb +3 -1
  42. data/lib/rustici_software_cloud_v2/models/credential_request_schema.rb +3 -1
  43. data/lib/rustici_software_cloud_v2/models/credential_schema.rb +3 -1
  44. data/lib/rustici_software_cloud_v2/models/destination_id_schema.rb +3 -1
  45. data/lib/rustici_software_cloud_v2/models/destination_list_schema.rb +4 -2
  46. data/lib/rustici_software_cloud_v2/models/destination_schema.rb +3 -1
  47. data/lib/rustici_software_cloud_v2/models/dispatch_id_schema.rb +3 -1
  48. data/lib/rustici_software_cloud_v2/models/dispatch_list_schema.rb +4 -1
  49. data/lib/rustici_software_cloud_v2/models/dispatch_lti_info_schema.rb +221 -0
  50. data/lib/rustici_software_cloud_v2/models/dispatch_registration_count_schema.rb +3 -1
  51. data/lib/rustici_software_cloud_v2/models/dispatch_schema.rb +43 -3
  52. data/lib/rustici_software_cloud_v2/models/enabled_schema.rb +3 -1
  53. data/lib/rustici_software_cloud_v2/models/file_list_item_schema.rb +205 -0
  54. data/lib/rustici_software_cloud_v2/models/file_list_schema.rb +187 -0
  55. data/lib/rustici_software_cloud_v2/models/import_asset_request_schema.rb +207 -0
  56. data/lib/rustici_software_cloud_v2/models/import_fetch_request_schema.rb +29 -6
  57. data/lib/rustici_software_cloud_v2/models/import_job_result_schema.rb +5 -29
  58. data/lib/rustici_software_cloud_v2/models/import_media_file_reference_request_schema.rb +216 -0
  59. data/lib/rustici_software_cloud_v2/models/import_request_schema.rb +195 -0
  60. data/lib/rustici_software_cloud_v2/models/import_result_schema.rb +3 -1
  61. data/lib/rustici_software_cloud_v2/models/integer_result_schema.rb +3 -1
  62. data/lib/rustici_software_cloud_v2/models/invitation_email_schema.rb +3 -1
  63. data/lib/rustici_software_cloud_v2/models/invitation_job_status_schema.rb +5 -29
  64. data/lib/rustici_software_cloud_v2/models/invitation_summary_list.rb +4 -1
  65. data/lib/rustici_software_cloud_v2/models/invitation_summary_schema.rb +3 -1
  66. data/lib/rustici_software_cloud_v2/models/item_value_pair_schema.rb +3 -1
  67. data/lib/rustici_software_cloud_v2/models/launch_auth_options_schema.rb +3 -1
  68. data/lib/rustici_software_cloud_v2/models/launch_auth_schema.rb +5 -29
  69. data/lib/rustici_software_cloud_v2/models/launch_history_list_schema.rb +3 -1
  70. data/lib/rustici_software_cloud_v2/models/launch_history_schema.rb +8 -36
  71. data/lib/rustici_software_cloud_v2/models/launch_link_request_schema.rb +5 -3
  72. data/lib/rustici_software_cloud_v2/models/launch_link_schema.rb +3 -1
  73. data/lib/rustici_software_cloud_v2/models/learner_preference_schema.rb +3 -1
  74. data/lib/rustici_software_cloud_v2/models/learner_schema.rb +3 -1
  75. data/lib/rustici_software_cloud_v2/models/media_file_metadata_schema.rb +213 -0
  76. data/lib/rustici_software_cloud_v2/models/message_schema.rb +3 -1
  77. data/lib/rustici_software_cloud_v2/models/metadata_schema.rb +10 -8
  78. data/lib/rustici_software_cloud_v2/models/objective_schema.rb +11 -43
  79. data/lib/rustici_software_cloud_v2/models/permissions_schema.rb +3 -1
  80. data/lib/rustici_software_cloud_v2/models/ping_schema.rb +3 -1
  81. data/lib/rustici_software_cloud_v2/models/post_back_schema.rb +8 -36
  82. data/lib/rustici_software_cloud_v2/models/private_invitation_list.rb +4 -1
  83. data/lib/rustici_software_cloud_v2/models/private_invitation_schema.rb +5 -3
  84. data/lib/rustici_software_cloud_v2/models/private_invitation_update_schema.rb +215 -0
  85. data/lib/rustici_software_cloud_v2/models/public_invitation_list.rb +4 -1
  86. data/lib/rustici_software_cloud_v2/models/public_invitation_schema.rb +6 -4
  87. data/lib/rustici_software_cloud_v2/models/public_invitation_update_schema.rb +228 -0
  88. data/lib/rustici_software_cloud_v2/models/registration_list_schema.rb +4 -1
  89. data/lib/rustici_software_cloud_v2/models/registration_schema.rb +3 -1
  90. data/lib/rustici_software_cloud_v2/models/reportage_account_info_schema.rb +3 -1
  91. data/lib/rustici_software_cloud_v2/models/reportage_account_info_usage_schema.rb +3 -1
  92. data/lib/rustici_software_cloud_v2/models/reportage_auth_token_schema.rb +3 -1
  93. data/lib/rustici_software_cloud_v2/models/reportage_link_schema.rb +3 -1
  94. data/lib/rustici_software_cloud_v2/models/response_error.rb +3 -1
  95. data/lib/rustici_software_cloud_v2/models/runtime_interaction_schema.rb +5 -29
  96. data/lib/rustici_software_cloud_v2/models/runtime_objective_schema.rb +8 -36
  97. data/lib/rustici_software_cloud_v2/models/runtime_schema.rb +5 -29
  98. data/lib/rustici_software_cloud_v2/models/score_schema.rb +3 -1
  99. data/lib/rustici_software_cloud_v2/models/setting_item.rb +5 -29
  100. data/lib/rustici_software_cloud_v2/models/setting_list_schema.rb +3 -1
  101. data/lib/rustici_software_cloud_v2/models/setting_metadata.rb +5 -29
  102. data/lib/rustici_software_cloud_v2/models/setting_valid_value.rb +3 -1
  103. data/lib/rustici_software_cloud_v2/models/settings_individual_schema.rb +3 -1
  104. data/lib/rustici_software_cloud_v2/models/settings_post_schema.rb +3 -1
  105. data/lib/rustici_software_cloud_v2/models/shared_data_entry_schema.rb +3 -1
  106. data/lib/rustici_software_cloud_v2/models/static_properties_schema.rb +3 -1
  107. data/lib/rustici_software_cloud_v2/models/string_result_schema.rb +3 -1
  108. data/lib/rustici_software_cloud_v2/models/tag_list_schema.rb +3 -1
  109. data/lib/rustici_software_cloud_v2/models/title_schema.rb +3 -1
  110. data/lib/rustici_software_cloud_v2/models/token_request_schema.rb +3 -1
  111. data/lib/rustici_software_cloud_v2/models/update_application_schema.rb +196 -0
  112. data/lib/rustici_software_cloud_v2/models/update_dispatch_schema.rb +15 -3
  113. data/lib/rustici_software_cloud_v2/models/user_invitation_list.rb +4 -1
  114. data/lib/rustici_software_cloud_v2/models/user_invitation_schema.rb +3 -1
  115. data/lib/rustici_software_cloud_v2/models/user_invitation_schema_registration_report.rb +3 -1
  116. data/lib/rustici_software_cloud_v2/models/xapi_account.rb +3 -1
  117. data/lib/rustici_software_cloud_v2/models/xapi_activity.rb +3 -1
  118. data/lib/rustici_software_cloud_v2/models/xapi_activity_definition.rb +3 -1
  119. data/lib/rustici_software_cloud_v2/models/xapi_agent_group.rb +5 -29
  120. data/lib/rustici_software_cloud_v2/models/xapi_attachment.rb +3 -1
  121. data/lib/rustici_software_cloud_v2/models/xapi_context.rb +3 -1
  122. data/lib/rustici_software_cloud_v2/models/xapi_context_activity.rb +3 -1
  123. data/lib/rustici_software_cloud_v2/models/xapi_credential_auth_type_schema.rb +5 -29
  124. data/lib/rustici_software_cloud_v2/models/xapi_credential_permissions_level_schema.rb +5 -29
  125. data/lib/rustici_software_cloud_v2/models/xapi_credential_post_schema.rb +3 -1
  126. data/lib/rustici_software_cloud_v2/models/xapi_credential_put_schema.rb +3 -1
  127. data/lib/rustici_software_cloud_v2/models/xapi_credential_schema.rb +3 -1
  128. data/lib/rustici_software_cloud_v2/models/xapi_credentials_list_schema.rb +4 -1
  129. data/lib/rustici_software_cloud_v2/models/xapi_endpoint_schema.rb +3 -1
  130. data/lib/rustici_software_cloud_v2/models/xapi_interaction_component.rb +3 -1
  131. data/lib/rustici_software_cloud_v2/models/xapi_result.rb +3 -1
  132. data/lib/rustici_software_cloud_v2/models/xapi_score.rb +3 -1
  133. data/lib/rustici_software_cloud_v2/models/xapi_statement.rb +3 -1
  134. data/lib/rustici_software_cloud_v2/models/xapi_statement_pipe_list_schema.rb +3 -1
  135. data/lib/rustici_software_cloud_v2/models/xapi_statement_pipe_post_schema.rb +3 -1
  136. data/lib/rustici_software_cloud_v2/models/xapi_statement_pipe_put_schema.rb +3 -1
  137. data/lib/rustici_software_cloud_v2/models/xapi_statement_pipe_schema.rb +3 -1
  138. data/lib/rustici_software_cloud_v2/models/xapi_statement_reference.rb +3 -1
  139. data/lib/rustici_software_cloud_v2/models/xapi_statement_result.rb +3 -1
  140. data/lib/rustici_software_cloud_v2/models/xapi_verb.rb +3 -1
  141. data/lib/rustici_software_cloud_v2/models/zoomi_company_id.rb +3 -1
  142. data/lib/rustici_software_cloud_v2/models/zoomi_course_options_schema.rb +13 -1
  143. data/lib/rustici_software_cloud_v2/version.rb +1 -1
  144. data/lib/rustici_software_cloud_v2.rb +13 -0
  145. data/rustici_software_cloud_v2.gemspec +2 -1
  146. data/spec/api_client_spec.rb +17 -0
  147. metadata +35 -2
@@ -19,8 +19,8 @@ module RusticiSoftwareCloudV2
19
19
  def initialize(api_client = ApiClient.default)
20
20
  @api_client = api_client
21
21
  end
22
- # DestinationsByTenant
23
- # Create multiple destinations.
22
+ # Create a group of Destinations
23
+ # Creates a group of destinations. A destination is a label used to identify an entity outside of SCORM Cloud, such as an LMS. Used in conjunction with dispatches to provide access control mechanisms for the courses distributed to the destination.
24
24
  # @param destinations_list
25
25
  # @param [Hash] opts the optional parameters
26
26
  # @return [nil]
@@ -29,8 +29,8 @@ module RusticiSoftwareCloudV2
29
29
  nil
30
30
  end
31
31
 
32
- # DestinationsByTenant
33
- # Create multiple destinations.
32
+ # Create a group of Destinations
33
+ # Creates a group of destinations. A destination is a label used to identify an entity outside of SCORM Cloud, such as an LMS. Used in conjunction with dispatches to provide access control mechanisms for the courses distributed to the destination.
34
34
  # @param destinations_list
35
35
  # @param [Hash] opts the optional parameters
36
36
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -39,7 +39,7 @@ module RusticiSoftwareCloudV2
39
39
  @api_client.config.logger.debug 'Calling API: DispatchApi.create_destinations ...'
40
40
  end
41
41
  # verify the required parameter 'destinations_list' is set
42
- if @api_client.config.client_side_validation && destinations_list.nil?
42
+ if destinations_list.nil?
43
43
  fail ArgumentError, "Missing the required parameter 'destinations_list' when calling DispatchApi.create_destinations"
44
44
  end
45
45
  # resource path
@@ -72,8 +72,8 @@ module RusticiSoftwareCloudV2
72
72
  end
73
73
  return data, status_code, headers
74
74
  end
75
- # Create dispatches.
76
- # Create multiple dispatches at once.
75
+ # Create a group of Dispatches
76
+ # Creates a group of dispatches. Dispatches are the connection between a course and a destination. A dispatch zip package is a distributable course stub which, upon launch in a third-party LMS, will reference and launch the underlying course in SCORM Cloud. As an extension, dispatches allow for limiting access control even after the zip file has been given to the destination. >**Caution:** >Only one dispatch can exist for a given course-destination combination. If calling this method with the same course and destination supplied, the old one will be loaded for modification. An exception to this is if a dispatchId is passed in the body, the request will fail with a 400 response warning that the dispatch already exists. This is to prevent confusion over which dispatchId is to be used in future requests.
77
77
  # @param dispatch_list
78
78
  # @param [Hash] opts the optional parameters
79
79
  # @return [nil]
@@ -82,8 +82,8 @@ module RusticiSoftwareCloudV2
82
82
  nil
83
83
  end
84
84
 
85
- # Create dispatches.
86
- # Create multiple dispatches at once.
85
+ # Create a group of Dispatches
86
+ # Creates a group of dispatches. Dispatches are the connection between a course and a destination. A dispatch zip package is a distributable course stub which, upon launch in a third-party LMS, will reference and launch the underlying course in SCORM Cloud. As an extension, dispatches allow for limiting access control even after the zip file has been given to the destination. &gt;**Caution:** &gt;Only one dispatch can exist for a given course-destination combination. If calling this method with the same course and destination supplied, the old one will be loaded for modification. An exception to this is if a dispatchId is passed in the body, the request will fail with a 400 response warning that the dispatch already exists. This is to prevent confusion over which dispatchId is to be used in future requests.
87
87
  # @param dispatch_list
88
88
  # @param [Hash] opts the optional parameters
89
89
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -92,7 +92,7 @@ module RusticiSoftwareCloudV2
92
92
  @api_client.config.logger.debug 'Calling API: DispatchApi.create_dispatches ...'
93
93
  end
94
94
  # verify the required parameter 'dispatch_list' is set
95
- if @api_client.config.client_side_validation && dispatch_list.nil?
95
+ if dispatch_list.nil?
96
96
  fail ArgumentError, "Missing the required parameter 'dispatch_list' when calling DispatchApi.create_dispatches"
97
97
  end
98
98
  # resource path
@@ -125,8 +125,8 @@ module RusticiSoftwareCloudV2
125
125
  end
126
126
  return data, status_code, headers
127
127
  end
128
- # Delete destination
129
- # Delete the destination with `destinationId`
128
+ # Delete a Destination
129
+ # Deletes the specified destination. >**Caution:** >This will also delete all dispatches belonging to the destination.
130
130
  # @param destination_id Identifier for the destination
131
131
  # @param [Hash] opts the optional parameters
132
132
  # @return [nil]
@@ -135,8 +135,8 @@ module RusticiSoftwareCloudV2
135
135
  nil
136
136
  end
137
137
 
138
- # Delete destination
139
- # Delete the destination with &#x60;destinationId&#x60;
138
+ # Delete a Destination
139
+ # Deletes the specified destination. &gt;**Caution:** &gt;This will also delete all dispatches belonging to the destination.
140
140
  # @param destination_id Identifier for the destination
141
141
  # @param [Hash] opts the optional parameters
142
142
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -145,7 +145,7 @@ module RusticiSoftwareCloudV2
145
145
  @api_client.config.logger.debug 'Calling API: DispatchApi.delete_destination ...'
146
146
  end
147
147
  # verify the required parameter 'destination_id' is set
148
- if @api_client.config.client_side_validation && destination_id.nil?
148
+ if destination_id.nil?
149
149
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.delete_destination"
150
150
  end
151
151
  # resource path
@@ -178,8 +178,8 @@ module RusticiSoftwareCloudV2
178
178
  end
179
179
  return data, status_code, headers
180
180
  end
181
- # Delete dispatches in destination
182
- # Delete the dispatches in a destination
181
+ # Delete a Destination's Dispatches
182
+ # Deletes all the dispatches from the destination. >**Caution:** >This will invalidate any existing dispatch packages, rendering them unlaunchable.
183
183
  # @param destination_id Identifier for the destination
184
184
  # @param [Hash] opts the optional parameters
185
185
  # @return [nil]
@@ -188,8 +188,8 @@ module RusticiSoftwareCloudV2
188
188
  nil
189
189
  end
190
190
 
191
- # Delete dispatches in destination
192
- # Delete the dispatches in a destination
191
+ # Delete a Destination&#39;s Dispatches
192
+ # Deletes all the dispatches from the destination. &gt;**Caution:** &gt;This will invalidate any existing dispatch packages, rendering them unlaunchable.
193
193
  # @param destination_id Identifier for the destination
194
194
  # @param [Hash] opts the optional parameters
195
195
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -198,7 +198,7 @@ module RusticiSoftwareCloudV2
198
198
  @api_client.config.logger.debug 'Calling API: DispatchApi.delete_destination_dispatches ...'
199
199
  end
200
200
  # verify the required parameter 'destination_id' is set
201
- if @api_client.config.client_side_validation && destination_id.nil?
201
+ if destination_id.nil?
202
202
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.delete_destination_dispatches"
203
203
  end
204
204
  # resource path
@@ -231,8 +231,8 @@ module RusticiSoftwareCloudV2
231
231
  end
232
232
  return data, status_code, headers
233
233
  end
234
- # Delete the tags for this destination
235
- # Delete the tags for this destination
234
+ # Delete tags from a Destination
235
+ # Deletes the specified tags from the destination. Deleting tags that do not exist will still result in a success.
236
236
  # @param destination_id Identifier for the destination
237
237
  # @param tags
238
238
  # @param [Hash] opts the optional parameters
@@ -242,8 +242,8 @@ module RusticiSoftwareCloudV2
242
242
  nil
243
243
  end
244
244
 
245
- # Delete the tags for this destination
246
- # Delete the tags for this destination
245
+ # Delete tags from a Destination
246
+ # Deletes the specified tags from the destination. Deleting tags that do not exist will still result in a success.
247
247
  # @param destination_id Identifier for the destination
248
248
  # @param tags
249
249
  # @param [Hash] opts the optional parameters
@@ -253,11 +253,11 @@ module RusticiSoftwareCloudV2
253
253
  @api_client.config.logger.debug 'Calling API: DispatchApi.delete_destination_tags ...'
254
254
  end
255
255
  # verify the required parameter 'destination_id' is set
256
- if @api_client.config.client_side_validation && destination_id.nil?
256
+ if destination_id.nil?
257
257
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.delete_destination_tags"
258
258
  end
259
259
  # verify the required parameter 'tags' is set
260
- if @api_client.config.client_side_validation && tags.nil?
260
+ if tags.nil?
261
261
  fail ArgumentError, "Missing the required parameter 'tags' when calling DispatchApi.delete_destination_tags"
262
262
  end
263
263
  # resource path
@@ -290,8 +290,8 @@ module RusticiSoftwareCloudV2
290
290
  end
291
291
  return data, status_code, headers
292
292
  end
293
- # Delete the dispatch with `dispatchId`.
294
- # Delete the dispatch with `dispatchId`.
293
+ # Delete a Dispatch
294
+ # Deletes the specified dispatch. >**Caution:** >This will invalidate any existing dispatch packages, rendering them unlaunchable.
295
295
  # @param dispatch_id Identifier for the dispatch
296
296
  # @param [Hash] opts the optional parameters
297
297
  # @return [nil]
@@ -300,8 +300,8 @@ module RusticiSoftwareCloudV2
300
300
  nil
301
301
  end
302
302
 
303
- # Delete the dispatch with &#x60;dispatchId&#x60;.
304
- # Delete the dispatch with &#x60;dispatchId&#x60;.
303
+ # Delete a Dispatch
304
+ # Deletes the specified dispatch. &gt;**Caution:** &gt;This will invalidate any existing dispatch packages, rendering them unlaunchable.
305
305
  # @param dispatch_id Identifier for the dispatch
306
306
  # @param [Hash] opts the optional parameters
307
307
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -310,7 +310,7 @@ module RusticiSoftwareCloudV2
310
310
  @api_client.config.logger.debug 'Calling API: DispatchApi.delete_dispatch ...'
311
311
  end
312
312
  # verify the required parameter 'dispatch_id' is set
313
- if @api_client.config.client_side_validation && dispatch_id.nil?
313
+ if dispatch_id.nil?
314
314
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.delete_dispatch"
315
315
  end
316
316
  # resource path
@@ -343,8 +343,8 @@ module RusticiSoftwareCloudV2
343
343
  end
344
344
  return data, status_code, headers
345
345
  end
346
- # DispatchesByTenantAndDispatchId
347
- # Delete the postback info dispatch with 'dispatchId'.
346
+ # Delete postback information from a Dispatch
347
+ # Clears the postback settings from the dispatch. This causes the postback settings to inherit a value from a higher level (e.g. application). If there is no setting at the application level, this will disable postbacks for the dispatch.
348
348
  # @param dispatch_id Identifier for the dispatch
349
349
  # @param [Hash] opts the optional parameters
350
350
  # @return [nil]
@@ -353,8 +353,8 @@ module RusticiSoftwareCloudV2
353
353
  nil
354
354
  end
355
355
 
356
- # DispatchesByTenantAndDispatchId
357
- # Delete the postback info dispatch with &#39;dispatchId&#39;.
356
+ # Delete postback information from a Dispatch
357
+ # Clears the postback settings from the dispatch. This causes the postback settings to inherit a value from a higher level (e.g. application). If there is no setting at the application level, this will disable postbacks for the dispatch.
358
358
  # @param dispatch_id Identifier for the dispatch
359
359
  # @param [Hash] opts the optional parameters
360
360
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -363,7 +363,7 @@ module RusticiSoftwareCloudV2
363
363
  @api_client.config.logger.debug 'Calling API: DispatchApi.delete_dispatch_postback_info ...'
364
364
  end
365
365
  # verify the required parameter 'dispatch_id' is set
366
- if @api_client.config.client_side_validation && dispatch_id.nil?
366
+ if dispatch_id.nil?
367
367
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.delete_dispatch_postback_info"
368
368
  end
369
369
  # resource path
@@ -396,8 +396,8 @@ module RusticiSoftwareCloudV2
396
396
  end
397
397
  return data, status_code, headers
398
398
  end
399
- # Delete the tags for this dispatch.
400
- # Delete the tags for this dispatch.
399
+ # Delete tags from a Dispatch
400
+ # Deletes the specified tags from the dispatch. Deleting tags that do not exist will still result in a success.
401
401
  # @param dispatch_id Identifier for the dispatch
402
402
  # @param tags
403
403
  # @param [Hash] opts the optional parameters
@@ -407,8 +407,8 @@ module RusticiSoftwareCloudV2
407
407
  nil
408
408
  end
409
409
 
410
- # Delete the tags for this dispatch.
411
- # Delete the tags for this dispatch.
410
+ # Delete tags from a Dispatch
411
+ # Deletes the specified tags from the dispatch. Deleting tags that do not exist will still result in a success.
412
412
  # @param dispatch_id Identifier for the dispatch
413
413
  # @param tags
414
414
  # @param [Hash] opts the optional parameters
@@ -418,11 +418,11 @@ module RusticiSoftwareCloudV2
418
418
  @api_client.config.logger.debug 'Calling API: DispatchApi.delete_dispatch_tags ...'
419
419
  end
420
420
  # verify the required parameter 'dispatch_id' is set
421
- if @api_client.config.client_side_validation && dispatch_id.nil?
421
+ if dispatch_id.nil?
422
422
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.delete_dispatch_tags"
423
423
  end
424
424
  # verify the required parameter 'tags' is set
425
- if @api_client.config.client_side_validation && tags.nil?
425
+ if tags.nil?
426
426
  fail ArgumentError, "Missing the required parameter 'tags' when calling DispatchApi.delete_dispatch_tags"
427
427
  end
428
428
  # resource path
@@ -455,8 +455,76 @@ module RusticiSoftwareCloudV2
455
455
  end
456
456
  return data, status_code, headers
457
457
  end
458
- # DestinationsDispatchesRegistrationInstancing
459
- # Enable or disable registration instancing.
458
+ # Delete a group of Dispatches
459
+ # Deletes the specified group of dispatches. Can be filtered using the request parameters to provide a subset of results. >**Caution:** >This will invalidate any existing dispatch packages, rendering them unlaunchable. >**Note:** >One of the filter parameters (i.e. `courseId`, `since`/`until`, `tags`, or `filter`) needs to be provided. This is to prevent accidental deletion of all dispatches. If you do wish to update all dispatches, try setting the since parameter to a value prior to the creation of any dispatches. >**Info:** >If using one of our client libraries, refer to its README for additional information on how to work with the `X-Total-Count` header.
460
+ # @param [Hash] opts the optional parameters
461
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
462
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
463
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
464
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against (default to updated)
465
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
466
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
467
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter. (default to dispatch_id)
468
+ # @return [nil]
469
+ def delete_dispatches(opts = {})
470
+ delete_dispatches_with_http_info(opts)
471
+ nil
472
+ end
473
+
474
+ # Delete a group of Dispatches
475
+ # Deletes the specified group of dispatches. Can be filtered using the request parameters to provide a subset of results. &gt;**Caution:** &gt;This will invalidate any existing dispatch packages, rendering them unlaunchable. &gt;**Note:** &gt;One of the filter parameters (i.e. &#x60;courseId&#x60;, &#x60;since&#x60;/&#x60;until&#x60;, &#x60;tags&#x60;, or &#x60;filter&#x60;) needs to be provided. This is to prevent accidental deletion of all dispatches. If you do wish to update all dispatches, try setting the since parameter to a value prior to the creation of any dispatches. &gt;**Info:** &gt;If using one of our client libraries, refer to its README for additional information on how to work with the &#x60;X-Total-Count&#x60; header.
476
+ # @param [Hash] opts the optional parameters
477
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
478
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
479
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
480
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against
481
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
482
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
483
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter.
484
+ # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
485
+ def delete_dispatches_with_http_info(opts = {})
486
+ if @api_client.config.debugging
487
+ @api_client.config.logger.debug 'Calling API: DispatchApi.delete_dispatches ...'
488
+ end
489
+ # resource path
490
+ local_var_path = '/dispatch/dispatches'
491
+
492
+ # query parameters
493
+ query_params = {}
494
+ query_params[:'courseId'] = opts[:'course_id'] if !opts[:'course_id'].nil?
495
+ query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
496
+ query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
497
+ query_params[:'datetimeFilter'] = opts[:'datetime_filter'] if !opts[:'datetime_filter'].nil?
498
+ query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
499
+ query_params[:'filter'] = opts[:'filter'] if !opts[:'filter'].nil?
500
+ query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
501
+
502
+ # header parameters
503
+ header_params = {}
504
+ # HTTP header 'Accept' (if needed)
505
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
506
+ # HTTP header 'Content-Type'
507
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
508
+
509
+ # form parameters
510
+ form_params = {}
511
+
512
+ # http body (model)
513
+ post_body = nil
514
+ auth_names = ['APP_NORMAL', 'OAUTH']
515
+ data, status_code, headers = @api_client.call_api(:DELETE, local_var_path,
516
+ :header_params => header_params,
517
+ :query_params => query_params,
518
+ :form_params => form_params,
519
+ :body => post_body,
520
+ :auth_names => auth_names)
521
+ if @api_client.config.debugging
522
+ @api_client.config.logger.debug "API called: DispatchApi#delete_dispatches\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
523
+ end
524
+ return data, status_code, headers
525
+ end
526
+ # Update registration instancing status for a Destination's Dispatches
527
+ # Updates the restration instancing status for all dispatches distributed to the destination. Registration instancing is the default for dispatches, in order to support versioning of dispatches. A small portion of users may experience duplicate registrations with content dispatched to some LMS platforms. If you happen to be dispatching content to an LMS with this issue, disabling registration instancing here will resolve the problems. However, dispatch versioning will also be disabled.
460
528
  # @param destination_id Identifier for the destination
461
529
  # @param enabled
462
530
  # @param [Hash] opts the optional parameters
@@ -466,8 +534,8 @@ module RusticiSoftwareCloudV2
466
534
  nil
467
535
  end
468
536
 
469
- # DestinationsDispatchesRegistrationInstancing
470
- # Enable or disable registration instancing.
537
+ # Update registration instancing status for a Destination&#39;s Dispatches
538
+ # Updates the restration instancing status for all dispatches distributed to the destination. Registration instancing is the default for dispatches, in order to support versioning of dispatches. A small portion of users may experience duplicate registrations with content dispatched to some LMS platforms. If you happen to be dispatching content to an LMS with this issue, disabling registration instancing here will resolve the problems. However, dispatch versioning will also be disabled.
471
539
  # @param destination_id Identifier for the destination
472
540
  # @param enabled
473
541
  # @param [Hash] opts the optional parameters
@@ -477,11 +545,11 @@ module RusticiSoftwareCloudV2
477
545
  @api_client.config.logger.debug 'Calling API: DispatchApi.enable_registration_instancing ...'
478
546
  end
479
547
  # verify the required parameter 'destination_id' is set
480
- if @api_client.config.client_side_validation && destination_id.nil?
548
+ if destination_id.nil?
481
549
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.enable_registration_instancing"
482
550
  end
483
551
  # verify the required parameter 'enabled' is set
484
- if @api_client.config.client_side_validation && enabled.nil?
552
+ if enabled.nil?
485
553
  fail ArgumentError, "Missing the required parameter 'enabled' when calling DispatchApi.enable_registration_instancing"
486
554
  end
487
555
  # resource path
@@ -514,8 +582,8 @@ module RusticiSoftwareCloudV2
514
582
  end
515
583
  return data, status_code, headers
516
584
  end
517
- # Get destination information by destinationId.
518
- # Gets detailed information about a destination belonging to a destinationId.
585
+ # Get detailed information about a Destination
586
+ # Returns detailed information about the destination. This includes name, tags, and launchAuth information.
519
587
  # @param destination_id Identifier for the destination
520
588
  # @param [Hash] opts the optional parameters
521
589
  # @return [DestinationSchema]
@@ -524,8 +592,8 @@ module RusticiSoftwareCloudV2
524
592
  data
525
593
  end
526
594
 
527
- # Get destination information by destinationId.
528
- # Gets detailed information about a destination belonging to a destinationId.
595
+ # Get detailed information about a Destination
596
+ # Returns detailed information about the destination. This includes name, tags, and launchAuth information.
529
597
  # @param destination_id Identifier for the destination
530
598
  # @param [Hash] opts the optional parameters
531
599
  # @return [Array<(DestinationSchema, Fixnum, Hash)>] DestinationSchema data, response status code and response headers
@@ -534,7 +602,7 @@ module RusticiSoftwareCloudV2
534
602
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destination ...'
535
603
  end
536
604
  # verify the required parameter 'destination_id' is set
537
- if @api_client.config.client_side_validation && destination_id.nil?
605
+ if destination_id.nil?
538
606
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.get_destination"
539
607
  end
540
608
  # resource path
@@ -568,8 +636,8 @@ module RusticiSoftwareCloudV2
568
636
  end
569
637
  return data, status_code, headers
570
638
  end
571
- # DestinationsDispatchesRegistrationCount
572
- # Get an aggregate count of all related dispatch registrations.
639
+ # Get registration count for a Destination's Dispatches
640
+ # Returns the registration count for all dispatches distributed to the destination. >**Note:** >The count here is a convenience counter. Since it has the capability of being reset, it may not match the actual billed registration count for a dispatch.
573
641
  # @param destination_id Identifier for the destination
574
642
  # @param [Hash] opts the optional parameters
575
643
  # @return [IntegerResultSchema]
@@ -578,8 +646,8 @@ module RusticiSoftwareCloudV2
578
646
  data
579
647
  end
580
648
 
581
- # DestinationsDispatchesRegistrationCount
582
- # Get an aggregate count of all related dispatch registrations.
649
+ # Get registration count for a Destination&#39;s Dispatches
650
+ # Returns the registration count for all dispatches distributed to the destination. &gt;**Note:** &gt;The count here is a convenience counter. Since it has the capability of being reset, it may not match the actual billed registration count for a dispatch.
583
651
  # @param destination_id Identifier for the destination
584
652
  # @param [Hash] opts the optional parameters
585
653
  # @return [Array<(IntegerResultSchema, Fixnum, Hash)>] IntegerResultSchema data, response status code and response headers
@@ -588,7 +656,7 @@ module RusticiSoftwareCloudV2
588
656
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destination_dispatch_registration_count ...'
589
657
  end
590
658
  # verify the required parameter 'destination_id' is set
591
- if @api_client.config.client_side_validation && destination_id.nil?
659
+ if destination_id.nil?
592
660
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.get_destination_dispatch_registration_count"
593
661
  end
594
662
  # resource path
@@ -622,38 +690,35 @@ module RusticiSoftwareCloudV2
622
690
  end
623
691
  return data, status_code, headers
624
692
  end
625
- # Get a ZIP of related dispatches.
626
- # Returns a zip file containing all of the dispatch packages for a destination.
693
+ # Download a zip file for a Destination's Dispatches
694
+ # Downloads a zip file containing all of the dispatch packages for the destination. A dispatch zip package is a distributable course stub which, upon launch in a third-party LMS, will reference and launch the underlying course in SCORM Cloud.
627
695
  # @param destination_id Identifier for the destination
628
696
  # @param [Hash] opts the optional parameters
629
- # @option opts [String] :type The type of dispatch package to export (SCORM12 only supported in cloud today) (default to SCORM12)
697
+ # @option opts [String] :type The type of dispatch package to export (SCORM_12 only supported in SCORM Cloud today) (default to SCORM_12)
630
698
  # @option opts [String] :css_url
631
- # @option opts [Array<String>] :tags
699
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
632
700
  # @return [File]
633
701
  def get_destination_dispatch_zip(destination_id, opts = {})
634
702
  data, _status_code, _headers = get_destination_dispatch_zip_with_http_info(destination_id, opts)
635
703
  data
636
704
  end
637
705
 
638
- # Get a ZIP of related dispatches.
639
- # Returns a zip file containing all of the dispatch packages for a destination.
706
+ # Download a zip file for a Destination&#39;s Dispatches
707
+ # Downloads a zip file containing all of the dispatch packages for the destination. A dispatch zip package is a distributable course stub which, upon launch in a third-party LMS, will reference and launch the underlying course in SCORM Cloud.
640
708
  # @param destination_id Identifier for the destination
641
709
  # @param [Hash] opts the optional parameters
642
- # @option opts [String] :type The type of dispatch package to export (SCORM12 only supported in cloud today)
710
+ # @option opts [String] :type The type of dispatch package to export (SCORM_12 only supported in SCORM Cloud today)
643
711
  # @option opts [String] :css_url
644
- # @option opts [Array<String>] :tags
712
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
645
713
  # @return [Array<(File, Fixnum, Hash)>] File data, response status code and response headers
646
714
  def get_destination_dispatch_zip_with_http_info(destination_id, opts = {})
647
715
  if @api_client.config.debugging
648
716
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destination_dispatch_zip ...'
649
717
  end
650
718
  # verify the required parameter 'destination_id' is set
651
- if @api_client.config.client_side_validation && destination_id.nil?
719
+ if destination_id.nil?
652
720
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.get_destination_dispatch_zip"
653
721
  end
654
- if @api_client.config.client_side_validation && opts[:'type'] && !['SCORM12'].include?(opts[:'type'])
655
- fail ArgumentError, 'invalid value for "type", must be one of SCORM12'
656
- end
657
722
  # resource path
658
723
  local_var_path = '/dispatch/destinations/{destinationId}/dispatches/zip'.sub('{' + 'destinationId' + '}', destination_id.to_s)
659
724
 
@@ -688,61 +753,61 @@ module RusticiSoftwareCloudV2
688
753
  end
689
754
  return data, status_code, headers
690
755
  end
691
- # Get a list of dispatches in this destination
692
- # Get a list of related dispatches.
756
+ # Get a list of a Destination's Dispatches
757
+ # Returns a list of dispatches belonging to the destination. Can be filtered using the request parameters to provide a subset of results. Using the `courseId` filter should only ever yield 0 or 1 results, as a dispatch is the intersection of a course and a destination. This can be useful for identifying if a certain course is dispatched to the destination. >**Note:** >This request is paginated and will only provide a limited amount of resources at a time. If there are more results to be collected, a `more` token provided with the response which can be passed to get the next page of results. When passing this token, no other filter parameters can be sent as part of the request. The resources will continue to respect the filters passed in by the original request.
693
758
  # @param destination_id Identifier for the destination
694
759
  # @param [Hash] opts the optional parameters
695
- # @option opts [String] :course_id Only retreive resources having &#x60;courseId&#x60;
696
- # @option opts [String] :more Value for this parameter will be provided in the &#39;more&#39; property of registration lists, where needed. An opaque value, construction and parsing may change without notice.
697
- # @option opts [DateTime] :since Only items updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
698
- # @option opts [DateTime] :_until Only items updated before the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
699
- # @option opts [Array<String>] :tags
700
- # @option opts [String] :datetime_filter A string describing what the since/until parameters will be applied to. Options are: &#39;created&#39; or &#39;updated&#39;. If not provided, it will default to &#x60;updated&#x60;. (default to updated)
701
- # @option opts [String] :order_by
760
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
761
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
762
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
763
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against (default to updated)
764
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
765
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
766
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter. (default to dispatch_id)
767
+ # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. (default to updated_asc)
768
+ # @option opts [String] :more Pagination token returned as &#x60;more&#x60; property of multi page list requests
702
769
  # @return [DispatchListSchema]
703
770
  def get_destination_dispatches(destination_id, opts = {})
704
771
  data, _status_code, _headers = get_destination_dispatches_with_http_info(destination_id, opts)
705
772
  data
706
773
  end
707
774
 
708
- # Get a list of dispatches in this destination
709
- # Get a list of related dispatches.
775
+ # Get a list of a Destination&#39;s Dispatches
776
+ # Returns a list of dispatches belonging to the destination. Can be filtered using the request parameters to provide a subset of results. Using the &#x60;courseId&#x60; filter should only ever yield 0 or 1 results, as a dispatch is the intersection of a course and a destination. This can be useful for identifying if a certain course is dispatched to the destination. &gt;**Note:** &gt;This request is paginated and will only provide a limited amount of resources at a time. If there are more results to be collected, a &#x60;more&#x60; token provided with the response which can be passed to get the next page of results. When passing this token, no other filter parameters can be sent as part of the request. The resources will continue to respect the filters passed in by the original request.
710
777
  # @param destination_id Identifier for the destination
711
778
  # @param [Hash] opts the optional parameters
712
- # @option opts [String] :course_id Only retreive resources having &#x60;courseId&#x60;
713
- # @option opts [String] :more Value for this parameter will be provided in the &#39;more&#39; property of registration lists, where needed. An opaque value, construction and parsing may change without notice.
714
- # @option opts [DateTime] :since Only items updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
715
- # @option opts [DateTime] :_until Only items updated before the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
716
- # @option opts [Array<String>] :tags
717
- # @option opts [String] :datetime_filter A string describing what the since/until parameters will be applied to. Options are: &#39;created&#39; or &#39;updated&#39;. If not provided, it will default to &#x60;updated&#x60;.
718
- # @option opts [String] :order_by
779
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
780
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
781
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
782
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against
783
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
784
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
785
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter.
786
+ # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results.
787
+ # @option opts [String] :more Pagination token returned as &#x60;more&#x60; property of multi page list requests
719
788
  # @return [Array<(DispatchListSchema, Fixnum, Hash)>] DispatchListSchema data, response status code and response headers
720
789
  def get_destination_dispatches_with_http_info(destination_id, opts = {})
721
790
  if @api_client.config.debugging
722
791
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destination_dispatches ...'
723
792
  end
724
793
  # verify the required parameter 'destination_id' is set
725
- if @api_client.config.client_side_validation && destination_id.nil?
794
+ if destination_id.nil?
726
795
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.get_destination_dispatches"
727
796
  end
728
- if @api_client.config.client_side_validation && opts[:'datetime_filter'] && !['created', 'updated'].include?(opts[:'datetime_filter'])
729
- fail ArgumentError, 'invalid value for "datetime_filter", must be one of created, updated'
730
- end
731
- if @api_client.config.client_side_validation && opts[:'order_by'] && !['updated_asc', 'updated_desc', 'created_asc', 'created_desc'].include?(opts[:'order_by'])
732
- fail ArgumentError, 'invalid value for "order_by", must be one of updated_asc, updated_desc, created_asc, created_desc'
733
- end
734
797
  # resource path
735
798
  local_var_path = '/dispatch/destinations/{destinationId}/dispatches'.sub('{' + 'destinationId' + '}', destination_id.to_s)
736
799
 
737
800
  # query parameters
738
801
  query_params = {}
739
802
  query_params[:'courseId'] = opts[:'course_id'] if !opts[:'course_id'].nil?
740
- query_params[:'more'] = opts[:'more'] if !opts[:'more'].nil?
741
803
  query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
742
804
  query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
743
- query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
744
805
  query_params[:'datetimeFilter'] = opts[:'datetime_filter'] if !opts[:'datetime_filter'].nil?
806
+ query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
807
+ query_params[:'filter'] = opts[:'filter'] if !opts[:'filter'].nil?
808
+ query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
745
809
  query_params[:'orderBy'] = opts[:'order_by'] if !opts[:'order_by'].nil?
810
+ query_params[:'more'] = opts[:'more'] if !opts[:'more'].nil?
746
811
 
747
812
  # header parameters
748
813
  header_params = {}
@@ -769,8 +834,8 @@ module RusticiSoftwareCloudV2
769
834
  end
770
835
  return data, status_code, headers
771
836
  end
772
- # True if the destination is set to hash user info, or false if it is disabled.
773
- # True if the destination is set to hash user info, or false if it is disabled.
837
+ # Get user PII hashing status for a Destination
838
+ # Returns whether or not user PII hashing is enabled for the destination. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
774
839
  # @param destination_id Identifier for the destination
775
840
  # @param [Hash] opts the optional parameters
776
841
  # @return [EnabledSchema]
@@ -779,8 +844,8 @@ module RusticiSoftwareCloudV2
779
844
  data
780
845
  end
781
846
 
782
- # True if the destination is set to hash user info, or false if it is disabled.
783
- # True if the destination is set to hash user info, or false if it is disabled.
847
+ # Get user PII hashing status for a Destination
848
+ # Returns whether or not user PII hashing is enabled for the destination. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
784
849
  # @param destination_id Identifier for the destination
785
850
  # @param [Hash] opts the optional parameters
786
851
  # @return [Array<(EnabledSchema, Fixnum, Hash)>] EnabledSchema data, response status code and response headers
@@ -789,7 +854,7 @@ module RusticiSoftwareCloudV2
789
854
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destination_hash_user_info ...'
790
855
  end
791
856
  # verify the required parameter 'destination_id' is set
792
- if @api_client.config.client_side_validation && destination_id.nil?
857
+ if destination_id.nil?
793
858
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.get_destination_hash_user_info"
794
859
  end
795
860
  # resource path
@@ -823,8 +888,8 @@ module RusticiSoftwareCloudV2
823
888
  end
824
889
  return data, status_code, headers
825
890
  end
826
- # Get the tags for this destination
827
- # Get the tags for this destination
891
+ # Get tags for a Destination
892
+ # Returns the tags for the destination.
828
893
  # @param destination_id Identifier for the destination
829
894
  # @param [Hash] opts the optional parameters
830
895
  # @return [TagListSchema]
@@ -833,8 +898,8 @@ module RusticiSoftwareCloudV2
833
898
  data
834
899
  end
835
900
 
836
- # Get the tags for this destination
837
- # Get the tags for this destination
901
+ # Get tags for a Destination
902
+ # Returns the tags for the destination.
838
903
  # @param destination_id Identifier for the destination
839
904
  # @param [Hash] opts the optional parameters
840
905
  # @return [Array<(TagListSchema, Fixnum, Hash)>] TagListSchema data, response status code and response headers
@@ -843,7 +908,7 @@ module RusticiSoftwareCloudV2
843
908
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destination_tags ...'
844
909
  end
845
910
  # verify the required parameter 'destination_id' is set
846
- if @api_client.config.client_side_validation && destination_id.nil?
911
+ if destination_id.nil?
847
912
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.get_destination_tags"
848
913
  end
849
914
  # resource path
@@ -877,55 +942,55 @@ module RusticiSoftwareCloudV2
877
942
  end
878
943
  return data, status_code, headers
879
944
  end
880
- # getAllDestinations
881
- # Get a list of destinations.
882
- # @param [Hash] opts the optional parameters
883
- # @option opts [String] :course_id Only retreive resources having &#x60;courseId&#x60;
884
- # @option opts [String] :more Value for this parameter will be provided in the &#39;more&#39; property of registration lists, where needed. An opaque value, construction and parsing may change without notice.
885
- # @option opts [DateTime] :since Only items updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
886
- # @option opts [DateTime] :_until Only items updated before the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
887
- # @option opts [Array<String>] :tags
888
- # @option opts [String] :datetime_filter A string describing what the since/until parameters will be applied to. Options are: &#39;created&#39; or &#39;updated&#39;. If not provided, it will default to &#x60;updated&#x60;. (default to updated)
889
- # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. Defaults to updated_asc (default to updated_asc)
945
+ # Get a list of Destinations
946
+ # Returns a list of destinations. Can be filtered using the request parameters to provide a subset of results. >**Note:** >This request is paginated and will only provide a limited amount of resources at a time. If there are more results to be collected, a `more` token provided with the response which can be passed to get the next page of results. When passing this token, no other filter parameters can be sent as part of the request. The resources will continue to respect the filters passed in by the original request.
947
+ # @param [Hash] opts the optional parameters
948
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
949
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
950
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
951
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against (default to updated)
952
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
953
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
954
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter. (default to destination_id)
955
+ # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. (default to updated_asc)
956
+ # @option opts [String] :more Pagination token returned as &#x60;more&#x60; property of multi page list requests
890
957
  # @return [DestinationListSchema]
891
958
  def get_destinations(opts = {})
892
959
  data, _status_code, _headers = get_destinations_with_http_info(opts)
893
960
  data
894
961
  end
895
962
 
896
- # getAllDestinations
897
- # Get a list of destinations.
963
+ # Get a list of Destinations
964
+ # Returns a list of destinations. Can be filtered using the request parameters to provide a subset of results. &gt;**Note:** &gt;This request is paginated and will only provide a limited amount of resources at a time. If there are more results to be collected, a &#x60;more&#x60; token provided with the response which can be passed to get the next page of results. When passing this token, no other filter parameters can be sent as part of the request. The resources will continue to respect the filters passed in by the original request.
898
965
  # @param [Hash] opts the optional parameters
899
- # @option opts [String] :course_id Only retreive resources having &#x60;courseId&#x60;
900
- # @option opts [String] :more Value for this parameter will be provided in the &#39;more&#39; property of registration lists, where needed. An opaque value, construction and parsing may change without notice.
901
- # @option opts [DateTime] :since Only items updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
902
- # @option opts [DateTime] :_until Only items updated before the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
903
- # @option opts [Array<String>] :tags
904
- # @option opts [String] :datetime_filter A string describing what the since/until parameters will be applied to. Options are: &#39;created&#39; or &#39;updated&#39;. If not provided, it will default to &#x60;updated&#x60;.
905
- # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. Defaults to updated_asc
966
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
967
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
968
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
969
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against
970
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
971
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
972
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter.
973
+ # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results.
974
+ # @option opts [String] :more Pagination token returned as &#x60;more&#x60; property of multi page list requests
906
975
  # @return [Array<(DestinationListSchema, Fixnum, Hash)>] DestinationListSchema data, response status code and response headers
907
976
  def get_destinations_with_http_info(opts = {})
908
977
  if @api_client.config.debugging
909
978
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_destinations ...'
910
979
  end
911
- if @api_client.config.client_side_validation && opts[:'datetime_filter'] && !['created', 'updated'].include?(opts[:'datetime_filter'])
912
- fail ArgumentError, 'invalid value for "datetime_filter", must be one of created, updated'
913
- end
914
- if @api_client.config.client_side_validation && opts[:'order_by'] && !['updated_asc', 'updated_desc', 'created_asc', 'created_desc'].include?(opts[:'order_by'])
915
- fail ArgumentError, 'invalid value for "order_by", must be one of updated_asc, updated_desc, created_asc, created_desc'
916
- end
917
980
  # resource path
918
981
  local_var_path = '/dispatch/destinations'
919
982
 
920
983
  # query parameters
921
984
  query_params = {}
922
985
  query_params[:'courseId'] = opts[:'course_id'] if !opts[:'course_id'].nil?
923
- query_params[:'more'] = opts[:'more'] if !opts[:'more'].nil?
924
986
  query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
925
987
  query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
926
- query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
927
988
  query_params[:'datetimeFilter'] = opts[:'datetime_filter'] if !opts[:'datetime_filter'].nil?
989
+ query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
990
+ query_params[:'filter'] = opts[:'filter'] if !opts[:'filter'].nil?
991
+ query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
928
992
  query_params[:'orderBy'] = opts[:'order_by'] if !opts[:'order_by'].nil?
993
+ query_params[:'more'] = opts[:'more'] if !opts[:'more'].nil?
929
994
 
930
995
  # header parameters
931
996
  header_params = {}
@@ -952,8 +1017,8 @@ module RusticiSoftwareCloudV2
952
1017
  end
953
1018
  return data, status_code, headers
954
1019
  end
955
- # Get dispatch by id.
956
- # Get the dispatch with `dispatchId`.
1020
+ # Get detailed information about a Dispatch
1021
+ # Returns detailed information about the dispatch. This includes destination and course IDs, as well as registration count.
957
1022
  # @param dispatch_id Identifier for the dispatch
958
1023
  # @param [Hash] opts the optional parameters
959
1024
  # @return [DispatchSchema]
@@ -962,8 +1027,8 @@ module RusticiSoftwareCloudV2
962
1027
  data
963
1028
  end
964
1029
 
965
- # Get dispatch by id.
966
- # Get the dispatch with &#x60;dispatchId&#x60;.
1030
+ # Get detailed information about a Dispatch
1031
+ # Returns detailed information about the dispatch. This includes destination and course IDs, as well as registration count.
967
1032
  # @param dispatch_id Identifier for the dispatch
968
1033
  # @param [Hash] opts the optional parameters
969
1034
  # @return [Array<(DispatchSchema, Fixnum, Hash)>] DispatchSchema data, response status code and response headers
@@ -972,7 +1037,7 @@ module RusticiSoftwareCloudV2
972
1037
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatch ...'
973
1038
  end
974
1039
  # verify the required parameter 'dispatch_id' is set
975
- if @api_client.config.client_side_validation && dispatch_id.nil?
1040
+ if dispatch_id.nil?
976
1041
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_dispatch"
977
1042
  end
978
1043
  # resource path
@@ -1006,8 +1071,8 @@ module RusticiSoftwareCloudV2
1006
1071
  end
1007
1072
  return data, status_code, headers
1008
1073
  end
1009
- # Get the `enabled` status for `dispatchId`.
1010
- # Get the `enabled` status for `dispatchId`. True if the dispatch is enabled, or false if it is disabled.
1074
+ # Get enabled status of a Dispatch
1075
+ # Returns the enabled status for the dispatch. This is an access control measure allowing you to turn access to a previously distributed dispatch packages on or off.
1011
1076
  # @param dispatch_id Identifier for the dispatch
1012
1077
  # @param [Hash] opts the optional parameters
1013
1078
  # @return [EnabledSchema]
@@ -1016,8 +1081,8 @@ module RusticiSoftwareCloudV2
1016
1081
  data
1017
1082
  end
1018
1083
 
1019
- # Get the &#x60;enabled&#x60; status for &#x60;dispatchId&#x60;.
1020
- # Get the &#x60;enabled&#x60; status for &#x60;dispatchId&#x60;. True if the dispatch is enabled, or false if it is disabled.
1084
+ # Get enabled status of a Dispatch
1085
+ # Returns the enabled status for the dispatch. This is an access control measure allowing you to turn access to a previously distributed dispatch packages on or off.
1021
1086
  # @param dispatch_id Identifier for the dispatch
1022
1087
  # @param [Hash] opts the optional parameters
1023
1088
  # @return [Array<(EnabledSchema, Fixnum, Hash)>] EnabledSchema data, response status code and response headers
@@ -1026,7 +1091,7 @@ module RusticiSoftwareCloudV2
1026
1091
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatch_enabled ...'
1027
1092
  end
1028
1093
  # verify the required parameter 'dispatch_id' is set
1029
- if @api_client.config.client_side_validation && dispatch_id.nil?
1094
+ if dispatch_id.nil?
1030
1095
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_dispatch_enabled"
1031
1096
  end
1032
1097
  # resource path
@@ -1060,8 +1125,8 @@ module RusticiSoftwareCloudV2
1060
1125
  end
1061
1126
  return data, status_code, headers
1062
1127
  end
1063
- # Get if this dispatch has PII hashing enabled.
1064
- # Get if this dispatch has PII hashing enabled. True if the dispatch is set to hash user info, or false if it is disabled.
1128
+ # Get user PII hashing status for a Dispatch
1129
+ # Returns whether or not user PII hashing is enabled for the dispatch. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
1065
1130
  # @param dispatch_id Identifier for the dispatch
1066
1131
  # @param [Hash] opts the optional parameters
1067
1132
  # @return [EnabledSchema]
@@ -1070,8 +1135,8 @@ module RusticiSoftwareCloudV2
1070
1135
  data
1071
1136
  end
1072
1137
 
1073
- # Get if this dispatch has PII hashing enabled.
1074
- # Get if this dispatch has PII hashing enabled. True if the dispatch is set to hash user info, or false if it is disabled.
1138
+ # Get user PII hashing status for a Dispatch
1139
+ # Returns whether or not user PII hashing is enabled for the dispatch. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
1075
1140
  # @param dispatch_id Identifier for the dispatch
1076
1141
  # @param [Hash] opts the optional parameters
1077
1142
  # @return [Array<(EnabledSchema, Fixnum, Hash)>] EnabledSchema data, response status code and response headers
@@ -1080,7 +1145,7 @@ module RusticiSoftwareCloudV2
1080
1145
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatch_hash_user_info ...'
1081
1146
  end
1082
1147
  # verify the required parameter 'dispatch_id' is set
1083
- if @api_client.config.client_side_validation && dispatch_id.nil?
1148
+ if dispatch_id.nil?
1084
1149
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_dispatch_hash_user_info"
1085
1150
  end
1086
1151
  # resource path
@@ -1114,8 +1179,8 @@ module RusticiSoftwareCloudV2
1114
1179
  end
1115
1180
  return data, status_code, headers
1116
1181
  end
1117
- # Get the registration count for `dispatchId`.
1118
- # Get the registration count for this dispatch, and the date and time of the last count reset, if any.
1182
+ # Get registration count for a Dispatch
1183
+ # Returns the registration count for the dispatch, as well as the date and time of the last count reset, if any. >**Note:** >The count here is a convenience counter. Since it has the capability of being reset, it may not match the actual billed registration count for a dispatch.
1119
1184
  # @param dispatch_id Identifier for the dispatch
1120
1185
  # @param [Hash] opts the optional parameters
1121
1186
  # @return [DispatchRegistrationCountSchema]
@@ -1124,8 +1189,8 @@ module RusticiSoftwareCloudV2
1124
1189
  data
1125
1190
  end
1126
1191
 
1127
- # Get the registration count for &#x60;dispatchId&#x60;.
1128
- # Get the registration count for this dispatch, and the date and time of the last count reset, if any.
1192
+ # Get registration count for a Dispatch
1193
+ # Returns the registration count for the dispatch, as well as the date and time of the last count reset, if any. &gt;**Note:** &gt;The count here is a convenience counter. Since it has the capability of being reset, it may not match the actual billed registration count for a dispatch.
1129
1194
  # @param dispatch_id Identifier for the dispatch
1130
1195
  # @param [Hash] opts the optional parameters
1131
1196
  # @return [Array<(DispatchRegistrationCountSchema, Fixnum, Hash)>] DispatchRegistrationCountSchema data, response status code and response headers
@@ -1134,7 +1199,7 @@ module RusticiSoftwareCloudV2
1134
1199
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatch_registration_count ...'
1135
1200
  end
1136
1201
  # verify the required parameter 'dispatch_id' is set
1137
- if @api_client.config.client_side_validation && dispatch_id.nil?
1202
+ if dispatch_id.nil?
1138
1203
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_dispatch_registration_count"
1139
1204
  end
1140
1205
  # resource path
@@ -1168,8 +1233,8 @@ module RusticiSoftwareCloudV2
1168
1233
  end
1169
1234
  return data, status_code, headers
1170
1235
  end
1171
- # Get the tags for this dispatch.
1172
- # Get the tags for this dispatch.
1236
+ # Get tags for a Dispatch
1237
+ # Returns the tags for the dispatch.
1173
1238
  # @param dispatch_id Identifier for the dispatch
1174
1239
  # @param [Hash] opts the optional parameters
1175
1240
  # @return [TagListSchema]
@@ -1178,8 +1243,8 @@ module RusticiSoftwareCloudV2
1178
1243
  data
1179
1244
  end
1180
1245
 
1181
- # Get the tags for this dispatch.
1182
- # Get the tags for this dispatch.
1246
+ # Get tags for a Dispatch
1247
+ # Returns the tags for the dispatch.
1183
1248
  # @param dispatch_id Identifier for the dispatch
1184
1249
  # @param [Hash] opts the optional parameters
1185
1250
  # @return [Array<(TagListSchema, Fixnum, Hash)>] TagListSchema data, response status code and response headers
@@ -1188,7 +1253,7 @@ module RusticiSoftwareCloudV2
1188
1253
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatch_tags ...'
1189
1254
  end
1190
1255
  # verify the required parameter 'dispatch_id' is set
1191
- if @api_client.config.client_side_validation && dispatch_id.nil?
1256
+ if dispatch_id.nil?
1192
1257
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_dispatch_tags"
1193
1258
  end
1194
1259
  # resource path
@@ -1222,36 +1287,33 @@ module RusticiSoftwareCloudV2
1222
1287
  end
1223
1288
  return data, status_code, headers
1224
1289
  end
1225
- # Get the ZIP for the dispatchId.
1226
- # Get the ZIP for the dispatch with `dispatchId`
1290
+ # Download a zip package for a Dispatch
1291
+ # Downloads a zip package for the dispatch. A dispatch zip package is a distributable course stub which, upon launch in a third-party LMS, will reference and launch the underlying course in SCORM Cloud. As an extension, dispatches allow for limiting access control even after the zip file has been given to the destination.
1227
1292
  # @param dispatch_id Identifier for the dispatch
1228
1293
  # @param [Hash] opts the optional parameters
1229
- # @option opts [String] :type The type of dispatch package to export (SCORM12 only supported in cloud today) (default to SCORM12)
1230
- # @option opts [String] :css_url
1294
+ # @option opts [String] :type The type of dispatch package to export (currently only SCORM_12 available) (default to SCORM_12)
1295
+ # @option opts [String] :css_url Custom CSS to apply to the dispatch package
1231
1296
  # @return [File]
1232
1297
  def get_dispatch_zip(dispatch_id, opts = {})
1233
1298
  data, _status_code, _headers = get_dispatch_zip_with_http_info(dispatch_id, opts)
1234
1299
  data
1235
1300
  end
1236
1301
 
1237
- # Get the ZIP for the dispatchId.
1238
- # Get the ZIP for the dispatch with &#x60;dispatchId&#x60;
1302
+ # Download a zip package for a Dispatch
1303
+ # Downloads a zip package for the dispatch. A dispatch zip package is a distributable course stub which, upon launch in a third-party LMS, will reference and launch the underlying course in SCORM Cloud. As an extension, dispatches allow for limiting access control even after the zip file has been given to the destination.
1239
1304
  # @param dispatch_id Identifier for the dispatch
1240
1305
  # @param [Hash] opts the optional parameters
1241
- # @option opts [String] :type The type of dispatch package to export (SCORM12 only supported in cloud today)
1242
- # @option opts [String] :css_url
1306
+ # @option opts [String] :type The type of dispatch package to export (currently only SCORM_12 available)
1307
+ # @option opts [String] :css_url Custom CSS to apply to the dispatch package
1243
1308
  # @return [Array<(File, Fixnum, Hash)>] File data, response status code and response headers
1244
1309
  def get_dispatch_zip_with_http_info(dispatch_id, opts = {})
1245
1310
  if @api_client.config.debugging
1246
1311
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatch_zip ...'
1247
1312
  end
1248
1313
  # verify the required parameter 'dispatch_id' is set
1249
- if @api_client.config.client_side_validation && dispatch_id.nil?
1314
+ if dispatch_id.nil?
1250
1315
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_dispatch_zip"
1251
1316
  end
1252
- if @api_client.config.client_side_validation && opts[:'type'] && !['SCORM12'].include?(opts[:'type'])
1253
- fail ArgumentError, 'invalid value for "type", must be one of SCORM12'
1254
- end
1255
1317
  # resource path
1256
1318
  local_var_path = '/dispatch/dispatches/{dispatchId}/zip'.sub('{' + 'dispatchId' + '}', dispatch_id.to_s)
1257
1319
 
@@ -1285,55 +1347,55 @@ module RusticiSoftwareCloudV2
1285
1347
  end
1286
1348
  return data, status_code, headers
1287
1349
  end
1288
- # All Dispatches in the system for an AppId
1289
- # Get a list of dispatches.
1290
- # @param [Hash] opts the optional parameters
1291
- # @option opts [String] :course_id Only retreive resources having &#x60;courseId&#x60;
1292
- # @option opts [String] :more Value for this parameter will be provided in the &#39;more&#39; property of registration lists, where needed. An opaque value, construction and parsing may change without notice.
1293
- # @option opts [DateTime] :since Only items updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
1294
- # @option opts [DateTime] :_until Only items updated before the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
1295
- # @option opts [Array<String>] :tags
1296
- # @option opts [String] :datetime_filter A string describing what the since/until parameters will be applied to. Options are: &#39;created&#39; or &#39;updated&#39;. If not provided, it will default to &#x60;updated&#x60;. (default to updated)
1297
- # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. Defaults to updated_asc (default to updated_asc)
1350
+ # Get a list of Dispatches
1351
+ # Returns a list of dispatches. Can be filtered using the request parameters to provide a subset of results. Using the `courseId` filter will allow for viewing which destinations the course has been dispatched to. >**Note:** >This request is paginated and will only provide a limited amount of resources at a time. If there are more results to be collected, a `more` token provided with the response which can be passed to get the next page of results. When passing this token, no other filter parameters can be sent as part of the request. The resources will continue to respect the filters passed in by the original request.
1352
+ # @param [Hash] opts the optional parameters
1353
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
1354
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
1355
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
1356
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against (default to updated)
1357
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
1358
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
1359
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter. (default to dispatch_id)
1360
+ # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. (default to updated_asc)
1361
+ # @option opts [String] :more Pagination token returned as &#x60;more&#x60; property of multi page list requests
1298
1362
  # @return [DispatchListSchema]
1299
1363
  def get_dispatches(opts = {})
1300
1364
  data, _status_code, _headers = get_dispatches_with_http_info(opts)
1301
1365
  data
1302
1366
  end
1303
1367
 
1304
- # All Dispatches in the system for an AppId
1305
- # Get a list of dispatches.
1368
+ # Get a list of Dispatches
1369
+ # Returns a list of dispatches. Can be filtered using the request parameters to provide a subset of results. Using the &#x60;courseId&#x60; filter will allow for viewing which destinations the course has been dispatched to. &gt;**Note:** &gt;This request is paginated and will only provide a limited amount of resources at a time. If there are more results to be collected, a &#x60;more&#x60; token provided with the response which can be passed to get the next page of results. When passing this token, no other filter parameters can be sent as part of the request. The resources will continue to respect the filters passed in by the original request.
1306
1370
  # @param [Hash] opts the optional parameters
1307
- # @option opts [String] :course_id Only retreive resources having &#x60;courseId&#x60;
1308
- # @option opts [String] :more Value for this parameter will be provided in the &#39;more&#39; property of registration lists, where needed. An opaque value, construction and parsing may change without notice.
1309
- # @option opts [DateTime] :since Only items updated since the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
1310
- # @option opts [DateTime] :_until Only items updated before the specified ISO 8601 TimeStamp (inclusive) are included. If a time zone is not specified, UTC time zone will be used.
1311
- # @option opts [Array<String>] :tags
1312
- # @option opts [String] :datetime_filter A string describing what the since/until parameters will be applied to. Options are: &#39;created&#39; or &#39;updated&#39;. If not provided, it will default to &#x60;updated&#x60;.
1313
- # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results. Defaults to updated_asc
1371
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
1372
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
1373
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
1374
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against
1375
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
1376
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
1377
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter.
1378
+ # @option opts [String] :order_by Optional enum parameter for specifying the field and order by which to sort the results.
1379
+ # @option opts [String] :more Pagination token returned as &#x60;more&#x60; property of multi page list requests
1314
1380
  # @return [Array<(DispatchListSchema, Fixnum, Hash)>] DispatchListSchema data, response status code and response headers
1315
1381
  def get_dispatches_with_http_info(opts = {})
1316
1382
  if @api_client.config.debugging
1317
1383
  @api_client.config.logger.debug 'Calling API: DispatchApi.get_dispatches ...'
1318
1384
  end
1319
- if @api_client.config.client_side_validation && opts[:'datetime_filter'] && !['created', 'updated'].include?(opts[:'datetime_filter'])
1320
- fail ArgumentError, 'invalid value for "datetime_filter", must be one of created, updated'
1321
- end
1322
- if @api_client.config.client_side_validation && opts[:'order_by'] && !['updated_asc', 'updated_desc', 'created_asc', 'created_desc'].include?(opts[:'order_by'])
1323
- fail ArgumentError, 'invalid value for "order_by", must be one of updated_asc, updated_desc, created_asc, created_desc'
1324
- end
1325
1385
  # resource path
1326
1386
  local_var_path = '/dispatch/dispatches'
1327
1387
 
1328
1388
  # query parameters
1329
1389
  query_params = {}
1330
1390
  query_params[:'courseId'] = opts[:'course_id'] if !opts[:'course_id'].nil?
1331
- query_params[:'more'] = opts[:'more'] if !opts[:'more'].nil?
1332
1391
  query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
1333
1392
  query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
1334
- query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
1335
1393
  query_params[:'datetimeFilter'] = opts[:'datetime_filter'] if !opts[:'datetime_filter'].nil?
1394
+ query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
1395
+ query_params[:'filter'] = opts[:'filter'] if !opts[:'filter'].nil?
1396
+ query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
1336
1397
  query_params[:'orderBy'] = opts[:'order_by'] if !opts[:'order_by'].nil?
1398
+ query_params[:'more'] = opts[:'more'] if !opts[:'more'].nil?
1337
1399
 
1338
1400
  # header parameters
1339
1401
  header_params = {}
@@ -1360,8 +1422,60 @@ module RusticiSoftwareCloudV2
1360
1422
  end
1361
1423
  return data, status_code, headers
1362
1424
  end
1363
- # Set the tags for this destination
1364
- # Set the tags for this destination
1425
+ # Get the information necessary to launch this dispatch using the IMS LTI 1.1 specification.
1426
+ # @param dispatch_id Identifier for the dispatch
1427
+ # @param [Hash] opts the optional parameters
1428
+ # @return [DispatchLtiInfoSchema]
1429
+ def get_lti_dispatch(dispatch_id, opts = {})
1430
+ data, _status_code, _headers = get_lti_dispatch_with_http_info(dispatch_id, opts)
1431
+ data
1432
+ end
1433
+
1434
+ # Get the information necessary to launch this dispatch using the IMS LTI 1.1 specification.
1435
+ # @param dispatch_id Identifier for the dispatch
1436
+ # @param [Hash] opts the optional parameters
1437
+ # @return [Array<(DispatchLtiInfoSchema, Fixnum, Hash)>] DispatchLtiInfoSchema data, response status code and response headers
1438
+ def get_lti_dispatch_with_http_info(dispatch_id, opts = {})
1439
+ if @api_client.config.debugging
1440
+ @api_client.config.logger.debug 'Calling API: DispatchApi.get_lti_dispatch ...'
1441
+ end
1442
+ # verify the required parameter 'dispatch_id' is set
1443
+ if dispatch_id.nil?
1444
+ fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.get_lti_dispatch"
1445
+ end
1446
+ # resource path
1447
+ local_var_path = '/dispatch/dispatches/{dispatchId}/lti'.sub('{' + 'dispatchId' + '}', dispatch_id.to_s)
1448
+
1449
+ # query parameters
1450
+ query_params = {}
1451
+
1452
+ # header parameters
1453
+ header_params = {}
1454
+ # HTTP header 'Accept' (if needed)
1455
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
1456
+ # HTTP header 'Content-Type'
1457
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
1458
+
1459
+ # form parameters
1460
+ form_params = {}
1461
+
1462
+ # http body (model)
1463
+ post_body = nil
1464
+ auth_names = ['APP_NORMAL', 'OAUTH']
1465
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path,
1466
+ :header_params => header_params,
1467
+ :query_params => query_params,
1468
+ :form_params => form_params,
1469
+ :body => post_body,
1470
+ :auth_names => auth_names,
1471
+ :return_type => 'DispatchLtiInfoSchema')
1472
+ if @api_client.config.debugging
1473
+ @api_client.config.logger.debug "API called: DispatchApi#get_lti_dispatch\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
1474
+ end
1475
+ return data, status_code, headers
1476
+ end
1477
+ # Add tags to a Destination
1478
+ # Applies the provided tags to the destination. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDestinations).
1365
1479
  # @param destination_id Identifier for the destination
1366
1480
  # @param tags
1367
1481
  # @param [Hash] opts the optional parameters
@@ -1371,8 +1485,8 @@ module RusticiSoftwareCloudV2
1371
1485
  nil
1372
1486
  end
1373
1487
 
1374
- # Set the tags for this destination
1375
- # Set the tags for this destination
1488
+ # Add tags to a Destination
1489
+ # Applies the provided tags to the destination. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDestinations).
1376
1490
  # @param destination_id Identifier for the destination
1377
1491
  # @param tags
1378
1492
  # @param [Hash] opts the optional parameters
@@ -1382,11 +1496,11 @@ module RusticiSoftwareCloudV2
1382
1496
  @api_client.config.logger.debug 'Calling API: DispatchApi.put_destination_tags ...'
1383
1497
  end
1384
1498
  # verify the required parameter 'destination_id' is set
1385
- if @api_client.config.client_side_validation && destination_id.nil?
1499
+ if destination_id.nil?
1386
1500
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.put_destination_tags"
1387
1501
  end
1388
1502
  # verify the required parameter 'tags' is set
1389
- if @api_client.config.client_side_validation && tags.nil?
1503
+ if tags.nil?
1390
1504
  fail ArgumentError, "Missing the required parameter 'tags' when calling DispatchApi.put_destination_tags"
1391
1505
  end
1392
1506
  # resource path
@@ -1419,9 +1533,9 @@ module RusticiSoftwareCloudV2
1419
1533
  end
1420
1534
  return data, status_code, headers
1421
1535
  end
1422
- # Sets all of the provided tags on all of the provided destinations
1423
- # Sets all of the provided tags on all of the provided destinations
1424
- # @param batch Object representing an array of ids to apply an array of tags to.
1536
+ # Add a group of tags to a group of Destinations
1537
+ # Applies all of the provided tags on all of the provided destinations. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDestinations).
1538
+ # @param batch Array of ids, and array of tags for bulk tag operations
1425
1539
  # @param [Hash] opts the optional parameters
1426
1540
  # @return [nil]
1427
1541
  def put_destination_tags_batch(batch, opts = {})
@@ -1429,9 +1543,9 @@ module RusticiSoftwareCloudV2
1429
1543
  nil
1430
1544
  end
1431
1545
 
1432
- # Sets all of the provided tags on all of the provided destinations
1433
- # Sets all of the provided tags on all of the provided destinations
1434
- # @param batch Object representing an array of ids to apply an array of tags to.
1546
+ # Add a group of tags to a group of Destinations
1547
+ # Applies all of the provided tags on all of the provided destinations. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDestinations).
1548
+ # @param batch Array of ids, and array of tags for bulk tag operations
1435
1549
  # @param [Hash] opts the optional parameters
1436
1550
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
1437
1551
  def put_destination_tags_batch_with_http_info(batch, opts = {})
@@ -1439,7 +1553,7 @@ module RusticiSoftwareCloudV2
1439
1553
  @api_client.config.logger.debug 'Calling API: DispatchApi.put_destination_tags_batch ...'
1440
1554
  end
1441
1555
  # verify the required parameter 'batch' is set
1442
- if @api_client.config.client_side_validation && batch.nil?
1556
+ if batch.nil?
1443
1557
  fail ArgumentError, "Missing the required parameter 'batch' when calling DispatchApi.put_destination_tags_batch"
1444
1558
  end
1445
1559
  # resource path
@@ -1472,8 +1586,8 @@ module RusticiSoftwareCloudV2
1472
1586
  end
1473
1587
  return data, status_code, headers
1474
1588
  end
1475
- # Set the tags for this dispatch.
1476
- # Set the tags for this dispatch.
1589
+ # Add tags to a Dispatch
1590
+ # Applies the provided tags to the dispatch. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDispatches).
1477
1591
  # @param dispatch_id Identifier for the dispatch
1478
1592
  # @param tags
1479
1593
  # @param [Hash] opts the optional parameters
@@ -1483,8 +1597,8 @@ module RusticiSoftwareCloudV2
1483
1597
  nil
1484
1598
  end
1485
1599
 
1486
- # Set the tags for this dispatch.
1487
- # Set the tags for this dispatch.
1600
+ # Add tags to a Dispatch
1601
+ # Applies the provided tags to the dispatch. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDispatches).
1488
1602
  # @param dispatch_id Identifier for the dispatch
1489
1603
  # @param tags
1490
1604
  # @param [Hash] opts the optional parameters
@@ -1494,11 +1608,11 @@ module RusticiSoftwareCloudV2
1494
1608
  @api_client.config.logger.debug 'Calling API: DispatchApi.put_dispatch_tags ...'
1495
1609
  end
1496
1610
  # verify the required parameter 'dispatch_id' is set
1497
- if @api_client.config.client_side_validation && dispatch_id.nil?
1611
+ if dispatch_id.nil?
1498
1612
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.put_dispatch_tags"
1499
1613
  end
1500
1614
  # verify the required parameter 'tags' is set
1501
- if @api_client.config.client_side_validation && tags.nil?
1615
+ if tags.nil?
1502
1616
  fail ArgumentError, "Missing the required parameter 'tags' when calling DispatchApi.put_dispatch_tags"
1503
1617
  end
1504
1618
  # resource path
@@ -1531,9 +1645,9 @@ module RusticiSoftwareCloudV2
1531
1645
  end
1532
1646
  return data, status_code, headers
1533
1647
  end
1534
- # Sets all of the provided tags on all of the provided dispatches
1535
- # Sets all of the provided tags on all of the provided dispatches
1536
- # @param batch Object representing an array of ids to apply an array of tags to.
1648
+ # Add a group of tags to a group of Dispatches
1649
+ # Applies all of the provided tags on all of the provided dispatches. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDispatches).
1650
+ # @param batch Array of ids, and array of tags for bulk tag operations
1537
1651
  # @param [Hash] opts the optional parameters
1538
1652
  # @return [nil]
1539
1653
  def put_dispatch_tags_batch(batch, opts = {})
@@ -1541,9 +1655,9 @@ module RusticiSoftwareCloudV2
1541
1655
  nil
1542
1656
  end
1543
1657
 
1544
- # Sets all of the provided tags on all of the provided dispatches
1545
- # Sets all of the provided tags on all of the provided dispatches
1546
- # @param batch Object representing an array of ids to apply an array of tags to.
1658
+ # Add a group of tags to a group of Dispatches
1659
+ # Applies all of the provided tags on all of the provided dispatches. Tags are used to easily identify resources. Adding tags can enable more refined searches when making calls to certain endpoints (e.g. GetDispatches).
1660
+ # @param batch Array of ids, and array of tags for bulk tag operations
1547
1661
  # @param [Hash] opts the optional parameters
1548
1662
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
1549
1663
  def put_dispatch_tags_batch_with_http_info(batch, opts = {})
@@ -1551,7 +1665,7 @@ module RusticiSoftwareCloudV2
1551
1665
  @api_client.config.logger.debug 'Calling API: DispatchApi.put_dispatch_tags_batch ...'
1552
1666
  end
1553
1667
  # verify the required parameter 'batch' is set
1554
- if @api_client.config.client_side_validation && batch.nil?
1668
+ if batch.nil?
1555
1669
  fail ArgumentError, "Missing the required parameter 'batch' when calling DispatchApi.put_dispatch_tags_batch"
1556
1670
  end
1557
1671
  # resource path
@@ -1584,8 +1698,8 @@ module RusticiSoftwareCloudV2
1584
1698
  end
1585
1699
  return data, status_code, headers
1586
1700
  end
1587
- # DestinationsDispatchesRegistrationCount
1588
- # Reset registration counts for all related dispatches.
1701
+ # Reset registration counts for a Destination's Dispatches
1702
+ # Clears the registration count for all dispatches distributed to the destination. This resets the registration counter on the dispatch itself, but has no effect on the existing registrations. Can be used in situations where the license for the course material has been renewed.
1589
1703
  # @param destination_id Identifier for the destination
1590
1704
  # @param [Hash] opts the optional parameters
1591
1705
  # @return [nil]
@@ -1594,8 +1708,8 @@ module RusticiSoftwareCloudV2
1594
1708
  nil
1595
1709
  end
1596
1710
 
1597
- # DestinationsDispatchesRegistrationCount
1598
- # Reset registration counts for all related dispatches.
1711
+ # Reset registration counts for a Destination&#39;s Dispatches
1712
+ # Clears the registration count for all dispatches distributed to the destination. This resets the registration counter on the dispatch itself, but has no effect on the existing registrations. Can be used in situations where the license for the course material has been renewed.
1599
1713
  # @param destination_id Identifier for the destination
1600
1714
  # @param [Hash] opts the optional parameters
1601
1715
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -1604,7 +1718,7 @@ module RusticiSoftwareCloudV2
1604
1718
  @api_client.config.logger.debug 'Calling API: DispatchApi.reset_destination_dispatch_registration_count ...'
1605
1719
  end
1606
1720
  # verify the required parameter 'destination_id' is set
1607
- if @api_client.config.client_side_validation && destination_id.nil?
1721
+ if destination_id.nil?
1608
1722
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.reset_destination_dispatch_registration_count"
1609
1723
  end
1610
1724
  # resource path
@@ -1637,8 +1751,8 @@ module RusticiSoftwareCloudV2
1637
1751
  end
1638
1752
  return data, status_code, headers
1639
1753
  end
1640
- # Reset registration count.
1641
- # Reset the registration count for this dispatch.
1754
+ # Reset registration count for a Dispatch
1755
+ # Clears the registration count for the dispatch. This resets the registration counter on the dispatch itself, but has no effect on the existing registrations. Can be used in situations where the license for the course material has been renewed.
1642
1756
  # @param dispatch_id Identifier for the dispatch
1643
1757
  # @param [Hash] opts the optional parameters
1644
1758
  # @return [nil]
@@ -1647,8 +1761,8 @@ module RusticiSoftwareCloudV2
1647
1761
  nil
1648
1762
  end
1649
1763
 
1650
- # Reset registration count.
1651
- # Reset the registration count for this dispatch.
1764
+ # Reset registration count for a Dispatch
1765
+ # Clears the registration count for the dispatch. This resets the registration counter on the dispatch itself, but has no effect on the existing registrations. Can be used in situations where the license for the course material has been renewed.
1652
1766
  # @param dispatch_id Identifier for the dispatch
1653
1767
  # @param [Hash] opts the optional parameters
1654
1768
  # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -1657,7 +1771,7 @@ module RusticiSoftwareCloudV2
1657
1771
  @api_client.config.logger.debug 'Calling API: DispatchApi.reset_dispatch_registration_count ...'
1658
1772
  end
1659
1773
  # verify the required parameter 'dispatch_id' is set
1660
- if @api_client.config.client_side_validation && dispatch_id.nil?
1774
+ if dispatch_id.nil?
1661
1775
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.reset_dispatch_registration_count"
1662
1776
  end
1663
1777
  # resource path
@@ -1690,7 +1804,8 @@ module RusticiSoftwareCloudV2
1690
1804
  end
1691
1805
  return data, status_code, headers
1692
1806
  end
1693
- # Creates or updates the destination identified by the `destinationId` provided in the path. If the destination is being created, a name should be provided in the DestinationSchema, else an error will be thrown. You may also optionally supply the e-mail address of the user to be associated with this destination. This e-mail address should correspond to a SCORM Cloud user account. If you do not supply an e-mail address upon the creation of a destination, the owner of the Realm will be used. This can, of course, also be changed via calling this method to update an existing destination.
1807
+ # Create or update a Destination
1808
+ # Creates or updates information about the destination. -If the destination is being created, a name should be provided in the DestinationSchema. If one is not present in the request an error will be thrown. -If the destination is instead being updated, only non-null values that are provided will be updated. You may also optionally supply the e-mail address of the user to be associated with this destination. This e-mail address should correspond to a SCORM Cloud user account.
1694
1809
  # @param destination_id Identifier for the destination
1695
1810
  # @param destination
1696
1811
  # @param [Hash] opts the optional parameters
@@ -1700,7 +1815,8 @@ module RusticiSoftwareCloudV2
1700
1815
  nil
1701
1816
  end
1702
1817
 
1703
- # Creates or updates the destination identified by the &#x60;destinationId&#x60; provided in the path. If the destination is being created, a name should be provided in the DestinationSchema, else an error will be thrown. You may also optionally supply the e-mail address of the user to be associated with this destination. This e-mail address should correspond to a SCORM Cloud user account. If you do not supply an e-mail address upon the creation of a destination, the owner of the Realm will be used. This can, of course, also be changed via calling this method to update an existing destination.
1818
+ # Create or update a Destination
1819
+ # Creates or updates information about the destination. -If the destination is being created, a name should be provided in the DestinationSchema. If one is not present in the request an error will be thrown. -If the destination is instead being updated, only non-null values that are provided will be updated. You may also optionally supply the e-mail address of the user to be associated with this destination. This e-mail address should correspond to a SCORM Cloud user account.
1704
1820
  # @param destination_id Identifier for the destination
1705
1821
  # @param destination
1706
1822
  # @param [Hash] opts the optional parameters
@@ -1710,11 +1826,11 @@ module RusticiSoftwareCloudV2
1710
1826
  @api_client.config.logger.debug 'Calling API: DispatchApi.set_destination ...'
1711
1827
  end
1712
1828
  # verify the required parameter 'destination_id' is set
1713
- if @api_client.config.client_side_validation && destination_id.nil?
1829
+ if destination_id.nil?
1714
1830
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.set_destination"
1715
1831
  end
1716
1832
  # verify the required parameter 'destination' is set
1717
- if @api_client.config.client_side_validation && destination.nil?
1833
+ if destination.nil?
1718
1834
  fail ArgumentError, "Missing the required parameter 'destination' when calling DispatchApi.set_destination"
1719
1835
  end
1720
1836
  # resource path
@@ -1747,8 +1863,8 @@ module RusticiSoftwareCloudV2
1747
1863
  end
1748
1864
  return data, status_code, headers
1749
1865
  end
1750
- # DestinationsDispatchesEnabledByTenant
1751
- # Enable or disable all related dispatches.
1866
+ # Update enabled status for a Destination's Dispatches
1867
+ # Updates the enabled status for all dispatches distributed to the destination. This is an access control measure allowing you to turn access to a previously distributed dispatch packages on or off.
1752
1868
  # @param destination_id Identifier for the destination
1753
1869
  # @param enabled
1754
1870
  # @param [Hash] opts the optional parameters
@@ -1758,8 +1874,8 @@ module RusticiSoftwareCloudV2
1758
1874
  nil
1759
1875
  end
1760
1876
 
1761
- # DestinationsDispatchesEnabledByTenant
1762
- # Enable or disable all related dispatches.
1877
+ # Update enabled status for a Destination&#39;s Dispatches
1878
+ # Updates the enabled status for all dispatches distributed to the destination. This is an access control measure allowing you to turn access to a previously distributed dispatch packages on or off.
1763
1879
  # @param destination_id Identifier for the destination
1764
1880
  # @param enabled
1765
1881
  # @param [Hash] opts the optional parameters
@@ -1769,11 +1885,11 @@ module RusticiSoftwareCloudV2
1769
1885
  @api_client.config.logger.debug 'Calling API: DispatchApi.set_destination_dispatch_enabled ...'
1770
1886
  end
1771
1887
  # verify the required parameter 'destination_id' is set
1772
- if @api_client.config.client_side_validation && destination_id.nil?
1888
+ if destination_id.nil?
1773
1889
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.set_destination_dispatch_enabled"
1774
1890
  end
1775
1891
  # verify the required parameter 'enabled' is set
1776
- if @api_client.config.client_side_validation && enabled.nil?
1892
+ if enabled.nil?
1777
1893
  fail ArgumentError, "Missing the required parameter 'enabled' when calling DispatchApi.set_destination_dispatch_enabled"
1778
1894
  end
1779
1895
  # resource path
@@ -1806,8 +1922,8 @@ module RusticiSoftwareCloudV2
1806
1922
  end
1807
1923
  return data, status_code, headers
1808
1924
  end
1809
- # Set the `enabled` status for `dispatchId`.
1810
- # Set the `enabled` status for `dispatchId`.
1925
+ # Update enabled status for a Dispatch
1926
+ # Updates the enabled status for the dispatch. This is an access control measure allowing you to turn access to a previously distributed dispatch packages on or off.
1811
1927
  # @param dispatch_id Identifier for the dispatch
1812
1928
  # @param enabled
1813
1929
  # @param [Hash] opts the optional parameters
@@ -1817,8 +1933,8 @@ module RusticiSoftwareCloudV2
1817
1933
  nil
1818
1934
  end
1819
1935
 
1820
- # Set the &#x60;enabled&#x60; status for &#x60;dispatchId&#x60;.
1821
- # Set the &#x60;enabled&#x60; status for &#x60;dispatchId&#x60;.
1936
+ # Update enabled status for a Dispatch
1937
+ # Updates the enabled status for the dispatch. This is an access control measure allowing you to turn access to a previously distributed dispatch packages on or off.
1822
1938
  # @param dispatch_id Identifier for the dispatch
1823
1939
  # @param enabled
1824
1940
  # @param [Hash] opts the optional parameters
@@ -1828,11 +1944,11 @@ module RusticiSoftwareCloudV2
1828
1944
  @api_client.config.logger.debug 'Calling API: DispatchApi.set_dispatch_enabled ...'
1829
1945
  end
1830
1946
  # verify the required parameter 'dispatch_id' is set
1831
- if @api_client.config.client_side_validation && dispatch_id.nil?
1947
+ if dispatch_id.nil?
1832
1948
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.set_dispatch_enabled"
1833
1949
  end
1834
1950
  # verify the required parameter 'enabled' is set
1835
- if @api_client.config.client_side_validation && enabled.nil?
1951
+ if enabled.nil?
1836
1952
  fail ArgumentError, "Missing the required parameter 'enabled' when calling DispatchApi.set_dispatch_enabled"
1837
1953
  end
1838
1954
  # resource path
@@ -1865,8 +1981,8 @@ module RusticiSoftwareCloudV2
1865
1981
  end
1866
1982
  return data, status_code, headers
1867
1983
  end
1868
- # Enable or disable hashing of the user info for the destination.
1869
- # Enable or disable hashing of the user info for the destination.
1984
+ # Update user PII hashing status for a Destination
1985
+ # Updates user PII hashing status for the destination. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
1870
1986
  # @param destination_id Identifier for the destination
1871
1987
  # @param enabled
1872
1988
  # @param [Hash] opts the optional parameters
@@ -1876,8 +1992,8 @@ module RusticiSoftwareCloudV2
1876
1992
  nil
1877
1993
  end
1878
1994
 
1879
- # Enable or disable hashing of the user info for the destination.
1880
- # Enable or disable hashing of the user info for the destination.
1995
+ # Update user PII hashing status for a Destination
1996
+ # Updates user PII hashing status for the destination. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
1881
1997
  # @param destination_id Identifier for the destination
1882
1998
  # @param enabled
1883
1999
  # @param [Hash] opts the optional parameters
@@ -1887,11 +2003,11 @@ module RusticiSoftwareCloudV2
1887
2003
  @api_client.config.logger.debug 'Calling API: DispatchApi.update_destination_hash_user_info ...'
1888
2004
  end
1889
2005
  # verify the required parameter 'destination_id' is set
1890
- if @api_client.config.client_side_validation && destination_id.nil?
2006
+ if destination_id.nil?
1891
2007
  fail ArgumentError, "Missing the required parameter 'destination_id' when calling DispatchApi.update_destination_hash_user_info"
1892
2008
  end
1893
2009
  # verify the required parameter 'enabled' is set
1894
- if @api_client.config.client_side_validation && enabled.nil?
2010
+ if enabled.nil?
1895
2011
  fail ArgumentError, "Missing the required parameter 'enabled' when calling DispatchApi.update_destination_hash_user_info"
1896
2012
  end
1897
2013
  # resource path
@@ -1924,8 +2040,8 @@ module RusticiSoftwareCloudV2
1924
2040
  end
1925
2041
  return data, status_code, headers
1926
2042
  end
1927
- # Update the dispatch with `dispatchId`.
1928
- # Update the dispatch with `dispatchId`.
2043
+ # Update information about a Dispatch
2044
+ # Updates information about the dispatch, such as the expiration date and registration cap. Only non-null values that are provided will be updated.
1929
2045
  # @param dispatch_id Identifier for the dispatch
1930
2046
  # @param dispatch_properties
1931
2047
  # @param [Hash] opts the optional parameters
@@ -1935,8 +2051,8 @@ module RusticiSoftwareCloudV2
1935
2051
  nil
1936
2052
  end
1937
2053
 
1938
- # Update the dispatch with &#x60;dispatchId&#x60;.
1939
- # Update the dispatch with &#x60;dispatchId&#x60;.
2054
+ # Update information about a Dispatch
2055
+ # Updates information about the dispatch, such as the expiration date and registration cap. Only non-null values that are provided will be updated.
1940
2056
  # @param dispatch_id Identifier for the dispatch
1941
2057
  # @param dispatch_properties
1942
2058
  # @param [Hash] opts the optional parameters
@@ -1946,11 +2062,11 @@ module RusticiSoftwareCloudV2
1946
2062
  @api_client.config.logger.debug 'Calling API: DispatchApi.update_dispatch ...'
1947
2063
  end
1948
2064
  # verify the required parameter 'dispatch_id' is set
1949
- if @api_client.config.client_side_validation && dispatch_id.nil?
2065
+ if dispatch_id.nil?
1950
2066
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.update_dispatch"
1951
2067
  end
1952
2068
  # verify the required parameter 'dispatch_properties' is set
1953
- if @api_client.config.client_side_validation && dispatch_properties.nil?
2069
+ if dispatch_properties.nil?
1954
2070
  fail ArgumentError, "Missing the required parameter 'dispatch_properties' when calling DispatchApi.update_dispatch"
1955
2071
  end
1956
2072
  # resource path
@@ -1983,8 +2099,8 @@ module RusticiSoftwareCloudV2
1983
2099
  end
1984
2100
  return data, status_code, headers
1985
2101
  end
1986
- # Enable or disable hashing of the user info for the dispatch.
1987
- # Enable or disable hashing of the user info for the dispatch.
2102
+ # Update user PII hashing status for a Dispatch
2103
+ # Updates user PII hashing status for the dispatch. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
1988
2104
  # @param dispatch_id Identifier for the dispatch
1989
2105
  # @param enabled
1990
2106
  # @param [Hash] opts the optional parameters
@@ -1994,8 +2110,8 @@ module RusticiSoftwareCloudV2
1994
2110
  nil
1995
2111
  end
1996
2112
 
1997
- # Enable or disable hashing of the user info for the dispatch.
1998
- # Enable or disable hashing of the user info for the dispatch.
2113
+ # Update user PII hashing status for a Dispatch
2114
+ # Updates user PII hashing status for the dispatch. Enabling it will cause all user PII to be hashed. Hashing PII will anonymize the learner data from the dispatched course. This will make looking up specific details about a learner difficult.
1999
2115
  # @param dispatch_id Identifier for the dispatch
2000
2116
  # @param enabled
2001
2117
  # @param [Hash] opts the optional parameters
@@ -2005,11 +2121,11 @@ module RusticiSoftwareCloudV2
2005
2121
  @api_client.config.logger.debug 'Calling API: DispatchApi.update_dispatch_hash_user_info ...'
2006
2122
  end
2007
2123
  # verify the required parameter 'dispatch_id' is set
2008
- if @api_client.config.client_side_validation && dispatch_id.nil?
2124
+ if dispatch_id.nil?
2009
2125
  fail ArgumentError, "Missing the required parameter 'dispatch_id' when calling DispatchApi.update_dispatch_hash_user_info"
2010
2126
  end
2011
2127
  # verify the required parameter 'enabled' is set
2012
- if @api_client.config.client_side_validation && enabled.nil?
2128
+ if enabled.nil?
2013
2129
  fail ArgumentError, "Missing the required parameter 'enabled' when calling DispatchApi.update_dispatch_hash_user_info"
2014
2130
  end
2015
2131
  # resource path
@@ -2042,5 +2158,79 @@ module RusticiSoftwareCloudV2
2042
2158
  end
2043
2159
  return data, status_code, headers
2044
2160
  end
2161
+ # Update a group of Dispatches
2162
+ # Updates information about a group of dispatches, such as registration cap, expiration date, and postback information. Can be filtered using the request parameters to provide a subset of results. >**Note:** >One of the filter parameters (i.e. `courseId`, `since`/`until`, `tags`, or `filter`) needs to be provided. This is to prevent accidental modification of all dispatches. If you do wish to update all dispatches, try setting the since parameter to a value prior to the creation of any dispatches. >**Info:** >If using one of our client libraries, refer to its README for additional information on how to work with the `X-Total-Count` header.
2163
+ # @param dispatch_properties
2164
+ # @param [Hash] opts the optional parameters
2165
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
2166
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
2167
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
2168
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against (default to updated)
2169
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
2170
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
2171
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter. (default to dispatch_id)
2172
+ # @return [nil]
2173
+ def update_dispatches(dispatch_properties, opts = {})
2174
+ update_dispatches_with_http_info(dispatch_properties, opts)
2175
+ nil
2176
+ end
2177
+
2178
+ # Update a group of Dispatches
2179
+ # Updates information about a group of dispatches, such as registration cap, expiration date, and postback information. Can be filtered using the request parameters to provide a subset of results. &gt;**Note:** &gt;One of the filter parameters (i.e. &#x60;courseId&#x60;, &#x60;since&#x60;/&#x60;until&#x60;, &#x60;tags&#x60;, or &#x60;filter&#x60;) needs to be provided. This is to prevent accidental modification of all dispatches. If you do wish to update all dispatches, try setting the since parameter to a value prior to the creation of any dispatches. &gt;**Info:** &gt;If using one of our client libraries, refer to its README for additional information on how to work with the &#x60;X-Total-Count&#x60; header.
2180
+ # @param dispatch_properties
2181
+ # @param [Hash] opts the optional parameters
2182
+ # @option opts [String] :course_id Only retrieve resources having &#x60;courseId&#x60;
2183
+ # @option opts [DateTime] :since Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
2184
+ # @option opts [DateTime] :_until Filter by ISO 8601 TimeStamp inclusive (defaults to UTC)
2185
+ # @option opts [String] :datetime_filter Specifies field that &#x60;since&#x60; and &#x60;until&#x60; parameters are applied against
2186
+ # @option opts [Array<String>] :tags Filter items matching any tag provided (not all)
2187
+ # @option opts [String] :filter Optional string which filters results by a specified field (described by filterBy).
2188
+ # @option opts [String] :filter_by Optional enum parameter for specifying the field on which to run the filter.
2189
+ # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
2190
+ def update_dispatches_with_http_info(dispatch_properties, opts = {})
2191
+ if @api_client.config.debugging
2192
+ @api_client.config.logger.debug 'Calling API: DispatchApi.update_dispatches ...'
2193
+ end
2194
+ # verify the required parameter 'dispatch_properties' is set
2195
+ if dispatch_properties.nil?
2196
+ fail ArgumentError, "Missing the required parameter 'dispatch_properties' when calling DispatchApi.update_dispatches"
2197
+ end
2198
+ # resource path
2199
+ local_var_path = '/dispatch/dispatches'
2200
+
2201
+ # query parameters
2202
+ query_params = {}
2203
+ query_params[:'courseId'] = opts[:'course_id'] if !opts[:'course_id'].nil?
2204
+ query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
2205
+ query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
2206
+ query_params[:'datetimeFilter'] = opts[:'datetime_filter'] if !opts[:'datetime_filter'].nil?
2207
+ query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :csv) if !opts[:'tags'].nil?
2208
+ query_params[:'filter'] = opts[:'filter'] if !opts[:'filter'].nil?
2209
+ query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
2210
+
2211
+ # header parameters
2212
+ header_params = {}
2213
+ # HTTP header 'Accept' (if needed)
2214
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
2215
+ # HTTP header 'Content-Type'
2216
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
2217
+
2218
+ # form parameters
2219
+ form_params = {}
2220
+
2221
+ # http body (model)
2222
+ post_body = @api_client.object_to_http_body(dispatch_properties)
2223
+ auth_names = ['APP_NORMAL', 'OAUTH']
2224
+ data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
2225
+ :header_params => header_params,
2226
+ :query_params => query_params,
2227
+ :form_params => form_params,
2228
+ :body => post_body,
2229
+ :auth_names => auth_names)
2230
+ if @api_client.config.debugging
2231
+ @api_client.config.logger.debug "API called: DispatchApi#update_dispatches\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
2232
+ end
2233
+ return data, status_code, headers
2234
+ end
2045
2235
  end
2046
2236
  end