OneDrive Output Tool Icon

OneDrive Output Tool

Version:
2022.1
Last modified: May 04, 2022

OneDrive Output writes files from Designer to OneDrive. See Microsoft OneDrive to learn about known limitations. More information about Microsoft OneDrive can be found on the Microsoft OneDrive documentation site.

To maintain full functionality of OneDrive data connector, pay attention to compatibility with Designer.

Connector Version 2.0.1 and Later

Designer version 2021.3.3 and later.

Connector Version 2.0.0

Designer version 2021.2.1 - 2021.3.1.

This tool is not automatically installed with Designer. To use this tool, download it from Alteryx Community.

Sign In to OneDrive

The OAuth method is used for authentication, so you can either use the default Alteryx application by selecting Sign in via Internet Browser or you can provide your own API application by selecting Provide authentication information. Go to Microsoft OneDrive for more information on how to create an API application.  

To schedule your workflow on Server when using the Cloud services, you need to select Use Service Principal after selecting Provide authentication information so that your token has an extended expiration, and you need to provide your own API application. 

Sign in via Internet Browser 

  1. In Authentication Method, select Sign in via Internet Browser

  2. Select Connect

  3. Enter your credentials and sign in. 

Provide Authentication Information 

  1. In Account type, select OneDrive business.
  2. In Client ID, enter your application key. See Microsoft OneDrive to learn about authentication configurations and known limitations.
  3. Enter the secret key.
  4. Select Login.

Select a File

  1. Select which files to display in the Files to display dropdown. Options are Personal Files, Recent and Shared with me

  1. Select the file in the file tree or search for it by its name. You can enter the file path in the File Path field. 

  1. Use Existing File Action in the Options tab to select the handling of an existing file. 

  • Rename: The Rename option will rename the file (appending a unique number to the end of the filename). 

  • Overwrite: Overwrite option deletes the existing file and writes the new file contents.

  • Append: Append option adds the new data to the existing file. 

  • Abort: When Abort is selected, the file will not upload if there is another file with the same name.

If you select the Overwrite or Append options in Existing File Action, the updated sheet becomes the first sheet in the file. This can impact tools using the order numbers of sheets.

 

Add a Folder 

  1. Navigate to the folder where you want to add a folder. 

  1. Select Add Folder

  1. Select By Name and enter the name of the new folder. Designer adds the folder without the need to run the workflow. 

  1. Select By Field to add multiple folders based on a specified field from the data. 

  1. Enter the name of the new files in the File Name field.

    The File Name field requires the file name including the file type extension. 

  2. Run the workflow to add the folders. 

Add a File 

  1. Navigate to the folder where you want to add a file. 

  1. Select Add File

  1. Select By Name and enter the name of the new file. 

    The File Name field requires the file name including the file type extension. 

  1. Select By Field to add multiple files based on a specified field from the data. 

  1. Run the workflow to add the file. 

Select a File Format

XLSX
  • Data Range options specify the names of the sheets to create. Options are By Sheet Name and By Field

    If you select the By Field option, multiple sheets will be created and named based on the value selected in Select Field.

     

  • Enter the cell in Start in cell to specify the start of data output. 

  • Select Write headers to include headers in the output data. 

  • Select Code Page to determine the encoding of the data. 

CSV
  • Use Max Field Length to set the maximum length of each field, allowing control over string cut off. 

  • Use Field Delimiter to select a field delimiter between fields. Options are CommaSemicolonTabPipeSpace or Custom delimiter

  • Select Write headers to include headers in the output data. 

  • Use Quote Character to select a format of the quote. Options are NoneSingle QuoteDouble Quote, or Custom

  • Select Code Page to determine the encoding of the data. 

YXDB

No options.

Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.