Admin User Subscriptions - hmislk/hmis GitHub Wiki
User Subscription Management
Overview
Subscriptions control which automated alerts and notifications a user receives. Each subscription is linked to a trigger type — a named system event (such as "new bill created", "stock below threshold", or "lab result ready"). When that event fires, the system sends an alert to all users subscribed to it in that department. The order of subscriptions can also be controlled.
When to Use
- A user needs to receive notifications when specific events happen (e.g. a pharmacist who wants to know when a GRN is approved)
- You need to remove a notification a user is receiving but no longer needs
- The order in which a user processes their alerts needs to be re-arranged
Navigating to Subscription Management
- Click Administration → Manage Users
- Select the user row
- Click Manage User Subscriptions in the right action panel
- The Manage User Subscriptions screen opens
Required privilege: AdminManagingUsers
Loading Existing Subscriptions
- Select the Department from the dropdown
- Click List Subscriptions
- The table below populates with the user's current subscriptions for that department
Adding a Subscription
- Select the Department
- Select the Subscription to Add from the dropdown — this lists all available trigger types
- Click Add Subscription
- The subscription appears in the list
Managing Subscription Order
Each subscription has up and down arrow buttons:
- Click the up arrow to move the subscription higher in the list
- Click the down arrow to move it lower
The order determines the sequence in which alerts appear in the user's notification feed.
Removing a Subscription
Click the trash icon (red button) in the Actions column next to the subscription you want to remove.
Role-Level Subscriptions
Subscriptions can also be managed at the role level so all users in a role share the same alert configuration. See Creating and Managing User Roles for details.