Métadonnées des publications de la HAS

Description

Publications de la HAS

À propos de cette documentation

La documentation de ce jeu de données suive le concept de fiche technique pour les jeux de données (ou Datasheets for Datasets) proposé par Gebru et al. Spécifiquement, nous reprenons l'adaptation et traduction au français proposée par Samuel Goëta ici.

Le but de cette fiche technique est de normaliser la documentation à propos de pourquoi un jeu de données a été créé, quelles informations il contient, les tâches pour lesquelles il devrait et ne devrait pas être utilisé, et si cela pourrait soulever des préoccupations d’ordre éthique ou juridique.

Motivations pour la création du jeu de données

Pourquoi le jeu de données a-t-il été initialement créé ? Les données des publications de la HAS sont trouvables programmatiquement à travers de l'API du site web, documenté ici. Ce jeu de données propose les publications traitées, nettoyées et enrichies sous forme de fichiers JSON, CSV et XSLX.

Pour quelles autres tâches le jeu de données pourrait-il être utilisé ? Créer un graphe de connaissance en liant les publications par rapport aux thématiques, mots clés, dates, etc.

Quelles sont les utilisations trompeuses du jeu de données ? L'utilisation des dates de publication ou de mise à jour comme des dates ayant une valeur légale. Ces dates font partie d'un processus métier interne et ne peuvent pas être prises en compte pour des démarches légales.

Qui a financé ou soutenu la création du jeu de données ? La HAS.

Composition du jeu de données

Que contient le jeu de données principalement ? Les métadonnées des documents rédigés par les agents de la HAS.

Dispose-t-on d’un schéma décrivant les variables du jeu de données ? Oui, comme ressource dans ce même jeu de données et sur la documentation du projet.

Que contient chaque champ du jeu de données ? Voir les tableaux du Dictionnaire abrégé ci-dessous.

Est-ce que le contenu du jeu de données dépend de ressources externes ? Oui, les textes des publications sont disponibles dans un jeu de donnée complémentaire. Par ailleurs, pour les publications du type Avis sur les Médicaments, le champ reference fait référence au Code ATC (Anatomical Therapeutic Chemical).

De quelles garanties dispose-t-on concernant la pérennité de ces ressources ? Le code ATC est un identifiant de référence indexé par l'OMS.

Processus de collecte des données

Comment les données ont été collectées (avec des capteurs, manuellement par des outils informatiques…) ? Les publications sont rédigées par des agents de la HAS et puis sont versées automatiquement à partir d'un système d'information interne. Certaines publications sont ajoutées manuellement. La collecte se fait par des outils informatiques, via l'API du site.

Qui a assuré le processus de collecte de données (des agents, des bénévoles, des étudiants…) ? Des agents de la HAS.

Quelle a été la période de collecte des données ? Le jeu de données contient les métadonnées des publications créées à partir de juin 1999.

Les données ont-elles été collectées directement ou inférées à partir d’autres données ? Collectées directement.

Les données ont-elles été collectées sur un échantillon ? Selon quelles méthodes ? Oui. Nous n'incluons que les publications de certains types, liées à la production des experts de la HAS. Nous écartons les publications liées au système de gestion de documents du site web. Les publications inclues/exclues sont les suivantes :

Types inclus Types exclus
Avis sur les Médicaments Médecin accrédité
Avis sur les dispositifs médicaux et autres produits de santé Avis et décisions de la HAS
Évaluation des technologies de santé Article HAS
Recommandation de bonne pratique Médicament
Outil d'amélioration des pratiques professionnelles Résultat de certification des établissements
Guide maladie chronique Événement de Calendrier
Guide méthodologique Lien externe
Recommandation en santé publique Article Webzine
Études et Rapports Communiqué de presse
Guide usagers Synthèse d'avis et Fiche bon usage
Recommandation vaccinale Newsletter HAS
Sous-éléments
Glossaire - Terme
Avis sur les Actes
Brève
Vos interlocuteurs
Faq - Entrée
Sondage
Étude d'évaluation économique

Quelles sont les erreurs connues, les limites, les sources de bruit ou de redondances associées à ces données ?

  1. Ils existent des variables avec des limites, évoquées dans le tableau ci-dessous.
  2. Ils existent des publications qu'ont été remplacées par une nouvelle version dans le site web.
  3. Les dates inclues dans le jeu de données sont relatives à la gestion du site Web. Ces dates ne portent aucune valeur légale.

Pré-traitement des données

Comment les données ont-elles nettoyées ou préparées ?
Pour chaque publication :

  1. Suppression des variables liées au système de gestion de documents pour faciliter l'utilisation.
  2. Renommage des noms de champs pour expliciter les contenus.
  3. Suppression des doublons dans les contenus dus aux erreurs de saisie.
  4. Simplification du code HTML pour faciliter sa lecture en gardant l'opérabilité.
  5. Ajout une version en Markdown pour les champs contenant du HTML.
  6. L'ajout des URLs des ressources référencées.
  7. L'ajout de la date où l'API a été consultée.
  8. L'ajout d'une valeur haché correspondant aux variables présentes dans la publication. Spécifiquement, une somme MD5 calculée avec tous les champs de la publication, sauf la date de consultation.

Les données « brutes » ont-elles été conservées ? Sont-elles diffusées ? Oui, ils sont trouvables via l'API du site web de la HAS.

L’outil de prétraitement des données est-il disponible ? Oui, dans le repo correspondant à ce jeu de données. La documentation de cet outil se trouve ici.

Diffusion du jeu de données

Les données sont-elles diffusées en ligne ? Selon quelles modalités (sur un portail open data, un site web, une API…)? Oui, sur cette page data.gouv.fr. Aussi, ils sont accessibles sans prétraitement via l'API.

Selon quelle licence les données sont-elles diffusées ? License Ouverte version 2.0

Des redevances ou des restrictions sont-elles appliquées dans l’accès aux données ? Non.

Maintenance du jeu de données

Qui assure la maintenance du jeu de données ? Comment peut-on contacter cette personne ? Quel est le service responsable du jeu de données ? La Mission Data de la HAS.

Est-ce que les rôles sont distincts entre la production des données, leur éditorialisation et leur diffusion ? Oui. Produit par les services HAS. Éditorialisé aussi par les services HAS et le service communication. Diffusé par le service informatique et la Mission Data de la HAS.

Le jeu de données sera-t-il mis à jour ? Si oui, à quelle fréquence ? Oui, de manière hebdomadaire (tous les lundis).

Si les données deviennent obsolètes, comment cette information sera-t-elle communiquée ? À travers de cette page.

Est-il possible de contribuer à l’amélioration des données ? Selon quelles modalités ? Oui, en nous contactant à travers des commentaires de cette page ou directement par e-mail.

Considérations légales et éthiques

Si le jeu de données concerne des individus, ont-ils exprimé leur consentement de manière claire ? Il ne concerne pas des individus.

Le jeu de données peut-il exposer de manière directe ou indirecte des individus ? Non à notre connaissance.

Ces données sont-elles conformes au RGPD ? Oui.

Les données peuvent-elles avantager ou désavantager des groupes sociaux ? Non à notre connaissance.

Le jeu de données contient-il des informations pouvant être considérées comme inappropriées ou offensantes ? Non à notre connaissance

Organisation de fichiers

Deux fichiers ZIP sont mis à disposition avec les données sous trois formats différents. Nous conseillons fortement d'utiliser le format JSON.

Single

Le premier, has_publications_single.zip, contient un seul fichier avec toutes les publications à l'intérieur. Nous fournissons trois types de format : CSV, JSON et XLSX (Excel). L'arborescence de ce fichier ZIP est la suivante :

├── csv
│   └── AllPublications.csv
├── json
│   └── AllPublications.json
└── xlsx
    └── AllPublications.xlsx

Split

Le deuxième fichier, has_publications_split.zip, contient un fichier par type de publication (voir table ci-dessus) et par type de format (CSV, JSON, XLSX) :

├── csv
│   ├── AVISMedicament.csv
│   ├── AVISProduitsEtPrestations.csv
│   ├── ...
│   └── RecommandationsProfessionnelles.csv
├── json
│   ├── AVISMedicament.json
│   ├── AVISProduitsEtPrestations.json
│   ├── ...
│   └── RecommandationsProfessionnelles.json
└── xlsx
    ├── AVISMedicament.xlsx
    ├── AVISProduitsEtPrestations.xlsx
    ├── ...
    └── RecommandationsProfessionnelles.xlsx

Dictionnaire des données abrégé

Attention

Certains champs dans les données proposées ont des particularités à prendre en compte lors de son utilisation. En général, il peut aussi exister des erreurs de saisi dans certains champs. Lorsque nous connaissons de telles erreurs pour certains champs, nous ajoutons des commentaires dans les tableaux ci-dessous.

AVISMedicament.json

Veuillez trouver des informations complémentaires pour les Avis sur les Médicaments ici dans un autre jeu de données ouvert de la HAS.

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
typeDavis Type d'avis
syntheseDeLavis Synthèse de l'avis
codeCIP Code Identifiant de Présentation
natureDeLaDemande Nature de la demande d'avis variable à très haute cardinalité
reference Code Anatomical Therapeutic Chemical (ATC)
fabricant Fabricant du médicament
presentation Présentation du médicament
avisPrioritaire Si l'avis es prioritaire ou pas
accesPrecoce Si l'avis es de type accès précoce ou pas
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
substance Substance active du médicament
serviceMedicalRendu Valeur du Service Médical Rendu
serviceMedicalRenduTexte Résumé explicatif du SMR
ameliorationDuServiceMedicalRendu Valeur de l'Amélioration du Service Médical Rendu
ameliorationDuServiceMedicalRenduTexte Résumé explicatif de l'Amélioration du Service Médical Rendu
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

RecommandationsProfessionnelles.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
surtitre Surtitre de la publication beaucoup de valeurs manquantes
soustitre Sous-titre de la publication beaucoup de valeurs manquantes
objectifs Objectifs de la recommandation beaucoup de valeurs manquantes
dateDeValidation Date de validation par le collège
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

AVISProduitsEtPrestations.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
typeDavis Type d'avis
soustitre Sous-titre de la publication
natureDeLaDemande Nature de la demande
demandeurFabricant Demandeur ou fabricant du produit
documentLinkSet Ressources (fichiers) liées
serviceAttendu Valeur du Service Attendu
serviceAttenduTexte Résumé explicatif du SA
ameliorationDuServiceAttendu Valeur de l'amélioration du Service Attendu
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
ameliorationDuServiceAttenduTexte Résumé explicatif de l'Amélioration du SA
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

GuideMedecinALD.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
documentLinkSet Ressources (fichiers) liées
apiAccessDate Date d'accès à l'API du site web HAS
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

EtudeEtEnquete.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication date sans valeur legal
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

GuideMethodologique.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

GuidePatient.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

EvaluationDesTechnologiesDeSante.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
surtitre Surtitre de la publication beaucoup de valeurs manquantes
soustitre Sous-titre de la publication beaucoup de valeurs manquantes
objectifs Objectifs de l'étude
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

RecommandationVaccinale.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

EvaluationDesPratiques.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
surtitre Surtitre de la publication beaucoup de valeurs manquantes
soustitre Sous-titre de la publication beaucoup de valeurs manquantes
resumeCourt Résumé court de cette évaluation beaucoup de valeurs manquantes
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

EvaluationDesProgrammesEtPolitiq.json

Field Description Commentaire
class Type de la publication
id Identifiant de la publication
title Titre de la publication
surtitre Surtitre de la publication beaucoup de valeurs manquantes
soustitre Sous-titre de la publication beaucoup de valeurs manquantes
resumeCourt Résumé court de cette évaluation
objectifs Objectifs de l'évaluation
documentLinkSet Ressources (fichiers) liées
publicationDate Date de publication date sans valeur legal
creationDate Date de création date sans valeur legal
apiAccessDate Date d'accès à l'API du site web HAS
categoriesThematiques Liste des catégories thématiques de la publication terminologie interne à la HAS
liensSiteWeb Liste des publications HAS liées
resumeSiteWeb Résumé présenté sur le site web
page_url URL de la page de cette publication
md5 Hash lié aux métadonnées de cette publication (champs précédents)

Producteur

Dernière mise à jour

17 juin 2024

Licence

Licence Ouverte / Open Licence version 2.0

Qualité des métadonnées
44.44444444444444/100

Documentation des fichiers manquante

Fréquence de mise à jour non renseignée

Couverture temporelle non renseignée

Couverture spatiale non renseignée

Il n'y a pas encore de réutilisation pour ce jeu de données.

Publiez une réutilisation Qu'est-ce qu'une réutilisation ?

Ces ressources sont publiées par la communauté et ne sont pas sous la responsabilité du producteur des données.

Informations

Tags

ID

61e6c823f1eae83eac2cf47b

Temporalité

Création

18 janvier 2022

Fréquence

Inconnu

Dernière mise à jour

17 juin 2024

Actions

Intégrer sur votre site

Visites

1,6k

68 en juin 2024

Téléchargements

427

10 en juin 2024

Réutilisations de ce jeu de données

0

Favoris

1