Home

[DOCUMENTATION OBSOLETE] : La documentation est maintenant au format IG! https://interop.esante.gouv.fr/ig/documentation

Bienvenue au wiki FHIR de l'ANS !

Celui-ci contient toutes les informations à propos de la modélisation, des outils FSH et IG publisher, ainsi que des tips dans le contexte français.

A qui est destiné ce wiki ?

Il est destiné à celles et ceux qui utilisent FHIR !

• Les FHIR modelers, qui profilent des ressources
• Les FHIR implementers, qui développent des APIs

Les experts fonctionnels ont également une plus value à connaître FHIR, la façon de profiler des ressource et de développer les APIs : c'est les personnes qui connaissent le mieux le besoin métier, c'est ceux qui seront le plus à même de juger le travail de modélisation effectué par les experts interopérabilité.

Par où commencer ?

1/ Installer les dépendances grâce à la page "Installer les dépendances [Windows/mac]" de ce wiki

2/ Développer un Implementation Guide :

• Si vous souhaitez créer un Implementation Guide pour publication : suivre la procédure Développement d'un nouvel IG
• Si vous souhaitez modifier un Implementation Guide existant : cloner le GitHub repository désiré
• Si vous souhaitez tester FSH et les Implementation Guide : cloner le GitHub repository FIG_ans-ig-sample ou téléchargez-le au format zip

Outils et vocabulaire

FSH

FSH est la grammaire de définition des ressources FHIR (instance, StructureDefinition, SearchParameter, CapabilityStatement, ImplementationGuide, ...)

SUSHI

Sushi est le logiciel permettant de générer les ressources au format json ou xml à partir de la grammaire FSH. Il est disponible en ligne : https://fshschool.org/ Ou bien en invite de commande : https://www.npmjs.com/package/fsh-sushi

Par défaut, sushi ne génère que les differential. Pour générer les snapshots, il faut utiliser l'option sushi -s .

GOFSH

GoFSH permet de faire la transformation inverse StructureDefinition --> FSH. Il est disponible en ligne : https://fshschool.org/ Ou bien en invite de commande : https://www.npmjs.com/package/gofsh

Par défaut, GoFSH ne traite que les fichiers json. Il va falloir rajouter l'option goFSH -t json-and-xml . pour traiter les deux

IG Publisher

L'IG publisher est l'outil permettant de générer les pages web de l'implementation guide (usage de jekyll, java, ...). Il prend en entrée une arborescence de dossiers / fichiers bien définis, contenant : des pages en markdown, des fichiers fsh, des ressources FHIR au format json ou xml, des images...

La documentation est disponible ici : https://confluence.hl7.org/display/FHIR/IG+Publisher+Documentation

Liens utiles

Des exemples d'ImplementationGuide:

• Us-core https://hl7.org/fhir/us/core/
  • https://github.com/HL7/US-Core
• mcode https://build.fhir.org/ig/HL7/fhir-mCODE-ig/ (qui se base sur uscore)
  • https://github.com/HL7/fhir-mCODE-ig
• SDC, IG qui définit des profils de la ressource FHIR Questionnaire. Ces profils rajoutent des fonctionnalités de : préremplissage des champs, indiquer un design de formulaire, calcul automatique…)
  • http://hl7.org/fhir/uv/sdc/index.html

Les éditeurs de profils :

• FSH (Grammaire de définition de profils)

  • https://fshschool.org/
  • https://build.fhir.org/ig/HL7/fhir-shorthand/

• Forge (définition de profils via interface graphique)

  • https://simplifier.net/forge

Autres :

• IG publisher documentation (officiel HL7):
  • https://confluence.hl7.org/display/FHIR/IG+Publisher+Documentation
• Doc CQL (langage d'expression FHIR, permettant par ex de décrire le calcul de l'IMC) :
  • https://build.fhir.org/ig/HL7/cqf-measures/using-cql.html
  • https://cql.hl7.org/