Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Génération de documents cliniques avec $document
AWS HealthLake prend désormais en charge le $document fonctionnement des ressources de composition, ce qui vous permet de générer un document clinique complet en regroupant la composition et toutes ses ressources référencées dans un seul package cohérent. Cette opération est essentielle pour les applications de santé qui doivent :
-
Créez des documents cliniques standardisés
-
Échangez les dossiers complets des patients
-
Stockez une documentation clinique complète
-
Générez des rapports qui incluent tous les contextes pertinents
Utilisation
L'$documentopération peut être invoquée sur les ressources de composition à l'aide des méthodes GET et POST :
Opérations prises en charge
GET/POST [base]/Composition/[id]/$document
Paramètres pris en charge
HealthLake prend en charge le $document paramètre FHIR suivant :
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
persist |
booléen | Non | false | Booléen indiquant si le serveur doit stocker le paquet de documents généré |
Exemples
Demande GET
GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
Requête POST avec paramètres
POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document
Content-Type: application/fhir+json
{
"resourceType": "Parameters",
"parameter": [
{
"name": "persist",
"valueBoolean": true
}
]
}
Exemple de réponse
L'opération renvoie une ressource Bundle de type « document » contenant la composition et toutes les ressources référencées :
{
"resourceType": "Bundle",
"id": "180f219f-97a8-486d-99d9-ed631fe4fc57",
"type": "document",
"identifier": {
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0"
},
"timestamp": "2024-06-21T15:30:00Z",
"entry": [
{
"fullUrl": "http://example.org/fhir/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57",
"resource": {
"resourceType": "Composition",
"id": "180f219f-97a8-486d-99d9-ed631fe4fc57",
"status": "final",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "34133-9",
"display": "Summary of Episode Note"
}
]
},
"subject": {
"reference": "Patient/example"
},
"section": [
{
"title": "Allergies",
"entry": [
{
"reference": "AllergyIntolerance/123"
}
]
}
]
}
},
{
"fullUrl": "http://example.org/fhir/Patient/example",
"resource": {
"resourceType": "Patient",
"id": "example",
"name": [
{
"family": "Smith",
"given": ["John"]
}
]
}
},
{
"fullUrl": "http://example.org/fhir/AllergyIntolerance/123",
"resource": {
"resourceType": "AllergyIntolerance",
"id": "123",
"patient": {
"reference": "Patient/example"
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "418689008",
"display": "Allergy to penicillin"
}
]
}
}
}
]
}
Attitude
L'$documentopération :
-
Utilise la ressource de composition spécifiée comme base du document
-
Identifie et récupère toutes les ressources directement référencées par la composition
-
Regroupe la composition et toutes les ressources référencées dans un ensemble de type « document »
-
Stocke le paquet de documents généré dans la banque de données lorsque le paramètre persist est défini sur true
-
Identifie et récupère les ressources référencées indirectement par la composition pour une génération complète de documents
L'$documentopération prend actuellement en charge la récupération de références de ressources au format suivant :
-
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id -
Ressource/ID
Les références de ressources non prises en charge dans la ressource Composition seront éliminées du document généré.
Gestion des erreurs
L'opération gère les conditions d'erreur suivantes :
-
400 Mauvaise demande :
$documentopération non valide (demande non conforme) ou si le document obtenu échoue à la validation FHIR en raison du filtrage des références lorsque persist est défini sur true -
404 Introuvable : ressource de composition introuvable
Pour plus d'informations sur les spécifications de $document fonctionnement, consultez la documentation de composition $document du FHIR R4