Название

Значение свойства / Тип возвращаемого значения метода

Описание

Пример использования

Свойства (Properties)

Ancestor

TagItem

Предок тега (тег, на который ссылается экземпляр).

Методы доступа: get

var tagInst = (TagInstanceItem)RootItemModel.GetChildByNamePath("Объекты.Объект 1.Папка 1.Объект 1.Базовый тег 1");

WriteConsole(tagInst?.Ancestor?.FullName);

ArchiveTemplate

ArchiveTemplateItem

Шаблон архивирования. С помощью данного свойства можно задавать параметры шаблона архивирования.

Методы доступа: get

var arch = (ArchiveTemplateItem)tag.ArchiveTemplate;

ArchiveTemplateType

string

Тип шаблона архивирования. Имя необходимо задавать в виде строки. Если ранее тип шаблона архивирования не был задан, то при обращении к шаблону архивирования (ArchiveTemplate) будет возвращаться null.

Методы доступа: get/set

var tag = newObject.AddTagBase("tag");

// Привязка шаблона архивирования

tag.ArchiveTemplateType = "Библиотеки.Стандартная.Шаблоны архивирования.Шаблон архивирования";

var arch = (ArchiveTemplateItem)tag.ArchiveTemplate;

arch.Deadband = "1";

// Мертвая зона

tag.ArchiveTemplate.Deadband = "1";

// Максимальный период записи в секундах

tag.ArchiveTemplate.MaxWritePeriod = "2";

// Минимальный период записи в секундах

tag.ArchiveTemplate.MinWritePeriod = "3";

// Фраг для написания всех значений

tag.ArchiveTemplate.WriteAll = false;

// Флаг для написания значений только при изменении

tag.ArchiveTemplate.WriteByChange = true;

// Флаг для написания значений только при остановке работы

tag.ArchiveTemplate.WriteOnShutdown = true;

Historizing

bool

Необходимость архивирования значений экземпляра тега.

Методы доступа: get/set

this.WriteConsole("\nHistorizing - " + Tag.Historizing);

Scale

ScaleItem

Шкала. С помощью данного свойства можно задавать параметры шкалы.

Методы доступа: get

var scaleAI = (ScaleAIItem)tag.Scale;

ScaleType

string

Тип шкалы. Необходимо задавать в виде строки: Шкала/Шкала AI/Шкала DI. Если ранее тип шкалы не был задан, то при обращении к шкале (Scale) будет возвращаться null.

Если установить значение свойства в null, шкала элемента будет сброшена.

Тип шкалы можно задать с помощью имени и полного имени шкалы из библиотек, но стоит учесть, что поиск по имени может занять значительное время, так как поиск происходит во всех библиотеках, поэтому рекомендуется использовать полное имя. Также поиск по полному имени необходимо использовать, если у вас есть несколько шкал с одинаковым именем, чтобы гарантировать правильный выбор шкалы.

Методы доступа: get/set

var tag = (TagItem)newObject.AddTagBase("tag");        

//Работа с тегами и шкалами

//Для настройки шкалы тега используются следующие параметры:

tag.ScaleType = "Библиотеки.Стандартная.Шкалы.Шкала AI";

tag.Scale.Format = "<формат>";

tag.Scale.Unit = "<единица измерения>";

//Пример настройки шкалы AI:

var scaleAI = (ScaleAIItem)tag.Scale;

scaleAI.DelayTime = 1551;     // Задержка времени отклика

scaleAI.ActiveHi = false;     // Флаг активности высокого порога

scaleAI.UseHi = false;     // Флаг использования высокого порога

scaleAI.Hi = 41;     // Значение высокого порога

scaleAI.HiPriority = 14111;     // Приоритет события высокого порога

scaleAI.RateOfChangePriority = 3533;     // Приоритет события скорости изменения

scaleAI.RateOfChangeText = "rateTex5t";     // Текст события скорости изменения

scaleAI.HiText = "Hi5hi";     // Текст события высокого порога

scaleAI.Hysteresis = "775";     // Гистерезис

//Пример настройки шкалы DI:

var scaleDI = (ScaleDIItem)tag.Scale;

scaleDI.DelayTime = 11;     // Задержка перед обработкой изменения сигнала

scaleDI.EventOff = "Отключено";     // Текст события при отключении

scaleDI.EventOn = "Включено";     // Текст события при включении

scaleDI.EventOffPriority = 199;     // Приоритет события при отключении

scaleDI.EventOnPriority = 201;     // Приоритет события при включении

Методы (Methods)

Delete()

Удаление Шаблона архивирования

tag.Delete();

DeleteScaleType()

Удаление Шкалы

tag.DeleteScaleType();