Admin Staff Mappings - hmislk/hmis GitHub Wiki

Staff Mappings (Sample Transporters)

Video: Watch the walkthrough

By default, the Sample Transporter box on the laboratory sample screens lists every staff member. Some hospitals want only their porters in that list. A Staff Mapping links a staff member to a purpose; the first purpose is Sample Transporter.

Map staff as sample transporters

  1. Open Administration → Manage Staff.
  2. Open the Manage section and click Staff Mappings (e.g. Sample Transporters).
  3. Check Mapping Type is Sample Transporter.
  4. Search for the staff member by name or code, pick them, then pick either a Route (to map them for a collecting centre) or an Institution (to map them for any other institution), and click Add. Choosing both, or neither, is refused.
  5. Repeat for each porter. A staff member can be mapped to several routes or institutions. Use the red bin button to remove a mapping.

Staff Mappings page

Limit the transporter list to mapped staff

Mapping does nothing until you switch on the application option.

  1. Open Administration → Manage Institutions → Preferences → Application Options.
  2. Search for Sample Transporter.
  3. Edit Sample Transporter List Is Limited To Staff Mapped As Sample Transporters, turn it on, and save.

The option

The default is off, so nothing changes for a hospital until its administrator turns it on.

Who sees which staff

When the option is on, the list depends on the institution the user is logged in to:

  • A collecting centre that has a route: every staff member mapped to that route.
  • Any other institution (including a collecting centre with no route): every staff member mapped to that institution.

What users see

With the option off, the Sample Transporter box suggests every matching staff member:

Option off

With the option on, it suggests only the staff mapped for the logged-in institution or route:

Option on

The limit applies in every Sample Transporter box: the Laboratory Dashboard sample actions, the sample barcode page, and the Collecting Centre self-sample page.

Related: #24952