Rappel : Une partie de Terminology Gateway sera mise hors service le 30 avril 2025, et le contenu des principales terminologies fera l'objet d'une migration vers notre nouveau serveur terminologique FHIR. Nous vous demandons de télécharger le contenu de Terminology Gateway dont vous avez besoin avant cette date, et de mettre à jour les points terminaux de votre système. En savoir plus >

Partager :

About About

Guide d’accès au serveur terminologique

Introduction

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.

https://ontoserver.csiro.au/ui/launch?iss=https://terminologystandardsservice.ca/fhir

Shrimp 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. https://ontoserver.csiro.au/shrimp/launch.html?iss=https://terminologystandardsservice.ca/fhir
Snapper

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).

https://ui.terminologystandardsservice.ca/snapper/?iss=https://terminologystandardsservice.ca/fhir

 

Déjà utilisateur?

  • Passez à la section « Se connecter au serveur terminologique (OntoCommand) » ci-dessous.

Nouvel utilisateur?

  • Passez à la section « Créer un compte InfoCentral » ci-dessous.

Se connecter au serveur terminologique (OntoCommand)

  • Rendez-vous sur le serveur terminologique en utilisant l’URL suivante : https://terminologystandardsservice.ca/fhir.
  • 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, Cette adresse courriel est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser. pour obtenir de l’aide.

ontocommand login

ontocommand image

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.

shrimp

Snapper

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.

snapper login

snapper terms

Se déconnecter

  • À partir du serveur terminologique, cliquez sur le bouton Logout (Déconnecter) dans le coin supérieur droit.
  • Vous serez déconnecté du serveur terminologique, mais resterez connecté à InfoCentral.
    • Vous n’aurez peut-être pas à entrer votre nom d’utilisateur et mot de passe à chaque connexion ultérieure.

 

Lire la suite

Processus de demande – compte de système

É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.

Points terminaux d’API

Obtenir un jeton d’authentification

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.

curl --location --request POST 'https://terminologystandardsservice.ca/authorisation/auth/realms/terminology/protocol/openid-connect/token' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={{client_id}}' \
--data-urlencode 'client_secret={{client_secret}}'

Réponse

Le jeton dans l’exemple ci-dessous sera utilisé dans les appels comme en-tête de requête HTTP Authorization.

{
     "access_token": "..."
     "expires_in": 1800,
     "refresh_expires_in": 0,
     "token_type": "Bearer",
     "not-before-policy": 0,
     "scope": ""

}

Requête à l’API FHIR

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.

[Dépôt GitHub] https://github.com/terminologystandardsservice/public

 

Collection Postman

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.

La collection Postman se trouve ici.

Créer un embranchement à une collection

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.

  • Connectez-vous à Postman.
  • Allez dans les collections, qui se trouvent ici.
  • 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.

image fork

image2 fork

 

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.

personal account

image2 personal account

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.

image system account

 

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.

Instructions

  1. 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''
  2. Comprendre la réponse de l’API

    La réponse est transmise en format XML et ressemble à ceci :

    Réponse

    <?xml version="1.0" encoding="UTF-8"?>
    <feed xmlns="http://www.w3.org/2005/Atom" xmlns:ncts="http://ns.electronichealth.net.au/ncts/syndication/asf/extensions/1.0.0" 
      xmlns:onto="http://ontoserver.csiro.au/syndication/">
      <title>initial-snomed_rf2</title>
      <link rel="alternate" href="https://terminologystandardsservice.ca/syndication/feed/20240831_001_SNOMED_RF2_RC/syndication.xml" />
      <subtitle />
      <id>urn:uuid:523dd9c5-3c05-47ab-aea1-61f476b989bf</id>
      <generator version="2.1.0">Atomio</generator>
      <updated>2024-08-29T15:43:00Z</updated>
      <ncts:atomSyndicationFormatProfile>http://ns.electronichealth.net.au/ncts/syndication/asf/profile/1.0.0</ncts:atomSyndicationFormatProfile>
      <entry>
        <title>Snomed RF2 Release 20240831</title>
        <link rel="alternate" type="application/zip" 
      href="https://terminologystandardsservice.ca/syndication/feed/20240831_001_SNOMED_RF2_RC/entry/74a84814-0e52-421b-b948-51d41ac2f7bc/artefact/e3d1a6d6a92301607d80e7889d4f9f363065be44a8dc92e645a4de8dbf335843.zip" length="690979420" 
        ncts:sha256Hash="e3d1a6d6a92301607d80e7889d4f9f363065be44a8dc92e645a4de8dbf335843" />
        <category term="RF2" label="RF2 ZIP package" scheme="http://ontoserver.csiro.au/syndication/rf2" />
        <id>urn:uuid:74a84814-0e52-421b-b948-51d41ac2f7bc</id>
        <updated>2024-08-29T15:43:00Z</updated>
        <published>2024-08-29T15:43:00Z</published>
        <summary>Snomed RF2 Release 20240831</summary>
        <ncts:contentItemIdentifier>http://snomed.info/sct</ncts:contentItemIdentifier>
        <ncts:contentItemVersion>http://snomed.info/sct/20611000087101/version/20240831</ncts:contentItemVersion>
      </entry>
    </feed>

  3. 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.

    curl --location --request POST 'https://terminologystandardsservice.ca/authorisation/auth/realms/terminology/protocol/openid-connect/token' \
    --data-urlencode 'grant_type=client_credentials' \
    --data-urlencode 'client_id={{client_id}}' \
    --data-urlencode 'client_secret={{client_secret}}'

  4. 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 :

    curl 'https://terminologystandardsservice.ca/syndication/feed/20240831_001_SNOMED_RF2_RC/entry/74a84814-0e52-421b-b948-51d41ac2f7bc/artefact/e3d1a6d6a92301607d80e7889d4f9f363065be44a8dc92e645a4de8dbf335843.zip'
    -H 'Authorization: Bearer <your_access_token> -O snomed_rf2_release.zip

    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.

  5. 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.

  1. Utiliser l’URL réservée à la clé API
    • Pour accéder aux API à l’aide d’une clé API, utiliser l’URL suivante: https://terminologystandardsservice.ca/tx/fhir
    • S’assurer que toutes les demandes d’API incluent le chemin contextuel `/tx/fhir` avant d’ajouter les paramètres de configuration.
  2. Inclure la clé API dans l’en-tête de requête HTTP
    • La clé API doit être fournie comme en-tête de requête HTTP dans vos requêtes. Api-Key: <your-api-key>
  3. Exemple d’une commande cURL
    • Voici un exemple de commande cURL pour faire une requête à l’aide de la clé API :

      curl 'https://terminologystandardsservice.ca/tx/fhir' -H 'Api-Key: <your-api-key>'

Note

  • 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.

 

Ressources

Lire la suite

Terminologique des Normes Service

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
  • LOINC
  • 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é.

Par où commencer

Pour commencer, vous aurez besoin d’une clé API unique fournie par Inforoute pour configurer facilement les outils d’HL7 et accéder à la terminologie. Pour plus d’information, voir le processus de demande de compte de système et la  documentation d’HL7 .

Versions prises en charge

  • HL7 IG Publisher : version 1.8.1 ou suivante
  • HL7 Validator : version 6.5.0 ou suivante

Outils associés au serveur terminologique

Il existe divers outils pour mieux comprendre et utiliser les ressources FHIR accessibles par le serveur terminologique d’Inforoute.

Navigateur Shrimp

benefits

  • 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:

benefits

  • 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:

benefits

  • 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. https://terminologystandardsservice.ca/fhir OntoCommand
Navigateur terminologique (Shrimp) 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. https://ontoserver.csiro.au/shrimp/launch.html?iss=https://terminologystandardsservice.ca/fhir Shrimp
Rédaction terminologique (Snapper)

L’outil de rédaction est composé des éléments:
Snapper: Author et Snapper: Map.
Suivre les liens ci-contre pour y accéder.

Snapper: Author permet de créer et de tenir à jour les ressources CodeSystem, ValueSet et ConceptMap.

Snapper: Map simplifie la rédaction et la tenue à jour des ressources ConceptMap.

https://ui.terminologystandardsservice.ca/snapper/?iss=https://terminologystandardsservice.ca/fhir Snapper

Ressources de formation

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.

Aperçu du serveur terminologique : 

Vidéos de formation et guides d’utilisation : 

Serveur terminologique :

Shrimp :

OntoCommand : 

Snapper :

API FHIR :


Foire aux questions

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. 

Une partie de la plateforme Terminology Gateway sera mise hors service le 30avril 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 PrescripTIonMC 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.

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.

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, Cette adresse courriel est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser. pour obtenir de l’aide.

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é. 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 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, 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 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 :

Snomed code

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.

shrimp code

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é.
  • 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 la passerelle terminologique sera mise hors service à partir du 30 avril 2025. Elle ne contiendra que le contenu lié à PrescripTIonMC. 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

  1. 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. :

    example 1

  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 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).

example 2

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.


Nous joindre pour obtenir de l’aide

Nous joindre sur InfoCentral

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

Lire la suite

Logo d'InfoCentral

La santé numérique à votre service

 

Transformer les soins de santé au Canada grâce aux technologies de l'information sur la santé.