# Execute a Work Order

A work order is more than a to-do. Every status change is recorded with a time, and the time you spend is added to the
plant's labor figures. This lesson takes one work order from start to finish, such as the `Machine 1 - Coolant leak`
work order, if it has been created: the Maintenance Manager track raises it in
[Raise a One-Time Work Order](../7-maintenance-manager/3-raise-a-one-time-work-order.md).

## Start the Work

1. In **Maintenance → Work Orders**, open the work order assigned to you.
2. Click **In Progress** in the row of status buttons at the bottom of the panel.
3. Set **Work Type** to the kind of work you're doing, such as `Repair`.

The status buttons are **Open**, **Assigned**, **In Progress**, **On Hold**, **Completed** and **Cancelled**. If the job
can't go on, for example while you wait for a part, click **On Hold** instead of leaving it In Progress. On Hold counts as
waiting, so the backlog shows the job as waiting and not being worked.

## Follow the Procedure

If the work order has a procedure, it's on the **Procedure** tab. A procedure is a set of steps, and each step has checks.

1. Open the **Procedure** tab. Each step is a button that shows how many checks it has, such as *Chain Tension (3)*.
2. Select a step, then work through its checks.
3. Enter the **Time Taken** for the step, in minutes, next to its **Estimated Time**.

The **Instructions** tab holds the written instructions for the job. Read it before you start.

{/*
TODO: Confirm on a gateway how a check result is entered. The Developer Training says to mark a check OK or Not OK and add a
comment, and the Entry Options of a check decide how a result is recorded, but the exact controls need a screenshot.
Also confirm whether a required check or step blocks Completed until it is filled in.
*/}

::embed-section{src="../../kanoa-cmms/procedure.md" collapsed="true" summary="Reference Materials: Procedures - Steps, checks and how results are recorded."}

## Record Your Labor

Each work order event has a **Technicians** list. Add one entry for each person who worked on it:

- **Technician**: the person who did the work.
- **Work Type**: the kind of work, such as Repair or Inspection.
- **Duration**: how long they worked, in minutes.

If two people work one job, each logs their own time. If you did two kinds of work, add an entry for each.

{/*
TODO: Confirm on a gateway where the Technicians list appears on the work order screen and how to add an entry, since the
screenshot in docs/kanoa-cmms.md does not show it. Add a screenshot of it.
*/}

::embed-section{src="../../kanoa-cmms/workOrderTechnicians.md#logging-technicians-on-a-work-order-event" collapsed="true" summary="Reference Materials: Logging Technicians - Who worked on the event, the work type and the minutes."}

## Close the Work Order

1. Open the **Comments** tab and add a comment about what you did, such as the part you replaced.
2. Click **Completed** at the bottom of the panel.
3. Open the **History** tab to see each status change and who made it.

Kanoa uses these times for its maintenance measures. The time from creation to the first response measures how fast work is
picked up. The time from In Progress to Completed measures how fast it's done.

:::warning
Click **Cancelled** only for a job that won't be done. A cancelled work order isn't a completed one.
:::

## Check Your Understanding

1. A job is waiting on a part. Which status do you set, and why not leave it In Progress?
2. Two people fixed a machine together. How is each person's time recorded?
3. How do you check who changed a work order's status?

<details>
<summary>Answers</summary>

1. **On Hold**. It counts as waiting, so the backlog shows the job as waiting and not being worked.
2. Each person has their own entry in the **Technicians** list, with their work type and minutes.
3. Open the work order's **History** tab.

</details>
