Start event configuration panel

In the Start event configuration panel, you can configure when or how your workflow starts. You can specify connections, select variables to add to your workflow, and set conditions. The panel appears when you click on the Start event on your designer canvas.

Open the Start event configuration panel

1. Open the Designer canvas.

2. If the Start event configuration panel does not open automatically, click Start event on the canvas.

Configure the start event

Configure your workflow to start when an event occurs in Nintex or in one of your connections. For example, a workflow can be triggered to start when a new file is uploaded to your Box account.

Caution: After you have selected and configured your start event and you begin designing the workflow and using start event variables in any of your actions, you can no longer change Start from and Event.

In the Start event configuration panel:

1. In Start from, select a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. or a Nintex start event that will trigger the start of the workflow.
2. If you chose your workflow to Start from a connector, select an Event.

Additional fields appear that you can use to configure your start event.

Note: To view start event variables that are available for use throughout the workflow, click Show variables in the start event configuration panel. This list of start event variables is populated once you have selected which variables to add to the workflow. For more information, see Show variables.

3. Complete the new fields that appear.

   1. For Connection, select an existing connection from the drop-down list or click Add connection to create a new connection.

      Example: To create a Microsoft OneDrive for Business connection

      1. In the drop-down list for Connection, select Add connection.

      2. Type a Connection name.

      3. Type your OneDrive Tenant URL.
      4. Click Connect.

      The entered name is validated for uniqueness. If credentials are not stored in the browser for the selected connector service, then you are prompted for credentials. For more guidance on connections, see Connectors.

      5. Enter credentials, if prompted.

         Upon successful log in, you are prompted to grant or deny access to Nintex Automation Cloud.

      6. Click the option to grant access.

      A window appears where you can assign owner and user permissions to the connection. Add Owners and Users, if required.

      7. Click Save permissions.

      Your newly added connection now appears in the Connection field.

   2. If needed, complete the Path field (displayed for path-based connectors). If the folder browse icon () is displayed to the right of the field, then click it to navigate to the folder that you want. If no folder browse icon is displayed for the selected connector, then type the path, beginning with the root folder.

4. If needed, add or update 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. for your workflow design. Steps to add variables depend on the selected start event.

   • Third-party connector steps to add a start event variable

     For most third-party start events, variables are automatically generated, but need to be added if you plan to use them later in the workflow design.

     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 , and then click Show Details. Edit the variable name in the Name field or click .
        

   • Nintex - Component workflow steps to add a start event variable (workflow input)

     For Nintex - Component workflow, you can create your own variables to define workflow inputs Variable to store a value or file when the workflow starts. Set up as a start event variable..

     1. On the Designer canvas, click Start event.

     2. From the Start from drop-down list, select Component workflow.

     3. Click Create variable.
     4. If you have previously created a variable, click Create.
     5. Type a user-friendly Name for the new variable.

     6. Select the variable Type you want.

        Data types of variables

        Variable type	Usage
        Text	String value, such as John.
        Decimal	Decimal value, such as 1.2.
        Integer	Integer value, such as 1.
        Boolean	Boolean value (Yes or No).
        DateTime	Date or date and time value.
        Collection	Set of files or array of values.
        File	File.

     7. Click Create.

     Every start event variable is rendered as a workflow input and is available later in the workflow.

   • Nintex - Form steps to add a start event variable (form control A form part corresponding to a user-input field (such as a text field) or display-only item (such as a heading). accepting user input)

     For Nintex - Form, start event variables are automatically generated for every user-input form field you add to the form.

     1. On the Designer canvas, click Start event.

     2. From the Start from drop-down list, select Form.

     3. Click Design form to open the forms designer.

     4. Drag the control that you want onto the canvas. The control must accept user input for a start event variable to be generated.

     5. To change the internal reference name for the control: 
        1. Click the control to open its configuration panel.
        2. In the configuration panel, update the value for the following fields:

           • Title

           • Name. Prior to updating the Name, toggle on Customize.

     6. Close the configuration panel and forms designer.

        A start event variable is listed corresponding to the added control. Its name (Name) reflects the internal reference name set up in the control configuration.

5. If you want to cancel a start event variable from being added to the workflow, complete the following steps:
Nintex Form

For a variable corresponding to a form field, open the forms designer to remove the related form control from the form.

When you go back to the Start event configuration panel, variables for deleted controls with workflow references are highlighted.

1. In the Start event configuration panel, click Show variables.
2. In the Start event tab, click the name of the variable indicated with (warning flag).
3. Click and then click Resolve.
4. In the dialog box that appears:

• To remove all workflow references to the deleted control, click Remove all.
• To update workflow references to point to another control, click Replace all and then select the variable associated with the control you want to use instead.

Variables available for replacement are limited to those of the same type.

Other start events

Variables are available for you to select whether or not to pass to the workflow. If you want to cancel selection of a variable, complete the following steps:

Note: You cannot cancel selection of start event variables that are used in any actions in the workflow.

1. Click Show variables.
2. In the Start event tab, click the name of the variable.
3. Click Delete.

The variable is removed from the Start event tab. If you want to reselect the variable, click Add variables in the Start event configuration panel.

6. Define or update one or more conditions for starting the workflow if applicable to your workflow design (available for third-party applications.) 

   1. Find the Conditions section.
   2. For each condition: 

      1. Click Add condition.
      2. For When, select a start event variable. For example, select Created date for a new file.
      3. For Operator, select an operator for comparing the variable to the value. For example, select is before or on.

      4. For Value, type or select the value to use for the comparison. For example, select 2017-12-31, 11:59 PM.

      5. Type a Condition summary, if desired.

      6. Click Add condition.

         The condition is added to the start event.

   3. Select all or any to control how multiple conditions are evaluated.

Your start event is configured when all required configuration fields are completed.