Configuring Workflows

<< Click to Display Table of Contents >>

Navigation:  NITRO™ Workflows >

Configuring Workflows

 

When the NITRO Workflows app opens you will see this screen which shows any existing workflows and allows you to create new workflows. Note you must select the site for the workflows you want to see in the dropdown. To edit a workflow click the pencil icon on the line of the workflow you want to edit. To create a new workflow follow the instructions below.

 

WF Configured Workflows

 

Create a New Workflow

To create a workflow click on the New Workflow button to open the Create/Configure screen, and follow the steps below.

 

Workflow Settings

1.Enter a unique Workflow Name.

2.Select the site that contains the list you want to start the workflow from.

3.Select the source list for the workflow.

4.Enter in a description for the workflow for future reference, if desired. This description can later be shown using the clip0829 icon for the workflow on the main Workflow screen.

 

create workflow 1

 

When to Start the Workflow

Next you will select the type of event that triggers your workflow. Workflows can be triggered based upon data conditions such as list item creation, item update, and item deletion, or they can be be triggered by time (e.g. run at a certain time of day or time interval.) You can also set conditions to further limit when the workflow is triggered.

WF Triggers

 

Data-based events can occur when

1.an item is created - triggered when a new item is added to selected list

2.an item is modified - triggered when an existing item is modified in the selected list

3.an item is deleted - triggered when an existing item is deleted in the selected list

Time based events can be setup at a time before or after an item is created, modified or deleted, or they can be set to repeat at some interval.

In the example below the workflow timer runs every 30 minutes, and all the workflows defined to be run in the past 30 minutes are evaluated. Note a workflow cannot run more frequently than every 30 minutes.

Repeat every - if this option is checked then the workflow will run repeatedly at the specified interval until the number of times has been met. In this example the workflow runs every 30 minutes for 10 times then will stop.

WF Time

Run during business hours only - If this check box is checked, the workflow will be triggered only in O365 site business hours.

Process this workflow for items created/modified/deleted by this App. If this check box is checked then Events will trigger when item is created through an app.

Delay Execution:  Enter a number between 1 and 30 to delay the execution of this action up to 30 seconds.

Process this workflow for items created/modified/deleted by automated processes. If this check box is checked then the workflow will execute when the defined triggering event is set off by an app or custom code. You must use caution with this feature and ensure you don't set off a sequence of  workflows with unintended consequences. If you do NOT check this checkbox, then then workflow will only execute when users create, modify or delete item data according to the defined trigger conditions.

 

Conditions

Conditions that trigger your workflow can be narrowed to one or more column values. When you click on AND or OR you can select the field you want and set the comparison value based on its datatype as shown below.

clip0378

For example you may automatically update a list where certain fields are empty, contain a specific task type value, or where a date has been exceeded.

clip0380                        

 

clip0381

For more on Conditions, click here.

 

What Actions to Execute for this Workflow

Once you have setup the conditions that will trigger your workflow, you can define the actions that will take place. Actions include Create, Update, Delete and Move items, Send Mail, and more technically complex functions like Query List, Worflow Variable and Manage Permission. For details on how to use each of these features, see Workflow Actions.

 

When to Execute this Action

Conditions

Here you can use Conditions in a similar manner as they would be used on the event trigger. See the section on Conditions above or click here for more details.

General Settings

Here you define a name for your action and set relevant target info as needed. This will vary by action type so refer to the section for the action you are defining for details. See Action Types section above.

Column Mappings

Column Mappings are used with Create Item and Update Item actions. This section allows you to define the values that will go into the fields/columns of the list you are creating or updating. For each column you will set the value in one of the following ways:

a literal value

a column value mapped from your source list

a placeholder value

a function

Once you set the column value, hit the Update key and continue defining any subsequent column values you want following the same process.

 

clip0383

Define value for a specific column.

clip0382