# Work Orders

Ask for work, route and assign it, record tasks, time and parts, approve requests that need a yes, and close the job.

When a machine is down, people need to know someone owns the fix. At Granite Peak Outdoors, staff file requests, the lead assigns them, and the crew closes each job with its time and parts on record.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

Every job is a **work order** with a number, priority, status, department, requester and assignee. Counters at the top show **Open**, **Overdue**, **In Progress**, **Completed Today** and **Avg Resolution (h)**. The tabs:

- **Work Orders**: the full list, with search and filters, and **New**.
- **My Work**: work assigned to you. Tick **Include closed** to see finished jobs too.
- **Activity**: every change to every work order.
- **Approvals**: requests waiting on your decision, if you approve a request type.
- **My requests**: what you filed, for people who ask for work but don't work on it.
- **Access Register**: who holds access granted through an access request type, shown when such a type exists. Click **Record removal** when access is taken away.

Click a work order to open it in the side panel.

## Set it up

1. Open **Module Settings** from the ⋮ on the module's sidebar row, then **Configuration**. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. On **Departments**, click **Add department**. Enter a **Code**, a **Name** and **What belongs to this department**, in the words people use (for example "Computers, laptops and printers"). Requests are routed by this description.
3. On **Work types**, click **Add work type** for each kind of work you do.
4. On **Request types**, click **Add request type** for what people can ask for, or click **Add from catalog**, tick ready-made types and click **Add selected**. Edit each one: to require a yes first, tick **Requires approval before anyone can work on it** and name **Who approves**, then tick **Active** and click **Save**. **Change history** shows every change to request types.
5. On **Rules**, pick a kind of rule in **Add a rule…** to add your own business rules.
6. Give roles their access (see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f)). Give **Can be assigned work** to the people who do the work, so the assign list shows your crew. Give **Assign work orders** and **Close work orders** to supervisors. Keep **Delete work orders** for administrators.
7. Optional: to file work orders from email, connect the workspace's Microsoft 365 integration with a support mailbox, give **Work the support mailbox** only to people who already read that mailbox, and turn the schedule on under **System Settings** > **Schedules** > **Offered by modules**. See "Work the support mailbox" below.

## Ask for work

1. Click **New**.
2. Under **What do you need?**, pick **General work order** or a request type.
3. For a request type, describe it in **Details** in your own words. For a general work order, fill in the **Title**, **Requested work**, **Priority** and **Department**, and add **Tasks** one at a time with **Add**. **Assign to** only shows if you can assign work.
4. Click **Submit**. A message gives you the order number.

## Find work and change many at once

1. On the **Work Orders** tab, click **Open**, **Closed** or **All**. The list opens on **Open**.
2. Search by title, equipment, person or order number. Narrow the list with **All departments** (pick **Needs routing** for work with no department), **Any status** or **Critical only**. If nothing matches, click **Search all work orders**.
3. Where departments are set up, click a department button above the list to switch to its view, and **Make default** to open Work Orders on that view next time.
4. To change several work orders at once, tick their rows. The header tick box selects only the rows the current filters show.
5. In the bar that appears, click **Assign**, **Change Status**, **Change Priority**, **Change Department**, **Add Notes**, **Post Time** or **Log Parts**, answer the prompt and confirm. A message says how many were changed and how many failed.

## Assign and work a job

1. In the **Work Orders** list, click the **Assign** icon on a row, pick the person in **Assign to** and confirm. Or open an unassigned work order, click **Edit** and click **Assign to me**.
2. Open the work order and click **Edit**. Tasks, time, materials and internal notes can only be changed while editing.
3. Under **Tasks**, click **Complete** on each task as you finish it. **Reopen** undoes it. Add a step with **Add a task…** and **Add**.
4. Under **Time Tracking**, enter the **Hours** (24 at most per entry), **Date** and **Notes**, and click **Add time**.
5. Under **Materials**, enter the **Part number**, **Name**, **Qty** and **Unit $**, and click **Post**.
6. Under **Internal Notes**, type a note for the crew and click **Add note**. The requester never sees these.
7. Click **Save** to keep changes to the details, or **Cancel** if you only added tasks, time, parts or notes. Those are kept as soon as you add them.
8. To write to the person who asked, type in **Requester** (no **Edit** needed), optionally pick a status in **and set status to**, and click **Send**. They see exactly what you write. The **Message** icon on a row does the same.

The screen has no control to skip a task. To skip one that won't be done, ask the Maintenance Agent.

## Close a work order

1. Open the work order and click **Close work order**, or click **Complete work order** on its row.
2. If it is greyed out, the work order isn't ready yet: a task is still open, an approval is missing, or a record its type needs isn't written yet. Finish the tasks, get the approval, or click the **Write …** button for the record.

To stop work that won't be done, change its status to cancelled instead. The record is kept.

## Approve a request

1. Open **Approvals**. The tab only shows if you approve a request type.
2. Read the request, then click **Approve**, with an optional note, or **Reject**, with a reason. The requester sees the reason.

Nobody approves their own access, and a request you filed needs another approver unless its type lets the requester approve. Whoever approved a request can't be assigned it.

## Work the support mailbox

When the workspace has a support mailbox connected through Microsoft 365 and the schedule is on, the Maintenance Agent reads the mailbox every 15 minutes, at most 10 emails a run. It files a work order for each real request email and tags the email with the order number. Those work orders wait as **Needs review** until a person decides them. You need **Work the support mailbox**.

1. Click **Needs review** above the list. Its number is how many are waiting.
2. Open one and read **Requested Work**: the original email is kept there. Correct the title or department with **Edit** and **Save** if needed.
3. Click **Approve** on the row, or in the panel, and confirm. It moves into the queue as Open. One with no assignee goes to its department's default assignee.
4. If it isn't real work, such as a newsletter or a duplicate, click the reject icon on the row, or **Reject** in the panel. Type a **Reason (optional)** and confirm. It is cancelled, the reason is kept as a crew-only note, and the email is tagged No work order.
5. To decide several at once, tick the rows and click **Approve** or **Reject** in the bar.

The schedule is off until an administrator turns it on under **System Settings** > **Schedules** > **Offered by modules**.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View work orders** | See work orders and their history. | Admin, Operator, Viewer |
| **Create and edit work orders** | Open new work orders and change their details. | Admin, Operator |
| **Assign work orders** | Decide who does the work (assign and unassign). | Admin |
| **Can be assigned work** | Appear in the assign list; grants nothing else. | Admin, Operator |
| **Change priority** | Raise or lower how urgent a work order is. | Admin, Operator |
| **Update tasks** | Mark tasks on a work order started, done or skipped. | Admin, Operator |
| **Record parts used** | Record the parts used on a job. | Admin |
| **Close work orders** | Sign off a work order as completed. | Admin |
| **View time on work orders** | See the hours logged on work orders. | Admin, Operator, Viewer |
| **Log time on work orders** | Record hours spent on a work order. | Admin, Operator |
| **View materials on work orders** | See what materials were used on a job. | Admin, Operator, Viewer |
| **Read internal notes** | Read the crew's notes, which the requester never sees. | Admin, Operator |
| **Add internal notes** | Leave crew-only notes on a job. | Admin, Operator |
| **Message the requester** | Write to the person who asked for the work; they see exactly what is written. | Admin, Operator |
| **Work the support mailbox** | Have the agent read the support mailbox and file work orders from it, and approve or reject what it filed. **Give with care.** | Admin |
| **View activity history** | See who changed what on a work order and when. | Admin, Operator, Viewer |
| **Delete work orders** | Permanently delete a work order and everything on it, with no undo. **Give with care.** | Admin |
| **Request work** | Ask for work from the New form or the desktop app, and download the desktop app. | Admin, Operator, Viewer |
| **View their own requests** | Follow the requests they filed, and nobody else's. | Admin, Operator, Viewer |
| **Set up departments and request types** | Set up departments, work types, request types, rules and who approves; every change is logged. **Give with care.** | Admin |

Assigning needs **Assign work orders**, which starts with Admin only: a Workspace Admin gives it to the roles that assign work.

## Ask its agent

The **Maintenance Agent** works with your access and no more. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48). Try:

- Paste an email and say "File this." It files the work order straight away.
- "What work is assigned to me?"
- "What work orders are overdue?"
- "Close WO-260914-33CE, it's all done."

Closing and deleting always wait for your yes.

## Good to know

- **The list opens on Open.** Click **Closed** or **All** to see finished work.
- **Overdue work moves up.** An overdue open work order is raised one priority step on a schedule, never past critical.
- **Cancel, don't delete.** **Delete** removes a work order and its history for good, and only Admins have it out of the box.
- **Desktop app** above the list, when offered, gives a Windows tray app for raising requests. Its page offers **Download the app**, **Download the certificate**, and a command under **Or roll it out** for many PCs. See [Desktop apps](article:d3921b51-1f16-4011-88d1-8c3757d156e8).

## More help

Open the module's **Help** (top right of the tabs) for the full reference and its **Runbooks**: step-by-step guides to ask for work, follow up on a request, triage and assign, approve a request, work the support mailbox, work and close a job, the Access Register, the desktop app, set up, and review the queue (see [Find and follow a runbook](article:4b62ad1f-577a-4998-8bce-f00226376522)). With the Assets module, a work order picks its asset and location from there. Work order datasets can be charted; see [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).


Source: https://datavisions.ai/docs/module-guides/work-orders
