Service Queues – Queue Screen Setup Guide

Step 1: Create Visit Attribute Type for Queue Numbers

Log in to PromedMRS as an administrator

Navigate to: Administration → Visit Attribute Types

• Direct URL: https://youdomain.com/openmrs/admin/visits/visitAttributeType.list

• Click Add Visit Attribute Type (or go directly to the form)
• Fill in the form:
  • Name*: Queue Number
  • Description: Visit queue number for service queues
  • Min Occurs: 0
  • Max Occurs: 1
  • Datatype*: Select Free Text from the dropdown
  • Datatype Configuration: (leave empty)
  • Preferred Handler: Default
  • Handler Configuration: (leave empty)
• Click Save
• Copy the UUID shown on the saved page (e.g., ae6e5192-f2fd-4c4b-8c83-e7626fe9be86)

Step 2: Configure Service Queues App in Frontend

• Log in to the PromedMRS
• Click the Implementer tools icon in the top right corner
• Select Configuration 

• In the search box, type: esm-service-queues-app
• Find the setting: visitQueueNumberAttributeUuid
• Paste the UUID you copied from Step 1
• Click Save

Done! The Queue Screen is now configured. Queue numbers will be automatically generated when patients are added to queues.

User Guide: Setting Up Service Queues

Part 1: Configure Services

1. Log in to Promed MRS
2. Go to Service Queues from the main menu
3. Click Admin (or go to System Administration → Service Queues)
4. Click Add new service button
5. Fill in:
   • Service Name: e.g., “Clinical Consult”, “Triage”, “Laboratory”
   • Description: (optional) Brief description of the service
6. Click Save
7. Repeat for all services your facility offers

Part 2: Create Queues

1. In the Service Queues Admin page, click Add Queue
2. Fill in:
   • Queue Name: e.g., “Outpatient Consultation”, “Outpatient Triage”
   • Service: Select the service from dropdown (created in Part 1)
   • Location: Select the location where this queue operates
   • Description: (optional)
3. Click Save
4. Repeat for each queue you need

Part 3: Configure Queue Rooms (Optional)

Queue Rooms help organize where patients are seen. They’re linked to queues.

1. In Service Queues Admin, click Add Queue Room
2. Fill in:
   • Room Name: e.g., “Room 1”, “Consultation Room A”, “Salle d’attente”
   • Description: (optional)
   • Queue: Select which queue this room serves
3. Click Save
4. Repeat for each room

Note: Queue Rooms are informational. The Queue Screen will display the queue name as the “Room” by default.

Part 4: Using Service Queues

Adding Patients to a Queue

1. Go to Service Queues from the main menu
2. Select a Service (e.g., “Clinical Consult”)
3. Click Add Patient to Queue button
4. Search and select a patient
5. Fill in:
   • Queue: Select the appropriate queue
   • Priority: Select priority (Not Urgent, Urgent, Emergency)
   • Status: Usually defaults to “Waiting”
6. Click Save
7. A queue number (ticket number) will be automatically generated

Calling Patients

1. In the Service Queues page, find the patient in the queue table
2. Click the Call button (bell icon) next to the patient
3. A modal will appear showing patient details
4. Click Attend to Patient to mark them as being served
5. The patient will now appear on the Queue Screen

Viewing the Queue Screen

1. Go to Queue Screen from the main menu (or navigate to /home/service-queues/screen)
2. This screen displays:
   • Ticket Number: The patient’s queue number
   • Room: The queue name (or service point name)
   • Status: Calling or Serving
3. The screen automatically refreshes every 3 seconds
4. This screen is typically displayed on a TV/monitor in the waiting area

Part 5: Managing Queue Entries

• Move: Transfer a patient to a different queue
• Transition: Change the patient’s status (e.g., from Waiting to In Service)
• Edit: Modify queue entry details
• Remove: Remove patient from queue (if not yet served)
• Delete: Permanently delete a queue entry

Troubleshooting

Queue Screen shows no patients

• Make sure you clicked “Call” on the patient from the main Service Queues page
• Verify that visitQueueNumberAttributeUuid is correctly configured in Settings → Configuration
• Check that the Visit Attribute Type “Queue Number” exists in Administration

No queue numbers are generated

• Verify the Visit Attribute Type “Queue Number” exists in Administration → Visit Attribute Types
• Check that the UUID in Settings → Configuration matches the attribute type UUID
• Ensure you saved the configuration in Settings → Configuration

“Room” shows queue name instead of room name

• This is expected behavior. The Queue Screen displays the queue name as the “Room”
• Queue Rooms configured in admin are separate entities and not automatically used by the Queue Screen