Service: Datapoint

Reading, editing and operating Datapoints and getting their States

Functions

Result	Name / Params			Comment
GetResult	datapoint.Get			Returns a filtered list of Datapoint Objects.
		filter	string	(Optional) Filter expression which determines the result set.
		select	string[]	(Optional) List of properties that should be contained in the result objects.
		limit	int	(Optional) Maximum amount of Objects that should be returned.
GetResult	datapoint.Get			Returns a filtered list of Datapoint Objects as a follow up to a previous Get call.
		context	string	The context received within the last get result. Mandatory for subsequent get calls with pagination.
		scroll	int	Scrolls through the result set with 'Next' or 'Prev'. Used for pagination. See EnumPaginationScroll.
		offset	int	(Optional) Offset of the first Object in the result set that should be returned. Used for direct pagination.
		limit	int	(Optional) Maximum amount of Objects that should be returned.
guid	datapoint.Create			Creates the Datapoint in the system and returns the id of the Datapoint. The Datapoint must not have an id. If an id is set, the creation is rejected and an empty id is returned.
guid		object	Datapoint	The Datapoint to create.
bool	datapoint.Update			Updates a Datapoint with data from the provided Object.
bool		object	Datapoint	Datapoint to update
bool	datapoint.Set			Sets specific properties of a Datapoint Object.
		id	guid	Id of the Datapoint to modify.
		props	value{}	List of properties that should be set. Property paths may be used as ids to address any partial aspect of the Object.
bool	datapoint.Delete			Deletes a Datapoint Object. Returns true if successfully deleted or if no such Object existed to begin with.
		id	guid	Id of the Datapoint to delete.
		deleteDependents	bool	(Optional) If set to true descendant of the Object identified by 'id' will also be deleted. If the parameter is not set, the default value is false.
bool	datapoint.BulkModify			Performs a bulk of changes at once. The changes are applied transactionally, so if any of the individual changes fails, none of the changes are applied.
		create	Datapoint[]	(Optional) List of Datapoint Objects to create.
		update	Datapoint[]	(Optional) List of Datapoint Objects to update.
		set	ObjectAspect[]	(Optional) List of Datapoint Object properties to set.
		delete	guid[]	(Optional) List of Datapoint ids to delete.
		deleteDependents	bool	(Optional) If set to true descendant of the Object identified by 'id' will also be deleted. If the parameter is not set, the default value is false.
Datapoint	datapoint.GetOne			Returns a single Datapoint Object identified by the given id.
		id	guid	(Optional) The Datapoint's id.
		url	string	(Optional) A URL that identifies the Datapoint.
		type	string	(Optional) The Datapoint's type.
		category	string	(Optional) The Datapoint's category.
		name	string	(Optional) The Datapoint's name.
		select	string[]	(Optional) List of properties that should be contained in the result object.
guid[]	datapoint.GetChildrenIds			Returns a list of children Objects for a given id.
guid[]		id	guid	Id of the Datapoint to get the children ids for.
Command[]	datapoint.GetCommands			Retrieves a list of possible commands for an Object.
Command[]		id	guid	Id of the Datapoint to fetch the commands for.
bool	datapoint.ExecuteCommand			Executes a command.
		id	guid	Id of the Datapoint to execute the command for.
		commandId	string	Id of the command to execute.
		props	value{}	Command dependent parameters.

Notifications

Name / Params			Comment
datapoint.Created			Notifies about new Datapoint Objects.
	objects	Datapoint[]	Newly created Datapoint Objects.
datapoint.Updated			Notifies about updated Datapoint Objects.
	objects	Datapoint[]	Changed Datapoint Objects.
datapoint.Deleted			Notifies about deleted Datapoint Objects.
	ids	guid[]	Ids of the deleted Datapoint Objects.
datapoint.State			Notifies of State changes.
	states	DatapointState[]	Modified States.

Objects

Datapoint

Property	Type	Description
Id	guid	(Unique, Readonly) Unique Object id.
Code	string	(Unique) Code, used for references in graphics.
ParentId	guid	Parent Object id.
SegmentId	guid	Assigned segment.
HolderIds	guid[]	(Readonly) Additional parents where the Datapoint is displayed.
MemberIds	guid[]	Children of a group or metaobject Datapoint.
Type	int	See EnumDatapointType.
Category	string	Category code.
Name	string	(Localized) Datapoint’s name, might be a language resource id.
DisplayName	string	(Readonly, Localized) Computed Datapoint name.
Desc	string	Description, might be a resource string.
Tags	string	Tags enclosed in vertical bars (pipes), such as “\|tag1\|tag2\|tag3\|”.
LocationId	guid	Associated location id.
DeviceType	string	Device type code.
GeoPos	GeoPosition	Geographical coordinates.
Note	string	User note.
Link	Link	Url, type and Properties of the linked SST Object.
Props	value{}	Additional properties.
Text	string	(Not in default set) Text.
Graphics	string[#]	(Not in default set) Graphics.
TextMacros	string[#]	(Not in default set) Text macros.
Script	string	(Not in default set) Script.
Prios	PrioDef	(Not in default set) Priorities for Events.
CommandMappings	CommandMapping[]	(Not in default set) Command mappings.
AssociatedDatapoints	guid[]	(Not in default set) Associated Datapoints.
FunctionalitiesAdd	string[]	Functionalities that are explicitly added to the implicit Functionalities.
FunctionalitiesRemove	string[]	Functionalities that are explicitly removed from the implicit Functionalities.
UserAlarm	UserAlarm	(Not in default set) User alarm.
Filter	string	(Not in default set) Filter.
FilterEmptyText	string	(Not in default set) State text to use if the Datapoint’s filter isn’t matched.
AggregateStates	bool	(Not in default set) Indicates if the filter Datapoint’s States should be aggregated.
FilteredAggregatedStates	int[]	(Not in default set) List of aggregated Datapoint State types for filter Datapoints.
ResponsibleStation	int	(Not in default set) The number of the station which is responsible to evaluate the value mappings for a filter.
CamInfo	CamInfo	(Not in default set) Camera infos.
CamPresets	CamPreset[]	(Not in default set) Camera presets.
ValueInfo	ValueInfo	(Not in default set)
ValueMapping	ValueMapping[]	(Not in default set)
ValueTransformation	ValueTransformation	(Not in default set)
EffectiveParentId	guid	(Computed) Effective parent (assigned or computed).
EffectiveCategory	string	(Computed) Effective category code (assigned or inherited).
EffectiveDesc ≥wg 0.5.4	string	(Computed) Effective description (assigned or inherited).
EffectiveTags	string	(Computed) Effective list of tag (assigned or inherited), enclosed in vertical bars (pipes), such as “\|tag1\|tag2\|tag3\|”.
EffectiveLocationId	guid	(Computed) Associated location id (assigned or inherited).
EffectiveDeviceType	string	(Computed) Effective Device Type (with inheritance).
EffectiveText	string	(Computed) Effective text (with inheritance).
EffectiveScript ≥wg 0.5.0	string	(Computed) Effective script (with inheritance).
EffectiveGraphics	string[#]	(Computed) Effective graphics(with inheritance).
EffectiveTextMacros	string[#]	(Computed) Effective text macros (with inheritance).
EffectiveFunctionalities	string[]	(Readonly, Not in default set, Computed) Effective Functionalities.
EffectiveState	DatapointState	(Computed) Effective Datapoint State.
EffectiveIcon	string	(Computed) The icon depending on device type and category
EffectiveSensorNumber ≥wg 0.4.13	int	(Optional, Computed) Effective sensornumber, computed from link or element name
EffectiveValueInfos ≥wg 0.4.13	EffectiveValueInfos	(Optional, Computed) Effective threshold values for value Datapoints
EditTime	time	(Readonly, Not in default set)
EditUser	string	(Readonly, Not in default set)

DatapointState

Property	Type	Description
Id	guid	Datapoint id, this is only set inside notifications.
Flags	int	The current State of the Datapoint. The different States are flags in a short value See EnumStateFlags.
Text	string	Additional text information. Not all States have an additional text.
Value	float	Additional value information. Not all States have an additional value.
Time	time	Additional time information. Not all States have an additional value.
GeoPos	GeoPosition	Additional geographical coordinates. Not all States have a geo position.
Ptz	PtzInfo	(Optional) Additional information about pan angle, tilt angle and zoom value of a PTZ-capable camera. Not all States have a PTZ info.
COPs ≥wg 0.4.11	guid[]	Ids of control operations (COPs) that are currently active for this Datapoint.
COPFlags ≥wg 0.4.11	int	The Datapoint states (as flags) that were set by control operations. See EnumStateFlags.
Props	value{}	Additional properties.

PrioDef

Property	Type	Description
Alarm	int	Prio for Alarm Events.
Fault	int	Prio for Fault Events.
Message	int	Prio for Message Events.
PreAlarm	int	Prio for PreAlarm Events.
Warning	int	Prio for Warning Events.
Off	int	Prio for Off Events.
Revision	int	Prio for Revision Events.
Active	int	Prio for Active Events.

UserAlarm

Property	Type	Description
Type	int	Type of the Event to trigger. See EnumStateFlags.
Text	string	Event text to set.
Prio	int	Event priority to set upon creation.

CommandMapping

Property	Type	Description
SrcCommand	string	The original id of the command.
DstCommand	string	The id to map the command to.
DstDatapointId	guid	Target Datapoint id of the command.

ValueInfo

Property	Type	Description
Precision	int	Amount of floating point digits.
Unit	string	The value’s unit.
SaveHistory	bool	If true the value’s history will be logged.

ValueTransformation

Property	Type	Description
SrcFrom	float	Original ranges low point.
SrcTo	float	Original ranges high point.
DstFrom	float	Target ranges low point.
DstTo	float	Target ranges high point.

ValueMapping

Property	Type	Description
Value	string	The value.
RangeFrom	float	Range low point.
RangeTo	float	Range high point.
RangeDeadBand	float	Range’s dead band.
StateType	int	Only one logical value is set. See EnumStateFlags.
StateText	string
EventType	int	Only one logical value is set. See EnumStateFlags.
EventId	string
EventText	string
EventPrio	int

CamInfo

Property	Type	Description
NorthAngle	float	(DistinctNull)
FocalLength	float	(DistinctNull)
ViewAngle	float	(DistinctNull)

CamPreset

Property	Type	Description
Id	string	Internal Id, used as default display name.
Name	string	Optional display name.
LinkId	string	Id used by the SST to identify the preset.

GeoPosition

Property	Type	Description
Latitude	float	(DistinctNull)
Longitude	float	(DistinctNull)
Altitude	float	(DistinctNull)

PtzInfo

Property	Type	Description
PanAngle	int	(DistinctNull) Value should be in range [0, 359].
TiltAngle	int	(DistinctNull) Value should be in range [0, 90].
ZoomValue	float	(DistinctNull) Value should be >= 1.0

Link

Property	Type	Description
Url	string
Ext	string
ObjId	string
ObjType	string
Props	value{}

Command

Property	Type	Description
Id	string	The command’s unique id.
Name	string	(Localized) Localized name, can be displayed to the user.

EffectiveValueInfos

Property	Type	Description
ValueFrom	float	(Optional) lower border of value
ValueTo	float	(Optional) upper border of value
ValueMaxHigh	float	(Optional) upper value of value Datapoints
ValueMaxLow	float	(Optional) upper value - deadband of value Datapoints
ValueMinHigh	float	(Optional) lower value + deadband of value Datapoints
ValueMinLow	float	(Optional) lower value of value Datapoints

Enums

EnumDatapointType

Name	Value	Description
Group	1
Object	2
Member	3
Filter	4
UserAlarm	6
EventGroup	7
MetaObject ≥wg 0.1.0	8

EnumStateFlags (Flags)

Name	Value	Description
Alarm	0x1
Fault	0x2
Message	0x4
Warning	0x8
PreAlarm	0x10
RevAlarm	0x20
RevFault	0x40
RevMessage	0x80
Active	0x100
Disarmed	0x200
Locked	0x400
Off	0x800
Unknown	0x1000
Armed	0x2000
Revision	0x4000
Simulation	0x8000

EnumPaginationScroll

Name	Value	Description
Offset	0	Scrolls to fixed position.
Next	1	Scrolls to next items for given context.
Prev	2	Scrolls to previous items for given context.

Last modified September 25, 2026