Annonce importante : Nous avons le plaisir d'annoncer que des améliorations majeures ont été apportées à notre serveur terminologique fondé sur FHIR, qui offre maintenant un accès plus facile et plus convivial au contenu terminologique destiné à l'échange de données sur les soins de santé. Découvrez les nouvelles fonctionnalités et les changements à venir.
En savoir plus >
A syndication feed represents a more mature web technology known as a Really Simple Syndication (RSS) Feed. It is a mechanism by which users can be notified of updates to content on a particular site. Infoway’s Terminology Server uses this mechanism to update users on new files available for download and provides users with the information necessary to be able to download the various files successfully.
Downloading Artifacts using Syndication Feed (RSS Feed)
Users can programmatically download files related to the various CodeSystems and ValueSets using the Syndication Feed. Files that are available for download are SNOMED CT CA RF2, SNOMED CT CA ValueSet, CCDD, pCLOCD and ValueSets files. The URLs below are publicly accessible meaning you do not require any credentials to access them. However, system credentials are needed to download the actual files. The feed is an XML formatted list of files available for download for each code system. To get started, please follow the ‘Syndication Download Instructions’ below.
If you or your team manage a Terminology Server, preferably an instance of OntoServer, then you may use the following syndication feeds to easily import new terminology data into your terminology server. This is essentially a synchronization feature, where updates to terminologies like SNOMED CT CA, pCLOCD and others, can be easily ingested into your instance of OntoServer on a regular basis. The formats of files available for download are FHIR JSON Resources and/or Indexed Binary data. Binary data is a product of processing that is done ahead of loading the data into the OntoServer instance; saving the user time and effort from having to repeat the process. Based on release cycles for the various code systems, you can create a script or CRON job to download newly available files from Infoway’s Terminology Server.
Syndication Download Instructions
This user guide will help you use the Syndication Feed to download the desired files. In this example, we use the SNOMED RF2 file.
Step-by-Step Instructions on Downloading files
Please Ensure that you have a system account to download the files. Request Access Here
Making an HTTP GET Request to the Syndication API.
The response will be in XML format and will look something like this:
Get a Token : In order to download the file, you must get a token first. In order to get the token, you can call the authorization service with your Client ID and Client Secret. You must acquire these credentials using the system account access request form.
Downloading the File To download the file, use the `href` property from the <link> element in the sample response in section 2. You will need to include a Bearer token for authorization. First, obtain a token using your client ID and secret described in the previous section. Then, use the token in the following curl command to save the output to a file:
Replace YOUR_ACCESS_TOKEN with the token you obtained and snomed_rf2_release.zip with your desired file name.
Verify the downloaded file
From the XML response in section 2, you may use the ncts:sha256Hash property to verify the SHA256 checksum. Below are commands that can be used to generate the SHA256 hash locally on your machine and compare that to the one on the XML Response.
Windows Powershell Command Get-FileHash <file> -Algorithm SHA256
Le serveur terminologique est une solution moderne qui permet d’héberger de nombreuses normes, dont SNOMED CT, LOINC, pCLOCD, le Répertoire canadien des médicaments (RCM) et la terminologie de PrescripTIonMC. Il remplacera éventuellement Terminology Gateway; si vous aviez accès à ce dernier, vous devriez automatiquement pouvoir accéder au nouveau serveur.
Liens utiles
Outil
Description
URL
Ontocommand
OntoCommand est une interface utilisateur d’administration qui vient avec Ontoserver.
Shrimp est un outil accessible gratuitement en ligne permettant de parcourir les systèmes de codes (codeSystem) FHIR, plus particulièrement sous forme de hiérarchie. Il est optimisé pour SNOMED CT et LOINC.
Snapper est un outil de rédaction qui permet de voir et de mettre à jour trois types de ressources FHIR : systèmes de codes (codeSystem), ensembles de valeurs (valueSet) et mappages conceptuels (conceptMaps).
Cliquez sur Login (Connecter) dans le coin supérieur droit.
Vous serez redirigé vers la page d’authentification unique OpenAM et pourrez vous connecter à partir du même compte InfoCentral qu’auparavant.
Une fois connecté, vous accéderez à la page principale du nouveau serveur terminologique.
Vous devriez pouvoir voir les terminologies disponibles en cliquant sur Resources (Ressources) dans le menu de gauche.
Si vous avez de la difficulté à vous connecter, actualisez la page, supprimez les témoins de navigation ou changez de navigateur. Si le problème persiste, communiquez avec nous pour obtenir de l’aide.
Shrimp
Shrimp est l’outil utilisé pour parcourir les systèmes de codes (CodeSystem) et les ensembles de valeurs (ValueSet). Il existe deux façons d’y accéder : vous pouvez accéder à Shrimp directement, ou passer par l’URL OntoCommand ci-dessous. Vous devrez peut-être vous connecter à Shrimp; utilisez les mêmes justificatifs d’accès que pour le serveur terminologique.
Snapper est un outil de rédaction qui permet aux utilisateurs d’ajouter ou de mettre à jour des systèmes de codes (CodeSystem) et des ensembles de valeurs (ValueSet). Vous pouvez y accéder à l’aide du lien direct ou de l’URL OntoCommand. La première fois que vous y accéderez, l’outil vous demandera d’accepter les conditions d’utilisation.
N.B. : Sauf indication contraire, les liens ci-dessous renvoient à du contenu en anglais.
Introduction
Inforoute Santé du Canada est fière de présenter son nouveau serveur terminologique, une solution sous forme de service géré très pratique pour les spécialistes des normes, les développeurs, les organisations de la santé, les fournisseurs et les consommateurs de données sur la santé partout au pays.
Notre serveur terminologique s’appuie sur le serveur Ontoserver du CSIRO. Il s’agit d’un serveur de terminologies cliniques de classe mondiale qui permet d’implanter des services terminologiques FHIR et d’intégrer du contenu de syndication. Grâce à cette technologie évoluée, notre serveur terminologique est à la fine pointe de l’interopérabilité en santé et contribue à améliorer les soins de santé au Canada.
Qu’est-ce qu’un serveur terminologique?
Le serveur terminologique d’Inforoute est une solution infonuagique entièrement conforme à la norme FHIR d’HL7 qui permet de stocker, de conserver et de diffuser des terminologies approuvées à l’échelle nationale et internationale. Il offre extensivité, sécurité, fiabilité et flexibilité, et garantit aux utilisateurs un accès sécurisé. Le serveur héberge des terminologies pancanadiennes et internationales de grande qualité ainsi que des ensembles de valeurs, et permet aux fournisseurs de données sur la santé, aux systèmes et aux solutions de santé numériques d’y accéder et de les partager. Il facilite ainsi la normalisation des données sur la santé, en plus de favoriser l’interopérabilité et l’uniformité sémantique.
Quels sont les avantages du serveur terminologique?
Centralisation de l’accès aux terminologies de la santé normalisées. Sert de répertoire centralisé pour les personnes qui utilisent ou tiennent à jour les terminologies de la santé normalisées, et assure l’uniformité en lien avec la collecte et l’échange de données.
Levier pour l’interopérabilité. Permet des mises à jour plus fréquentes des terminologies cliniques normalisées dans diverses solutions et divers systèmes numériques pancanadiens, fournissant ainsi au personnel de la santé une information normalisée plus fiable pour soutenir la prise de décisions éclairées au sujet des traitements et améliorer les soins aux patients.
Moteur de collaboration. Offre des outils pour utiliser et créer du contenu, ce qui favorise la participation à l’écosystème de la santé et le travail collaboratif.
Possibilités d’utilisations spécialisées des terminologies. Rend disponible de l’information comparable, ce qui permet de tirer profit des terminologies pour améliorer la recherche, l’analyse et la production de rapports.
Capacités terminologiques FHIR pleinement fonctionnelles. Permet l’utilisation des ressources et opérations FHIR pour la gestion terminologique, dont les opérations de recherche (Search), de création (Create), de lecture (Read), de mise à jour (Update) et de suppression (Delete) en lien avec les ressources ValueSet, ConceptMap, CodeSystem, NamingSystem et StructureDefinition, et des opérations terminologiques, comme $expand, $validate-code, $lookup, $subsumes, $find-matches, $closure, $translate et $validate.
Modélisation de l’information et élaboration de spécifications. Soutient les schémas conceptuels (mappages), relie la terminologie et les ensembles de valeurs aux spécifications et modèles de données, valide le contenu de la terminologie en fonction des spécifications, et garantit la conformité des ressources FHIR.
Contenu du serveur terminologique
Le serveur terminologique donne accès à des ensembles de valeurs, des systèmes de codes et d’autres artéfacts terminologiques pour des classifications et terminologies canadiennes et internationales, notamment :
l’édition canadienne de SNOMED CT
pCLOCD
UCUM
les ensembles de valeurs pancanadiens
le Répertoire canadien des médicaments (RCM)
Qui peut utiliser le serveur terminologique?
Le serveur terminologique s’adresse aux :
provinces et territoires
développeurs
fournisseurs
organisations de la santé et fournisseurs de données sur la santé
spécialistes des normes terminologiques de la santé
chercheurs dans le domaine de la santé
Accéder au serveur terminologique
Pour accéder au serveur terminologique, une personne doit passer par son compte InfoCentral. Un guide d’accès au serveur terminologique fournit des directives détaillées pour l’accès au serveur terminologique et son utilisation.
Le serveur terminologique inclut de solides mesures de sécurité, dont le contrôle d’accès basé sur les rôles, le chiffrement et l’utilisation de journaux de vérification, afin de protéger les données terminologiques sensibles et de garantir que seules les personnes autorisées peuvent y accéder. Inforoute demeure déterminée à placer la sécurité et la confidentialité au cœur de toutes ses activités, y compris des relations avec ses partenaires et du déploiement de nouvelles solutions et de nouveaux outils.
Le serveur terminologique fournit aussi des API RESTful HTTP et prend en charge les formats JSON et XML. Ainsi, tout moteur d’intégration ou toute application ou plateforme capable de faire des appels RESTful HTTP et de traiter les formats JSON ou XML peut interagir avec le serveur terminologique. Les API FHIR permettent une intégration en profondeur avec le serveur terminologique et facilitent l’abonnement au contenu récent et son téléchargement, ainsi que l’utilisation de la terminologie au moment de l’exécution. L’utilisateur peut ainsi profiter pleinement de la terminologie et obtenir des données normalisées grâce à une représentation des données plus uniforme.
Le serveur terminologique prend en charge diverses approches d’intégration, ce qui permet aux systèmes d’intégrer le contenu terminologique le plus récent et d’en créer des représentations internes. Les fonctionnalités propres à un fournisseur peuvent également trouver plus facilement des représentations de la terminologie propres à un système, au besoin. Le fait de rendre la terminologie disponible par le truchement d’API garantit aux différents systèmes et fournisseurs un accès uniforme à la terminologie. Tant les systèmes de grande envergure que les petits fournisseurs profitent de cette approche, qui favorise l’utilisation de données normalisées et l’interopérabilité.
Accès par un système
Les administrateurs de système et les développeurs peuvent choisir de communiquer avec le nouveau serveur terminologique à l’aide d’une application logicielle ou d’un script automatisé. Pour faire des appels d’API au serveur terminologique d’Inforoute, vous avez besoin d’un compte de système. Le processus de demande de compte de système, précise la marche à suivre pour obtenir ce type de compte. Vous devrez envoi d’un formulaire de demande précise la marche à suivre pour obtenir ce type de compte. Vous devrez envoyer un formulaire de demande pour obtenir des données d’accès au serveur pour vous, pour un projet ou pour une organisation. Ces données d’accès permettent d’obtenir un jeton d’authentification grâce auquel le système peut communiquer avec le serveur terminologique sans devoir utiliser un nom d’utilisateur et mot de passe personnels. Les données d’accès doivent demeurer confidentielles, comme tout nom d’utilisateur et mot de passe.
Quelques exemples de l’utilité des appels d’API :
Interroger une API FHIR du serveur terminologique pour accéder, par exemple, aux systèmes de code (CodeSystems) et aux ensembles de valeurs (ValueSets.
Télécharger des fichiers à partir du serveur de syndication du serveur terminologique
Intégration d'outils d’HL7
Le nouveau serveur terminologique permet une intégration facile avec les outils FHIR d’HL7 International, dont l’outil de publication de guides d’implantation (IG Publisher) et l’outil de validation (Validator), ce qui offre de nombreux avantages :
Accès direct, pour les utilisateurs, aux ensembles de valeurs et aux systèmes de code définis dans les guides d’implantation et hébergés par Inforoute, sans avoir à dupliquer du contenu ou à utiliser un substitut des ensembles de valeurs.
Accès, dans l’outil de validation FHIR d’HL7, aux ensembles de valeurs et systèmes de code hébergés par Inforoute, ce qui évite la gestion à part du contenu à des fins de validation.
Mise à jour automatique des terminologies canadiennes, comme l’édition canadienne de SNOMED CT, dans l’écosystème HL7, garantissant aux utilisateurs un accès à la version la plus récente des normes rapidement et sans intervention manuelle.
Simplification des processus de validation pendant des événements comme les projetathons et le connectathon IHE, grâce à un accès direct aux terminologies hébergées par Inforoute, ce qui permet de gagner du temps et simplifie les tests de conformité.
Il existe divers outils pour mieux comprendre et utiliser les ressources FHIR accessibles par le serveur terminologique d’Inforoute.
Navigateur Shrimp
Parcourir et explorer les systèmes de codes et les hiérarchies
Parcourir et explorer les ensembles de valeurs
Créer et évaluer des expressions ECL pour SNOMED CT
Télécharger les expansions ECL pour SNOMED CT
OntoCommand:
Comprendre quelles sont les ressources FHIR disponibles sur le serveur
Visualiser les métadonnées liées aux ressources
Comparer les ressources FHIR
*NOUVEAUTéléchargez les systèmes de codes (CodeSystems) en différents formats (p. ex. format RF2 pour SNOMED CT, format Excel pour pCLOCD et le RCM, et format d'HL7)
*NOUVEAUFaites l’extraction des artéfacts d'ensembles de valeurs (ValueSets) pancanadiens en format CSV, JSON ou XML
*NOUVEAUTrouvez le contenu terminologique dont vous avez besoin à l'aide des capacités de recherche améliorées
*NOUVEAUVisualisez et téléchargez une liste des éléments contenus dans un ensemble de valeurs, ainsi que des rapports détaillés sur les changements qui incluent des comparaisons entre les versions
*NOUVEAUVisualisez les changements apportés à une version spécifique d’un système de code ou d’un ensemble de valeurs directement dans OntoCommand
Snapper:
Comprendre la création d’une ressource FHIR
Télécharger une ressource FHIR
Syndication
Dans le contexte de ce serveur terminologique, la syndication consiste en la capacité de communiquer avec une source préconfigurée et prédéfinie (comme un serveur) afin d’en récupérer des index binaires et des ressources FHIR à l'aide d'une API de syndication.
Outil
Description
Lien direct
Documentation
Tableau de bord terminologique (OntoCommand)
OntoCommand prend la forme d’un tableau de bord et permet d’interagir avec un serveur terminologique FHIR.
Shrimp est un navigateur en ligne permettant de parcourir les ressources CodeSystem, plus particulièrement sous forme de hiérarchie. Il est optimisé pour SNOMED CT et LOINC.
Les utilisateurs n’ont pas tous le même degré de connaissance et de compréhension du fonctionnement du serveur terminologique (Ontoserver). Voici quelques ressources de formation accessibles en ligne, en anglais seulement, qui aident à comprendre la solution et à en tirer pleinement profit.
Les partenaires externes, dont les spécialistes des normes, les organismes gouvernementaux, les développeurs de spécifications d’interopérabilité et les fournisseurs et consommateurs de données sur la santé de partout au pays, profiteront d’une meilleure interopérabilité sémantique en santé et pourront adopter plus facilement les terminologies cliniques et autres systèmes de codes et accéder plus rapidement aux normes nationales et internationales. Inforoute est fière de son partenariat avec Dedalus et compte continuer à rassembler les partenaires indispensables du secteur de la santé pour faire avancer les solutions de santé numériques interopérables et favoriser un réseau de la santé connecté.
Le partenariat avec Dedalus visant à développer le serveur terminologique marque une étape importante de l’avancement durable des solutions de santé numériques au Canada puisqu’il renforce l’interopérabilité sémantique à l’échelle du réseau de la santé, simplifie l’adoption des terminologies cliniques et, de façon plus générale, améliore la qualité des soins pour tous les Canadiens.
Le nouveau serveur terminologique utilisera principalement une API FHIR pour l’accès aux terminologies et leur gestion. Terminology Gateway demeure accessible jusqu’à la fin de 2024, mais les utilisateurs sont invités à découvrir le nouveau serveur terminologique au fur et à mesure de la transition pour mieux connaître ses fonctionnalités et les avantages d’un serveur terminologique FHIR.
La mise hors service de Terminology Gateway devrait se faire en décembre 2024, mais on n’en connaît pas encore la date exacte. D’ici là, son contenu demeure fiable et exact, tout comme celui du nouveau serveur terminologique puisque les deux systèmes sont tenus à jour pour assurer la continuité du service. À la suite du lancement de la version bêta, les utilisateurs pourront explorer le nouveau serveur terminologique afin d’en comprendre le fonctionnement, tout en continuant à utiliser Terminology Gateway pour leurs besoins courants. La migration du contenu vers le nouveau serveur se fera par étape, ce qui signifie que certaines ressources terminologiques, comme le RCM et la terminologie de PrescripTIon, ne seront pas disponibles dans la version bêta initiale. Nous tiendrons les utilisateurs au courant de l’avancement du projet, selon les recommandations des experts et les données sur l’adoption de la nouvelle solution.
Oui, Ontoserver permet aux utilisateurs de parcourir le contenu, d’y faire des recherches et de le télécharger dans des formats utilisés par FHIR, plus précisément dans les formats JSON et XML. Pour certaines opérations, comme ValueSet $expand, il offre des représentations simplifiées et horizontales (p. ex. en format CSV). Les fichiers RF2, pour leur part, seront disponibles à l’aide de l’API de syndication pour le serveur. Une partie du contenu terminologique sera également accessible dans d’autres formats (comme Excel) à l’aide de l’API de syndication pendant la transition.
Non, on utilise souvent ces termes comme des synonymes. Un sous-ensemble est, au sens mathématique, un ensemble d’éléments qui sont tous contenus dans un autre ensemble. Dans le présent contexte, il s’agit d’un ensemble particulier de codes faisant partie d’un plus grand ensemble. Il s’agit aussi d’un ensemble de codes sélectionnés à partir d’une plus grande terminologie en fonction de besoins cliniques ou administratifs bien précis. En fournissant une liste précise de codes applicables dans des scénarios précis, le sous-ensemble assure la pertinence et l’uniformité du codage.
Un ensemble de valeurs est un ensemble de codes dérivé d’un ou de plusieurs systèmes de codes et défini par des critères spécifiques ou fondé sur une liste explicite de champs. Les ensembles de valeurs appuient l’interopérabilité lorsqu’utilisés avec des normes comme la norme FHIR d’HL7 puisqu’ils précisent les codes possibles pour des éléments de données, par exemple les valeurs acceptables pour le champ « diagnostic » dans un dossier de santé électronique.
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 de FHIR pour les ensembles de valeurs canoniques dans les guides d’implantation devraient déjà refléter l’URI de FHIR pour l’ensemble de valeur 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.
Le processus de demande de changement d’ensembles de valeurs pour SNOMED CT, LOINC, le RCM et la terminologie de PrescripTIon sera modifié selon une approche par étape. Cependant, à compter du 15 juillet, les ensembles de valeurs HL7 seront mis à jour automatiquement dans le serveur terminologique à partir des versions de la terminologie HL7 (THO).
Phase 1 (juillet à décembre 2024) : le processus de demande de changement dans InfoRMS reste le même.
Phase 2 (à partir de janvier 2025) : des utilisateurs seront autorisés à rédiger dans Snapper et pourront ainsi mettre à jour des ensembles de valeurs et en créer de nouveaux dans l’environnement de préparation jusqu’à leur approbation par le Centre canadien de publication des normes et leur chargement dans l’environnement de production. En outre, Terminology Gateway ne reflètera plus les changements apportés aux ensembles de valeurs.
Au cours des prochains mois, les utilisateurs apprendront comment créer et modifier des ensembles de valeurs dans Snapper selon le modèle de contrôle d’accès basé sur les rôles. Inforoute accordera à certains utilisateurs l’autorisation de créer et de modifier des ensembles de valeurs, selon les besoins. Ces ensembles de valeurs seront révisés, validés puis approuvés par le Centre canadien de publication des normes, puis intégrés à une version de production. Un guide d’utilisation et un tutoriel vidéo de Snapper sont à leur disposition pour les aider à utiliser l’outil. D’autres informations seront transmises dans les mois à venir.
Si vous avez de la difficulté à vous connecter, suivez ces étapes :
Actualisez la page: une simple actualisation règle parfois le problème.
Supprimez les témoins de navigation: si le problème est causé par des données en mémoire cache, cette action les supprimera.
Utilisez un autre navigateur : accédez au site à l’aide d’un autre navigateur pour voir si le problème persiste.
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.
Ontoserver permet autant les déploiements à grande échelle que l’utilisation à petite échelle, et pourra évoluer en fonction des besoins d’Inforoute. On l’utilise le plus souvent comme serveur en lecture seule qui donne accès, en cours d’exécution, au contenu terminologique publié. Le serveur terminologique convient donc à divers types de déploiements grâce à sa flexibilité et son extensibilité.
Ontoserver offre une grande flexibilité : il peut être intégré à un système, ou encore être utilisé de façon autonome.
L’intégration à un système peut prendre différentes formes : certains systèmes peuvent s’inscrire au serveur terminologique pour télécharger le contenu terminologique le plus récent afin de créer une représentation de l’information pour ses utilisateurs.
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.
Grâce à ses API FHIR, Ontoserver permet une intégration en profondeur avec le serveur terminologique et l’utilisation de la terminologique en cours d’exécution, et rend possibles des fonctionnalités avancées difficiles à exécuter dans d’autres contextes.
Le serveur terminologique favorise une représentation plus uniforme des données et facilite la collecte de données normalisées afin de soutenir autant les petits fournisseurs que les systèmes de grande envergure. Le fait de rendre la terminologie disponible par le truchement d’API garantit aux différentes plateformes un accès uniforme à la terminologie.
Shrimp est un navigateur terminologique et un explorateur visuel; il permet de chercher et de visualiser du contenu terminologique. Le téléchargement de sous-ensembles ne fait pas partie de ses fonctionnalités de base, mais nous savons que vous aimeriez pouvoir le faire, et nous explorons des façons de répondre à ce besoin. Pour l’instant, nous recommandons l’utilisation de Snapper pour télécharger des ressources. Vous trouverez plus d’information sur Snapper et son utilisation dans la vidéo de présentation et le guide d’utilisation.
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, les appels d’API suivants permettent de récupérer 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 la page Processus de demande d’accès de système à système.
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 :
Nous accordons une grande importance à vos commentaires et tentons constamment d’améliorer l’expérience utilisateur. Certaines des améliorations souhaitées n’entrent toutefois pas dans la portée du projet en cours et exigent une personnalisation d’outils qui ne sont pas gérés directement par Inforoute ou nos partenaires. Nous explorons diverses possibilités avec des intervenants, mais nous ne pouvons pas, pour l’instant, promettre des améliorations dans des délais précis. Nous sommes déterminés à améliorer l’expérience utilisateur en général, et nous tenons grandement compte de vos commentaires pour y arriver. Nous vous remercions sincèrement de votre compréhension et 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.
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.
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é.
Continuité avec Terminology Gateway : Sur Terminology 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.
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 CA), les solutions devront inclure l'édition CA de SNOMED CT (pour la « coding.version »).
Exemples de cas d'utilisation
Voici un 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 CA de SNOMED CT pour leurs ensembles de valeurs, leurs services de terminologie (ex. : Catalogue national des vaccins), etc. :
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 logiciels de fournisseurs qui sont aux États-Unis ou dans d'autres pays et qui n'utilisent pas par défaut l'édition CA 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).
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.
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. Suivez le lien ci-dessus pour nous faire part de vos commentaires.
Avertissement : le serveur terminologique d’Inforoute permet l’échange de contenu provenant des fournisseurs et de contenu provenant des utilisateurs. Inforoute veille à la qualité, à l’exactitude et à l’exhaustivité du contenu, mais les utilisateurs demeurent responsables de s’assurer que le contenu convient à l’usage prévu. Inforoute s’exonère de toute responsabilité quant aux erreurs ou aux omissions pouvant entacher ledit contenu, qui est fourni « tel quel », conformément aux conditions d’utilisation prévues. Information sur les contrats de licence applicables au contenu terminologique
Étape 1 : Remplissez le formulaire de demande d’accès par un système.
Étape 2 : Inforoute évaluera votre demande et l’approuvera ou vous demandera plus d’information..
Étape 3 : Une fois la demande approuvée, Inforoute vous enverra, par courriel, la marche à suivre pour récupérer vos données d’accès (identifiant et authentifiant de client).
Étape 4 : Suivez l’URL pour le jeton d’authentification et utilisez vos données d’accès pour obtenir un jeton.
Étape 5 : Utilisez le jeton reçu à l’étape 4 pour accéder à l’API FHIR.
Étape 5a : Les jetons expirent toutes les 30 minutes. Répétez les étapes 4 et 5 aussi souvent que nécessaire.
L’utilisateur du système recevra un identifiant et un authentifiant qui lui permettront d’obtenir un jeton d’authentification (ou d’accès). Il utilisera ensuite ce jeton pour faire des appels d’API afin d’obtenir de l’information.
Une fois le jeton obtenu, vous pouvez faire des appels à l’API FHIR. Un exemple simple d’intégration du jeton comme en-tête de requête HTTP figure ci-dessous. Voir la collection sur Postman mentionnée ci-dessous pour obtenir d’autres exemples.
curl --location --request GET 'https://terminologystandardsservice.ca/fhir/ValueSet/' \ --header 'Authorization: Bearer YYY'
Dépôt GitHub
Vous pouvez accéder à la collection Postman à partir de notre dépôt GitHub et l’importer dans votre espace de travail personnel sur Postman afin d’y apporter les modifications souhaitées. Vous pouvez aussi envoyer des requêtes au serveur terminologique sans devoir créer un embranchement à la collection.
Postman est un outil en ligne qui vous aidera à mettre à l’essai des API RESTful et à établir des communications avec celles-ci. Nous y avons créé une collection pour faciliter l’intégration aux API REST FHIR. Vous pouvez vous en servir pour authentifier, interroger, récupérer ou chercher des données sur le serveur terminologique. Certaines fonctionnalités, comme la modification des données, sont réservées aux personnes possédant un certain type d’accès. Consultez la collection, et utilisez les modèles pour concevoir le script de votre application logicielle qui s’intègre à nos API. Vous devrez peut-être créer un embranchement à la collection et sauvegarder le tout dans votre espace de travail pour pouvoir effectuer des changements et envoyer des requêtes au serveur terminologique. Il existe aussi un dépôt GitHub contenant la collection Postman sous forme de fichier à importer dans votre espace de travail. Voir les détails ci-dessous.
Pour pouvoir utiliser notre collection, vous devez créer un embranchement ou la copier dans votre propre espace de travail. Vous aurez à créer un compte Postman gratuit pour vous ou pour votre entreprise ou organisation. Une fois l’embranchement créé, vous pourrez modifier les requêtes et les envoyer au serveur terminologique. Vous verrez les réponses s’afficher dans la zone située au bas de l’écran principal.
Cliquez sur la collection ontoserver.canada puis, dans la section de droite, cliquez sur Fork.
Attribuez un nom à votre embranchement, et choisissez un espace de travail.
Cochez la case Watch original collection.
Cliquez sur le bouton Fork Collection.
Obtenir un jeton d’authentification dans Postman
Avant de pouvoir interroger l’API FHIR, vous devez obtenir un jeton d’authentification (ou d’accès). Vous pouvez utiliser votre nom d’utilisateur et votre mot de passe pour le serveur terminologique, ou utiliser une connexion de système.
Compte personnel
La marche à suivre pour utiliser un compte de système ressemble à celle utilisée avec un compte personnel.
Connectez-vous à Postman.
Rendez-vous à la collection créée à partir d’un embranchement.
Cliquez sur Terminology Standards Service Collection.
Cliquez sur l’onglet Authorization.
Tout au bas de la page, cliquez sur le bouton Get new Access Token.
Vous arriverez à la page de connexion.
Entrez votre nom d’utilisateur et votre mot de passe.
Une fenêtre avec le message Authentication complete s’affichera.
Cliquez sur Proceed.
Cliquez sur Use Token.
Vous pouvez maintenant naviguer d’un exemple à l’autre et utiliser le bouton Send pour obtenir une réponse du serveur terminologique.
Compte de système
La marche à suivre pour utiliser un compte de système ressemble à celle utilisée avec un compte personnel.
Connectez-vous à Postman.
Rendez-vous à la collection créée à partir d’un embranchement Terminology Standards Service Collection.
Cliquez sur l’onglet Authorization.
Sous Grant type, sélectionnez Client Credentials.
Entrez l’identifiant et l’authentifiant de client dans les champs appropriés.
Cliquez sur le bouton Get new Access Token.
Télécharger des artéfacts à l’aide d’une API de syndication
Les utilisateurs peuvent télécharger par programmation des fichiers liés aux divers systèmes de codes (CodeSystems) et ensembles de valeurs (ValueSets) à l’aide d’une API de syndication. Pour l’instant, les fichiers RF2 de l’édition canadienne de SNOMED CT, les fichiers du RCM et les fichiers pCLOCD peuvent être téléchargés – d’autres pourraient s’ajouter dans l’avenir. Les URL fournies ci-dessous sont accessibles à tous; vous n’aurez pas à entrer de données d’accès. Elles mènent à une liste, en format XML, de fichiers téléchargeables pour chaque système de code. Pour commencer à télécharger des artéfacts, suivez les instructions ci-dessous. Vous devrez entrer les données d’accès de votre compte de système pour télécharger des fichiers.
Instructions pour télécharger à l’aide de la syndication
Vous trouverez, dans le présent guide, de l’aide pour utiliser l’API de syndication pour télécharger les fichiers dont vous avez besoin. Aux fins de l’exemple, nous utilisons le fichier de SNOMED en format RF2.
L’URL de l’API de syndication est : is https://terminologystandardsservice.ca/syndication/alias/<feed-name>/syndication.xml. L’URL du fil RF2 de SNOMED est : is https://terminologystandardsservice.ca/syndication/alias/production_snomed_rf2/syndication.xml.
Envoyer une requête HTTP GET à l’API de syndication
Pour obtenir la liste des fichiers disponibles, utilisez la commande cURL suivante : curl 'https://terminologystandardsservice.ca/syndication/alias/production_snomed_rf2/syndication.xml''
Comprendre la réponse de l’API
La réponse est transmise en format XML et ressemble à ceci :
Obtenir un jeton Pour pouvoir télécharger le fichier, vous devez d’abord obtenir un jeton. Pour ce faire, vous pouvez utiliser le service d’autorisation et fournir vos données d’accès uniques (identifiant et authentifiant de client). Vous pouvez obtenir ces données d’accès en utilisant le formulaire de demande d’accès – compte de système.
Télécharger le fichier Pour télécharger le fichier, utilisez l’attribut href de l’élément <link> de l’exemple de réponse donné à la section 2. Vous devrez inclure un jeton porteur pour obtenir l’autorisation. Obtenez d’abord un jeton à l’aide de vos données d’accès uniques comme décrit dans la section précédente. Utilisez ce jeton dans la commande cURL ci-dessous pour sauvegarder le contenu obtenu sous forme de fichier :
Remplacez YOUR_ACCESS_TOKEN par le jeton que vous avez obtenu, et remplacez snomed_rf2_release.zip par le nom que vous souhaitez donner à votre fichier.
Vérifier le fichier téléchargé
De la réponse en XML obtenue à la section 2, vous pouvez utiliser la propriété ncts:sha256Hash pour vérifier la somme de contrôle SHA256. Voici des commandes à utiliser pour générer la fonction SHA256 localement et faire la comparaison avec la réponse en XML obtenue.
Windows Commande Powershell Get-FileHash <file> -Algorithm SHA256
Commande Powershell sha256sum <file>
Commande MacOS shasum -a 256 <file>
Outils d’HL7 International
Notre nouveau serveur terminologique permet maintenant l’intégration d’outils d’HL7 International, comme l’outil de publication de guides d’implantation (IG Publisher) et l’outil de validation (Validator)
Par où commencer
Demandez d’abord à Inforoute de vous fournir une clé API, afin de faciliter la configuration des outils d’HL7 (IG Publisher et Validator) et l’accès à la terminologie. Vous devrez mettre à jour le fichier de configuration fhir-settings.json de l’outil en utilisant la clé API fournie par Inforoute. Pour plus d’information, voir la documentation d’HL7. Inforoute peut vous aider avec les réglages, au besoin.
Versions prises en charge
HL7 IG Publisher : version 1.8.1 ou suivante
HL7 Validator : version 6.5.0 ou suivante
Note: Il s’agit d’une nouvelle configuration sur le serveur d’Inforoute, et d’une fonctionnalité récemment offerte par HL7. Certains ajustements pourraient être requis, et nous vous invitons à nous faire part de vos commentaires pour nous aider à améliorer cette fonctionnalité.
Accéder aux API du serveur terminologique à l’aide d’une clé API
Si votre application ne prend pas en charge les données d’accès de type OAuth2 (la méthode privilégiée), et que vous utilisez des outils autres que les outils d’HL7 mentionnés ci-dessus, vous pouvez utiliser une clé API pour accéder aux API du serveur terminologique. Il s’agit d’une solution de dernier recours. Suivez bien les étapes ci-dessous; elles diffèrent de celles fournies pour les données de type OAuth2.
Accès avec l’API de syndication: es utilisateurs de clé API n’ont pas accès aux téléchargements effectués à l’aide de l’API de syndication. Ils ont accès aux ressources FHIR seulement.
Compatibilité: utilisez les clés API seulement si votre application ne prend pas en charge OAuth2.
Imprimer
Courriel
Twitter