VideoOS.Platform.ConfigurationItems.AlarmDefinition Class Reference

More...

Inheritance diagram for VideoOS.Platform.ConfigurationItems.AlarmDefinition:
VideoOS.Platform.ConfigurationItems.IConfigurationItem VideoOS.Platform.ConfigurationItems.IConfigurationChildItem

Public Member Functions

 AlarmDefinition (FQID fqid)
 Construct the class from a MIP FQID - note that not all configuration items have a corresponding FQID.
 
 AlarmDefinition (ServerId serverId, ConfigurationItem alarmDefinition)
 Construct the class from serverId of the Management Server that owns the configuration, and the already returned ConfigurationItem.
 
 AlarmDefinition (ServerId serverId, string path)
 Construct the class from serverId of the Management Server that owns the configuration, and the path of the item.
 
- Public Member Functions inherited from VideoOS.Platform.ConfigurationItems.IConfigurationItem
void ClearChildrenCache ()
 Clear the internal cache of children. Can be used to force a new set of children to be fetched from the server at next access.
 
ServerTask ExecuteMethod (string methodId)
 Execute the provided method. The method id must be one of the defined values in the Methods property.
 
void FillChildren (string[] itemTypes)
 Fill all children and grand-children - as long as the itemtype is contained in itemType parameter.
 
void FillChildren (string[] itemTypes, ItemFilter[] itemFilters)
 Fill all children and grand-children - as long as the itemtype is contained in itemType parameter and filters match. If multiple filters are defined for same itemtype, all must match for the item to be included ('and' operation).
If no filter is defined for an ItemType, then all items of that type is filled.
 
void Save ()
 Will save all updated values to server.
 
ValidateResult ValidateItem ()
 Validate the current content.
 
- Public Member Functions inherited from VideoOS.Platform.ConfigurationItems.IConfigurationChildItem
string GetProperty (string key)
 Return a property value as string, if key is not found the return value will be null.
 
ICollection< string > GetPropertyKeys ()
 Get a collection of all available property keys.
 
List< ValueTypeInfoGetValueTypeInfoList (string propertyKey)
 Get defined ValueTypeInfo for a given property. If no ValueTypeInfo is available, an empty list is returned.
 
void SetProperty (string key, string content)
 Sets the value of a property (all is string format here)
 
override string ToString ()
 Display the 'DisplayName' is the default ToString()
 

Properties

bool AssignableToAdmins [get, set]
 Alarm assignable to Administrators. Select this to include users with an administrator role in the Assigned to list.
 
bool AutoClose [get, set]
 Auto-close alarm: . Defines if an alarm should be closed automatically upon reception of a specific message from save source.
 
String Category [get, set]
 Alarm category. Sets the category of the alarm. Valid options are defined in the Management Client.. Valid values are available in the CategoryValues property dictionary.
 
Dictionary< string, string > CategoryValues [get]
 A list of valid names/values for the Category property.
 
String DisableEventList [get, set]
 Disabling events. When enable rule is 'by events', then this property contains the events that will disable the alarm.
 
bool Enabled [get, set]
 Indicate if this item is active in the VMS system, e.g. enabled.
 
String EnableEventList [get, set]
 Enabling events. When enable rule is 'by events', then this property contains the events that will enable the alarm (but does not create any alarm).
 
String EnableRule [get, set]
 Enable rule. Defines when the alarm can be triggered. Options are: Always, by TimeProfile or by events. When TimeProfile is defined the TimeProfile property must contain a valid TimeProfile path, when enabled by events then both EnablingEvents and DisablingEvents must be defined.. Valid values are available in the EnableRuleValues property dictionary.
 
Dictionary< string, string > EnableRuleValues [get]
 A list of valid names/values for the EnableRule property.
 
String EventType [get, set]
 Triggering event type. Defines the type of event that should trigger an alarm, when received from the source defined.. Valid values are available in the EventTypeValues property dictionary.
 
String EventTypeGroup [get, set]
 Triggering event group. Defines a group of events in the same area. Valid values are available in the EventTypeGroupValues property dictionary.
 
Dictionary< string, string > EventTypeGroupValues [get]
 A list of valid names/values for the EventTypeGroup property.
 
Dictionary< string, string > EventTypeValues [get]
 A list of valid names/values for the EventType property.
 
string Id [get]
 ID.
 
String ManagementTimeoutEventList [get, set]
 Operator timeout events triggered. If operator action is required within a specific time, this property defines what event to fire if no action was taken within the time specified in the ManagementTimeoutTime property.
 
string ManagementTimeoutTime [get, set]
 Operator action time limit. If operator action is required within a specific time, the time is defined here. Format is like: HH:mm.ss. Valid values are the same as defined in the Management Client, e.g. 1 minute, 5 minutes etc. Default is 1 minute.
 
String MapType [get, set]
 Alarm manager view. Valid values are available in the MapTypeValues property dictionary.
 
Dictionary< string, string > MapTypeValues [get]
 A list of valid names/values for the MapType property.
 
string Owner [get, set]
 Owner. Defines the initial owner. Should be formatted as Identity.ToString() does, like 'John Doe (Acme/JD)'.
 
String Priority [get, set]
 Priority. Sets the priority. Can be High, Medium, Low. Valid values are available in the PriorityValues property dictionary.
 
Dictionary< string, string > PriorityValues [get]
 A list of valid names/values for the Priority property.
 
String RelatedCameraList [get, set]
 Related cameras. The list of additional cameras to associate with the alarm. The list is a comma separated set of Paths.
 
String RelatedMap [get, set]
 Related map. Defines what map to show in the alarm manager, when alarm is selected.. Valid values are available in the RelatedMapValues property dictionary.
 
Dictionary< string, string > RelatedMapValues [get]
 A list of valid names/values for the RelatedMap property.
 
bool RequireCommentOnClose [get, set]
 Require comment on close. Specifies whether a comment must be given when closing an alarm.
 
bool RequireReasonOnClose [get, set]
 Require reason on close. Specifies whether a reason must be given when closing an alarm.
 
String SourceList [get, set]
 Sources. Defines the source(s) the event is coming from. To define that all sources of a given type will trigger the alarm, use the folder format like: '/CameraFolder'.
 
String TimeProfile [get, set]
 Time profile. Defines what TimeProfile to be used when checking when the alarm is enabled. Property is only valid when EnableRule is set to TimeProfile.
 
String TriggerEventlist [get, set]
 Events triggered by alarm. Defines a list of events to trigger when alarm is created. List is a comma separated set of Paths.
 
- Properties inherited from VideoOS.Platform.ConfigurationItems.IConfigurationItem
Guid Guid [get]
 Returns the id property or part of the path, when available. When no id is available this will be Guid.Empty. This is relevant for some items of ItemCategory.ChildItem where no property with key = "Id" exists and path does not contains a guid.
 
Collection< string > Methods [get]
 The available methods for this class.
 
- Properties inherited from VideoOS.Platform.ConfigurationItems.IConfigurationChildItem
string Description [get, set]
 Description.
 
virtual string DisplayName [get]
 Name of this ConfigurationItem in user readable format. Usually the same as property with key = "Name".
 
string ItemCategory [get]
 Return the item category for this item. This can be used to understand how multiple items are fetched and saved together. Only ItemCategory == 'Item' can be saved.
 
string Name [get, set]
 Name.
 
string ParentItemPath [get]
 Get hold of the next real parent path, e.g. skip any 'Folder' type parent.
 
string ParentPath [get]
 The path for the parent of this ConfigurationItem.
 
string Path [get]
 The identification of this item.

 
ServerId ServerId [get, set]
 Contains the ServerId of the Management Server holding this item.
 

Detailed Description

Constructor & Destructor Documentation

◆ AlarmDefinition() [1/3]

VideoOS.Platform.ConfigurationItems.AlarmDefinition.AlarmDefinition ( ServerId serverId,
ConfigurationItem alarmDefinition )
inline

Construct the class from serverId of the Management Server that owns the configuration, and the already returned ConfigurationItem.

Parameters
serverIdIdentify the Management Server that owns the configuration
alarmDefinitionThe ConfigurationItem returned from elsewhere
Exceptions
ArgumentMIPExceptionWhen LoginSettings not found for serverId

◆ AlarmDefinition() [2/3]

VideoOS.Platform.ConfigurationItems.AlarmDefinition.AlarmDefinition ( ServerId serverId,
string path )
inline

Construct the class from serverId of the Management Server that owns the configuration, and the path of the item.

This construction will contact the server and read the specified item.

Parameters
serverIdIdentify the Management Server that owns the configuration
pathThe path of a specific item
Exceptions
MIPExceptionRepresents a number of possible exceptions. Possible exceptions can be found via the inherited exceptions - like PathNotFoundMIPException

◆ AlarmDefinition() [3/3]

VideoOS.Platform.ConfigurationItems.AlarmDefinition.AlarmDefinition ( FQID fqid)
inline

Construct the class from a MIP FQID - note that not all configuration items have a corresponding FQID.

This construction will contact the server and read the specified item.

Parameters
fqidIdentify the MIP item
Exceptions
MIPExceptionRepresents a number of possible exceptions. Possible exceptions can be found via the inherited exceptions - like PathNotFoundMIPException

Property Documentation

◆ AssignableToAdmins

bool VideoOS.Platform.ConfigurationItems.AlarmDefinition.AssignableToAdmins
getset

Alarm assignable to Administrators. Select this to include users with an administrator role in the Assigned to list.

◆ AutoClose

bool VideoOS.Platform.ConfigurationItems.AlarmDefinition.AutoClose
getset

Auto-close alarm: . Defines if an alarm should be closed automatically upon reception of a specific message from save source.

◆ Category

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.Category
getset

Alarm category. Sets the category of the alarm. Valid options are defined in the Management Client.. Valid values are available in the CategoryValues property dictionary.

◆ CategoryValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.CategoryValues
get

A list of valid names/values for the Category property.

◆ DisableEventList

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.DisableEventList
getset

Disabling events. When enable rule is 'by events', then this property contains the events that will disable the alarm.

◆ Enabled

bool VideoOS.Platform.ConfigurationItems.AlarmDefinition.Enabled
getset

Indicate if this item is active in the VMS system, e.g. enabled.

◆ EnableEventList

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.EnableEventList
getset

Enabling events. When enable rule is 'by events', then this property contains the events that will enable the alarm (but does not create any alarm).

◆ EnableRule

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.EnableRule
getset

Enable rule. Defines when the alarm can be triggered. Options are: Always, by TimeProfile or by events. When TimeProfile is defined the TimeProfile property must contain a valid TimeProfile path, when enabled by events then both EnablingEvents and DisablingEvents must be defined.. Valid values are available in the EnableRuleValues property dictionary.

◆ EnableRuleValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.EnableRuleValues
get

A list of valid names/values for the EnableRule property.

◆ EventType

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.EventType
getset

Triggering event type. Defines the type of event that should trigger an alarm, when received from the source defined.. Valid values are available in the EventTypeValues property dictionary.

◆ EventTypeGroup

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.EventTypeGroup
getset

Triggering event group. Defines a group of events in the same area. Valid values are available in the EventTypeGroupValues property dictionary.

◆ EventTypeGroupValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.EventTypeGroupValues
get

A list of valid names/values for the EventTypeGroup property.

◆ EventTypeValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.EventTypeValues
get

A list of valid names/values for the EventType property.

◆ Id

string VideoOS.Platform.ConfigurationItems.AlarmDefinition.Id
get

ID.

◆ ManagementTimeoutEventList

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.ManagementTimeoutEventList
getset

Operator timeout events triggered. If operator action is required within a specific time, this property defines what event to fire if no action was taken within the time specified in the ManagementTimeoutTime property.

◆ ManagementTimeoutTime

string VideoOS.Platform.ConfigurationItems.AlarmDefinition.ManagementTimeoutTime
getset

Operator action time limit. If operator action is required within a specific time, the time is defined here. Format is like: HH:mm.ss. Valid values are the same as defined in the Management Client, e.g. 1 minute, 5 minutes etc. Default is 1 minute.

◆ MapType

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.MapType
getset

Alarm manager view. Valid values are available in the MapTypeValues property dictionary.

◆ MapTypeValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.MapTypeValues
get

A list of valid names/values for the MapType property.

◆ Owner

string VideoOS.Platform.ConfigurationItems.AlarmDefinition.Owner
getset

Owner. Defines the initial owner. Should be formatted as Identity.ToString() does, like 'John Doe (Acme/JD)'.

◆ Priority

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.Priority
getset

Priority. Sets the priority. Can be High, Medium, Low. Valid values are available in the PriorityValues property dictionary.

◆ PriorityValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.PriorityValues
get

A list of valid names/values for the Priority property.

◆ RelatedCameraList

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.RelatedCameraList
getset

Related cameras. The list of additional cameras to associate with the alarm. The list is a comma separated set of Paths.

◆ RelatedMap

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.RelatedMap
getset

Related map. Defines what map to show in the alarm manager, when alarm is selected.. Valid values are available in the RelatedMapValues property dictionary.

◆ RelatedMapValues

Dictionary<string, string> VideoOS.Platform.ConfigurationItems.AlarmDefinition.RelatedMapValues
get

A list of valid names/values for the RelatedMap property.

◆ RequireCommentOnClose

bool VideoOS.Platform.ConfigurationItems.AlarmDefinition.RequireCommentOnClose
getset

Require comment on close. Specifies whether a comment must be given when closing an alarm.

◆ RequireReasonOnClose

bool VideoOS.Platform.ConfigurationItems.AlarmDefinition.RequireReasonOnClose
getset

Require reason on close. Specifies whether a reason must be given when closing an alarm.

◆ SourceList

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.SourceList
getset

Sources. Defines the source(s) the event is coming from. To define that all sources of a given type will trigger the alarm, use the folder format like: '/CameraFolder'.

◆ TimeProfile

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.TimeProfile
getset

Time profile. Defines what TimeProfile to be used when checking when the alarm is enabled. Property is only valid when EnableRule is set to TimeProfile.

◆ TriggerEventlist

String VideoOS.Platform.ConfigurationItems.AlarmDefinition.TriggerEventlist
getset

Events triggered by alarm. Defines a list of events to trigger when alarm is created. List is a comma separated set of Paths.