Connector for Microsoft OneDrive

The connector for OneDrive allows you to access and use your personal files hosted on Microsoft OneDrive.

To use this connector, perform the following prerequisites:

Register Panopticon Real Time as an application in the Azure administration portal
Get access on behalf of a user

Then configure the Panopticon.properties file located in the AppData folder (i.e., /etc/panopticon/appdata) with the values generated from these prerequisites:


Property	OneDrive connector
Attribute	connector.onedrive.client.id
Description	Application (client) ID assigned by the Azure administration portal.
Default Value
Property	OneDrive connector
Attribute	connector.onedrive.client.secret
Description	Your application’s client secret created in the application registration portal.
Default Value
Property	OneDrive connector
Attribute	connector.onedrive.root.url
Description	The Microsoft Graph API root URL.
Default Value	https\://graph.microsoft.com/v1.0/me/drive/root
Property	OneDrive connector
Attribute	connector.onedrive.tenant.id
Description	Controls who can sign into the application. The allowed values are: common - for both Microsoft accounts and work or school accounts organizations - for work or school accounts only consumers - for Microsoft accounts only tenant - identifiers such as the tenant ID or domain name
Default Value

Save the updated properties file and restart Tomcat.

Click Login.

A notification dialog box displays where you may need to enter the login credentials to your Microsoft account. Click Accept to allow permissions.

Your OneDrive files are now displayed in the list box.
Select the Only Show Know File Types checkbox to narrow down the list based on the supported data types.
Select the OneDrive file. The file name is displayed in the File Path field and the Data Type is updated with its related fields.
Select either the period (.) or comma (,) as the Decimal Separator.
NOTE: Prepend 'default:' for the elements falling under default namespace.
Click to the fetch the schema based on the connection details. Consequently, the list of
columns with the data type found from inspecting the first ‘n’ rows of the input data source is populated and the Save button is enabled.
You can also opt to load or save a copy of the column definition.
NOTE: This option is not available for the Excel data type.

Click

to add columns to the OneDrive connection that represent sections of the message. Then enter or select:

Property	Description
Name	The column name of the source schema.
JsonPath/Column Index/XPath	The JsonPath/Column Index/XPath of the source schema.
Type	The data type of the column. Can be a Text, Numeric, or Time
Date Format	The format when the data type is Time.
Enabled	Determines whether the message field should be processed.

NOTE: To parse and format times with higher than millisecond precision, the format string needs to end with a period followed by sequence of upper case S. There can be no additional characters following them.

For example: yyyy-MM-dd HH:mm:ss.SSSSSS

To delete a column, check its or all the column entries, check the topmost , then click .

Giving Read Access to OneDrive Data Files for Viewers of Your Dashboard

When you share a file in OneDrive with another user, they will be able to view the data of a Panopticon data table that you created from that file as soon as:

They can see the file in their personal OneDrive using the browser (Sharepoint.com), under the Shared section
If a user has done the login procedure through the OneDrive connector, they will be able to load any file shared with them, regardless of it showing or not under Shared in the Sharepoint.com web view

Users that only have a Viewer role in Panopticon will be able to view the data of a Panopticon data table that you created from a file in your OneDrive, as soon as the user can see the file in their personal OneDrive using the browser (Sharepoint.com), under the Shared section. Until the shared file has been listed there by OneDrive, the user will not be able to load the data through Panopticon.

NOTE: The Viewer user is also required to be authenticated/logged in to Panopticon using the same identity as in OneDrive (i.e., company single-sign-on identity).

Intellectual Property Rights Notice | Technical Support