Ressources

Liaison entre plusieurs ressources

Voici des exemples de requêtes permettant de récupérer plusieurs ressources liées en un seul appel. Il est par exemple possible de récupérer les ressources “HealthcareServices” liées à une ressource “PractitionerRole”.

1) Trouver l’Organization et le Practitioner d’un PractitionerRole

Le but ici étant de récupérer les ressources “Organization” et “Practitioner” liées à un PractitionerRole.

Pour cela, nous devons utiliser l’inclusion _include.

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/PractitionerRole?_include=PractitionerRole%3Apractitioner&_include=PractitionerRole%3Aorganization&_count=10"

var client = createClient();

// The practitioner role know the practitioner and the organization, so the main request is on PractitionerRole and then we ask
// the server to include related Organization and Practitioner:

var bundleWithAllResources = (Bundle) client.search().forResource(PractitionerRole.class)
    // inclusion:
    .include(PractitionerRole.INCLUDE_PRACTITIONER.asNonRecursive())
    .include(PractitionerRole.INCLUDE_ORGANIZATION.asNonRecursive())
    .count(10)
    .execute();

$response = $client->request('GET', '/fhir/v1/PractitionerRole?_include=PractitionerRole:practitioner&_include=PractitionerRole:organization');
/** @var  $devices  \DCarbone\PHPFHIRGenerated\R4\FHIRResource\FHIRBundle*/
$practitionerRoles = $parser->parse((string) $response->getBody());

La méthode .count() permet de spécifier le nombre d’entrées maximum à récupérer. Attention, la donnée retourner peut comporter plus que 10 items car les données liées sont retournées à plat dans cette même liste de données.

Il convient donc ensuite de tester le type de donnée afin de pouvoir l’interpréter :

// the bundle contains the page of PractitionerRole elements and additional elements for related Organization and Practitioner:
for(var entry : bundleWithAllResources.getEntry()){
    switch (entry.getResource().fhirType()) {
        case "PractitionerRole":
            // TODO treatment
            break;
        case "Practitioner":
            // TODO treatment
            break;
        case "Organization":
            // TODO treatment
            break;
        default:
            // TODO treatment
            break;
    }
}

// if you want to know which Practitioner/Organization is corresponding to a PractitionerRole you can do it with practitioner/organization field in the PractitionerRole resource:
var practitionerRoles = bundleWithAllResources.getEntry().stream().map(Bundle.BundleEntryComponent::getResource).filter(e -> "PractitionerRole".equals(e.fhirType())).map(PractitionerRole.class::cast).collect(Collectors.toList());
var practitioners = bundleWithAllResources.getEntry().stream().map(Bundle.BundleEntryComponent::getResource).filter(e -> "Practitioner".equals(e.fhirType())).map(Practitioner.class::cast).collect(Collectors.toList());
var organizations = bundleWithAllResources.getEntry().stream().map(Bundle.BundleEntryComponent::getResource).filter(e -> "Organization".equals(e.fhirType())).map(Organization.class::cast).collect(Collectors.toList());

foreach($practitionerRoles->getEntry() as $entry){
    /** @var  $oneResource  \DCarbone\PHPFHIRGenerated\R4\PHPFHIRContainedTypeInterface */
    $oneResource = $entry->getResource();
    switch ($oneResource->_getFHIRTypeName()):
        case 'PractitionerRole':
            // TODO treatment
            /** @var  $oneResource  \DCarbone\PHPFHIRGenerated\R4\FHIRResource\FHIRDomainResource\FHIRPractitionerRole */
            echo $oneResource->getId();
            break;
        case 'Practitioner':
            // TODO treatment
            /** @var  $oneResource  \DCarbone\PHPFHIRGenerated\R4\FHIRResource\FHIRDomainResource\FHIRPractitioner */
            echo $oneResource->getId();
            break;
        case 'Organization':
            // TODO treatment
            /** @var  $oneResource  \DCarbone\PHPFHIRGenerated\R4\FHIRResource\FHIRDomainResource\FHIROrganization */
            echo $oneResource->getId();
            break;
        default:
            // TODO treatment
            break;
    endswitch;
}

2) Trouver le nom, le prénom, la civilité, l’adresse postale et les adresses MSS d’un Practitioner en partant de son identifiant ADELI/RPPS

1) Le nom, le prénom, la civilité et les adresses MSS sont récupérables en une seule requête qui retournera plusieurs objets.

D’une part, le Practitioner sur lequel nous allons pouvoir récupérer le numéro adeli/rpps ainsi que le genre et les mailboxmss.

D’autre part, la liste des PractitionerRole (activités) qui contiendront les noms, les prénoms d’exercice du professionel de santé pour l’activité.

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/Practitioner?identifier=349101808&_revinclude=PractitionerRole%3Apractitioner"

Le résultat retourné est un Bundle contenant le Practitioner et le PractitionerRole.

2) Pour récupérer l’adresse postale, il faut faire une requête complémentaire sur Organization (les adresses étant celles des structures dans lesquelles le professionnel exerce ses activtés).

Dans la réponse de la première requête 1), on retrouve le lien vers la structure d’exercice : <”reference”: “Organization/001-01-519022”>. Cela permet de faire une requête vers l’endpoint Organization afin de récupérer la structure liée à cette activité.

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/Organization?_id=001-01-519022"

Le résultat retourné est un Bundle contenant l’Organization.

3) Trouver l’identifiant ADELI/RPPS, les BAL MSS, les activités ainsi que les structures d’exercice d’un Practitioner en partant de son nom/prénom d’exercice

L’ensemble des informations sont récupérables en une seule requête qui retournera plusieurs objets.

D’une part, pour récupérer les activités, il faut interroger l’endpoint PractitionerRole en filtrant sur le nom d’exercice et le prénom d’exercice du Practitioner.

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/PractitionerRole?family:exact=ROBERT&given=CHRISTIAN"

Le résultat retourné est un Bundle contenant l’ensemble des PractitionerRole (activités) remplissant les conditions à savoir : nom = “ROBERT” et prénom = “CHRISTIAN”.

Les PR retournés contiendront différentes informations comme le nom, le prénom, la civilité d’exerce, la profession, la catégorie professionnelle, le mode d’exercice, la fonction, la carte CPX, le lien vers le professionnel (Practitioner) et le lien vers la structure d’exercice (Organization).

PractitionerRole/005-324864	
PractitionerRole/005-200354-226359	
PractitionerRole/005-231819	
PractitionerRole/005-296896

D’autre part, il est possible de récupéer les Practitioner (professionnels) au même temps que les PractitionerRole (activités) précédemment récupérés 1).

Pour ce faire, il faut utiliser le paramètre ‘_include’ comme suit :

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/PractitionerRole?family:exact=ROBERT&given=CHRISTIAN&_include=PractitionerRole:practitioner"

Le résultat retourné est un Bundle contenant l’ensemble des PractitionerRole et des Practitioner associés.

Les Practitioner retournés contienderont les données relatives au professionel à savoir : le numéro RPPS ou ADELI, la civilité, les diplômes et les BAL MSS.

Les PractitionerRole :

PractitionerRole/005-324864	
PractitionerRole/005-200354-226359	
PractitionerRole/005-231819	
PractitionerRole/005-296896

Les Practitioner :

Practitioner/003-227332	
Practitioner/003-266011	
Practitioner/003-329381	
Practitioner/003-351933

Par ailleurs, il est également possible de récupéer les Organization (structures d’exercice) au même temps que les PractitionerRole (activités) et les Practitioner (professionnels) précédemment récupérés 2).

Pour ce faire, il faut réutiliser le paramètre _include comme suit :

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/PractitionerRole?family:exact=ROBERT&given=CHRISTIAN&_include=PractitionerRole:practitioner&_include=PractitionerRole:organization"

Le résultat retourné est un Bundle contenant l’ensemble des PractitionerRole , des Practitioner et des Organization associés.

Les Organization retournées contienderont les données relatives à la structure comme : le numéro FINESS/SIRET/SIREN, la raison sociale, l’adresse de coresspondance, les adresses mails, le secteur d’activité, la catégorie juridque, …

Les PractitionerRole :

PractitionerRole/005-324864	
PractitionerRole/005-200354-226359	
PractitionerRole/005-231819	
PractitionerRole/005-296896


Les Practitioner :

Practitioner/003-227332	
Practitioner/003-266011	
Practitioner/003-329381	
Practitioner/003-351933

Les Organization :

Organization/001-01-237805

4) Trouver l’ensemble des EG d’un EJ

Le but ici est de remonter l’entité juridique (Ressource Organization) ainsi que les entités géographiques qui lui sont rattachées (Ressource Organization) en partant de l’identifiant EJ.

Pour ce faire, il faut interroger l’endpoint Organization avec le paramètre _revinclude permettant d’inclure dans le résultat les ressources filles liées à la ressource mère.

curl -H "ESANTE-API-KEY: XXXX-XXXX-XXXX-XXXXX" "https://gateway.api.esante.gouv.fr/fhir/Organization?identifier=010000347&_revinclude=Organization%3Apartof"

Le résultat retourné est un Bundle contenant l’EJ et les EG rattachées.