Run Training

See who is signed off on each of the plant's instructions and who holds each certification, sign operators off, and know when someone needs a review or to recertify.

A sign-off sheet says who was trained and when, but not on which version of the work, and nobody crosses it out when the instruction changes. Site qualifications such as forklift or lockout/tagout live in another spreadsheet, and nobody notices one has expired until an audit asks. Run › Training keeps both on one page: signoffs against the plant’s instructions themselves, flagged for review as soon as the work changes, and certifications, flagged when they’re due for renewal.

#What it is

Run › Training is one scrolling page with two matrices, Instructions and then Certifications. Both have your organization’s members across the top, in the same columns, 25 members at a time. The pager under the matrices moves both to the next members, and can show 50 at a time instead. Members are in order of email address.

#Instructions

The plant’s instructions run down the side. Each cell shows a member’s level on that instruction:

LevelNameMeaning
1SupervisedWorks the instruction with someone watching
2IndependentWorks it alone
3Can trainWorks it alone and trains others

A small warning dot on a level means Needs review: the instruction has changed since that signoff. An empty cell means the member is Untrained: they haven’t been signed off. The key under the matrix shows each of these.

The matrix always shows the instructions in the plant version that’s currently effective. See Plant Git and Imports.

#Certifications

  • Certification: a named qualification your organization defines, such as forklift or lockout/tagout. It isn’t tied to any instruction. It has a Name, an optional Description, optional media (images or PDFs) and an optional Recertification interval (days). Leave the interval blank if the certification never expires.
  • Certified: a ✓ in a cell means the member has been certified.
  • Recertification needed: a warning dot on the ✓ means the certification’s interval has passed since the member was certified.
  • Not certified: an empty cell.
  • Deactivated: a certification taken off the page. Its signoffs are kept.

#Rules

  • Run › Training needs both Run and Training turned on for your organization. While Training is off, the tab doesn’t show. See Feature Access and Billing.
  • Owners and Editors sign members off and certify them, and create, edit and deactivate certifications. View All members see both matrices and can open a filled cell to read it. Operators see only their own column, and in Instructions only the instructions they’re signed off on.
  • An instruction is identified by its id: in your plant’s files. Renaming an instruction’s id: makes it a new instruction that nobody is signed off on yet. Signoffs on the old id: stay in each member’s history.
  • People who are removed from the organization, deactivated or given the Floor role don’t show in the matrix and aren’t counted. Their signoffs are kept, and they come back if the person does.
  • Signoffs are never edited or deleted. Signing someone off or certifying them again adds a new signoff, and their cell shows the newest one.
  • A certification’s expiry is set when the member is certified, from the interval at that moment. Changing the interval later doesn’t change expiry dates already recorded; the next certification uses the new interval.
  • A deactivated certification doesn’t show in the app, and members can’t be certified on it. Only the API can reactivate it.

#In the app

#Reading the matrix

  • Click an instruction’s name to read it in Run › Instructions.
  • To find someone, type part of their first name, last name or email in Search members… in the toolbar. Both matrices show only the members who match, starting from the first page. If nobody matches, the page says No members match.
  • Use the pager at the bottom (Members per page, then the arrows) to move through the members. Operators see only their own column, so they get no search or pager.

#Signing someone off

  1. Click the cell for the member and the instruction.
  2. Choose a Proficiency level and add any notes.
  3. Click Sign off, or Sign off again if they already have a signoff.

The dialog also shows the member’s current signoff, who made it and when, and their Training history on this instruction. Each signoff in the history is marked Current content if the instruction still has the content it was signed off on, or Changed since if not. The history shows the 20 most recent signoffs and counts them all; click Show older for the next 20.

If the instruction changes while you have the dialog open, signing off is refused with This instruction changed while you were looking. Review the new version, then sign off again. The dialog then shows the new version.

#Certifying someone

  1. In Certifications, click the cell for the member and the certification.
  2. Add any Notes.
  3. Click Certify, or Re-certify if they’re already certified.

The dialog shows when the current certification expires and the member’s history on this certification, 20 signoffs at a time (Show older loads more).

#Managing certifications

  • Click New certification in the toolbar. Enter a Name, an optional Description and Recertification interval (days) (placeholder Never expires), attach any media, then click Create.
  • Click a certification’s name to open it. Owners and Editors edit its fields and media in place, and Deactivate it after confirming. Everyone else reads it.

#When a signoff needs a review

A signoff needs a review when the work in the instruction changes. Any of these does it:

  • A procedure is added, removed or reordered, or its id: changes.
  • A procedure’s safety warning changes.
  • A step is added, removed or reordered.
  • A step’s text changes, by even one character.
  • A step changes between a work step and a check step, or starts or stops asking for pass/fail.
  • A tool is added to or removed from a step.
  • A step’s images or videos change, including uploading the same file again.
  • A step’s parameters are added, removed, renamed, reordered, or made optional or required.

These don’t:

  • The instruction’s or a procedure’s name or description.
  • Image captions.
  • Spec values, targets, limits or attached documents.
  • Which routings or stations use the instruction.
  • A tool’s display name in the tool catalog, or the order a step lists its tools in.
  • Formatting, comments, spaces before or after text, or which file the instruction is in.
  • Changes to any other instruction.

If an instruction is changed and then changed back, or an older plant version is made effective again, members whose signoffs match that content are current again without a new signoff. Imports that aren’t effective don’t affect training.

#From the CLI or API

Run training’s API lives under /api/v2/training/, with the same permissions as the app.

#Instructions

OperationWhat it does
v2_training_organizations_instructions_listThe effective plant version’s instructions, with how many members are current and how many need review on each
v2_training_organizations_training_matrix_listEvery member’s level on every instruction. Filter with state=current or state=stale
v2_training_organizations_instructions_training_signoffs_listOne member’s signoffs on one instruction, newest first, with operator_uuid
v2_training_organizations_instructions_training_matrix_create_createSign a member off. Send the instruction’s uuid from the instructions list as instruction_uuid
v2_training_organizations_matrix_members_listWhat the Training page reads for its columns: the active members, by email, 25 a page (page_size up to 50). search matches first name, last name and email
v2_training_organizations_matrix_instructions_list, …_matrix_entries_listWhat the Training page reads for its rows and cells: the instructions whole, and the signed-off cells of the members you name in member_uuid__in (comma-separated, at most 50; required). Too large a list is a 422; use the paged operations above instead
threaded api call --operation-id v2_training_organizations_training_matrix_list \
  --path organization_uuid=<organization-id> --query state=stale

Sign a member off from the CLI with threaded task training:matrix:create --instruction <yaml id> --operator <user uuid> --training-level <level>.

#Certifications

OperationWhat it does
v2_training_organizations_certifications_listEvery certification, active and inactive. An inactive one has deleted_at set
v2_training_organizations_certifications_create_createCreate a certification
v2_training_certifications_partial_updateEdit a certification. Set deleted_at to any time to deactivate it (the time recorded is the server’s, not the one you send), or null to reactivate it
v2_training_organizations_certification_matrix_listEvery member’s status on every certification. is_stale is true when recertification is needed
v2_training_certifications_matrix_create_createCertify a member on one certification
v2_training_certifications_signoffs_listA certification’s signoffs, newest first
v2_training_organizations_matrix_certifications_list, …_matrix_certification_entries_listWhat the Training page reads: the active certifications whole, and the status on them of the members you name in member_uuid__in (comma-separated, at most 50; required). Too large a list is a 422

From the CLI:

  • threaded task certification:create --name <text> [--description <text>] [--recertification-interval-days <n>] [--media <uuids>] creates a certification. Omit the interval for one that never expires.
  • threaded task certification:matrix:create --certification <uuid> --operator <user uuid> [--notes <text>] certifies a member.

#Common errors

  • 403 on any operation: the organization doesn’t have Training turned on, or (for a write) you aren’t an Owner or Editor.
  • 404 when certifying: the certification is deactivated. Reactivate it with v2_training_certifications_partial_update and deleted_at set to null.
  • 400 from …_matrix_entries_list or …_matrix_certification_entries_list: member_uuid__in is missing or names more than 50 members.
  • 409 when signing off on an instruction: it changed since you read it. List the instructions again and sign off on the new uuid.

See What Run Exposes for the rest of Run’s API.