E-mailRelease Version 0.5
Features
Goal Management tool
This tool can be configured as global (objects span sites) or site-specific (objects contained to site).
Global Configuration
- Can add/edit/delete/publish global goalsets
- Can add/edit/delete goals within goalsets
- Can view a detailed list of associations to global goals
- Can view a report of ratings for all associations within each global goalset
- For each associated goal, can view a detailed list of associations
- For each association, can view a detailed list of ratings
Site-specific Configuration
- Can add/edit/delete/publish/suggest site-specific goalsets
- Can add/edit/delete goals within goalsets
- Can view a detailed list of associations from global or site-specific goals to site-specific objects
- Can view a report of ratings for all site-specific associations within each global or site-specific goalset
- For each associated goal, can view a detailed list of site-specific associations
- For each site-specific association, can view a detailed list of ratings
- Can associate goals with site-specific assignments. These associations can be set as visible, which indicates whether or not a user with 'view visible' permission can view them. Otherwise, the user will require permission to either modify or view all associations.
"Goal Aware" Assignment tool
- Assignments tool can be configured as goalAware
- Can associate assignments with goals
- Can rate assignment submissions and provide an optional rating comment
Installation Instructions
We don't, as of yet, have a neatly packaged quickstart bundle. These instructions assume you have already setup a Sakai development environment. The Goal Management Tool version 0.5 requires version 2.1.2 of Sakai.
- cd dest_dir
- svn co https://source.sakaiproject.org/svn/tags/sakai_2-1-2 sakai-2.1.2
- svn co https://source.sakaiproject.org/contrib/syracuse/gmt/tags/0.5 gmt-0.5
- Edit gmt-0.5/project.properties and change sakai.src.dir to value of dest_dir
- cd dest_dir/sakai-2.1.2/legacy
- patch p0 < dest_dir/gmt-0.5/sakai.legacy.patch
- cd dest_dir/sakai-2.1.2/legacy-service
- patch p0 < dest_dir/gmt-0.5/sakai.legacy-service.patch
- cd dest_dir/sakai-2.1.2/login
- patch p0 < dest_dir/gmt-0.5/sakai.login.patch
- cd dest_dir/sakai-2.1.2
- maven bld dpl
- cd dest_dir/gmt-0.5
- maven bld dpl
Please Note
This tool has only been tested using Mysql, and requires connector version 3.1.12 (or higher?). If you are upgrading from version 0.4, you must run the migrate_0.4_to_0.5.sql script. Again this script was written for and tested on Mysql.
Post-installation Configuration
A typical setup would have a globally configured goal management tool (global="true") added to the 'My Workspace' site of an account created for a program coordinator. Additional goal management tools are added to course worksites configured with global="false". Users with the 'maintain' (or similar) role should be able to modify goalsets, associations and ratings. Users with the 'access' (or similar) role should be able to view goalsets and associations. Viewing of associations can be limited by setting the association(s) 'visible' property to false, and only allowing users to 'view_visible_association'. In some instances, you may want to create a role that is allowed to view ratings but not be able to modify them. This is possible by assigning the role the 'view_rating' permission instead of the 'modify_rating' permission.
In order to really make use of the goal management tool, worksites should also have the "goal aware" assignments tool. This is accomplished by adding the sakai.assignment.grades tool and configuring it with goalAware="true". It is only through the "goal aware" assignments tool that ratings can be modified.
Testing
The test scripts should be used to test tool functionality, and can be used to become more familiar with these tools.
Release Notes
Task
- GM-8 - Rating interface cleanup
- GM-10 - Add confirmation page for publishing
- GM-11 - Fix pages using panelGrid tag to use it properly
- GM-12 - Remove GMT permissions from assignment tool
- GM-14 - Separate Association and Rating helpers
- GM-15 - Add paging and user's first and last name to Rating Report
- GM-16 - Replace existing form validation with validation tags (where possible)
- GM-19 - Show Associations should not show associations outside of context when tool is not global
- GM-21 - Add confirmation screen to ratings helper
- GM-22 - Worksite column in global reports
