Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Свойства

Begin

Хранит значение, соответствующее началу интервала, указанному в редакторе. Тип значения – уведомляющий timestamp.

End

Хранит значение, соответствующее концу интервала, указанному в редакторе. Тип значения – уведомляющий timestamp.

Error

Текст ошибки, возникшей при указании границ интервала. Тип значения – уведомляющий string.

Если значением свойства является не пустая строка, то редактор интервала времени будет подсвечен красной рамкой, во всплывающей подсказке отобразится сообщение об ошибке, а текст этой ошибки будет записан в качестве значения свойства Error.

Если указать в качестве начала интервала значение, большее или равное значению окончания интервала, возникнет ошибка.

Проверить интервал (pValidate)

Ссылка на Обработчик события, которая активируется при каждом изменении границ интервала времени в редакторе. По умолчанию выполняет проверку, что начало интервала времени наступает раньше его окончания.

Вы можете изменить проверку интервала по умолчанию, для этого:

  1. Создайте обработчик события. В этом обработчике можно получить аргументы возникшего события – начало и конец интервала времени, которые введены в редакторе интервала времени. Аргументы будут представлять собой JSON-объект вида {"begin":<начало интервала>,"end":<окончание интервала>}. Чтобы получить аргументы возникшего события, в событии Invoked используйте код на языке JavaScript:

    var interval = JSON.parse(Args.Get());

    В результате в переменную interval будет записан JSON-объект. Этот объект содержит два свойства: begin – метка времени начала интервала и end – метка времени окончания интервала. Значения этих свойств следует использовать при проверке значений интервала времени, введенных в редакторе.

  2. Чтобы проверять значения интервала времени, создайте собственную функцию на языке Alpha.Om как описано в документации на Alpha.HMI → Руководство пользователя → Разработка мнемосхем → Действия с объектами и экранными формами → Просмотр характеристик → Функции объектов → Создание собственных функций. В качестве типа возвращаемого значения функции выберите void. Входными параметрами этой функции будут являться границы интервала, введенные в редакторе, поэтому в качестве аргументов укажите две переменные типа timestamp. Пусть эта функция называется CheckFunction, а аргументы – BeginDate и EndDate. В этой функции можно проверять, например, что начальная граница интервала в редакторе наступает не ранее 01 января 2020 г. Тогда можно использовать следующий код, написанный на языке Alpha.Om:

    dateT: uint8 = DateTime.Parse("31.12.2019 23:59:59");
    if(BeginDate < dateT)
    {
     MyIntervalEditor.Error = "Начало интервала не ранее 01 января 2020 г.";
    }

    В этом коде использована функция DateTime.Parse, которая преобразует необходимую дату в метку времени. Подробнее об этой функции написано в документации на Alpha.Om → Функции → Функции обработки времени → Parse. Затем эту метку времени можно сравнить с началом интервала из редактора интервала времени. Если в редакторе введена начальная граница интервала, которая наступает раньше 01 января 2020 г., то в свойство Error редактора интервала времени будет записан текст ошибки.

  3. Вернитесь в обработчик события, созданный на шаге 1. В коде события Invoked вызовите созданную функцию CheckFunction, в качестве входных параметров этой функции используйте свойства JSON-объекта: CheckFunction(interval.begin,interval.end);.
  4. В свойстве Проверить интервал редактора интервала времени сошлитесь на обработчик события, созданный на шаге 1.
  5. Теперь в редакторе интервала времени будет выполняться проверка того, что начальная граница интервала наступает не раньше 01 января 2020 г. Каждый раз, когда начальная граница в редакторе будет указана неверно, будет появляться сообщение об ошибке.

Интервал был изменен (pIntervalChanged)

Ссылка на команду, выполняемую при изменении границ интервала.

Выполнено смещение интервала (pShiftCompleted)

Ссылка на команду, выполняемую только при изменении границ интервала с помощью кнопок Перейти к предыдущему интервалу времени, Перейти к следующему интервалу времени.

Тема оформления (init_Theme)

Ссылка на экземпляр Тема оформления, который позволяет менять тему оформления редактора: шрифты, цвет текста, фона и т.п..