Difference between revisions of "CUMULATE protocol"

From PAWS Lab
Jump to: navigation, search
(URLs of web-services)
(Parameter Naming Conventions)
Line 9: Line 9:
  
 
= 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.
 
+
* usr – user, user login
 +
* sid – session id
 +
* app – application, activity server
 +
** <pre>1</pre> – 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; knowledge (KnowledgeSea)
 +
comprehension (WebEx/NavEx, WADEIn in exploration mode)
 +
application (QuizPACK/QuizGuide, WADEIn in evaluation mode)
 +
comma separated combinations of all of the above without spaces (e.g. knowledge,comprehension)
 +
* 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 stackable transparent authentication =  

Revision as of 21:44, 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; knowledge (KnowledgeSea)

comprehension (WebEx/NavEx, WADEIn in exploration mode) application (QuizPACK/QuizGuide, WADEIn in evaluation mode) comma separated combinations of all of the above without spaces (e.g. knowledge,comprehension)

  • 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