Fil de syndication

Un fil de syndication, ou fil RSS (pour Really Simple Syndication), est une technologie Web évoluée. Elle permet à un utilisateur d’être avisé lorsque le contenu d’un site en particulier est mis à jour. Le serveur terminologique d’Inforoute se sert de cette technologie pour informer les utilisateurs lorsque de nouveaux fichiers sont disponibles pour le téléchargement, et les aider à réussir leur téléchargement.

Télécharger des artéfacts à l’aide d’un fil de syndication (fil RSS)

Les utilisateurs peuvent télécharger par programme des fichiers liés aux divers systèmes de codes et ensembles de valeurs à l’aide d’un fil de syndication. Les fichiers RF2 et de l’ensemble de valeurs de l’édition canadienne de SNOMED CT, les fichiers du RCM, les fichiers pCLOCD et les fichiers des ensembles de valeurs peuvent être téléchargés. Les URL fournies ci-dessous sont accessibles à tous; vous n’aurez pas à entrer de données d’accès. Vous devrez toutefois entrer les données d’accès de votre compte de système pour télécharger des fichiers. Le fil prend la forme d’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 pour le téléchargement avec API de syndication ci-dessous. 

Administrateurs d’un serveur terminologique provincial ou territorial

Si vous ou votre équipe gérez un serveur terminologique, de préférence une instance d’Ontoserver, vous pouvez utiliser les fils de syndication suivants pour importer facilement de nouvelles données terminologiques dans votre serveur terminologique. Vous profitez ainsi d’une fonctionnalité de synchronisation, puisque les versions les plus récentes des terminologies comme l’édition canadienne de SNOMED CT ou pCLOCD, par exemple, sont intégrées automatiquement et régulièrement à votre instance d’Ontoserver. Les fichiers disponibles pour le téléchargement sont des ressources FHIR en format JSON ou des index de données binaires. Les données binaires sont produites à l’étape du traitement préalable au chargement des données dans l’instance d’Ontoserver, ce qui évite à l’utilisateur de devoir répéter le processus. En fonction des cycles de publication des divers systèmes de codes, vous pouvez lancer une tâche CRON ou un script afin de télécharger les fichiers nouvellement disponibles dans le serveur terminologique d’Inforoute.

Instructions pour le téléchargement avec API de syndications

Vous trouverez, dans le guide, de l’aide pour utiliser le fil 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.

Étapes du téléchargement de fichiers

1. Pour télécharger des fichiers, vous devez avoir un compte de système. Pour faire une demande de compte de système, consultez cette page
2. 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/external_snomed/syndication.xml''
3. Comprendre la réponse de l’API
   
   La réponse est transmise en format XML et ressemble à ceci :

 

<?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>

4. Obtenir un jeton
   Pour pouvoir télécharger le fichier, vous devez d’abord obtenir un jeton. Pour ce faire, vous pouvez faire un appel au service d’autorisation avec vos données d’accès uniques (identifiant et authentifiant de client). Pour obtenir ces données d’accès, utilisez le  formulaire de demande d’accès de 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}}'
   

5. 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é au point 3 ci-dessus. 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 au point précédent. 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 &ltyour_access_token&gt' -O snomed_rf2_release.zip
   

   Remplacez YOUR_ACCESS_TOKEN par votre jeton and snomed_rf2_release.zip par le nom que vous souhaitez donner à votre fichier. 

6. Vérifier le fichier téléchargé

De la réponse en XML obtenue au point 3 , 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.

• Commande Powershell pour Windows
  Get-FileHash <file> -Algorithm SHA256
• Commande pour Linux
  sha256sum <file>
• Commande pour MacOS
  shasum -a 256 <file>