Как определить, что объект в 1С — это справочник: 5 рабочих методов

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

Эта статья поможет разобраться, как точно идентифицировать справочник в разных сценариях: от визуального анализа в конфигураторе до программной проверки в коде. Мы рассмотрим методы для пользователей без доступа к конфигуратору, администраторов и разработчиков, а также разберем типичные «ловушки», где справочники маскируются под другие объекты. Например, почему СправочникСсылка.Номенклатура и ДокументСсылка.ПоступлениеТоваров в коде выглядят похоже, но ведут себя принципиально по-разному.

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

1. Визуальное определение в конфигураторе

Самый простой способ — открыть конфигуратор (1Cv8.exe /config) и изучить дерево метаданных. Справочники в нем отмечены специальной иконкой (папка с книжкой), но есть нюансы:

• 📁 Иконка: стандартная иконка справочника — папка с синей книжкой. Если иконка другая (например, документ с печатью или таблица), это не справочник.
• 🔍 Контекстное меню: при клике правой кнопкой на объекте в дереве появится пункт «Открыть справочник» (для документов будет «Открыть список документов»).
• 📊 Свойства объекта: в панели свойств (справа) у справочника будет поле «Тип значения» со значением СправочникСсылка.ИмяСправочника.

⚠️ Внимание: В некоторых конфигурациях (например, 1С:ERP или 1С:КА 2.5) справочники могут быть скрыты в подсистемах. Чтобы увидеть их все, включите отображение служебных объектов в меню Конфигурация → Настройки → Показывать служебные объекты.

2. Проверка через «Все функции» (для пользователей без конфигуратора)

Если у вас нет прав на запуск конфигуратора, определить тип объекта можно через стандартный интерфейс 1С:Предприятие:

1. Откройте главное меню и выберите Все функции (или нажмите Ctrl+Shift+F).
2. В списке найдите раздел Справочники — здесь перечислены все доступные пользователю справочники.
3. Сравните имя интересующего вас объекта с тем, что видите в интерфейсе. Например, если в форме документа есть поле «Контрагент», а в Все функции → Справочники есть Контрагенты, то это справочник.

🔹 Подсказка: В современных конфигурациях (начиная с 1С:Предприятие 8.3.10) справочники в интерфейсе часто называются во множественном числе (например, «Номенклатура» в коде → «Номенклатуры» в меню). Это сделано для удобства пользователей, но может сбивать с толку.

3. Анализ формы объекта: 3 ключевых признака

Даже без конфигуратора тип объекта можно определить по его форме. Откройте объект (например, карточку номенклатуры или контрагента) и обратите внимание на:

⚠️ Внимание: Некоторые справочники (например, ФизическиеЛица) могут иметь реквизиты, похожие на документы (например, поле «ДатаРождения»). Не ориентируйтесь только на одно поле — анализируйте комплекс признаков.

4. Программное определение типа в коде (1C:Enterprise)

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

Процедура ОпределитьТипОбъекта(Значение)
Если ТипЗнч(Значение) = Тип("СправочникСсылка.ИмяТипа") Тогда
Сообщить("Это справочник: " + ТипЗнч(Значение));
ИначеЕсли ТипЗнч(Значение) = Тип("ДокументСсылка.ИмяТипа") Тогда
Сообщить("Это документ: " + ТипЗнч(Значение));
Иначе
Сообщить("Другой тип: " + ТипЗнч(Значение));
КонецЕсли;
КонецПроцедуры

🔹 Как использовать:

1. Скопируйте процедуру в модуль любой формы или обработки.
2. Передайте в нее ссылку на объект, например:

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

3. Система выведет точный тип, например: СправочникСсылка.Номенклатура.

⚠️ Внимание: Если вы передадите в функцию не ссылку, а сам объект (например, результат выборки), используйте ТипЗнч() с параметром Истина для рекурсивного определения:

ТипЗнч(Объект, Истина)

Это поможет распознать объекты, обернутые в ДвоичныеДанные или ХранилищеЗначения.

Убедитесь, что переменная содержит ссылку, а не значение реквизита|Используйте ТипЗнч() с параметром Истина для сложных объектов|Проверяйте не только тип, но и имя (например, СправочникСсылка.Номенклатура)|Тестируйте код на пустых ссылках (может вернуть Неопределено)

-->

5. Скрытые справочники: как их найти

В 1С:Предприятие есть справочники, которые не отображаются в дереве метаданных, но критичны для работы системы. Их можно обнаружить через:

• 🔎 Глобальный поиск: В конфигураторе нажмите Ctrl+Shift+F и введите Справочник. (с точкой). Система покажет все упоминания справочников в коде, включая скрытые.
• 📜 Системные справочники: Например, Пользователи, Роли, Права — они не видны в дереве, но доступны через Справочники.Пользователи.
• 🛠️ Консоль запросов: Execute запрос:

  ВЫБРАТЬ
  Метаданные.Справочники.Имя
  ИЗ
  Метаданные.Справочники

  Он вернет все справочники, включая служебные.

🔹 Пример: Справочник ВнешниеОбработки хранит список подключенных внешних обработок, но его нет в дереве метаданных. Чтобы открыть его программно, используйте:

Справочники.ВнешниеОбработки.ПолучитьСписок();

⚠️ Внимание: Работа со скрытыми справочниками может нарушить стабильность системы. Например, изменение справочника Пользователи напрямую (без интерфейса администрирования) может заблокировать доступ к базе. Всегда делайте резервную копию перед экспериментами!

6. Типичные ошибки и как их избежать

Даже опытные разработчики иногда путают справочники с другими объектами. Рассмотрим распространенные случаи:

• 🔄 Справочник vs. Перечисление: Перечисления имеют фиксированный список значений (например, ВидыНоменклатуры), а справочники — динамический. Проверьте: если список редактируется пользователем — это справочник.
• 📄 Справочник vs. Документ: Документы всегда имеют дату и номер, справочники — нет. Исключение: справочники с реквизитом «Дата» (например, ДоговорыКонтрагентов).
• 🗃️ Справочник vs. Регистр сведений: Регистры хранят данные с привязкой к периоду (например, курсы валют), а справочники — статичные данные (например, список валют).

🔹 Практический совет: Если сомневаетесь, используйте универсальный запрос для проверки:

ВЫБРАТЬ
ВЫРАЗИТЬ(МETAДАННЫЕ(Ссылка).Имя КАК Строка) КАК ИмяТипа,
ВЫРАЗИТЬ(ТИП(Ссылка) КАК Строка) КАК ТипОбъекта
ИЗ
&Таблица КАК Ссылка
ГДЕ
Ссылка.Ссылка = &СсылкаНаОбъект

Замените &Таблица на реальную таблицу (например, Справочник.Номенклатура), а &СсылкаНаОбъект — на проверяемую ссылку.

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

Справочники.ИмяСправочника.ПолучитьСписок();