Shop Floor
Shop Floor
Live plant boards, wall displays and machine data built on the Plex data you already have.
What Shop Floor is for
Shop Floor is the frontline layer over your Plex ERP. It turns what Plex already records about your workcenters (status, production, scrap, jobs and shifts) into boards that supervisors, operators and maintenance can read at a glance: on a desk, on a tablet at a station, or on a TV on the wall. Where your plant has PLCs, it can also read machine signals directly.
Open it from the Shop Floor menu in the top navigation. The menu appears when your company holds the Shop Floor license and you have one of the Shop Floor roles (Shop Floor Admin, Maintenance or Shop Floor Viewer).
Where the data comes from
- Plex ERP, through data sources. Each plant is a location: one Plex PCN inside your company. (In an enterprise account, a Site is a separate company with its own locations.) Boards read Plex data sources with the location's data source credential, and the Plant Readiness report reads Plex's reporting replica with the location's ODBC credential. Reading never changes Plex. A change, such as a downtime reason captured on a board, is queued to Plex through the Write Outbox, where you can see whether it landed.
- PLCs, through the on-premises connector. With OT connectivity, a connector agent running on your plant network reads machine tags over OPC-UA. The cloud never connects to your machines. The agent connects out.
Main areas
- Boards. The home page at
/shop-flooris a launcher for every board: Plant Overview, Floor Console, Live Board, Hour by Hour, Pace Board, Active Issues and Shift Handover, plus any screens you register yourself. See Boards and screens. - Setup. Locations, areas and lines, workcenter types, plant maps and the facility graph describe your plant. See Getting started and The plant model.
- Screens and displays. The screen registry decides which boards exist and what renders them. Displays put boards on TVs and kiosks in a rotation you control remotely. See Displays and kiosks.
- Data. Data Source Enablement, Console Settings, Plant Readiness, OEE Diagnostics and the Write Outbox show whether the data behind the boards is reachable and trustworthy. See OEE and Writing back to Plex. To check or change writes with your own scripts, see Transaction hooks on the shop floor.
- Machines. The OPC-UA Tag Map, Equipment and models, PLC State Map, PLC Scrap Reasons and PLC Triggers connect machine signals to workcenters. These need OT connectivity. See PLC connectivity and PLC mapping.
- Fleet. Fleet, Transport orders and Fleet optimizer manage vehicles such as AGVs. See Fleet.
- Alerts. Conditions and Escalation decides what raises an alarm and who is paged. Notification groups name the people a page goes to. PA announcements put alerts on the floor. See Conditions and escalation.
- Asset Health. An add-on module for alarms, faults, equipment health and maintenance insights. See Asset Health.
If something is not working, start with Troubleshooting.
Licenses
- shop_floor: the module itself, including every Plex-driven board, setup screen and display.
- shop_floor_ot: OT connectivity. It unlocks the Machines setup screens and reading PLC tags through the connector. Without OT connectivity, the Machines screens do not appear in the Setup menu or on the home page. If you open one by its address, you get an Access denied page that names Shop Floor OT connectivity.
- asset_health: the Asset Health module, which sits inside Shop Floor and needs the Shop Floor license as well.
Licenses are set on your company's plan. If a menu or page you expect is missing, ask your DataMagik account contact which features your plan includes.
Roles
Shop Floor and Asset Health use their own three roles. DataMagik - Builder and DataMagik - Viewer give no access here.
- DataMagik - Shop Floor Admin sets the module up: locations, lines, workcenter types, maps, screens, displays, console bindings, alerts and Asset Health settings. A Shop Floor Admin also runs checks and assessments, and can do everything the other two roles can.
- DataMagik - Shop Floor Viewer opens every board, the plant data pages (Plant Readiness, Data Source Enablement, OEE Diagnostics and the Write Outbox) and every Asset Health screen. A Viewer can also acknowledge or resolve an alarm, explain a stop on the Hour by Hour board and answer a page. A Viewer cannot change any setting.
- DataMagik - Maintenance can do everything a Shop Floor Viewer can, and also works Asset Health insights: add notes, move insights through their states, and raise or dismiss Plex work requests. With Asset Health on your plan, a Maintenance user who is not a Shop Floor Admin opens Shop Floor on the Asset Health Portal.
Permissions: Nobody has these roles by default. A company admin (someone with DataMagik - Security) grants them under Admin → Company User Manager. On the Shop Floor home page, a Shop Floor Admin sees a Setup section marked Shop Floor Admins only. A Shop Floor Viewer sees Plant data instead, with links to Plant Readiness, Data Source Enablement and OEE Diagnostics.
AI agents
If your plan includes AI Agents, the Agent catalog has an MES tab with ten agents built for Shop Floor. See AI Agents for how agents work and how to install them.
Six come with their own Shop Floor condition or escalation rung:
- Downtime Attributor finds machines that are down with no reason recorded and proposes the reason the plant's own history points at. A supervisor approves it before it is recorded. An escalation rung hands the incident to it.
- Shift Pacer tells the supervisor, partway through each shift, which machines are at least 10% behind their target so far or have been down 15 minutes or more.
- Data Doctor checks every hour for problems with the shop floor's own data, such as a feed that stopped or a Plex data source the location is not granted.
- Recurrence Hunter reports each morning the downtime reasons that keep coming back on the same workcenter.
- Shift Handover reports each workcenter's output, downtime, scrap and escalations at the end of each shift.
- Certification Guard alerts a supervisor when an operator badges onto a workcenter Plex does not list them as approved for. It never blocks the tap.
Four more read and report:
- Start-of-shift digest tells the supervisor, before each shift, what is set up on each machine, which machines are down and why, and what the last shift left open.
- Shift downtime digest reports at the end of each shift which machines fell behind target, how long each was down, and how much of that downtime has no reason yet.
- Machine material watch checks every two hours on shift whether the material for the jobs set up on your machines is at the machine, loaded, or in the plant at all.
- Escalation incident summarizer summarizes the escalation incidents that are still open, not acknowledged, or keep recurring on the same machines.
The six agents with a Shop Floor condition or rung install switched off, along with every condition and escalation rung they add to your locations. Nothing runs until a person turns them on. Installing from the catalog needs the DataMagik - Builder role.
From an AI assistant (MCP)
Assistants connected to the DataMagik MCP server can read and configure Shop Floor through the shop_floor, shop_floor_config, shop_floor_setup, shop_floor_live, shop_floor_escalation, shop_floor_conformance and shop_floor_write tools. A status written this way goes through the same Write Outbox as one captured on a board. An assistant cannot bind OPC-UA tags or apply a guided setup proposal. Those stay on the screens.