Что не относится к свойствам документов в 1С: полный разбор

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

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

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

1. Реквизиты справочников: почему их путают со свойствами документов

Одно из самых частых заблуждений — считать, что реквизиты справочников (например, Наименование или Артикул в справочнике Номенклатура) являются свойствами документа, если они отображаются в его форме. На самом деле это внешние ссылки, а не внутренние атрибуты.

Когда вы добавляете в документ поле типа "СправочникСсылка.Номенклатура", вы создаете ссылку на объект, но не копируете его реквизиты. Например, в документе РеализацияТоваровУслуг поле Номенклатура — это свойство документа (оно хранится в его метаданных), а вот Артикул или ЕдиницаИзмерения из справочника номенклатуры — нет. Они подтягиваются динамически при открытии формы.

🔹 Свойство документа: Дата, Номер, Контрагент (как ссылка)
🔸 НЕ свойство: ИНН Контрагента, Артикул Номенклатуры, Адрес Склада
📌 Исключение: Если вы явно добавили реквизит типа "Строка" и назвали его Артикул, то это уже свойство документа (но это плохая практика!).

⚠️ Внимание: При обмене данными через XML или JSON реквизиты справочников, отображаемые в документе, не экспортируются автоматически. Их нужно подгружать отдельно через запросы или обработки.

2. Табличные части: часть документа или отдельный объект?

Табличные части (например, Товары в документе ПоступлениеТоваровУслуг) — это структурный элемент документа, но не его свойство в классическом понимании. Они представляют собой коллекцию записей, каждая из которых имеет свой набор реквизитов.

Ключевое отличие: свойство документа (например, Дата) хранится в одной записи базы данных, а табличная часть — в отдельной таблице, связанной с документом по идентификатору. Это означает, что:

📊 Табличную часть можно обрабатывать как отдельный набор данных (например, через запрос ВЫБРАТЬ Товары ИЗ Документ.ПоступлениеТоваровУслуг.Товары).
🔄 Ее можно модифицировать независимо от документа (добавлять/удалять строки без изменения основных реквизитов).
🚫 Она не участвует в механизме проверки заполнения на уровне документа (ее валидация реализуется отдельно).

Пример из кода:

// Это свойство документа
Документ.Дата = ТекущаяДата();

// Это работа с табличной частью (НЕ свойство!)
НоваяСтрока = Документ.Товары.Добавить();
НоваяСтрока.Номенклатура = СсылкаНаНоменклатуру;

⚠️ Внимание: В управляемых формах табличные части отображаются как элементы интерфейса, но в метаданных они остаются отдельными объектами. Это важно учитывать при настройке прав доступа: права на документ и на его табличные части могут различаться!

💡

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

3. Регистры накопления, сведений и бухгалтерии: где граница?

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

📈 Хранят историю изменений (например, остатки товаров или обороты по счетам).
🔗 Связаны с документами через механизм движений, но не являются их частью.
🛠️ Могут обновляться не только документами, но и другими обработками (например, регламентными заданиями).

Пример: в документе РеализацияТоваровУслуг есть свойство СуммаДокумента, но остатки товаров на складе хранятся в регистре накопления ТоварыНаСкладах — это разные сущности!

Объект	Является свойством документа?	Пример
Реквизит документа	✅ Да	`Документ.Дата`, `Документ.Контрагент`
Табличная часть	❌ Нет (отдельный объект)	`Документ.Товары`
Регистр накопления	❌ Нет (внешний объект)	ТоварыНаСкладах
Реквизит справочника	❌ Нет (если не скопирован)	`Номенклатура.Артикул`

💡

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

4. Команды, кнопки и элементы формы: интерфейс ≠ данные

Многие разработчики путают элементы управления формой (кнопки, флажки, поля ввода) со свойствами документа. Например, кнопка Провести или флажок Пометить на удаление — это часть интерфейса, но не метаданные документа.

Ключевые отличия:

🎨 Элементы формы определяются в модуле формы и могут динамически изменяться (например, скрываться при определенных условиях).
🗃️ Свойства документа хранятся в базе данных и фиксированы для всех экземпляров документа данного типа.
🔧 Команды (например, ПровестиИЗакрыть) реализуются через общие команды или команды формы, но не являются реквизитами.

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

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

Что будет, если удалить команду из формы документа?

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

5. Движения документа: следствие, а не свойство

Движения документа по регистрам (например, проведение по регистру Бухгалтерии) — это результат его обработки, а не его свойство. Они генерируются при проведении документа и хранятся отдельно от него.

Почему это важно:

🔄 Движения можно перепровести без изменения свойств документа (например, после исправления ошибок в регистрах).
🗑️ Их можно удалить (через Документ.УдалитьДвижения()), не затрагивая сам документ.
📊 Они используются для формирования отчетов (например, Оборотно-сальдовая ведомость), но не отображаются в списке реквизитов документа.

Пример кода для работы с движениями:

// Получаем движения документа (это НЕ его свойства!)
Движения = Документ.ПолучитьДвижения();

// Удаляем движения (документ остается неизменным)
Документ.УдалитьДвижения();

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

6. Внешние обработки и отчеты: когда документ — juste параметр

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

📄 Сама печатная форма (например, Счет на оплату) — это внешний объект, не хранящийся в документе.
🔧 Параметры обработки (например, ПечататьЦены) не сохраняются в метаданных документа.
📑 Результат выполнения (например, сформированный PDF-файл) — это временные данные, не связанные с документом на уровне базы.

Пример: в документе ЗаказПокупателя может быть свойство Комментарий, но шаблон печатной формы, который использует это свойство, хранится в отдельной обработке или в подсистеме печати.

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

Проверьте, хранится ли элемент в таблице документа в базе данных|Убедитесь, что он отображается во вкладке "Реквизиты" в конфигураторе|Попробуйте получить его значение через Документ.ИмяРеквизита|Проверьте, экспортируется ли он при обмене данными-->

7. Системные реквизиты: что скрыто от глаз пользователя

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

🆔 Ссылка — уникальный идентификатор документа в базе.
🔐 ПометкаУдаления — флаг, указывающий, что документ помечен на удаление.
🔄 ЭтоГруппа — признак группового документа (например, в Управлении торговлей).
📅 ДатаСоздания — когда документ был создан (не путать с Дата!).

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

Пример использования системных реквизитов:

// Получаем ссылку на документ (системный реквизит) СсылкаНаДокумент = Документ.Ссылка; // Проверяем, помечен ли документ на удаление Если Документ.ПометкаУдаления Тогда Сообщить("Документ удален!");

КонецЕсли;

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

8. Динамические списки и временные данные

Динамические списки, которые отображаются в формах документов (например, список связанных платежей в документе РеализацияТоваровУслуг), — это временные выборки данных, а не свойства документа. Они:

🔍 Формируются на основе запросов к базе в момент открытия формы.
🗑️ Не сохраняются вместе с документом (при закрытии формы данные исчезают).
🔄 Могут обновляться без изменения документа (например, при добавлении нового платежа).

Пример: если в документе ЗаказПокупателя вы видите список Оплаты по заказу, это динамический список, сгенерированный на основе данных из регистра ВзаиморасчетыСКонтрагентами. Он не хранится в самом документе!

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

Есть ли у него вкладка в конфигураторе (у свойств есть, у динамических списков — нет).
Сохраняется ли он при выгрузке документа в XML (динамические списки — нет).
Можно ли получить к нему доступ через Документ.ИмяСписка (обычно нет, только через ЭлементыФормы).

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

💡

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

FAQ: Частые вопросы о свойствах документов в 1С

❓ Можно ли добавить реквизит справочника как свойство документа?

Да, но это требует явного действия: нужно создать реквизит в документе (например, АртикулНоменклатуры типа "Строка") и вручную заполнять его значением из справочника. Однако это нарушает нормализацию данных и может привести к расхождению информации. Лучше использовать ссылку на справочник и получать актуальные данные динамически.

❓ Почему при копировании документа табличные части не всегда копируются?

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

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

❓ Являются ли движения документа его свойствами?

Нет, движения — это записи в регистрах, которые генерирует документ при проведении. Они хранятся в отдельных таблицах базы данных и связаны с документом только логически (через ссылку). Например, документ ПоступлениеТоваровУслуг может создать движения в регистре ТоварыНаСкладах, но эти движения не являются его реквизитами.

❓ Как проверить, является ли поле свойством документа?

Есть несколько способов:

Откройте конфигуратор, найдите документ и проверьте вкладку Реквизиты — там перечислены все его свойства.
Попробуйте получить значение поля через точку: Документ.ИмяПоля. Если выдает ошибку — это не свойство.
Посмотрите структуру документа в базе данных (например, через SQL-запрос к таблице _Document{ID}).

❓ Можно ли сделать так, чтобы реквизит справочника автоматически становился свойством документа?

Да, но это требует доработки конфигурации. Например, можно:

Добавить реквизит в документ (например, Артикул типа "Строка").

В обработчике ПриЗаписи автоматически заполнять его значением из справочника:

Процедура ПриЗаписи(Отказ)
Если Не ЗначениеЗаполнено(Артикул) Тогда
Артикул = Справочники.Номенклатура.НайтиПоНаименованию(Номенклатура).Артикул;
КонецЕсли;
КонецПроцедуры

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

Что не относится к свойствам документов в 1С: 8 мифов и реальность