Difference between revisions of "CUMULATE protocol"

From PAWS Lab
Jump to: navigation, search
(Parameter Naming Conventions)
(Parameter Naming Conventions)
Line 10: Line 10:
 
= Parameter Naming Conventions =
 
= Parameter Naming Conventions =
 
The following parameter names (and their possible values) should be used in communication between all applications using ADAPT² protocols.
 
The following parameter names (and their possible values) should be used in communication between all applications using ADAPT² protocols.
* usr – user, user login
+
* '''usr''' – user, user login
* sid – session id
+
* '''sid''' – session id
* app – application, activity server
+
* '''app''' – application, activity server
** 1 – Unknown application
+
** '''1''' – Unknown application
** 2 – QuizPACK
+
** '''2''' – QuizPACK
** 3 – WebEx
+
** '''3''' – WebEx
** 4 – WADEIn
+
** '''4''' – WADEIn
** 5 – KnowledgeSea
+
** '''5''' – KnowledgeSea
** 6 – AnnotatEd
+
** '''6''' – AnnotatEd
** 7 – venn
+
** '''7''' – venn
** 8 – KnowledgeTree
+
** '''8''' – KnowledgeTree
** 9 – NavEx
+
** '''9''' – NavEx
** 10 – CourseAgent
+
** '''10''' – CourseAgent
** 11 – cWADEIn II
+
** '''11''' – cWADEIn II
** 12 – VIBE
+
** '''12''' – VIBE
** 13 – VirtPresenter
+
** '''13''' – VirtPresenter
** 14 – Problets
+
** '''14''' – Problets
** 15 – VarScope
+
** '''15''' – VarScope
** 16 – BooleanTool
+
** '''16''' – BooleanTool
** 17 – Jeliot
+
** '''17''' – Jeliot
** 18 – free slot
+
** '''18''' – free slot
** 19 – free slot
+
** '''19''' – free slot
** 20 – QuizQUIDE
+
** '''20''' – QuizQUIDE
** 21 – jWADEIn II
+
** '''21''' – jWADEIn II
** 22 – free slot
+
** '''22''' – free slot
** 23 – SQL KnoT
+
** '''23''' – SQL KnoT
** 24 – ADAPT² PService
+
** '''24''' – ADAPT² PService
* act – learning action, learning object – minimally invokable piece of learning object (quiz, example etc.)
+
* '''act''' – learning action, learning object – minimally invokable piece of learning object (quiz, example etc.)
* sub – sub-action, step of learning action, fragment of learning object – minimal trackable piece of learning object (question of quiz, line of example etc.)
+
* '''sub''' – sub-action, step of learning action, fragment of learning object – minimal trackable piece of learning object (question of quiz, line of example etc.)
* grp – group name; suggested naming convention for group name is {academic year, semester, group identified or name within semester}, e.g. 200621 – Spring 2006, group 1
+
* '''grp''' – group name; suggested naming convention for group name is {academic year, semester, group identified or name within semester}, e.g. 200621 – Spring 2006, group 1
* res – result of the interaction – any decimal value e.g. -1, 0, 0.4, 0.7, 1
+
* '''res''' – result of the interaction – any decimal value e.g. -1, 0, 0.4, 0.7, 1
* svc – service parameter – any character string that can be used to store system state, should not contain ? (question mark), & (ampersand), : (colon), and / (backward slash); however all those symbols can be encoded using Java URLEncoder class that maps them to %XX; service parameter
+
* '''svc''' – service parameter – any character string that can be used to store system state, should not contain ? (question mark), & (ampersand), : (colon), and / (backward slash); however all those symbols can be encoded using Java URLEncoder class that maps them to %XX; service parameter
* lev – Bloom's level; knowledge (KnowledgeSea)
+
* '''lev''' – Bloom's level - comma separated combinations of the ones below without spaces (e.g. knowledge,comprehension)
comprehension (WebEx/NavEx, WADEIn in exploration mode)
+
** '''knowledge''' (KnowledgeSea)
application (QuizPACK/QuizGuide, WADEIn in evaluation mode)
+
** '''comprehension''' (WebEx/NavEx, WADEIn in exploration mode)
comma separated combinations of all of the above without spaces (e.g. knowledge,comprehension)
+
** '''application''' (QuizPACK/QuizGuide, WADEIn in evaluation mode)
* prc – precision
+
* '''prc''' – precision
* ums – user modeling server URL for reporting user activity to
+
* '''ums''' – user modeling server URL for reporting user activity to
* dom – learning domain (e.g. C programming), will define the concepts ontology
+
* '''dom''' – learning domain (e.g. C programming), will define the concepts ontology
* con - concept - knowledge component of a learning domain
+
* '''con''' - concept - knowledge component of a learning domain
* scp – scope of activities (used for multiple groupings of activities).
+
* '''scp''' – scope of activities (used for multiple groupings of activities).
 
It is advised to use these parameters and values even internally.
 
It is advised to use these parameters and values even internally.
  

Revision as of 22:00, 20 November 2007

URLs of web-services

These are the URLs of the web-services that implement components of the ADAPT² architecture and protocols.

User Activity report receiver - this service listens to applications that report user activity

http://adapt2.sis.pitt.edu/cbum/um

Report Manager - service that answers queries about users' progress with learning objects and mastery of concepts

http://adapt2.sis.pitt.edu/cbum/ReportManager

Parameter Naming Conventions

The following parameter names (and their possible values) should be used in communication between all applications using ADAPT² protocols.

  • usr – user, user login
  • sid – session id
  • app – application, activity server
    • 1 – Unknown application
    • 2 – QuizPACK
    • 3 – WebEx
    • 4 – WADEIn
    • 5 – KnowledgeSea
    • 6 – AnnotatEd
    • 7 – venn
    • 8 – KnowledgeTree
    • 9 – NavEx
    • 10 – CourseAgent
    • 11 – cWADEIn II
    • 12 – VIBE
    • 13 – VirtPresenter
    • 14 – Problets
    • 15 – VarScope
    • 16 – BooleanTool
    • 17 – Jeliot
    • 18 – free slot
    • 19 – free slot
    • 20 – QuizQUIDE
    • 21 – jWADEIn II
    • 22 – free slot
    • 23 – SQL KnoT
    • 24 – ADAPT² PService
  • act – learning action, learning object – minimally invokable piece of learning object (quiz, example etc.)
  • sub – sub-action, step of learning action, fragment of learning object – minimal trackable piece of learning object (question of quiz, line of example etc.)
  • grp – group name; suggested naming convention for group name is {academic year, semester, group identified or name within semester}, e.g. 200621 – Spring 2006, group 1
  • res – result of the interaction – any decimal value e.g. -1, 0, 0.4, 0.7, 1
  • svc – service parameter – any character string that can be used to store system state, should not contain ? (question mark), & (ampersand), : (colon), and / (backward slash); however all those symbols can be encoded using Java URLEncoder class that maps them to %XX; service parameter
  • lev – Bloom's level - comma separated combinations of the ones below without spaces (e.g. knowledge,comprehension)
    • knowledge (KnowledgeSea)
    • comprehension (WebEx/NavEx, WADEIn in exploration mode)
    • application (QuizPACK/QuizGuide, WADEIn in evaluation mode)
  • prc – precision
  • ums – user modeling server URL for reporting user activity to
  • dom – learning domain (e.g. C programming), will define the concepts ontology
  • con - concept - knowledge component of a learning domain
  • scp – scope of activities (used for multiple groupings of activities).

It is advised to use these parameters and values even internally.

Protocol for stackable transparent authentication

Protocol for sending events to the User Model

Using Report API to send reports to User Model

Sending reports from Applets via relay servlet

Protocols for requesting user progress

Getting user progress report in an XML format

Getting user progress report in the format of Java serialized objects

Protocols for requesting user knowledge of concepts

Getting user knowledge of concepts report in an XML format

Getting user knowledge of concepts report in the format of Java serialized objects