Перейти к основному содержимому

Запросы (ЮТЗапросы)

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

Методы модуля


ЗначенияРеквизитов

Возвращает значения реквизитов ссылки

Параметры метода

  • Ссылка
    • ЛюбаяСсылка -
  • ИменаРеквизитов
    • Строка - Имена получаемых реквизитов, разделенные запятой. Важно, нельзя указывать реквизиты через точку.

Возвращает

Структура Из Произвольный - Значения реквизитов ссылки


ЗначениеРеквизита

Возвращает значение реквизита ссылки

Параметры метода

  • Ссылка
    • ЛюбаяСсылка -
  • ИмяРеквизита
    • Строка - Имя получаемого реквизита, можно указать путь к вложенному реквизиту через точку

Возвращает

Произвольный - Значение реквизита ссылки


Запись

Возвращает первую запись таблицы соответствующую условиям

Параметры метода

  • ИмяТаблицы
    • Строка - Имя таблицы базы
  • Предикат
    • Массив из см. ЮТФабрика.ВыражениеПредиката - Набор условий, см. ЮТПредикаты.Получить
    • ЮТФабрика.ВыражениеПредикатасм. ЮТФабрика.ВыражениеПредиката -
    • ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат
    • Неопределено - Проверит, что таблица не пустая

Возвращает

Структура - Содержит все данные записи, включая табличный части


СсылкаПоУсловиям

Возвращает первую ссылку на объект таблицы соответствующую условиям

Параметры метода

  • ИмяТаблицы
    • Строка - Имя таблицы базы
  • Предикат
    • Массив из см. ЮТФабрика.ВыражениеПредиката - Набор условий, см. ЮТПредикаты.Получить
    • ЮТФабрика.ВыражениеПредикатасм. ЮТФабрика.ВыражениеПредиката -
    • ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат
    • Неопределено - Проверит, что таблица не пустая

Возвращает

ЛюбаяСсылка - Ссылка на объект


Записи

Возвращает записи таблицы соответствующую условиям

Параметры метода

  • ИмяТаблицы
    • Строка - Имя таблицы базы
  • Предикат
    • Массив из см. ЮТФабрика.ВыражениеПредиката - Набор условий, см. ЮТПредикаты.Получить
    • ЮТФабрика.ВыражениеПредикатасм. ЮТФабрика.ВыражениеПредиката -
    • ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат
    • Неопределено - Проверит, что таблица не пустая

Возвращает

Массив из Структура - Найденные записи, включая табличный части


ЗначенияРеквизитовЗаписи

Возвращает значения реквизитов первой записи таблицы, соответствующей условиям

Параметры метода

  • ИмяТаблицы
    • Строка -
  • Предикат
  • ИменаРеквизитов
    • Строка - Имена получаемых реквизитов

Возвращает

Произвольный - Значение реквизита записи


ЗначениеРеквизитаЗаписи

Возвращает значение реквизита первой записи таблицы, соответствующей условиям

Параметры метода

  • ИмяТаблицы
    • Строка -
  • Предикат
  • ИмяРеквизита
    • Строка - Имя получаемого реквизита

Возвращает

Структура Из Произвольный - Значения реквизитов записи


ТаблицаСодержитЗаписи

Вернет признак содержит ли таблица записи удовлетворяющие переданным условиям

Параметры метода

  • ИмяТаблицы
    • Строка - Имя таблицы базы
  • Предикат
    • Массив из см. ЮТФабрика.ВыражениеПредиката - Набор условий, см. ЮТПредикаты.Получить
    • ЮТФабрика.ВыражениеПредикатасм. ЮТФабрика.ВыражениеПредиката -
    • ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат
    • Неопределено - Проверит, что таблица не пустая

Возвращает

Булево - Таблица содержит записи


КоличествоЗаписей

Возвращает количество записей таблицы удовлетворяющих переданным условиям

Параметры метода

  • ИмяТаблицы
    • Строка - Имя таблицы базы
  • Предикат
    • Массив из см. ЮТФабрика.ВыражениеПредиката - Набор условий, см. ЮТПредикаты.Получить
    • ЮТФабрика.ВыражениеПредикатасм. ЮТФабрика.ВыражениеПредиката -
    • ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат
    • Неопределено - Проверит, что таблица не пустая

Возвращает

Число - Количество записей


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

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

Параметры метода

  • ОписаниеЗапроса
    • ОписаниеЗапросасм. ОписаниеЗапроса -

Возвращает

ТаблицаЗначений - Результат запроса для сервера


РезультатПустой

Определяет, есть ли в результате записи

Параметры метода

  • ОписаниеЗапроса
    • ОписаниеЗапросасм. ОписаниеЗапроса -

Возвращает

Булево - Результат пустой


ОписаниеЗапроса

Описание простого запроса

Возвращает

Структура - Описание запроса:

  • ИмяТаблицы - Строка - Имя таблицы, из которой нужно получить данные
  • ВыбираемыеПоля - Массив из Строка - Выражения выбираемых полей
  • КоличествоЗаписей - Число - Ограничение количества выбираемых записейНеопределено - Ограничение количества выбираемых записей
  • Условия - Массив из Строка - Коллекция выражений условий, которые будут объединены через И
  • ЗначенияПараметров - Структура - Набор параметров запроса
  • Порядок - Массив из Строка - Поля сортировки

Примеры:

ОписаниеЗапроса = ЮТЗапросы.ОписаниеЗапроса();
ОписаниеЗапроса.ИмяТаблицы = "Справочник.Номенклатура";
ОписаниеЗапроса.ВыбираемыеПоля.Добавить("Ссылка");
ОписаниеЗапроса.ВыбираемыеПоля.Добавить("Наименование");
ОписаниеЗапроса.Условия.Добавить("Наименование = &Наименование");
ОписаниеЗапроса.ЗначенияПараметров.Вставить("Наименование", "Товар1");
ОписаниеЗапроса.Порядок.Добавить("Наименование");
Результат = ЮТЗапросы.РезультатЗапроса(ОписаниеЗапроса);
// Результат будет содержать записи номенклатуры с наименованием "Товар1",
// отсортированные по наименованию

ДвиженияДокумента

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

Параметры метода

  • Документ
    • ДокументСсылка -
  • ИмяРегистра
    • Строка - Короткое или полное имя регистра движений

Возвращает

Массив из Структура - Движения документа для клиента


СлучайнаяЗапись

Возвращает случайную ссылку на объект из информационной базы, удовлетворяющую заданным условиям отбора.

Параметры метода

  • МетаданныеОбъекта
    • ОбъектМетаданных - Явное указание объекта метаданных.
    • Произвольный - менеджер, например, Справочники.Номенклатура.
    • Строка - Полное имя объекта метаданных или менеджера, например, "Справочник.Номенклатура".
    • Тип - Тип искомого объекта
    • ОписаниеТипов - Тип искомого объекта
  • Отборы
    • Массив из см. ЮТФабрика.ВыражениеПредиката - Набор условий, см. ЮТПредикаты.Получить
    • ЮТФабрика.ВыражениеПредикатасм. ЮТФабрика.ВыражениеПредиката -
    • ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат
    • Структура - Простой отбор по полям "ключ-значение".
    • Соответствие - Простой отбор по полям "ключ-значение".
    • Неопределено - Отбор не используется.

Возвращает

ЛюбаяСсылка - Случайная ссылка