Обращение к справочникам 1С на клиенте: от базовых методов до продвинутых приёмов

Работа со справочниками — одна из самых частых задач при программировании в 1С:Предприятие. Однако многие разработчики сталкиваются с трудностями, когда нужно получить данные справочника именно на клиентской стороне, а не на сервере. В этой статье разберём все актуальные способы обращения к справочникам из клиентского кода: от простых методов платформы до оптимизированных запросов с учётом производительности.

Особенность клиентского контекста в 1С заключается в ограниченном доступе к базе данных. Здесь нельзя напрямую выполнять SQL-запросы или использовать серверные процедуры без вызова через ВыполнитьНаСервере(). Но это не значит, что работа со справочниками на клиенте невозможна — просто требуется правильный подход. Мы рассмотрим как стандартные методы (ПолучитьСсылку(), НайтиПоНаименованию()), так и менее очевидные приёмы с использованием менеджера значений и временных таблиц.

Статья будет полезна как начинающим разработчикам, которые только осваивают клиент-серверную архитектуру 1С, так и опытным специалистам, ищущим способы оптимизации кода. Все примеры приведены для актуальных версий платформы 8.3.20+ и протестированы на конфигурациях УТ 11, БП 3.0 и ЗУП 3.1.

1. Базовые методы работы со справочниками на клиенте

Начнём с самых простых и универсальных способов, которые работают в любом клиентском коде без дополнительных условий. Эти методы подходят для большинства типовых задач, когда нужно получить ссылку на элемент справочника или его реквизиты.

Самый распространённый способ — использование менеджера справочника. Он доступен через глобальный контекст и позволяет получать ссылки по уникальным идентификаторам или наименованиям. Например, чтобы найти элемент справочника "Номенклатура" по названию, достаточно одной строки:

СсылкаНаНоменклатуру = Справочники.Номенклатура.НайтиПоНаименованию("Ноутбук Dell XPS 15");

Если элемент не найден, метод вернёт Неопределено, поэтому всегда проверяйте результат. Для поиска по коду используйте аналогичный метод НайтиПоКоду(). Эти методы работают быстро, так как обращаются к кэшу метаданных, но имеют ограничение: они не возвращают полные данные элемента, а только ссылку.

• 🔹 Справочники.ИмяСправочника.ПолучитьСсылку(Ид) — получение ссылки по уникальному идентификатору (GUID)
• 🔹 Справочники.ИмяСправочника.НайтиПоНаименованию(Строка) — поиск по точному совпадению наименования
• 🔹 Справочники.ИмяСправочника.НайтиПоКоду(Строка) — поиск по точному совпадению кода
• 🔹 Справочники.ИмяСправочника.ПустаяСсылка() — получение пустой ссылки для сравнений

⚠️ Внимание: Методы НайтиПоНаименованию() и НайтиПоКоду() чувствительны к регистру и пробелам. Если в справочнике есть элемент с названием " Ноутбук " (с пробелами), а вы ищете "Ноутбук", метод вернёт Неопределено. Всегда нормализуйте строки перед поиском с помощью СтрЗаменить() или СокрЛП().

2. Получение данных справочника через ссылку

Когда у вас уже есть ссылка на элемент справочника (например, полученная через методы из предыдущего раздела), вы можете получить его реквизиты и табличные части прямо на клиенте. Для этого используется метод ПолучитьОбъект():

ОбъектНоменклатуры = СсылкаНаНоменклатуру.ПолучитьОбъект();
Сообщить(ОбъектНоменклатуры.Артикул); // Выведет значение реквизита "Артикул"

Важно понимать, что ПолучитьОбъект() загружает данные элемента в память клиента. Это означает:

• ✅ Данные доступны для чтения и модификации (если разрешено правами)
• ⚠️ Изменения объекта не сохранятся в базе, пока не вызвать Записать()
• ❌ Большие объекты (с множеством реквизитов или табличных частей) могут замедлить интерфейс

Для оптимизации используйте отложенную загрузку — указывайте только те реквизиты, которые действительно нужны:

ОбъектНоменклатуры = СсылкаНаНоменклатуру.ПолучитьОбъект(Истина, "Артикул,ЦенаПродажи");

В этом примере загрузятся только реквизиты Артикул и ЦенаПродажи, что ускорит выполнение кода. Если попытаться обратиться к незагруженному реквизиту, платформа вызовет исключение.

3. Работа с менеджером значений и временными таблицами

Когда нужно получить список элементов справочника (например, для отображения в форме или фильтрации), удобно использовать менеджер значений. Он позволяет создать коллекцию ссылок или объектов без обращения к серверу за каждым элементом отдельно.

Пример получения всех активных элементов справочника "Контрагенты":

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Контрагенты.Ссылка КАК Ссылка
|ИЗ
|   Справочник.Контрагенты КАК Контрагенты
|ГДЕ
|   Контрагенты.ПометкаУдаления = ЛОЖЬ";

РезультатЗапроса = Запрос.Выполнить();
Выборка = РезультатЗапроса.Выбрать();

СписокКонтрагентов = Новый СписокЗначений;
Пока Выборка.Следующий() Цикл
СписокКонтрагентов.Добавить(Выборка.Ссылка);
КонецЦикла;

Этот код выполняется на клиенте, но сам запрос отправляется на сервер. Чтобы минимизировать нагрузку:

• 📌 Используйте ИНДЕКСИРОВАТЬ ПО для часто фильтруемых полей
• 📌 Ограничивайте выборку условием ПЕРВЫЕ 100, если не нужны все записи
• 📌 Для больших справочников (>10 000 элементов) применяйте пагинацию

Для временного хранения данных на клиенте удобно использовать таблицу значений. Она позволяет манипулировать данными без постоянных обращений к серверу:

ТаблицаКонтрагентов = Новый ТаблицаЗначений;
ТаблицаКонтрагентов.Колонки.Добавить("Ссылка");
ТаблицаКонтрагентов.Колонки.Добавить("Наименование");
ТаблицаКонтрагентов.Колонки.Добавить("ИНН");

Для Каждого Ссылка Из СписокКонтрагентов Цикл
Строка = ТаблицаКонтрагентов.Добавить();
Строка.Ссылка = Ссылка;
Строка.Наименование = Ссылка.Наименование;
Строка.ИНН = Ссылка.ИНН;
КонецЦикла;

4. Выполнение серверных процедур с клиента

Когда стандартных методов недостаточно (например, нужно выполнить сложный запрос с joins или обновить множество элементов), приходится обращаться к серверу. Для этого используется конструкция ВыполнитьНаСервере() или ВызватьИсключение с обработкой на сервере.

Пример: получение списка номенклатуры с ценами и остатками:

Процедура ПолучитьНоменклатуруСОстаткамиНаСервере()
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка,
|   Номенклатура.Наименование КАК Наименование,
|   Номенклатура.Артикул КАК Артикул,
|   РегистрыНакопления.ОстаткиТоваровОрганизаций.КоличествоОстаток КАК Остаток
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|       ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ОстаткиТоваровОрганизаций.Остатки(
|           &ТекущаяДата,
|           Организация = &Организация
|       ) КАК РегистрыНакопления.ОстаткиТоваровОрганизаций
|       ПО Номенклатура.Ссылка = РегистрыНакопления.ОстаткиТоваровОрганизаций.Номенклатура
|ГДЕ
|   Номенклатура.ПометкаУдаления = ЛОЖЬ";

Запрос.УстановитьПараметр("ТекущаяДата", ТекущаяДата());
Запрос.УстановитьПараметр("Организация", Организация);

Возврат Запрос.Выполнить().Выгрузить();
КонецПроцедуры

// Вызов с клиента
Результат = ВыполнитьНаСервере(Новый ОписаниеОповещения("ПолучитьНоменклатуруСОстаткамиНаСервере", ЭтотОбъект));

Ключевые моменты при работе с ВыполнитьНаСервере():

⚠️ Внимание: При частом использовании ВыполнитьНаСервере() в циклах (например, для обработки каждой строки таблицы) производительность резко падает из-за сетевых задержек. В таких случаях лучше передавать на сервер пакет данных (массив или таблицу значений) и обрабатывать его единоразово.

5. Оптимизация и типичные ошибки

Неоптимальный код при работе со справочниками на клиенте может приводить к "подвисаниям" интерфейса или даже ошибкам блокировки. Рассмотрим наиболее распространённые проблемы и способы их решения.

Ошибка 1: Чрезмерное использование ПолучитьОбъект() в циклах

Если вам нужно получить данные по 100 ссылкам, не делайте так:

// ПЛОХО: 100 обращений к серверу!
Для Каждого Ссылка Из СписокСсылок Цикл
Объект = Ссылка.ПолучитьОбъект();
// ... обработка
КонецЦикла;

Лучше загрузите все нужные данные одним запросом:

// ХОРОШО: одно обращение к серверу
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ РАЗРЕШЕННЫЕ Ссылка.Артикул, Ссылка.Цена КАК Цена ИЗ Справочник.Номенклатура КАК Ссылка ГДЕ Ссылка В(&СписокСсылок)";
Запрос.УстановитьПараметр("СписокСсылок", СписокСсылок);
Результат = Запрос.Выполнить().Выгрузить();

Ошибка 2: Игнорирование кэша метаданных

Платформа 1С кэширует структуру метаданных, но не всегда данные справочников. Если вы многократно обращаетесь к одним и тем же элементам, храните их в клиентском кэше (например, в переменной модуля или в Соответствие):

КэшНоменклатуры = Новый Соответствие;
Функция ПолучитьНоменклатуруИзКэша(Ид)
Если НЕ КэшНоменклатуры.СодержитКлюч(Ид) Тогда
КэшНоменклатуры.Вставить(Ид, Справочники.Номенклатура.ПолучитьСсылку(Ид));
КонецЕсли;
Возврат КэшНоменклатуры.Получить(Ид);
КонецФункции

Ошибка 3: Блокировки при длительных операциях

Если клиентский код долго выполняет операции со справочниками (например, формирует большой отчёт), используйте ПрерватьОбработку() для проверки отмены пользователем:

Для Сч = 1 По 1000 Цикл
Если ПрерватьОбработку() Тогда
Прервать;
КонецЕсли;
// ... обработка
КонецЦикла;

Использовать пакетные запросы вместо цикла с ПолучитьОбъект()|Кэшировать часто используемые ссылки|Ограничивать выборки условием ПЕРВЫЕ N|Использовать асинхронные вызовы для долгих операций|Проверять ПрерватьОбработку() в циклах-->

6. Продвинутые приёмы: динамические списки и расширения

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

Пример создания динамического списка для справочника "Сотрудники":

ДинамическийСписок = ДинамическиеСписки.СоздатьСписок();
ДинамическийСписок.ИсточникДанных = Новый ИсточникДанныхСписка(Справочники.Сотрудники);
ДинамическийСписок.ПараметрыОтбора.Добавить("Организация", Организация);
ДинамическийСписок.ПараметрыПорядка.Добавить("Наименование", НаправлениеСортировки.Возр);

ЭлементыФормы.СписокСотрудников.Список = ДинамическийСписок;

Преимущества динамических списков:

• 🚀 Автоматическая подгрузка данных при прокрутке
• 🔍 Поддержка фильтрации и сортировки без перезагрузки
• 📊 Оптимизированная работа с большими объёмами данных

Для расширения функциональности справочников без изменения конфигурации используйте расширения. Например, можно добавить новый реквизит "Примечание" ко всем справочникам:

&НаКлиенте
Процедура ДобавитьРеквизитКСправочникам()
Для Каждого Справочник Из Метаданные.Справочники Цикл
Если НЕ Справочник.Реквизиты.Найти("Примечание") Тогда
НовыйРеквизит = Справочник.Реквизиты.Добавить();
НовыйРеквизит.Имя = "Примечание";
НовыйРеквизит.Тип = Новый ОписаниеТипов("Строка", Новый КвалификаторыСтроки(250));
КонецЕсли;
КонецЦикла;
КонецПроцедуры

⚠️ Внимание: Изменение метаданных через расширения может привести к конфликтам при обновлении конфигурации. Всегда тестируйте такие изменения на копии базы.

7. Работа с иерархическими справочниками

Иерархические справочники (например, "Номенклатура" с группами и элементами) требуют особого подхода. На клиенте можно получать не только отдельные элементы, но и целые ветки дерева.

Пример рекурсивного обхода иерархии:

Процедура ОбойтиГруппуНоменклатуры(Группа, Уровень = 0)
Если Уровень > 5 Тогда // Ограничение по глубине рекурсии
Возврат;
КонецЕсли;

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Элементы.Ссылка КАК Ссылка,
|   Элементы.ЭтоГруппа КАК ЭтоГруппа
|ИЗ
|   Справочник.Номенклатура КАК Элементы
|ГДЕ
|   Элементы.Родитель = &Группа";

Запрос.УстановитьПараметр("Группа", Группа);
Результат = Запрос.Выполнить();

Пока Результат.Следующий() Цикл
Если Результат.ЭтоГруппа Тогда
ОбойтиГруппуНоменклатуры(Результат.Ссылка, Уровень + 1); // Рекурсия
Иначе
// Обработка элемента
Сообщить(Результат.Ссылка.Наименование);
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Для отображения иерархии в форме используйте элемент ПолеДереваЗначений:

Дерево = ЭлементыФормы.ДеревоНоменклатуры;
КорневойУзел = Дерево.Элементы.Добавить(, "Корневая группа");
ЗаполнитьДеревоНоменклатуры(КорневойУзел, Справочники.Номенклатура.НайтиПоНаименованию("Товары"));

Чтобы избежать зависаний при работе с глубокой иерархией:

• 🛑 Ограничивайте глубину рекурсии (как в примере выше)
• 🔄 Используйте асинхронную загрузку для больших веток
• 📁 Кэшируйте уже загруженные узлы дерева

FAQ: Ответы на частые вопросы

ДанныеНовогоЭлемента = Новый Структура();
ДанныеНовогоЭлемента.Вставить("Наименование", "Новый товар");
ДанныеНовогоЭлемента.Вставить("Артикул", "ART-12345");

Ссылка = ВыполнитьНаСервере(Новый ОписаниеОповещения("СоздатьЭлементНоменклатуры", ЭтотОбъект, ДанныеНовогоЭлемента));

// На сервере
Функция ПолучитьВсеЭлементыСправочника()
Запрос = Новый Запрос("ВЫБРАТЬ Ссылка, Наименование ИЗ Справочник.Номенклатура");
Возврат Запрос.Выполнить().Выгрузить();
КонецФункции

// На клиенте
СписокНоменклатуры = ВыполнитьНаСервере(Новый ОписаниеОповещения("ПолучитьВсеЭлементыСправочника", ЭтотОбъект));

Сообщить(Справочники.Номенклатура.НайтиПоНаименованию("Товар1").Наименование);

Процедура ОбновитьЦенуНоменклатурыНаСервере(Ссылка, НоваяЦена) Экспорт
Если НЕ ПраваДоступа.ПроверкаПрав("РедактированиеЦенНоменклатуры") Тогда
ВызватьИсключение "Недостаточно прав для изменения цен";
КонецЕсли;

Объект = Ссылка.ПолучитьОбъект();
Объект.Цена = НоваяЦена;
Объект.Записать();
КонецПроцедуры

// Вызов с клиента
ВыполнитьНаСервере(Новый ОписаниеОповещения("ОбновитьЦенуНоменклатурыНаСервере", ЭтотОбъект, СсылкаНаТовар, 1500));

Ссылка = Справочники.Номенклатура.ПолучитьСсылку(Новый УникальныйИдентификатор("123e4567-e89b-12d3-a456-426614174000"));
Объект = Ссылка.ПолучитьОбъект(); // Теперь можно читать/изменять реквизиты