Archetype designer: Creation of a cluster to include an additional field as "Parsable text"

Hello everyone

My situation:
Currently, I am designing the template for the medication order in the archetype designer provided by tools.openehr.org.

My problem:
In order to fulfill the given use case, I want to create a cluster named “Flag” that covers the scope and definition as specified by HL7 FHIR for the resource “Flag”. Based on this specification, I intend to map the field “identifier” in the resource Flag onto the created cluster “Flag”. In the cluster Flag, I aim to have this field as “Parsable text”. Unfortunately, I am not able to find this input field as an option in the archetype designer.

My two questions:

  • I am seeking your help to figure out, if parsable text can be included using the archetype designer at tools.openehr.org.
  • And if yes, how can I do this?

Hi Lukas,

To add datatypes that do not have specific button in the toolbar you can use the Available Type field

image

So typically add a Text element - add Parsable as a datatype and then remove the original text Type - it will now be a Parsable datatype.

However, I don’t think you need a new archetype, or perhaps even the parsable Identifier

We use the Precaution archetype for the ‘alerts list’ in the London UCP and it is a very close match to Flag

What information would you expect to carry in the Identifier element - normally this would not be required in an openEHR system, unless you need to capture an external identifier coming from a source system, in which case you can use the feeder_audit structures provided by the Reference model.

Hi Ian

Thank you so much for your answer and your help for how to create a parsable text in archetype designer.

As well as your insight on the archetype “Precaution”. Unfortunately, I haven’t thought of that. After reading the definition of the archetype “Precaution”, I realized, that I also want to create warnings that are independent of a condition or a state of the individual as well as current treatments/procedures such as

  • A particular provider is unavailable for referrals over a given period (subject = Practitioner, FHIR R5)
  • Special guidance or caveats to know when following a protocol (subject=PlanDefinition, FHIR R5)
  • Warnings about using a drug in a formulary requires special approval (subject=Medication, FHIR R5)
  • Patient currently undergoing quarantine due to whatever infection

Some examples are drawn for the definition of Flag in FHIR R5 (marked as such), but are examples, that we also require in our data model. Consequently, I wanted to ask you

Are the archetype “Precaution” in openEHR and the resource “Flag” in FHIR R5 the same?

Overall, my model definition of a Flag in archetype designer overlaps quite well with Precaution, such that I can use it.

A particular provider is unavailable for referrals over a given period (subject = Practitioner, FHIR R5)

This needs to be in some sort of resource, either associated with the practitioner or practitioner role , not in the openEHR patient record, so not in scope for the CDR

Special guidance or caveats to know when following a protocol (subject=PlanDefinition, FHIR R5)

I think that belongs in the protocol which is probably not part of the patient record - so not in the CDR at all.

Warnings about using a drug in a formulary requires special approval (subject=Medication, FHIR R5)

I would expect that to be carried in some sort of definitional resource external to the CDR e.g a drug reference terminology or formulary document i.e. not in the patient record. The record of approval could be carried in the patient record e.g. Cluster Archetype: Medication authorisation [openEHR Clinical Knowledge Manager]Prescriber endorsement

Patient currently undergoing quarantine due to whatever infection

That is be a good use case for a openEHR Precaution though officially it is designed for ‘Therapeutic precautions’, however I know it is being used in e.g. London for wider Alerts exactly as you are suggesting.