For version 1.5 I’ve moved the text, in addition to all strings associated with features into it’s own resource file which gets deployed when you install 1.5. This now allows localised versions to be added for other language support, but also you can change it on a farm by farm basis if you don’t like the out of the box phrase.

How to change the text

Once you have installed version 1.5, you will need to navigate to the Resources folder where the SLK resource file is located. On a default install of SharePoint 2010 this is

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\Resources

For SharePoint 2007, just replace the 14 with 12 (it’s the product number). For non-English OS installations the path will vary as some of it is localised, but it’s the standard SharePoint location for files.

Within that folder, in addition to a large number of standard SharePoint resource files, you will find SLK.resx.

While you are in the Resources folder do not modify any of the other resource files. If you change any of the strings in there you’ll only confuse your users, and they may get overwritten on the next SharePoint upgrade.

Once you have found SLK.resx, open it in your favourite text editor, find the E-Learning Actions resource and change the value to whatever you want it to be.

Make sure that you only change the value element’s text. The name of the data item is how it’s referenced, so if you change that SharePoint won’t be able to find the value, and the menu item will be blank.

Here I’ve changed the test to Assign Work.

Once you have made your changes you will need to recycle the SharePoint application pool or restart IIS. Once that’s completed you can navigate back to your document library to verify that the text has changed

SLK.resx also contains the strings for all the features i.e. the text displayed when activating or deactivating features.

One thing to note is that any changes you make could get overwritten in any upgrade of SLK, so please keep a copy of your changes.

Localisation

To localise the text for another language, you make a copy of the resource file and save it in the same folder, but include the language code in the file name. You can see this from the standard files in the folder of which the following screenshot is a small selection.

Eventually I hope to included localised versions of this in the language packs.

Site Collection Level

SharePoint Learning Kit Web Parts

When activated this feature automatically adds the Assignment List Web Part to the web part gallery for a site collection.

Site Level

SharePoint Learning Kit

This is the same feature as present in previous versions of SLK. When this is activated in a site the "E-Learning Actions" menu item is added to document libraries.

SharePoint Learning Kit – Assign Self

This feature add the "Assign To Self" menu item to document libraries. This allows the user to immediately assign an item to themselves and run it.

SharePoint Learning Kit – Assign Site

This feature add the "Assign To Site" menu item to document libraries. This allows the user to start assigning an item to the current site without having to choose the site to assign to. In effect it jumps straight to the Assignment Properties page for the current site.

Web Application Level

SharePoint Learning Kit Admin

This feature adds the Configure SharePoint Learning Kit functionality to Central Administration. This is just here for completeness as it’s actually a hidden feature which is activated automatically so you should never see it or need to activate it.

As you can see I still need a image for it.

Support for SharePoint 2010

This has to be the highlight of the release. SLK now natively supports SharePoint 2007 and SharePoint 2010. The functionality is exactly the same, but there are separate installers for the two versions. I’ve updated it so that the core components are the same, it’s only the installation scripts and a few references in aspx pages are different.

E-Learning Actions can be localised

Since the beginning of the project the phrase "E-Learning Actions", which appears in the document library drop down menu, has not been able to be changed or localisable. I have now moved this out to a resource file and this can now be localised for other languages, or even just changed on a farm by farm basis. So if you wanted your instance to say "Assign Work", you can just edit the text based resource file to change it.

Two New Document Library Edit Options

There’s 2 new options for document library edit menu. These are shortcuts for assigning work to yourself or to the site the resource is stored in. They are called "Assign to Self" and "Assign to Site". Just like "E-Learning Actions" these can also be localized. It is completely up to you which of these 3 actions you have in any site.

Automatically add the Assignment List Web Part to the Web Part Gallery

SLK now includes a feature to automatically add the ALWP to the web part gallery. This has been a big miss in my opinion in the releases so far and just made it annoying to install.

Various Bug Fixes for the Drop Box

This release rolls up all the fixes for all the bugs I’m aware of in the Drop Box.

You can download from the release page on CodePlex.

It is not backwards compatible with the version uploaded to the patches folder, so any documents returned by that will not be available via this version. The documents will still be present though.

The major changes compared to the version in the patches folder are:

1. Students can open office documents and save them straight back to SharePoint without having to save to disk first.
2. Teachers can open and comment on office documents without having to save to disk first.
3. The drop box library is created as required. You do not have to enable the SLK feature on the site to create it.
4. Although folders are still used as containers to hold student’s work (as the document names are likely to be the same), they are not used to navigate the assignments. You either use the default view which is grouped by assignment or use assignment specific views which are created when an assignment is created.
5. You can use the drop box in a locale which doesn’t use US style dates.
6. I’ve currently removed the download all and upload all files options for teachers so that I can get the release out. I just haven’t had time to complete this.
7. I’ve removed Course Manager from the install. This will again be available as a separate release. The reason is that the quality is still not there for it to be bundled.

I will consider this version to be in beta until 24 Jan at the latest. At which point there will be another beta version with at a minimum the download all and upload all functionality in, or a final release. Please download and report any bugs, which I will attempt to resolve quickly. I am keen to get 1.4 RTM so we can move on to the next version and get the project moving again.

Note, I still need to update the documentation to cover this release, this may take some time. If anyone would like to volunteer to do this it would be really helpful. I’m also considering moving it to the wiki pages on CodePlex rather than just having the getting started pdf as it will be easier to maintain and distribute. Does anyone have any thoughts on this?

When this happened to a customer, I was able to debug it and found out the problem. I can now re-produce it at will and it’s definitely a bug in SharePoint.

The problem occurs when the user is a member of a large number of SharePoint groups. To retrieve all the roles, SharePoint makes a call to the database. In normal circumstances this call is along the lines of

SELECT DISTINCT ra.RoleId FROM RoleAssignment AS ra
WHERE ra.ScopeId = '67FD4879-2097-4B98-9771-5A6E9D11F0E9' AND ra.PrincipalId IN (3,1 )

where 3 and 1 are the IDs of the groups and the guid (67FD4879-2097-4B98-9771-5A6E9D11F0E9) is the ID of the site. This call is retrieving all the role assignments on this site for all the groups that the user is a member of.

Now when the user is a member of a large number of groups the SQL generated is:

SELECT DISTINCT ra.RoleId FROM RoleAssignment AS ra
WHERE ra.ScopeId = '67FD4879-2097-4B98-9771-5A6E9D11F0E9' AND ra.PrincipalId
IN (SELECT DISTINCT ra.RoleId FROM RoleAssignment AS ra WHERE ra.ScopeId = '67FD4879-2097-4B98-9771-5A6E9D11F0E9' AND ra.PrincipalId IN (839,1840,1841,.......,2611,2612,1 ) 

The …….. is where I’ve removed about 740 group IDs.

I’m not sure what’s happening here in the SQL generation, but the "SELECT .. FROM .. WHERE .. IN(" bit is repeated twice leading to invalid SQL. Apart from being a nonsense statement there are 2 opening braces and only 1 closing brace. The code is obviously getting confused by so many groups. My initial thought was that it allocated a buffer for the string generation, but it wasn’t big enough, but that doesn’t explain the 2 sets of SELECT … .

This is easy to reproduce. All you need to do is create a large number of groups with the current user in, and then call AllRolesForCurrentUser, not forgetting to delete them all afterwards or you’ll quickly clutter up your server. I found 800 is enough to make it fail for me, different environment may need more. A sample test class is shown at then end.

In normal use, no user is going to be a member of this many groups – for a start membership of this many is going to need to be automated. However, the best use of SLK requires a site per class and in a reasonably sized Secondary school, this can easily be over 1000 members. Then it’s generally only the administrator who is affected if his account has been used to create the sites, and only if you have a group per site for membership purposes.

I don’t normally create groups for class sites anyway. The maintenance screens for groups are just not very user friendly – you have to manually page through the lists to find a group – and it makes the year roll-over a pain. My preference is to give the users explicit permissions on the class sites rather than through groups, something I’ve discussed before.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using Microsoft.SharePoint; 

namespace SharePointTest
{
  public class AllRolesTest
  {
    public static void Main()
    {
      //Url to a SharePoint site. Any site but don't do it on a live server. 
      string url = "http://salamanderdemo/sites/mis";
      //The username of the user you are running as. I could have programmatically found this out, but it
      //wouldn't have added anything to the example 
      string userName = "DEMO\\Administrator"; 

      try
      {
        using (SPSite site = new SPSite(url))
        {
          using (SPWeb web = site.OpenWeb())
          {
            SPUser user = web.SiteUsers[userName]; 

            // This call should succeed 
            SPRoleDefinitionBindingCollection allRoles = web.AllRolesForCurrentUser;
            Console.WriteLine("First AllRolesForCurrentUser worked."); 

            List<string> names = new List<string>();
            try
            {
              //Create all the groups 
              for (int i = 0; i < 800; i++)
              {
                if (i%100 == 0)
                {
                  Console.WriteLine("Added {0} groups.", i);
                }
                string name = Guid.NewGuid().ToString();
                names.Add(name);
                web.SiteGroups.Add(name, user, user, name);
              } 

              try
              {
                // This call should fail 
                allRoles = web.AllRolesForCurrentUser;
                Console.WriteLine("AllRolesForCurrentUser succeeded, try adding more groups.");
              }
              catch (SPException e)
              {
                Console.WriteLine("AllRolesForCurrentUser failed.");
                Console.WriteLine(e.Message);
              }
            }
            finally
            {
              int i=0;
              foreach (string name in names)
              {
                if (i%100 == 0)
                {
                  Console.WriteLine("Deleted {0} groups.", i);
                }
                i++;
                web.SiteGroups.Remove(name);
              }
            }
          }
        }
      }
      catch (Exception e)
      {
        Console.WriteLine(e);
      }
    }
  }
}

Fortunately there is a built in way in SLK to handle this. The items shown in the web part are completely configurable and are described in the SlkSettings.xml file associated with a site collection.

As an example let’s view the web part for a test instructor.

As you can see he has 8 active assignments. Now we decide that we want to only display assignments which have a start date greater than 01 June 2009.

So first of all we download the SlkSettings.xml through the "Configure SharePoint Learning Kit" page in central administration, change it and then upload it again (click for a larger view).

The change you need to make is to add the following line to the ActiveInstructor query.

<Condition ViewColumnName="AssignmentStartDate" Operator="GreaterThan" Value="2009-06-01" />

The image shows where it should go (click for a larger view).

What this does is add a new condition to the query so that it only brings back assignments whose start date is greater than the Value. You need to use the start date rather than the due date because I haven’t found a way to bring back assignments with due dates greater than the value, and ones without a due date. If I add a condition for due date in, none of the assignments without a due date are returned. As the start date is a mandatory field this is not a problem.

Once you’ve made the change and uploaded the new settings file back up, this is what the web part looks like.

As you can see the four assignments whose start date were less than 02 June 2009 are not returned. They are still present in the other queries though as so far we have only altered the active query for instructors. To complete the job you will need to add the condition to all the queries for instructors, learners and observers.

Finally, if you would like to display assignments outside of those dates somewhere in your portal, you can have different instances of the web part display different queries by defining custom query sets in the settings file. I’ll leave that until another time if there’s a demand for it though.

The situation this school was in, is that they are running the Sims Learning Gateway (SLG). Part of how that works is that there is a component to create AD users and class groups based on the data in Sims. However, the users created by SLG are then ‘consolidated’ with the ‘real’ AD users, so these can then use the Sims web parts. As part of the consolidation process, the SLG users are disabled and the real users are added to the class groups, however the disabled SLG users are not removed from the AD groups.

Now the school were using these AD groups to assign SLK Learner permisssion to in order to assign work. So when the teachers came to assign work and selected their class group, each pupil was represented twice in the list which was a bit confusing.

The solution was to update the SLK code so that there is now a setting to hide disabled users. This will mean that when SLK goes to get the list of all Learners on a site it will ignore users in Active Directory groups who are disabled.

To get this set up you will first of all need to download and upgrade to the version with the setting in on the 1.3.2 build page . Then set the setting by:

1. Go to the Configure SharePoint Learning Kit page in SharePoint Central Administration.
2. Make sure that the correct site collection is selected and then click ‘Click here to download the current SLK Settings file’ near the bottom of the page.
3. This will open up the SlkSettings.xml file in a new browser window. Save this to disk.
4. Open the saved file in a text editor e.g. notepad (do not use Word or similar)
5. Add the attribute HideDisabledUsers=”true” to the file as indicated in the screen-shot

6.  Then upload the modified SlkSettings.xml file by adding it the page to “New SlkSettings  file:” and clicking OK.

This will work for schools using Sims Learning Gateway with the same issues, but I wouldn’t necessarily recommend it for anyone else. My personal preference is to give the individual users the appropriate permissions on the class sites rather than using groups. Groups will always cause issues when it comes to rollover and I just think it’s cleaner and more intuitive to have the direct permissions. I would also have removed the disabled users from the groups. Of course I’ve got the toolset to do all of this easily.

                spDateTimeStart.LocaleId = SPWeb.Locale.LCID;
                spDateTimeDue.LocaleId = SPWeb.Locale.LCID;

A version with this fix in is now available on the 1.3.2 build page.

Once the package is read from the cache then SLK will read the manifest to determine the navigation of the content and generate the table of contents for the frameset. Once this is generated the frameset is shown to the user who can then use the table of contents to navigate around the content depending on the sequencing rules of the package.

How the content is then sent to the user depends on how the content has been written. Typically each navigation node will be a separate item in the zip file, which will be downloaded when the user navigates to it. This will lead to a slight delay every time the user navigates between activities, the length of which will depend on the size of that activity and the network connection between the browser and SharePoint – just like any other web content being downloaded. I can also imagine that there are some packages which initially download all the content of all the activities. This will lead to longer start up times again depending on the size of the content, but quicker navigation within the package.

Cache Settings

The default cache settings are to use a cache on the individual SharePoint server and to keep it for 3 days. After this it will be removed. In a server farm this means that each web front-end server will maintain it’s own cache, leading to several initial requests as the load balancing passes requests to different servers. The cache location can be set in the SlkSettings file allowing the farm servers to share a cache. This should allow more hits on the cache and hence less unpacking.

Cache settings are set in the SlkSettings file and hence are on a per site collection basis, allowing you to have different settings for different site collections. The 2 settings are PackageCacheExpirationMinutes and PackageCacheLocation.

Firstly this is about the Course Manger source code and not its functionality. Andrew Woodward has done a great review of that on his blog.

First thing to realize is that Course Manager is basically 3 web parts:

1. Course Manager Pages : 2 links to pages with the other web parts on
2. Plan & Assign : Where you create the courses and assign them to students
3. Monitor & Assess : Where you grade the assignments

To implement these Course Manager consists of 5 dlls. Yes that’s right, 5 dlls for 3 web parts, 1 of which is just 2 html links with no business logic in it. Looking closer the 5 dlls are

1. Axelerate.DataAccessApplicationBlock.dll
2. Axelerate.BusinessLayerFrameWork.dll
3. Axelerate.BusinessLayerUITools.dll
4. Axelerate.SharedBusinessLogic.dll
5. Axelerate.SlkCourseManagerLogicalLayer.dll

Looking at the code only the last one, SlkCourseManagerLogicalLayer actually contains any SLK/Course Manager functionality, the rest are all plumbing. In fact the first 2 projects are written in VB.net while the rest are in C#. It’s fairly obvious that the first 4 components are are supposed to be a generic framework, which has been used to build the course manager and contains a lot of code which isn’t used by Course Manager – more on this later. Digging deeper on the framework and googling Axelerate leads to aXelerate Solutions, who Microsoft must have commissioned to create the Course Manager. My guess is, and it is a guess as the Course Manager code is way before my time as project co-ordinator, is that aXelerate created Course Manager the way they create all their applications, using their custom framework. Whether or not they realized that they were going to have to release the framework code as open source is another matter. I suspect not as that sort of thing tends to be considered a commercial advantage and secret. Fact is Course Manager is unusable without it, and couldn’t be considered open source without it. Trawling around I have found out that the framework has itself been released as open source at http://www.codeplex.com/AxelerateLibraries with a press release (dated 15 Oct 2007 but released 30 Oct 2008) and an overview.

Now the point of a good framework is that it should enable you to add more functionality easily and maintain it. I’m actually finding that it’s getting in the way and causing more work. For example I’ve spent several hours figuring out why Course Manager just wasn’t working and giving the informative error “No data found”. I eventually tracked it down to mismatched versions of AzMan. The first problem with that is that the error handling was atrocious, it threw away the original error and just displayed a generic error, which it displays if any of the data access had failed. There was no way of finding out what the problem was without modifying the code to not catch the error, this is not maintainable is anything but a development environment. Secondly, as far as I can make out AzMan is not even used in the Course Manager web parts. AzMan is a role-based access control framework from Microsoft which uses an MMC snap-in to manage security. Course Manager just relies on the SharePoint security model, so the AzMan access checking, which is embedded all through the code is superfluous. However, the fact that Course Manager breaks without the correct version is really annoyying. The worst part is that the installation routine checks for the correct version of SLK and .Net, before letting you install, and those checks were broken so no one could install. Please, either check for all requirements, or none, not just a couple that you feel like checking for, It’s either a fully robust installation, or a requirement for the installer to manually check for everything first.

I’m not convinced that anyone apart from the authors of the framework is going to be able to add easily any functionality to Course Manager using the framework, or maintain what is there. Why couldn’t they have used a mature, robust, full featured framework like NHibernate is beyond me. Granted NHibernate doesn’t handle the UI stuff, but thousands of successful projects use it rather than just one.

Finally the two biggest problems of the framework are:

1. Many, many warning on building the projects. There should be 0.
2. There are many places where all exceptions are caught and ignored. This is fundamentally wrong.