Talk:Definition of act.text

separating presentation from data

Within V3 we have been very good at making the meanings of each fragment of information clear, and in making the relationships between those fragments clear -- what we have been less good at is making the presentation of the information predictable.

For semantic interoperability you do not want the sender to be suprised by what the receivers clinical decision support system may infer from the data -- But just as important is that the sender should not be suprised by what the reciving system displayed to their users.

We need to provide far clearer definitions of what it is reasonable to expect. Many acts, certainly most clinical statements, will be displayed as either items in a list, as a summary in quarter to a tenth of the screen, or in a full screen "focus-of-attention" view. The first provides room for some text (?act.text? or maybe act.code.displayText or maybe act.code.originalText) and other information (subject, dates, author, location etc) mainly by context. The partial screen view and the full screen view gives scope for including more of the alternate text, as well as associations and context.

The fact that we cannot give clear guidelines on the use of act.text, means that we are far short of the requirement to provide predictable renderings.

GP2GP implementation guidence for the clinical statement "observation"

These are summarised as an example of the level of detail that is needed in an implementation guide or message specification to make use of act.text predictable

observation.text: The description of an act is a piece of free text or multimedia data that describes the observation in all necessary detail.

If present the text attribute should contain the full display text for the ObservationStatement constructed as follows with elements that are not present omitted:

1. uncertaintyCode.originalText (displayText if no originalText)
2. priorityCode.originalText (displayText if no originalText)
3. interpretationCode.originalText (displayText if no originalText)
4. subject.Relation.code.originalText (displayText if no originalText)

1. pertinentInformation[sequenceNumber= -1].Annotation.text
2. code.originalText (displayText if no originalText)
3. pertinentInformation[sequenceNumber= 0].Annotation.text
4. value (representation including all elements within value).
5. pertinentInformation[sequenceNumber= +1].Annotation.text

The order of some of the above elements may be varied. However the relative order of the elements in second list should not be changed.