Norises gaita

Apraksts

Informācija, kas raksturo slimības gaitu – progresija, recidīvs, remisija.

Norises gaitas datu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss Observation, uz kura pamata izveidots FHIR profils CourseOfDisease.

Apstrāde

  1. Iesūtot norises gaitu, ir nepieciešams norādīt slimības pamatdatu karti (FHIR profils OncologyBasicDataOfDisease). To norāda caur Observation.focus lauku.
  2. Iesūtot datus, ir nepieciešams norādīt references uz administratīvajiem profiliem: pacients (Condition.subject.reference), ārējās sistēmas piešķirtā ieraksta identifikatora organizācija (Condition.identifier.assigner.reference).
  3. Katrs datumu raksturojums (piemēram, Progresijas diagnosticēšanas datums, Lokāla recidīva diagnosticēšanas datums u.c.) tiek iesūtīti kā atsevisķi observation. Nav paredzēts, ka tiek iesūtīts viens observation par visu datu kopu.
  4. Norises gaitas norādīšanai ir jāizmanto FHIR value set ar vērtībām [Progresijas diagnosticēšanas datums, Lokāla recidīva diagnosticēšanas datums, Attālu metastāžu diagnosticēšanas datums, Slimības remisijas datums, Papildus informācija]. Klasifikatora kods: 1.3.6.1.4.1.38760.2.645.
  5. Iesūtot jaunu norises gaitu, ir jānorāda statuss 2-Iesniegta (Extension: CardStatusExtension). Statusa maiņas datumu (Extension: CardStatusDateExtension) piešķir Vēža pacientu reģistra IS.
  6. Gadījumā, ja norises gaitu ir nepieciešams anulēt, tiem ir nepieciešams uzstādīt statusu 3-Anulēta (Extension: CardStatusExtension). Statusa maiņas datumu (Extension: CardStatusDateExtension) piešķir Vēža pacientu reģistra IS.

Datu lauki

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
1 Progresijas diagnosticēšanas datums Standard:
Observation.code Observation.value
0..1 Code: Describes what was observed. Sometimes this is called the observation "name".
Value: The information determined as a result of making the observation, if the information has a simple value.
2 Lokāla recidīva diagnosticēšanas datums Standard:
Observation.code Observation.value
0..1 Code: Describes what was observed. Sometimes this is called the observation "name".
Value: The information determined as a result of making the observation, if the information has a simple value.
3 Attālu metastāžu diagnosticēšanas datums Standard:
Observation.code Observation.value
0..1 Code: Describes what was observed. Sometimes this is called the observation "name".
Value: The information determined as a result of making the observation, if the information has a simple value.
4 Attālu metastāžu lokalizācija Standard:
Observation.code Observation.value
0..1 Code: Describes what was observed. Sometimes this is called the observation "name".
Value: The information determined as a result of making the observation, if the information has a simple value.
Metastāžu lokalizācija: 1.3.6.1.4.1.38760.2.621
5 Slimības remisijas datums Standard:
Observation.code Observation.value
0..1 Code: Describes what was observed. Sometimes this is called the observation "name".
Value: The information determined as a result of making the observation, if the information has a simple value.
6 Papildu informācija Standard:
Observation.code Observation.value
0..1 Code: Describes what was observed. Sometimes this is called the observation "name".
Value: The information determined as a result of making the observation, if the information has a simple value.

Citi profila obligātie datu lauki:

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
7 Ārējās sistēmas ieraksta ID Standard:
Condition.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
8 Atsauce uz pacientu Standard:
Condition.subject
1..1 Indicates the patient or group who the condition record is associated with. Atsauce uz VVIS LV pacienta profilu: https://vvis.gov.lv/fhir/StructureDefinition/Patient/LVPatient
9 Atsauce uz Onkoloģijas karti Extension:
RelatedConditionExtension
1..1 Sasaista norises gaitu ar slimības karti
10 Norises gaitas statuss Extension:
CardStatusExtension
1..1 Norises gaitas statuss var būt tikai 2-Iesniegta, 3-Anulēta, 5-Apstiprināta vai 6-Noraidīta
11 Norises gaitas statusa datums Extension:
CardStatusDateExtension
1..1 Datums, kad attiecīgais statuss kartei ir piešķirts. Datumu nav nepieciešams iesūtīt, to automātiski piešķir Vēža pacientu reģistra IS

Profila struktūra

idΣ0..1id
metaΣ I0..1OncologyMeta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedI0..0Resource
cardStatusDateExtensionI0..1Extension(dateTime)
cardStatusExtensionI1..1Extension(CodeableConcept)
modifierExtension?! I0..*Extension
id0..0id
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1codeBinding
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemΣ0..0uri
valueΣ1..1string
periodΣ I0..0Period
assignerΣ I1..1Reference(MedicalInstitution)
basedOnΣ I0..0Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)
partOfΣ I0..0Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)
statusΣ ?!1..1codeBinding
category0..0CodeableConceptBinding
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ I1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
encounterΣ I0..0Reference(Encounter)
issuedΣ0..0instant
performerΣ I0..0Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)
valueCodeableConceptCodeableConcept
valueStringstring
valueDateTimedateTime
dataAbsentReasonI0..0CodeableConceptBinding
interpretation0..0CodeableConceptBinding
note0..0Annotation
bodySite0..0CodeableConcept
method0..0CodeableConcept
specimenI0..0Reference(Specimen)
deviceI0..0Reference(Device | DeviceMetric)
hasMemberΣ I0..0Reference(Observation | QuestionnaireResponse | MolecularSequence)
derivedFromΣ I0..0Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)

Profila validācijas

Nr. Nosacījums Tips Validācija FHIR
1. Attālu metastāžu diagnosticēšanas datums – ir obligāts, ja šajā sadaļā (Slimības norises gaita) ir izvēlēta vērtība laukā “Attālo metastāžu lokalizācija” FHIRPath Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-5
2. Attālu metastāžu lokalizācija – ir obligāts, ja šajā sadaļā (Slimības norises gaita) ir izvēlēta vērtība laukā “Attālo metastāžu diagnosticēšanas datums” FHIRPath Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-6
3. Progresijas diagnosticēšanas datums nevar būt nākotnē. Progresijas datumam ir jābūt lielākam par diagnozes noteikšanas datumu FHIRPath ID: CourseOfDisease-con-1
Progresijas diagnosticēšanas datums nevar būt nākotnē:
iif((value is dateTime or value is date) and value.exists(), value.toDateTime() <= now(), true)

Progresijas datumam ir jābūt lielākam par diagnozes noteikšanas datumu:
Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-1
4. Lokāla recidīva diagnosticēšanas datums nevar būt nākotnē. Lokāla recidīva datumam ir jābūt lielākam par diagnozes noteikšanas datumu FHIRPath ID: CourseOfDisease-con-1
Lokāla recidīva diagnosticēšanas datums nevar būt nākotnē:
iif((value is dateTime or value is date) and value.exists(), value.toDateTime() <= now(), true)

Lokāla recidīva datumam ir jābūt lielākam par diagnozes noteikšanas datumu:
Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-2
5. Slimības remisijas datums nevar būt nākotnē. Remisijas datumam ir jābūt lielākam par diagnozes noteikšanas datumu FHIRPath ID: CourseOfDisease-con-1
Slimības remisijas datums nevar būt nākotnē:
iif((value is dateTime or value is date) and value.exists(), value.toDateTime() <= now(), true)

Remisijas datumam ir jābūt lielākam par diagnozes noteikšanas datumu:
Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-3
6. Attālu metastāžu diagnosticēšanas datums nevar būt nākotnē. Metastāžu diagnosticēšanas datumam ir jābūt lielākam par diagnozes noteikšanas datumu FHIRPath ID: CourseOfDisease-con-1
Attālu metastāžu diagnosticēšanas datums nevar būt nākotnē:
iif((value is dateTime or value is date) and value.exists(), value.toDateTime() <= now(), true)

Metastāžu diagnosticēšanas datumam ir jābūt lielākam par diagnozes noteikšanas datumu:
Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-4
7. Klasfikatora kodam (datums) jāsakrīt ar datuma lauku FHIRPath ID: CourseOfDisease-con-2, CourseOfDisease-con-3, CourseOfDisease-con-4, CourseOfDisease-con-5
Pamatā datumu validācijām tiek izmantota validācija
$this='KODS' implies (%resource.value.ofType(dateTime).exists())
Zemāk uzskaitīti kodi, pēc kuriem notiek datuma validācija:
PROGRESSION_DIAGNOSIS_DATE
LOCAL_RECURRENCE_DIAGNOSIS_DATE
DISTANT_METASTASES_DIAGNOSIS_DATE
DISEASE_REMISSION_DATE
8. Klasifikatora kodam jāsakrīt ar iesūtāmā klasifikatora OID FHIRPath ID: CourseOfDisease-con-6
Pamatā klasifikatoru validācijas tiek izmantota validācija
$this='KODS' implies (%resource.value.ofType(CodeableConcept).exists() and %resource.value.ofType(CodeableConcept).coding.where(system='https://vvis.gov.lv/fhir/ValueSet/KLASIFIKATORA_OID).exists())
Zemāk uzskaitīts izmantotais klasifikatoru kods un tā attiecīgais OID:
DISTANT_METASTASES_LOCALIZATION - 1.3.6.1.4.1.38760.2.621
9. Klasifikatora kodam (teksts) ir jāsakrīt ar teksta lauku FHIRPath ID: CourseOfDisease-con-7
Pamatā teksta validācijām tiek izmantota validācija
$this='KODS' implies (%resource.value.ofType(string).exists())
Zemāk uzskaitīts kods, pēc kura notiek teksta validācija:
ADDITIONAL_INFO
10. Norises gaitas datu statuss var būt tikai 2-Iesniegt, 3-Anulēta, 5-Apstiprināta vai 6-Noraidīta FHIRPath CourseOfDisease-con-8
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$|^5$|^6$')

Datu iesūtīšanas piemēri

Skatīt Postman kolekcijas struktūru CourseOfDisease:

Darbība Nosaukums Apraksts
POST Create CourseOfDisease (using code field) Jaunas norises gaitas datu iesūtīšana, norādot klasificētu vērtību
POST Create CourseOfDisease (using date field) Jaunas norises gaitas datu iesūtīšana, norādot datuma lauku
POST Create CourseOfDisease (using additional info field) Jaunas norises gaitas datu iesūtīšana, norādot papildus info lauku
GET Get CourseOfDisease Esošas norises gaitas datu izgūšana pēc ID
PUT Update CourseOfDisease Esošas norises gaitas datu labošana
GET Search for CourseOfDisease entry by OncologyBasicDataOfDisease reference Norises gaitas meklēšana pēc Slimības pamatdatu references