QR label, scanning and the mobile work-order list

Three things belong together on the Maintenance page: a technical location’s QR label (which you print and put up on the equipment), the scanner in the search (camera or a handheld barcode scanner), and the mobile work-order list, on which you find the work waiting for you on a phone, even with gloves on. The label serves field reporting — how that works is described in Field report by QR label.

Before you start

• To request a label: “Manage field reports” — field_report:manage. By default only the system administrator has it. Without this right the QR label box does not appear on the page at all, and the token is not in the page data either.
• For scanning and work orders: maintenance read access — cmms:view — and the Maintenance module switched on.
• Master switch: field reporting is off by default for the whole organisation and is switched on by OPEREX. While it is off the label answers “not found” and no new label can be requested — on the node page the box says so and its Details: Master data → Field reports link takes you there.

Request a QR label for a technical location

1. Open Maintenance → Technical location structure and select the node. You find the QR label box on the page.
2. Click Enable QR label. If the location could belong to several plants, choose first: Which plant’s log should it write to? — a label writes into one plant’s diary. A plant-bound location offers only its own plant; a location without a plant offers all active plants of the site.
3. In the row that appears you see the token’s state (Active / Paused) and the link. Click Label (PDF) for the printable sheet.
4. Several labels at once: if a technical location is a subtree (say a block with all its equipment), Subtree labels (PDF, N) puts the labels of the live tokens of the location and everything below it on one sheet.
5. In the QR label actions (⋮) menu: Copy link, Pause / Resume, New token, Revoke.

New token and Revoke act immediately

New token makes the old label stop working immediately (you must print a new one), Revoke ends the token for good. The system asks you to confirm both. A paused token’s label cannot be printed — resume it first.

Archiving a location also affects the label

When you archive a location, the Confirm archiving window states the consequence: the location’s field-report QR label will then answer “not found” (its strategies and tasks are archived with it as well). An archived item is not deleted — its history is kept.

Scan in the maintenance search

In the Maintenance search (Search by name or code…) you can scan a label in two ways.

1. With the camera: click the QR button next to the search field (Scan a QR label with the camera). The browser asks for camera permission the first time — allow it. With Point the camera at the QR label. shown, hold the phone in front of the label; when the code is recognised the window closes by itself.
2. With a handheld (USB or Bluetooth) barcode scanner: click into the search field and scan the label. The scanner types the code and then sends Enter — you need not empty the field first: an own label scanned after text already in the field is recognised too.

What does a recognised code do?

• Your organisation’s own field label — the system opens the diary, not the search: signed in with the right to log events it takes you to the pre-filled event form (plant and location filled in, “From QR label: …”), with — given maintenance read access — a Technical location data sheet → link next to it. Without the “Log event” right you get the public report form.
• Any other code — another organisation’s QR, a web address, a part number — goes into the field as search text; the system never navigates to a foreign address. When a camera scan was a web address, you see: “The scanned code is not this organisation’s field label, so we searched for it as text.”

Camera permission and browser

• The camera works only on the Maintenance page, signed in, and only over a secure (HTTPS) connection. The permission is the browser’s own prompt; recognition runs in the browser — the app does not send the camera image anywhere.
• On Android Chrome the built-in QR detector does the work; in other browsers a fallback decoder is loaded (the first use may take a little longer). If the browser does not support the camera, the handheld scanner always works.

Mobile work-order list

On Maintenance → Work orders a phone shows cards instead of a table (the usual table from 769 pixels wide).

• Mine: the one-tap quick button shows the open work orders assigned to you. Tap again to switch the filter off. The button is shown only to people who see work orders through maintenance read access — someone who sees only their own requests does not get it.
• Assignee: the drop-down filters by Assigned to me or Unassigned (work the shift can still pick up).
• Open only: hides closed, rejected and cancelled work orders.
• Clear filters: resets everything in one tap.

On a work order’s detail page a phone shows a sticky quick bar at the bottom: Status, Checklist done/total (e.g. 2/5) and Photo — with 48-pixel touch targets.

“Mine” means “assigned to me”

The filter gives the work orders assigned to you as assignee, not what is due in your shift: the system does not link a user to their rostered shift today. Our development list tracks this as a separate item.

If it worked

In the QR label box the token is Active, Label (PDF) downloads, and scanning the label from the search (signed in) opens the diary’s pre-filled form. On the work-order list the Mine button is highlighted (primary colour) when switched on.

Common problems

What you see	Why	What to do
“The browser did not allow camera access. Allow the camera in the site settings, then try again.”	You denied the permission in the browser.	Allow the camera in the site settings and try again.
“No usable camera was found on this device.”	There is no camera, or it is busy.	Use a handheld barcode scanner or another device.
“This browser does not support scanning with the camera.”	The browser cannot open the camera.	Use another browser, or the handheld scanner.
“The camera is only available over a secure (HTTPS) connection.”	The page was not opened over HTTPS.	Open your organisation’s https address.
“The camera is not enabled on this page. Reload the Maintenance page, then try again.”	Only a freshly loaded Maintenance page gets the camera permission.	Reload the Maintenance page and scan again.
“The camera did not start.”	The camera failed or another app is using it.	Close the app using the camera and try again.
No QR label box on the node page	You do not have Manage field reports.	Ask your administrator.
“No active plant belongs to this location, so there is no log the label could write to.”	The location’s plant is archived, or the site has no active plant.	Bind the location to an active plant, or create one.

Related

Field report by QR label (no login)What the reporter sees, what becomes of the report in the diary, data protection.

Technical locations (the installation tree)The tree whose nodes you request the label for.

Work-order statusesWhat open and closed mean for a work order.