-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy path_doc_api_outcomes.html.txt
154 lines (127 loc) · 7.53 KB
/
_doc_api_outcomes.html.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
Outcomes API
API for accessing learning outcome information.
An Outcome object looks like:
{
// the ID of the outcome
"id": 1,
// the URL for fetching/updating the outcome. should be treated as opaque
"url": "/api/v1/outcomes/1",
// the context owning the outcome. may be null for global outcomes
"context_id": 1,
"context_type": "Account",
// title of the outcome
"title": "Outcome title",
// Optional friendly name for reporting
"display_name": "My Favorite Outcome",
// description of the outcome. omitted in the abbreviated form.
"description": "Outcome description",
// A custom GUID for the learning standard.
"vendor_guid": "customid9000",
// maximum points possible. included only if the outcome embeds a rubric
// criterion. omitted in the abbreviated form.
"points_possible": 5,
// points necessary to demonstrate mastery outcomes. included only if the
// outcome embeds a rubric criterion. omitted in the abbreviated form.
"mastery_points": 3,
// the method used to calculate a students score
"calculation_method": "decaying_average",
// this defines the variable value used by the calculation_method. included only
// if calculation_method uses it
"calculation_int": 65,
// possible ratings for this outcome. included only if the outcome embeds a
// rubric criterion. omitted in the abbreviated form.
"ratings": null,
// whether the current user can update the outcome
"can_edit": true,
// whether the outcome can be unlinked
"can_unlink": true,
// whether this outcome has been used to assess a student
"assessed": true,
// whether updates to this outcome will propagate to unassessed rubrics that
// have imported it
"has_updateable_rubrics": true
}
An OutcomeAlignment object looks like:
{
// the id of the aligned learning outcome.
"id": 1,
// the id of the aligned assignment (null for live assessments).
"assignment_id": 2,
// the id of the aligned live assessment (null for assignments).
"assessment_id": 3,
// a string representing the different submission types of an aligned
// assignment.
"submission_types": "online_text_entry,online_url",
// the URL for the aligned assignment.
"url": "/courses/1/assignments/5",
// the title of the aligned assignment.
"title": "Unit 1 test"
}
Show an outcomeOutcomesApiController#show
GET /api/v1/outcomes/:id
Returns the details of the outcome with the given id.
Parameter | | Type | Description
add_defaults | | boolean | If defaults are requested, then color and mastery level defaults will be added to outcome ratings in the result. This will only take effect if the Account Level Mastery Scales FF is DISABLED
If defaults are requested, then color and mastery level defaults will be added to outcome ratings in the result. This will only take effect if the Account Level Mastery Scales FF is DISABLED
Update an outcomeOutcomesApiController#update
PUT /api/v1/outcomes/:id
Modify an existing outcome. Fields not provided are left as is; unrecognized fields are ignored.
If any new ratings are provided, the combination of all new ratings provided completely replace any existing embedded rubric criterion; it is not possible to tweak the ratings of the embedded rubric criterion.
A new embedded rubric criterionâs mastery_points default to the maximum points in the highest rating if not specified in the mastery_points parameter. Any new ratings lacking a description are given a default of âNo descriptionâ. Any new ratings lacking a point value are given a default of 0.
Parameter | | Type | Description
title | | string | The new outcome title.
display_name | | string | A friendly name shown in reports for outcomes with cryptic titles, such as common core standards names.
description | | string | The new outcome description.
vendor_guid | | string | A custom GUID for the learning standard.
mastery_points | | integer | The new mastery threshold for the embedded rubric criterion.
ratings[][description] | | string | The description of a new rating level for the embedded rubric criterion.
ratings[][points] | | integer | The points corresponding to a new rating level for the embedded rubric criterion.
calculation_method | | string | The new calculation method. If the Outcomes New Decaying Average Calculation Method FF is ENABLED then âweighted_averageâ can be used and it is same as previous âdecaying_averageâ and new âdecaying_averageâ will have improved version of calculation.Allowed values:weighted_average,decaying_average,n_mastery,latest,highest,average
calculation_int | | integer | The new calculation int. Only applies if the calculation_method is âdecaying_averageâ or ân_masteryâ
add_defaults | | boolean | If defaults are requested, then color and mastery level defaults will be added to outcome ratings in the result. This will only take effect if the Account Level Mastery Scales FF is DISABLED
The new outcome title.
A friendly name shown in reports for outcomes with cryptic titles, such as common core standards names.
The new outcome description.
A custom GUID for the learning standard.
The new mastery threshold for the embedded rubric criterion.
The description of a new rating level for the embedded rubric criterion.
The points corresponding to a new rating level for the embedded rubric criterion.
The new calculation method. If the Outcomes New Decaying Average Calculation Method FF is ENABLED then âweighted_averageâ can be used and it is same as previous âdecaying_averageâ and new âdecaying_averageâ will have improved version of calculation.
Allowed values:weighted_average,decaying_average,n_mastery,latest,highest,average
The new calculation int. Only applies if the calculation_method is âdecaying_averageâ or ân_masteryâ
If defaults are requested, then color and mastery level defaults will be added to outcome ratings in the result. This will only take effect if the Account Level Mastery Scales FF is DISABLED
curl 'https://<canvas>/api/v1/outcomes/1.json' \
-X PUT \
-F 'title=Outcome Title' \
-F 'display_name=Title for reporting' \
-F 'description=Outcome description' \
-F 'vendor_guid=customid9001' \
-F 'mastery_points=3' \
-F 'calculation_method=decaying_average' \
-F 'calculation_int=65' \
-F 'ratings[][description]=Exceeds Expectations' \
-F 'ratings[][points]=5' \
-F 'ratings[][description]=Meets Expectations' \
-F 'ratings[][points]=3' \
-F 'ratings[][description]=Does Not Meet Expectations' \
-F 'ratings[][points]=0' \
-F 'ratings[][points]=0' \
-H "Authorization: Bearer <token>"
curl 'https://<canvas>/api/v1/outcomes/1.json' \
-X PUT \
--data-binary '{
"title": "Outcome Title",
"display_name": "Title for reporting",
"description": "Outcome description",
"vendor_guid": "customid9001",
"mastery_points": 3,
"ratings": [
{ "description": "Exceeds Expectations", "points": 5 },
{ "description": "Meets Expectations", "points": 3 },
{ "description": "Does Not Meet Expectations", "points": 0 }
]
}' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>"
Get aligned assignments for an outcome in a course for a particular studentOutcomesApiController#outcome_alignments
GET /api/v1/courses/:course_id/outcome_alignments