Form Notifications, Departments, and the HSE Dashboard
When a form is submitted in EZ Ops, three things can respond to it:
- Workflows - Rules you add to a form that send an email or create a task when it is completed.
- The HSE Dashboard - A review queue where supervisors and HSE reviewers work through submitted Health & Safety, Custom, and Causal Analysis forms.
- Automatic emails - Emails EZ Ops sends on its own at certain points, such as when all corrective actions on a form are done.
All three decide who is a supervisor for a submitted form the same way: through departments. This article explains that rule, how to set departments up, and how the HSE Dashboard works.
Who Counts as a Supervisor for a Submitted FormA user is a supervisor for a submitted form when:
- The form has a department - The department on the submitted form, which comes from the form's default department.
- They are ticked as Supervisor in that department - Being a member is not enough.
- They are assigned to the location, if the department has Location Limit on - Through a plant, field, or run that covers the location where the form was submitted.
That decides who can approve pending workflows and complete the Supervisor Review phase in the HSE Dashboard, who gets the HSE Dashboard link in workflow emails, and who receives the automatic supervisor emails.
If the form has no department, nobody is a supervisor for it. Workflow emails set to department options send to no one from the department, nobody can act on it in the Supervisor Review phase, and the automatic supervisor emails reach nobody. Give every form that uses workflows or the HSE Dashboard a default department.
There is no per-location Form Supervisor setting any more. Supervisor status comes only from departments. The location checkboxes on a user's Assigned Locations panel — Out Of Spec Emails, Log Book Supervisor, Office Supervisor, Costs Admin — do not make someone a form supervisor.
How the Location Is Matched
When a department has Location Limit on, a user must be assigned to the submission location:
- Form submitted at a plant - The user is assigned to that plant, to the plant's field, or to a run that includes the plant.
- Form submitted at a well - The user is assigned to the well's plant, to the well's field, or to a run that includes the well.
- Form with a custom location, or no location - There is no tracked location to match. For the automatic supervisor emails, every supervisor in the form's department receives them. In the HSE Dashboard and for the dashboard link, a location-limited department has no supervisor for that form.
- Open Departments - Org Configuration > Users & Roles > Departments.
- Click Create New Department - Enter a Name.
- Decide on Location Limit - Tick Location Limit if people should only be notified about, and act on, forms from locations they are assigned to. Leave it off if department membership alone should be enough.
- Save the department - It appears in the list.
- Open the department - Click the arrow in the Configure column.
- Click Add Users To Department - Choose users under Users to add: and click Add. Everyone is added as a member.
- Tick Supervisor for your supervisors - In the department's user list. Supervisor status is only used for workflow notifications and form review.
You can also manage a user's departments from their own user page: Org Configuration > Users & Roles > Users, open the user, and use the Assigned Departments panel. Tick Assigned, then Supervisor if needed, and click Save.
Then set the form's default department. Open the form in Org Configuration > Forms, go to Form Info, and choose Select default department.
Who Can Work the HSE Review PhaseThe HSE Review phase is handled by users with the HSE Admin setting turned on. Set it on the user's page under Org Configuration > Users & Roles > Users. HSE Admin users also receive the "HS&E review required" and department changed emails, and are the only users who can delete a form from the dashboard.
What Is the HSE Dashboard?The HSE Dashboard is the review queue for submitted Health & Safety, Custom, and Causal Analysis forms. It is where supervisors approve pending workflows, add corrective tasks, and sign off their review, and where HSE Admin users do the final review.
A form only appears in the dashboard if it has Supervisor Review or HSE Review turned on. Set these on the form's Form Process tab. A form with neither never appears, whatever its type or department.
Where to Find It
Reports > Forms group > HS&E Dashboard. The menu link needs the organization's HSE forms module turned on and the HSE Forms role permission. The page opens for users with Employee or Admin access and either the HSE Forms or Custom Forms role permission. Report Viewer accounts cannot open it.
How the Dashboard Is Organized
- Phases - Initial Reporting / Draft (not yet completed), Supervisor Review, and HSE Review. Choose a phase to see the forms in it.
- My Responsibility / Others Responsibility - Switches between forms waiting on you and forms waiting on someone else.
- Reviewed and Closed - Forms that have finished review. They leave the main list but stay available here.
Whose responsibility each phase is:
| Phase | Waiting on |
|---|---|
| Initial Reporting / Draft | The person who started the form |
| Supervisor Review | Supervisors for the form (see Who Counts as a Supervisor) |
| HSE Review | Users with HSE Admin turned on |
- The form is completed - It moves to Supervisor Review if that is turned on for the form, otherwise to HSE Review. Workflows run at this point; any with Approval Required wait as pending.
- Supervisor Review - A supervisor approves or cancels pending workflows, adds corrective tasks if needed, and clicks Complete Supervisor Review. That button only works once nothing is pending or outstanding.
- HSE Review - An HSE Admin user reviews the form and clicks Mark as reviewed. It is disabled while a corrective task is still outstanding. If the form does not use HSE Review, completing Supervisor Review closes it instead.
- Reviewed and Closed - The form leaves the main list.
Sending a form back: Kick back to Supervisor Review Phase returns a form from HSE Review to Supervisor Review, with a message to the supervisors (Kick back & Send Message). Put back to HSE Review Phase reopens a reviewed form for HSE Review; it is for HSE Admin users.
Actions on a Form
- View Form / Edit Form - Supervisors and reviewers can edit; others only while the form is a draft.
- Create Task - Adds a corrective task to the form. Uses your organization's name for tasks if it has been renamed.
- Cancel Form and Workflows - Deletes the submitted form and its workflows. It does not just cancel them. Supervisors, in Supervisor Review.
- Delete Form - HSE Admin users only.
- New Causal Form Log - In the form's Causal Analysis section. Starts a Causal Analysis form linked to this form, for root-cause investigation.
Actions on a Workflow
Each workflow waiting on the form shows its email or corrective action:
- Approve Event - Sends the email or creates the task. Shown while it is pending.
- Cancel Event - Closes it without sending anything.
- Edit Message - Changes the email or task text before you approve it. Supervisors only.
- Delete Corrective Action - Removes a corrective action and its task.
- Complete Task / View Task - On a corrective action's task.
A workflow that both emails and creates a task shows two items, and each must be approved separately.
Common Issues"A form isn't showing in the HSE Dashboard"
- Turn on Supervisor Review or HSE Review on the form's Form Process tab. Only Health & Safety, Custom, and Causal Analysis forms appear.
- Check Reviewed and Closed — finished forms move there.
"A supervisor can't approve anything, or doesn't see forms under My Responsibility"
- The form needs a department — check Select default department on the form.
- They must be ticked Supervisor in that department.
- If the department has Location Limit on, they must be assigned to the plant, field, or run covering the submission location.
"Nobody is getting the supervisor emails"
- The form has no department. Set a default department on the form.
"Supervisors are getting emails for forms from other sites"
- If the form had no location, the automatic supervisor emails go to every supervisor in the form's department. Turning on Location Limit does not change that case, so require a location on forms that use these emails.
"Nobody can complete the HSE Review"
- Turn on HSE Admin for the people who do HSE reviews.
"We used to set Form Supervisor on a user's location — where did it go?"
- It was removed. Tick Supervisor for the user in the form's department instead, and turn on Location Limit on the department to keep it site-specific.
- Give every reviewed form a default department - Without one, nobody is its supervisor and no supervisor emails go out.
- Use Location Limit for site-based supervisors - Then supervisors only see and receive forms from the locations they are assigned to.
- Turn on Supervisor Review before using Approval Required - Without it, workflows that need approval fire immediately.
- Give HSE Admin to your HSE reviewers only - It controls the HSE Review phase and form deletion.
Remember: Cancel Form and Workflows deletes the submitted form and its workflows — it does not just cancel the review.