assignment (xml)

Represents assignments for a given site.
RESTful URLs: http://microformats.org/wiki/rest/urls
HTTP response codes as returned by the system:
200 - OK (request is ok and content returned)
201 - CREATED (request created new content, URL and id of content in the header)
204 - NO CONTENT (request is ok but no content to return)
400 - ERROR (general error in the request, probably invalid parameters or data)
401 - UNAUTHORIZED (user authentication required for this request)
403 - FORBIDDEN (authorization required, insufficient privileges, user is already authenticated)
404 - NOT FOUND (resource not found, URL is invalid in some way, id or action are invalid)
405 - METHOD NOT ALLOWED (the method is not supported for this entity type)
406 - NOT ACCEPTABLE (the data format requested is unavailable for this entity type)
500 - INTERNAL SERVER ERROR (general server failure, probably a failure in the provider)
501 - NOT IMPLEMENTED (indicates that a prefix is invalid)

Sample Entity URLs (_id=':ID:') [may not be valid]:

Show Entity URL: GET /assignment/:ID: (xml) (json) (form)
Response Code Details: 200 plus data; 404 if not found, 406 if format unavailable

Custom Actions

deepLinkWithPermissions : list (GET) : [/assignment/deepLinkWithPermissions] (xml) (json) (form)
The action takes assignment reference, and boolean value for allowReadAssignment, allowAddAssignment, allowSubmitAssignment and returns the deepLink url. Here is the request url pattern: /direct/assignment/deepLinks/{assignment_ref} with parameters {bool_allowRead}, {bool_allowAdd} and {bool_allowSubmit}
item : list (GET) : [/assignment/item] (xml) (json) (form)
Retrieve an assignment specified by the assignment id. The request url pattern: /direct/assignment/item/{assignmentId}.{format}
fullSubmissions : list (GET) : [/assignment/fullSubmissions] (xml) (json) (form)
itemSubmission : list (GET) : [/assignment/itemSubmission] (xml) (json) (form)
my : list (GET) : [/assignment/my] (xml) (json) (form)
Retrieve all my assignments for all of my sites. The request url pattern: /direct/assignment/my.{format}
removeFeedbackAttachment : list (GET) : [/assignment/removeFeedbackAttachment] (xml) (json) (form)
annc : list (GET) : [/assignment/annc] (xml) (json) (form)
The action takes assignment reference, and returns information about assignment for announcement integration. The assignment information includes assignment object, context, assignmentId, assignmentTitle, assignmentUrl. Here is the request url pattern: /direct/assignment/annc/{assignment_ref} with paramter {messageId}
site : list (GET) : [/assignment/site] (xml) (json) (form)
Retrieve the assignments for a site. The request url pattern: /direct/assignment/site/{siteId}.{format}.gradebookItemId returns data in 3 different format 1) ""- if an assignment is not associated with gradebook 2) "{String-of gradebookItem name}"- when Associate an assignment with existing Gradebook item 3)"/assignment/a/{site_id}/{assignment-id}"- when Adding Assignment to Gradebook.
getTimeSheet : list (GET) : [/assignment/getTimeSheet] (xml) (json) (form)
removeTimeSheet : new (POST) : [/assignment/removeTimeSheet]
deepLink : list (GET) : [/assignment/deepLink] (xml) (json) (form)
The action takes assignment reference, returns the deepLink url for current user. Here is the request url pattern: /direct/assignment/deepLinks/{assignment_ref}
addTimeSheet : new (POST) : [/assignment/addTimeSheet]
setGrade : new (POST) : [/assignment/setGrade]
gradable : list (GET) : [/assignment/gradable] (xml) (json) (form)
checkForUsersInMultipleGroups : list (GET) : [/assignment/checkForUsersInMultipleGroups] (xml) (json) (form)

Entity class : org.sakaiproject.assignment.entityproviders.AssignmentEntityProvider$SimpleAssignment

Type :: bean
Name Type Status
1) accessstringRead/Write
2) allPurposeItemTextstringRead/Write
3) allowPeerAssessmentbooleanRead/Write
4) allowResubmissionbooleanRead/Write
5) anonymousGradingbooleanRead/Write
6) attachmentsjava.util.ListRead/Write
7) authorstringRead/Write
8) authorLastModifiedstringRead/Write
9) closeTimejava.time.InstantRead/Write
10) closeTimeStringstringRead/Write
11) contentorg.sakaiproject.assignment.api.model.AssignmentRead/Write
12) contextstringRead/Write
13) creatorstringRead/Write
14) draftbooleanRead/Write
15) dropDeadTimejava.time.InstantRead/Write
16) dropDeadTimeStringstringRead/Write
17) dueTimejava.time.InstantRead/Write
18) dueTimeStringstringRead/Write
19) estimatestringRead/Write
20) estimateRequiredbooleanRead/Write
21) gradeScalestringRead/Write
22) gradeScaleMaxPointsstringRead/Write
23) gradebookItemIdlongRead/Write
24) gradebookItemNamestringRead/Write
25) groupsjava.util.CollectionRead/Write
26) idstringRead/Write
27) instructionsstringRead/Write
28) ltiGradableLaunchstringRead/Write
29) maxGradePointstringRead/Write
30) modelAnswerTextstringRead/Write
31) openTimejava.time.InstantRead/Write
32) openTimeStringstringRead/Write
33) positionintRead/Write
34) privateNoteTextstringRead/Write
35) sectionstringRead/Write
36) statusstringRead/Write
37) submissionTypestringRead/Write
38) submissionsjava.util.ListRead/Write
39) timeCreatedjava.time.InstantRead/Write
40) timeLastModifiedjava.time.InstantRead/Write
41) titlestringRead/Write

Data and Request Handling

Output formats : xml, json, form
Input formats : html, xml, json
Access Provider available for request processing : EntityViewAccessProvider
Access Provider available for request processing : EntityViewAccessProvider

Capabilities

NameTypeDescription
1CoreEntityProviderorg.sakaiproject.entitybroker.entityprovider.CoreEntityProvider
2EntityProviderorg.sakaiproject.entitybroker.entityprovider.EntityProvider
3ActionsExecutableorg.sakaiproject.entitybroker.entityprovider.capabilities.ActionsExecutable
4AutoRegisterEntityProviderorg.sakaiproject.entitybroker.entityprovider.capabilities.AutoRegisterEntityProvider
5Describeableorg.sakaiproject.entitybroker.entityprovider.capabilities.Describeable
6Inputableorg.sakaiproject.entitybroker.entityprovider.capabilities.Inputable
7Outputableorg.sakaiproject.entitybroker.entityprovider.capabilities.Outputable
8PropertyProvideableorg.sakaiproject.entitybroker.entityprovider.capabilities.PropertyProvideable
9Propertyableorg.sakaiproject.entitybroker.entityprovider.capabilities.Propertyable
10Resolvableorg.sakaiproject.entitybroker.entityprovider.capabilities.Resolvable
11Sampleableorg.sakaiproject.entitybroker.entityprovider.capabilities.Sampleable

REST:: 1.0.1 SVN: $Revision$ : $Date$