КОНСТРУКТОР
Реквизиты
Реквизиты — это поля объекта: то, что пользователь заполняет в карточке. Вкладка «Реквизиты» есть у всех объектов Конструктора.
┌──────────────────────────────────────────────────────────────────────────────┐
│ Реквизиты [+ Добавить] │
├────┬───────────────┬──────────────────┬───────────────┬─────────────────────┤
│ ⠿ │ Имя │ Тип │ Роль (регистр)│ Действия │
│ ⠿ │ Наименование │ Строка │ │ ⚙ 🗑 │
│ ⠿ │ Цена │ Число │ Ресурс │ ⚙ 🗑 │
│ ⠿ │ Номенклатура │ Справочник Ссылка│ Измерение │ ⚙ 🗑 │
├────┴───────────────┴──────────────────┴───────────────┴─────────────────────┤
│ Табличные части [+ Добавить] │
│ ⠿ Товары ⚙ 🗑 │
└──────────────────────────────────────────────────────────────────────────────┘# Таблица реквизитов
| Колонка | Что в ней |
|---|---|
| ⠿ | Ручка перетаскивания. Меняет порядок реквизитов — он же порядок полей в карточке |
| Имя | Название реквизита так, как его увидит пользователь и как оно используется в формулах. Щёлкните и введите новое имя |
| Тип | Тип данных поля — см. Типы реквизитов |
| Роль (регистр) | Только у регистров: Измерение, Ресурс, Реквизит или (Не задана) — см. Регистры |
| Действия | ⚙ — открыть настройки реквизита (правая панель), 🗑 — удалить реквизит |
Базовая кнопка Добавить создаёт новый реквизит типа Строка с именем вида «Реквизит1». Переименуйте его сразу — позже имя менять неудобно: оно используется в правилах проведения, формулах и модулях.
# Настройки выбранного реквизита
Когда вы щёлкаете значок ⚙, справа открывается панель свойств. Состав настроек зависит от типа.
# Общие настройки (для всех типов)
| Настройка | Что означает |
|---|---|
| Описание | Пояснение для разработчика и подсказка в карточке. На работу данных не влияет |
| Ширина | Сколько колонок макета занимает поле: 1, 2 или 3. Поле Блок всегда занимает всю ширину |
| Скрытый | Поле существует в данных, но не показывается в карточке (используется модулем) |
# Дополнительно по типам
| Настройка | Для каких типов | Что означает |
|---|---|---|
| Длина | Строка | Максимальное число символов |
| По умолчанию | Строка, Число, Дата, Булево, Перечисление | Значение, подставляемое в новую запись. Для даты это галочка Текущая дата |
| Обязательный | Строка, Число, Дата, Булево, Справочник Ссылка, Документ Ссылка, Перечисление | Без заполнения запись не сохранится — поле подсветится красным |
| Уникальное | Строка, Число | Запрещает две записи с одинаковым значением. Появится сообщение «Нарушение уникальности полей…» |
| Только чтение | Все, кроме Блок/Надпись/Картинка | Пользователь видит значение, но изменить его не может |
| Многострочный | Строка | Поле ввода увеличивается по высоте (комментарии, описания) |
| Пароль | Строка | Символы скрываются точками. Взаимоисключающе с «Многострочный» и «Файл» |
| Файл | Строка | Поле хранит загруженный файл (кнопка выбора и удаления файла) |
| Точность | Число | Сколько знаков после запятой. 2 — копейки, 3 — количество, 6 — курсы |
| Минимум, Максимум | Число | Допустимый диапазон значения |
| Валютная сумма | Число | Включает мультивалютность: рядом появляется Валюта суммы (реквизит-валюта) или Сумма в учётной валюте (для второго поля пары: сумма в валюте + сумма в базовой валюте) |
| Выражение | Число | Формула для автоматического расчёта поля. Поле становится «Только чтение». Пример: SUM([Товары.Сумма]) |
| Вариант | Дата | Что вводит пользователь: Дата, Время, Дата и время |
| Вариант | Булево | Вид переключателя в карточке |
| Ссылка на | Справочник/Документ Ссылка | Каталог или документ, на который ссылается поле. Выбирается кнопкой со значком списка, очищается крестиком |
| Родитель | Справочник/Документ Ссылка | Другое ссылочное поле этого же объекта. Используется для каскадного отбора: после выбора родителя в списке остаются только подчинённые значения |
| Значения перечисления | Перечисление | Список вариантов: имя, значение, добавление и удаление строк |
| Правила фильтрации | Справочник/Документ Ссылка | Кнопка Настроить открывает редактор условий отбора в поле выбора. Показывает «Настроено правил: N» или «Правила не настроены» |
| Себестоимость | Ресурс регистра (при включённом партионном учёте) | Помечает ресурс как хранилище себестоимости — см. Партионный учёт |
| Текст кнопки, Имя обработчика, Вариант, Размер, Только иконка, Иконка, Позиция, Классы CSS | Кнопка | Оформление и поведение кнопки на форме; обработчик — имя функции в модуле объекта |
| Текст надписи, Размер шрифта, Насыщенность, Наклон, Цвет текста, Цвет фона, Выравнивание, На всю ширину | Надпись | Оформление текстовой подписи |
| URL, Ширина, Высота, Заполнение, Рамка, Alt текст | Картинка | Источник и оформление изображения |
# Выражения для расчёта (тип «Число»)
Расчётные поля считаются автоматически при записи и при проведении. В поле Выражение можно писать формулу; ниже в панели выводится список доступных полей — нажатие на кнопку с именем вставляет его в формулу.
Примеры:
| Выражение | Что получится |
|---|---|
SUM([Товары.Сумма]) | Сумма колонки «Сумма» табличной части «Товары» |
[Количество] * [Цена] | Произведение двух реквизитов |
SUM([Товары.Количество]) * [Цена] | Комбинированный расчёт |
Скобки [ ] обязательны, имена пишутся точно как в колонке «Имя».
# Табличные части
Ниже таблицы реквизитов расположен блок «Табличные части» (кнопка Добавить). Табличная часть — это список однотипных строк внутри одной записи: товары в накладной, услуги в акте, сотрудники в документе. Подробнее — Табличные части.
# Правила именования
| Рекомендация | Почему |
|---|---|
| Имя без пробелов и специальных символов | Имя попадает в формулы, модули и SQL-запросы отчётов |
Имя отражает смысл: СуммаСНДС, а не Реквизит3 | Читаемость правил проведения и отчётов |
| Не переименовывать после начала работы | Старые данные и написанные формулы продолжат ссылаться на прежнее имя |
| Для сумм указывать «Сумма», для количества — «Количество» | Есть автоматические механизмы (агрегации журнала, отчёты), которые ищут поля по смыслу |
