Anatomy of a Space CE Template

Introduction

Within SpaceCE, a system template is a base configuration that forms the blueprint of a room. Unlike SpaceVC, SpaceCE system templates can be updated without affecting the rooms created from them.

For the SpaceCE Room overview, click here.

For help navigating the Templates page, click here.

For more information on the differences between templates and rooms with each Innomesh product, click here.

Configuration Options for a SpaceCE Template

You may access Space CE Template by selecting it via the pop up window as shown below:

The configuration options available for your SpaceCE system template are dependent on the SpaceVC software you are using. However, all SpaceCE software share the below configuration options:

  • Properties
  • Devices
  • Macros
  • Room Options

The below section provides an overview of each of these configuration options.

Properties

The configuration options under “Properties” are general information related to a system template.

The following fields are available in this section:

System Name

The name of the system type represented by this system template configuration.

System Repository Name

This is auto-populated based on the System Name. This is the global identifier of the system template.

System Description

A description of the system type represented by this system template configuration.

Template Version

The version number of this template, to track changes over time. The version number must be in the format ‘major.minor.revision’. E.g. 1.0.0.

When system templates are updated, Innomesh offers the option to auto-increment this version.

System Type

The type of system this template configuration represents. This can be any of the following:

  • General
  • Boardroom
  • Breakout Area
  • Collaboration Space
  • Conference Room
  • Control Room
  • Exhibition Hall
  • Foyer
  • Huddle Space
  • Laboratory
  • Lecture Theatre
  • Meeting Room
  • Office
  • Signage
  • Simulation Room
  • Stadium
  • Teaching Space
  • Tutorial Room.

System Author

The author of this system template configuration. This is automatically populated with the name of the user creating the system template.

Is Portable

This marks rooms created with this system template as “portable”, i.e. it is expected that this room will not always be online as part of its normal operation. Marking a room as “portable” results in all alerts for the room automatically diverting to the “Suppressed Alerts” tab on the Portal Hotlist.

For more information, please refer to this link.

An example of a “portable” room is a mobile trolleys that may be disconnected and stowed away.

Devices

Main View

In the main device view we can see 5 primary sections.

A. Control

Devices are separated into 2 categories, selectable on the centre column:

  • IP – these are devices that are controlled over the network
  • Gateway – these are devices that are controlled via another device, and may be abstract. E.g. a lighting fader.

Pulse (Monitoring) can be included in this template.

B. Device Fields

Fields which describe the key properties of a device, such as the device name, the name of the driver used to control the device, the device IP address, etc.

Depending on the type of device being created, these fields will be different.

C. Duplicate, Edit and Delete

These allow a device to be duplicated, edited and deleted.

The “Edit” button takes users to a detailed view of the device, allowing for further customisation of the device if required.

D. Download as CSV File

This button download the list of devices in this category as a CSV file.

E. Add New Device

This button allows the user to add a new device of the selected category.

“Add New Device” View

When adding a new device, the following fields are presented.

A. Is Portable, PDU Connected & Disable

Is Portable

If checked, alerts from this device will be diverted to the “Suppressed” alerts list on the Innomesh Portal Hotlist. This featured can be used if the device is portable and is not always connected i.e. a display on a removable trolley.

PDU Connected

This denotes that the device is connected to a power distribution unit (PDU), and only turns on while the room is powered on. If checked, alerts from this device be diverted to the “Suppressed” alerts list on the Innomesh Portal Hotlist while the room is powered off.

Disable

If this button is checked, the device will be disabled from the configuration.

B. Standard Fields

These are fields which describe the key components of a device.

Depending on the type of device being created, these fields will be different. Fields that are common to all types of device are:

  • Type
  • Driver
  • Name
  • ID
  • Model

This will be discussed in greater detail below.

C. Advanced Connection Settings

This is an expandable menu which shows advanced connection settings relevant for this device type. It is hidden by default.

D. Cancel

This discards all changes made to this device configuration and returns you to the Device main page.

E. Add Device

Once all of the required fields are input, this adds the device to the template configuration.

Common Elements to all Device Types

Each device type has different fields which the user must fill out.

ID

The unique identifier for the device. This is automatically populated depending on the device type selected.

Name

The friendly name for the device.

Driver

The driver which SpaceCE uses to connect to and control the device.

IP Devices
  • Type – The device type. E.g. Camera or Projector.
  • Driver – The driver which SpaceCE uses to control the device.
  • Name – The ‘friendly name’ for the device.
  • ID – The auto-generated unique identifier for the device. For e.g. dev.display.1.
  • Model – The Model of the device.
Advanced Settings
  • IP Port – The IP port for connecting to the device, if different from the device default.
  • Username – The username required (if any) to connect to the device.
  • Password – The password required (if any) to connect to the device.
Gateway Devices
  • Type – The device type. E.g. Audio Fader.
  • Driver – The driver which SpaceCE uses to connect to and control the device.
  • Name – The ‘friendly name’ for the device.
  • ID – The auto-generated unique identifier for the device. For e.g. dev.display.1.
  • Gateway Device ID – The ID of the device through which this device communicates.

Macros

This section contains the definitions for macros.

Macros are custom actions, definable as a script, that are set off by a “trigger”. Triggers can either be based on an event (e.g. when the system powers on), or on a time, and optionally, on particularly days of the week.

The definition for macros consists of the following elements:

ID

The unique identifier for the macro. It is recommended that this be defined in the following format: macro.trigger.[device].operation. For e.g. macro.poweron.1.

Disable

If set to true, this macro is ignored in the configuration.

Name

The friendly name for the device.

Triggers / Time Triggers

This array element defines the one or more time-based triggers that set this macro. The array consists of the following elements:

ID
The unique identifier for this trigger.

Disable
If set to true, this trigger is ignored in the configuration.

Time
The 24-hour time, in the format HH:mm:ss, at which the macro is to trigger. This is relevant for “Time” triggers only.

Days
A comma separated list of days of the week on which the macro is to trigger. Also This is relevant for “Time” triggers only.

Example values are:
“Monday, Tuesday, Thursday”. 
“Weekday” (Monday to Friday) 
“Weekend” (Saturday or Sunday)

Triggers / Event Triggers

This array element defines the one or more event-based triggers that set this macro. The array consists of the following elements:

ID
The unique identifier for this trigger.
Disable
If set to true, this trigger is ignored in the configuration.
Guid
The GUID of the object generating the event. Relevant for Event trigger types only.
Property
The object property this event relates to. Relevant for Event trigger types only.
Key
For Dictionary object properties, the key by which the property value is accessed. Relevant for Event trigger types only.
Index
For List object properties, the index by which the property value is accessed. Relevant for Event trigger types only.
Value
The property value which, if matched, triggers this macro. Relevant for Event trigger types only.

Actions

This array element defines the one or more actions that are set off when the trigger conditions are met. The array consists of the following elements:

ID
The unique identifier for this action.

Disable
If set to true, this trigger is ignored in the configuration.

Script
The script that defines the action.

Device ID
This is required when the device keyword is used within the lambda script, to specify the ID of the device it is to refer to. Device IDs are defined under #/Devices/IP/ID.

Delay
The delay, in seconds, between the macro trigger occurring, and the macro action being executed.

Room Options

“Room Options” is where you define the things from the list that you would like to manage at the room level. You can do that by checking items from the list. When managing the rooms users will only be able to see what you select here.

For more options about user permissions, please see this article here.

If you are intending to have external contractors deploy rooms using Innomesh Room Manager, assuming they do not have Administrator access, this is where you can define what the contractors can and cannot modify when deploying rooms. This allows you to enforce standards.

Related Articles