InnerWeb
Skip to main content

Seven-step work permit wizard: implementation

The seven-step permit wizard works well only when the plant has prepared the data that each step draws on. We describe what must be ready before issuers start: locations, work types, templates, risks and notification recipients, and the pitfalls that appear in the first weeks.

7
steps of the permit wizard
Source: karta
3 and 2
items cleared when changing the company and the location
Source: karta

Seven steps and where each one gets its data

The new permit wizard has seven steps: basic data, hazardous work, tasks, risks, team, notifications and summary. Each of them draws on configuration that someone has to enter beforehand. When it is missing, the issuer sees empty lists and quickly goes back to paper.

That is why rolling out the wizard is mostly preparing data, not training in clicking. Below is an overview of the steps and of what must be ready.

  • Basic data: location and contractor company, from the location hierarchy and the list of companies.
  • Hazardous work: types and subtypes configured in the catalogue.
  • Tasks: a permit template linked to the location.
  • Risks: the hazard catalogue assigned to locations and work types.
  • Team: employees of the contractor company and the team leader.
  • Notifications: recipients on the plant side and on the contractor side.
  • Summary: preview of the printout from the plant's matrix and preview of the e-mail.

Preview before saving: why it matters

Before saving, the wizard shows a preview of the printout from the plant's matrix and an e-mail preview for each recipient, while the predicted permit status is calculated by the server. The issuer therefore sees what the contractor and the manager will see before the permit is created.

From the implementation standpoint this means the printout matrix must be ready before first use. If a printout looks odd, the cause is the matrix configuration, not an error by the issuer. It is worth checking the preview for several work types before the wizard goes to everyone.

How many form items a change in the wizard clears

How many form items a change in the wizard clearsHorizontal bar chart: changing the contractor company clears 3 items, changing the location clears 20123itemsChange of contractor companyChange of contractor company: 3 items3Change of locationChange of location: 2 items2
Source: Feature documentation: new permit wizard

Data and configuration to prepare step by step

The order of preparation is not accidental. Locations must exist before templates, and templates before the first permit, because a template is linked to a location.

1. Location hierarchy

Hall, area, line, place. This is the axis around which risks and templates are built. Without it the wizard has nothing to start from.

2. Types and subtypes of hazardous work

The work type tiles in the wizard are sorted by how often a given issuer uses them, so after a few weeks the most frequently chosen types appear at the top. At the start, however, the list should be complete, so that no type is missing.

3. Permit templates

The permit flow follows the template linked to the location, and it is configured in the installation data. A template is needed for every location where permits will be issued.

4. Risk catalogue

Risks assigned to the location and to the type of work make up the printout in five sections. The better the catalogue is organised, the shorter the document.

5. Contractor companies and their employees

The team is chosen from the employees of the contractor company. If the list is empty, the team step will block the issuer.

6. Notification recipients

The notifications step shows an e-mail preview for each recipient. Recipients must have correct addresses in the system, because the preview is based on that data.

Pitfalls of the first weeks

A form that has been started is saved locally as a draft assigned to the user, so interrupted work survives closing the browser tab. This is convenient, but it has a consequence: the draft is local, so no other person or computer will see it.

The second pitfall is changing data while filling in the form. Changing the contractor company in the wizard clears only the workers, the team leader and the template, while changing the location clears the additional locations and the template. An issuer who changes their mind halfway must therefore select the template again, and they need to be told this in advance.

  • The draft is saved in the user's browser, not on the server.
  • Changing the company clears 3 items: the workers, the team leader and the template.
  • Changing the location clears 2 items: the additional locations and the template.
  • The permit status is calculated by the server, so the status preview is binding only after saving.

Training issuers: what to show first

It is worth starting the training with the printout preview, because that is what convinces issuers that the digital permit is complete. Then show the draft, the change of company and location, and how work types are chosen. The remaining steps issuers will master on their own, because the wizard guides them through in order.

Video

Frequently asked questions

Will another person see a permit draft?

No. The draft is saved locally, assigned to the user, so it survives closing the tab but is not visible to others.

Who calculates the predicted permit status?

The server. The wizard shows it in the summary before saving.

What stays after the contractor company is changed?

The workers, the team leader and the template are cleared. The other form data stays.

Let us prepare the plant for the permit wizard

We will go through with you the list of data needed before issuers start, and show the printout preview on your plant's matrix. We invite you to talk.

Let's talk