Configuration des files d’attente de service
Les files d’attente de service sont l’un des modules les plus configurables d’O3, vous permettant de personnaliser les tableaux de files d’attente, les priorités, les statuts, la mise en évidence des temps d’attente, l’interrogation périodique, etc. Ce guide couvre toutes les options de configuration du module Files d’attente de service.
Aperçu
Le module Files d’attente de service gère les files d’attente de patients dans les établissements ambulatoires. Vous pouvez configurer :
- Titre du tableau de bord et file d’attente de service par défaut
- Tags de priorité avec couleurs et styles
- Mise en évidence des temps d’attente
- Colonnes et mises en page des tableaux de files d’attente (par file/statut)
- UUID de concepts pour les priorités et les statuts
- Appel des patients et écran de file d’attente
- L’écran d’administrateur de clinique
- Fréquence d’actualisation des données des files d’attente
- L’espace de travail Add patient to queue
- Le résumé de visite des lignes dépliées des tableaux de files d’attente
- Numéros de file d’attente de visite
- URLs du dossier patient
- Intégration avec le formulaire de début de visite
Titre du tableau de bord
Configurez le titre affiché sur le tableau de bord des files d’attente de service :
{
"@openmrs/esm-service-queues-app": {
"dashboardTitle": {
"key": "serviceQueues",
"value": "Service queues"
}
}
}key- Clé de traduction pour le titrevalue- Texte par défaut si la traduction n’est pas trouvée
File d’attente de service par défaut
Définissez la file d’attente de service sélectionnée par défaut lors de l’ouverture du formulaire de début de visite :
{
"@openmrs/esm-service-queues-app": {
"defaultInitialServiceQueue": "Outpatient Triage"
}
}La valeur par défaut est "Outpatient Triage".
Intégration avec le formulaire de début de visite
L’app des files d’attente de service fournit l’extension visit-form-queue-fields au formulaire de début de visite du dossier patient. Ces champs sont rendus lorsque la configuration du dossier patient active les champs de file de service, ou lorsque le formulaire de début de visite est ouvert depuis le flux d’ajout de patient aux files de service :
{
"@openmrs/esm-patient-chart-app": {
"showServiceQueueFields": true
},
"@openmrs/esm-service-queues-app": {
"defaultInitialServiceQueue": "Outpatient Triage"
}
}Les onglets de types de visite recommandés sont également contrôlés par le formulaire de début de visite du dossier patient. Configurez showRecommendedVisitTypeTab et visitTypeResourceUrl sur @openmrs/esm-patient-chart-app, pas sur @openmrs/esm-service-queues-app.
Configuration des priorités
Configurez les tags de priorité avec des couleurs et des styles :
{
"@openmrs/esm-service-queues-app": {
"priorityConfigs": [
{
"conceptUuid": "04f6f7e0-e3cb-4e13-a133-4479f759574e",
"color": "red",
"style": null
},
{
"conceptUuid": "f4620bfa-3625-4883-bd3f-84c2cce14470",
"color": "green",
"style": null
},
{
"conceptUuid": "dc3492ef-24a5-4fd9-b58d-4fd2acf7071f",
"color": "orange",
"style": null
}
]
}
}Couleurs disponibles : red, magenta, purple, blue, teal, cyan, gray, orange, green, warm-gray, cool-gray, high-contrast, outline
Styles disponibles : bold (ou null pour aucun style spécial)
conceptUuid- UUID du concept de priorité à configurercolor- Couleur du tag de prioritéstyle- Style à appliquer (actuellement uniquementboldounull)
Mise en évidence du temps d’attente
Vous pouvez colorer le temps d’attente affiché dans les tableaux de files d’attente lorsqu’un patient a attendu au moins un certain nombre de minutes. Cela attire l’attention sur les patients qui sont dans la file depuis longtemps. Cette option est désactivée par défaut.
{
"@openmrs/esm-service-queues-app": {
"waitTimeThresholds": [
{ "waitTimeInMinutes": 60, "color": "orange" },
{ "waitTimeInMinutes": 120, "color": "red" }
]
}
}waitTimeInMinutes- Le temps d’attente minimal, en minutes, à partir duquel la couleur s’applique. Doit être un nombre positif.color-orangeoured(par défaut :red)
Lorsque plusieurs seuils correspondent, celui dont la valeur waitTimeInMinutes est la plus élevée l’emporte. Dans l’exemple ci-dessus, le temps d’attente passe à l’orange après une heure et au rouge après deux heures. Les mêmes seuils s’appliquent à l’attente la plus longue affichée sur l’écran d’administrateur de clinique.
UUID de concepts
Configurez les UUID de concepts utilisés dans tout le module des files d’attente de service :
{
"@openmrs/esm-service-queues-app": {
"concepts": {
"defaultPriorityConceptUuid": "f4620bfa-3625-4883-bd3f-84c2cce14470",
"defaultStatusConceptUuid": "51ae5e4d-b72b-4912-bf31-a17efb690aeb",
"defaultTransitionStatus": "ca7494ae-437f-4fd0-8aae-b88b9a2ba47d",
"emergencyPriorityConceptUuid": "04f6f7e0-e3cb-4e13-a133-4479f759574e",
"waitingStatusConceptUuid": "51ae5e4d-b72b-4912-bf31-a17efb690aeb"
}
}
}Concepts clés :
defaultPriorityConceptUuid- Priorité par défaut (par ex. “Pas urgent”)defaultStatusConceptUuid- Statut par défaut (par ex. “En attente”)defaultTransitionStatus- Statut lors de la prise en charge du service (par ex. “En service”)emergencyPriorityConceptUuid- Priorité la plus élevée (par ex. “Urgence”)waitingStatusConceptUuid- Statut des patients qui attendent d’être pris en charge (par ex. “En attente”). Sur le tableau de bord, le tableau de file ne liste que les entrées ayant ce statut, l’action Call n’apparaît que pour les entrées ayant ce statut, et le tableau de bord ainsi que la vue d’ensemble de la clinique l’utilisent pour calculer le nombre de patients en attente et les temps d’attente.
Tableaux de files d’attente
Configurez les colonnes et mises en page des tableaux de files d’attente. Il s’agit d’une fonctionnalité puissante qui vous permet de personnaliser les colonnes des tableaux par file et statut.
Définitions de colonnes
Définissez des colonnes personnalisées ou remplacez les colonnes intégrées :
{
"@openmrs/esm-service-queues-app": {
"queueTables": {
"columnDefinitions": [
{
"id": "patient-name",
"columnType": "patient-name",
"header": "Patient Name"
},
{
"id": "custom-identifier",
"columnType": "patient-identifier",
"header": "National ID",
"config": {
"identifierTypeUuid": "f85081e2-b4be-4e48-b3a4-7994b69bb101"
}
},
{
"id": "status",
"columnType": "status",
"header": "Status",
"config": {
"statusConfigs": [
{
"conceptUuid": "51ae5e4d-b72b-4912-bf31-a17efb690aeb",
"iconComponent": "Group"
},
{
"conceptUuid": "ca7494ae-437f-4fd0-8aae-b88b9a2ba47d",
"iconComponent": "InProgress"
}
]
}
},
{
"id": "actions",
"columnType": "actions",
"config": {
"actions": {
"buttons": ["call"],
"overflowMenu": ["move", "edit", "remove", "undo"]
}
}
},
{
"id": "queue-number",
"columnType": "queue-number",
"config": {
"visitQueueNumberAttributeUuid": "c0c579b0-8e59-401d-8a4a-976a0b183519"
}
},
{
"id": "eligibility",
"columnType": "extension",
"header": "Eligibility"
}
]
}
}
}Types de colonnes disponibles :
patient-name- Nom du patientpatient-identifier- Identifiant du patient (nécessiteidentifierTypeUuiddans la config)patient-age- Âge du patientcoming-from- D’où vient le patientextension- Colonne personnalisée rendue par un emplacement d’extensionpriority- Tag de prioritéstatus- Statut avec icônes (nécessitestatusConfigsdans la config)queue- Nom de la filequeue-number- Numéro de file (nécessitevisitQueueNumberAttributeUuid)visit-start-time- Heure de début de visitewait-time- Temps d’attenteactions- Boutons d’action (nécessite la configactions)
Icônes de statut : Group, InProgress
Types d’action : move, call, edit, remove, delete, undo
move couvre le déplacement d’un patient vers une autre file ainsi que le changement de son statut ou de sa priorité. L’ancienne action transition y a été fusionnée. transition est toujours acceptée dans la configuration mais se comporte comme move, vous pouvez donc la retirer de votre configuration.
Par défaut, la colonne d’actions affiche un bouton Call et un menu de débordement contenant move, edit, remove et undo. Call n’apparaît que pour les entrées ayant le statut d’attente. Pour les autres entrées, la première action disponible du menu de débordement (move par défaut) devient le bouton. undo n’apparaît que lorsque l’entrée a une entrée de file précédente vers laquelle revenir.
Si vous remplacez la colonne actions dans columnDefinitions, listez explicitement overflowMenu, comme le fait l’exemple ci-dessus. Sinon, sa valeur par défaut est edit, remove et undo, sans move.
Options de configuration des colonnes :
id- Identifiant unique de la colonnecolumnType- Type de colonne. Définissez-le sur chaque colonne que vous définissez, même lorsqu’il est identique àid. Une colonne sanscolumnTypelève une erreur « Unknown column type from configuration ».header- Texte d’en-tête (sera traduit s’il s’agit d’une clé de traduction valide)config- Configuration spécifique à la colonne :- Pour
patient-identifier:identifierTypeUuid- UUID du type d’identifiant - Pour
status:statusConfigs- Tableau des configurations d’icônes de statut - Pour
actions:actions.buttonsetactions.overflowMenu- Tableaux de types d’action - Pour
queue-number:visitQueueNumberAttributeUuid- UUID de l’attribut de visite contenant le numéro de file - Pour
extension: toute colonne d’extension rend l’emplacement d’extensionqueue-table-<column-id>-slotet transmetqueueEntrydans l’état de l’emplacement. Par exemple, une colonne avec l’IDeligibilityrendqueue-table-eligibility-slot.
- Pour
Définitions de tableaux
Définissez quelles colonnes apparaissent dans quels tableaux :
{
"@openmrs/esm-service-queues-app": {
"queueTables": {
"tableDefinitions": [
{
"columns": [
"patient-name",
"custom-identifier",
"priority",
"status",
"actions"
],
"appliedTo": [
{
"queue": "some-queue-uuid",
"status": "some-status-uuid"
}
]
},
{
"columns": [
"patient-name",
"coming-from",
"priority",
"queue-number",
"queue",
"wait-time",
"actions"
],
"appliedTo": [
{
"queue": "",
"status": ""
}
]
}
]
}
}
}columns- Tableau d’IDs de colonnes (depuiscolumnDefinitionsou colonnes intégrées)appliedTo- (Optionnel) Tableau de conditions spécifiant à quelles files/statuts ce tableau s’applique- Si omis, s’applique à tous les tableaux
- Une chaîne
queueoustatusvide signifie “toutes les files” ou “tous les statuts” - Si plusieurs définitions de tableau correspondent, la première est utilisée
Exemple : La première définition de tableau s’applique uniquement à une combinaison file/statut spécifique. La seconde s’applique à toutes les autres files et statuts, et correspond à la configuration intégrée par défaut. Placez les définitions spécifiques avant la définition générale, car la première définition correspondante est utilisée. Si aucune définition ne correspond, Service Queues utilise la définition intégrée par défaut.
Le tableau de bord de Service Queues cherche ses colonnes sans file ni statut : il n’utilise donc que les définitions dont queue et status sont tous deux vides (ou qui n’ont pas de appliedTo). Une définition pour le statut d’attente ne s’y applique pas non plus, même si le tableau de bord ne liste que les patients en attente. Les définitions propres à une file ou à un statut s’appliquent à la page de chaque file, à l’adresse ${openmrsSpaBase}home/service-queues/queue-table-by-status/<queue-uuid>. Elle affiche un tableau pour chaque statut autorisé par la file, sauf le statut « en service » (defaultTransitionStatus), dont les patients s’affichent sous forme de cartes au-dessus des tableaux.
Attribut de numéro de file d’attente de visite
Configurez l’attribut de visite qui contient le numéro de file :
{
"@openmrs/esm-service-queues-app": {
"visitQueueNumberAttributeUuid": "c0c579b0-8e59-401d-8a4a-976a0b183519"
}
}La valeur par défaut est c0c579b0-8e59-401d-8a4a-976a0b183519, le type d’attribut Visit Queue Number du contenu de démonstration de l’application de référence. Le tableau intégré par défaut affiche une colonne queue-number : si votre distribution enregistre les numéros de file dans un autre type d’attribut de visite, définissez ici son UUID (ou définissez-le par colonne dans columnDefinitions).
Types d’identifiants par défaut
Configurez les types d’identifiants affichés dans la modale d’appel du patient :
{
"@openmrs/esm-service-queues-app": {
"defaultIdentifierTypes": [
"05ee9cf4-7242-4a17-b4d4-00f707265c8a",
"f85081e2-b4be-4e48-b3a4-7994b69bb101"
]
}
}La modale d’appel du patient affiche les identifiants du patient appartenant à ces types.
Type d’attribut de contact
contactAttributeType figure toujours dans le schéma de configuration, mais rien dans les files d’attente de service ne le lit : le définir n’a donc aucun effet.
URL du dossier patient
Configurez où les utilisateurs sont redirigés lors du clic sur un nom de patient :
{
"@openmrs/esm-service-queues-app": {
"customPatientChartUrl": "${openmrsSpaBase}/patient/${patientUuid}/chart"
}
}Le modèle d’URL prend en charge :
${openmrsSpaBase}- URL de base pour le SPA${openmrsBase}- URL de base pour le backend OpenMRS${patientUuid}- UUID du patient
Appel des patients et écran de file d’attente
Lorsqu’un utilisateur clique sur Call pour une entrée de file, l’app des files d’attente de service envoie le numéro de ticket du patient et une chaîne de statut au point de terminaison queueutil/assignticket du module backend queue. L’écran de file d’attente, accessible à ${openmrsSpaBase}home/service-queues/screen, fait clignoter un ticket tant qu’il a ce statut.
La chaîne de statut par défaut est calling. Si votre système d’affichage dynamique attend une autre valeur, comme Now serving, modifiez-la :
{
"@openmrs/esm-service-queues-app": {
"callingStatus": "Now serving"
}
}Évitez completed, car le backend des files d’attente l’interprète comme un signal pour retirer le ticket.
Écran d’administrateur de clinique
Les utilisateurs qui disposent du privilège d’administrateur de clinique voient deux onglets sur le tableau de bord des files d’attente de service. Le premier, Clinic overview, affiche des chiffres pour chaque file du lieu sélectionné, notamment le nombre de patients en attente et en service, ainsi que l’attente moyenne et l’attente la plus longue. Le second, Waiting list, est le tableau de bord standard. Les utilisateurs qui n’ont pas ce privilège ne voient aucun onglet, et leur tableau de bord reste inchangé.
{
"@openmrs/esm-service-queues-app": {
"clinicAdministratorScreen": {
"privilege": "App: Service Queues Clinic Administrator"
}
}
}privilege- Le privilège qui donne accès à la vue d’ensemble de la clinique (par défaut :App: Service Queues Clinic Administrator)
Le privilège doit exister dans la configuration backend de votre distribution et être attribué à un rôle. Le contenu de démonstration de l’application de référence le définit et l’attribue au rôle Organizational: System Administrator. Tant qu’il n’est attribué à aucun rôle, seuls les utilisateurs ayant le rôle System Developer voient les onglets. Définir privilege sur une chaîne vide masque les onglets pour tout le monde.
Intervalles d’actualisation
Le tableau de bord des files d’attente de service et l’écran de file d’attente interrogent régulièrement le serveur pour obtenir les mises à jour. Chacun dispose d’un intervalle pour les moments où l’utilisateur est actif et d’un intervalle plus lent pour les moments où il est devenu inactif :
{
"@openmrs/esm-service-queues-app": {
"refreshIntervals": {
"dashboard": {
"active": 60000,
"idle": 120000
},
"queueScreen": {
"active": 5000,
"idle": 10000
}
}
}
}Toutes les valeurs sont en millisecondes et doivent être comprises entre 1000 et 3600000. Les valeurs ci-dessus sont les valeurs par défaut.
Un utilisateur est considéré comme inactif lorsqu’il n’a pas bougé la souris, cliqué, saisi au clavier, touché l’écran ni fait défiler la page depuis une minute, ou lorsque l’onglet du navigateur est masqué. L’interrogation s’arrête complètement tant que l’onglet est masqué, et le tableau de bord s’actualise dès que l’utilisateur y revient. L’intervalle d’inactivité de l’écran de file d’attente est volontairement court afin qu’un écran mural laissé sans surveillance reste raisonnablement à jour.
Ajout d’un patient à la file d’attente
Par défaut, avant que l’utilisateur ne saisisse un terme de recherche, l’espace de travail Add patient to queue liste les patients dont la visite a commencé aujourd’hui au lieu sélectionné et est toujours ouverte, et qui ne sont pas encore dans une file de ce lieu. Pour passer directement à la recherche, désactivez cette option :
{
"@openmrs/esm-service-queues-app": {
"showCheckedInPatientsBeforeSearch": false
}
}Lignes dépliées des tableaux de files d’attente
Déplier une ligne d’un tableau de file d’attente affiche un résumé de la visite en cours du patient. Deux paramètres contrôlent son contenu :
{
"@openmrs/esm-service-queues-app": {
"appointmentStatuses": ["Scheduled", "CheckedIn", "Completed", "Missed"],
"visitAttributeTypes": [
{ "uuid": "57ea0cbb-064f-4d09-8cf4-e8228700491c" },
{ "uuid": "aac48226-d143-4274-80e0-264db4e368ee" }
]
}
}appointmentStatuses- Les statuts des rendez-vous du jour du patient à afficher dans le résumé. Les options sontRequested,WaitList,Scheduled,Arrived,CheckedIn,Completed,CancelledetMissed. Utilisez un tableau vide pour masquer les rendez-vous du jour. Les valeurs ci-dessus sont celles par défaut.visitAttributeTypes- Les types d’attributs de visite dont les valeurs s’affichent sous forme de tags dans le résumé, comme les tags d’attributs de visite de l’en-tête patient. Par défaut, ce sont les types Punctuality et Insurance Policy Number du contenu de démonstration de la Reference Application.
Service Queues 12.1.0 a ajouté visitAttributeTypes et modifié la valeur par défaut de appointmentStatuses. Les versions antérieures utilisent par défaut Requested, Scheduled, CheckedIn, Completed, Cancelled et Missed.