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

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

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

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

Базовое понятие реквизита в конфигурации

Реквизит в терминологии 1С — это именованное поле хранения данных. Каждый объект метаданных, будь то справочник, документ или регистр сведений, состоит из набора таких полей. Технически это переменная с определенным именем, типом и свойствами, которая хранится в информационной базе. Значение реквизита может быть простым (число, строка, дата) или ссылочным (ссылка на другой объект).

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

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

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

Типизация играет ключевую роль в производительности. Если вы точно знаете, что в поле будет храниться только дата, не стоит выбирать составной тип «Дата или Строка». Использование неопределенных типов усложняет работу СУБД и замедляет выборки. Всегда стремитесь к максимально точному описанию структуры данных.

Структура шапки и табличной части документа

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

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

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

Существует возможность создавать несколько табличных частей в одном документе. Это удобно, когда нужно разделить разнородные данные. Например, в документе «Заказ клиента» одна таблица может содержать заказанные товары, а вторая — историю комментариев менеджеров. Однако злоупотреблять этим не стоит, так как это усложняет интерфейс пользователя.

Типы данных и настройка свойств полей

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

Числовые реквизиты требуют настройки точности и длины. Для денежных сумм обычно используют длину 15 и точность 2 знака после запятой. Для количественных показателей (штуки, килограммы) точность может быть выше, до 3-4 знаков. Неправильная настройка длины может привести к ошибке «Значение слишком длинное» при вводе крупных сумм.

Строковые реквизиты также имеют ограничение по длине. По умолчанию это 150 символов, но его можно изменить. Если вы планируете хранить в поле URL-адреса или длинные описания, увеличьте длину до 500 или 1000 символов. Однако помните, что длинные строки занимают больше места в индексах и могут замедлить поиск.

Тип реквизита	Пример использования	Особенности хранения
Число	Количество, Сумма, Вес	Требует указания длины и точности
Строка	Артикул, Комментарий, ФИО	Ограничение по длине (байты/символы)
Дата	Дата договора, Срок оплаты	Хранит дату и время с точностью до секунды
СправочникСсылка	Контрагент, Номенклатура	Хранит уникальный идентификатор (UUID)

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

Реквизиты табличной части и работа с коллекциями

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

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

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

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

Для оптимизации работы с большими таблицами рекомендуется использовать индексы. Если вы часто ищете строки по определенному полю (например, по артикулу товара в спецификации заказа), создание индекса для этого реквизита табличной части ускорит поиск в разы. Это настраивается в свойствах реквизита флажком «Индексирование».

Дополнительные реквизиты и расширения конфигурации

Часто возникает ситуация, когда стандартной структуры документа недостаточно, а изменять основную конфигурацию нельзя или нецелесообразно. В таких случаях на помощь приходят дополнительные реквизиты и сведения. Этот механизм позволяет пользователям самостоятельно добавлять новые поля к объектам без участия программиста.

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

Где физически хранятся доп. реквизиты?

Данные дополнительных реквизитов хранятся в регистре сведений «ДополнительныеРеквизиты» (или аналогичном, в зависимости от версии платформы). Связь с основным объектом осуществляется по ссылке (UUID). Это означает, что для получения значения требуется дополнительный JOIN при формировании запроса.

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

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

Практические аспекты программирования и отладки

При написании кода для документов важно учитывать контекст выполнения. В модуле объекта документа реквизиты доступны напрямую. В модуле формы доступ осуществляется через элементы формы, которые связаны с реквизитами данными. Разница может быть критичной при обработке событий, таких как ПриЗаписи или ПередЗаписью.

Частая ошибка новичков — попытка обратиться к реквизиту табличной части как к массиву. На самом деле это коллекция объектов. Для добавления новой строки используется метод Добавить, который возвращает ссылку на новый объект строки, где уже можно заполнить реквизиты.

НоваяСтрока = Документ.Товары.Добавить;
НоваяСтрока.Номенклатура = СсылкаНаТовар;
НоваяСтрока.Количество = 10;
НоваяСтрока.Цена = 1500.00;
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;

Отладка значений реквизитов удобнее всего проводится с помощью панели «Монитор переменных» в режиме отладки. Вы можете видеть не только значения простых типов, но и раскрывать структуры объектов, просматривая содержимое табличных частей. Также полезно использовать метод ПолучитьТабличнуюЧасть для анализа данных в отладчике.

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

Часто задаваемые вопросы (FAQ)

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

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

Как переименовать реквизит в базе данных без потери данных?

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

В чем разница между реквизитом и измерением регистра?

Реквизит — это свойство объекта (документа, справочника), описывающее его состояние. Измерение регистра — это поле, по которому группируются данные в регистре накопления или сведений. Реквизиты документов часто становятся измерениями регистров при проведении, но это разные сущности в архитектуре 1С.

Почему реквизит не виден в форме документа?

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