WCF Alarms Service Documentation

Abstract

The WCF Alarms web service handles all the alarm related operations. This article provides a list of all available methods.

This WCF web service handles all the alarm related operations. The following methods are available:

UpdateAlarmGeneralComment

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`UpdateAlarmGeneralComment(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmID, string comment, int millisecondsTimeOut);`
Description	Updates the text of the alarm's general comment
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmID` (guid) - the unique id of the alarm `comment` (string) - the updated text of the general comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

UpdateOnlineAlarmsOccurrenceComment

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`UpdateOnlineAlarmsOccurrenceComment(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmLogID, string comment, int millisecondsTimeOut);`
Description	Updates the text of the online alarm's occurrence comment
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmLogID` (guid) - the unique id of the alarm log `comment` (string) - the updated text of the occurrence comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

GetOnlineAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetOnlineAlarms(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmFilterDTO filter, int millisecondsTimeOut);`
Description	Retrieves the online alarms based on the provided parameters
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `filter` (AlarmFilterDTO) - the alarm filter data transfer object that contains: `LanguageID` (int) - the id of the language for which the translations are applied `TimeZoneID` (string) - the id of the time zone for which the alarms are retrieved `AlarmGroups` (ICollection<string>) - the collection of alarm groups for which the alarms to be retrieved `AlarmTypes` (ICollection<string>) - the collection of alarm types for which the alarms to be retrieved `MinimumPriority` (int) - the lowest priority for which the alarms to be retrieved `MaximumPriority` (int) - the highest priority for which the alarms to be retrieved `SortOrder` (ServerSortOrder) - the object defining the server side sort order of the alarms, containing the following members: `DateDescending` `PriorityDescending` `MaxRowCount` (int) - the maximum number of alarms to be retrieved `AlarmStatusFilter` (AlarmStatusFilter) - the object defining the status filters, containing the following members: `All` `Gone` `Active` `NotAcknowledged` `ActiveOrNotAcknowledged` `StartTime` (DateTimeOffset) - the time of the alarms `EndTime` (DateTimeOffset) - the end time of the alarms `Column` (enum FilterColumnType) - the object defining the columns to be retrieved for the alarms, containing the following members: `None` `Text` `SignalName` `OpcItem` `Name` `HttpLink` `HelpCause` `HelpEffect` `HelpRepair` `GeneralComment` `OccurrenceComment` `AcknowledgeComment` `NavigationSource` `NavigationTarget` `ExtendedProperty1` to `ExtendedProperty32` `ColumnFilters` (string[]) - the list of filters for alarm columns `FilterAlarmGroupByUser` (bool) - if true, only the alarms in the alarm groups to which the user has access will be retrieved `UserName` (string) - the user name used for filtering alarm groups by user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms will be retrieved) `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	An `AlarmsDTO` containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved (by specifying the StartIndex and ItemCount) `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms were be retrieved)

GetOnlineAlarmsByToken

Syntax	`GetOnlineAlarmsByToken(string securityToken, AlarmFilterDTO filter, int millisecondsTimeOut);`
Description	Retrieves the online alarms based on the provided security token and filter
Parameters	`securityToken` (string) - the security token returned by the `Login()` method `filter` (AlarmFilterDTO) - the alarm filter data transfer object that contains: `LanguageID` (int) - the id of the language for which the translations are applied `TimeZoneID` (string) - the id of the time zone for which the alarms are retrieved `AlarmGroups` (ICollection<string>) - the collection of alarm groups for which the alarms to be retrieved `AlarmTypes` (ICollection<string>) - the collection of alarm types for which the alarms to be retrieved `MinimumPriority` (int) - the lowest priority for which the alarms to be retrieved `MaximumPriority` (int) - the highest priority for which the alarms to be retrieved `SortOrder` (ServerSortOrder) - the object defining the server side sort order of the alarms, containing the following members: `DateDescending` `PriorityDescending` `MaxRowCount` (int) - the maximum number of alarms to be retrieved `AlarmStatusFilter` (AlarmStatusFilter) - the object defining the status filters, containing the following members: `All` `Gone` `Active` `NotAcknowledged` `ActiveOrNotAcknowledged` `StartTime` (DateTimeOffset) - the time of the alarms `EndTime` (DateTimeOffset) - the end time of the alarms `Column` (enum FilterColumnType) - the object defining the columns to be retrieved for the alarms, containing the following members: `None` `Text` `SignalName` `OpcItem` `Name` `HttpLink` `HelpCause` `HelpEffect` `HelpRepair` `GeneralComment` `OccurrenceComment` `AcknowledgeComment` `NavigationSource` `NavigationTarget` `ExtendedProperty1` to `ExtendedProperty32` `ColumnFilters` (string[]) - the list of filters for alarm columns `FilterAlarmGroupByUser` (bool) - if true, only the alarms in the alarm groups to which the user has access will be retrieved `UserName` (string) - the user name used for filtering alarm groups by user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms will be retrieved) `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	An `AlarmsDTO` containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved (by specifying the StartIndex and ItemCount) `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms were be retrieved)

GetOfflineAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetOfflineAlarms(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmFilterDTO filter, int millisecondsTimeOut);`
Description	Retrieves the offline alarms based on the provided parameters
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `filter` (AlarmFilterDTO) - the alarm filter data transfer object that contains: `LanguageID` (int) - the id of the language for which the translations are applied `TimeZoneID` (string) - the id of the time zone for which the alarms are retrieved `AlarmGroups` (ICollection<string>) - the collection of alarm groups for which the alarms to be retrieved `AlarmTypes` (ICollection<string>) - the collection of alarm types for which the alarms to be retrieved `MinimumPriority` (int) - the lowest priority for which the alarms to be retrieved `MaximumPriority` (int) - the highest priority for which the alarms to be retrieved `SortOrder` (ServerSortOrder) - the object defining the server side sort order of the alarms, containing the following members: `DateDescending` `PriorityDescending` `MaxRowCount` (int) - the maximum number of alarms to be retrieved `AlarmStatusFilter` (AlarmStatusFilter) - the object defining the status filters, containing the following members: `All` `Gone` `Active` `NotAcknowledged` `ActiveOrNotAcknowledged` `StartTime` (DateTimeOffset) - the time of the alarms `EndTime` (DateTimeOffset) - the end time of the alarms `Column` (enum FilterColumnType) - the object defining the columns to be retrieved for the alarms, containing the following members: `None` `Text` `SignalName` `OpcItem` `Name` `HttpLink` `HelpCause` `HelpEffect` `HelpRepair` `GeneralComment` `OccurrenceComment` `AcknowledgeComment` `NavigationSource` `NavigationTarget` `ExtendedProperty1` to `ExtendedProperty32` `ColumnFilters` (string[]) - the list of filters for alarm columns `FilterAlarmGroupByUser` (bool) - if true, only the alarms in the alarm groups to which the user has access will be retrieved `UserName` (string) - the user name used for filtering alarm groups by user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms will be retrieved) `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	An `AlarmsDTO` containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved (by specifying the StartIndex and ItemCount) `IdentityNumber` (long) - the index number of the last offline alarm at the point of the first request `RowNumber` (long) - the index number from which the alarms were be retrieved

GetOfflineAlarmsByToken

Syntax	`GetOfflineAlarmsByToken(string securityToken, AlarmFilterDTO filter, int millisecondsTimeOut);`
Description	Retrieves the offline alarms based on the provided security token and filter
Parameters	`securityToken` (string) - the security token returned by the `Login()` method `filter` (AlarmFilterDTO) - the alarm filter data transfer object that contains: `LanguageID` (int) - the id of the language for which the translations are applied `TimeZoneID` (string) - the id of the time zone for which the alarms are retrieved `AlarmGroups` (ICollection<string>) - the collection of alarm groups for which the alarms to be retrieved `AlarmTypes` (ICollection<string>) - the collection of alarm types for which the alarms to be retrieved `MinimumPriority` (int) - the lowest priority for which the alarms to be retrieved `MaximumPriority` (int) - the highest priority for which the alarms to be retrieved `SortOrder` (ServerSortOrder) - the object defining the server side sort order of the alarms, containing the following members: `DateDescending` `PriorityDescending` `MaxRowCount` (int) - the maximum number of alarms to be retrieved `AlarmStatusFilter` (AlarmStatusFilter) - the object defining the status filters, containing the following members: `All` `Gone` `Active` `NotAcknowledged` `ActiveOrNotAcknowledged` `StartTime` (DateTimeOffset) - the time of the alarms `EndTime` (DateTimeOffset) - the end time of the alarms `Column` (enum FilterColumnType) - the object defining the columns to be retrieved for the alarms, containing the following members: `None` `Text` `SignalName` `OpcItem` `Name` `HttpLink` `HelpCause` `HelpEffect` `HelpRepair` `GeneralComment` `OccurrenceComment` `AcknowledgeComment` `NavigationSource` `NavigationTarget` `ExtendedProperty1` to `ExtendedProperty32` `ColumnFilters` (string[]) - the list of filters for alarm columns `FilterAlarmGroupByUser` (bool) - if true, only the alarms in the alarm groups to which the user has access will be retrieved `UserName` (string) - the user name used for filtering alarm groups by user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms will be retrieved) `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	An `AlarmsDTO` containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved (by specifying the StartIndex and ItemCount) `IdentityNumber` (long) - ignored here, only used for offline alarms (the index number of the last offline alarm at the point of the first request) `RowNumber` (long) - ignored here, only used for offline alarms (the index number from which the alarms were be retrieved)

GetExtendedAlarmProperties

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetExtendedAlarmProperties(string sessionId, string clientId, string userName, bool IsDomainUser, int millisecondsTimeOut);`
Description	Returns a list of extended alarm properties
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of `ExtendedAlarmPropertyDTO` objects, each containing: `Index` (int) - the index of the extended alarm property `IsActive` (bool) - the status of the extended alarm property `DataType` (ExtendedAlarmDataType) - the object defining the data type of the extended alarm property. It's members are: `String` `Integer` `Double` `SymbolicTextName` (string) - the symbolic name (language independent) of the extended alarm property

GetAlarmsWithChangedProcessingAndDisplayState

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAlarmsWithChangedProcessingAndDisplayState(string sessionId, string clientId, string userName, bool IsDomainUser, int languageID, int millisecondsTimeOut);`
Description	Retrieves a list of alarms that have a modified processing and visibility state
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `languageID` (int) - the id of the language in which to retrieve the alarms `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of `AlarmProcessingAndDisplayDTO` objects, containing: `AlarmID` (guid) - the unique id of the alarm `AlarmTag` (string) - the alarm tag `AlarmSymbolicTextTranslation` (string) - the translation of the alarm text `SignalName` (string) - the name of the signal which triggers the alarm `OPCItemName` (string) - the OPC name of the signal that triggers the alarm `State` (AlarmProcessingAndDisplayState) - the object defining the processing and display state of the alarm, with the following members: `NotProcessedButVisible` `ProcessedAndVisible` `NotProcessedAndNotVisible` `ProcessedButNotVisible`

GetAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAlarms(string sessionId, string clientId, string userName, bool IsDomainUser, IEnumerable<Guid> alarmsID, int languageID, string timeZoneID, int millisecondsTimeOut, bool shouldResolvePlaceholders = true);`
Description	Retrieves a list of alarms based on the given parameters
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmsID` (IEnumerable<Guid>) - the list of unique ids of the alarms to be retrieved `languageID` (int) - the id of the language in which to retrieve the alarms `timeZoneID` (string) - the id of the timezone in which to retrieve the alarm `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated. `shouldResolvePlaceholders` (bool) - if true, the replacement values placeholders will return resolved
Return Value	A list of `AlarmsDTO` objects, containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved `IdentityNumber` (long) - the index number of the last offline alarm at the point of the first request `RowNumber` (long) - the index number from which the alarms were be retrieved

GetAlarmsByToken

Syntax	`GetAlarmsByToken(string securityToken, IEnumerable<Guid> alarmsID, int languageID, string timeZoneID, int millisecondsTimeOut, bool shouldResolvePlaceholders = true)`
Description	Retrieves a list of alarms based on the security token and the given parameters
Parameters	`securityToken` (string) - the security token returned by the `Login()` method `alarmsID` (IEnumerable<Guid>) - the list of unique ids of the alarms to be retrieved `languageID` (int) - the id of the language in which to retrieve the alarms `timeZoneID` (string) - the id of the timezone in which to retrieve the alarm `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated. `shouldResolvePlaceholders` (bool) - if true, the replacement values placeholders will return resolved
Return Value	A list of `AlarmsDTO` objects, containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved `IdentityNumber` (long) - the index number of the last offline alarm at the point of the first request `RowNumber` (long) - the index number from which the alarms were be retrieved

GetCustomAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetCustomAlarms(string sessionId, string clientId, string userName, bool IsDomainUser, string alarmQueryName, CustomQueryParameterDTO[] queryParameters, int languageID, string timeZoneID, int millisecondsTimeOut);`
Description	Retrieves a list of alarms based on a custom made query created in the database
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmQueryName` (string) - the custom query name `queryParameters` (CustomQueryParameterDTO[]) - a list of custom query parameter data transfer objects, each containing: `Name` (string) - the name of the custom query parameter `Value` (string) - the value of the custom query parameter `languageID` (int) - the id of the language in which to retrieve the alarms `timeZoneID` (string) - the id of the timezone in which to retrieve the alarm `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of `AlarmsDTO` objects, containing: `Alarms` (IEnumerable<AlarmDTO>) - a list of `AlarmDTO` containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `HasMore` (bool) - indicates if there are more alarms matching the filter besides the ones retrieved `IdentityNumber` (long) - the index number of the last offline alarm at the point of the first request `RowNumber` (long) - the index number from which the alarms were be retrieved

GetReplacedAlarm

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetReplacedAlarm(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmDTO alarmDTO, int languageID, AlarmReplacement[] replacementValues, int millisecondsTimeOut);`
Description	Retrieves alarm with replacement values instead of placeholders, for the given alarm and language
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmDTO` (AlarmDTO) - the alarm data transfer object, containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - replacement value placeholders `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm `languageID` (int) - the id of the language in which to retrieve the alarm `replacementValues` (AlarmReplacement[]) - an array of alarm replacement values, each containing the following members: `NumberValue` (double?) - the possible numeric value to be replaced `StringValue` (string) - the string value to be replaced `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	An `AlarmDTO`, containing: `AlarmLogID` (guid) - alarm log id `DateOn` (DateTime) - the date and time when alarm was triggered `DateOff` (DateTime?) - the date and time when alarm was closed `DateAck` (DateTime?) - the date and time when alarm was acknowledged `SysTime` (DateTime?) - the date and time of the OCP server `AlarmID` (guid) - the global unique identifier for the alarm `AlarmTag` (string) - the name of the alarm `SignalName` (string) - the name of the attached signal in the OCP server `SignalAliasName` (string) - the name of the attached signal in the server `ReplaceOn` (int) - the flag that activates the replacement of placeholders `Priority` (int) - the alarm priority `AckText` (string) - the acknowledgment text `AlarmLinkURL` (string) - the URL attached to the alarm `Value1` -> `Value20` (string) - the replaced values `AlarmConstant` (double?) - the constant used in alarm condition. The value of the attached signal can be bigger, equal or smaller than the constant. `AlarmConstantTo` (double?) - the constants used in alarm condition. The value of the attached signal can be between the two constants. `AlarmSymbolicText` (string) - the original alarm name not translated `AlarmSymbolicTextTranslation` (string) - the translation of the alarm name in the defined language `AlarmGroupSymbolicText` (string) - the alarm group name not translated `AlarmGroupSymbolicTextTranslation` (string) - the translation of the alarm group name in the defined language `AlarmTypeSymbolicText` (string) - the alarm type name not translated `AlarmTypeSymbolicTextTranslated` (string) - the alarm type name translated in the defined language `AckUserName` (string) - the user name of the user that acknowledged the alarm `AlarmComment` (string) - the general comment of the alarm `OccurrenceComment` (string) - the comment at the alarm occurrence `Status` (string) - the status of the alarm `ExtendedProperty1` -> `ExtendedProperty32` (string) - the extended properties of the alarm. `HelpCause` (string) - the cause of the alarm `HelpEffect` (string) - the effect of the alarm `HelpRepair` (string) - the fixing method for the alarm `OccurrenceCount` (string) - the number of times the alarm has occurred before `NavigationSource` (string) - the navigation page to be displayed at runtime `NavigationTarget` (string) - the navigation area in which the page is displayed at runtime `OPCQuality` (int) - the quality of the signal attached to the alarm

SetAlarmState

Syntax	`SetAlarmState(string securityToken, Guid alarmId, AlarmProcessingAndDisplayState state, DateTime reactivation, int millisecondsTimeOut);`
Description	Sets the specified alarm to the specified state
Parameters	`securityToken` (string) - the security token returned by the Login method `alarmId` (guid) - the unique id of the alarm for which the state is modified `state` (AlarmProcessingAndDisplayState) - the object defining the new processing and display state of the alarm, with the following members: `NotProcessedButVisible` `ProcessedAndVisible` `NotProcessedAndNotVisible` `ProcessedButNotVisible` `reactivation` (DateTime) - the time and date when the alarm is reactivated after changing the state `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The status of the operation: true for success or false for error

SetAlarmStates

Syntax	`SetAlarmStates(string securityToken, IEnumerable<Guid> alarmIds, IEnumerable<AlarmProcessingAndDisplayState> states, IEnumerable<DateTime> reactivations, int millisecondsTimeOut);`
Description	Sets the specified alarms to the specified states
Parameters	`securityToken` (string) - the security token returned by the Login method `alarmIds` (IEnumerable<Guid>) - a list of unique ids of the alarms for which the states are modified `states` (IEnumerable<AlarmProcessingAndDisplayState>) - a list of objects defining the new processing and display states of the alarms, each one with the following members: `NotProcessedButVisible` `ProcessedAndVisible` `NotProcessedAndNotVisible` `ProcessedButNotVisible` `reactivations` (IEnumerable<DateTime>) - a list of times and dates when the alarms are reactivated after changing the states `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The status of the operation: true for success or false for error

AcknowledgeAllAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`AcknowledgeAllAlarms(string sessionId, string clientId, string userName, string password, bool IsDomainUser, string comment, int millisecondsTimeOut);`
Description	Sets all unacknowledged alarms to acknowledged and provides the acknowledgment comment
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `password` (string) - the password of the user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAllAlarmsByToken

Syntax	`AcknowledgeAllAlarmsByToken(string securityToken, string comment, int millisecondsTimeOut);`
Description	Sets all unacknowledged alarms to acknowledged and provides the acknowledgment comment
Parameters	`securityToken` (string) - the security token returned by the Login method `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAlarmsByGroup

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`AcknowledgeAlarmsByGroup(string sessionId, string clientId, string userName, string password, bool IsDomainUser, string groupName, string comment, int millisecondsTimeOut);`
Description	Sets all alarms from the specified alarm group to acknowledged and provides the acknowledgment comment
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `password` (string) - the password of the user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `groupName` (string) - the name of the alarm group for which to set the alarms to acknowledged `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAlarmsByGroupByToken

Syntax	`AcknowledgeAlarmsByGroupByToken(string securityToken, string groupName, string comment, int millisecondsTimeOut);`
Description	Sets all alarms from the specified alarm group to acknowledged and provides the acknowledgment comment
Parameters	`securityToken` (string) - the security token returned by the Login method `groupName` (string) - the name of the alarm group for which to set the alarms to acknowledged `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAllGoneAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`AcknowledgeAllGoneAlarms(string sessionId, string clientId, string userName, string password, bool IsDomainUser, string comment, int millisecondsTimeOut);`
Description	Sets all gone alarms to acknowledged and provides the acknowledgment comment
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `password` (string) - the password of the user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAllGoneAlarmsByToken

Syntax	`AcknowledgeAllGoneAlarmsByToken(string securityToken, string comment, int millisecondsTimeOut);`
Description	Sets all gone alarms to acknowledged and provides the acknowledgment comment
Parameters	`securityToken` (string) - the security token returned by the Login method `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAlarms

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`AcknowledgeAlarms(string sessionId, string clientId, string userName, string password, bool IsDomainUser, IEnumerable<Guid> alarmIds, string comment, int millisecondsTimeOut);`
Description	Sets all specified alarms to acknowledged and provides the acknowledgment comment
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `password` (string) - the password of the user `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmIds` (IEnumerable<Guid>) - the list of unique ids of the alarms to be set as acknowledged `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The AcknowledgeResultDTO object, containing: `Result` (bool) - the status of the operation: true for success or false for error `ErrorCodes` (IEnumerable<int>) - an array of error codes, which can contain the following: 0 - a single number 0 when the result is successful (`Result` = true) -1, authorizationErrorCount, opcErrorCount - when the operation failed (`Result` = false), where: authorizationErrorCount - the number of errors caused by authorization issues opcErrorCount - the number of errors caused by OPC issues

AcknowledgeAlarmsByToken

Syntax	`AcknowledgeAlarmsByToken(string securityToken, IEnumerable<Guid> alarmIds, string comment, int millisecondsTimeOut);`
Description	Sets all specified alarms to acknowledged and provides the acknowledgment comment
Parameters	`securityToken` (string) - the security token returned by the Login method `alarmIds` (IEnumerable<Guid>) - the list of unique ids of the alarms to be set as acknowledged `comment` (string) - the acknowledgment comment `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The status of the operation: true for success or false for error

GetAllServers

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAllServers(string sessionId, string clientId, string userName, bool IsDomainUser, int millisecondsTimeOut);`
Description	Retrieves all the available alarm servers
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of `ServerDTO` objects, each containing: `id` (guid) - the unique id of the server `name` (string) - the name of the server `description` (string) - the description of the server

GetAllAlarmConditions

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAllAlarmConditions(string sessionId, string clientId, string userName, bool IsDomainUser, int millisecondsTimeOut);`
Description	Returns all existing alarm conditions based on the provided parameters.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of AlarmConditionDTOs. The AlarmConditionDTO contains the following: `Server` (ServerDTO) - the Server data transfer object, containing: `id` (guid) - the unique id of the server `name` (string) - the name of the server `description` (string) - the description of the server `Criteria` (AlarmCriteriaDTO) - the AlarmCriteria data transfer object, containing: `ID` (int) - the id of the alarm criteria `Name` (string) - the name of the alarm criteria `Constant` (double?) - the numeric constant used by the alarm criteria for comparison. Can be null. `constantTo` (double?) - the secondary numeric constant used by the alarm criteria for comparison. Can be null. `OtherSignal` (SignalDTO) - the Signal data transfer object, containing: `id` (guid) - the unique id of the signal used for comparison by the alarm criteria `Name` (string) - the name of the signal used for comparison by the alarm criteria `AliasName` (string) - the friendly name of the signal used for comparison by the alarm criteria `Description` (string) - the description of the signal used for comparison by the alarm criteria

InsertAlarmCondition

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`InsertAlarmCondition(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmConditionId, string name, Guid serverId, int alarmCriteriaId, double? constant, double? constantTo, Guid? otherSignalId, int millisecondsTimeOut);`
Description	Adds a new alarm condition.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmConditionId` (guid) - the id of the alarm condition `name` (string) - the name of the alarm condition `serverId` (guid) - the unique id of the alarming server `alarmCriteriaId` (int) - the id of the alarm criteria `constant` (double?) - the numeric constant used by the alarm criteria for comparison. Can be null. `constantTo` (double?) - the secondary numeric constant used by the alarm criteria for comparison. Can be null. `otherSignalId` (guid?) - the unique id of the signal used by the alarm criteria for comparison. Can be null. `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

UpdateAlarmCondition

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`UpdateAlarmCondition(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmConditionId, string name, Guid serverId, int alarmCriteriaId, double? constant, double? constantTo, Guid? otherSignalId, int millisecondsTimeOut);`
Description	Updates a new alarm condition.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmConditionId` (guid) - the id of the alarm condition `name` (string) - the name of the alarm condition `serverId` (guid) - the unique id of the alarming server `alarmCriteriaId` (int) - the id of the alarm criteria `constant` (double?) - the numeric constant used by the alarm criteria for comparison. Can be null. `constantTo` (double?) - the secondary numeric constant used by the alarm criteria for comparison. Can be null. `otherSignalId` (guid?) - the unique id of the signal used by the alarm criteria for comparison. Can be null. `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

DeleteAlarmCondition

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`DeleteAlarmCondition(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmConditionId, int millisecondsTimeOut);`
Description	Deletes the specified alarm condition.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmConditionId` (guid) - the id of the alarm condition `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The status of the delete operation: Success, Error or InUse

GetAlarmDefinitions

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAlarmDefinitions(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmDefinitionFilterDTO filter, int millisecondsTimeOut);`
Description	Retrieves the list of alarm definitions that fulfill the filter conditions.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `AlarmDefinitionFilterDTO` (filter) - the filter data transfer object that contains: `UserName` (string) - the user name of the currently logged in user `IsDomainUser` (bool) - the value is true when the user is an Active Directory user `LangID` (int) - the id of the current language `Tag` (string) - the tag of the alarms `Signal` (string) - the name of the signal that triggers the alarms `Active` (bool?) - the status of the alarms. If active, the value will be 1. Can be null. `Custom` (bool?) - the type of alarms. If custom, the value will be 1. Can be null. `Online` (bool?) - the online status of the alarms. If online, the value will be 1. Can be null. `Groups` (IEnumerable<string>) - the list of alarm groups to which the alarms belong `Types` (IEnumerable<string>) - the list of alarm types to which the alarms belong `CondIDs` (IEnumerable<guid>) - the list of global unique ids of the alarm conditions which apply to the alarms `Prio` (RangeDTO) - the Range data transfer object of the alarms priority, containing: `Minimum` (T) - the minimum priority value `Maximum` (T) - the maximum priority value `Text` (string) - the default text of the alarms `Link` (string) - the link URL of the alarms `Suppression` (RangeDTO) - the Range data transfer object of the alarms suppression interval, containing: `Minimum` (T) - the start of the suppression interval `Maximum` (T) - the end of the suppression interval `PlcOn` (bool?) - the state of PLC acknowledgment. If on, the value will be 1. Can be null. `PlcSignal` (string) - the name of the PLC signal used for PLC acknowledgment `ExecScript` (bool?) - the state of script execution when the alarm is triggered. If on, the value will be 1. Can be null. `ScriptPath` (string) - the path to the script to be executed when the alarm is triggered `EnableLP` (bool?) - the state of line printer output. If enabled, the value will be 1. Can be null. `NavSrc` (string) - the name of the page to be displayed in the navigation target when the alarm is clicked in the visualization `NavTarget` (string) - the control where the visualization page will display the navigation source `Comment` (string) - the custom comment used for providing additional information `FilterAlarmGroupsByUser` (bool) - the state of alarm group filtering. If on, the value will be 1 and only the alarms belonging to alarm groups to which the currently logged in user has access to will be displayed `DeactivationSignal` (string) - the name of the signal which can deactivate alarms `Ep1` to `Ep32` (RangeDTO<string>) - the Range data transfer object of strings, containing: `Minimum` (string) - the minimum value of the extended property, which can be either an int, double or string passed as strings. The ExtendedProperty can contain the equal value of the Minimum and Maximum or a value defined by their range. `Maximum` (string) - the maximum value of the extended property, which can be either an int, double or string passed as strings. The ExtendedProperty can contain the equal value of the Minimum and Maximum or a value defined by their range. `Translation` (string) - the translated description of the alarms `Cause` (string) - the translated text of the alarms cause hints `Effect` (string) - the translated text of the alarms effect hints `Repair` (string) - the translated text of the alarms repair hints `Replace` (bool?) - the state of replacement values. If on, the value will be 1 and the placeholders will be replaced with signals values in the alarm messages `RSigl` to `RSig20` (string) - the name of the signals used to replace the placeholders in the alarm messages `Start` (int) - the starting index from which the alarm definitions will be retrieved `Count` (int) - the number of alarm definitions to be retrieved. To get all available alarm definitions, use int.MaxValue. `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	An `AlarmDefinitionsDTO`, containing: `Definitions` (IEnumerable<AlarmDefinitionDTO>) - a list of alarm definition data transfer objects, which contain: `Signal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the signal on which the alarm condition is based `AliasName` (string) - the friendly name of the signal on which the alarm condition is based `Description` (string) - the description of the signal on which the alarm condition is based `id` (guid) - the unique id of the signal on which the alarm condition is based `Tag` (string) - the alarm definition tag `Active` (bool) - the state of the alarm definition `Type` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm type `SymbolicTextTranslation` (string) - the actual translation of the alarm type `id` (guid) - the unique id of the symbolic text `Group` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm group `SymbolicTextTranslation` (string) - the actual translation of the alarm group `id` (guid) - the unique id of the symbolic text `Cond` (NameDTO) - the name data transfer object containing: `Name` (string) - the name of the alarm definition `id` (guid) - the unique id of the alarm definition `Replace` (int) - the state of the signal replacement. If activate, the value will be 1. `Prio` (int) - the priority of the alarm definition `PLCOn` (int) - the state of the PLC acknowledgment. If active, the value will be 1. `PLCSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the PLC signal used for PLC acknowledgment `AliasName` (string) - the friendly name of the PLC signal used for PLC acknowledgment `Description` (string) - the description of the PLC signal used for PLC acknowledgment `id` (guid) - the unique id of the PLC signal used for PLC acknowledgment `PLCValue` (double?) - the value to be written to the PLC signal when the alarm is acknowledged `Link` (string) - the URL link that can be opened when the alarm is active `Online` (bool) - the online status of the alarm. If online, the value will be 1. `ExecScript` (bool) - the state of script execution when the alarm is triggered. If on, the value will be 1. `ScriptPath` (string) - the path to the script to be executed when the alarm is triggered `EnableLP` (bool) - the state of line printer output. If enabled, the value will be 1. `Symbol` (int) - the id of the alarm symbol `Status` (int) - the status of the alarm `ReactTime` (DateTime) - the time and date when the alarm is reactivated after changing the state `Suppression` (int) - the time duration in which the alarm will be suppressed `DeactivationSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the deactivation signal `AliasName` (string) - the friendly name of the deactivation signal `Description` (string) - the description of the deactivation signal `id` (guid) - the unique id of the deactivation signal `RSigl1` to `RSig20` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the replacement signal `AliasName` (string) - the friendly name of the replacement signal `Description` (string) - the description of the replacement signal `id` (guid) - the unique id of the replacement signal `Cause` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help cause text `SymbolicTextTranslation` (string) - the actual translation of the help cause text `id` (guid) - the unique id of the help cause text `Effect` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help effect text `SymbolicTextTranslation` (string) - the actual translation of the help effect text `id` (guid) - the unique id of the help effect text `Repair` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help repair text `SymbolicTextTranslation` (string) - the actual translation of the help repair text `id` (guid) - the unique id of the help repair text `Ep1` to `Ep32` (string) - the extended properties contents `NavSrc` (string) - the name of the page to be displayed in the navigation target when the alarm is clicked in the visualization `NavTarget` (string) - the control where the visualization page will display the navigation source `Comment` (string) - the custom comment used for providing additional information `Custom` (bool) - the type of alarm. If custom, the value will be 1. `HasMore` (bool) - indicates if there are more alarm definitions matching the filter besides the ones retrieved (by specifying the StartIndex and ItemCount).

UpdateAlarmDefinition

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`UpdateAlarmDefinition(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmDefinitionDTO alarmDefinition, int millisecondsTimeOut);`
Description	Updates the alarm definition.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmDefinition` (AlarmDefinitionDTO) - the alarm definition data transfer object, which contains: `Signal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the signal on which the alarm condition is based `AliasName` (string) - the friendly name of the signal on which the alarm condition is based `Description` (string) - the description of the signal on which the alarm condition is based `id` (guid) - the unique id of the signal on which the alarm condition is based `Tag` (string) - the alarm definition tag `Active` (bool) - the state of the alarm definition `Type` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm type `SymbolicTextTranslation` (string) - the actual translation of the alarm type `id` (guid) - the unique id of the symbolic text `Group` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm group `SymbolicTextTranslation` (string) - the actual translation of the alarm group `id` (guid) - the unique id of the symbolic text `Cond` (NameDTO) - the name data transfer object containing: `Name` (string) - the name of the alarm definition `id` (guid) - the unique id of the alarm definition `Replace` (int) - the state of the signal replacement. If activate, the value will be 1. `Prio` (int) - the priority of the alarm definition `PLCOn` (int) - the state of the PLC acknowledgment. If active, the value will be 1. `PLCSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the PLC signal used for PLC acknowledgment `AliasName` (string) - the friendly name of the PLC signal used for PLC acknowledgment `Description` (string) - the description of the PLC signal used for PLC acknowledgment `id` (guid) - the unique id of the PLC signal used for PLC acknowledgment `PLCValue` (double?) - the value to be written to the PLC signal when the alarm is acknowledged `Link` (string) - the URL link that can be opened when the alarm is active `On` (bool) - the online status of the alarm. If online, the value will be 1. `ExecScript` (bool) - the state of script execution when the alarm is triggered. If on, the value will be 1. `ScriptPath` (string) - the path to the script to be executed when the alarm is triggered `EnableLP` (bool) - the state of line printer output. If enabled, the value will be 1. `Symbol` (int) - the id of the alarm symbol `Status` (int) - the status of the alarm `ReactTime` (DateTime) - the time and date when the alarm is reactivated after changing the status `Suppression` (int) - the time duration in which the alarm will be suppressed `DeactivationSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the deactivation signal `AliasName` (string) - the friendly name of the deactivation signal `Description` (string) - the description of the deactivation signal `id` (guid) - the unique id of the deactivation signal `RSigl1` to `RSig20` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the replacement signal `AliasName` (string) - the friendly name of the replacement signal `Description` (string) - the description of the replacement signal `id` (guid) - the unique id of the replacement signal `Cause` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help cause text `SymbolicTextTranslation` (string) - the actual translation of the help cause text `id` (guid) - the unique id of the help cause text `Effect` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help effect text `SymbolicTextTranslation` (string) - the actual translation of the help effect text `id` (guid) - the unique id of the help effect text `Repair` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help repair text `SymbolicTextTranslation` (string) - the actual translation of the help repair text `id` (guid) - the unique id of the help repair text `Ep1` to `Ep32` (string) - the extended properties contents `NavSrc` (string) - the name of the page to be displayed in the navigation target when the alarm is clicked in the visualization `NavTarget` (string) - the control where the visualization page will display the navigation source `Comment` (string) - the custom comment used for providing additional information `Custom` (bool) - the type of alarm. If custom, the value will be 1. `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	Returns true if the alarm definition was successfully updated.

DeleteAlarmDefinition

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`DeleteAlarmDefinition(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmDefinitionDTO alarmDefinition, int millisecondsTimeOut);`
Description	Deletes the alarm definition
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmDefinition` (AlarmDefinitionDTO) - the alarm definition data transfer object, which contains: `Signal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the signal on which the alarm condition is based `AliasName` (string) - the friendly name of the signal on which the alarm condition is based `Description` (string) - the description of the signal on which the alarm condition is based `id` (guid) - the unique id of the signal on which the alarm condition is based `AlarmTag` (string) - the alarm definition tag `Active` (bool) - the state of the alarm definition `AlarmType` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm type `SymbolicTextTranslation` (string) - the actual translation of the alarm type `id` (guid) - the unique id of the symbolic text `AlarmGroup` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm group `SymbolicTextTranslation` (string) - the actual translation of the alarm group `id` (guid) - the unique id of the symbolic text `Condition` (NameDTO) - the name data transfer object containing: `Name` (string) - the name of the alarm definition `id` (guid) - the unique id of the alarm definition `ReplaceON` (int) - the state of the signal replacement. If activate, the value will be 1. `Priority` (int) - the priority of the alarm definition `PLCOn` (int) - the state of the PLC acknowledgment. If active, the value will be 1. `PLCSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the PLC signal used for PLC acknowledgment `AliasName` (string) - the friendly name of the PLC signal used for PLC acknowledgment `Description` (string) - the description of the PLC signal used for PLC acknowledgment `id` (guid) - the unique id of the PLC signal used for PLC acknowledgment `PLCNewValue` (double?) - the value to be written to the PLC signal when the alarm is acknowledged `AlarmLinkURL` (string) - the URL link that can be opened when the alarm is active `OnlineAlarm` (bool) - the online status of the alarm. If online, the value will be 1. `ExecuteScript` (bool) - the state of script execution when the alarm is triggered. If on, the value will be 1. `ScriptPath` (string) - the path to the script to be executed when the alarm is triggered `EnableLinePrinter` (bool) - the state of line printer output. If enabled, the value will be 1. `SymbolID` (int) - the id of the alarm symbol `Status` (int) - the status of the alarm `ReactivationTime` (DateTime) - the time and date when the alarm is reactivated after changing the status `SuppressionDuration` (int) - the time duration in which the alarm will be suppressed `DeactivationSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the deactivation signal `AliasName` (string) - the friendly name of the deactivation signal `Description` (string) - the description of the deactivation signal `id` (guid) - the unique id of the deactivation signal `ReplaceSignal1` to `ReplaceSignal20` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the replacement signal `AliasName` (string) - the friendly name of the replacement signal `Description` (string) - the description of the replacement signal `id` (guid) - the unique id of the replacement signal `HelpCause` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help cause text `SymbolicTextTranslation` (string) - the actual translation of the help cause text `id` (guid) - the unique id of the help cause text `HelpEffect` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help effect text `SymbolicTextTranslation` (string) - the actual translation of the help effect text `id` (guid) - the unique id of the help effect text `HelpRepair` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help repair text `SymbolicTextTranslation` (string) - the actual translation of the help repair text `id` (guid) - the unique id of the help repair text `ExtendedProperty1` to `ExtendedProperty32` (string) - the extended properties contents `NavigationSource` (string) - the name of the page to be displayed in the navigation target when the alarm is clicked in the visualization `NavigationTarget` (string) - the control where the visualization page will display the navigation source `GeneralComment` (string) - the custom comment used for providing additional information `CustomAlarm` (bool) - the type of alarm. If custom, the value will be 1. `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	Returns true if the alarm definition was successfully deleted

InsertNewAlarmDefinition

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`InsertNewAlarmDefinition(string sessionId, string clientId, string userName, bool IsDomainUser, AlarmDefinitionDTO alarmDefinition, int millisecondsTimeOu);`
Description	Adds a new alarm definition.
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmDefinition` (AlarmDefinitionDTO) - the alarm definition data transfer object, which contains: `Signal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the signal on which the alarm condition is based `AliasName` (string) - the friendly name of the signal on which the alarm condition is based `Description` (string) - the description of the signal on which the alarm condition is based `id` (guid) - the unique id of the signal on which the alarm condition is based `AlarmTag` (string) - the alarm definition tag `Active` (bool) - the state of the alarm definition `AlarmType` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm type `SymbolicTextTranslation` (string) - the actual translation of the alarm type `id` (guid) - the unique id of the symbolic text `AlarmGroup` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the alarm group `SymbolicTextTranslation` (string) - the actual translation of the alarm group `id` (guid) - the unique id of the symbolic text `Condition` (NameDTO) - the name data transfer object containing: `Name` (string) - the name of the alarm definition `id` (guid) - the unique id of the alarm definition `ReplaceON` (int) - the state of the signal replacement. If activate, the value will be 1. `Priority` (int) - the priority of the alarm definition `PLCOn` (int) - the state of the PLC acknowledgment. If active, the value will be 1. `PLCSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the PLC signal used for PLC acknowledgment `AliasName` (string) - the friendly name of the PLC signal used for PLC acknowledgment `Description` (string) - the description of the PLC signal used for PLC acknowledgment `id` (guid) - the unique id of the PLC signal used for PLC acknowledgment `PLCNewValue` (double?) - the value to be written to the PLC signal when the alarm is acknowledged `AlarmLinkURL` (string) - the URL link that can be opened when the alarm is active `OnlineAlarm` (bool) - the online status of the alarm. If online, the value will be 1. `ExecuteScript` (bool) - the state of script execution when the alarm is triggered. If on, the value will be 1. `ScriptPath` (string) - the path to the script to be executed when the alarm is triggered `EnableLinePrinter` (bool) - the state of line printer output. If enabled, the value will be 1. `SymbolID` (int) - the id of the alarm symbol `Status` (int) - the status of the alarm `ReactivationTime` (DateTime) - the time and date when the alarm is reactivated after changing the status `SuppressionDuration` (int) - the time duration in which the alarm will be suppressed `DeactivationSignal` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the deactivation signal `AliasName` (string) - the friendly name of the deactivation signal `Description` (string) - the description of the deactivation signal `id` (guid) - the unique id of the deactivation signal `ReplaceSignal1` to `ReplaceSignal20` (SignalDTO) - a signal data transfer object containing: `Name` (string) - the name of the replacement signal `AliasName` (string) - the friendly name of the replacement signal `Description` (string) - the description of the replacement signal `id` (guid) - the unique id of the replacement signal `HelpCause` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help cause text `SymbolicTextTranslation` (string) - the actual translation of the help cause text `id` (guid) - the unique id of the help cause text `HelpEffect` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help effect text `SymbolicTextTranslation` (string) - the actual translation of the help effect text `id` (guid) - the unique id of the help effect text `HelpRepair` (TranslatableDTO) - the translatable data transfer object which contains: `SymbolicTextName` (string) - the symbolic text name of the help repair text `SymbolicTextTranslation` (string) - the actual translation of the help repair text `id` (guid) - the unique id of the help repair text `ExtendedProperty1` to `ExtendedProperty32` (string) - the extended properties contents `NavigationSource` (string) - the name of the page to be displayed in the navigation target when the alarm is clicked in the visualization `NavigationTarget` (string) - the control where the visualization page will display the navigation source `GeneralComment` (string) - the custom comment used for providing additional information `CustomAlarm` (bool) - the type of alarm. If custom, the value will be 1. `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	Returns true if the alarm definition was successfully inserted

InsertAlarmGroup

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`InsertAlarmGroup(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmGroupId, string symbolicText, int millisecondsTimeOut);`
Description	Adds a new alarm group
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmGroupId` (guid) - the unique id of the new alarm group `symbolicText` (string) - the symbolic text (language independent text) of the new alarm group `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

UpdateAlarmGroup

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`UpdateAlarmGroup(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmGroupId, string symbolicText, int millisecondsTimeOut);`
Description	Updates an existing alarm group
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmGroupId` (guid) - the unique id of the new alarm group `symbolicText` (string) - the symbolic text (language independent text) of the new alarm group `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

DeleteAlarmGroup

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`DeleteAlarmGroup(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmGroupId, int millisecondsTimeOut);`
Description	Deletes an existing alarm group
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmGroupId` (guid) - the unique id of the new alarm group `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	Returns true if the alarm group was successfully deleted

GetAlarmGroups

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAlarmGroups(string sessionId, string clientId, string userName, bool IsDomainUser, int languageID, int millisecondsTimeOut);`
Description	Retrieves the list of available alarm groups
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `languageID` (int) - the id of the current language, for which the translations are applied `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of AlarmGroupDTOs, each containing: `id` (guid) - the unique id of the alarm group `symbolicTextName` (string) - the symbolic name of the alarm group `symbolicTextTranslation` (string) - the translation of the alarm group

GetAlarmGroupsByToken

Syntax	`GetAlarmGroupsByToken(string securityToken, int languageID, int millisecondsTimeOut);`
Description	Retrieves the list of available alarm groups using the security token
Parameters	`securityToken` (string) - the security token returned by the `Login()` method `languageID` (int) - the id of the current language, for which the translations are applied `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of AlarmGroupDTOs, each containing: `id` (guid) - the unique id of the alarm group `symbolicTextName` (string) - the symbolic name of the alarm group `symbolicTextTranslation` (string) - the translation of the alarm group

GetUserAlarmGroups

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetUserAlarmGroups(string sessionId, string clientId, string userName, bool IsDomainUser, int languageID, int millisecondsTimeOut);`
Description	Retrieves the list of available alarm groups for a specific user
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `languageID` (int) - the id of the current language, for which the translations are applied `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of AlarmGroupDTOs, each containing: `id` (guid) - the id of the alarm group to which the specified user has access `symbolicTextName` (string) - the symbolic name (language independent) of the alarm group to which the specified user has access `symbolicTextTranslation` (string) - the translation of the alarm group to which the specified user has access

GetUserAlarmGroupsByToken

Syntax	`GetUserAlarmGroupsByToken(string securityToken, int languageID, int millisecondsTimeOut)`
Description	Retrieves the list of available alarm groups for a specific user using the security token
Parameters	`securityToken` (string) - the security token returned by the `Login()` method `languageID` (int) - the id of the current language, for which the translations are applied `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of AlarmGroupDTOs, each containing: `id` (guid) - the id of the alarm group to which the specified user has access `symbolicTextName` (string) - the symbolic name (language independent) of the alarm group to which the specified user has access `symbolicTextTranslation` (string) - the translation of the alarm group to which the specified user has access

GetAlarmTypes

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`GetAlarmTypes(string sessionId, string clientId, string userName, bool IsDomainUser, int languageID, int millisecondsTimeOut);`
Description	Retrieves all available alarm types using the provided language
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `languageID` (int) - the id of the language in which to retrieve the alarm types `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of `AlarmTypeDTO` objects, each containing: `id` (guid) - the unique id of the alarm type `symbolicTextName` (string) - the symbolic name (language independent) of the alarm type `symbolicTextTranslation` (string) - the translated name of the alarm type

InsertAlarmType

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`InsertAlarmType(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmTypeId, string symbolicText, bool isAutoConfirm, int millisecondsTimeOut);`
Description	Ads a new alarm type using the provided id, name and auto acknowledge option
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmTypeId` (guid) - the unique id of the new alarm type `symbolicText` (string) - the symbolic name (language independent) of the new alarm type `isAutoConfirm` (bool) - if true, the alarms of this new type will be auto acknowledged `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

UpdateAlarmType

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`UpdateAlarmType(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmTypeId, string symbolicText, bool isAutoConfirm, int millisecondsTimeOut);`
Description	Updates an existing alarm type using the provided id, name and auto acknowledge option
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmTypeId` (guid) - the unique id of the new alarm type `symbolicText` (string) - the symbolic name (language independent) of the new alarm type `isAutoConfirm` (bool) - if true, the alarms of this new type will be auto acknowledged `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	None

DeleteAlarmType

This method follows the WEBfactory i4scada Security Protocol.

Syntax	`DeleteAlarmType(string sessionId, string clientId, string userName, bool IsDomainUser, Guid alarmTypeId, int millisecondsTimeOut);`
Description	Deletes and existing alarm type based on the provided id
Parameters	`sessionId` (string) - the unique ID of the session, returned by the `connect()` method `clientId` (string) - the user defined unique ID of the client from which the web service is called `userName` (string) - the name of the defined user in context of which the method is called `IsDomainUser` (bool) - true if the defined user is an Active Directory user `alarmTypeId` (guid) - the unique id of the new alarm type `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	The status of the delete operation: Success, Error or InUse

GetAlarmTypesByToken

Syntax	`GetAlarmTypesByToken(string sessionId, string clientId, string userName, bool IsDomainUser, int languageID, int millisecondsTimeOut);`
Description	Retrieves all available alarm types using the provided security token and language ID
Parameters	`securityToken` (string) - the security token returned by the Login method `languageID` (int) - the id of the language in which to retrieve the alarm types `millisecondsTimeOut` (int) - the amount of time, in milliseconds, in which the authentication process is verified. If this time period is exceeded or the login failed, a fault exception will be generated.
Return Value	A list of `AlarmTypeDTO` objects, each containing: `id` (guid) - the unique id of the alarm type `symbolicTextName` (string) - the symbolic name (language independent) of the alarm type `symbolicTextTranslation` (string) - the translated name of the alarm type

In this section:

i4scada Knowledge Base

WCF Alarms Service Documentation

UpdateAlarmGeneralComment

UpdateOnlineAlarmsOccurrenceComment

GetOnlineAlarms

GetOnlineAlarmsByToken

GetOfflineAlarms

GetOfflineAlarmsByToken

GetExtendedAlarmProperties

GetAlarmsWithChangedProcessingAndDisplayState

GetAlarms

GetAlarmsByToken

GetCustomAlarms

GetReplacedAlarm

SetAlarmState

SetAlarmStates

AcknowledgeAllAlarms

AcknowledgeAllAlarmsByToken

AcknowledgeAlarmsByGroup

AcknowledgeAlarmsByGroupByToken

AcknowledgeAllGoneAlarms

AcknowledgeAllGoneAlarmsByToken

AcknowledgeAlarms

AcknowledgeAlarmsByToken

GetAllServers

GetAllAlarmConditions

InsertAlarmCondition

UpdateAlarmCondition

DeleteAlarmCondition

GetAlarmDefinitions

UpdateAlarmDefinition

DeleteAlarmDefinition

InsertNewAlarmDefinition

InsertAlarmGroup

UpdateAlarmGroup

DeleteAlarmGroup

GetAlarmGroups

GetAlarmGroupsByToken

GetUserAlarmGroups

GetUserAlarmGroupsByToken

GetAlarmTypes

InsertAlarmType

UpdateAlarmType

DeleteAlarmType

GetAlarmTypesByToken

Search results