erinhmcmillan
Instructure Alumni
Instructure Alumni

Canvas Release: Microsoft Office 365 LTI (2016-12-10)

This document introduces the Microsoft Office 365 integration as noted in the Canvas Production Release Notes (2016-12-10).

 

Microsoft Office 365 requires the Microsoft Office 365 LTI app, which can be added to an account, sub-account, or course. The LTI can be configured manually by users who have permission to add and edit LTI tools.

 

When enabled, Microsoft Office 365 adds functionality to multiple areas in Canvas courses.

Canvas supports an LTI integration with Microsoft Office 365 in Assignments, Collaborations, Modules, Course Navigation, and the Rich Content Editor. This integration allows students and instructors to use, create, share, and collaborate on Office 365 files within Canvas. Users can also view their OneDrive files directly in Canvas.

 

 

Integration Details

 

Microsoft Office 365 is an external app (LTI) available to institutions with Office 365 education or business accounts who have created user accounts for their students. The Office 365 LTI is not supported for personal Office 365 accounts.

 

The Office 365 LTI supports Microsoft OneDrive in Canvas and can be enabled at the account, sub-account, or course level in a Canvas production environment. The LTI is not available in the Canvas App Center and must be configured manually by users who have permission to add and edit LTI tools. Integration instructions vary by region:

 

  • United States: Users can generate their own key and secret to install the LTI tool through the EduAppCenter Microsoft Office 365 app page. Instructors in Free-for-Teacher accounts can add the LTI to individual courses.

  • Worldwide Regions: Users should contact their Canvas Customer Success Manager (CSM) for region-specific configuration credentials. Office 365 is not currently available for instructors in Free-for-Teacher accounts.

 

Note: The OneDrive external tool is still available in the EduAppCenter, but the new Microsoft Office 365 LTI should be used in its place.

 

Microsoft Integration Add-Ins

The Microsoft integration officially supports Microsoft OneDrive in Canvas. However, Microsoft maintains add-ins for additional products, such as OneNote. These add-ins are not managed or maintained by Canvas. Documentation can be found as part of Microsoft's support website.

 

Microsoft Limitations

As part of the Canvas integration, some functionality is limited by Microsoft. Users should be aware of the following limitations by Microsoft in Canvas:

  • Faculty and students must have accounts in the same Microsoft domain.
  • Account sharing permissions can prevent sharing outside of an institution’s domain. Admins can change the sharing permissions to allow documents to be shared outside the institution. This feature may affect institutions with trust accounts.
  • Document permissions can prevent files from previewing in a course. Users should ensure that permissions are set correctly for a document before sharing it with others in Canvas.
  • Microsoft authentication is only managed when adding Microsoft as a third-party authentication service in Canvas. The LTI integration does not support single sign-on authentication.
  • When displaying Word, Excel, and PowerPoint files, files with font conflicts will not display. Best practice is to use standard Microsoft fonts in all documents.

 

Canvas Account-Level Features

Authentication

Canvas admins can use the existing Microsoft third-party authentication method to enable users to sign into Canvas using their Office 365 credentials. The LTI integration does not support single sign-on authentication.

 

Microsoft-Authentication.png

 

Canvas Course-Level Features

Course Navigation

The Microsoft Office 365 LTI adds a link to a user’s OneDrive in the Course Navigation Menu. The name of the link aligns with the name added as part of the Office 365 LTI (most commonly named Office 365). After logging in to their user accounts, users can view all files in their OneDrive account.

 

Course-Navigation-Office-365.png

 

Assignments

Cloud Assignments

Instructors can create an online embedded assignment through an external tool. With the Microsoft Office 365 external tool, this assignment type creates a view of the assignment file that acts as a template for a student’s assignment submission. Accepted assignment types are Word, PowerPoint, and Excel.

 

Cloud-Assignment-Creation.png

 

When students open the assignment, Office 365 will create a copy of the file in the student’s OneDrive folder for the course for each student’s submission. Students can open the document and make changes per the assignment instructions. When they are ready to submit the assignment, they can return to the Canvas assignment page and submit the assignment. Instructors view each student’s document copy in SpeedGrader for grading.

 

Cloud-Assignment-Office-365.png

 

File Upload Assignments

Instructors can also continue to create regular file upload assignments. However, when an instructor allows file uploads, students can view the Office 365 tab and upload files directly from OneDrive.

 

Office-365-Tab.png

 

Collaborations

Users can create collaborations with Microsoft Word, PowerPoint, or Excel documents. The creator can add individual users or groups from the course to participate in the collaboration. Collaborators can be added or removed at any time, but once a user is added to the collaboration, the user always has access to the collaboration in the user’s OneDrive folder.

 

Collaborations.png

 

External Collaborations Tool Feature Option

Office 365 complements Canvas with an updated Collaborations page. The page design update is controlled by the External Collaborations Tool feature option, which can be enabled by a Canvas admin and must be enabled in the same location as the Microsoft Office 365 LTI app (course or account).

 

  • Enabling the External Collaborations Tool feature option removes the links to all existing collaborations and no longer allows users to create collaborations with the existing Google Drive option.
  • To implement this feature, admins should set the feature option to allow so instructors can manage any existing collaborations. Instructors who want to retain existing collaborations should not enable the External Collaborations Tool feature option at the course level.

 

Note: this feature option is not available in the beta environment.

 

Files

Users can access their OneDrive folder from Course Navigation link. Office 365 does not display a folder directly in a user’s Files page.

 

Like other uploaded files in Canvas, student submissions are copied to a student’s submissions folder in user files if the file was uploaded using the File Upload or Office 365 upload assignment options. However, cloud assignment submissions are copied into the student’s OneDrive folder.

 

Modules

The Office 365 LTI tool displays as a Modules external tool. Instructors can add links to OneDrive documents as an external tool.

 

Rich Content Editor

The Office 365 LTI displays the OneDrive icon in the Rich Content Editor. The icon displays everything in a user’s OneDrive account and allows users to display documents as inline links. Students and instructors can view the icon anywhere they can access the Rich Content Editor, such as discussions and pages (as allowed).

 

Office-365-RCE-editor.png

 

SpeedGrader

The Office 365 LTI includes an Office 365 viewer, which can be used to preview office documents in SpeedGrader and overrides any other previewer in Canvas.

 

SpeedGrader displays any uploaded file type that is supported like other Canvas assignments. Some files cannot be previewed in SpeedGrader and have to be downloaded for viewing. Crocodoc can be used with supported file types.

 

Canvas Mobile App Features

The following functionality relates to Microsoft Office 365 in the Canvas by Instructure app and SpeedGrader app:

 

Canvas by Instructure

  • Authentication through Microsoft is not supported in the Canvas app.
  • Collaborations are not supported in the Canvas app.
  • Microsoft Office 365 files can be viewed in a mobile device by downloading the OneDrive mobile app.
  • In cloud assignments, the students can view the assignment description but cannot view the cloud assignment. In the submission tab, students can view a link to access the assignment externally, though the link is not currently functional as it cannot connect the student to the student’s Microsoft Office 365 account for online editing. Instructors who incorporate cloud assignments into their coursework should let students know that cloud assignment are not currently supported in the Canvas app.
  • File upload submission types can accept files from the Microsoft OneDrive mobile app. Similar to submitting Google documents as assignments, students can share a supported file from the OneDrive app and import it to Canvas.
  • Modules can display external tools set to a Microsoft Office 365 document if students log in to their accounts.

 

SpeedGrader

  • Cloud assignment submissions do not display in the app.

 

For any contrary behaviors in the production environment, users should submit a Canvas support case for assistance.

Labels (1)
42 Replies
Shar
Community Champion

Awesome cool for the Cloud Assignments!:smileycool:  Even with the current limitations, it's still a very nifty feature to make sure students are completing the correct document. Hah! there go your excuses, students, about not locating the right file!:smileygrin:

I'm guessing that eventually you'll support annotations on the Office 365 submissions in SpeedGrader. No worries for now though, we still have access to our rubric to leave feedback.

Cheers - Shar

MattHanes
Community Champion

We're so excited about this for our O365 school district!

Is there any loss of functionality if we don't implement the new collaborations page that removes Google Docs options? In other words, is that option strictly a visual change?

Also, we've seen in the demo that you could submit a word document to an assignment from within O365 itself. I don't see that mentioned here though. Did that feature make it in yet?

buellj
Community Contributor

Same question - I wasn't understanding the info about the new collaborations page. What are the pros/cons between keeping the External Collaborations Tool option turned off and using the new Office 365 LTI vs turning it on?

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Matt,

It is a visual change, yes. If you don't turn it on, Office 365 appears as an option in the current Collaborations drop-down menu. But if you do turn it on, you lose all existing collaborations and can only use Office 365.

The Word document integration is strictly maintained and managed by Microsoft; the functionality does exist and we're going to add info about that in the Office 365 Focus Group​ (which you are welcome to join as well).

Thanks,

Erin

h_mukaddam
Community Contributor

Hi there,

Anybody tested this on the Canvas iOS App.

myerdon01
Community Champion

In our instance of Canvas, we already have Class Notebook enabled and I just added Office 365, so now in our navigation, faculty will see both Office 365 and Class Notebook. So...the question I have, would it make sense to disable the Class Notebook since this is already available in Office 365? I don't want to confuse faculty anymore than I have to!

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Hamza,

I've updated the document to reflect the current functionality in the Canvas apps.

Hope that helps!

Thanks,

Erin

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Melinda,

Class Notebook is a separate app that is independent from this LTI. You should be able to use both, but ultimately it's up to you and how many integrations you want to display to your users. Microsoft does have a couple of OneNote Class Notebook add-ins you could explore as well for online assignments. I've included links in the release notes document.

Thanks,

Erin

kcelebi1
New Member

Fantastic.  Does anyone know if there is any documentation/guides on this yet?  I plugged it into Canvas, but need some guidance on configuration.

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Kevin,

Check out the Office 365 Focus Group for links to resources and to ask specific questions about the integration.

Hope that helps,

Erin

dave-long
Community Participant

Hi Erin,

For the External Collaborations Tool Feature Option, is that something our CSM needs to turn on, or can I turn that on as a Canvas Admin?

I'm looking under our main account's Settings > Feature Options tab, and don't see setting for the External Collaborations Tool, but maybe I'm in the wrong place.

Thanks!

-Dave

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Dave,

You're in the right place. You'll find that feature option under the Courses heading; scroll down to the bottom of the page and you'll see it right above Quiz Log Auditing.

Hope that helps!

Erin

dave-long
Community Participant

Hi Erin,

Thanks, should this option be available on Canvas Beta?

Looking at the Feature Options tab in Prod, the "External Collaborations Tool" feature option does appear.  Checking Iowa's instance of Test and Beta, that option does not appear.  I was looking at Beta when I posted the above comment.  See the image below for what I see on Beta.

Do you see this option on Test or Beta?  Is this somehow related to the recent Beta release?

Thanks!

-Dave

uiowa canvas beta feature options.png

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, David,

Thanks for the clarification on the environment you're using. It looks like the feature option is actually hidden in beta; I'm not sure why at the moment and we'll look into fixing that next week. If you'd like it turned on in beta, just contact your CSM.

Thanks,

Erin

victoria-maloy
Community Champion

I have found that in the Cloud Assignment Submissions gradebook cells a Submission URL is placed in the comment window.

212203_pastedImage_0.png

However, following the link only results in a "page doesn't exist" message.

212249_pastedImage_1.png

Is anyone else seeing this behavior?

rgibson1
Community Champion

Is anyone else getting this error when attempting to use the Microsoft Login option on the Test Server? Is it because of the Test Server?

Login_Error.png

rgibson1
Community Champion

There also appears to be a limited number of folders that are displayed when the user clicks "Office 365" from the sidebar. (OneDrive) Mine stops at about 200 folders - somewhere around the "M". *However*, when I browse folders from the content editor (RTE), all the folders in OneDrive appear normally.

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Rob,

The LTI isn't supported in the test environment, so yes that could be why. If you see this error in the production environment, please submit a support case so we can check it out.

Thanks!

Erin

rgibson1
Community Champion

Followup to my own posting....

I added the LTI to Production during this downtime. Interestingly, the Microsoft Login never appeared like it did in Test. That's OK, I guess. Not sure what's going on there....

rgibson1
Community Champion

 @victoria-maloy  I'm attempting to replicate your steps, but thus far I'm unsuccessful. I browsed and added an O365 (OneDrive) Word file as a student to an test assignment submission lifecycle. I never see the URL behavior you illustrate above. Instead I see the actual file I added from the cloud.

Can you provide your steps? I would like to see if I can replicate this....

rgibson1
Community Champion

Really digging the new O365 Collaborations feature that allows for student collaboration using Word, Excel, or PowerPoint.  Whereas the Google option is limited to Docs (for now). The bomb.

Microsoft Office 365 Now at Your Fingertips

victoria-maloy
Community Champion

Hi Rob,

Thanks for taking a look at this with me.  Here's my steps.

1.  The instructor creates an assignment in the course.  Submission Type = External Tool.

2. In the "Configure External Tool" window the instructor selects the Office 365 Cloud Assignment link from the menu.

3. In the "Link Resource from External Tool" window, the instructor selects a file for the assignment.

4. Back in the "Configure External Tool" window, complete this process by clicking "Select." Then Save & Publish the assignment.

Next, the student logs in and submits the assignment.   Note that this is not simply an upload of a document from the student's O365 files, but a Cloud Assignment.

Back to the instructor's side of things: When a student has submitted the assignment, the gradebook will automatically assign a zero to the cell in the spreadsheet.  This is a known issue mentioned above.

When I click into the top right corner of the cell, in the comment window, I get a handy link to the Submission - except for the fact that the URL leads to a page that doesn't exist.

If I go through the "More Details in Speedgrader" link it does take me to the student's submission, but the broken URL is so much longer, I'm sure it will catch an instructor's eye before the Speedgrader link.

Let me know if you see anything different this time!

Vicky

JACOBSEN_C
Community Contributor

Is the Office Onedrive app no longer an option?  We are getting the error included below at the moment... it was working in the fall, the app.

Screen Shot 2017-01-05 at 3.26.58 PM.png

rgibson1
Community Champion

Working OK here at ESU, but we're in a fresh installation.

Adrienne_J_Gaut
Community Champion

... might be worth putting that it's only available in Production and specifically won't work in Test/Beta in the Release Notes up at the very top where the installation instructions appear?

Might save folks some wasted time. Some institutions require new things to be vetted/tested in Test before going into Production, us included. I can find the App in Test and can install it in a course. I can click the menu item and I can pull in my OneDrive. I can also link to a OneDrive doc from the RCE. What I cannot do in Test is a Cloud Assignment or students submitting OneDrive assignments. Spent some time troubleshooting and talking with our O365 admins, and that wasn't needed.

It wasn't until I thought to secretly try it in Production...that I realized it doesn't fully work in Test.

fabianm
Community Participant

We are very excited about the Office 365 integration!

One suggestion: it would be nice to have the Office 365 navigation link show in Groups (same as it does in Courses). This would allow group member to easily access OneDrive files.

dschuma
Community Participant

Clint,

Did you ever find a resolution to this issue?  BGSU is experiencing the same problem.  Thanks.

JACOBSEN_C
Community Contributor

Not yet.  Good to hear we are not alone.

dschuma
Community Participant

I submitted a ticket and emailed our CSM.  I'll share what I learn.

dschuma
Community Participant

Adrienne_J_Gaut
Community Champion

erinhallmark​ might chime in --- earlier there was a comment that it ONLY works in Production. I found this to be true, that some things did not work in our Test instance. I didn't try Beta.

DaleDrees
Community Champion

If a student submits a word document from Office 365 are the crocodoc features available to the instructor for that submitted Office 365 files?

Currently we do not see this available in our instance.

victoria-maloy
Community Champion

I can report that this behavior is the same in our Test environment.  Even if the file format should be readable by Crocodoc (.docx in my case) the preview of the file is using Box, not Crocodoc.

kmcgee
Instructure Alumni
Instructure Alumni

Hi Clint, this looks like a previous version of the Microsoft tool, that we are not longer supporting. To have the new integration work for you, you'll want to uninstall this previous version and set up the new integration available in the  Edu App Center.

Thanks!

erinhmcmillan
Instructure Alumni
Instructure Alumni

Hi, Dale,

This functionality is a fixed bug we'll be announcing in the Canvas production release notes coming soon and will be part of the Canvas release on January 28.

Thanks,

Erin

rglore
New Member

Hello!

I've been working with faculty on Collaborations. Currently you can create the collaboration and use to collect all students impute. But it doesn't tell the faculty who is collaborating and what they are adding to the doc. No time stamps or indicators. Will this change? There is no real way to close a collaboration, will this also change?

If you create a collaboration, link it to an assignment, it creates a document for each student which defeats the purpose of collaborations. Will this be something that changes over time?

Whatever help you can give me would be amazing.

Thanks,

Rodney

kmcgee
Instructure Alumni
Instructure Alumni

Hi Rodney, Thanks for your questions. I wonder if Discussions might work as a better alternative to for gathering student input. You would then get time stamps and an indication of who wrote the feedback. Collaborations are intended for student group work or for group notes. Currently, no plans to close collaborations. One workaround for this would be to remove all the students from the collaboration.

Collaborations are best only referenced in assignments instead of linked to or embedded, more specifically they should not be used in tandem with cloud assignments. Like you said this will have unintended outcomes such as duplicate file creation.

It may help to read over the Collaborations guides to learn more about their intended use.

Hope this can help your use of the new tools! Smiley Happy

powellj
Community Member

Can anyone expand on the statement, "Faculty and students must have accounts in the same Microsoft domain.", please? For whatever reason, our faculty/staff are in a different domain than our students. Is there only certain functionality that would not be available, or are we looking at total inoperability? Thanks!

dschuma
Community Participant

Clint,

Instructure has confirmed this is a wide-spread issue.  However, exact scope or nature of the issue was not provided.  The ticket I submitted is in the hands of the engineers for resolution.  I can post an update when it is reported that the issue is resolved.

PS This integration is still officially supported, but it is deprecated.  I expect to see an announcement later this spring as to the last date it will be available.  BGSU is planning to review the Office 365 integration in the coming weeks as long as Instructure will support the integration.