The O365 OneNote integration gives users the ability to view and browse OneNote notebooks. When configuring the integration, you must specify up to 5 notebooks to show. This integration obeys the access rules of your O365 environment and will not display notebooks to users who do not have access to them in O365.
Sections in this article:
Considerations and caveats
Authentication
You must sign in to the integration using your organization's O365 credentials. If you sign in with different credentials, you will most likely not be able to access any of the configured OneNote notebooks.
After signing in, you will only see the OneNote notebooks that have been configured and that you have access to.
Widget layout
| Location | Description |
|---|---|
| Notebooks | Select a notebook to view its sections. |
| Sections | Select a section to view its notes. |
| Pages | Select a page to view the page in the integration widget. |
| Back | To navigate back the index of notebooks, pages, and sections, select |
| Open in Web | Select Open in web to view a notebook in O365. |
| Actions menu | In the bottom right corner of the integration widget, select |
| Actions menu: Sign Out | Select |
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
OneNote 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 |
| Default Notebook |
Select which of the configured notebooks initially displays in the integration. |
| Setting | Description |
|---|---|
| Show Admin Login |
Select Enable to show the Sign in as Microsoft Admin link on the authentication prompt of the integration; de-select Enable to not show this link. See the Office 365 administrator sign in section above to better understand when to enable this option. |
Notebook options
When setting up the integration, you can configure up the 5 notebooks to display. To configure a notebook, select one of the Notebook tabs to open its configuration options.
| Setting | Description |
|---|---|
| Enable |
Select Enable to show the Sign in as Microsoft Admin link on the authentication prompt of the integration; de-select Enable to not show this link. See the Office 365 administrator sign in the section above to better understand when to enable this option. |
| Notebook name |
Enter the name of the notebook as it appears in O365 OneNote. This notebook must be in your organization's O365 environment (ex. SharePoint or OneDrive); shared notebooks outside this location will not display. The widget will show all notebooks that have this name. However, users will only see notebooks that they have access to. |
| Setting | Description |
|---|---|
| Section name(s) |
Enter a comma-separated list of sections to display. Use section names as they appear in O365 OneNote. Leave this option blank to return all sections in a notebook. |
| Page name(s) |
Enter a comma-separated list of pages to display. Use page names as they appear in O365 OneNote. Leave this option blank to return all pages in a notebook. If entering values here, section name(s) must also be specified in the section name text field. |
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.