WISE v4.10 Release Notes

Hiroki Terashima edited this page Mar 7, 2015 · 22 revisions

Table of Contents

Release Schedule

Release date: March 6, 2015

Download

You can download WISE 4.10 here: http://wise4.org

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 items from "My Work" (and uploaded images), which students can organize and annotate
  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