Antylogic
DemoApp login

399 operational guides

Docs sections
DocsTeam
Device

List staff roles

Use Employee roles in Employees and roles to review the staff roles configured for Harbor Soho. The list is scoped to the active location, searchable in the app, and can show active staff assignments when staff viewing access is available.

In this article

Employee roles keeps the location role catalogue visible without opening create, edit, or delete flows. It helps managers confirm which staff roles exist and, when staff viewing is allowed, who is actively assigned to each role.

For Harbor Demo Group / Harbor Soho, the GB demo runtime seeds the roles `Sala`, `Cocina`, and `Barra`. The planned search capture uses `STAFF_ROLE_LIST_QUERY=Sala` to show the filtered list state.

Before you start

  • You are signed in with Harbor Demo Group selected as the organisation and Harbor Soho selected as the active location.
  • Your account has location permission `staff-roles:view`.
  • To see active assigned staff in the Employees column, your account also has location permission `staff:view`.
  • The app route can open `location/staff?tab=roles`.

Instructions

  1. 1.

    Open Employee roles

    Open `location/staff?tab=roles`. The app shows Employees and roles with the Employee roles tab selected when your permissions allow that tab.

  2. 2.

    Review the roles table

    Read the Name, Description, and Employees columns. The Harbor Soho demo role names are `Sala`, `Cocina`, and `Barra`; staff examples in the same runtime include Olivia Hart, Mason Reed, Noah Stone, and Ava Price.

  3. 3.

    Search roles

    Use Search by name or description to filter the loaded role list by role name or description. The demo route `location/staff?tab=roles&roles_query=${STAFF_ROLE_LIST_QUERY}&roles_page=1` narrows the table to `Sala`.

  4. 4.

    Use pagination

    Use the table pagination controls when more roles exist than fit on the current page. Pagination is calculated in the app from the loaded and filtered role list.

  5. 5.

    Refresh the data

    Use the refresh action on the Employee roles tab to reload roles. When staff viewing is allowed, the app also refreshes staff so the Employees column reflects current active assignments.

Validations and limits

  • If the selected organisation or location is missing, the screen shows the location-not-found state.
  • `staff-roles:view` is required by `GET /api/app/{orgId}/{locationId}/staff-roles`; `staff-roles:manage` may expose the tab in the UI, but the list endpoint still requires view access.
  • The list only includes roles for the active location and the backend orders roles by name ascending.
  • Search trims spaces, ignores case, and runs in the app against the already-loaded role array; there is no separate server-side search endpoint.
  • Invalid, zero, negative, or non-numeric `roles_page` values return to page 1, and out-of-range pages are moved to the nearest valid page.
  • `roles_page_size` may be parsed from the route, but this screen uses a viewport-based page size instead.
  • A blank role description is shown as `-`; empty or unrecognised role colours fall back to grey.
  • Archived staff are not counted in the Employees column, and the cell can show up to five avatars plus a `+N` overflow indicator.
  • This action does not create, edit, or delete roles, and it documents staff roles, not access roles under `/roles`.

Expected result

The manager can confirm the staff roles configured for Harbor Soho, see active assignment evidence when permitted, and filter to the `Sala` role without changing role data.

Related articles