Global

Type Definitions

HistoricItem

Source:
Properties:
Name Type Description
state string

Item state
rawState HostState

Raw Java state
numericState number | null

Numeric representation of Item state, or null if state is not numeric
quantityState Quantity | null

Item state as Quantity or null if state is not Quantity-compatible
timestamp time.ZonedDateTime

timestamp of historic item
Type:
  • object

ItemConfig

Source:
Properties:
Name Type Attributes Description
type string

the type of the Item
name string

Item name for the Item to create
label string <optional>

the label for the Item
category string <optional>

the category (icon) for the Item
groups Array.<string> <optional>

an array of groups the Item is a member of
tags Array.<string> <optional>

an array of tags for the Item
channels string | Object <optional>

for single channel link a string or for multiple an object { channeluid: configuration }; configuration is an object
metadata * <optional>

either object { namespace: value } or { namespace: ItemMetadata }
giBaseType string <optional>

the group Item base type for the Item
groupFunction HostGroupFunction <optional>

the group function used by the Item

configuration describing an Item

Type:
  • object

ItemMetadata

Source:
Properties:
Name Type Description
configuration object

metadata namespace's configuration
value string

metadata namespace's value

a single metadata namespace of an Item

Type:
  • object

EventObject

Source:
Properties:
Name Type Description
oldState string

only for triggers.ItemStateChangeTrigger & triggers.GroupStateChangeTrigger: Previous state of Item or Group that triggered event
newState string

only for triggers.ItemStateChangeTrigger & triggers.GroupStateChangeTrigger: New state of Item or Group that triggered event
receivedState string

only for triggers.ItemStateUpdateTrigger & triggers.GroupStateUpdateTrigger: State that triggered event
receivedCommand string

only for triggers.ItemCommandTrigger, triggers.GroupCommandTrigger, triggers.PWMTrigger & triggers.PIDTrigger : Command that triggered event
itemName string

for all triggers except triggers.PWMTrigger: name of Item that triggered event
receivedEvent string

only for triggers.ChannelEventTrigger: Channel event that triggered event
channelUID string

only for triggers.ChannelEventTrigger: UID of channel that triggered event
oldStatus string

only for triggers.ThingStatusChangeTrigger: Previous state of Thing that triggered event
newStatus string

only for triggers.ThingStatusChangeTrigger: New state of Thing that triggered event
status string

only for triggers.ThingStatusUpdateTrigger: State of Thing that triggered event
eventType string

for all triggers except triggers.PWMTrigger, triggers.PIDTrigger, time triggers: Type of event that triggered event (change, command, time, triggered, update)
triggerType string

for all triggers except triggers.PWMTrigger, triggers.PIDTrigger, time triggers: Type of trigger that triggered event (for TimeOfDayTrigger: GenericCronTrigger)
payload *

for most triggers

When a rule is triggered, the script is provided the event instance that triggered it. The specific data depends on the event type. The EventObject provides several information about that trigger.

Note: Group****Triggers use the equivalent Item****Trigger as trigger for each member. Time triggers do not provide any event instance, therefore no property is populated.

Type:
  • object

RuleCallback(event)

Source:
Parameters:
Name Type Description
event EventObject

RuleConfig

Source:
Properties:
Name Type Attributes Default Description
name string

name of the rule (used in UI)
description string <optional>

description of the rule (used in UI)
triggers HostTrigger | Array.<HostTrigger>

which will fire the rule
execute RuleCallback

callback to run when the rule fires
id string <optional>

UID of the rule, if not provided, one is generated
tags Array.<string> <optional>

tags for the rule (used in UI)
ruleGroup string <optional>

name of rule group to use
overwrite boolean <optional>
 false

whether to overwrite an existing rule with the same UID

configuration for rules.JSRule

Type:
  • object