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
- Open Administration → Manage Staff.
- Open the Manage section and click Staff Mappings (e.g. Sample Transporters).
- Check Mapping Type is Sample Transporter.
- 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.
- Repeat for each porter. A staff member can be mapped to several routes or institutions. Use the red bin button to remove a mapping.

Limit the transporter list to mapped staff
Mapping does nothing until you switch on the application option.
- Open Administration → Manage Institutions → Preferences → Application Options.
- Search for Sample Transporter.
- Edit Sample Transporter List Is Limited To Staff Mapped As Sample Transporters, turn it on, and save.

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:

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

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