Difference between revisions of "Sakai 11 Tips"

From DurhamtechWiki
Jump to navigationJump to search
Line 36: Line 36:
 
** For example, in Lessons, if an instructor used the Text Editor-Record Audio Clip tool to create an audio file, both instructors and students can play the audio file.  
 
** For example, in Lessons, if an instructor used the Text Editor-Record Audio Clip tool to create an audio file, both instructors and students can play the audio file.  
 
** BUT after using Site Info-Import from Site in a new course site, in Lessons, the students won't be able to play the audio files in the new course site.     
 
** BUT after using Site Info-Import from Site in a new course site, in Lessons, the students won't be able to play the audio files in the new course site.     
* '''To see the issue:''' Create audio files in Lessons or other tool using the Text Editor-Record Audio Clip tool. Use Site Info-Import from Site in a new course site. Copy Lessons or appropriate tool containing audio files, and other tools as needed. Instructors can play the audio files in Lessons and in other tools in the new course site, but students in the course can not. Instructors can download the audio files, but can only upload to Resources, small audio files (<25MB), to their new course site.   
+
* '''To see the issue:''' Create audio files in Lessons or other Sakai tools using the Text Editor-Record Audio Clip tool. Use Site Info-Import from Site in a new course site. Copy Lessons or appropriate tool containing audio files, and other tools as needed. Instructors can play the audio files in Lessons and in other tools in the new course site, but students in the course can not. Instructors can download the audio files, but can only upload to Resources, small audio files (<25MB), to their new course site.   
 
* '''Solution:'''  Please contact  [mailto:sakaihelp@durhamtech.edu sakaihelp@durhamtech.edu].  
 
* '''Solution:'''  Please contact  [mailto:sakaihelp@durhamtech.edu sakaihelp@durhamtech.edu].  
 
** We'll download the audio files, convert them to a smaller size (file type MP3) using [https://sourceforge.net/projects/audacity/ Audacity], and will upload your optimized audio files to your new course site's Resources area.  
 
** We'll download the audio files, convert them to a smaller size (file type MP3) using [https://sourceforge.net/projects/audacity/ Audacity], and will upload your optimized audio files to your new course site's Resources area.  

Revision as of 07:34, 20 July 2018

Known Issues/Solutions

Calendar: Assignments/Tests & Quizzes generated calendar entries don't display in Day and Week Views

  • Issue: When generating calendar entries for Assignments and Tests & Quizzes, the calendar entries display on the Overview page, in the monthly calendar; and displays in the Calendar tool, in monthly, yearly and list of events views. The calendar entries do NOT display in the Calendar tool, in the Day and Weekly views.
  • To see the issue in Assignments: In Assignments, click on the Add tab, add a due date in the future, add required fields, check beside "Add due date to calendar". Click "Post". Click on Calendar tool. Beside View, click on "Calendar by Week". Click on "Next Week" button as needed. The Assignment calendar entry does NOT display to instructor AND students. Beside View, click on "Calendar by Day". Again, the calendar entry does NOT display for instructor and students. Note: The Assignment calendar entry DOES display in the Calendar Monthly, Yearly, and List of Events views; and displays on the Overview/Home page, in the displayed monthly calendar.
  • To see the issue in Tests & Quizzes: In Tests & Quizzes, add title, add required fields (question/correct answers), click "Settings before Publishing", add a due date in the future (now you'll need to select or not select late submissions allowed), click "Save Settings and Publish"; if not already present by default, check the box beside "display due date on calendar", Click Publish. See above instructions to view entries in the Calendar tool and in Overview/Home page displayed monthly calendar.
  • Solution: Hide the Calendar tool from students; the Overview/Home page displayed monthly calendar displays all calendar entries correctly. To hide the Calendar tool (Do NOT delete the tool): Click on Site Info. Click on Tool Order. Beside the Calendar tool, click on the "wheel" icon. Click on "Make Tool Invisible to Students". Click "Save".

Site Info-Tool Order: Changing Name of Lessons button not reflected in Page Title

  • Issue: When creating multiple Lessons pages, if you change a Lessons button name, the button and navigation bar titles are changed, but the page title is not.
  • To see the issue: After creating more than one Lessons page:
    • Click on Site Info; then click on Tool Order.
      • Beside a Lessons tool, click on the "wheel" icon.
        • Click on "Edit Tool Title". Type in new title. Click on the green "check mark" icon.
      • Click "Save". The Lessons button and navigation bar titles are changed, but the page title is not.
  • Solution: After creating more than one Lessons page:
    • Click on the new Lessons page on the course menu.
    • At top, click on the "wheel" button. Change the Page title.
      • Click "Save". The page title, navigation title, and button title are updated correctly.

Tests & Quizzes: When using Chrome, error page displays when adding audio files in all Question types

  • Issue: In Chrome, in Tests & Quizzes, in all question types: when adding audio files to the Question Text area using the Text Editor, such as adding embed code from Vocaroo, instructors receive an error.
    • The question IS CREATED, and the audio file DOES get added, in spite of the error.
  • To see the issue: Using Chrome: In Tests & Quizzes, create a test; add any question type.
    • Above the Question Text box, click on "Show Rich-Text Editor (and character count)".
    • Click on the Source tool, to paste the embed code for an audio file created using Vocaroo.
    • Add answers/feedback as needed. Click "Save". You'll receive an error web page.
    • Refresh the web browser (you may need to click on another tool on the course menu, then click on Tests & Quizzes). Even though an error occurred, when you edit the test, the question WILL be created, and the audio player WILL be displayed. You CAN play the audio file.
  • Solution: Use Firefox when adding audio files to Question Text in Tests & Quizzes.

Site Info-Import issues with Text Editor created audio files

  • Issue: After Importing a course with audio files created using the Text Editor's "Record Audio Clip" tool; audio files won't play for students (but will play for instructors).
    • For example, in Lessons, if an instructor used the Text Editor-Record Audio Clip tool to create an audio file, both instructors and students can play the audio file.
    • BUT after using Site Info-Import from Site in a new course site, in Lessons, the students won't be able to play the audio files in the new course site.
  • To see the issue: Create audio files in Lessons or other Sakai tools using the Text Editor-Record Audio Clip tool. Use Site Info-Import from Site in a new course site. Copy Lessons or appropriate tool containing audio files, and other tools as needed. Instructors can play the audio files in Lessons and in other tools in the new course site, but students in the course can not. Instructors can download the audio files, but can only upload to Resources, small audio files (<25MB), to their new course site.
  • Solution: Please contact sakaihelp@durhamtech.edu.
    • We'll download the audio files, convert them to a smaller size (file type MP3) using Audacity, and will upload your optimized audio files to your new course site's Resources area.
    • You can then link to the audio files located in Resources.
    • The audio files can be imported with your Resources files in future; both instructors and students will be able to see the audio player and play the audio files in new courses.
  • To Avoid Future Issues: Create audio recordings using Vocaroo.
    • In the Sakai Text Editor, click on the Source button. Paste the embed code provided by Vocaroo. Save the changes.
    • Note: Vocaroo does not keep recordings forever. After creating a recording in Vocaroo, below the link/embed code, it states "Download as"; click on the MP3 link, to download the MP3 audio file on your computer.
      • Upload this file into your course's Resources area, with an easily identifiable name, as a backup to use in the future. If needed: Here's a refresher on how to upload a file to Resources
      • If the file is too large to upload to Resources, make sure the file is in a location you can easily find on your computer in the future.
    • Accessibility Recommendation:
      • Please upload a text transcript to accompany your audio clips. It may be helpful to type a script before you record. This can be a useful strategy to help your audio clip remain focused, and the script can be uploaded to Sakai to serve as the audio clip’s transcript. Not sure how to create a text transcript file? See How to create a text file using Windows Notepad
      • If needed: Here's a refresher on how to upload a file to Resources

Lessons: After the subpage release date, the "Not released until" date/time message displays to instructors

  • Issue: In Lessons, if an instructor sets up a date/time for a subpage to be displayed to students, the subpage DOES display to students at the correct date and time.
    • BUT the "Not released until" date/time message still displays to instructors.
    • As a result, instructors may think the subpage is not visible to students.
  • To see the issue: In Lessons, after a subpage release date/time, on the course menu, click on the "View Site" button, then click on "Student". The subpage displays correctly, without a "Not released until" message.
  • Solution: If you want to remove the "Not released until" date/time message, after the subpage release date/time:
    • On the Lessons main page, to the right of the subpage, click on the "Edit" button
      • Un-check the box beside "Hide page until the following date"
      • Click Update Item

Gradebook: Uncategorized items can cause incorrect category averages to display to students

  • Issue: If an instructor is using the new Gradebook with categories and weights, a student will see incorrect category averages when all of the following conditions are true:
    • The Gradebook contains an uncategorized item that was generated by Tests & Quizzes or by the Assignments tool
    • The uncategorized item is set to "include in course grade calculations" (it will be set this way by default but should not be!)
    • The uncategorized item has a grade in it for the student
  • To see the issue: In the new Gradebook, click on a student's name and notice the category averages. Click the "Student Review Mode" tab at the top -- if the category averages are different in student view, you have this problem, and your students will see incorrect averages. Thankfully, the overall course grade (if set to display to students) is correct, just the category averages are incorrect.
  • Solution: Once you assign the items to categories, the problem goes away. If you prefer to leave the items uncategorized, you can solve the issue this way:
    • For the uncategorized item, select "Edit Item Details" (by clicking the triangle in the item's column heading)
    • Assign the item to a category -- this is temporary, so you can choose any category, even if it's wrong
    • Un-check the box to "include item in course grade calculations"
    • Set the item back to uncategorized
    • Click Save

Gradebook: In a combined site, cannot export just one section

  • Issue: Gradebook offers the ability to export all data to a spreadsheet. If your Sakai site has been "combined" and contains multiple sections, the export includes all students from all sections -- and does not identify which student is in which section.
  • Solution: Gradebook Classic will allow you to export a particular section or group of students. To do this:
    • In Gradebook Classic, click the "All Grades" tab.
    • Beside "View" choose the section you want to export.
    • In the upper right area, click one of the export buttons (e.g. "Export as CVS" or "Export for Excel")

Lessons: Some column breaks don't display correctly to students

  • Issue: The column break feature in Lessons lets you display two "boxes" of information side-by-side on a page or subpage. This does not work properly when both of these conditions are true:
    • (1) the column break is on a subpage, and
    • (2) the column break is at the top of the page (i.e it is the first content on the page).
    • When the above conditions are true, the columns will display correctly (side-by-side) to the instructor, but when viewed as a student, the right-side column box displays underneath the first box.
  • Solution: Avoid using columns as the first item on a subpage. As a work-around, you can put something on the subpage (such as some text), then add the columns below it. Try "view as student" to make sure it displays the way you want it to.

Lessons: YouTube videos are wide

  • Issue: YouTube videos embedded in Lessons using "Add Multimedia" under Sakai 2.9 now appear very wide across the screen.
  • Solution: To the right of the embedded video, click the edit icon. Change the "Width" to something smaller, such as 40%. (Height can remain as is, or be removed and left blank.) Click Update Item to save the change.

HTML notice

  • Issue: A few instructors have reported a notice in a yellow box (as shown below) popping up in their sites. The notice may appear on the course home page, or after copying/pasting content into a text editor box somewhere in Sakai.
    Sample HTML error message
  • Solution: The notice indicates that content that you've entered into Sakai (most likely, content that you copied from somewhere else and pasted in) contains some behind-the-scenes code that is problematic. In some situations, the boxes appear once and then go away forever, and all is fine. However, in some cases, they may pop up every time you visit the page. In the latter case, please contact sakaihelp@durhamtech.edu and let us know which site and where in the site the notices are appearing, and we should be able to clean things up for you.

Tips

Clear web browser cache

When using dynamic web sites like Sakai, web browsers might show you an outdated version of a page (what is called a "cached" version of the page). By default, browsers keep previous versions of a page to improve response time. But this behavior might prevent you from displaying the latest information.

Lessons: Displays "Download file" when linking to a document

In Lessons, after adding a link to a document (such as a Word, PowerPoint or text file), a "download file" link and "message" appear, as shown below: Displays sample "Download file" link and message
Why is this happening? If you click Add Content or on a "plus" sign (+), then click on:

  • Add Content Links, a link will be created to your document or presentation, as desired.
  • But if you click on Embed content on page, you are trying to display or show your document, like you would a video or image. Microsoft Word and PowerPoint files can't be displayed in a web browser; therefore, a download file link and "instructions" are provided.

What are the steps to add a link to a document? Watch this one minute video and/or do the following:

  • In Lessons, at the top, click on Add Content or click on a "plus" sign (+) to the right or below your content
  • Click on Add Content Links NOT Embed content on page
  • Click on the Choose or Browse button to select a document or click on "Or select existing files from Resources"
  • After selecting your file, either click Save or Continue, then Save. Your link to your document will now display correctly.

Importing content

The process for importing content from another course has some new time-saving features:

  • You no longer have to add tools before importing; the import process will automatically add them for you, based on what you choose to import.
  • There is now an option to import content from the "home page" (aka "Site Information Display"). Any images on the home page will import and be visible to students (assuming the images were set up properly and visible to students in the course you are importing from!)

For details, see our updated instructions for importing course content (PDF).

Roster

  • When you access the Roster, only the first 10 students display. If you scroll all the way down, more students will appear as you scroll.
  • Students' email addresses are no longer listed in the Roster. Click Export at the top to download a spreadsheet that contains student email addresses.

Turnitin

  • In the prior version of Sakai, Turnitin would check only one attachment per student per assignment. Therefore, instructors were advised to choose "Single file upload" when setting up Turnitin-enabled Assignments, to prevent a student from uploading more than one document. If desired, you can now allow students to submit multiple attachments on a single assignment, and all attachments will be checked by Turnitin.
  • On the Assignment grading screen in Sakai, instructors will see a Turnitin column which presents information a bit differently than in the prior version. Each document submitted will show an icon. Point to the icon to see additional information.
    • For example, a yellow triangle icon yellow triangle icon can mean a couple of different things:
      1. the attachment has been submitted and is pending review (wait 15-30 minutes for results to be returned) OR
      2. an error occurred and Turnitin could not process the document (contact sakaihelp@durhamtech.edu for assistance).
  • When setting up a Turnitin-enabled Assignment, if you choose an option (e.g. "Inline and Attachments") that allows students to enter comments along with their attachment(s), those comments will be checked by Turnitin -- but only if the comment text exceeds 20 words. (This is a general rule for Turnitin: any documents or text containing fewer than 20 words are not checked, and will return an "error" stating that the content could not be processed. This error is represented by a yellow triangle.)
    Turnitin results inline comments
     

New Gradebook

  • Instructors can choose to use the old Gradebook (now called "Gradebook Classic") or the new, redesigned one (called simply "Gradebook"). Learn more about the two gradebooks in Sakai 11
  • The new Gradebook requires horizontal scrolling to see all items. Inconveniently, the horizontal scrollbar is at the bottom, which means you have to scroll all the way down before you can scroll left to right! An easier method may be to use the right and left arrow keys on your keyboard to navigate around in the new Gradebook.

Favorite, Hide and Organize Course Sites and Categories

  • You can now "favorite" sites that you want to display at the top of your Sakai page. View this short video or follow the instructions below:
    • In Sakai in the upper right corner, click on Sites, then click on the "gray" star to the left of a site you want displayed at the top of your Sakai page; the star will display "yellow"
    • After you click on the "X" in the upper right corner of the Sites drop-down box, in the top middle of your page, you can click on a link to "reload" your page, to see your favorites listed across the top of your page
    • Also, in Sites, at the top right of your Sakai page, you can also "un-favorite" sites, by clicking on the yellow star to the left of the course site(s)
  • Previously you could hide sites from your "Sites" area that you no longer wanted to see. You still can, but there's more!
    • Now you can also hide categories of course sites (such as 2018FA or 2018CE3):
      • In Sakai at the top left, click on the Home button:
        • On the menu on the left, click on Preferences
        • Click on the Sites tab. Click in the checkbox beside a category and/or sites
        • At the bottom, click Update Preferences.

Resolved Issues

Lessons: Student Content/Pages, Comments, Question: Can Not Enter Zero Grade for Students without Submissions

  • This issue has been resolved:
  • Issue: In Lessons, after you added Student Content, if you chose to make it a graded assignment, there wasn't a way to enter a zero grade for students who did not submit the assignment. The same issue existed for graded Comments and graded Questions.
  • Solution: Student Pages The Sakai Community fixed these issues. As soon as you make your Student Content a graded assignment, you'll see in the Student Pages area two new features: 1) "Missing Pages", a list of student's who haven't submitted their student page 2) A button titled: "Set grades to zero for students without submissions".
  • Solution: Comments/Add Question In Lessons, after clicking on the grading icon (next to the Edit item icon); at the bottom of the grading pane, a new link has been added "Set grades to zero for students without submissions".
  • Previous Solution: Instructors had to create a separate Gradebook column to record student grades for student pages and for comments and questions, so they could assign zeroes to students who did not submit the assignment, comments and/or question answer.

Assignments: Peer Reviewer Receives an Error When Attaching File

  • This issue has been resolved:
  • Issue: When a student completing a peer review clicked Reviewer Attachment to attach a file, he received an error.
  • Solution: Students completing a peer review can click "Reviewer Attachment" and attach a file, with no errors. Attachments and/or text can now be submitted.
  • Previous Solution: Students can still copy and paste content into the Reviewer Comments area, the "Peer Reviewer text box"; the Peer Review text can then be submitted.

Buttons fail to function

  • This issue has been resolved: Some instructors reported instances of buttons not working in Sakai 11. For example, when adding or editing an Assignment, you click the "Post" or "Save" button and nothing happens. Or after editing home page content, you click "Continue" and nothing happens.
  • Prior Solution: Clearing the cache resolves this issue. For a full clear of the cache, follow these steps:
    1. Log out of Sakai
    2. Clear your browser's cache - see instructions for clearing the cache in most any browser.
      • Note: Be sure to clear everything, including cache, cookies, history, etc.
    3. Close out of the browser completely
    4. Re-open the browser, log in again, and things should work correctly.

Note: This should solve the problem so that it does not recur. However, if you use another browser or computer, you may have to clear the cache there as well. If the problem occurs more than a few times on the same computer or browser, please contact sakaihelp@durhamtech.edu.