Skip to content

Функции GAP

В ячейках листов моделей допускается вызов пользовательских функций GAP (C#) в формате <script GAP.ИмяПространства.Класс.Метод(args)/>. Определение термина GAP — в Термины и сокращения. Ниже — каталог доступных функций по классам (после префикса GAP); используйте поиск на странице или глобальный поиск wiki.

57 функций

GAP.ScadaProjectBase.Tags

Функция Вызов (пример) Описание
GetPrjTag GAP.ScadaProjectBase.Tags.GetPrjTag("[TAG]") Преобразование тега по правилам проекта (SplitRegex/ComposeRegex)
GetPrjShortTag GAP.ScadaProjectBase.Tags.GetPrjShortTag(tag) Сокращённый тег (последние две части)
GetVarTagByObjType GAP.ScadaProjectBase.Tags.GetVarTagByObjType(objType, tag, varType) Тег переменной по типу объекта и имени переменной
ReplaceTagString GAP.ScadaProjectBase.Tags.ReplaceTagString(tag, old, new) Замена подстроки в теге
GetTagFeedback GAP.ScadaProjectBase.Tags.GetTagFeedback(tagFeedback, tag, qlty) Тег обратной связи по OBJTYPENAME

GAP.ScadaProjectBase.AlarmLevels

Функция Вызов (пример) Описание
GetSeverityValue GAP.ScadaProjectBase.AlarmLevels.GetSeverityValue(alarmLevel, tag) Значение Severity по уровню аварии (AlphaAlarms)
GetSeverityLink GAP.ScadaProjectBase.AlarmLevels.GetSeverityLink(alarmLevelValue, tag) Ссылка на глобальный объект Severity в HMI
GetAlarmLevelParameter GAP.ScadaProjectBase.AlarmLevels.GetAlarmLevelParameter(alarmLevel, paramName, tag) Параметр уровня аварии по имени

GAP.ScadaProjectBase.General

Функция Вызов (пример) Описание
GetAttributeFromAlarmLevel GAP.ScadaProjectBase.General.GetAttributeFromAlarmLevel(alarmLevel, attribute) Атрибут уровня аварии из AlphaAlarms
IsStringSet GAP.ScadaProjectBase.General.IsStringSet(value, tag) Проверка: строка задана и не пуста («true»/«false»)
GetMappedValue GAP.ScadaProjectBase.General.GetMappedValue(input, mappingPairs) Значение по паре ключ=значение (разделитель |)
GetMappedValueOrDefault GAP.ScadaProjectBase.General.GetMappedValueOrDefault(input, mappingPairs, default) То же с значением по умолчанию
GetPLCDataForTag GAP.ScadaProjectBase.General.GetPLCDataForTag(tag, data) Данные экземпляра ПЛК по тегу и имени поля
GetInstanceObjType GAP.ScadaProjectBase.General.GetInstanceObjType(instanceName) Библиотека Unimod2 для экземпляра
GetCombinedString GAP.ScadaProjectBase.General.GetCombinedString(s1, s2, s3, s4) Объединение четырёх строк
GetIOSPath GAP.ScadaProjectBase.General.GetIOSPath(tag) IosPath экземпляра по тегу

GAP.ScadaProjectBase.StCode

Функция Вызов (пример) Описание
GetInverseString GAP.ScadaProjectBase.StCode.GetInverseString(inverse) «NOT» если строка задана, иначе пустая строка
OffsetIntVariable GAP.ScadaProjectBase.StCode.OffsetIntVariable(address, offset) Смещение индекса переменной кадра (в JSM Modbus; в исходниках GAP — см. статью)

GAP.Helpers.DictionaryProcessor

Функция Вызов (пример) Описание
AddVariable GAP.Helpers.DictionaryProcessor.AddVariable(varName, value) Запись переменной в словарь текущей строки модели

GAP.AUCS.Thresholds

Функция Вызов (пример) Описание
GetThTag GAP.AUCS.Thresholds.GetThTag(sensorTag, num) Тег уставки по тегу датчика и номеру
GetThTagOrDefault GAP.AUCS.Thresholds.GetThTagOrDefault(sensorTag, num, default) То же с значением по умолчанию
GetThData GAP.AUCS.Thresholds.GetThData(sensorTag, num, data) Поле данных уставки
GetThDataOrDefault GAP.AUCS.Thresholds.GetThDataOrDefault(sensorTag, num, data, default) То же с значением по умолчанию
GetThUpBySensorTag GAP.AUCS.Thresholds.GetThUpBySensorTag(sensorTag, num) IsHigh у уставки («true»/«false»)
GetThUp GAP.AUCS.Thresholds.GetThUp(thTag) IsHigh по тегу уставки
GetThSeverity GAP.AUCS.Thresholds.GetThSeverity(sensorTag, num) Severity у уставки
GetTitleWithThresholdQuantity GAP.AUCS.Thresholds.GetTitleWithThresholdQuantity(sensorTag, title, returnEmptyIfZero) Заголовок с суффиксом _NTh по количеству уставок
MakeThresholdFeedbackText GAP.AUCS.Thresholds.MakeThresholdFeedbackText(sensorTag, templateName) Текст обратной связи по шаблону и уставкам

GAP.AUCS.Misc

Функция Вызов (пример) Описание
GetFBDNameWithExistingExtensions GAP.AUCS.Misc.GetFBDNameWithExistingExtensions(tag, initString) Имя FBD с учётом существующих расширений (OpTime и др.)

GAP.AUCS.TagAssignement

Функция Вызов (пример) Описание
GetDefaultOrAssignedFieldTag GAP.AUCS.TagAssignement.GetDefaultOrAssignedFieldTag(objType, tag, channel, templateName, defaultTag) Полевой тег по умолчанию или из шаблона
GetFieldTag GAP.AUCS.TagAssignement.GetFieldTag(objType, tag, channel, templateName) Полевой тег по шаблону привязки
GetDefaultOrAssignedDigitalTag GAP.AUCS.TagAssignement.GetDefaultOrAssignedDigitalTag(objType, tag, channel, templateName, defaultTag) Дискретный тег по умолчанию или из шаблона
GetDigitalTag GAP.AUCS.TagAssignement.GetDigitalTag(objType, tag, channel, templateName) Дискретный тег по шаблону
GetAnalogFieldTag GAP.AUCS.TagAssignement.GetAnalogFieldTag(tag, fieldTag) Полевой тег аналогового канала
GetDiscretFieldTag GAP.AUCS.TagAssignement.GetDiscretFieldTag(tag, fieldTag) Полевой тег дискретного канала
FindTagOrDefault GAP.AUCS.TagAssignement.FindTagOrDefault(tag) Поиск экземпляра по тегу или пустая строка

GAP.Afas

Функция Вызов (пример) Описание
GetMupsStatusExpr GAP.Afas.GetMupsStatusExpr(name, devNumber, tag) Выражение для статуса МУПС (индекс массива)
GetMupsStatusFrameIndex GAP.Afas.GetMupsStatusFrameIndex(devNumber) Индекс кадра статуса МУПС
GetCauseEffectC_condition GAP.Afas.GetCauseEffectC_condition(type, forceTypesStr, ...) Условие для ПСД (Cause Effect)
GetNotifierType GAP.Afas.GetNotifierType(tag, type) Тип оповещателя (0/1/2: световой, звуковой, свето-звуковой)
GetSpotDetectorType GAP.Afas.GetSpotDetectorType(tag, type) Тип точечного извещателя (0–3)
GetDetectorType GAP.Afas.GetDetectorType(tag, type) Тип извещателя (0–5: дымовой, тепловой, пламени и др.)
GetRmCntrlExpr GAP.Afas.GetRmCntrlExpr(name, channel) Выражение управления по EqtDescr и каналу

GAP.MopsDevice

Функция Вызов (пример) Описание
GetDiType GAP.MopsDevice.GetDiType(tag, type) Тип дискретного входа МОПС: 0 — магн. контакт, 1 — сигнал
SetMopsCommandsData GAP.MopsDevice.SetMopsCommandsData(name, suffix) Переменные команд МОПС по каналам 1–8

GAP.MupsDevice

Функция Вызов (пример) Описание
SetMupsCommandsData GAP.MupsDevice.SetMupsCommandsData(name, onName, offName) Переменные команд МУПС по каналам 1–4

GAP.Modbus

Функция Вызов (пример) Описание
GetTag GAP.Modbus.GetTag(tag) Возврат тега без изменений
GetModbusDiagVariable GAP.Modbus.GetModbusDiagVariable(tag, frameName) DiagVariable статического кадра Modbus-устройства
GetModbusFrameArray GAP.Modbus.GetModbusFrameArray(tag, frameName, index) Элемент массива переменных кадра Modbus
GetKauDeviceFrameArray GAP.Modbus.GetKauDeviceFrameArray(tag, frameName, index) Элемент массива кадра KAU по тегу датчика
GetKauDeviceDiagVariable GAP.Modbus.GetKauDeviceDiagVariable(tag, frameName) BeginReadVariableLocal кадра KAU

GAP.Unimodv2

Функция Вызов (пример) Описание
GetUnimodModuleTag GAP.Unimodv2.GetUnimodModuleTag(moduleId) Тег модуля по ModuleId
GetCpuTag GAP.Unimodv2.GetCpuTag(CpuId) Тег CPU по ModuleId
GetUnimodModbusDeviceTag GAP.Unimodv2.GetUnimodModbusDeviceTag(moduleId) Тег Modbus-устройства по ModuleId
MakeModuleDiagnosticText GAP.Unimodv2.MakeModuleDiagnosticText(cpuTag, templateName) ST-текст диагностики модулей по JSM-шаблону

GAP.Kau2

Функция Вызов (пример) Описание
GetIsSpotDetectorReReq GAP.Kau2.GetIsSpotDetectorReReq(template) True/False: ReReq в имени шаблона
GetRcmType GAP.Kau2.GetRcmType(tag, type) Код типа клапана RCM (ОЗК/ДУ/Реверс)

В качестве аргументов можно указывать внешние переменные (например, [TAG]) и переменные, определённые ранее в модели. Подробнее о синтаксисе вызова: Подключение пользовательских скриптов C# (GAP).

Описание каждой функции см. в отдельной статье (ссылки в колонке «Функция»).