WISE v4.10 Release Notes

Table of Contents Release Schedule Notes Issues Major additions/changes Minor additions/changes Updating instructions (for people upgrading from v4.9)

Release Schedule

Release dates:
ETA: first half of 2015

Notes

This release requires Tomcat 8.0.x and and java 7+ to work with WebSockets. WISE@Berkeley is using Tomcat 8.0.9 with java 1.7.0_65 (as of Aug. 2014)

Issues

1. See here: https://github.com/WISE-Community/WISE/issues?q=milestone%3A%22v4.10+Major+Release%22

Major additions/changes

1. New Portfolio Tool for collection of student-selected work from the "My Work", which students can organize, annotate, and share with class
2. MatchSequence step redesign
3. Global CSS: Project style override. Authors can add CSS for all elements of WISE VLE via Authoring Tool->Advanced->Edit Look and Feel
4. CRater: implemented multiple-score sequence feedback. Students get different feedback based on how they did in the current round and in the previous round
5. Run Survey: teachers can give feedback when they archive a run
6. Standardized how we store autograded annotations using the "autograded" type
7. Auto scores and auto feedback are now automatically populated into the grading tools
8. Admin user and researchers can batch create user accounts for existing runs
9. Upgraded SpringFramework dependency 4.0.5 => 4.1.4
10. Upgraded Spring Security dependency3.1.1 => 3.2.4
11. Upgraded Hibernate dependency 4.3.5 => 4.3.7

Minor additions/changes

1. WebappNode: added the ability for webapps to specify when a student has completed the step
2. CRater feedback items can greet users with new syntax, {{studentFirstNames}}
3. CRater steps can now be authored to check work when the student exits the step
4. Classroom Manager: the student progress view now displays students
5. Authoring Tool: implemented icon authoring
6. Authors can create links to other steps with new syntax, {{link|step_number|text_to_display_on_the_link}}. For example, Good job! Now {{link|1.2|go see the finger bowl activity}} next!
7. Newly created projects start with a default activity
8. External script: added the ability for external scripts to specify when the student has completed the step
9. Grapher step now saves intermediary states so we can see a history of student work
10. Archive project/run when associated run/project is archived, un-archive project/run when associated run/project is un-archived
11. Admin Tool: improved search functionality for projects
12. Shared run owners can now edit max scores for project
13. Added "hidden" type to news item, which won't show up in public news page nor teacher news section
14. More translations into Hebrew, Traditional Chinese, and Korean
15. Refactoring and code cleanup
16. bug fixes

Updating instructions (for people upgrading from v4.9)

1. Update db schema (for people using mysql)

# create new portfolio table
CREATE TABLE `portfolio` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `workgroupId` bigint(20) DEFAULT NULL,
  `runId` bigint(20) DEFAULT NULL,
  `metadata` mediumtext,
  `items` mediumtext,
  `deletedItems` mediumtext,
  `isPublic` bit(1) DEFAULT NULL,
  `isSubmitted` bit(1) DEFAULT NULL,
  `tags` varchar(255) DEFAULT NULL,
  `postTime` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);

# add a new column, 'run_survey_template',  to portal table, for storing default survey template JSON string
ALTER TABLE `wise_database`.`portal` ADD COLUMN `run_survey_template` TEXT NULL AFTER `settings`;

# insert a default run survey template JSON. You can change this via admin portal's settings page too
UPDATE `portal` set run_survey_template='{\"save_time\":null,\"items\":[{\"id\":\"recommendProjectToOtherTeachers\",\"type\":\"radio\",\"prompt\":\"How likely would you recommend this project to other teachers?\",\"choices\":[{\"id\":\"5\",\"text\":\"Extremely likely\"},{\"id\":\"4\",\"text\":\"Very likely\"},{\"id\":\"3\",\"text\":\"Moderately likely\"},{\"id\":\"2\",\"text\":\"Slightly likely\"},{\"id\":\"1\",\"text\":\"Not at all likely\"}],\"answer\":null},{\"id\":\"runProjectAgain\",\"type\":\"radio\",\"prompt\":\"How likely would you run this project again?\",\"choices\":[{\"id\":\"5\",\"text\":\"Extremely likely\"},{\"id\":\"4\",\"text\":\"Very likely\"},{\"id\":\"3\",\"text\":\"Moderately likely\"},{\"id\":\"2\",\"text\":\"Slightly likely\"},{\"id\":\"1\",\"text\":\"Not at all likely\"}],\"answer\":null},{\"id\":\"useWISEAgain\",\"type\":\"radio\",\"prompt\":\"How likely would you use WISE again in your classroom?\",\"choices\":[{\"id\":\"5\",\"text\":\"Extremely likely\"},{\"id\":\"4\",\"text\":\"Very likely\"},{\"id\":\"3\",\"text\":\"Moderately likely\"},{\"id\":\"2\",\"text\":\"Slightly likely\"},{\"id\":\"1\",\"text\":\"Not at all likely\"}],\"answer\":null},{\"id\":\"adviceForOtherTeachers\",\"type\":\"textarea\",\"prompt\":\"Please share any advice for other teachers about this project or about WISE in general.\",\"answer\":null},{\"id\":\"technicalProblems\",\"type\":\"textarea\",\"prompt\":\"Please write about any technical problems that you had while running this project.\",\"answer\":null},{\"id\":\"generalFeedback\",\"type\":\"textarea\",\"prompt\":\"Please provide any other feedback to WISE staff.\",\"answer\":null}]}' where id=1;

# change 'public_notes' column to 'survey' for 'runs' table
ALTER TABLE `wise_database`.`runs` CHANGE COLUMN `public_notes` `survey` TEXT NULL DEFAULT NULL ;

# insert default run survey template JSON for existing runs.
UPDATE `runs` set survey='{\"save_time\":null,\"items\":[{\"id\":\"recommendProjectToOtherTeachers\",\"type\":\"radio\",\"prompt\":\"How likely would you recommend this project to other teachers?\",\"choices\":[{\"id\":\"5\",\"text\":\"Extremely likely\"},{\"id\":\"4\",\"text\":\"Very likely\"},{\"id\":\"3\",\"text\":\"Moderately likely\"},{\"id\":\"2\",\"text\":\"Slightly likely\"},{\"id\":\"1\",\"text\":\"Not at all likely\"}],\"answer\":null},{\"id\":\"runProjectAgain\",\"type\":\"radio\",\"prompt\":\"How likely would you run this project again?\",\"choices\":[{\"id\":\"5\",\"text\":\"Extremely likely\"},{\"id\":\"4\",\"text\":\"Very likely\"},{\"id\":\"3\",\"text\":\"Moderately likely\"},{\"id\":\"2\",\"text\":\"Slightly likely\"},{\"id\":\"1\",\"text\":\"Not at all likely\"}],\"answer\":null},{\"id\":\"useWISEAgain\",\"type\":\"radio\",\"prompt\":\"How likely would you use WISE again in your classroom?\",\"choices\":[{\"id\":\"5\",\"text\":\"Extremely likely\"},{\"id\":\"4\",\"text\":\"Very likely\"},{\"id\":\"3\",\"text\":\"Moderately likely\"},{\"id\":\"2\",\"text\":\"Slightly likely\"},{\"id\":\"1\",\"text\":\"Not at all likely\"}],\"answer\":null},{\"id\":\"adviceForOtherTeachers\",\"type\":\"textarea\",\"prompt\":\"Please share any advice for other teachers about this project or about WISE in general.\",\"answer\":null},{\"id\":\"technicalProblems\",\"type\":\"textarea\",\"prompt\":\"Please write about any technical problems that you had while running this project.\",\"answer\":null},{\"id\":\"generalFeedback\",\"type\":\"textarea\",\"prompt\":\"Please provide any other feedback to WISE staff.\",\"answer\":null}]}';

2. Add new key/value pairs to wise.properties (see wise_sample.properties for example)

# don't auto-create database tables
hibernate.hbm2ddl.auto=none

# set this to true iff you want privileged users (admins,researchers) to batch create user accounts
isBatchCreateUserAccountsEnabled=true