Shop Floor troubleshooting
Shop Floor troubleshooting
Common Shop Floor problems, what causes them, and how to fix them.
Permissions: Most fixes below are made on setup pages that need DataMagik - Shop Floor Admin. A Shop Floor Viewer or Maintenance user can still open Data Source Enablement, Plant Readiness, OEE Diagnostics and the Write Outbox to find the cause, then pass it to a Shop Floor Admin.
Access and licenses
- There is no Shop Floor menu, or a page says Access denied and names Shop Floor as the required permission. Either your company's plan does not include the Shop Floor license, or you have none of the Shop Floor roles (Shop Floor Admin, Maintenance or Shop Floor Viewer). DataMagik - Builder and DataMagik - Viewer do not count. For the license, ask your DataMagik account contact. For a role, ask your company admin to grant one under Admin → Company User Manager.
- The Machines pages (OPC-UA Tag Map, PLC State Map and so on) are missing from the Setup menu, or open as Access denied naming Shop Floor OT connectivity. Machine connectivity is a separate license (OT connectivity) on your plan. The rest of Shop Floor works without it.
- The Asset Health section is missing from the menu. Asset Health needs its own license on top of Shop Floor.
- A setup page is refused but boards open. Setup needs the DataMagik - Shop Floor Admin role. DataMagik - Builder does not give it. Ask your company admin to grant it under Admin → Company User Manager.
A board is empty or a panel shows no data
- "No locations configured yet" or "No location is configured yet". Every board reads one plant. Add the location under Locations first.
- A board says "This location has no timezone, so no shift can be placed on a clock". Hour by Hour, the Pace Board, Active Issues and Shift Handover need the plant's timezone. Set Plant timezone (IANA) under Locations.
- A Floor Console panel says no Plex data source is bound to it, or that it is switched off. Open Console Settings, choose a data source for the panel, and tick Show this panel. Bindings are per location, so check you are on the right location.
- A data source is not granted. Open Data Source Enablement and press Check for the location. For each ✗ Not granted row, grant that data source to the Plex API user the location uses, then check again. The Blocks: line shows which boards are waiting on it. For △ Shape mismatch, the listed differences show which fields changed in Plex.
- A location card shows "Data source credential missing" or "ODBC credential missing". The credential it names is no longer active. Edit the location and pick another, or create the credential again.
- No machine shows a live status, and the location shows "Live reads off". Live Plex reads is switched off for that location. Switch it on under Locations. History, hour blocks and OEE do not depend on it.
- "No workcenters have been pulled for this location yet", or a board says the location has no workcenters. Workcenters have not been brought in from Plex for this location. Check the location's credential and enablement, then press Pull workcenters from Plex on the location's card under Locations (Shop Floor Admins only). The pull is queued and also brings in new production records; the card reports how many workcenters and rows came in.
- A board says the location's status tree is not synced. Without Plex's status tree, no status can be told apart as downtime, so availability and downtime by line read zero. The tree is read from Plex for each location. Press Sync status tree on the location's card under Locations (Shop Floor Admins only); it reports how many statuses, events and detail reasons it stored. If nothing comes back, check that the location's ODBC credential reaches the right PCN.
- The Plant Overview shows a list, not a map. The location has no plant map yet. Draw one under Plant maps.
Machines are missing from a board
- A machine is not measured, or an app cannot read it. It has no workcenter type. Classify it under Workcenter types, using guided setup or by choosing its type by hand.
- A line-filtered board, such as the Pace Board filtered by a line, shows nothing or misses machines. Only machines on that line are drawn. Open Areas and lines and move machines out of Machines not on a line onto the line.
- Hour by Hour finds no shift for a day. Pick another date, or check which shift cycle the workcenter is on in Plex. If it says the workcenter is on no shift cycle, assign one in Plex, then press Sync shift calendar on the location's card.
- Shift Handover says "No shift has finished recently". Nothing on the location's rotas ended in the last three days. That is normal over a weekend the plant does not work.
- Figures look a day behind. The location has no timezone set, so reports close on a conservative 12-hour margin. Set Plant timezone (IANA) under Locations.
Run Plant Readiness for the location whenever figures look wrong. It grades what your Plex data supports and says What it would take to improve each area.
A captured reason did not reach Plex
Reasons and status changes captured on a board are queued, not sent immediately. Open the Write Outbox to see each write's state. Active Issues also lists "A reason write did not reach Plex". A write is refused before it is sent if the workcenter is disabled in Shop Floor, the status is unknown or inactive, the event is not valid for that status, or no operator is clocked in. A write that one of your transaction hooks stopped is listed as Stopped by a hook, with the hook's reason, or with Not sent to Plex: hook … failed, and it is required if the hook's script failed. Press Test on the hook under Setup → Data → Transaction hooks to see what it does. See Writing back to Plex and Transaction hooks on the shop floor.
Machine (PLC) data is not arriving
See Connecting PLCs and OPC-UA servers for the full setup.
- The connector is offline. Open Connectors → Connector Agents and check that the agent at the plant shows as online. If it is offline, check the machine it runs on, its service and its network.
- The location has no connector group. Until Connector group (for OT capture) is set at the location, OPC-UA tag capture cannot reach an agent.
- The OPC-UA endpoint cannot be reached. The agent connects to the machine, not the cloud, so the endpoint address on the OPC-UA Tag Map must resolve on the plant network where the agent runs.
Displays
- A display shows "Dark · last seen". It paired and then stopped checking in. Check the TV's power and network. It resumes its rotation on its own.
- The TV says "This display is not paired" or "no longer paired". Open
/kioskon the TV and enter a fresh token from Displays → Pair a screen. Tokens work once and expire after 60 minutes. - The TV says "Nothing to show yet". No item in the saved rotation is switched on. Add or switch on an item, then press Save rotation.
- An application on a display says it has not been told who to run as. Set Runs as on the display.
- An external web page is blank. That website refuses to be embedded. It cannot be fixed from DataMagik.
- Only external pages can be added to a rotation. No shop-floor screen is registered and enabled. Register or turn on a screen under Screens.
- The remote says the TV is still counting an old number of pages. The TV picks up the saved rotation within a minute.
A screen answers not-found
It has been turned off, or it points at an application that was deleted. Open Screens and turn it on, or pick another application for it.