Work Orders

This screen displays a searchable, filterable list of work orders and is available at /fm/work-orders.

​

Overview

The Work Orders page renders a tabular list of work orders fetched via useWorkOrderList. Users can search by text and filter by Status, Priority, and Category using dropdown selects. Filter options are loaded from the usePicklistByEnum hook with enum fallback labels (WORK_ORDER_STATUS_LABELS, WORK_ORDER_PRIORITY_LABELS, WORK_ORDER_CATEGORY_LABELS). A New Work Order button opens WorkOrderFormDialog. Navigating to /fm/work-orders?action=new automatically opens the creation dialog on load. Note: The route /fm/work-orders/new redirects to /fm/work-orders?action=new and is not a standalone screen.

​

Who it’s for

Requires permission fm.dashboard.view (enforced by the parent FMViewGuard). Creating a new work order additionally requires fm.work-orders.create (enforced within the form dialog).

​

Before you start

• Hold the fm.dashboard.view permission.
• To create work orders, hold fm.work-orders.create.

​

Finding a work order

1. Navigate to /fm/work-orders via the FM sidebar or the Open Work Orders stat card on the dashboard.
2. Use the search bar and the Status, Priority, and Category dropdowns to narrow the list.
3. Click any row in the work order table to navigate to its detail page at /fm/work-orders/:id.
4. Click New Work Order in the header. The creation dialog opens; fill in required fields and submit.
5. Click the Help button to start the guided tour for work orders.

• Work order status — values include draft, submitted, assigned, in_progress, on_hold, completed, closed, cancelled (from WORK_ORDER_STATUS_LABELS).
• Priority — values from WORK_ORDER_PRIORITY_LABELS.
• Category — values from WORK_ORDER_CATEGORY_LABELS.

​

Creating a work order

Work orders are created via WorkOrderFormDialog. The route /fm/work-orders/new redirects to /fm/work-orders?action=new, which automatically opens the creation dialog. Requires fm.work-orders.create.

1. Navigate to /fm/work-orders/new (redirected) or click New Work Order from the work orders list.
2. The work order creation dialog opens; fill in required fields and submit.

​

Viewing a work order

The Work Order Detail page (/fm/work-orders/:id) loads a work order by ID using useWorkOrderDetail. It displays the work order number, title, status badge, and priority badge in the header. The main grid shows a Details card (description, type, category, site, location), and sidebar cards for Assignment (requester, assignee, assigned date), Timeline (created, due date, completed), and Costs (estimated hours, actual hours, estimated cost, actual material cost). Below the grid are cards for Materials, Attachments, and History. Context-sensitive action buttons appear based on the current status: Assign (draft/submitted), Start Work (assigned), Put On Hold (in_progress), Complete (in_progress), and Cancel (all non-terminal states). Requires fm.dashboard.view. Actions like Assign and Complete may require fm.work-orders.edit or fm.work-orders.approve — confirm with SME. Before you start: the work order must exist and not have been deleted. Hold the appropriate permissions for the action you intend to take.

1. From the Work Orders list, click any row to navigate to /fm/work-orders/:id.
2. Examine the Details, Assignment, Timeline, and Costs cards.
3. If the work order is in draft or submitted status, click Assign to open the assign dialog and select an assignee.
4. When status is assigned, click Start Work to move it to in_progress.
5. From in_progress, click Complete to open the completion dialog, or Put On Hold to pause.
6. Click Cancel on any non-terminal work order; a confirmation dialog is required.
7. Scroll down to view associated materials, file attachments, and the audit history of actions taken on this work order.

• Work order number — displayed as the primary identifier (e.g., WO-0001).
• Status flow — draft → submitted → assigned → in_progress → completed/on_hold/cancelled.
• History entries — each status change records action, optional notes, performed_by_profile, and performed_at.

​

Related

Documentation sources

• src/routes/fm.tsx
• src/cores/fm/pages/WorkOrdersPage.tsx
• src/cores/fm/pages/WorkOrderDetailPage.tsx