Essais CLiniques Accessibles Interconnectés pour la Recherche ouverts à l'Ecosystème
0.3.0 - trial-use
This page is part of the Implementation Guide FHIR pour le projet ECLAIRE, base de données qui recense les essais cliniques en France (v0.3.0: Release) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions
Un consommateur recherche des essais cliniques à partir de critères de recherche.
Le SI répond au consommateur les essais cliniques correspondant aux critères de recherche et les ressources liées.
Endpoint |
|
Header |
Content-type :=Json + FHIR |
Encodage |
|
Version FHIR |
4.0.0 |
Version package |
|
Publication |
|
Méthode http associée |
GET |
Ressource recherchée |
ResearchStudy |
Construction requête de base |
|
Lien vers la spécification FHIR : http://hl7.org/fhir/R4/bundle.html
Si la recherche est un succès, le serveur répond :
total
. Dans le cas où il n’y a pas de résultat le service renvoie total
: 0. Le nombre de résultats renvoyés peut être modifié en utilisant le modificateur de requête _count, avec une valeur maximale de 5000.Remarque : La recherche est un succès à partir du moment où la requête peut être exécutée. Il peut il y avoir 0 à n correspondances.
Plus de précision sur la spécification FHIR : http://hl7.org/fhir/R4/http.html
Lien vers la spécification FHIR : http://hl7.org/fhir/R4/operationoutcome.html
Si la recherche échoue, le serveur doit répondre :
Remarque : L’échec d’une recherche est la non-possibilité d’exécuter la requête, ce qui est différent d’aucune correspondance à la recherche.
Plus de précision sur la spécification FHIR : http://hl7.org/fhir/R4/http.html
status |
identifier |
Les paramètres et modificateurs de requêtes décrits au paragraphe dédié applicables à ce cas d’usage sont :
Description du scénario : Un consommateur cherche les essais cliniques ayant pour statut = “active”.
Requête :
GET [BASE]/ResearchStudy?status=http://hl7.org/fhir/ValueSet/research-study-status|active&_include=ResearchStudy:site&_include=ResearchStudy:sponsor&_include=ResearchStudy:enrollment
Requête expliquée :
GET [BASE]/ResearchStudy?status=http://hl7.org/fhir/R4/ValueSet/research-study-status|active # Critère de recherche sur le statut
&_include=ResearchStudy:site # Inclus les Location référencées par ResearchStudy
&_include=ResearchStudy:sponsor # Inclus les Organization référencées par ResearchStudy
&_include=ResearchStudy:enrollment # Inclus les Group référencés par ResearchStudy
Description du scénario : Un consommateur souhaite rechercher un essai clinique à partir de son identifiant = XXX.
Requête :
GET [BASE]/ResearchStudy?identifier=XXX&_include=ResearchStudy:site&_include=ResearchStudy:sponsor&_include=ResearchStudy:enrollment
Requête expliquée :
GET [BASE]/ResearchStudy?identifier=XXX # Critère de recherche de l’identifiant de l'essai
&_include=ResearchStudy:site # Inclus les Location référencées par ResearchStudy
&_include=ResearchStudy:sponsor # Inclus les Organization référencées par ResearchStudy
&_include=ResearchStudy:enrollment # Inclus les Group référencés par ResearchStudy