Serveur terminologique

Oui, les appels d’API suivants permettent d’obtenir la version la plus récente des systèmes de codes, comme SNOMED CT et pCLOCD, dans la collection Postman.  Pour savoir comment accéder à la collection Postman, consultez les Instructions pour l’utilisation de Postman.

• Pour SNOMED CT, utilisez :
• HTTP GET
  https://terminologystandardsservice.ca/fhir/CodeSystem?url=http://snomed.info/sct&_elements=version&_sort=-version&_count=1

• Pour pCLOCD, utilisez :
• HTTP GET
  https://terminologystandardsservice.ca/fhir/ValueSet/$expand?url=https://fhir.infoway-inforoute.ca/CodeSystem/pCLOCD?fhir_vs&count=0

Vous devrez vous authentifier pour pouvoir faire ces requêtes.
Voici un exemple de commande cURL :

Oui, il existe deux façons d’accéder au contenu. Vous pouvez utiliser une API, par exemple avec Postman, qui permet de traiter de grands volumes de données sans imposer de limites comme le font certains autres outils. Vous pouvez voir une démonstration dans notre vidéo de formation intitulée Terminology Server Drop-in Session FHIR API (à 35 min. 20 sec.). Si vous avez besoin d’accéder à l’intégralité du contenu, le serveur de syndication vous permet de tout récupérer.

Vous devez choisir le format de téléchargement approprié selon vos besoins. La représentation en format FHIR est toujours disponible, sauf pour SNOMED CT et LOINC. Pour ces deux systèmes de codes, il existe des versions binaires et natives puisqu’ils ne peuvent pas être représentés dans un format de fichier plat. Pour des artéfacts plus simples et plus courants, le système de syndication permet d’accéder aux données requises.

Ontoserver offre une grande flexibilité : il peut être intégré à un système, ou encore être utilisé de façon autonome. Avec les API FHIR, Ontoserver peut aussi être utilisé avec des fonctionnalités propres à un fournisseur et permettre à un système de trouver des représentations particulières de la terminologie, selon les besoins.

Un menu situé dans le coin supérieur droit de l’écran, dans Shrimp, permet de choisir la langue de l’interface (y compris des menus et des liens), mais aussi celle du contenu terminologique. Vous pouvez donc choisir « en » ou « fr » pour naviguer dans la langue de votre choix. Comme Shrimp est utilisé partout dans le monde, le menu peut contenir d’autres options de langue, par exemple, « id » pour l’indonésien. Ces options n’ont aucune incidence sur le contenu terminologique canadien, qui n’est disponible qu’en anglais et en français. Consultez le guide d’utilisation de Shrimp pour en savoir plus sur cette nouvelle fonctionnalité. Elle est toujours en cours d’amélioration, et nous vous remercions de votre patience.

Oui, l’expression « latest » renvoie à la version la plus récente du système de codes disponible dans le flux de versions actuel. Avec le serveur terminologique, nous voulons rendre accessible le contenu le plus à jour possible. Pour en savoir plus sur la navigation dans les systèmes de codes, consultez le guide d’utilisation et la vidéo de formation sur Shrimp, accessibles à partir de la section sur les ressources de formation.

Du point de vue de FHIR, le « code.system » de l'édition canadienne (CA) de SNOMED CT est le système de codes international par défaut : http://snomed.info/sct. La « version » serait incluse pour indiquer qu'un code provient de l'édition CA. Cette version est basée sur le module le plus dépendant (« Canada Health Infoway French module ») : http://snomed.info/sct/20611000087101.

Si, dans le cadre d'un projet d'implantation, on n'utilise pas un service de terminologie canadien comme le serveur terminologique d'Inforoute (qui utilise par défaut l'édition canadienne), les solutions devront inclure l'édition canadienne de SNOMED CT (pour la « coding.version »).

Exemples de cas d'utilisation

1. Exemple de format recommandé qui n’inclut pas la version, à utiliser au Canada dans les écosystèmes où les outils et les logiciels des fournisseurs utilisent implicitement l'édition canadienne de SNOMED CT pour leurs ensembles de valeurs, leurs services de terminologie (ex. catalogue national des vaccins), etc.
   "vaccineCode": {
     "coding": {  {
       "system":  "http://snomed.info/sct",
         "code":  "34921000087108"
     }  }
   }
2. Voici un exemple de format recommandé qui inclut la version, à utiliser dans les écosystèmes où l'échange de données pourrait s'effectuer avec des outils et des logiciel de fournisseurs qui sont aux États-Unis ou dans d'autres pays et qui n'utilisent pas par défaut l'édition canadienne de SNOMED CT. Il pourrait s’agir de solutions qui utilisent par défaut l'édition internationale ou américaine de SNOMED CT, par exemple celles d’un fournisseur des États-Unis qui offre des services au Canada (ex. applications pour téléphones intelligents).
   "vaccineCode": {
     "coding": {  {
       "system":  "http://snomed.info/sct",
       "version": "http://snomed.info/sct/20611000087101",
         "code":  "34921000087108"
     }  }
   }

Directives sur l’inclusion de la version du système de codes

Les responsables de l'implantation doivent consulter le guide d'implantation de FHIR pertinent pour savoir s'il convient d’inclure la version du système de codes.

Les auteurs de guides d'implantation de FHIR doivent suivre les directives ci-dessus, en fonction de l'écosystème d'échange de données.

Une partie de la plateforme Terminology Gateway sera mise hors service le 30 avril 2025 conformément à notre volonté d’améliorer nos services. À partir de cette date, elle ne contiendra plus les publications de normes en continu – seul le contenu terminologique de PrescripTIon^MC y sera tenu à jour. Pour les publications de normes dans l’avenir, il faudra passer par notre serveur terminologique FHIR.

La publication de mars 2025 de l’édition canadienne de SNOMED CT, de pCLOCD, du RCM et des ensembles de valeurs sera la dernière à être diffusée sur Terminology Gateway pour le téléchargement. Par la suite, vous devrez passer par le serveur terminologique pour tous les téléchargements et les téléversements. Nous vous invitons à rapidement adopter le serveur terminologique FHIR afin de profiter de son contenu à jour et de ses fonctionnalités robustes. Consultez les ressources de formation mises à votre disposition pour vous aider à utiliser le nouveau serveur et profiter de ses avantages.

Nous vous remercions de votre compréhension et de votre collaboration pendant cette période de transition. Nous sommes disponibles pour vous aider à chaque étape du processus.

Oui, Ontoserver vous permet de parcourir le contenu terminologique, d’y faire des recherches et de le télécharger dans divers formats, selon vos besoins. Avec les API FHIR, vous pouvez intégrer du contenu terminologique par programmation, accéder aux fichiers dans des formats utilisés par FHIR, plus précisément les formats XML et JSON, et obtenir des représentations en format CSV pour certaines opérations, comme ValueSet $expand. Pour automatiser le téléchargement de ressources terminologiques, vous disposez de l’API de syndication, qui fournit des listes détaillées pour chaque système de codes. Le navigateur Shrimp offre une interface intuitive pour chercher et explorer du contenu terminologique, et notre interface OntoCommand améliorée vous permet de télécharger directement des ensembles de valeurs et des systèmes de codes dans le format qui vous convient.  

Les systèmes d’extrémité peuvent accéder à Ontoserver en cours d’exécution et utiliser son contenu. Cependant, l’accord sur les niveaux de service (ANS) du serveur terminologique d’Inforoute ne permet pas, pour l’instant, l’utilisation en cours d’exécution par des systèmes d’extrémité. Il est toutefois possible d’élargir la portée de l’ANS selon les niveaux d’utilisation et d’interaction prévus. Par ailleurs, les systèmes consommateurs peuvent effectuer une syndication du contenu du serveur terminologique et, ainsi, utiliser les données terminologiques de façon autonome, notamment en cours d’exécution.

Si vous avez de la difficulté à vous connecter, suivez ces étapes :

1. Actualisez la page : une simple actualisation règle parfois le problème.
2. Supprimez les témoins de navigation : si le problème est causé par des données en mémoire cache, cette action les supprimera.
3. Utilisez un autre navigateur : accédez au site à l’aide d’un autre navigateur pour voir si le problème persiste.

Si le problème persiste malgré tout, communiquez avec nous pour obtenir de l’aide.

Grâce à vos commentaires, nous pouvons améliorer et parfaire notre serveur terminologique. Nous espérons profiter de votre collaboration et de votre soutien en continu pour, ensemble, faire progresser l’interopérabilité en santé au Canada. Cliquez sur le lien « Communiquez avec nous » pour nous faire part de vos commentaires.

Communiquez avec nous

Dans le contexte de l’informatique de la santé, et plus particulièrement dans le cas de normes comme FHIR (Fast Healthcare Interoperability Resources), un ensemble de valeurs consiste en un ensemble de représentations de concept valides identifiables de manière unique. Il prend la forme d’un ensemble de codes ou de termes tirés d’un ou de plusieurs systèmes de codes et est utilisé pour déterminer les valeurs admissibles pour un élément en particulier dans une ressource liée à la santé. Il est possible de tester chaque concept de l’ensemble de valeurs pour déterminer s’il est inclus à l’ensemble ou non.

Dans Terminology Gateway, le terme sous-ensemble désigne un ensemble dont tous les éléments sont également contenus dans un autre ensemble. Ainsi, si l’ensemble B est un sous-ensemble de l’ensemble A, l’ensemble B ne contient que des éléments également compris dans l’ensemble A. Ces sous-ensembles incluent des listes de valeurs ou termes soumis à des contraintes et tirés des systèmes de codes sources (extension canadienne de SNOMED CT, pCLOCD, UCUM, SCP ou HL7).

Les termes « ensemble de valeurs » et « sous-ensemble » sont donc utilisés de manière interchangeable. Les sous-ensembles hébergés précédemment dans Terminology Gateway correspondent aux ensembles de valeurs maintenant hébergés dans le serveur terminologique FHIR.

Dans le cadre de la transition vers le serveur terminologique fondé sur FHIR, les façons d’accéder aux ensembles de valeurs à des fins de révision ne changeront pas. Les URI canoniques de FHIR pour les ensembles de valeurs dans les guides d’implantation devraient déjà refléter les URI de FHIR pour les ensembles de valeurs et être liés au nouveau serveur terminologique fondé sur FHIR.

Oui, le serveur terminologique peut prendre en charge toutes les opérations terminologiques FHIR, y compris l’élément de composition d’un ensemble de valeurs (intensionnel comme extensionnel) aux fins de l’opération $validate-code. La méthode actuelle consiste à charger la totalité des ensembles de valeurs sur le serveur terminologique sous la forme composée plutôt que sous la forme préalable à l’expansion, de façon à pouvoir utiliser des fonctionnalités avancées, comme $validate-code, et des opérations $expand. Ces opérations permettent d’effectuer des expansions globales, mais aussi diverses expansions ciblées en fonction de certains paramètres. Pour en savoir plus, consultez la documentation sur FHIR d’HL7.

Les ensembles de valeurs HL7 seront mis à jour automatiquement dans le serveur terminologique à partir des versions de la terminologie HL7 (THO). Les mises à jour et les changements seront apportés uniquement dans le serveur terminologique. La section sur les ressources de formation inclut des ressources et des documents de formation détaillés qui vous aideront à naviguer dans le serveur terminologique et à accéder efficacement aux ensembles de valeurs. Les ajouts ou les changements aux ensembles de valeurs ne peuvent être apportés qu’à la suite d’une demande de changement.

On utilisera le versionnage sémantique pour tous les ensembles de valeurs pancanadiens définis par Inforoute à la suite de la migration vers le nouveau serveur terminologique.

• Le versionnage sémantique constitue une pratique exemplaire, surtout maintenant que nous passons à un serveur terminologique entièrement fondé sur FHIR. Cette pratique limite les conflits et le travail de maintenance pour les responsables de l’implantation et du développement du Guide d’implantation FHIR puisqu’elle garantit une structure plus uniforme pour la gestion des versions. On règle ainsi certains problèmes liés au versionnage dynamique dans Terminology Gateway, problèmes connus des experts de la communauté et documentés. Pour en savoir plus, consultez la discussion en ligne sur le versionnage et FHIR.

Nouveautés pour les responsables de l’implantation:

• Versionnage de base : Sur le nouveau serveur terminologique, tous les ensembles de valeurs auront une version de base, la version 1.0.0, et on utilisera le versionnage sémantique pour les mises à jour, pour améliorer la stabilité et la prévisibilité.
• Guides d’implantation de FHIR avec des substituts d’ensembles de valeurs : L’utilisation de guides d’implantation de FHIR qui reposent sur des substituts d’ensembles de valeurs dont la version est fondée sur la date risque d’entraîner des collisions s’ils sont utilisés avec des outils FHIR. Ces outils tenteront de comparer le substitut dont la version est fondée sur la date avec l’ensemble de valeurs qui se trouve dans le serveur terminologique et dont la version est sémantique et sera incapable de déterminer lequel a préséance. Les guides d’implantation de FHIR qui reposent sur des substituts d’ensembles de valeurs doivent être publiés de nouveau et inclure des versions sémantiques, en plus de prévoir une antidatation suffisante (p. ex. 1900-01-01).
• Continuité avec Terminology Gateway : Une partie de Terminology Gateway sera mise hors service. Il ne contiendra dorénavant que le contenu lié à PrescripTIon^MC. SurTerminology Gateway, la pratique de gestion des versions restera la même pour l’instant pour assurer la continuité du service pour les intervenants qui l’utilisent pendant la transition. 
• Uniformité et clarté : Avec le versionnage sémantique, les utilisateurs saisissent plus facilement l’ampleur d’un changement, et les responsables de l’implantation peuvent en évaluer l’impact. Une mise à jour importante (p. ex., 2.0.0) entraînera d’importants changements, tandis qu’une mise à jour mineure ou l’apport de correctifs (p. ex., 1.1.0 ou 1.0.1) ne devrait pas causer d’interruption de service.
• Compatibilité et simplification des mises à niveau : Les responsables de l’implantation peuvent reconnaître plus facilement les nouveautés rétrocompatibles, et savoir si une mise à niveau mineure suffit, ou s’ils doivent effectuer une mise à niveau majeure.
• Amélioration de la gouvernance et de la gestion du changement : Avec la nouvelle pratique de versionnage, les responsables de l’implantation pour harmoniser leurs processus de gestion des mises à jour et établir des protocoles qui facilite l’adoption du changement et limite les risques de perturbation.
• Incidence sur les délais d’implantation : Contrairement à la gestion des versions fondée sur la date, le versionnage sémantique est fondé sur la nature des changements. Il ne suit pas un calendrier fixe, ce qui peut avoir une incidence sur les moments où une mise à jour doit être effectuée.

La transition vise à simplifier la gestion des ensembles de valeurs, à accroître la stabilité et à simplifier le processus d’implantation, tant pour les développeurs que pour les utilisateurs.