docs

docs/docs/getting-started/request.md

@@ -1,6 +1,32 @@
----
+---
-sidebar_position: 2
+sidebar_position: 2
-tags: [Начало]
+tags: [Начало]
----
+---
-
+
-# Пишем запрос при помощи библиотеки "Fluent запросы"
+# Пишем запрос при помощи библиотеки "Fluent запросы"
+
+## Простейший запрос
+
+Любой запрос начинается с вызова функции `НовыйЗапрос` в качестве параметра которого необходимо указать источник выбираемых данных
+
+```bsl
+Запрос = СЗ_Запрос.НовыйЗапрос("Справочник.Номенклатура");
+```
+
+На этом этапе самого запроса, как объекта 1С, не существует. В переменной `Запрос` находится контекст (описание) запроса. По этому описанию будет позже сформирован реальный запрос к базе данных.
+
+## Материализация данных
+
+Чтобы получить данные по написанному запросу необходимо вызвать функцию материализации. Их две: `ВТаблицуЗначений` и `ВМассив`. При этом происходит выполнение запроса на сервере. Если запрос вызывается с клиента, то соответственно дополнительно происходит вызов сервера.
+
+```bsl
+ТаблицаЗначений = СЗ_Запрос.НовыйЗапрос("Справочник.Номенклатура")
+  .ВТаблицуЗначений();
+```
+
+Материализация данных в массив требует передачи имени выгружаемой в этот массив колонки запроса
+
+```bsl
+ТаблицаЗначений = СЗ_Запрос.НовыйЗапрос("Справочник.Номенклатура")
+  .ВМассив("Ссылка");
+```