Incidents
Report workplace incidents, capture category-specific details, assess actual and potential severity, and manage investigation and close-out with linked follow-up records.
Use the Incidents module to report workplace events, capture the details that matter for the incident type, assess severity, and manage investigation and close-out activity in one place.
This module is configured for more than injury reporting alone. The current setup supports incident outcomes such as community complaints, environmental events, equipment damage, injuries, near misses, production events, psychosocial events, security events, vehicle-related events, and violence or abuse.
Access to some sections and actions depends on role. In particular, there are some restrictions on the User after the initial incident is logged, with some sections only visible or editable by an Admin role.
What you can record
Depending on the incident type and where the record is in the workflow, an incident can include:
- the
Reporting Person - the
Date Reported,Date Occurred, and optionalTime Occurred - the incident
Location - a short
Brief Description - one or more
Classification (Outcomes)values - whether the incident was
Work Related - whether a
Third Partywas involved - detailed narrative in
Details - immediate controls, witnesses, and linked records
- actual and potential severity ratings
- regulator reporting details
- investigation dates, team members, event sequence, contributing factors, root causes, recommendations, and cost
What you must complete depends on the current status and your role.
When you first log an incident in Draft, the required fields are:
Reporting PersonDate ReportedDate OccurredBrief DescriptionClassification (Outcomes)Work RelatedThird Party InvolvedDetails
Reporting Person defaults to the current user, and both Date Reported and Date Occurred default to today.
Some specialist sections also introduce their own required fields when they become visible in Draft. For example, Linked Injuries is required when the incident is classified as an injury, and the psychosocial and violence-and-abuse sections include their own mandatory questions.
If the incident is later moved into Open, additional follow-up sections become available, including Specifics and Define Incident. In that stage, the required severity/reportability fields are:
Actual Incident SeverityPotential/Worst Case Incident CategoryExternally Reportable?
Severity-dependent investigation sections may also appear later. Access to those sections is role-based, and for the standard User role they are view-only rather than editable.
Incident workflow
The live workflow currently uses these statuses:
Draft: the initial incident logging stageOpen: a follow-up stage used after an admin reopens the incident for more workClosed: the read-only end state for logged or completed incidents
The configured progression is:
- Create the incident and start in
Draft. - Complete the sections that are available in
Draftand selectLog Incident. Log Incidentmoves the record directly toClosed.- If the record needs more work later, an admin can use
Re-Opento move it intoOpen. - From
Open, an admin can useClose Off and Archiveto return it toClosed.
Important access notes:
- there is no normal save-in-draft button in this workflow;
Log Incidentis the draft-stage action Re-OpenandClose Off and Archiveare not available to the standardUserrole- if you cannot change the record status yourself, an admin must handle the workflow transition
Creating an incident
To create a new incident:
- Open the
Incidentsmodule. - Create a new record. It opens in
Draft. - Confirm the reporting details such as
Reporting Person,Date Reported,Date Occurred, andLocation. - Enter a clear
Brief Descriptionand the main incidentDetails. - Select one or more
Classification (Outcomes)values so the relevant specialist sections appear. - Complete any visible specialist sections that apply. For injury incidents, use
Log NewinInjury Reportsto create the injury record from inside the incident workflow. - Add any attachments you want included with the initial report. For the standard
Userrole, attachments are only editable while the incident is still inDraft. - Select
Log Incidentto submit the record. The incident will move toClosed. - If more follow-up information is needed later, an admin can
Re-Openthe incident. InOpen, access depends on role. The standardUserrole can update specialist sections,Specifics, andDefine Incident, but not the originalReportsection or the investigation-only sections.
Classification-driven sections
One of the key features of this incident form is that the record expands based on the selected incident outcomes.
Depending on the chosen Classification (Outcomes), the form can show extra sections such as:
Third Party DetailswhenThird Party Involvedis set toYesComplaint Detailsfor community complaintsEnvironmental Impact Detailsfor environmental incidentsEquipment Detailsfor equipment-related incidentsInjury Reportsfor injury events, withLinked Injuriesand aLog Newaction that opens the internalInjuriesformVehicle Detailsfor vehicle incidentsViolence and Abusefor aggressive or abusive incidentsProduction,Near Miss,Security, andPsychosocialsections for those incident categories
This lets one incident module support a wide range of event types without forcing every record to show every question.
These specialist outcome sections are the main expandable parts of the initial incident log. If the record is later moved into Open, additional follow-up sections such as Specifics and Define Incident also become available. For the standard User role, the investigation-only sections still remain read-only.
Recording injury details
When Classification (Outcomes) includes Injury, the Injury Reports section becomes available and Linked Injuries becomes mandatory.
Use Log New to create an injury record from within the incident. The linked form sits inside the same incidents module, so injury details can be managed in context rather than through a separate external module.
The internal Injuries form captures information such as:
Injured Personand optionalDate of BirthDate of Injuryand optionalTime of InjuryInjury Classificationsuch asFirst Aid,Medical Treatment,Lost Time, orFatalityNature of Injury,Mechanism of Injury, andBody Part AffectedBrief Description of InjuryTreatment ProvidedInjury Manager
In practice, this means you can report the main incident, create one or more linked injury records as needed, and keep the incident and injury information connected for investigation, follow-up, and reporting.
Access by status
Draft is the initial logging stage. This is where the incident is first created, the Report and Details sections are completed, and the visible outcome-driven sections are filled in as needed. Log Incident is the action that submits the record from this stage.
Open is the follow-up stage used after the incident has been reopened for more work. Additional sections such as Specifics, Define Incident, investigation areas, and associated records become available here.
Closed is the end state for submitted or completed incidents.
Access inside those statuses depends on role. Admins can edit the full record and handle the workflow transitions. The standard User role can submit from Draft, can read the full record once it exists, and can update selected sections in Open, but cannot reopen, close off, edit attachments after draft submission, edit the original Report section in Open, or complete the investigation-only sections.
Key fields
Reporting and summary
Reporting Person: who is lodging the incidentDate Reported: when the incident was reportedDate Occurred: when the event happenedTime Occurred: optional time of the eventLocation: where it happenedBrief Description: the short summary used in lists and notificationsDetails: the main narrative of what occurred
Basic incident classification
Classification (Outcomes): one or more incident outcome categories that control which specialist sections appearWork Related: whether the incident is work relatedThird Party Involved: whether an external person or organisation was involved
When Third Party Involved is set to Yes, the form can capture Third Party Name, address, telephone, and comments.
Severity and reportability
Actual Incident Severity: the assessed severity of what actually happenedPotential/Worst Case Incident Category: the potential or worst-case severity if the event had ended differentlyExternally Reportable?: whether the incident needs to be reported outside the organisationBody Reported To: who it was reported toDate Reported On: when that external report was made
These fields sit in Define Incident, which becomes available in Open. For the standard User role, that means they are not part of the initial Draft submission.
This setup helps separate the real outcome from the possible consequence, which is useful for learning from near misses and lower-consequence events that still had serious potential.
Investigation and cause analysis
The investigation area supports:
Investigation Start DateInvestigation TeamSequence of EventsWitness StatementsImmediate Contributing FactorsRoot CausesRecommendationsCost
In the current configuration, these investigation sections are shown conditionally based on the selected severity, so not every incident has to follow the same level of investigation.
These sections are intended for investigation follow-up rather than the initial incident log. For the standard User role, they can become visible on the record but are not editable.
Linked records
The form can connect an incident to other records through:
Linked InjuriesAssociated ActionsAssociated Hazards
Vehicle-related incidents also have their own Vehicle Details section.
Access to linked-record areas depends on role. Linked Injuries can be managed while logging or updating the incident. Associated Actions and Associated Hazards sit in a read-only section for the standard User role.
For injuries, this is more than a simple cross-reference. Log New opens the internal Injuries form so the injury record can be created and linked from the same overall incident process.
Managing the investigation
Once the incident has been reported, the module can be used to:
- review the incident after submission, even when it is
Closed - update details and specialist sections as facts are confirmed
- complete
SpecificsandDefine Incidentduring follow-up - create or link injury records through
Injury Reports - document investigation notes, causes, recommendations, and associated records during follow-up
Exactly which of those actions you can perform depends on role. For the standard User role, investigation writing, associated action or hazard linking, attachment updates after submission, and workflow changes are handled elsewhere.
Notifications and lists
The current configuration includes notification templates for key events such as new incidents, reassignment-related changes, closing, and reopening. In practice, this means the module can be used to keep the right people informed as the incident progresses.
The incident list is configured to surface key information such as:
Brief DescriptionDate OccurredDate ReportedClassification (Outcomes)
Additional fields such as severity ratings can also be made available in list views, which helps teams monitor incident patterns and review workload.
Common questions
Why can't I just save the record and come back later?This workflow does not expose the normal save-in-draft action. The main draft-stage action isLog Incident.Why did my incident move to Closed as soon as I selected Log Incident?Because the current workflow sendsDraftdirectly toClosed. TheOpenstatus is only used if an admin later reopens the record for more work.Why can't I see Specifics or Define Incident when I first create the record?Those sections belong to theOpenfollow-up stage, so they are not part of the initialDraftview.Why can't I change Reporting Person, Date Occurred, or the other Report fields later?If you are on the standardUserrole, theReportsection is only editable while the incident is still inDraft.Why can't I add attachments after logging the incident?If you are on the standardUserrole, attachment editing is limited toDraft.Why can't I complete Investigation, Root Causes, or Recommendations?Those sections can appear on the record, especially for more serious incidents, but they are read-only for the standardUserrole.Why can't I see some sections?Sections appear only when their trigger conditions are met. For example,Third Party Detailsappears whenThird Party InvolvedisYes, the incident-type sections appear when the matchingClassification (Outcomes)value is selected, and the investigation sections depend on severity.
Tips for better incident records
- Write the
Brief Descriptionso the incident is understandable in lists and emails without opening the record. - Choose every relevant
Classification (Outcomes)value so the correct specialist sections appear. - Add any attachments before you select
Log Incident. If you are on the standardUserrole, you cannot edit attachments afterward. - If the incident is reopened into
Open, useActual Incident SeverityandPotential/Worst Case Incident Categorydeliberately; they answer different questions. - Complete external reporting details only when the incident is genuinely reportable and your role has access to
Define Incident. - Use
Log NewinInjury Reportswhere needed so linked injuries are created from the incident context with better traceability. - If you need the status changed, the report header corrected, or investigation-only sections updated and your role cannot do that directly, ask an admin or other responsible person with that access.