Microsoft OneDrive for Business - New file

Use the Microsoft OneDrive for Business - New file start event An event that triggers a workflow to run when it occurs. An example is Box - New file, which triggers the workflow to run when a new file is uploaded to the specified folder. to start your workflow whenever a new file is uploaded to a folder you specify in your Microsoft OneDrive for Business account. For more information about the Microsoft OneDrive for Business start events, go to Microsoft OneDrive for Business start events.

Microsoft OneDrive for Business has other actions as well. For more information, see Connectors.

Before you begin: 

Jump to:

Select the Microsoft OneDrive for Business - New file start event

  1. At the top of the designer canvas on the Designer page, click Start event to open the Start event configuration panel.
  2. For Start from, select Microsoft OneDrive for Business.

  3. For Event, select Microsoft OneDrive for Business - New file.

    Additional fields appear. To configure, see Configure the start event.

Configure the start event

When configuring the Microsoft OneDrive for Business – New file start event, you can:

In the Start event configuration panel:

  1. Find the Source section.

  2. Select a Connection. If you do not have a connection, see Add a connection.
  3. For Path, type the path to the folder that contains the new files to monitor. Example: /Draft. This value is case-insensitive. Do not add a trailing slash (as in "/Draft/").

For more information about fields and buttons, see Microsoft OneDrive for Business - New file start event fields by section.

start event variables A variable associated with the start event. Often referenced by actions in the workflow. For example, a start event variable might capture input in a form field.

  1. On the Designer canvas, click Start event.

  2. Select a connector from the Start from drop-down list.

  3. Select an event from the Event drop-down list.

  4. Click Add variables.
  5. Select the predefined variables that you want to add to your workflow. If you know the variable and you want to find it faster, type the variable name in the Filter options field. To select all variables, click Select All.
  6. Click Add.

    Note: If you want to edit the selection of variables, hover over the variable, click More Options icon, and then click Show Details. Edit the variable name in the Name field or click Delete icon.

  • Name: The file name, including extension. Text variable. Example: sunset.jpg
  • Path: The full file path of the new file, including folders, file name, and extension. Text variable. Example: /Draft/sunset.jpg.
  • File variable: The new file, stored in Nintex Automation Cloud for the duration of the workflow instance. File variable.

    • Use the File variable to attach the new file to an email later in the workflow, or to move or copy the new file to a new location. The configuration field in the action you choose must allow file variables.

  • URL: The web address of the new file. Example: https://acme-my.sharepoint.com/personal/paul_rafferty_
    acme_com/Documents/Attachments/sunset.jpg.
  • Size (bytes): The storage size of the file added to Microsoft OneDrive for Business.

For more information about fields and buttons, see Microsoft OneDrive for Business - New file start event fields by section.

conditions Statements about variable values, that when true, run the workflow.
  1. In the Start event dialog box, find the Set conditional start options section.

  2. For each condition: 

    1. Click Add a condition.
    2. For When, select a start event variable. For example, select Name for a new file start event.
    3. For Operator, select an operator for comparing the variable to the value. For example, select Contains.

    4. For Value, type or select the value to use for the comparison. For example, type marketing.

  3. Select All or Any to control how multiple conditions are evaluated.

For more information about fields and buttons, see Microsoft OneDrive for Business - New file start event fields by section.

Maintain path integrity

Caution: If a file/folder that's used in a workflow is moved, renamed, or deleted, any workflows that use that file/folder will not start or will fail. Make sure you keep the paths in your workflow configurations up to date.

Section

Field

Description
  Show variables

Displays variables that are available to use throughout the workflow. Variables are classified based on how they are created or generated.

Selection

Description

Name Internal name to identify your variable within the workflow.
Type

The data type of your variable.

You can assign only the variable type that a workflow expects. For example, if you want to capture a Date entry in a form, then you must create a variable of the DateTime type.
Used in Indicates the number of actions using the variable.
Delete Cancels adding the variable to the workflow.
Source Connection

The Microsoft OneDrive for Business connection to use for the start event.

  Path

The folder path to monitor for new files. Type the folder path. Example: /Draft. This value is case-insensitive. Do not add a trailing slash (as in "/Draft/").

Add variables

Displays selections for browsing, selecting, and adding variables to use throughout the workflow. For example, if you want to attach the new file to an email later in the workflow, then select the variable File variable.

Selection

Description

Filter options

Filters the list of variables using your entered text.

/

Selects or de-selects a variable for adding.

Select all

Selects all variables.

Add

Adds the selected fields.

Cancel

Discards field selections and hides the fields available for selection.

The following informational elements related to the new file that started the workflow are available.

  • Name: The file name, including extension. Text variable. Example: sunset.jpg
  • Path: The full file path of the new file, including folders, file name, and extension. Text variable. Example: /Draft/sunset.jpg.
  • File variable: The new file, stored in Nintex Automation Cloud for the duration of the workflow instance. File variable.

    • Use the File variable to attach the new file to an email later in the workflow, or to move or copy the new file to a new location. The configuration field in the action you choose must allow file variables.

  • URL: The web address of the new file. Example: https://acme-my.sharepoint.com/personal/paul_rafferty_
    acme_com/Documents/Attachments/sunset.jpg.
  • Size (bytes): The storage size of the file added to Microsoft OneDrive for Business.

Conditions

Add condition

Displays fields for defining a new condition.

 

 When

The start variable the operator compares with the value. Select a start event variable from the drop-down list. The File variable can't be used in conditions.

 

 Operator

Select how to compare the When variable and Value. The operators available in the drop-down depend on the When variable type. Example: in the condition 'Name contains marketing', the operator is contains.

 

 Value

The text or variable that the operator compares with the When variable. Type to enter text. The variable type must match the When variable type. Example: in the condition 'Name contains marketing', the value is marketing.

 

Add

Saves the condition to the start event.

 

Cancel

Discards the condition you are editing.

 

all/any

If you select:

  • all: then all conditions must be true for the workflow to start.
  • any: then at least one of the multiple conditions must be true for the workflow to start.

 

(Edit condition)

Redisplays condition fields for editing.

 

(Delete condition)

Deletes the indicated condition.