Запрос

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

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

[?]

Выполнить запрос

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

Это действие выполняет запрос и отображает его результат пользователю. Различают простой и параметризованный запросы. Выполняются они следующим образом:

Для простого (не параметризованного) запроса:

  1. Запрос выполнен

  2. Результат запроса отображается пользователю при помощи  GUI процедуры

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

Для параметризованного запроса:

  1. Система

предлагает пользователю ввести параметры запроса

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

  2. Запрос выполнен.

  3. Результат запроса отображается пользователю при помощи GUI процедуры

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

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

Если во время выполнения запроса или параметризации возникают ошибки, они отображаются пользователю при помощи GUI процедуры показать ошибку.

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

execute

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

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

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

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

Параметры выполнения:

С результатом запроса расположение окна

С результатом запроса свойства инструментальных панелей

Запустить в режиме отладки

Это действие используется для выполнения запроса в режиме отладки. У него есть лишь одно отличие от действия Выполнить запрос: если запрос производит вывод отладки, отчет об отладке отображается пользователю сразу после выполнения запроса при помощи GUI процедуры редактировать данные в режиме реального времени. Когда пользователь закрывает отчет об отладке, отображается результат запроса.

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

debug

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

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

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

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

Настроить

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

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

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

Настроить

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

[?]

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

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

У этого контекста нет состояний. Он представлен иконкой .

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

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

Тип контекста: запросы

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

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

Путь контекста: users.USER_NAME.queries.QUERY_NAME

Контекстная маска: users.*.queries.*

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

[?]

Уровень

Описание

Отсутствует

Нет доступа.

Наблюдатель

Выполнение запроса.

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

Просмотр состояния.

Оператор

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

Менеджер

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

Инженер

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

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

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

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

[?]

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

Свойства запроса

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

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

childInfo

Записи:

1

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

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

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

Имя поля

Тип поля

Примечания

name

Строка

1 - 50 знаков

description

Строка

1 - 50 знаков

parameterized

Булевое


query

Строка

parameterized

Строка

outFormat

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

fields

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


disableEditableResult

Булевое


Результаты запроса

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

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

data

Записи:

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

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

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

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

динамический

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

[?]

Выполнить запрос

Выполняет запрос и возвращает его набор результатов.

Имя функции:

execute

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

Доступно на уровне прав доступа Отсутствует

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

1

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

Динамический, может меняться, когда редактируются свойства запроса.

Если запрос не параметризован, формат ввода пуст, т.е. возможно выполнить запрос без определения ввода.

Если запрос параметризован, формат ввода этой функции соотетствует формату, определенному в параметризаторе запроса.

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

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

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

динамический

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

[?]

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