| ShortName | Name | Type | Description | Required? | Read only? | Implementation Notes |
|---|---|---|---|---|---|---|
| id | Id | String | Unique identifier for the object within the service. You DO NOT HAVE TO SET THE ID -- the service constructs it for you when you create an object. However... You MAY set it to an "alias" by which you which to later access this object. The alias id MUST be unique across all aliases for that kind of object. The alias id is composed of 3 parts... namespace : identifier @ authority. If a namespace is supplied it must match the namespace of the type of object being created, if not supplied the namespace defaults to the namespace of the type of the object being created. If the authority is supplied it must be the "USER-ALIAS" if not supplied then this authority will be used as the default. Even if you do supply an alias Id when creating the object then the service still constructs and assigns an new unique internal id for the object BUT it also adds the ID you supplied as an aliasId. Note: if you do not assign an alias when you create the object you can assign one using the id service, addAliasId method. The id is expected to be unique and should be treated as if the id is opaque. Opaque means that no consumer should interrogate the structure of the string but should just manipulate it as a whole. Having said that, there two things you should know about ids: (1) They should follow this structure: namespace:identifier@authority . (2) All ids passed through the RESTful interface have been encoded so they do not mess up URLS when fetched when used as parameters to fetch a particular object. They are decoded back when passed back in. This is applied not just to this ID field but ALL ids passed in as parameters and fetched back as fields on beans. These two issues should NOT make a difference to any processing, it just explains the structure you would find if you examined the contents of an id. OSID reference: Id * |
Required | Read only on updates | |
| genusTypeId | Genus Type Id | String | The genus type of the object. This is a code that indicates the detailed type of an object, it represents a further breakdown of the object into sub-categories. For example in MC3 Learning Objectives have two main types: (1) TOPIC (2) OUTCOME The name and description of the type can be found by calling the type service. OSID reference: OsidObject |
Required | ||
| displayName | Display Name | DisplayTextBean | Get the name of the object to be displayed on the screen to a user. All objects MUST HAVE A DISPLAY NAME. OSID reference: OsidObject |
Required | ||
| description | Description | DisplayTextBean | The description of the object The consumer might have to interrogate the format type to properly display the the description on the screen. In particular some of the objectives have LATEX markup in them that needs to be translated to display appropriately. OSID reference: OsidObject |
|||
| objectiveId | Objective Id | String | The id of the objective to which this activity is attached. OSID reference: Activity |
Required | Read only specified on create but cannot be changed on updates | |
| assetIds | Asset Ids | StringList | List of ids for assets that a student may consume to become proficient in the attached objective. For example the asset may be to watch a movie or to read a web page or a section of a book. OSID reference: Activity |
|||
| courseIds | Course Ids | StringList | List of ids for courses that a student may take to become proficient in this objective. TODO: Task #54 Add support for course service so we can support looking up courses. OSID reference: Activity |
not implemented | ||
| assessmentIds | Assessment Ids | StringList | List of ids for assessments that a student can take as the activity for learning this objective. Most people don't really realize it but taking an assessment is actually an activity you can do to force yourself to actually think deeply about a concept or topic or idea and actually force yourself to learn it. TODO: Task #55 Add assessment service so we can support looking up assessments OSID reference: Activity |
not implemented | ||
| current | Current | boolean | Indicates if the object might be stale or if it was freshly pulled from the underlying data store. If the object was fetched from a cache then this value should be false. OSID reference: Identifiable |
Required | Read only | |
| sortKey | Sort Key | String | Sort key that can be used to sort this object when in a list. This value is NOT persisted but is calculated based on the query that was used to fetch the objects. For example the larger the value the more relevant the keyword search applies to this object. |
|||
| extensionRecord | Extension Record | ExtensionRecordBean | Extension Record for this object if the method requested that the extension record be included. |
|||
| auditTrail | Audit Trail | AuditTrailBean | Audit trail information about when this object was created/updated |
{
"type" : "Activity",
"id" : "id",
"genusTypeId" : "id",
"displayName" : {
"languageTypeId" : "id",
"scriptTypeId" : "id",
"formatTypeId" : "id",
"text" : "XXXX"
},
"description" : {
"languageTypeId" : "id",
"scriptTypeId" : "id",
"formatTypeId" : "id",
"text" : "XXXX"
},
"objectiveId" : "id",
"assetIds" : ["id", ...],
"courseIds" : ["id", ...],
"assessmentIds" : ["id", ...],
"current" : true,
"sortKey" : "XXXX",
"extensionRecord" : {
"recordTypeIds" : ["id", ...],
"recordProperties" : [ {
"displayName" : {
"languageTypeId" : "id",
"scriptTypeId" : "id",
"formatTypeId" : "id",
"text" : "XXXX"
},
"description" : {
"languageTypeId" : "id",
"scriptTypeId" : "id",
"formatTypeId" : "id",
"text" : "XXXX"
},
"recordTypeId" : "id",
"value" : "XXXX",
"displayLabel" : {
"languageTypeId" : "id",
"scriptTypeId" : "id",
"formatTypeId" : "id",
"text" : "XXXX"
},
"associatedId" : "id"
},
...],
"associatedId" : "id"
},
"auditTrail" : {
"addedBy" : "XXXX",
"addedOn" : "YYYY-MM-DDThh:mm:ss",
"updatedBy" : "XXXX",
"updatedOn" : "YYYY-MM-DDThh:mm:ss",
"comment" : "XXXX"
}
}