Use the OneDrive for Business integration to give users of your digital workplace a way of viewing, adding, and downloading files located in OneDrive.
Sections in this article:
Considerations and caveats
Moving files between your digital workplace and OneDrive
You can't transfer files directly between a folder channel in your digital workplace and OneDrive. You must download the files to your device and upload them to the other repository.
Shared files
The OneDrive integration is not able to show files or folders that have been shared with you from someone else's OneDrive.
Widget layout
Location | Description |
---|---|
Breadcrumbs |
Use the breadcrumbs at the top of the file and folder list to navigate back to a parent folder. |
Search |
Select a folder to view its contents. Use the breadcrumbs at the top of the file and folder list to navigate back to a parent folder. If enabled, use the search box to find a specific file or folder. |
Add folder |
Select |
Delete folder |
To the right of a folder, select |
Upload files |
Select Additionally, drag and drop files from your device into the integration. The files you dragged will be uploaded to the current location. |
View in Office Online |
If View in Office Online is enabled, select a file to open it in O365 online. |
Actions menu |
The rightmost column of the file list in the widget contains an icon with three dots. Select |
Actions menu: View in Office 365 |
If enabled, select View in Office 365 to open the file in your browser using the associated 0365 application. |
Actions menu: Download |
Select Download will save the selected file to your computer or device. If you are using Microsoft Edge as your browser, files associated with O365 applications will open in their associated application. |
Actions menu: Delete File |
Select Delete to delete the file. You will be prompted to confirm this action. |
Actions menu: Information |
Select Information to view file size, creation date, and modification date. A link to the file in OneDrive is also provided in addition to the other Actions menu options (View in OneDrive, Download, Delete File). |
Log out |
Select Log out in the bottom right hand corner of integration to sign out. |
Set up
- Place an
Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget.
- Select the placed widget's Edit button.
- Under Integration Library, select Igloo Integration Library.
- Select
OneDrive for Business from the library.
- Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
- In the widget editor, select Update to apply your changes.
- At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.
O365 administrator sign-in
The first time you ever set up the integration in your digital workplace, your Office 365 administrator must sign in to it using the Sign in as Microsoft Admin link on the authentication prompt of the integration. This only needs to be done once per Office 365 environment. Once an O365 administrator grants permissions to the app, the integration can be used anywhere in your digital workplace without additional administrator approvals.
After an O365 administrator grants permissions, edit the integration to disable and hide the Sign in as Microsoft Admin link.
Settings
Options tab
Setting | Description |
---|---|
Title |
Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections. When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select This field can contain a maximum of 140 characters. |
Title link |
Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget. This field can contain a maximum of 2,083 characters. |
Description |
Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget. When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select |
Setting | Description |
---|---|
Azure Tenant ID |
Enter the default value of Refer to Microsoft's article, How to find your Azure Active Directory tenant ID, for instructions on locating this value. |
Initial Folder Path |
Enter the path of the initial folder that you want to show. Users cannot browse or search for files that are not in this folder. For example, |
Setting | Description |
---|---|
API Base URL |
Enter the domain of your OneDrive. For example If left blank, the URL will default to the OneDrive domain associated with the signed-in user and display the organization's primary O365 OneDrive Document Library. |
Drive ID |
Leave this field blank for your primary drive. The Drive ID is typically the SMTP address of a user and is used to connect to a different user's OneDrive. |
Show the admin consent login link |
Select Enable to show the Sign in as Microsoft Admin link on the authentication prompt of the integration; deselect Enable to not show this link. See the Office 365 administrator sign-in section above to better understand when to select this option. |
Enable View in Office Online |
Select Enable to show the View in Office 365 option in a file's actions menu; deselect Enable to not show this option. |
Enable Auto Height |
Select Enable to make the height of the integration responsive to the amount of content; deselect Enable to give the integration a fixed height (scrollbars will be available to navigate locations with large amounts of files or folders). If enabled, the Height option on the Appearance tab must be set to Auto (default state). |
Show search |
Select Enable to give users the ability to search the connected repository; deselect Enable to prevent users from searching the repository. |
Show Last Modified |
Select Enable to show the Last Modified by column; deselect Enable to hide this column. |
Show Last Modified |
Select Enable to show the Last Modified column; deselect Enable to hide this column. |
Show File Type |
Select Enable to show the File Type column; deselect Enable to hide this column. |
Show File Size |
Select Enable to show the Size column; deselect Enable to hide this column. |
Appearance tab
Setting | Description |
---|---|
Class |
Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets. |
Height |
Select the height of the widget. The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px. Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar. |
Note
Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.