This article is part of the Tool Mastery Series, a compilation of Knowledge Base contributions to introducediverse workingexamples forDesigner Tools. Here we’ll delve into uses of the OneDrive Tools on our wayto mastering the Alteryx Designer:
IMPORTANT - The following article is accurate for App Registrations that were created prior to October 2020. If you are setting up a new App Registration for a Microsoft Connector, please see this Help Documentation .
OneDrive is a file hosting and synchronization service operated by Microsoft. You can connect to a OneDrive instance in Alteryx with the OneDrive Input tool and the OneDrive Output tool.
The OneDrive tools do not come installed standard with Alteryx. To install them, you can find them here, or by searching for “OneDrive” in the Alteryx Gallery.
Connecting to OneDrive:
There are two different modes for authentication depending on whether the OneDrive account you'd like to connect to is Personal or for Business. For either form of authentication, you will have to register a new application with Microsoft (Azure) and create a Client ID. If the account type is business, you will also need to generate a secret key.
How to Create a registered application in Azure:
1. Go to the Azure Application Registration Portal
2. When prompted, sign in with your account credentials.
3. Select "New Registration":
4. This will prompt you to enter a name for the application, the supported account types, and the redirect URI. Select either of the multitenant options (You may have to work with your Azure admin to determine which will be best for you) and enter https://login.live.com/oauth20_desktop.srf as the redirect URI. This is required for the OneDrive tools to connect.
5. Once the app is created, an application ID will automatically be created. This is the Client ID that is used in Alteryx to login to the app:
6. If you are using the application for a OneDrive Business account (organization account) you will need to generate a client secret. This will be entered as the Secret Key when logging in from the OneDrive tool in Alteryx:
Once you select "New Client Secret" a secret will be generated. Make sure to copy and paste this somewhere safe, as after you leave the page for the first time, the secret will be hidden. You can always generate a new secret if you lose it.
7. Next, you will have to set permissions for the application. You can access API permissions for the application from the application "overview page":
There are three delegated permissions required to use the tool (Files.ReadWrite, User.Read, and offline_access).
Note* You can achieve necessary permission for the application by selecting other permissions as well. The permissions listed above are the bare minimum for the Alteryx tool to access OneDrive.
After this is complete, you have everything necessary to log into the OneDrive tool in Alteryx. Additional information on registering an application with Azure can be found here.
Logging in to the OneDrive tools in Alteryx:
Personal: For OneDrive Personal Accounts, you will only need to enter a Client ID:
Business: For OneDrive Business Accounts, you will need both a Client ID as well as a Secret Key that is associated with the application:
Once you provide the application credentials, A new window will pop up, and you will be prompted to log in to an account that has access to the OneDrive:
Note* You will have to provide authentication for both OneDrive Input and Output tools, even if you are using them in the same workflow.
Once you complete the authentication, the configuration window for the tool will appear.
Configuring the OneDrive Input Tool:
The OneDrive input tool will allow you to choose multiple specifications for the file you wish to pull in:
Once you have made all of your selections, run the workflow to pull in the file from OneDrive.
Configuring the OneDrive Output Tool:
Once you have made all the selections that you wish, run the workflow towrite data into OneDrive.
"We're unable to complete your request" error after logging in:
-This usually means that you have entered your Client ID or Application Secret incorrectly. Makes sure that you have entered them correctly.
-Also be sure that you have permissions to access the OneDrive.
Error when reading in JSON: “list index out of range”
Check to make sure that JSON formatting within the files is correct.
By now, you should have expert-level proficiency with the OneDrive Input and Output tools! If you can think of a use case we left out, feel free to use the comments section below! Consider yourself a Tool Master already? Let us know at firstname.lastname@example.org if you’d like your creative tool uses to be featured in the Tool Mastery Series.
Stay tuned with our latest posts everyTool Tuesdayby followingAlteryxon Twitter! If you want to master all the Designer tools, considersubscribingfor email notifications.