Introduction
We needed to display a list of Blackboard Course objects on a view page and wanted the list to be sorted by a specific field (courseId). We used the inventoryList Blackboard tag to display the list. Consulting the Blackboard Learn Building Blocks Tag Library Guide for Release 9.0 and 9.1, I found that the inventoryList tag has an attribute, initialSortCol with this description:
The column to initially sort by when the list is displayed. The value should match the name of a list element.
So we set the value of initialSortCol to be the name value for the listElement tag that displays the course ID for each Course object in the collection. But the list of Course objects still was not sorted correctly.
Thanks to some bright colleagues where I work, we were able to get the list sorted correctly. Hopefully this article will save other developers hours of frustrating work caused by incomplete and missing Blackboard documentation.
[More]