Документация Формулы
Разделы документации

Руководство

Обзор руководства

Бизнес-процессы и задачи

Бизнес-процессы и задачи

КОНСТРУКТОР

Реквизиты

Реквизиты — это поля объекта: то, что пользователь заполняет в карточке. Вкладка «Реквизиты» есть у всех объектов Конструктора.

┌──────────────────────────────────────────────────────────────────────────────┐
│ Реквизиты                                        [+ Добавить]                │
├────┬───────────────┬──────────────────┬───────────────┬─────────────────────┤
│ ⠿  │ Имя           │ Тип              │ Роль (регистр)│ Действия            │
│ ⠿  │ Наименование  │ Строка           │               │  ⚙   🗑             │
│ ⠿  │ Цена          │ Число            │ Ресурс        │  ⚙   🗑             │
│ ⠿  │ Номенклатура  │ Справочник Ссылка│ Измерение     │  ⚙   🗑             │
├────┴───────────────┴──────────────────┴───────────────┴─────────────────────┤
│ Табличные части                                  [+ Добавить]                │
│ ⠿  Товары                                                     ⚙   🗑         │
└──────────────────────────────────────────────────────────────────────────────┘

# Таблица реквизитов

КолонкаЧто в ней
⠿Ручка перетаскивания. Меняет порядок реквизитов — он же порядок полей в карточке
ИмяНазвание реквизита так, как его увидит пользователь и как оно используется в формулах. Щёлкните и введите новое имя
ТипТип данных поля — см. Типы реквизитов
Роль (регистр)Только у регистров: Измерение, Ресурс, Реквизит или (Не задана) — см. Регистры
Действия⚙ — открыть настройки реквизита (правая панель), 🗑 — удалить реквизит

Базовая кнопка Добавить создаёт новый реквизит типа Строка с именем вида «Реквизит1». Переименуйте его сразу — позже имя менять неудобно: оно используется в правилах проведения, формулах и модулях.

# Настройки выбранного реквизита

Когда вы щёлкаете значок ⚙, справа открывается панель свойств. Состав настроек зависит от типа.

# Общие настройки (для всех типов)

НастройкаЧто означает
ОписаниеПояснение для разработчика и подсказка в карточке. На работу данных не влияет
ШиринаСколько колонок макета занимает поле: 1, 2 или 3. Поле Блок всегда занимает всю ширину
СкрытыйПоле существует в данных, но не показывается в карточке (используется модулем)

# Дополнительно по типам

НастройкаДля каких типовЧто означает
ДлинаСтрокаМаксимальное число символов
По умолчаниюСтрока, Число, Дата, Булево, ПеречислениеЗначение, подставляемое в новую запись. Для даты это галочка Текущая дата
ОбязательныйСтрока, Число, Дата, Булево, Справочник Ссылка, Документ Ссылка, ПеречислениеБез заполнения запись не сохранится — поле подсветится красным
УникальноеСтрока, ЧислоЗапрещает две записи с одинаковым значением. Появится сообщение «Нарушение уникальности полей…»
Только чтениеВсе, кроме Блок/Надпись/КартинкаПользователь видит значение, но изменить его не может
МногострочныйСтрокаПоле ввода увеличивается по высоте (комментарии, описания)
ПарольСтрокаСимволы скрываются точками. Взаимоисключающе с «Многострочный» и «Файл»
ФайлСтрокаПоле хранит загруженный файл (кнопка выбора и удаления файла)
ТочностьЧислоСколько знаков после запятой. 2 — копейки, 3 — количество, 6 — курсы
Минимум, МаксимумЧислоДопустимый диапазон значения
Валютная суммаЧислоВключает мультивалютность: рядом появляется Валюта суммы (реквизит-валюта) или Сумма в учётной валюте (для второго поля пары: сумма в валюте + сумма в базовой валюте)
ВыражениеЧислоФормула для автоматического расчёта поля. Поле становится «Только чтение». Пример: SUM([Товары.Сумма])
ВариантДатаЧто вводит пользователь: Дата, Время, Дата и время
ВариантБулевоВид переключателя в карточке
Ссылка наСправочник/Документ СсылкаКаталог или документ, на который ссылается поле. Выбирается кнопкой со значком списка, очищается крестиком
РодительСправочник/Документ СсылкаДругое ссылочное поле этого же объекта. Используется для каскадного отбора: после выбора родителя в списке остаются только подчинённые значения
Значения перечисленияПеречислениеСписок вариантов: имя, значение, добавление и удаление строк
Правила фильтрацииСправочник/Документ СсылкаКнопка Настроить открывает редактор условий отбора в поле выбора. Показывает «Настроено правил: N» или «Правила не настроены»
СебестоимостьРесурс регистра (при включённом партионном учёте)Помечает ресурс как хранилище себестоимости — см. Партионный учёт
Текст кнопки, Имя обработчика, Вариант, Размер, Только иконка, Иконка, Позиция, Классы CSSКнопкаОформление и поведение кнопки на форме; обработчик — имя функции в модуле объекта
Текст надписи, Размер шрифта, Насыщенность, Наклон, Цвет текста, Цвет фона, Выравнивание, На всю ширинуНадписьОформление текстовой подписи
URL, Ширина, Высота, Заполнение, Рамка, Alt текстКартинкаИсточник и оформление изображения

# Выражения для расчёта (тип «Число»)

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

Примеры:

ВыражениеЧто получится
SUM([Товары.Сумма])Сумма колонки «Сумма» табличной части «Товары»
[Количество] * [Цена]Произведение двух реквизитов
SUM([Товары.Количество]) * [Цена]Комбинированный расчёт

Скобки [ ] обязательны, имена пишутся точно как в колонке «Имя».

# Табличные части

Ниже таблицы реквизитов расположен блок «Табличные части» (кнопка Добавить). Табличная часть — это список однотипных строк внутри одной записи: товары в накладной, услуги в акте, сотрудники в документе. Подробнее — Табличные части.

# Правила именования

РекомендацияПочему
Имя без пробелов и специальных символовИмя попадает в формулы, модули и SQL-запросы отчётов
Имя отражает смысл: СуммаСНДС, а не Реквизит3Читаемость правил проведения и отчётов
Не переименовывать после начала работыСтарые данные и написанные формулы продолжат ссылаться на прежнее имя
Для сумм указывать «Сумма», для количества — «Количество»Есть автоматические механизмы (агрегации журнала, отчёты), которые ищут поля по смыслу