|
1 ------------------------------------------------------------ |
|
2 CompOD User Requirements Document URD |
|
3 (User is the LMS - isac in this case) |
|
4 Last Modification: 20070726 |
|
5 ------------------------------------------------------------ |
|
6 |
|
7 ### 1) general |
|
8 |
|
9 *) CompOD is a Web service. |
|
10 It does not intitiate system behaviour, but waits passively for requests |
|
11 which are responded accordingly. Communication protocol is SOAP |
|
12 |
|
13 *) CompOD controls the adaptation behaviour in terms of kwoweldge |
|
14 |
|
15 *) isac (like other LMS) must register at CompOD once at launch |
|
16 and gets an ID (LMS-ID). |
|
17 |
|
18 *) CompOD is user-oriented. Each user gets a personalised service from CompOD. |
|
19 Users have to be registered once at launch with a unique username |
|
20 (LMS can determine the username) |
|
21 |
|
22 *) internal key for CompOD is LMS-id + username, must be used for every request. |
|
23 |
|
24 *) there are two modi for isac's USERMODELHANDLER (2 values in properties, and only 1 code). |
|
25 assessment and course |
|
26 |
|
27 ### 2) data model |
|
28 |
|
29 *) there is a data model / ontology (see sheet) manged by CompOD. |
|
30 It comprises reference to problems and learning objects, and references to users. |
|
31 Furthermore, it comprises skills, concepts, and action verbs. |
|
32 ontology structure in further document (TODO AN). |
|
33 |
|
34 *) there are functions to create, modify, and delete the ontology entities. |
|
35 ((for automatic generation of ontoloy) OR import of ontology as a whole). |
|
36 the id's of problems, learning objects, skills in ontology which must match the |
|
37 objects in LMS. |
|
38 |
|
39 *) the ontology has to be created by the LSM (which contains information |
|
40 about users, learning objects, and their relations to skills, |
|
41 concepts, and action verbs. ) or created manually and imported |
|
42 TODO (TODO AN+WN0709 3 examples [3Std] ++ thesis) |
|
43 [ in september 3 examples/problesm are assigned manually with skills |
|
44 and ontology is created manually, AN+WN; |
|
45 probably a psychology thesis is used to buid the whole ontology; |
|
46 automatic building of the ontology is possible but to exhausting (half year) ] |
|
47 |
|
48 |
|
49 ### 3) assessment |
|
50 |
|
51 *) the assessment has to be started by the LMS (start isac with property COMPOD_ASSESS). |
|
52 |
|
53 *) during an assessment the problems are assigned by ComOD; |
|
54 there is a method 'getNextLearningObject (type)', type = assessment |
|
55 CompOD may present a list for selection of problem. |
|
56 isac can choose randomly one of them, or it can allow the user to choose among this list |
|
57 |
|
58 *) if a problem is selected by the user (within LMS) then CompOD is to be informed. |
|
59 |
|
60 *) a problem consists of skills, brought into a sequence of steps by isac. |
|
61 a step is assigned by isac (and never by CompPod) |
|
62 |
|
63 *) after each step within a problem a message is sent to CompOD. |
|
64 the message contains: a step has three arguments: |
|
65 - id of problem, concept, and mastery status |
|
66 - an iteger indicating the activity-level of the user |
|
67 (assumptionL: 'solved' with a high activit-level indicates good mastering |
|
68 of the concept, 'solved' with a low activit-level not necessarily indicates |
|
69 good mastering of the concept) |
|
70 |
|
71 * LMS reports the end of a problem as 'solved | not-solved'; |
|
72 internally in isac, 'not-solved' is invoked when the user closes the problem window; |
|
73 |
|
74 *) CompOD provides a method to check the status |
|
75 (if assessment is finnished, then no more problems are needed to be worked on) |
|
76 the function 'getNextLearningObject' also returns value which indicates that |
|
77 assessment is finnished) |
|
78 |
|
79 *) in isac more problems can be elaborated by a learner at the same time |
|
80 (TODO AN: check, what this means psychologically) |
|
81 |
|
82 |
|
83 ### 4) course |
|
84 |
|
85 *) the course has to be started by the LMS (start isac with property COMPOD_COURSE). |
|
86 |
|
87 *) during a course the learning objects are assigned by ComOD; |
|
88 there is a method 'getNextLearningObject (type)', type = course |
|
89 CompOD may present a list for selection of learning objects. |
|
90 isac can choose randomly one of them, or it can allow the user to choose among this list |
|
91 |
|
92 *) if a LO is selected by the user (within LMS) then CompOD is to be informed. |
|
93 |
|
94 *) LMS reports the end of an LO |
|
95 |
|
96 *) CompOD provides a method to check the status (if assessment is finnished) |
|
97 |
|
98 |
|
99 |
|
100 ---------------------------------------------------- |
|
101 TODOs |
|
102 - further elaboration of this docuement and diagram of ontology [AN] |
|
103 - first CompOD implemenation (at least a dummy with interface which reflects |
|
104 this specification) until 20070831 [AN] |
|
105 - manual creation of very small ontology (3 examples/problems) in beginning |
|
106 of september [WN, AN] |
|
107 - implementation of functionality in ISAC which connects to CompOD and uses |
|
108 its services, in first half of semptember [CR with help of AN] |