Alpha.Community

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

Блокировка и подавление событий

Чтобы отключить отображение уведомлений о событиях в оперативном режиме, используйте компонент Менеджер алармов для блокировки или подавления событий.

При подавлении источник данных прекращает уведомлять клиентов о событиях, но продолжает сохранять их в историю.

При блокировке источник данных прекращает формировать уведомления и не сохраняет события в историю.

Отображение уведомлений можно восстановить в любой момент, отменив подавление или блокировку.

Подавление и блокировка применяются:

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

Подробнее о свойствах, функциях и событиях компонента Менеджер алармов см. в справочном руководстве.

Как настроить блокировку и подавление событий (Демо-проект)

В данном примере (скачать его можно здесь) показано, как настроить и использовать компонент Менеджер алармов для:

  • блокировки зон событий и вывода результата;
  • подавления зон событий на заданный интервал времени;
  • получения текущего состояния блокировки и подавления по зонам;
  • снятия блокировки и подавления.

Для работы с проектом-примером в проект уже должен быть добавлен объект типа Источник AP, с которым вы планируете взаимодействовать. Для получения подробной информации о настройке и подключении источника данных обратитесь к разделу Подключение к источнику.

Подготовка компонента Менеджер алармов

  1. Добавьте на форму компонент Менеджер алармов.
  2. В свойствах компонента в поле Источник укажите ссылку на ApSource_1. Для этого нажмите правой кнопкой мыши по свойству Источник → Сослаться → ApSource_1.

Блокировка зон событий

  1. Добавьте на форму следующие компоненты:

    1. Поле ввода с именем edit_BlockZones для ввода имён блокируемых зон в виде JSON-массива.
    2. Текст с именем text_BlockResult для отображения результата блокировки.

    3. Кнопка с именем btn_BlockZones и задайте в свойстве Текст подпись Заблокировать зоны.

  2. В обработчике события ButtonPressed кнопки btn_BlockZones укажите код:

    ApAlarmManager_1.SetAreaDisabled(edit_BlockZones.Text, true);
  3. В обработчике события SetAreaDisabledFinished компонента Менеджер алармов укажите код:

    text_BlockResult.Text = result;

После нажатия кнопки зоны, указанные в edit_BlockZones, будут заблокированы. В компоненте text_BlockResult появится JSON с результатом операции по каждой зоне.

Подавление зон событий на заданное время

  1. Добавьте на форму следующие компоненты:
    1. Поле ввода с именем edit_SuppressZones для ввода имён подавляемых зон.

    2. Текст с именем text_SuppressResult для отображения результата подавления.

    3. Кнопка с именем btn_SuppressZones и задайте в свойстве Текст подпись Подавить зоны.

  2. В обработчике события ButtonPressed кнопки btn_SuppressZones запишите:

    // Подавляем зоны на 1 час от текущего момента
    SuppressUntil: var = DateTime.ToUtc(DateTime.Now()) + 3600;
    ApAlarmManager_1.SetAreaSuppressed(edit_SuppressZones.Text, true, SuppressUntil);
  3. В обработчике события SetAreaSuppressedFinished компонента Менеджер алармов запишите:

    text_SuppressResult.Text = result;

После нажатия кнопки зоны, указанные в edit_SuppressZones, будут подавлены на один час. Чтобы подавить зоны бессрочно, передайте в качестве третьего параметра значение 0.

Получение состояния блокировки и подавления

  1. Добавьте на форму следующие компоненты:
    1. Поле ввода с именем edit_StateZones для ввода имён зон, состояние которых нужно проверить.

    2. Текст с именем text_StateResult для отображения результата.

    3. Кнопка с именем btn_GetState и задайте в свойстве Текст подпись Получить состояние.

  2. В обработчике события ButtonPressed кнопки btn_GetState запишите:

    ApAlarmManager_1.GetAreaState(edit_StateZones.Text);
  3. В обработчике события GetAreaStateFinished компонента Менеджер алармов запишите:

    text_StateResult.Text = result;

После нажатия кнопки в компоненте text_StateResult появится JSON с текущим состоянием блокировки и подавления для каждой из указанных зон.

Снятие блокировки зон

  1. Добавьте компонент Кнопка с именем btn_UnblockZones и задайте в свойстве Текстподпись Снять блокировку.
  2. В обработчике события ButtonPressed кнопки btn_UnblockZones запишите:

    ApAlarmManager_1.SetAreaDisabled(edit_BlockZones.Text, false);
    

После нажатия кнопки блокировка будет снята с зон, указанных в поле edit_BlockZones. Результат отобразится в компоненте text_BlockResult.

Снятие подавления зон

  1. Добавьте компонент Кнопка с именем btn_UnsuppressZones и задайте в свойстве Текст подпись Снять подавление.
  2. В обработчике события ButtonPressed кнопки btn_UnsuppressZones запишите:

    ApAlarmManager_1.SetAreaSuppressed(edit_SuppressZones.Text, false, 0);

После нажатия кнопки подавление будет снято с зон, указанных в поле edit_SuppressZones. Результат отобразится в компоненте text_SuppressResult.