Médicosocial - Suivi Décisions Orientation
4.0.2-ballot - STU1

This page is part of the Médicosocial - Suivi Décisions Orientation (v4.0.2-ballot: Release) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 4.0.4. For a full list of available versions, see the Directory of published versions

Flux 5 - Recherche et consultation de statut

Flux 5.1 - RechercheStatut

Ce flux permet à un ESMS de savoir si le statut de décision des personnes orientées en cours d’instruction est passé à « Période d’essai en cours » (code 185) ou « Usager pris en charge » (code 186) dans un autre ESMS. Il permet également de rechercher si un statut de décision, de l’ESMS émettant la recherche, est passé à « Admission impossible entérinée » (code 46).
Cette recherche est ainsi formulée par le SI-ESMS auprès du SI-SDO.

diagramme de séquence

SI-SDOSI-ESMSFlux 5.1RechercheStatut  GET [base]/Task?_lastUpdated=gt[dateDernièreRecherche]&_elements=idFlux 5.2ResultatStatut  OK 200 (+ ressource "Bundle")Liste des identifiants des ressourcesTask répondant à la recherche.loopFlux 5.3ConsultationStatut  GET [base]/Task/idFlux 5.4ResultatConsultationStatut  OK 200 (+ ressource "Task")La ressource Task véhiculant un statut"Usager prise en charge" ou"Admission impossible entérinée".

Construction du flux

Le flux 5.1 est basé sur l’opération « search » de l’API REST FHIR. La recherche s’effectue sur la ressource de type Task et est constituée des paramètres de recherche obligatoire listés dans le tableau ci-dessous :

Paramètre

Description

Format du paramètre

Contrainte

_lastUpdated

Date de dernière recherche

date

Utilisation du préfix « gt » (greater than) pour permettre au SI-ESMS de ne récupérer que les nouvelles ressources Task créées depuis la dernière interrogation.  

_elements

Le paramètre élément liste les attributs de la ressource à retourner par le serveur

Liste d’éléments séparés par des virgules

Ce paramètre doit avoir pour valeur id.

Cette recherche sera envoyée au SI-SDO en utilisant la requête HTTPS GET suivante :

GET [base]/Task?_lastUpdated=gt[dateDernièreRecherche]&_elements=id

  • [base] est le point de contact FHIR
  • [dateDernièreRecherche] est au format Année-Mois-Jour

Flux 5.2 - ResultatStatut

Ce flux contient le résultat de la recherche de mise à jour des statuts des décisions d’orientation. Cette réponse est retournée par le SI-SDO au SI-ESMS. Il s’agit d’un flux qui permet de retourner la liste des ressources « Task » répondant aux critères de recherche. Le SI-SDO s’appuie sur les informations du token d’authentification pour ne retourner que les statuts des décisions concernant l’ESMS ayant effectué la requête.
Le SI-SDO filtre également les ressources des décisions concernant l’ESMS pour ne retourner que :

  • Le statut « Période d’essai en cours » (code 185) ou « Usager pris en charge » (code 186) lié à un autre ESMS,
  • Le statut « Admission impossible entérinée » (code 46) d’un dossier de l’ESMS ayant émis la recherche

diagramme de séquence

SI-SDOSI-ESMSFlux 5.1RechercheStatut  GET [base]/Task?_lastUpdated=gt[dateDernièreRecherche]&_elements=idFlux 5.2ResultatStatut  OK 200 (+ ressource "Bundle")Liste des identifiants des ressourcesTask répondant à la recherche.loopFlux 5.3ConsultationStatut  GET [base]/Task/idFlux 5.4ResultatConsultationStatut  OK 200 (+ ressource "Task")La ressource Task véhiculant un statut"Usager prise en charge" ou"Admission impossible entérinée".

Construction du flux

Le flux 5.2 se compose d’un code HTTPS 200 ok et d’un contenu. Le contenu est une ressource « Bundle » de type « searchset » encapsulant zéro, une ou plusieurs ressources « Task » répondant aux critères de recherche. Comme la recherche contient le paramètre _elements=id, les ressources « Task » ne contiendront pas l’ensemble des données connues du SI-SDO mais uniquement l’identifiant technique de la ressource permettant au SI-ESMS d’aller les consulter (cf flux 5.3). En cas d’échec, le SI-SDO doit répondre avec le code HTTPS approprié tel que défini par l’API REST FHIR (Http - FHIR v4.0.1 (hl7.org)). Une ressource OperationOutcome doit également y être associé pour véhiculer les messages d’erreurs détaillant la raison de l’erreur (OperationOutcome - FHIR v4.0.1 (hl7.org)).

Flux 5.3 - ConsultationStatut

Ce flux contient une demande de consultation d’un statut d’une décision d’orientation dont l’identifiant technique connu a été remonté par le flux 5.2. Cette demande de consultation est formulée par le SI-ESMS auprès du SI-SDO et fait suite à la recherche de mise à jour des statuts des décisions d’orientation.

diagramme de séquence

SI-SDOSI-ESMSFlux 5.1RechercheStatut  GET [base]/Task?_lastUpdated=gt[dateDernièreRecherche]&_elements=idFlux 5.2ResultatStatut  OK 200 (+ ressource "Bundle")Liste des identifiants des ressourcesTask répondant à la recherche.loopFlux 5.3ConsultationStatut  GET [base]/Task/idFlux 5.4ResultatConsultationStatut  OK 200 (+ ressource "Task")La ressource Task véhiculant un statut"Usager prise en charge" ou"Admission impossible entérinée".

Construction du flux

Le flux 5.3 est basé sur l’opération « read » de l’API REST FHIR. La demande est envoyée via une requête HTTP GET basée sur le modèle suivant :

GET [base]/Task/id

  • [base] est le point de contact FHIR ;
  • [id] est l’identifiant technique de la ressource Task tel que reçu dans le flux 5.2.

Flux 5.4 - RésultatConsultationStatut

Ce flux contient le résultat de la demande de consultation d’un statut d’une décision d’orientation (flux 5.3). Cette réponse est retournée par le SI-SDO au SI-ESMS.

diagramme de séquence

SI-SDOSI-ESMSFlux 5.1RechercheStatut  GET [base]/Task?_lastUpdated=gt[dateDernièreRecherche]&_elements=idFlux 5.2ResultatStatut  OK 200 (+ ressource "Bundle")Liste des identifiants des ressourcesTask répondant à la recherche.loopFlux 5.3ConsultationStatut  GET [base]/Task/idFlux 5.4ResultatConsultationStatut  OK 200 (+ ressource "Task")La ressource Task véhiculant un statut"Usager prise en charge" ou"Admission impossible entérinée".

Construction du flux

Le flux 1.4 se compose d’un code HTTP 200 ok et contient la ressource Task souhaitée. En cas d’échec, le SI-SDO doit répondre avec le code HTTPS approprié tel que défini par l’API REST FHIR (Http - FHIR v4.0.1 (hl7.org)). Une ressource OperationOutcome doit également y être associé pour véhiculer les messages d’erreurs détaillant la raison de l’erreur (OperationOutcome - FHIR v4.0.1 (hl7.org)).