Группа устройств

Этот контекст предоставляет Вам доступ к одной группе и позволяет ею управлять.

Уникальные действия

[?]

Создать датчик статуса группы

Это действие позволяет создать датчик, который будет отображать статус группы, то есть совокупный статус всех участников группы. Статус группы рассчитывается с использованием двух параметров: Выражения и Начального значения.  

Выражение статуса группы вычисляется для каждого контекста члена группы. Оно должно включать в себя две ссылки:

  • {env/previous} - ссылка, относящаяся к результату предыдущего подсчета

  • ссылка на данные текущего контекста, например {.:status$connectionStatus}

Во время первой оценки, {env/previous} превратится в Начальное значение.  

Последовательность действий:

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

  2. Выражение статуса группы составляется на основании выше приведенных данных, после чего создается новый датчик.

  3. Отображается уведомление, указывающее на имя нового датчика.  

Имя действия:

createStatusTracker

Иконка действия:

Не интерактивный режим:

не поддерживается

Права доступа:

Доступно на уровне с правами доступа для Менеджера.  

Настроить группу

(действие по умолчанию)

Это действие используется для редактирования свойств Группы.

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

Тип действия:

настроить

Создать в группе

Это действие используется для создания нового объекта и добавления его в группу сразу же после создания. Тип объекта совпадает с типом группы, например, Тревога для Группы тревог и пр.

Поток действия:

1. Запустите действие создать из контекста "контейнера", соответствующего группе, например, контекст тревог администратора для Группы тревог Администратора.

2. Добавить только что созданный объект в группу.

Имя действия:

create

Иконка действия:

Не интерактивный режим:

Не поддерживается

Права доступа:

Доступно на уровне с правами доступа для Наблюдателя.

Создать вложенную группу

Это действие используется для создания вложенной группы внутри данной группы.

Имя действия:

createNestedGroup

Иконка действия:

Права доступа:

Доступно на уровне прав доступа для Менеджера

Реплицировать или добавить в группу

Это действие по перетаскиванию мышью, которое принимает контексты того же типа, что и члены группы, т.е. контексты пользователя для групп Пользователя и пр. Логика данного действия совершенно отличается в двух случаях:

  • Когда принятый контекст не является членом данной группы.

  • Когда принятый контекст уже является членом группы.

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

Во втором случае, это действие ведет себя как действие реплицировать, т.е. выполняет реплицирование конфигурации членов группы во все остальные члены группы.  

Это действие очень удобно для добавления новых членов группы. Новые члены добавляются путем перетаскивания мышью на контекст Группы.

Тип действия:

перетаскивание мышью

Имя действия:

replicateOrAdd

Не интерактивный режим:

Не поддерживается

Права доступа:

Доступно на уровне с правами доступа для Оператора.

Конвертировать динамическую группу в статическую

Это действие добавляет каждый дочерний узел динамической группы как статический дочерний узел в ту же группу так, чтобы позднее его можно было индивидуально удалить. Когда действие выполнено, выражение действительности группы опустошается (emptied) так, чтобы у него больше не было данамических дочерних узлов.

Достаточно просто создать группу объектов, соответствующих определенным критериям:

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

  • преобразуйте группу в статическую (static);

  • добавьте или удалите определенные объекты так, чтобы они точно соответствовали Вашей группе.

Имя действия:

convertToStatic

Не интерактивный режим:

Не поддерживается

Права доступа:

Доступно на уровне с правами доступа для Инженера.

Общие действия

[?]

Удалить, редактировать права доступа, просмотр событий, поиск/фильтрация, показать статус

Состояния и иконки контекста

Иконка

Код

Состояние

0

Обычная группа

1

Группа, которая выполняет автоматическую репликацию

Дополнительная информация

Информация о контексте

Тип контекста: группа

Имя контекста: предоставляется пользователем

Описание контекста: предоставляется пользователем

Путь контекста: "usergroups.GROUP_NAME" для группы пользователя, "users.USER_NAME.devgroups.GROUP_NAME" для группы устройства

Контекстные маски: "usergroups.*" для групп пользователя, "users.*.devgroups.*" для групп устройства

Права доступа к контексту

[?]

Уровень

Описание

Отсутствует

Нет доступа.

Наблюдатель

Просмотр списка членов группы.

Мониторинг основных событий.

Просмотр статуса.

Доступ к списку членов группы не означает доступ к самим членам группы. См. подробности в Права доступа к членам группы.

Оператор

Просмотр конфигурации.

Управление членством группы.

Менеджер

Конфигурация и удаление группы.

Инженер

Те же, что у Менеджера.

Администратор

Те же, что у Менеджера.

Общие переменные (свойства)

[?]

Общие переменные: groupMembership (членство группы), validity (пригодность), activeAlerts (активные тревоги)

Свойства

См описание переменной и ее полей здесь.

Имя переменной:

childInfo

Записи:

1

Права доступа:

Доступно для чтения на уровне с правами доступа для Наблюдателя, доступно для записи для Менеджера.

Формат записи:

Имя поля

Тип поля

Примечания

name

Строка

1 - 50 знаков

description

Строка

1 - 50 знаков

autoReplication

Булевое


hideMembers

Булевое

validityExpression

Строка

validityListeners

Таблица данных

Статус группы

См. описание переменной и ее полей здесь.

Имя переменной:

groupStatus

Записи:

1

Права доступа:

Доступно для чтения на уровне с правами доступа для Наблюдателя, доступно для записи для Менеджера.

Формат записи:

Имя поля

Тип поля

Примечание

enabled

Булевое


variable

Строка


expression

Строка


statuses

Таблица данных

Опции копирования

См. описание переменной и ее полей здесь.

Имя переменной:

replication

Записи:

0...не ограничено

Права доступа:

Доступно для чтения на уровне с правами доступа для Наблюдателя, доступно для записи для Менеджера.

Формат записи:

Имя поля

Тип поля

Примечания

variable

Строка

description

Строка

replicate

Булевое

useMaster

Булевое

master

Строка

Статические члены группы

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

Отметим, что определенные статические члены группы могут также появляться в списке Пригодности (например, соответствовать выражению пригодности динамической группы).

Имя переменной:

staticMembers

Записи:

0...не ограничено.

Права доступа:

Доступно для чтения на уровне прав доступа Отсутствует

Формат записи:

Имя поля

Тип поля

Примечания

context

Строка

Путь контекста статического члена группы.

Статус членов группы

Эта переменная показывает отдельные статусы всех членов группы. Эти отдельные статусы используются для расчета собранных статусов группы.

Имя переменной:

memberStatus

Записи:

0... не ограничено.

Права доступа:

Доступно для чтения на уровне с правами доступа для Наблюдателя.

Формат записи:

Имя поля

Тип поля

Примечания

context

Строка

Путь контекста члена группы.

status

Строка

Строка статуса члена группы.

Общие функции

[?]

Добавить член

Добавляет новый контекст члена в группу.

Имя функции:

add

Права доступа:

Доступно на уровне с правами доступа для Оператора.

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

context

Строка

Путь контекста для добавления.

Записи вывода:

0

Формат вывода:

нет

Удалить член

Удаляет контекст члена из группы.

Имя функции:

remove

Права доступа:

Доступно на уровне с правами доступа для Оператора.

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

context

Строка

Путь контекста для удаления.

Записи вывода:

0

Формат вывода:

нет

Вызвать функцию для членов группы

Вызывает одну и ту же функцию контекста из каждого контекста члена.

Имя функции:

call

Права доступа:

Доступно на уровне с правами доступа для Оператора.

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

function

Строка

Имя функции для вызова.

parameters

Строка

Параметры ввода функции.

Записи вывода:

0...не ограничено

Формат вывода:

Имя

Тип

Описание

context

Строка

Путь контекста.

successful

Boolean

Указывает, прошло ли выполнение успешно.

error

Строка

Текст сообщения об ошибке, если выполнение неуспешно.

return

Таблица данных

Вывод функции, если выполнение успешно.

Общие события

[?]

Общие события: info (информация), contextStatusChanged (статус изменен)