ITessaViewRequest - интерфейс

Запрос к представлению ITessaView.

Definition

Пространство имён: Tessa.Views
Сборка: Tessa (в Tessa.dll) Версия: 4.1.3+7e2b1422f9b8c7c41fbbc4b151a843bed05319ab
C#
public interface ITessaViewRequest : IStorageCachePolicyProvider, 
	IViewConnectionInfo
Implements
IStorageCachePolicyProvider, IViewConnectionInfo

Заметки

Результат выполнения запроса возвращается как объект ITessaViewResult.

Для сериализации используйте объект TessaViewRequest.

Свойства

CalculateRowCounting Признак необходимости подсчёта количества строк. Для подсчёта строк представление должно содержать подмножество с именем RowCountSubset, осуществляющее такой подсчёт.
ConnectionAlias

Алиас строки подключения (из конфигурационного файла app.json на сервере) к БД, на которой будет выполняться представление вместо основной БД. В конфигурационном файле можно указать подключение к любой СУБД. Если, например, основная база - MSSQL, а подключение к базе Postgres, то запрос генерируется по правилам Postgres; если же СУБД какая-то другая (например, Oracle), то по умолчанию используются правила генерации для MSSQL.

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

Укажите null или пустую строку, если используется соединение по умолчанию. Также на алиас соединения влияет одноимённая настройка в метаинформации представления.

Для использования этой настройки требуется модуль лицензии "Кластеризация". Он включён в корпоративную лицензию Enterprise.


(Унаследован от IViewConnectionInfo)
ExecutionTimeout Таймаут выполнения запроса или null, если используется значение по умолчанию из настроек системы. Значение Zero соответствует неограниченному таймауту.
Info Дополнительная информация для расширений.
Parameters Значения параметров представления.
SkipErrorLogging Признак того, что не требуется создавать карточку ошибки при ошибке выполнения представления.
SortingColumns Колонки сортировки.
SubsetName Имя вызываемого подмножества представления. Равен null или пустой строке, если сабсет не указан, т.е. представление выполняется без подмножества в режиме Normal.
ViewAlias Алиас вызываемого представления. Не равен null или пустой строке.

Методы

EnsureCacheResolved Инициализирует объект-обёртку для всех значений, в т.ч. для вложенных объектов. Рекомендуется выполнять при создании заполненного объекта перед асинхронным обращением к его вложенным объектам.
(Унаследован от IStorageCachePolicyProvider)

Методы расширения

GetCriteriaName Возвращает имя единственного критерия CriteriaName для параметра запроса name или null, если параметр не найден или количество критериев отлично от одного.
(Определяется ViewsExtensions)
GetFirstParameterValue Возвращает первое значение параметра, заданного в запросе request, для параметра с именем name.
Если значение не задано или количество значений меньше одного, то будет выброшено исключение.
(Определяется ViewsExtensions)
GetFirstParameterValueT Возвращает значение первого критерия для указанного параметра.
(Определяется ViewsExtensions)
GetFirstParameterValueIsNull Возвращает признак того, что первое значение параметра, заданного в запросе request, для параметра с именем name равно null.
Если значение не задано или количество значений меньше одного, то будет выброшено исключение.
Метод учитывает операторы "пусто" IsNullCriteriaOperator и "не пусто" IsNotNullCriteriaOperator.
(Определяется ViewsExtensions)
GetParameterCriteriaCount Возвращает количество условий, заданных для параметра name.
(Определяется ViewsExtensions)
GetParameterValueCount Возвращает число заданных значений параметра.
Если параметр не задан или условий больше чем 1, то возвращает -1.
(Определяется ViewsExtensions)
GetSecondParameterValue Возвращает второе значение параметра, заданного в запросе request, для параметра с именем name.
Если значение не задано или количество значений меньше одного, то будет выброшено исключение.
(Определяется ViewsExtensions)
GetSingleParameterValue Возвращает единственное значение параметра, заданного в запросе request, для параметра с именем name.
Если значение не задано или количество значений не равно одному, то будет выброшено исключение.
(Определяется ViewsExtensions)
GetSingleParameterValueIsNull Возвращает признак того, что единственное значение параметра, заданного в запросе request, для параметра с именем name, равно null.
Если значение не задано или количество значений не равно одному, то будет выброшено исключение.
Метод учитывает операторы "пусто" IsNullCriteriaOperator и "не пусто" IsNotNullCriteriaOperator.
(Определяется ViewsExtensions)
ProvideDefaults

Заполняет параметры запроса по умолчанию в соответствии с метаинформацией представления.

Алиас метаинформации [!:IViewMetadata.Alias] должен соответствовать алиасу в запросе ViewAlias.


(Определяется ViewsExtensions)
SortDirection Получает порядок сортировки для столбца columnAlias в запросе request.
Возвращает строку "asc", если выполняется сортировка по возрастанию;
строку "desc", если выполняется сортировка по убыванию;
или null, если сортировка по столбцу не выполняется.
(Определяется ViewsExtensions)
SortedBy Проверяет наличие колонки columnAlias в списке колонок, по которым осуществляется сортировка в запросе request.
(Определяется ViewsExtensions)

См. также