Patient Information

This operator loads the "Patient Record" from the "Data Manager" that is currently selected, and provides the items of the record in its variable parameters.
This operator does not process signal data, so it has no input or output.

If you want to display information about the current patient, put this operator somewhere on a page in your project (presumably the main Design page). Then put a Variable Viewer ("Variable Viewer") on a display or print page and specify an Address. In the address dialog (addresses always start with the $-sign) find the Patient Information operator. It should list the Patient Information in general (which means all patient data) and all the separate items of the patient record. Note that you have to select a patient before any data is displayed!

The address dialog for variable or list viewers will show the items in the patient record of the current patient. If a patient is selected that uses another patient record (e.g. because the patient was imported from another system or even another country), then other items may be displayed.

The Technical Name of a patient record determines the address name. For example, if you see that the address ends with 'LastName', then that is because the record of the current patient uses an item that has the Technical Name 'LastName'. If you would now select a patient that was imported from a German database, that patient might use another patient record that uses the technical name 'Nachname'. In that case, your variable viewer won't show anything.

To cope with this problem, you may also use numbers (starting from 0) to reference items in the patient record. So, if the first item in the record is 'LastName', both following addresses will show an equal result:

$Design.Patient Information.PatientRecord.LastName
$Design.Patient Information.PatientRecord.0

Adding a field in the patient record in your application

Starting from Polybench 1.40 it is possible to add a field to a patien record from within an application. Use the AddItem function for this. If the Data Manager is running in the background, and you are adding an item to the current record of the manager, then after calling the Save function, the record will be updated in the Data Manager.
If no Data Manager is running, then initially the record in this operator will be empty. You can add items to it and use the information during your application's running time. You cannot save the record in that case. Use the Cancel function to clear the record,

When adding an item to the record, you must specify four properties that are written comma-separated in the argument of the AddItem function call:
- the user name, which is the name of the item as presented in the user interface
- the technical name as described above
- the format of the item, which can be left empty, or is N, R, D or T as specified in "Variable Type Formatting".
- optionally one or more of the following options (in any order):
O for Obligatory; the field must be filled out by the user
S for Searchable; the Data Manager Search feature will also look at this item
M for Multiple Lines; the item can hold multiple lines of text
H for Hidden; the item is not shown to the user, but it is stored in the record
R for Read-Only; the item cannot be changed by a user.

Example for a free-text item that obligatory and searchable:
Free Text Item, freeTextItem,, OS

Example for a hidden number that can be searched:
Secret item, secretItem, N, HS

When are patient data updated?

The Patient Information object loads the patient data from the Manager during start-up (immediately after an application is loaded), and after RESET.

So, if you change the selected patient in the Manager, while an application shows patient data using this operator, then the previous patient stays active in the application, until the Patient Information operator receives a RESET action.

Properties

Find more information about changing properties here: "Properties Viewer"

Caption

type: Word or phrase
The name of the object in the project. This name must not contain '.', '$' nor '@' characters.

Documentation

type: See description
Optional documentation of this object. If this object is an operator, the Documentation text is displayed below the operator symbol.

Variable Parameters

Find more information about Variable Parameters here: "Variable Parameters"

PatientRecord

type: Parameter list (see "Parameter List")
This parameter contains all items in the current patient record. Use a Variable Viewer or List Viewer to read the different items, or address the items directly.

DateOfBirth

type: See description
Write a date of birth in this variable in order to get the age of a person in the Age variable.

Age

type: See description
The age of a person as of today, after the variable DateOfBirth has been set to a valid date.

IsManaged

type: See description
If 1, the current record is managed by the Data Manager; if 0, the record can be used when the application is running, but is lost when it closes.

Functions

Find more information about Functions here: "Operator Functions"

Save

Saves the latest changes to the patient record to the patient and measurements manager.

Cancel

Discard the latest changes to the patient record and reload the record from the patient and measurements manager.

AddItem

Adds an item to the current patient record. Use the Save function to commit the item to the patient and measurements manager.