Users

Who can access this

Administrator role only. Since the Administrator role can itself only be assigned to accounts at the central (main) store, user management is in practice a central-level activity.

Overview

The Users page lists every account in the system with the warehouse or store it is linked to, its roles, and whether it is active. From here you create new accounts and update existing ones.

VLMIS does not manage identities itself: it delegates that to DHIS2. Every VLMIS account corresponds to an existing DHIS2 user, and the personal details (name, email, phone) come from the DHIS2 API rather than being typed in.

Creating a user

Create New Account is a two step flow:

1. Enter the DHIS2 username and press Next. VLMIS looks the username up in DHIS2 and shows the profile it found: name, email, and phone number. Nothing is typed by hand; if the person does not exist in DHIS2 yet, they must be created there first.
2. Pick the store and the roles. The store choices are the organisation units assigned to that user in DHIS2; you select which one becomes their VLMIS store. Then tick one or more access levels and save.

Roles

• storeKeeper and storeManager: the day-to-day operational roles; they unlock Requisition, Distributions, Issuing, and Inventory.
• CentralUser: unlocks the Arrivals page; meaningful only at the central store.
• Administrator: unlocks Users, Maintenance, and Analytics. It can only be given to an account whose store is the central store; trying anywhere else is rejected with "Only central level user can be assigned to the Admin Role".
• ViewOnly: read-only access (see View Mode).

An account can combine several roles.

Updating a user

From the user's row you can open the profile, change the set of roles, and activate or deactivate the account. A deactivated account cannot log in ("Unable to login, please contact the support Team"). The same central store restriction applies when adding the Administrator role to an existing account.

Why an action may fail

• "username ... not found": no DHIS2 user has that exact username; check the spelling or create the user in DHIS2.
• "Organization Unit with ID ... not found": one of the user's DHIS2 facilities is not yet in VLMIS; refresh organisation units in Maintenance, Settings.
• "User already exists": an account with that username was already created; update it instead.
• "Only central level user can be assigned to the Admin Role" (or "Upper role assignment is restricted to Central store users" when updating): the Administrator role is reserved for central store accounts.

Screenshots and step-by-step walkthroughs to be added.