Руководство к использованию стандарта FHIR в ЦИСЗ
0.1.1660 - ci-build
Руководство к использованию стандарта FHIR в ЦИСЗ - Local Development build (v0.1.1660) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Метод предназначен для проверки пакета медицинских данных без его непосредственного импорта (сохранения) в ЦИСЗ.
Этот метод можно использовать во время проектирования и разработки для проверки ресурсов на соответствие профилям.
Этот метод возвращает 200 ОК при условии, что было возможно выполнить проверку, независимо от того, были ли обнаружены проблемы с проверкой. Однако возможно, что определенные ошибки в контенте (например, неверный набор символов, неверный JSON и т. д.) могут привести к сбою всей операции проверки с ответом серии 4xx или 5xx.
Метод проверяет входящий пакет медицинских данных на соответствие профилю пакета медицинских данных.
Вызов метода осуществляется с помощью HTTP POST
команды:
POST [base]/fhir/Bundle/$validate
Входящие параметры метода:
Название | Профиль | Описание |
---|---|---|
bundle | пакет медицинских данных | Пакет медицинских данных, сформированный локальной или облачной медицинской информационной системой |
Исходящие параметры метода:
Название | Профиль | Описание |
---|---|---|
result | documents | В случае успешной проверки пакета медицинских данных возвращается тип данных OperationOutcome со статусом success. В случае возникновения ошибки при проведении проверки пакета медицинских данных возвращается тип данных OperationOutcome со статусом error с детализацией ошибок по результатам пройденной проверки. |
ЦИСЗ может принимать Bundle соответствующий профилю MedicationDocument и только типа document
Входящий профиль ресурса Bundle типа document представляет собой набор медицинских данных о пациенте, включая сведения о медицинском наблюдении за пациентом и услугах, предоставленных пациенту (данные о медицинских осмотрах пациента, проведенных исследованиях и лечении пациента, а также рекомендациях, выданных пациенту).
Входящий ресурс Bundle типа document должен содержать:
• Composition в качестве первого ресурса;
• ресурсы, на которые ссылается Composition (должны содержать сведения о пациенте, состоянии здоровья пациента и виде оказанной медицинской помощи пациенту, в том числе сведения о медицинском работнике и организации, ответственных за подготовку, утверждение и хранение документа);
• вспомогательные ресурсы, которые представляют дополнительные сведения о документе, и ссылки на них;
• идентификатор документа с системой или значением;
• дату создания документа (информацию о том, когда документ был создан в локальной или облачной медицинской информационной системе);
• дату составления документа (информацию о том, когда медицинский работник составил документ в локальной или облачной медицинской информационной системе).
Более подробно о ресурсе Bundle типа document можно ознакомиться по следующей ссылке - documents.
Пример запроса на проверку пакета медицинских данных без его непосредственного сохранения.
{
"resourceType": "Bundle",
"meta": {
"profile": [
"https://fhir.by/AbstractArea/StructureDefenition/Bundle/MedicationDocument"
]
},
"identifier": {
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0"
},
"timestamp": "2013-05-28T22:12:21Z",
"type": "document",
"entry": [
{
"fullUrl": "Composition/1",
"resource": {
"resourceType": "Composition",
"meta": {
"profile": [
"http://hl7.org/fhir/StructureDefinition/clinicaldocument"
]
},
"status": "final",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "28655-9"
}
],
"text": "Discharge Summary from Responsible Clinician"
},
"subject": [
{
"reference": "Patient/b218cee9-019d-47a4-b161-e97c0fd6f736",
"display": "Eve Everywoman"
}
],
"author": [
{
"reference": "Practitioner/36a6e15b-7345-42ae-8a59-7a35059ebb47",
"display": "Doctor Dave"
}
],
"date": "2013-02-01T12:30:02Z",
"title": "Discharge Summary"
}
},
{
"fullUrl": "Patient/b218cee9-019d-47a4-b161-e97c0fd6f736",
"resource": {
"resourceType": "Patient",
"id": "AnonymousPatient01",
"meta": {
"profile": [
"https://fhir.by/StructureDefinition/AnonymousPatientBy"
]
},
"identifier": [
{
"type": {
"coding": [
{
"system": "http://fhir.by/CodeSystem/DocNumbersBySystem",
"code": "ANO"
}
]
},
"value": "331121990999000",
"period": {
"start": "2024-12-31"
},
"assigner": {
"reference": "Organization/ecc51621-0af3-3b35-ac3e-8b1e34022e92"
}
}
],
"active": true,
"name": [
{
"use": "anonymous",
"family": "Иванов",
"given": [
"Петр",
"Сидорович"
]
}
],
"telecom": [
{
"system": "phone",
"value": "89001234567"
}
],
"birthDate": "1990-12-31",
"deceasedBoolean": false
}
},
{
"fullUrl": "Practitioner/36a6e15b-7345-42ae-8a59-7a35059ebb47",
"resource": {
"resourceType": "Practitioner",
"meta": {
"profile": [
"http://hl7.org/fhir/StructureDefinition/Practitioner"
]
},
"name": [
{
"family": "Иванов",
"given": [ "Иван" ]
}
]
}
},
{
"fullUrl": "Organization/ecc51621-0af3-3b35-ac3e-8b1e34022e92",
"resource": {
"resourceType": "Organization",
"active": true,
"name": "SAINT ANNE'S HOSPITAL"
}
}
]
}
Пример ответа в случае успешной проверки пакета медицинских данных.
{
"resourceType": "OperationOutcome",
"id": "cb97a66a-c6a5-4445-8cde-09f4d97d3950",
"meta": {
"lastUpdated": "2024-05-10T09:20:30.9466591+00:00"
},
"issue": [
{
"severity": "success",
"code": "informational"
}
]
}
Пример ответа в случае возникновения ошибки при проведении проверки пакета медицинских данных.
{
"resourceType": "OperationOutcome",
"id": "cb97a66a-c6a5-4445-8cde-09f4d97d3950",
"meta": {
"lastUpdated": "2024-05-10T09:20:30.9466591+00:00"
},
"issue": [
{
"severity": "error",
"code": "invariant",
"details": {
"coding": [
{
"system": "http://hl7.org/fhir/dotnet-api-operation-outcome",
"code": "1012"
},
{
"system": "http://fire.ly/dotnet-sdk-operation-outcome-structdef-reference",
"code": "Bundle(https://fhir.by/AbstractArea/StructureDefenition/Bundle/MedicationDocument)"
}
],
"text": "Instance failed constraint bdl-11 \"A document must have a Composition as the first resource\""
},
"expression": [
"Bundle, element Bundle(https://fhir.by/AbstractArea/StructureDefenition/Bundle/MedicationDocument)"
]
},
]
}
Ссылка | Описание |
---|---|
Скачать | Переменные ЦИСЗ |
Скачать | Коллекция “Проверка пакета медицинских данных без импорта информации”. |