Creating a Single Step Workflow

From SmartWiki
Revision as of 09:39, 15 June 2016 by Ciaran Donnelly (talk | contribs) (Saving the Workflow)

Jump to: navigation, search


Overview

Single step workflows are useful for creating alert type messages. Some examples of where you may consider using single step workflows would be to:

  • Alert a sales person when a customer adds a file to the system.
  • Get an alert when a new contact is added to the database.
  • Send a copy of a new file to your customer, by simply adding the file to a folder.
  • Send a confirmation message to a new customer when they are added to the system.
  • Trigger an e-mail alert when someone registers on your website for information.


Navigating to the Workflow Options Page

  1. Under the Configuration menu, click on Workflows
  2. The Workflows options page will be displayed


Creating an Acknowledgment Workflow

In this example you will create a workflow that sends an alert when a contact is added to a company.

1. Click the New Workflow button.

WFTask.png


The New Workflow window is displayed.

WorkFTask2.png


Setting the Workflow Type

SmartSimple provides the ability to attach a workflow to many different objects. If you do not select the correct type, the workflow name will not be listed when you attempt to connect the workflow to the object.

1. Click the Workflow type combo box. The workflow object types are listed.

WFTask3.png

See Workflow Types for details.


This workflow will be attached to a company, but will trigger only when a contact is added to that company.

2. Set the Workflow type to User.

3. Set the Name to New Contact Added.

4. Set the Description to A new contact has been added to the system.

Setting the Trigger Type

The Workflow trigger determines when a new instance of the workflow should be started.

  • The New option will only trigger when a new object is created. In this example, when a new user is added to the company.
  • The Modified option will trigger the workflow when an existing object is changed.
  • The On Demand option will trigger the workflow when called by a System Call or a browser script.

The default New option is correct.

WFTask4.png

Saving the Workflow

It is necessary to save to workflow details before you can add any tasks.

1. Click the Save button.

WFTask6.png

The workflow is saved.

WorkFTask5.png

The Workflow ID is now populated and the following options appear along the top of the screen:

  • Back – click this tab to return to the previous page accessed.
  • Workflows – click this tab to return to the workflow list.
  • New Task – click this tab to create a new workflow task.
  • Diagram – click this tab to see a diagram view of the workflow.


The following tabs are also displayed:

  • Task – click this tab to view workflow task and to edit tasks. Tasks are steps within the workflow.
  • Pending Queue – click this tab to see a list of outstanding tasks for this workflow, to delete certain tasks and to reassign tasks to other contacts within the system.
  • History - click this tab to see a list of completed tasks for this workflow.

Create New Task

In this article you will add the step to the workflow and connect that step to the start and complete.

The Task List is displayed.

WorkFTask7.png

Note the Start and Complete entries, plus the connector for the start step.

1. Click the New task button.

WFTask8.png

The Task details are displayed, with a Task Number initially set to 10 and increasing in increments of 10 for each subsequent workflow task.

WorkFTask8.png

The first thing to do is to select the Task Type. The list of available Task Types is controlled by the workflow type.

WorkFTask10.png

The type selected will then control the properties available within the task. The general options available to all Task types include:

  • Name - Narrative name for the task.
  • Task Type - Acknowledge, process, complete, and move type tasks. See below.
  • Task Number - A system generated number that determines the presentation order of the task in the workflow. This number can be changed to display the step in a different location.
  • Description - Detailed description of the task.
  • Expire After - Intended duration of the workflow.

There are a number of other settings specific to the Task Type selected. These are covered in the individual entries specific to each [[Workflow Task Types|Task Type].


2. Set the Name of the Task as appropriate.

3. Populate the Description field if required.

4. Click Save at the bottom of the page.

5. Click on the Back button to return to the Edit Workflow screen.

6. The Task will be listed but there will be no Connectors, so the task will not be executed if the workflow was triggered.

WorkFTask11.png

Connecting Tasks

The task is a steps that must be executed when the workflow is triggered. However, all tasks must first be connected to other tasks or to the start and complete before they will be executed.

1. Click on the New option in the row preceding the task you wish to connect. In the example below the preceding task may be the Start option, but it could also be a preceeding Task.

WorkFTask12.png

2. The New Connector screen launches with number of options.

WFTask13.png
  • Name: Free text field to enter a descriptive name for the connectro
  • Trigger Type: drop-down with Default or Expired options
  • Connect To: drop-down allowing you to select what you want to connect to. All tasks within the workflow will be listed. along side the Start and Complete options. Also, there will be a list of other workflows in the system.
  • Trigger Date: drop-down allowing user to specify whether the task should be triggered on the day it was called, or based on a date field within the entity (i.e. level one, contact, etc.) that the workflow was triggered from.
  • Delay(s): user can specify any delays based on the trigger date.
    • If the value 1 was entered here then the task would be triggered one day after the defined Trigger Date.
    • If the value -1 was entered here then the task would be triggered one day before the defined Trigger Date.
    • If the value 0 was entered here then the task would be triggered on the defined Trigger Date.
  • Business Day Only: If this is checked then the triggering based on dates and delays will take into account the normal working week, and statutory holidays
  • Holiday Calendar Used: drop-down list to allow users to select their own calendars. Primarily used when the normal Business Day Only option is insufficient
  • Required Respondents: If there is an action required then you can specify how many people must complete this action before the workflow moves on to the next task.
  • Condition: field to define conditions under which the connector will bypass the proceeding task The field allows the use of variables.

3. Complete as appropriate and click Save sat the bottom of the screen.

4. Now click on the New option in the row for the task you wish to connect and try and connect to a proceeding task, the Complete option or to another workflow entirely. Click Save when finished.

5. Click Save at the bottom of the Edit Workflow screen once all connectors have been defined. When the page refreshes then the connectors should be displayed.

WorkFTask14.png

Configure System to display Workflow options

  • the user creating the workflow must have permission to set company workflow trigger.

Go to - Roles & Permissions - Manager Permissions, Under permissions, click on Workflows - Attach Workflow to Company.

100504 workflow manager permission.jpg


100504 workflow manager permission 01.jpg

- select the role that will be triggering the workflow.

- once the role is selected, the options will display in the edit company view.
100504 workflow manager permission 02.jpg





Previous.png Workflow Types Adding a Workflow Task in an Acknowledgment Workflow

Next.png