# Recherche de fiche (ITI-67) - Partage de Documents de Santé en mobilité (PDSm) v3.1.0

* [**Table of Contents**](toc.md)
* [**Specifications Techniques**](specifications_techniques.md)
* **Recherche de fiche (ITI-67)**

## Recherche de fiche (ITI-67)

Ce flux intervient lorsque le consommateur de documents souhaite rechercher un ou plusieurs documents d'un patient du gestionnaire partage de documents.

Ces flux se basent sur la requête et la réponse de la transaction IHE "Find Document References [ITI-67](https://profiles.ihe.net/ITI/MHD/ITI-67.html) du profil MHD.

### Flux 05-b de recherche de fiches

Le flux 05-b de recherche de fiches se base sur l’interaction « search » de L’API REST FHIR. Il s’agit d’une requête HTTP GET ou HTTP POST adressant la ressource DocumentReference et regroupant les paramètres listés dans le tableau ci-dessus.

Le flux 05-b contient les critères suivants :

#### Paramètre de recherche sur la ressource DocumentReference

| | | |
| :--- | :--- | :--- |
| type | token | Recherche sur le type de document |
| facility | token | Recherche sur le secteur d'activité associé au document |
| setting | token | Recherche du cadre d'exercice du document |
| identifier | token | Recherche dans l'identifiant de la fiche (idUnique ou idFiche) |
| creation | date | Recherche sur la date de création du document |
| security-label | token | Recherche sur le niveau de confidentialité du document |
| status | token | Description |
| [isArchived](SearchParameter-PDSm-isArchived.md)* | token | Recherche les documents archivés ou non |
| [period-start](SearchParameter-PDSm-DocumentReference-period-start.md)* | date | Contraindre la recherche sur la date de début de l'acte |
| [period-end](SearchParameter-PDSm-DocumentReference-period-end.md)* | date | Contraindre la recherche sur la date de fin de l'acte |
| format | token | Recherche sur le format du document |
| category | token | Recherche sur la classe du document |
| relatesTo | reference | Recherche de l'identifiant de la fiche associée |
| event | token | Recherche sur l'acte de la pathologie |
| period | date | Recherche sur le debut et la fin de l'acte |
| patient | token | Recherche de l'identifiant du patient |
| author | token | Recherche du praticien par identifiant, nom ou prénom |

#### Paramètre de recherche sur les ressources Patient / Practitioner / Device

| | | |
| :--- | :--- | :--- |
| identifier | token | Recherche sur l'identifiant patient / auteur |

#### Paramètre de recherche sur la ressource Patient

| | | |
| :--- | :--- | :--- |
| given | token | Recherche sur le prénom de l'auteur |
| family | token | Recherche sur le nom de l'auteur |

#### Paramètre de recherche sur la ressource PractitionerRole

| | | |
| :--- | :--- | :--- |
| name | token | Recherche sur le nom ou le prénom de l'auteur |

Ci-dessous un exemple de requête :

* Rechercher les ressources de type DocumentReference du patient ayant l’identifiant 32659.

```
GET http://targetsystem.com/API/DocumentReference?patient.identifier=32659 HTTP/1.1

```

### Flux 06b : réponse au flux 05-b

Il s'agit du résultat de la recherche de documents retourné par le gestionnaire de partage de documents. La recherche de fiches retourne les ressources DocumentReference qui correspondent aux critères de recherche fournis par le consommateur de documents. On retrouve les mêmes éléments qui constituent les fiches que lors de la demande d’ajout d’un lot de documents.

Un profil spécifique dérivé du profil IHE MHD « FindDocumentReferencesComprehensiveResponse » est créé pour ce volet et nommé [PDSm_FindDocumentReferencesComprehensiveResponse](StructureDefinition-pdsm-comprehensive-document-reference.md). Il contient zéro ou plusieurs ressources DocumentReference répondants aux critères de la requête.

Ce flux correspond à la réponse à la requête reposant sur l’interaction « search » du flux précédent. En cas de succès, le gestionnaire de partage de documents retourne un code `HTTP 200 OK` ainsi qu’un Bundle de type searchset.

Si le gestionnaire de partage de documents envoie des "warnings", la ressource Bundle doit aussi contenir une ressource "OperationOutcome" qui contient ces "warnings". Si le gestionnaire de partage de documents doit reporter une erreur, il doit utiliser un "[HTTP error response codes](http://hl7.org/fhir/R4/http.html)" et doit inclure un "[FHIR OperationOutcome](http://hl7.org/fhir/R4/operationoutcome.html)" avec plus de détails sur l'échec.

