Device Template

The device template allows you to configure what data should be managed for a new type of device and how it should behave. You can have multiple templates allowing for different device types or even different modus operandi of the same device type under different settings. For example, in organization A your device is set to measure heart rate & blood pressure and receives a specific configuration, while in organization B it only measures heart rate and does not need to receive configuration parameters.

The device template comes both with pre-built fields you can choose from as well as the ability to add any custom field. For each field you can specify whether it is mandatory or optional. If the field is not needed, you can delete it.

For every template you need to define the template name and you can add an optional text description of what this template represents.

Every field in the device template represents a field that may be populated when creating a new device from this template type or later in the device lifecycle. Fields are either populated by the user during configuration of the device, or by the device itself (in case of status fields). Some fields are needed for proper device operations and are received from or sent to the device.

The device template has the following different segments:

General fields – Fields that define information related to the device (name, location, association with patients, time zone, etc.) that the system users need to know, but are of no concern to the device itself.
Status fields – Fields that pertain to how the device sends statuses to the system and how statuses should be interpreted.
Configuration fields – Fields that define what type of configurations should be sent to the device and how they should be sent.
Usage Type fields – Fields that define how the device is used and how frequently it sends measurements.

General Fields Defaults

The table below shows the general fields that are available out of the box and what their default definitions are. You, the device manufacturer, can at any time change the default settings (for example, set an optional field to be mandatory).
For additional information on the different field types, see Attribute Types.

Field	Description	Field Type	Required (R)/ Optional (O)
Name	A name to be assigned to every new device.	Label	O
Description	A short description for the new device (for example "BO monitor for nurse station room 401").	Paragraph	O
Unique ID	A form of unique Id that is used to identify a specific device (usually used as part of the production process- for example device S/N).	Label	R
Time zone	What time zone the device operates in.	Date Time	O
Creation time	Time the device was created (in the system or time of manufacturing- this can represent any time you want).	Date Time	O
Last modified time	Time of last change done to the device entity (time it was last edited).	Date Time	O
Owner Organization	The organization that the device is associated with (for example, a specific hospital, clinic, etc.).	Entity	R
Patient	Used to assign the device to a specific patient – usually only done if the device is assigned to a specific patient (for example a heart implant).	Entity	O

You can customize the general fields as you choose and add/remove fields from the table. The following table shows the options for adding fields to the General fields tab of the device template.

Adding a General Field

Step	Description	Field Type
Add Name	The new name of the custom general field to be added.	Label
Assign Format	The type of value format this field should hold.	Label Paragraph Integer Decimal Boolean Single Select Multi Select Address Name Phone Email Date Time Date Entity Timezone Locale
Set DEV name	The name of the field in the JSON message format that corresponds with this field in BioT APIs.	N/A
Assign mandatory	Indicates whether the field is required or not.	Flag
Assign PHI	Indicates whether the field carries personal health information.	Flag

Status Fields

Device status fields allow you to configure what type of statuses are available with your device. The device status tab comes with a list of pre-defined fields you can choose from as well as the ability to add or remove fields.

Built-in (Pre-defined) Status Fields

Field	Description	Field Type	Required (R)/ Optional (O)
FW version	The latest firmware version of the device.	Label	O
HW version	The latest hardware version of the device.	Label	O
Connected	Indicates if the device is connected to the cloud or not.	Boolean	R
IP Address	The current IP address of the device.	Label	O
Last connected time	Last time the device connected to the cloud (prior to this session).	Date Time	R
Certificate status	The certificate status (installed, bootstrap, not installed).	Single select	O
Boot time	Last time the device performed a boot.	Date time	O
Device operational health status	The operational status of the device – OK (working properly), critical fault, major fault, minor fault.	Single select	O
Device operational health message	A text message that can be displayed when an operational status is received.	Paragraph

Adding a Status Field

Action	Description	Field Type
Add Name	The new name of the custom status field to be added.	Label
Assign Format	The type of value format this field should hold.	Label Paragraph Integer Decimal Boolean Single Select Multi Select Address Name Phone Email Date Time Date Entity Timezone Locale
Set DEV name	The name of the field in the JSON message format that corresponds with this field in BioT APIs.	N/A
Assign mandatory	Indicates whether the field is mandatory or not.	Flag
Assign PHI	Indicates whether the field carries personal health information.	Flag

Configuration Fields

The configuration fields tab allows you to define what configurations can be sent to the device and how they should be sent. The configuration tab does not contain built-in attributes and allows you to add any type of configuration options you choose. This is done in the same way you add other attributes to the device.

Configuration Tab (Adding Attributes)

Action	Description	Field Type
Add Name	The new name of the custom configuration field to be added.	Label
Assign Format	The type of value format this field should hold.	Label Paragraph Integer Decimal Boolean Single Select Multi Select Address Name Phone Email Date Time Date Entity Timezone Locale
Set DEV name	The name that corresponds with this field when interacting with BioT's APIs and sending JSON.	N/A
Assign mandatory	Indicates whether the field is mandatory or not.	Flag
Assign PHI	Indicates whether the field carries personal health information.	Flag

Usage Type Fields

The Usage Type tab allows you to define what types of usage the device should have and how frequently measurements should be sent to BioT. The Usage Types tab does not contain built-in attributes and allows you to add any type of usage type options you choose. This is done in the same way you add other attributes to the device.

Usage Type Tab (Adding Attributes)

Action	Description	Field Type
Add Name	The new name of the custom usage type field to be added.	Label
Assign Format	The type of value format this field should hold.	Label Paragraph Integer Decimal Boolean Single Select Multi Select Address Name Phone Email Date Time Date Entity Timezone Locale
Set DEV name	The name that corresponds with this field when interacting with BioT's APIs and sending JSON.	N/A
Assign mandatory	Indicates whether the field is mandatory or not.	Flag
Assign PHI	Indicates whether the field carries personal health information.	Flag

For more information on Device Templates, see Adding a Device Template.