CUMULATE protocol - Revision history

Peterb at 23:52, 20 January 2025

2025-01-20T23:52:27Z

2012-02-09T22:04:06Z

‎Getting user progress report in the format of JSON files

2012-02-09T21:56:07Z

‎Getting user progress report in the format of Java serialized objects

2010-10-18T14:08:30Z

‎Parameter Naming Conventions

2010-02-05T14:35:47Z

‎Parameter Naming Conventions

2009-10-29T16:15:10Z

‎Protocol for user authentication and activity invocation

2009-10-29T16:14:46Z

‎Protocol for stackable user authentication

2009-10-29T16:11:58Z

2009-07-01T17:22:22Z

‎Protocol for reporting changes in user knowledge

2009-07-01T17:17:44Z

‎Protocol for reporting changes in user knowledge

@@ Line 74: / Line 74: @@
 = Protocol for reporting user activity =
-This protocol allows external applications to send the infomation about user actions to the user model. To successfully report user activity the external aplication should describe what learning object the user has been working with, who is the user, and what was the result of the interaction.
+This protocol allows external applications to send the infomation about user actions to the user model. To successfully report user activity, the external application should describe what learning object the user has been working with, who the user is, and what was the result of the interaction.
 Request URL Format:

@@ Line 362: / Line 362: @@
 [[#top|^top]]
-== Getting user progress report in the format of JSON files ==
 = Protocol for requesting user knowledge of concepts =

← Older revision		Revision as of 21:56, 9 February 2012
Line 360:		Line 360:
	</pre>		</pre>

		+	[[#top\|^top]]
		+
		+	== Getting user progress report in the format of JSON files ==
	[[#top\|^top]]		[[#top\|^top]]

@@ Line 41: / Line 41: @@
 ** '''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.)

@@ Line 35: / Line 35: @@
 ** '''17''' – Jeliot
 ** '''18''' – WOTAN
-** '''19''' – free slot
+** '''19''' – SQL-Tutor
 ** '''20''' – QuizQUIDE
 ** '''21''' – jWADEIn II

@@ Line 67: / Line 67: @@
 * '''usr''' - user identifier, usually login (mandatory)
 * '''grp''' - group identifier (mandatory), just like a user identifier, but for a group of users (class, research team)
-* '''sid''' - session identifier (optional), usually 5 character string each application makes a choice whether and how to come up with this parameter (e.g. truncate [http://en.wikipedia.org/wiki/Apache_Tomcat|Apache Tomcat] session id to last 5 characters)
+* '''sid''' - session identifier (optional), usually 5 character string each application makes a choice whether and how to come up with this parameter (e.g. truncate [http://en.wikipedia.org/wiki/Apache_Tomcat | Apache Tomcat] session id to last 5 characters)
 *  '''act''' - id of the resource (mandatory), each application maintains its own vocabulary of resource ids
 * '''sub''' - if resource is a collection of multiple resources/steps, then a sub-resource id is supplied (optional)

@@ Line 62: / Line 62: @@
 [[#top|^top]]
-= Protocol for stackable user authentication =
+= Protocol for user authentication and activity invocation =
-This protocol is adopted not only by CUMULATE but by most of the [[ADAPT2|ADAPT<sup>2</sup>]] tools. It regulates how user identity is transferred from application to application via the following HTTP parameters
+This protocol is adopted not only by CUMULATE but by most of the [[ADAPT2|ADAPT<sup>2</sup>]] tools. It regulates how user and resource identities is transferred from application to application via the following HTTP parameters
 * '''usr''' - user identifier, usually login (mandatory)
 * '''grp''' - group identifier (mandatory), just like a user identifier, but for a group of users (class, research team)
-* '''sid''' - session identifier, usually 5 character string each application makes a choice whether and how to come up with this parameter (e.g. truncate [http://en.wikipedia.org/wiki/Apache_Tomcat|Apache Tomcat] session id to last 5 characters)
+* '''sid''' - session identifier (optional), usually 5 character string each application makes a choice whether and how to come up with this parameter (e.g. truncate [http://en.wikipedia.org/wiki/Apache_Tomcat|Apache Tomcat] session id to last 5 characters)
 = Protocol for reporting user activity =

← Older revision		Revision as of 16:11, 29 October 2009
Line 61:		Line 61:

	[[#top\|^top]]		[[#top\|^top]]
		+
		+	= Protocol for stackable user authentication =
		+
		+	This protocol is adopted not only by CUMULATE but by most of the [[ADAPT2\|ADAPT<sup>2</sup>]] tools. It regulates how user identity is transferred from application to application via the following HTTP parameters
		+	* '''usr''' - user identifier, usually login (mandatory)
		+	* '''grp''' - group identifier (mandatory), just like a user identifier, but for a group of users (class, research team)
		+	* '''sid''' - session identifier, usually 5 character string each application makes a choice whether and how to come up with this parameter (e.g. truncate [http://en.wikipedia.org/wiki/Apache_Tomcat\|Apache Tomcat] session id to last 5 characters)

	= Protocol for reporting user activity =		= Protocol for reporting user activity =

@@ Line 165: / Line 165: @@
 Example request URL:
 <pre>http://adapt2.sis.pitt.edu/cbum/umc?app=19&usr=joe&grp=class12&dom=sql_concepts&con=Table,MultipleTableSelection,WhereClause&val=-1,0.5,-1&sid=1&svc=5</pre>
 = Protocol for requesting user progress =

@@ Line 151: / Line 151: @@
 Request URL Format:
 <pre>
-http://<report_servlet>?app=<application_id> &act=<learning_object> &sub=<learning_object_step> &usr=<user> &gpr=<group> &sid=<session_id> &res=<result> &svc=<service_parameters>
+http://adapt2.sis.pitt.edu/cbum/umc?app=<application_id> &usr=<user> &grp=<group> &dom=<learning domain> &con=<concept list> &val=<result list> &sid=<session_id> &svc=<service_parameters>
 </pre>
 ,where: