Skip to content
English
  • There are no suggestions because the search field is empty.

Configuring Form Workflows

 What Is a Workflow?

A workflow is a rule on a form that runs automatically when someone completes that form. A workflow can send an email, create a corrective action task, or both. You can add as many workflows to a form as you need, and each one can be limited to fire only for certain answers.

Without a workflow, a completed form is saved and appears in the Forms Report, but nobody is emailed and no task is created.

Who can configure workflows: Admins.

Which forms can have workflows: Every form type except MOC and RIK, which have their own approval process and do not show the Work Flows tab.

Where to Configure Workflows
  1. Open Org Configuration from the top menu.
  2. Under Forms, click Forms (or Forms and Inspections if your organization uses inspections).
  3. Find the form in the Forms Config list and click the arrow in the Configure column.
  4. Open the Work Flows tab.
When a Workflow Runs
  • On completion only - A workflow runs when the form is fully completed. Save Progress does not trigger it. On a form with sections, it runs when the last section is completed.
  • Once per form - Editing a form after it has been completed does not run its workflows again.
  • Each workflow on its own - Every workflow on the form is checked separately. One workflow being skipped does not stop the others.
How to Create a Workflow
  1. Click Add New Work Flow - On the form's Work Flows tab.
  2. Enter a Description - Required. This is the name you and supervisors see in the workflow list and the HSE Dashboard; the person filling in the form does not see it.
  3. Tick Email to send an email - Then choose who receives it (see Who Receives the Workflow Email below), add any Always email addresses, and write an optional Email Message.
  4. Tick Corrective to create a task - Then write an optional Corrective Message for the task.
  5. Tick Approval Required (optional) - Holds the workflow until a supervisor approves it. See Approval Required below — it only works when the form has Supervisor Review turned on.
  6. Click Create - The workflow appears in the list.
  7. Open the workflow to finish setting it up - Click the workflow's row. The tabs Edit WorkFlow, Validations, Responsibility RoleGroups, and Questions to add to Emails/Tasks let you change the settings, limit when it fires, add recipients by role, and choose which answers to include.

You can tick both Email and Corrective on the same workflow. When it fires, it sends the email and creates the task. If neither is ticked, the workflow does nothing.

The workflow list shows each workflow's Description, Send Email, Corrective Action, Approval Required, and Number of Validations.

How to Make a Workflow Fire Only for Certain Answers

Use the Validations tab. A workflow with no validations fires every time the form is completed.

  1. Open the workflow and go to Validations.
  2. Click Add New Validation.
  3. Select a Question - Only single-choice questions (radio buttons and dropdowns) can be used.
  4. Tick the Expected Answer options - The validation passes when the person picks any one of the answers you tick.
  5. Click Create.

How several validations combine:

  • All validations must pass for the workflow to fire. If any one fails, that workflow is skipped for that submission.
  • To fire on one answer OR another on the same question, tick both answers in one validation — for example, tick High and Critical on a Severity question.
  • To do different things for different answers, create a separate workflow for each, each with its own validation and recipients.
  • An unanswered question fails its validation. If the question is optional and the person skips it, the workflow does not fire.
What the Workflow Email Contains

Every workflow email is built in this order:

  1. Email Message - The text you wrote, in bold. It is also added to the email's subject line. Left out if blank.
  2. Submission details - Always included: Form submitted by: with the person's name, At: with the date and time, and Location:.
  3. Answers - The questions you chose on the Questions to add to Emails/Tasks tab, each with its answer and any comment the person added. Questions with no answer are left out.

If you choose no questions, the email uses the questions on the form marked Send response in emails by default instead. To mark one, open the form's Questions tab, edit the question, and tick Send response in emails by default. If a workflow has no questions chosen and no question on the form is marked, the email contains only the Email Message and the submission details.

On the Questions to add to Emails/Tasks tab, click Add Link, pick a question under Select a Question, and click Add Question. Drag the Linked Questions into the order you want them to appear.

Which Link the Email Contains

Each recipient gets a link to the submitted form:

  • HSE Dashboard link - When the form has Supervisor Review or HSE Review turned on and the recipient is a supervisor for that submission, so they can act on it directly.
  • Forms Report link - Everyone else, including every Always email address.

A supervisor for a submission means a user marked Supervisor in the form's department. If that department has Location Limit turned on, they must also be assigned to the location where the form was submitted.

What the Corrective Action Task Contains

When Corrective is ticked, the workflow creates a task at the location where the form was submitted, with the status Outstanding. The task description contains, in order:

  1. The form's name and ID, in bold
  2. The location's legal land description
  3. Your Corrective Message, in bold
  4. The same answers as the email — the chosen questions, or the Send response in emails by default questions if none are chosen

Who the task is assigned to:

  • No approval needed - The person who completed the form.
  • Approval Required - The supervisor who approves it.

The person assigned and the person whose action created the task are both emailed about the new corrective action.

Who Receives the Workflow Email

Recipients come from three sources, added together. Anyone who qualifies through more than one source receives the email once.

1. The Form's Department

Choose an option under Send to department members? It only appears when your organization has departments, and it only works when the submitted form has a department — set one with Select default department on the form's Form Info tab.

Option Who receives the email
None Nobody from the department
All Department Supervisors Users marked Supervisor in the form's department
All Department Members Everyone in the form's department, supervisors included
All Supervisors and Department Members Everyone in the form's department, plus the supervisors of every department in your organization
All Supervisors The supervisors of every department in your organization

Location Limit narrows it to the site. When the form's department has Location Limit turned on, All Department Supervisors and All Department Members only include people assigned to the location where the form was submitted, through a plant, field, or run. In All Supervisors and Department Members, only the department-members half is narrowed. All Supervisors always covers the whole organization.

To mark someone as a department supervisor, open Org Configuration > Users & Roles > Departments, click the arrow in Configure on the department, and tick Supervisor next to their name.

2. A Role (Responsibility RoleGroups)

On the Responsibility RoleGroups tab, click Add Responsibility Role, choose a role under Make Role Responsible For WorkFlow, and click Add Role. Despite the name, this only adds people to the email — it does not make them responsible for anything or give them a task.

  • All [role] - Everyone in your organization with that role, for example All Operator or All HS&E Coordinator.
  • For Location [role] - People with that role who are assigned to the location where the form was submitted.

The roles offered are Operator, Foreman, Drilling, HS&E Coordinator, Office Staff, and Office Executive. Add one role per workflow — if a workflow has more than one, only one of them adds recipients.

The list also shows For Location Log Book Supervisor and For Location Office Supervisor. These do not add any recipients.

3. Always Email

Enter email addresses separated by commas. They receive every email from this workflow, whatever the other settings, and do not need to be EZ Ops users. An address that is not a valid email address is ignored.

An email with more than 50 recipients is sent to each person individually rather than as one group email.

Approval Required

Approval Required holds a workflow until a supervisor approves it.

  1. The form is completed.
  2. The workflow waits as pending — no email is sent and no task is created.
  3. It appears on the form in the HSE Dashboard, where a supervisor for that submission can review it, change the message if needed, and approve it.
  4. Once approved, the email sends and the task is created. The task is assigned to the approving supervisor.

If a workflow both emails and creates a task, each one waits for approval separately.

Approval Required only works when the form has Supervisor Review turned on. Supervisor Review is on the form's Form Process tab. Without it, there is nowhere for the approval to happen, so EZ Ops approves the workflow automatically and it fires straight away.

Common Workflow Setups

Email the local supervisor every time the form is completed

  • Tick Email, choose All Department Supervisors, no validations
  • Set a default department on the form, turn Location Limit on for that department, and tick Supervisor for the right people
  • Make sure each supervisor is assigned to the plants, fields, or runs they cover

Email everyone at the site

  • Tick Email, choose All Department Members, and turn Location Limit on for the department

Email only for serious answers

  • Add a validation on the Severity question and tick High and Critical

Different people for different severities

  • Create two workflows, each with its own validation and its own recipients

Create a follow-up task when a problem is reported

  • Tick Corrective and write the instruction in Corrective Message
  • Add a validation on the question that identifies the problem — for example Deficiency Found = Yes
  • Add the questions that describe the problem on Questions to add to Emails/Tasks

Hold everything until a supervisor signs off

  • Tick Approval Required, and turn on Supervisor Review on the form's Form Process tab

Always copy a corporate safety inbox

  • Add the inbox under Always email
Common Issues

"The workflow fires on every submission"

  • It has no validations. Add one on the question that should decide it.

"The workflow never fires"

  • Check the validations. Every one must pass, and an unanswered question fails.
  • If Approval Required is ticked, look for the workflow waiting as pending in the HSE Dashboard.
  • Editing a form that was already completed does not run its workflows.

"Approval Required is ignored — it fires straight away"

  • Supervisor Review is not turned on for the form. Turn it on in the form's Form Process tab.

"The email is empty apart from who submitted it"

  • No questions are chosen on the workflow and no question on the form is marked Send response in emails by default. Add questions to the workflow, or mark the form's key questions.

"A supervisor isn't receiving the email"

  • The submitted form must have a department. Check Select default department on the form's Form Info tab.
  • The person must be ticked as Supervisor in that department — being a member is not enough for All Department Supervisors.
  • If the department has Location Limit on, they must be assigned to the location where the form was submitted.

"The wrong people are receiving the email"

  • Check all three sources: the Send to department members? option (and whether All Supervisors reaches every department), the role on Responsibility RoleGroups, and the Always email list.

"The email links to the Forms Report instead of the HSE Dashboard"

  • The dashboard link only goes to supervisors for the submission, and only when the form has Supervisor Review or HSE Review turned on. Everyone else, including Always email addresses, gets the Forms Report link.
Tips & Recommendations
  • Name workflows by what triggers them - "Severity High — email supervisor" is easier to audit later than "Email workflow 1", and the description appears in the HSE Dashboard.
  • Mark the key questions Send response in emails by default - Then any workflow without its own question list still sends a useful summary.
  • Use Always email for fixed inboxes only - It ignores location, so site-specific recipients belong in the department or role settings.
  • Test with a real submission - Complete the form yourself and check the email arrives, contains the right answers, and links where you expect.

Remember: Approval Required only holds a workflow when the form has Supervisor Review turned on — without it, the workflow fires immediately.