Click or drag to resize
Patient Record Tree

[This is preliminary documentation and is subject to change.]

When the user has selected a patient, the patient is set in context. The patient submenu /a tab set) is shown - in this submenu, the item (tab) "Input" is automatically selected. This displays two frames:

  • The left frame displays the record tree.

  • The right frame is initially blank (per default). It is a work area for creating / viewing / updating / deleting individual records (form instances). The content varies as the user clicks nodes in the record tree in the left frame.

This topic contains the following sections.

Overall description of the record tree

The root of the record tree is always the patient node (note that "patient" may be labelled something else in the actual application). The text of the node displays the national id and name of the patient. Clicking this node opens the patient property form (that allows viewing / editing properties of the patient) in the right frame.

Everything else in the record tree varies from application to application, as it is defined (by the Role Configurator) in the Data Dictionary which is built from The Structure File.

But of course there are some similarities. All nodes in the record tree are of one of the following types:

  • "Open" node

  • "Hint" node

  • "Create" node

  • "Fill-in" node

  • "Group" node

"Open" nodes

Each "open node" corresponds to one record (= form instance).

The text in the "open node" displays two pieces of information:

  • The name of the record. This name is per default read from the Caption-property of the table in the Data Dictionary, that defines the form / type of record. The configurator may define a computation "Name" in The Structure File, which is be used to give a record a name that depends on the content of the record (and/or a parent or sub record).

  • A date value. This value is per default the DateStart-value stored in the database for the record. The configurator may define a computation "DisplayDate" in The Structure File, which may be used to display some other date (read or calculated from the current record and/or ancestor/descendant records).

"Open" nodes ar active, i.e. the user may click an "open" node, and the corresponding form will be shown in the right frame.

The security system hides or inactivates records, that the user does not have read access to. Role Configurator should consult Configuring Security for information on how to set parameters controlling the security.

"Hint" nodes

Each "hint" node corresponds to one record (= form instance), just like "open" nodes.

"Hint" nodes are only displayed, if the end user does not have read access to the corresponding record, and Role Configurator has specified AccessModeDenied=Hint in The Structure File.

The differences between "open" and "hint" nodes are:

  • "Hint" nodes are "inactive", i.e. user cannot click them

  • "Hint" nodes never shows any content, i.e. subrecords are never displayed.

"Create" nodes

The text of a "create" node is read from the Caption property of the table (in the Data Dictionary) that defines the type of record being created (and hence the form to display).

The configurator may define a computation "Name" in The Structure File, in order to disply a different text for the "create" node.

Clicking a "create" node displays an "empty" form in the right frame. Most field in the form will be empty, except those fields, where default values are computed in the configured forms (see Working with Forms).

"Fill-in" nodes

A "fill-in" node is conceptually the same as a "create" node - both initiate creating new records (form instances) in the database (clicking displays an "empty" form in the right frame).

The difference is, that a "create" node creates new records in a 1:N-relation (there may be several records of the given type in the given context), whereas a "fill-in" node creates a new record in a 1:1-relation (there may be at most one record of the given type in the given context).

If a record of the given type already exists in the 1:1-relation, no "fill-in" node is displayed (an "open" node is displayed in this case).

Security

The security system hides or inactivates nodes in the record tree, depending on what the user has access to. The record tree is therefore the most important place in the application's user interface in terms of controlling access to individual patient record data.

The configurator should consult Configuring Security for information on how to set up the security.