Skip to end of metadata
Go to start of metadata

Intro

This is a manual integration example that would hopefully help you to create an integration with LAMS quickly.

First, I created an integration server in LAMS (login as sysadmin and then go to the syadmin menu) with these settings:

Obviously, change the URLS according to yours.

Open author

Creates a user, the course, adds the user as author into it and then redirects the user directly to the Author UI

Prepare hash: [ts + uid + method + serverID + serverKey]
sha1(1roger01authorlmslms) = 2694cbe4a627b9798824453e65d0f13f8dc1f5e3

URL: http://lams-server/lams/LoginRequest?uid=roger01&ts=1&sid=lms&method=author&courseid=123&firstName=Roger&lastName=Moore&email=roger@gmail.com&country=AU&lang=en&hash=2694cbe4a627b9798824453e65d0f13f8dc1f5e3

Result:
open LAMS author, create a sequence called "Some sequence" and saved

Get learning designs for roger01

Prepare hash: [timestamp + username + serverID + serverKey]

sha1(1roger01lmslms) = a8c722c31ac21e719145d15febf6df246ea16d16

URL:

http://lams-server/lams/services/xml/LearningDesignRepository?username=roger01&datetime=1&serverId=lms&courseId=123&courseName=lola&mode=2&firstName=Roger&lastName=Moore&email=roger@gmail.com&country=AU&lang=en&hashValue=a8c722c31ac21e719145d15febf6df246ea16d16

Result:

Shows me all the lessons available for Roger to create lessons. You can see "Some sequence" within Roger Moore's personal folder.

Start a lesson

Prepare hash: [timestamp + username + serverID + serverKey]

sha1(1roger01lmslms) = a8c722c31ac21e719145d15febf6df246ea16d16

URL:

http://lams-server/lams/services/xml/LessonManager?username=roger01&serverId=lms&datetime=1&courseId=123&ldId=2173&method=start&title=Lesson01&desc=somedesc&hashValue=a8c722c31ac21e719145d15febf6df246ea16d16

Returns:

The lessonId ready to be used

Jump into monitor to this lesson

Jump into this lesson as learner (using learnerStrictAuth method)

Roger goes into the lesson as learner. Note that learnerStrictAuth is only available for LAMS 2.5+

Prepare hash: [ts + uid + method + lsId +serverID + serverKey]

sha1(1roger01learnerstrictauth1537lmslms) = 109cf9886c6fcb926a29a6d10d217de7c524016d

URL:

http://lams-server/lams/LoginRequest?uid=roger01&ts=1&sid=lms&method=learnerStrictAuth&courseid=123&firstName=Roger&lastName=Moore&email=roger@gmail.com&country=AU&lang=en&hash=109cf9886c6fcb926a29a6d10d217de7c524016d&lsid=1537

Result:

Open Learner UI

Jump into this lesson as a new learner (using learner method)

This will create the user, added to the course and also the lesson as leaner. Note that this method works with 2.4 and 2.5+

Prepare hash: [ts + uid + method +serverID + serverKey]

sha1(1daniel007learnerlmslms) = c86882105c7db67e438be44919e6113fa17b4596

URL:

http://lams-server/lams/LoginRequest?uid=daniel007&ts=1&sid=lms&method=learnerStrictAuth&courseid=123&firstName=Daniel&lastName=Craig&email=daniel@gmail.com&country=AU&lang=en&hash=c86882105c7db67e438be44919e6113fa17b4596&lsid=1537

Result:

Open Learner UI, creates the user, adds it to the course and lesson just as leaner.

Jump in this lesson as a new Monitor (just for kicks (smile)

Prepare hash:

sha1(1sean007monitor1537lmslms) = bbbf4b5f8b63291ee10c32d7e9181024d2326fa7

URL:

http://lams-server/lams/LoginRequest?uid=sean007&ts=1&sid=lms&method=monitor&courseid=123&firstName=Sean&lastName=Connery&email=sean@gmail.com&country=AU&lang=en&hash=bbbf4b5f8b63291ee10c32d7e9181024d2326fa7&lsid=1537

Result:

Opens Monitor UI. You can see on the sequence tab that there's two students (Roger and Daniel)

I think by now you pretty much get the idea how the integration works and how to get all the other API calls to work.

Quick tips

If you've got any further questions, please post them in the Tech Forums in the LAMS Community.