FHIR Bundle: девять типов и когда какой использовать

Краткий ответ: Bundle — это ресурс FHIR, который группирует другие ресурсы: результаты поиска, набор операций записи, отправленных в одном запросе, клинический документ, такой как сводка данных пациента, или сообщение. Его тип указывает, что означает группа и как сервер должен ее обрабатывать.

Девять типов в FHIR R4

• searchset: результаты поиска со ссылками для постраничного вывода.
• transaction: операции записи, обрабатываемые по принципу «всё или ничего»; если одна операция не удалась, не применяется ни одна.
• batch: операции записи, обрабатываемые независимо; каждая запись либо успешна, либо неуспешна сама по себе.
• transaction-response / batch-response: то, что возвращает сервер для каждой из них.
• document: клинический документ (первая запись — это Composition), такой как Международная сводка данных пациента (International Patient Summary); он подписывается или хранится целиком.
• message: сообщение, первая запись — это MessageHeader.
• history: версии ресурсов.
• collection: набор ресурсов без дополнительного значения.

Transaction vs batch

Используйте transaction, когда ресурсы зависят друг от друга, например, пациент и связанные с ним наблюдения (Observations): ссылки между записями могут использовать временные идентификаторы urn:uuid:, которые сервер разрешает. Используйте batch для независимых операций, где частичный успех приемлем.

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {"fullUrl": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a",
     "resource": {"resourceType": "Patient", "name": [{"family": "Example"}]},
     "request": {"method": "POST", "url": "Patient"}},
    {"resource": {"resourceType": "Observation", "status": "final",
       "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]},
       "subject": {"reference": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a"},
       "valueQuantity": {"value": 72, "unit": "/min", "system": "http://unitsofmeasure.org", "code": "/min"}},
     "request": {"method": "POST", "url": "Observation"}}
  ]
}

В Anpheros

Платформа Anpheros принимает бандлы типа transaction и batch, а также возвращает бандлы типа searchset с постраничным выводом; Международная сводка данных пациента возвращается как бандл типа document. Посетите песочницу FHIR, чтобы попробовать их, и ознакомьтесь с Международной сводкой данных пациента в FHIR.

Связанные страницы

• Поиск FHIR: объяснение
• FHIR R4 против R5

Источники

• HL7 FHIR R4: Bundle
• HL7 FHIR R4: Типы Bundle

Частые вопросы

В чем разница между транзакцией FHIR и пакетом (batch)?

Транзакция — это «всё или ничего»; пакет обрабатывает каждую запись независимо.

Как сослаться на ресурс, созданный в том же бандле?

Присвойте ему полный URL (fullUrl), например urn:uuid:..., и используйте его как ссылку; в транзакции сервер заменяет его реальным идентификатором.

Какой тип у сводки данных пациента?

Бандл типа document, первая запись которого — это Composition.

Почему мой поиск возвращает Bundle?

Результаты поиска всегда представляют собой бандл типа searchset со ссылками на следующую страницу.

Anpheros Platform

Попробуйте бесплатно в песочнице

Первый запрос FHIR за 5 минут. API HL7 FHIR R4 с встроенным согласием пациента: попробуйте в песочнице, затем подключите свое приложение или систему клиники.

Создать бесплатную песочницуЧитать руководства для разработчиков →

Бесплатно · 30 синтетических пациентов · без карты

Автор

Команда Anpheros

Anpheros создает медицинскую карту, которую пациент контролирует и может делиться с любой клиникой, на платформе HL7 FHIR R4, базирующейся в ЕС. Эти руководства помогут вам понять и организовать свое здоровье; они не заменяют вашего врача.

О Anpheros →