Microsoft OneDrive Writeback Connector
Intro
Microsoft OneDrive is an online file sharing and personal cloud content management service for businesses. Use this connector to export your data from a Domo DataSet to a specified OneDrive folder. For more information about the OneDrive API, see https://msdn.microsoft.com/en-us/lib.../dn659752.aspx.
You export data to OneDrive in the Data Center. This topic discusses the fields and menus that are specific to the Microsoft OneDrive Writeback connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To configure this connector, you will a Domo Client ID and Client Secret. To create a Domo client ID and client secret, do the following:
-
Navigate to https://developer.domo.com and log in.
-
Click New Client (found under "My Account" in the top right corner).
-
Create a new client with Application Scopes of Data and User.
When you click Create, you will be redirected to the client ID and client secret. -
Copy the client ID and client secret, as you will need them soon.
Microsoft Permissions
Having the correct permissions within Microsoft allows Domo to effectively access your data using the Microsoft OneDrive Writeback connector.
Setting Permissions for New Apps
These steps pertain only to new apps.
-
Navigate to https://apps.dev.microsoft.com/ and sign in.
-
Click Add an app.
-
Name the app.
-
Click Create.
The APP ID that appears is the Client ID.
-
Click Generate new password.
Be sure to SAVE THIS—you will not see it again. This is your Secret.
-
Click OK.
-
Click Add platform.
-
Select Web.
-
In the Redirect URLs field, enter the URL https://oauth.domo.com/api/data/v1/o...drive/exchange.
-
Click Save.
-
Add permissions for Files.Read.All, offline_access, and Sites.ReadWrite.All.
-
Click Save.
-
Go to Domo and use the ClientID and Secret to connect.
Configuring the Connection
This section enumerates the options in the Credentials and Details panes in the Microsoft OneDrive Writeback Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your Domo developer account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Domo Client ID |
Enter your Domo client ID. For steps on obtaining your client ID and client secret, see "Prerequisites," above. |
Domo Client Secret |
Enter your Domo client secret. For steps on obtaining your client ID and client secret, see "Prerequisites," above. |
Once you have entered valid credentials, you can use the same account any time you go to set up a new Domo-OneDrive connection. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a number of fields for specifying your data and indicating where it's going.
Menu |
Description |
---|---|
Input DataSet ID |
Enter the DataSet ID (GUID) for the DataSet you want to copy to a OneDrive folder or workspace. You can find the ID by opening the details view for the DataSet in the Data Center and looking at the portion of the URL following datasources/. For example, in the URL https://mycompany.domo.com/datasources/845305d8-da3d-4107-a9d6-13ef3f86d4a4/details/overview, the DataSet ID is 845305d8-da3d-4107-a9d6-13ef3f86d4a4. |
Folder Name |
Select the OneDrive folder where you want to copy your data. |
Select Filename |
Select how you want to choose the file where data will be copied.
|
Filename |
Enter the desired output filename. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.