Как проверить наличие реквизита в документе 1С: подробное руководство с примерами

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

Вы узнаете, как:

• 🔍 Проверить реквизит через интерфейс пользователя без программирования
• 💻 Написать код для проверки наличия реквизита в модуле документа
• 📊 Использовать отладчик и глобальный поиск для анализа структуры документов
• 🔧 Работать с динамическими реквизитами и реквизитами табличных частей

Материал будет полезен и бухгалтерам, которые хотят избежать ошибок при заполнении документов, и программистам, которые пишут обработки или дорабатывают конфигурации. Все примеры актуальны для последних версий платформы 1С:Предприятие 8.3 (включая 8.3.23 и новее).

1. Визуальная проверка реквизитов через интерфейс 1С

Самый простой способ — посмотреть структуру документа в режиме 1С:Предприятие. Этот метод не требует знаний программирования и подходит для обычных пользователей.

Чтобы увидеть все реквизиты документа:

1. Откройте нужный документ (например, Реализация товаров и услуг).
2. Нажмите кнопку Ещё → Изменить форму (или Все действия → Изменить форму в новых версиях).
3. В открывшемся окне конструктора формы перейдите на вкладку Реквизиты.
4. Здесь отобразится полный список реквизитов документа, включая скрытые.

Если реквизит отсутствует в списке, значит, его нет в конфигурации. Для проверки заполненности существующего реквизита просто посмотрите на его значение в форме документа.

2. Проверка реквизитов через "Все функции" (для опытных пользователей)

Более продвинутый способ — использование окна Все функции. Это позволяет не только увидеть реквизиты, но и выполнить быстрые проверки без написания кода.

Инструкция:

• 📌 Откройте документ и нажмите Ctrl+Shift+F12 (или Сервис → Все функции).
• 🔎 В поле поиска введите название реквизита (например, Контрагент).
• 📋 Если реквизит существует, он отобразится в списке с указанием типа (строка, справочник, число и т.д.).
• 🔄 Чтобы проверить значение, выделите реквизит и нажмите Выполнить — внизу окна появится его текущее значение.

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

3. Программная проверка реквизитов на встроенном языке 1С

Для разработчиков и продвинутых пользователей наиболее надёжный способ — написание кода на встроенном языке. Этот метод позволяет автоматизировать проверки и интегрировать их в бизнес-процессы.

Основные конструкции для проверки:

1. Проверка существования реквизита:

Если Метаданные.Документы[ИмяДокумента].Реквизиты.Найти(ИмяРеквизита) <> Неопределено Тогда
// Реквизит существует
Иначе
// Реквизита нет
КонецЕсли;

2. Проверка заполненности реквизита:

Если Документ.Реквизит = Неопределено Или Документ.Реквизит = "" Тогда
Сообщить("Реквизит не заполнен!");
КонецЕсли;

3. Проверка реквизитов табличной части:

Для Каждого СтрокаТабличнойЧасти Из Документ.ТабличнаяЧасть Цикл
Если СтрокаТабличнойЧасти.Реквизит = Неопределено Тогда
Сообщить("В строке " + СтрокаТабличнойЧасти.НомерСтроки() + " не заполнен реквизит!");
КонецЕсли;
КонецЦикла;

Пример полной процедуры для проверки обязательных реквизитов перед проведением документа:

Процедура ПередЗаписью(Отказ)
Если НЕ ЗначениеЗаполнено(Контрагент) Тогда
Сообщить("Не заполнен контрагент!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;

Если НЕ ЗначениеЗаполнено(Дата) Тогда
Сообщить("Не указана дата документа!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

4. Работа с динамическими реквизитами

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

Чтобы проверить динамический реквизит:

• 🔧 Используйте объект ДополнительныеРеквизиты:

ДопРеквизиты = Документ.ДополнительныеРеквизиты;
Если ДопРеквизиты.Найти("НазваниеРеквизита") <> Неопределено Тогда
Значение = ДопРеквизиты["НазваниеРеквизита"].Значение;
Если Значение = Неопределено Тогда
Сообщить("Динамический реквизит не заполнен!");
КонецЕсли;
Иначе
Сообщить("Динамический реквизит не существует!");
КонецЕсли;

Особенности динамических реквизитов:

Важно: динамические реквизиты не отображаются в окне "Все функции" и не видны в конструкторе формы по умолчанию. Их можно увидеть только через код или в специальном разделе настроек (обычно "Администрирование → Дополнительные реквизиты").

5. Проверка реквизитов через запросы 1С

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

Пример запроса для проверки заполненности реквизита Контрагент во всех документах РеализацияТоваровУслуг за текущий месяц:

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

Запрос.УстановитьПараметр("НачалоМесяца", НачалоМесяца(ТекущаяДата()));
Запрос.УстановитьПараметр("КонецМесяца", КонецМесяца(ТекущаяДата()));

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

Пока Выборка.Следующий() Цикл
Сообщить("Документ " + Выборка.Ссылка + " не имеет контрагента!");
КонецЦикла;

Преимущества этого метода:

• 📊 Возможность анализировать большие объёмы данных
• 🔍 Гибкая фильтрация по датам, контрагентам, организациям
• 📈 Легко интегрируется в отчёты и обработки

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

6. Отладка и глобальный поиск реквизитов

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

Как искать реквизиты в конфигурации:

1. Откройте конфигуратор (1С:Предприятие в режиме Конфигуратор).
2. Нажмите Ctrl+Shift+F для вызова окна поиска.
3. В поле поиска введите предполагаемое название реквизита.
4. Установите галочки Поиск в модулях и Поиск в метаданных.
5. Нажмите Найти все — система покажет все упоминания реквизита в коде и метаданных.

Для отладки кода, работающего с реквизитами:

• 🛠 Установите точку останова на строке, где происходит работа с реквизитом.
• 🐞 Запустите отладку (F5) и проследите, как изменяется значение реквизита.
• 📡 Используйте окно Вычислить выражение (Ctrl+Alt+F9), чтобы в реальном времени проверять значения переменных.

Использовать глобальный поиск (Ctrl+Shift+F)|Проверить метаданные документа|Просмотреть форму в режиме редактирования|Использовать окно "Все функции" (Ctrl+Shift+F12)|Запустить отладку с точками останова-->

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

При работе с реквизитами в 1С часто возникают ошибки, связанные с неверной проверкой или недоучётом особенностей платформы. Рассмотрим самые распространённые случаи.

Ошибка 1: Проверка только на Неопределено

Многие разработчики пишут:

Если Документ.Реквизит = Неопределено Тогда...

Но это не покрывает все случаи! Реквизит может быть пустой строкой, нулевой датой или пустой ссылкой. Правильнее использовать:

Если НЕ ЗначениеЗаполнено(Документ.Реквизит) Тогда...

Ошибка 2: Работа с реквизитами табличных частей без цикла

Часто забывают, что реквизиты табличной части нужно проверять для каждой строки:

// Неверно:
Если Документ.ТабличнаяЧасть.Реквизит = Неопределено Тогда...

// Правильно:
Для Каждого Строка Из Документ.ТабличнаяЧасть Цикл
Если НЕ ЗначениеЗаполнено(Строка.Реквизит) Тогда...
КонецЦикла;

Ошибка 3: Игнорирование прав доступа

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

Попытка
Значение = Документ.Реквизит;
Исключение
Сообщить("Нет прав на доступ к реквизиту!");
КонецПопытки;

Ошибка 4: Работа с динамическими реквизитами как с обычными

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

// Неверно (вызовет ошибку):
Значение = Документ.ДинамическийРеквизит;

// Правильно:
ДопРеквизиты = Документ.ДополнительныеРеквизиты;
Значение = ДопРеквизиты["ДинамическийРеквизит"].Значение;

8. Автоматизация проверок с помощью обработок

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

• 📋 Проверять заполненность обязательных реквизитов во всех документах за период
• 📊 Формировать отчёт о документах с незаполненными реквизитами
• 🔧 Автоматически исправлять типичные ошибки (например, подставлять контрагента по умолчанию)

Пример кода для обработки, проверяющей реквизиты в документах ПоступлениеТоваров:

Процедура ПроверитьДокументы(Команда)
НачалоПериода = НачалоДня(НачалоМесяца(ТекущаяДата()));
КонецПериода = КонецДня(КонецМесяца(ТекущаяДата()));

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

Запрос.УстановитьПараметр("НачалоПериода", НачалоПериода);
Запрос.УстановитьПараметр("КонецПериода", КонецПериода);

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

ПроблемныеДокументы = Новый Структура("Список, Количество");
ПроблемныеДокументы.Список = Новый Массив;
ПроблемныеДокументы.Количество = 0;

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

Если ПроблемныеДокументы.Количество > 0 Тогда
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Найдено " + ПроблемныеДокументы.Количество + " документов с незаполненным контрагентом!";
Сообщение.Сообщить();
Иначе
Сообщить("Все документы заполнены корректно.");
КонецЕсли;
КонецПроцедуры

Такую обработку можно сохранить во внешний файл (.epf) и запускать по мере необходимости. Для автоматизации проверок настройте регламентное задание в 1С, которое будет запускать обработку, например, раз в неделю.

Для удобства можно добавить в обработку кнопку Исправить автоматически, которая будет подставлять значения по умолчанию (например, контрагента из настроек пользователя или последнюю использованную организацию).

⚠️ Внимание: При автоматическом исправлении реквизитов всегда создавайте резервную копию базы данных перед массовыми изменениями. Неправильное исправление может привести к искажению учёта.

FAQ: Частые вопросы о проверке реквизитов в 1С

Для Каждого Строка Из Документ.ТабличнаяЧасть Цикл
Сообщить(Строка.Реквизит); // Правильный доступ
КонецЦикла;

Если Метаданные.Документы[ИмяДокумента].Реквизиты.Найти(ИмяРеквизита) <> Неопределено Тогда
Сообщить("Реквизит существует!");
Иначе
Сообщить("Реквизит не найден.");
КонецЕсли;

Если Метаданные.Документы[ИмяДокумента].ТабличныеЧасти[ИмяТабличнойЧасти].Реквизиты.Найти(ИмяРеквизита) <> Неопределено Тогда
Сообщить("Реквизит табличной части существует!");
КонецЕсли;

НовыйДокумент = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
НовыйДокумент.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ОАО Ростех");

Если НЕ ЗначениеЗаполнено(НовыйДокумент.Контрагент) Тогда
Сообщить("Контрагент не установлен!");
КонецЕсли;

Попытка
Соединение = Новый COMОбъект("V83.ComConnector");
База = Соединение.Connect("File=""C:\Базы\Trade""; Usr=""Администратор"";");
Документ = База.Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-00001");
Сообщить("Контрагент: " + Документ.Контрагент);
Исключение
Сообщить("Ошибка подключения: " + ОписаниеОшибки());
КонецПопытки;