Список контекстов

Компонент Список контекстов отображает дерево вложенных контекстов на основе маски контекста.

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

Несколько параметров фильтрации дают детальный и динамический контроль над тем, какие именно контексты будут отображаться пользователю. Следующие свойства (более подробно описанные ниже) можно использовать для создания точного подмножества контекстов для отображения пользователю.

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

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

Правила пригодности контекстов — это выражение пригодности, оцениваемое для каждого дочернего контекста Корневого элемента. Будут отображаться только контексты, в которых это выражение оценивается как True. В этом примере для отображения только неподключенных устройств используется выражение {.:status$connectionStatus} != 1, поскольку оно оценивается как True только для контекстов, в которых connectionStatus не равен 1, что указывает на то, что устройство не подключено.

Маска контекстов позволяет проводить дальнейшую фильтрацию, отображая только контексты, соответствующие указанной маске контекстов. Это свойство может динамически обновляться с помощью привязки таким образом, что контекстная маска будет devices.<current user>.devices.*, где <current user> — это пользователь, который в данный момент просматривает инструментальную панель.

Таблица Список фильтров может использоваться для создания предопределенных фильтров, которые пользователь может применить через раскрывающееся меню. В этом примере предположим, что описание каждого устройства также включает его местоположение с описаниями, такими как Server One Honolulu, Server Two Honolulu, Server Three Marseille, Server Four Marseille и т. д. В дополнение к фильтру по умолчанию «Все ресурсы» можно создать специальные фильтры, чтобы пользователь мог быстро фильтровать контексты с описаниями, содержащими слова «Honolulu» или «Marseille».

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

[?]

Компонент Список контекстов имеет следующие основные свойства и группы свойств, которые являются общими для всех компонентов:

Имя, Дополнительные свойства, Свойства контейнера, Стили, Прелоадер, События, Привязки, Кебаб меню.

Наследуемые переменные (Свойства)

Компонент Список контекстов внутренне основан на компоненте Data Table, поэтому он наследует его общие свойства.

Корневой элемент

Абсолютный контекстный путь, указывающий на контекст, который будет корневым узлом отображаемого контекстного дерева.

Переменная:

root

Записи:

1

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

Поле

Тип поля

Описание поля

root

String

Абсолютный контекстный путь к корневому узлу отображаемого контекстного дерева.

Выражение пригодности

Выражение, определяющее, появится ли данный контекст в списке контекстов. Действует так же, как и Выражение пригодности в серверных контекстах. Если выражение оценивается как True, контекст будет включен в список компонентов, в противном случае он будет исключен.

Переменная:

validity

Записи:

1

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

Поле

Тип поля

Описание поля

validity

String

Вычисляется как выражение пригодности для каждого контекста, соответствующего маске контекстов

Маска контекстов

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

Переменная:

mask

Записи:

1

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

Поле Имя

Тип поля

Описание поля

mask

String

Маска контекста

Список фильтров

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

Переменная:

filterList

Записи:

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

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

Поле

Тип поля

Описание поля

Имя

String

Имя фильтра для отображения пользователю

Настройки колонок

Data Table

Свойства, определяющие поведение фильтра:

  • Имя: - String - Имя столбца, включенного в фильтр.

  • Фиксированная колонка - String - Опции выбора для установки колонки как фиксированной Справа, Слева или Не установлено

  • Поведение текста заголовка - String - Опции, определяющие, как пользователь может видеть полный текст столбца.

    • Развернуть колонку - Пользователь может изменить ширину колонки.

    • Обрезать текст - Кнопка “Обрезать текст” появляется в длинных заголовках, позволяя отображать полный текст заголовка.

    • Перенос слов - текст заголовка будет переноситься

  • Перенос слов - String - Правило, применяемое при переносе текста в ячейке:

    • Не разделять - Разрывы происходят в естественных точках, например между словами или после дефиса.

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

    • Разделить слово - пытается сохранить слова без разрывов, перемещая их на следующую строку, но разрывает слово, если оно слишком длинное.

  • Видимая длина - Integer - Максимум символов для отображения в данном поле.

  • Горизонтальное выравнивание текста ячейки - String - Указывает, как содержимое ячейки таблицы должно быть выровнено по горизонтали. Возможные значения:

    • Слева

    • Центр

    • Справа

  • Горизонтальное выравнивание текста заголовка - String - Аналогично Горизонтальному выравниванию текста ячейки, но применяется специально для заголовков столбцов.

  • Вертикальное выравнивание текста ячейки - String - Указывает, как содержимое ячейки в таблице должно быть выровнено по вертикали. Возможные значения:

    • Внизу

    • Выравнивание по середине

    • Верх

  • Вертикальное выравнивание текста заголовка - String - Аналогично Вертикальному выравниванию текста ячейки, но применяется именно к заголовкам.

  • Сортировщик - Boolean - Определяет, может ли пользователь сортировать данные в таблице, нажимая на заголовки столбцов.

  • Предустановка сортировки - String - Определяет порядок сортировки по умолчанию для таблицы при ее загрузке. Возможны следующие значения:

    • По возрастанию

    • По убыванию

    • Не установлено

  • Фильтрация - String - Определяет, как будет фильтроваться указанный столбец. Возможные значения:

    • Отсутствует - К таблице не будет применяться фильтрация на основе значений указанного столбца.

    • Строка соответствия - Столбец будет отфильтрован на основе значений поля Строка соответствия. Будут отображаться только строки со значениями, которые содержат Строку соответствия в указанном столбце.

    • Фильтр - Таблица будет отфильтрована на основе строк таблицы данных Фильтр таблицы.

  • Фильтр таблицы - Таблица данных - Строки значений, которые будут применены в качестве фильтра к указанному столбцу.

    • Значение - Строка - Указывает значение для применения в качестве фильтра. Строки со значениями в указанном столбце, которые соответствуют этому значению, появятся в результатах фильтрации

    • Описание - Строка - Описание значения фильтра, для справки администратора.

    • Выбран - String - Указывает, что данная строка таблицы фильтров будет использоваться в фильтре. Если строка отключена, она будет игнорировать при фильтрации.

  • Строка соответствия - String - Если для параметра Фильтрация установлено значение Строка соответствия, будут отображаться только строки со значениями, содержащими Строку соответствия в указанном столбце.

  • Ширина - Integer - Указывает ширину столбца в пикселях. Значение по умолчанию 0 позволяет определить ширину автоматически

  • Видимый - Boolean - Определяет, будет ли столбец отображаться для пользователя.

  • Индекс - Integer - Указывает размещение колонки в порядке следования столбцов, где 0 - первая колонка, 1 - вторая и так далее.

Фильтр ключевых слов

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

Переменная:

keywordFilter

Записи:

1

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

Поле Имя

Тип поля

Описание поля

keywordFilter

String

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

Включить выбор нескольких строк

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

Переменная:

checkRows

Записи:

1

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

Поле

Тип поля

Описание поля

checkRows

Boolean

Включить выбор нескольких строк

Расположение компонента

Определяет расположение и размер новых окон (компонентов), открываемых пользователями, взаимодействующими с Контекстом.

Подробности о формате и поведении этого свойства см. в Расположение компонента.

Название: Переменная:

componentLocation

Записи:

1

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

Поле

Тип поля

Описание поля

componentLocation

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

Поля определены в Расположение компонента.

Общедоступные события

[?]

Унаследованные события

Компонент Список контекстов внутренне основан на компоненте Data Table, поэтому он наследует его общие события.

Пользовательские события

Нет пользовательских событий.

Was this page helpful?