Getting started with Shop Floor

Updated Nov 14, 2026
Shop Floor

Getting started with Shop Floor

Set up a plant in order: credentials, location, data sources, workcenter types, lines, then a readiness check.

Every setup screen lives under Shop Floor and shares one Setup menu, grouped into Plant, Screens & displays, Data, Machines, Fleet and Alerts. Almost every screen works on one location at a time, so the location comes first.

Permissions: Setup needs the DataMagik - Shop Floor Admin role and the Shop Floor license. A Shop Floor Viewer or Maintenance user can open Data Source Enablement and Plant Readiness to read the results, but only a Shop Floor Admin can run a check or an assessment. DataMagik - Builder does not give access to Shop Floor.

Before you start

  • A Plex data source credential. This is a basic-auth credential for the Plex API user that boards use to call data sources.
  • An ODBC credential for the Plant Readiness report, which reads Plex's reporting replica.
  • For machine data only: the OT connectivity license and a connector agent installed on the plant network, set up under Connectors → Connector Agents.

If a credential does not exist yet, the Create one link beside each credential field on the Locations page takes you to Credentials.

Credentials and connector agents are not part of Shop Floor. Creating a credential needs DataMagik - Builder or DataMagik - Security, and Connectors → Connector Agents needs DataMagik - Builder. If you are a Shop Floor Admin without those roles, ask someone who has them to create the credential or install the agent first.

1. Add a location

A location is one plant inside your company, read from one Plex PCN. It is not a Site, which is a separate company under an enterprise parent. Open Setup menu → Locations (/shop-floor/settings/sites) and press Add a location.

  1. Enter a Name, for example "Main plant".
  2. Enter the Plex PCN. The field suggests PCNs your company already uses. A known PCN is marked Seen before for this company. A new one is marked Not seen before, so check that it is the plant's PCN.
  3. Choose the Company code. For a known PCN it is filled in for you. For a new PCN, pick a code your company uses or choose New code (PCN not seen before).
  4. Pick the Data source credential (basic_auth) and the ODBC credential.
  5. Choose the Plant timezone (IANA), for example America/Chicago. Boards read the plant's hours in this timezone, and reports close each day at local midnight. If it is left as Not set, reports close on a conservative 12-hour margin and run a day behind. Hour by Hour, the Pace Board, Active Issues and Shift Handover cannot place shifts on a clock at all, and say the location has no timezone. Set it.
  6. If the plant reads PLCs, choose its Connector group (for OT capture). Until this is set, OPC-UA tag capture cannot reach an agent.
  7. Choose the Environment (production or test), leave Enabled ticked and press Add location.

The Live Plex reads switch on each location fetches current workcenter status, the running job and its rate from Plex, and evaluates shop-floor conditions. It saves as soon as you change it. With it off, the location costs no live Plex calls, and blocks, history and OEE are unaffected.

A location card shows a warning chip such as Data source credential missing or ODBC credential missing when a credential it names is no longer active.

Sync from Plex

Once a location is saved, a Shop Floor Admin sees three buttons under Sync from Plex on its card. Each reads the location's Plex PCN with its saved credentials and updates what Shop Floor stores. Nothing is written to Plex.

  • Pull workcenters from Plex queues the location's regular Plex pull, so it also brings in any new production records. The card reports how many workcenters and rows came in. A long pull carries on in the background and the card says so.
  • Sync shift calendar reads the plant's shifts and shift cycles, and reports how many shifts, cycles and cycle-day assignments it stored.
  • Sync status tree reads Plex's statuses, events and detail reasons, and reports how many of each it stored. Downtime, availability and the PLC State Map depend on it.

Run all three when you add a location, and again after the plant changes them in Plex.

2. Check data source enablement

Boards read specific Plex data sources, and your Plex API user must be granted each one. Open Data Source Enablement (/shop-floor/settings/enablement) and press Check location name. Each data source shows one of:

  • ✓ Enabled: reachable, with the shape the screens expect.
  • ✗ Not granted: grant this data source to the Plex API user used by this location, then check again.
  • △ Shape mismatch: granted, but its fields differ from what the screen expects. The differences are listed under the row.
  • ? Unknown: the check itself failed, so try again. If it keeps failing, the credential or connection is the problem.

The Blocks: line on a row names the screens that need that source. Guided setup in step 3 needs 805 Workcenters_Get_All, listed as Workcenter types (guided setup).

3. Classify workcenters with guided setup

Workcenters come from Plex. You do not create them by hand. Open Workcenter types (/shop-floor/settings/classify). This page holds the guided setup.

  1. Press See what Plex suggests. Guided setup proposes one type for each Plex workcenter type your machines use, such as Press, Staker or Assembly. It reads them from data source 805, so that source must show ✓ Enabled in step 2.
  2. For each type, check its Standard type: the kind of machine it is, such as Press or Weld Station. The standard sets the tags its machines should report. Guided setup suggests one where the name makes it clear; choose one yourself where it does not, or leave none for a type that groups machines but is not measured.
  3. Tick the types you want and press Apply the ticked types. This creates the types, classifies the machines and registers the built-in boards. A type you have already saved is proposed as you saved it, so running guided setup again does not undo your changes.
  4. If suggestions remain, press Accept all to accept them. Machines you pinned by hand are never changed.
  5. Assign any machine guided setup could not classify by choosing its type in the list. A machine with no workcenter type in Plex is one of these.

Why it matters: an unclassified machine is not measured, and an app that asks for a role cannot read it. If the page says No workcenters have been pulled for this location yet, workcenters have not been brought in from Plex for this location. Press Pull workcenters from Plex on the location's card under Locations.

4. Group machines into areas and lines

On Areas and lines, add an area, add a line to it, and move machines onto the line. Boards filtered by a line only show machines on that line. See The plant model.

5. Bind the Floor Console's panels

On Console Settings, choose which Plex data source fills each panel of the Floor Console and which of the source's inputs receive the console's date range and workcenter. Optionally choose an AI assistant for the console. Bindings are set per location.

6. Run a plant readiness assessment

Open Plant Readiness (/shop-floor/readiness) and press Assess location name. The report reads only, so nothing is written to Plex. It grades each capability (pacing and hour-by-hour, downtime Pareto, live OEE, line mapping, shifts and others) as Ready, Partial or Blocked, and explains What it would take to improve it. Only completed days are counted, because Plex's reporting replica runs behind live data. Run it again after you fix something to see what changed.

7. Optional next steps

  • Draw a Plant map so the Plant Overview shows machines in place.
  • Put boards on TVs with Displays.
  • With OT connectivity, bind machine signals on the OPC-UA Tag Map.
  • Grant the people who read the boards the DataMagik - Shop Floor Viewer role, and maintenance staff DataMagik - Maintenance. Nobody has either by default. See Shop Floor for what each role can do.
Was this page helpful?