Как обратиться к справочнику в 1С

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

Ошибки при обращении к справочникам — одна из самых частых причин неработающих доработок: неверное имя справочника, обращение к несуществующему реквизиту, попытка получить значение из пустой ссылки. Ниже разобраны рабочие способы обращения с примерами кода, критериями выбора и методами проверки результата.

Как открыть справочник в пользовательском интерфейсе

В типовых конфигурациях (1С:Бухгалтерия, Управление торговлей, ЗУП) справочники разнесены по функциональным разделам. Например, «Номенклатура» обычно находится в разделе «Склад» или «НСИ и администрирование», «Контрагенты» — в разделе «Продажи» или «Справочники». Точное расположение зависит от конфигурации и её версии, поэтому универсальный путь — поиск.

Быстрый способ найти нужный справочник — строка поиска в верхней части окна (в тонком клиенте она вызывается через меню или начинает работать при вводе в поле поиска по меню). Введите название, например «склады», и система покажет подходящие объекты. Если поиск по меню отключён или нужного пункта нет, откройте полный список объектов: главное меню → «Все функции» → раздел «Справочники». Команда «Все функции» может быть скрыта — тогда её включают через «Сервис» → «Параметры» → флажок «Отображать команду "Все функции"».

1. 1
   Откройте главное меню и выберите «Все функции» (при необходимости включите команду в параметрах).
2. 2
   В дереве объектов раскройте ветку «Справочники» и найдите нужный по имени.
3. 3
   Дважды щёлкните по имени — откроется форма списка.
4. 4
   Используйте поиск по наименованию, отборы и сортировку, чтобы найти конкретный элемент.
5. 5
   Откройте карточку элемента двойным щелчком для просмотра или редактирования.

Если справочник не отображается ни в разделах, ни в «Все функции», проверьте права: у пользователя может не быть роли на просмотр этого объекта. Это штатное ограничение, а не ошибка программы — обратитесь к администратору за назначением прав.

Обращение к справочнику из встроенного языка: базовый синтаксис

Программный доступ к любому справочнику начинается с менеджера объекта: Справочники.ИмяСправочника. Имя — это не синоним, который видит пользователь, а имя объекта в конфигураторе. Например, справочник с синонимом «Физические лица» может называться в метаданных ФизическиеЛица. Уточнить имя можно в конфигураторе в дереве метаданных (ветка «Справочники») или через синтакс-помощник.

Менеджер предоставляет методы поиска и создания. Основные из них: НайтиПоКоду(), НайтиПоНаименованию(), НайтиПоРеквизиту(), Выбрать(), СоздатьЭлемент(), ПустаяСсылка(). Все методы поиска возвращают ссылку на элемент; если элемент не найден — пустую ссылку, которую обязательно нужно проверять.

// Поиск контрагента по наименованию
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");

Если НайденныйКонтрагент.Пустая() Тогда
    Сообщить("Контрагент не найден");
Иначе
    ИНН = НайденныйКонтрагент.ИНН; // обращение к реквизиту через точку
КонецЕсли;

Обращение к реквизитам элемента выполняется через точку от ссылки: Ссылка.Наименование, Ссылка.ИНН. Важно понимать: при таком обращении платформа неявно выполняет запрос к базе и получает объект целиком. В циклах по тысячам элементов это приводит к заметному падению производительности — там правильнее использовать запрос.

Поиск элементов: по коду, наименованию и реквизиту

Метод НайтиПоКоду("000000123") ищет по точному совпадению кода. Учтите: код может быть строковым, и тогда важны ведущие нули и длина — «123» и «000000123» это разные значения. Для числовых кодов с автонумерацией платформа сама управляет форматом, но при переносе данных из других систем расхождения форматов — частая причина «ненайденных» элементов.

Метод НайтиПоНаименованию("Текст", Истина) со вторым параметром Истина ищет точное совпадение, без него — по началу строки. Точный поиск надёжнее, но чувствителен к лишним пробелам и регистру в зависимости от СУБД. Если наименования не уникальны, метод вернёт первый попавшийся элемент — для таких случаев безопаснее поиск по уникальному реквизиту, например по ИНН для контрагентов: Справочники.Контрагенты.НайтиПоРеквизиту("ИНН", "7707083893").

Для иерархических справочников (папки и элементы) методы поиска принимают дополнительные параметры: родителя и владельца. Если искать элемент без указания родителя, можно получить не тот объект, когда в разных папках лежат одноимённые элементы.

Обращение к справочнику через запрос

Запрос — основной инструмент массовой выборки. Он выполняется на стороне сервера СУБД, выбирает только нужные поля и не создаёт объекты в памяти. Для отчётов, обработок и обменов это стандартный подход.

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

Результат = Запрос.Выполнить().Выбрать();
Пока Результат.Следующий() Цикл
    Сообщить(Результат.Код + " — " + Результат.Наименование);
КонецЦикла;

Обратите внимание на типичные фильтры: ЭтоГруппа исключает папки в иерархических справочниках, ПометкаУдаления — помеченные на удаление элементы. Без этих условий выборка будет содержать «мусор», который потом попадёт в отчёты и обмены. Для подчинённых справочников дополнительно фильтруют по владельцу.

Результат запроса можно получить тремя способами: Выбрать() — последовательный обход (экономит память на больших выборках), Выгрузить() — таблица значений (удобна для произвольного доступа и сортировки), Выгрузить().ВыгрузитьКолонку() — массив значений одного поля. Для десятков тысяч строк предпочтителен обход выборки без выгрузки в таблицу.

Создание и изменение элементов справочника

Новый элемент создаётся через объект, а не через ссылку: Справочники.Номенклатура.СоздатьЭлемент() возвращает объект, у которого заполняют реквизиты и вызывают Записать(). Для иерархических справочников создание папки выполняется методом СоздатьГруппу(). Изменение существующего элемента начинается с Ссылка.ПолучитьОбъект() — только объект можно модифицировать, ссылка доступна только для чтения.

При записи срабатывают подписки на события и проверки заполнения, заложенные в конфигурации. Если запись «не проходит», смотрите текст исключения: чаще всего не заполнен обязательный реквизит или нарушена уникальность. Принудительный обход проверок через ОбменДанными.Загрузка = Истина допустим только в обменах и при полном понимании последствий — так можно записать некорректные данные, которые потом ломают отчёты и проведение документов.

Обращение к справочнику извне: COM, веб-сервисы, HTTP

Из внешних систем к справочникам 1С обращаются через механизмы интеграции. Классический вариант для Windows — COM-соединение (V83.COMConnector): внешний скрипт подключается к базе и использует тот же объектный API, включая Справочники. Это работает только для файловых и клиент-серверных баз на Windows и требует установленной платформы той же версии.

Современный вариант — HTTP-интерфейсы: стандартный OData (публикация на веб-сервере, доступ к справочникам по REST-подобному протоколу) или собственные HTTP-сервисы, разработанные в конфигурации. OData подходит для простого чтения данных, собственные HTTP-сервисы — когда нужна бизнес-логика, контроль прав и нестандартные форматы. Для интеграции между базами 1С традиционно используют планы обмена и EnterpriseData.

Как проверить, что обращение выполнено правильно

Минимальная проверка программного поиска — убедиться, что ссылка не пустая и относится к нужному типу. Для дальнейшей диагностики полезно вывести уникальный идентификатор: Строка(Ссылка.УникальныйИдентификатор()) — по GUID элемент однозначно находится в базе и в конфигураторе.

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

Частые вопросы