From cfc68d7757c079e6e894e1e2d4e08b1ebeffa6b5 Mon Sep 17 00:00:00 2001 From: Ilya Bushin Date: Fri, 18 Oct 2024 09:20:24 +0300 Subject: [PATCH] docs --- docs/docs/getting-started/request.md | 38 +++++++++++++++++++++++----- 1 file changed, 32 insertions(+), 6 deletions(-) diff --git a/docs/docs/getting-started/request.md b/docs/docs/getting-started/request.md index 01d7019..0084d7d 100644 --- a/docs/docs/getting-started/request.md +++ b/docs/docs/getting-started/request.md @@ -1,6 +1,32 @@ ---- -sidebar_position: 2 -tags: [Начало] ---- - -# Пишем запрос при помощи библиотеки "Fluent запросы" +--- +sidebar_position: 2 +tags: [Начало] +--- + +# Пишем запрос при помощи библиотеки "Fluent запросы" + +## Простейший запрос + +Любой запрос начинается с вызова функции `НовыйЗапрос` в качестве параметра которого необходимо указать источник выбираемых данных + +```bsl +Запрос = СЗ_Запрос.НовыйЗапрос("Справочник.Номенклатура"); +``` + +На этом этапе самого запроса, как объекта 1С, не существует. В переменной `Запрос` находится контекст (описание) запроса. По этому описанию будет позже сформирован реальный запрос к базе данных. + +## Материализация данных + +Чтобы получить данные по написанному запросу необходимо вызвать функцию материализации. Их две: `ВТаблицуЗначений` и `ВМассив`. При этом происходит выполнение запроса на сервере. Если запрос вызывается с клиента, то соответственно дополнительно происходит вызов сервера. + +```bsl +ТаблицаЗначений = СЗ_Запрос.НовыйЗапрос("Справочник.Номенклатура") + .ВТаблицуЗначений(); +``` + +Материализация данных в массив требует передачи имени выгружаемой в этот массив колонки запроса + +```bsl +ТаблицаЗначений = СЗ_Запрос.НовыйЗапрос("Справочник.Номенклатура") + .ВМассив("Ссылка"); +```