En résumé
Le catalogue est l’étagère commune de Linkr : des projets, des schémas, des alignements de concepts et des règles de qualité publiés par des équipes de recherche. C’est un annuaire de dépôts git — chaque fiche pointe vers un dépôt, et installer une entrée revient à le cloner. Le parcourir fonctionne partout, y compris dans le navigateur ; l’installer demande le mode serveur.
Le badge porte sur l’installation, qui demande un serveur. Parcourir le catalogue fonctionne dans les deux modes.
À quoi il sert
Beaucoup de travail en informatique de santé se refait à l’identique d’un établissement à l’autre : décrire le schéma d’une base MIMIC, aligner des codes locaux sur un vocabulaire standard, écrire les contrôles qualité d’un entrepôt OMOP. C’est long, et c’est le même travail partout.
Le catalogue répond à cela. Une équipe publie son schéma, son jeu de règles ou son projet complet dans un dépôt git, déclare ce dépôt au catalogue, et les autres l’installent en un clic pour partir de là.
Deux catalogues, à ne pas confondre
Le catalogue communautaire, décrit ici, indexe des entités Linkr à installer. Le catalogue de données documente les variables d’un entrepôt : ce que signifie chaque champ, d’où il vient. Noms voisins, fonctions sans rapport.
Y accéder
Le catalogue est une entrée de premier niveau de la barre latérale, Catalogue, à côté d’Accueil et d’Espaces de travail. Il ne dépend d’aucun espace de travail : c’est une ressource de l’installation entière.
À la première visite, il ne se charge pas tout seul. Un écran Catalogue non chargé vous invite à cliquer sur Charger le catalogue, en précisant quel serveur sera contacté.
Pourquoi ce clic explicite
Charger le catalogue contacte un serveur extérieur à votre établissement. Dans un contexte hospitalier, une requête sortante ne doit jamais partir sans que vous l’ayez décidée — d’où le bouton, plutôt qu’un chargement automatique.
Une fois chargé, le catalogue est mis en cache : il reste consultable entre deux sessions, avec sa date de mise à jour. Le bouton Actualiser vérifie s’il a changé, et un bandeau Mises à jour disponibles résume ce qui est nouveau, modifié ou retiré.
Ce qu’on y trouve
Neuf types d’entités peuvent être publiés.
Espace de travail
Un ensemble complet, avec ses projets et ses ressources. C’est ainsi qu’arrivent les données de démonstration.
Projet
Une étude entière : cohortes, tableaux de bord, scripts.
Alignement de concepts
Un travail de correspondance entre des codes locaux et un vocabulaire standard.
Collection de scripts
Des requêtes SQL réutilisables, organisées en dossiers.
Pipeline ETL
Une transformation d’un modèle source vers un modèle cible, OMOP par exemple.
Catalogue de données
La documentation des variables d’un entrepôt.
Règles de qualité
Un jeu de contrôles à passer sur des données.
Préréglage de schéma
La description d’une source : ses tables, ses colonnes, comment les lire.
Base de données
Une base publique et ses données — MIMIC-IV de démonstration, par exemple.
Lire une fiche
Chaque entrée affiche son nom, sa description, son auteur et son organisation, sa licence, sa version et ses étiquettes. Un lien Ouvrir le dépôt mène au dépôt git d’origine, pour inspecter le contenu avant d’installer.
Trois états signalent une entrée à considérer avec prudence : En cours pour un travail non terminé, Obsolète pour une entrée remplacée, Inaccessible quand son dépôt ne répond plus.
La taille est annoncée quand elle compte
La plupart des entités pèsent quelques kilooctets de JSON. Une base de données emporte ses fichiers de données — la démonstration MIMIC-IV fait 18 Mo — et la fiche l’affiche alors, pour éviter la surprise sur une connexion lente.
Chercher
Une barre de recherche et quatre filtres : Type, Étiquettes, Auteur et Organisation. Le tri est celui des autres listes de Linkr, et votre choix est retenu.
Le filtre Organisation rend un service particulier : il répond à « qu’a publié tel CHU ? », ce qui est souvent la vraie question quand on cherche du contenu de confiance.
Installer une entrée
Le bouton Installer demande dans quel espace de travail l’entité doit atterrir, puis clone son dépôt.
Si vous l’avez déjà, Linkr le dit — Installé — et vous propose de Mettre à jour lorsqu’une version plus récente existe. La fiche compare alors la version installée et celle du catalogue.
Réinstaller remplace ou duplique
Sur une entrée déjà présente, l’application prévient : « Déjà installé dans ce workspace. Réinstaller le remplacera ou le dupliquera. » Comme pour un import, c’est vous qui tranchez — voir Import et export.
Une entité installée reste liée à son dépôt d’origine. Vous récupérez donc ses corrections plus tard, sans la réinstaller depuis zéro.
Installer un espace de travail : « Installé, mais du contenu est manquant »
Un espace de travail publié est fait de renvois vers les dépôts de chacun de ses éléments. Ils sont récupérés un par un, et certains peuvent échouer — le cas courant étant un dépôt privé, auquel l’installation ne présente aucun identifiant.
Le message vous dit alors précisément lesquels sont restés vides. L’espace de travail est bien installé ; il lui manque le contenu de ces éléments, que vous pouvez récupérer ensuite en fournissant un jeton d’accès.
Installer nécessite le mode serveur
L’installation clone un dépôt git, ce que le navigateur seul ne sait pas faire. En mode navigateur, le catalogue reste consultable — vous voyez les fiches et pouvez ouvrir les dépôts — mais le bouton d’installation est indisponible.
Pour retrouver malgré tout du contenu publié dans une installation navigateur, téléchargez une archive depuis le dépôt et importez-la en ZIP.
Depuis la fenêtre d’import
Le catalogue apparaît aussi comme troisième onglet de la fenêtre Importer, Depuis le catalogue, filtré sur le type que vous êtes en train d’importer. Pratique quand vous savez déjà ce que vous cherchez : un schéma, depuis la page des schémas.
Utiliser un catalogue interne
Le catalogue par défaut est public et ouvert. Un établissement peut préférer le sien — pour du contenu qui ne doit pas sortir, ou pour un catalogue validé en interne.
Les paramètres portent une section Catalogue communautaire : « Le dépôt Git depuis lequel Linkr lit le catalogue. Modifiez-le pour utiliser un catalogue interne. » Vous y donnez une URL du dépôt du catalogue et une Branche, avec un bouton Réinitialiser pour revenir au catalogue public.
Ce qu'attend cette adresse
Une URL https vers un dépôt GitLab — l’instance publique, une forge associative, ou votre GitLab d’établissement. Le format du dépôt d’index est celui du catalogue public, qu’on peut donc prendre pour modèle.
Quand ça ne marche pas
Les messages distinguent les causes, ce qui évite de chercher au mauvais endroit.
- Catalogue inaccessible — pas de réseau, ou une sortie bloquée par le pare-feu de l’établissement. C’est le cas le plus fréquent en milieu hospitalier.
- Aucun catalogue trouvé à cette adresse — l’URL configurée ne pointe pas sur un dépôt de catalogue.
- Le fichier du catalogue est illisible — le dépôt répond, mais son contenu n’est pas exploitable.
- Ce catalogue nécessite une version plus récente de Linkr — mettez à jour l’application.
Pour aller plus loin
- Publier du contenu — y déposer votre propre travail.
- Import et export — les deux autres façons de faire circuler une entité.
- Schémas de bases — ce qu’on installe le plus souvent depuis le catalogue.
- Entités et partage — ce qui rend une entité installable.