Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Modifica delle risorse con l'operazione PATCH

AWS HealthLake supporta l'operazione PATCH per le risorse FHIR, che consente di modificare le risorse prendendo di mira elementi specifici da aggiungere, sostituire o eliminare senza aggiornare l'intera risorsa. Questa operazione è particolarmente utile quando è necessario:

Formati PATCH supportati

AWS HealthLake supporta due formati PATCH standard:

Patch JSON (RFC 6902)

Utilizza la sintassi JSON Pointer per indirizzare gli elementi in base alla loro posizione nella struttura delle risorse.

Tipo di contenuto: application/json-patch+json

FHIRPath Patch (specifica FHIR R4)

Utilizza FHIRPath le espressioni per indirizzare gli elementi in base al loro contenuto e alle loro relazioni, fornendo un approccio nativo FHIR all'applicazione delle patch.

Tipo di contenuto: application/fhir+json

Utilizzo

Operazioni PATCH dirette

L'operazione PATCH può essere richiamata direttamente sulle risorse FHIR utilizzando il metodo HTTP PATCH:

PATCH [base]/[resource-type]/[id]{?_format=[mime-type]}

PATCH in pacchetti

Le operazioni PATCH possono essere incluse come voci all'interno di pacchetti FHIR di tipo batch oppure transaction consentono di combinare le operazioni di patch con altre interazioni FHIR (creazione, lettura, aggiornamento, eliminazione) in un'unica richiesta.

Formato di patch JSON

Operazioni supportate

Sintassi del percorso

JSON Patch utilizza la sintassi JSON Pointer (RFC 6901):

Esempi

Richiesta diretta di patch JSON con più operazioni

PATCH [base]/Patient/example
Content-Type: application/json-patch+json
If-Match: W/"1"

[
  {
    "op": "replace",
    "path": "/name/0/family",
    "value": "Smith"
  },
  {
    "op": "add",
    "path": "/telecom/-",
    "value": {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  },
  {
    "op": "remove",
    "path": "/address/0"
  },
  {
    "op": "move",
    "from": "/name/0/family",
    "path": "/name/1/family"
  },
  {
    "op": "test",
    "path": "/gender",
    "value": "male"
  },
  {
    "op": "copy",
    "from": "/name/0",
    "path": "/name/1"
  }
]

Richiesta diretta di patch JSON con singola operazione

PATCH [base]/Patient/example
Content-Type: application/json-patch+json

[
  {
    "op": "replace",
    "path": "/active",
    "value": false
  }
]

Patch JSON in bundle

Usa una risorsa binaria contenente il payload della patch JSON con codifica base64:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Binary",
      "contentType": "application/json-patch+json",
      "data": "W3sib3AiOiJhZGQiLCJwYXRoIjoiL2JpcnRoRGF0ZSIsInZhbHVlIjoiMTk5MC0wMS0wMSJ9XQ=="
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

FHIRPath Formato della patch

Operazioni supportate

Sintassi del percorso

FHIRPath La patch utilizza FHIRPath espressioni che supportano:

Esempi

Richiesta diretta di patch FHIRPath

PATCH [base]/Patient/123
Content-Type: application/fhir+json
Authorization: ...

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "operation",
    "part": [
      { "name": "type", "valueCode": "add" },
      { "name": "path", "valueString": "Patient" },
      { "name": "name", "valueString": "birthDate" },
      { "name": "value", "valueDate": "1990-01-01" }
    ]
  }]
}

FHIRPath Patch inclusa nel pacchetto

Usa una risorsa Parameters come risorsa di ingresso conmethod: PATCH:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Parameters",
      "parameter": [{
        "name": "operation",
        "part": [
          { "name": "type", "valueCode": "add" },
          { "name": "path", "valueString": "Patient" },
          { "name": "name", "valueString": "birthDate" },
          { "name": "value", "valueDate": "1990-01-01" }
        ]
      }]
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

Intestazioni di richiesta

Risposta di esempio

L'operazione restituisce la risorsa aggiornata con le informazioni sulla nuova versione:

HTTP/1.1 200 OK
Content-Type: application/fhir+json
ETag: W/"2"
Last-Modified: Mon, 05 May 2025 10:10:10 GMT

{
  "resourceType": "Patient",
  "id": "example",
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  ],
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-05-05T10:10:10Z"
  }
}

Comportamento

L'operazione PATCH:

Gestione errori

L'operazione gestisce le seguenti condizioni di errore:

Riepilogo delle capacità

Limitazioni

Risorse aggiuntive

Per ulteriori informazioni sulle operazioni PATCH, consulta: