Объекты метаданных: константы, справочники, документы, перечисления

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

Константы и справочники

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

• Иерархия: справочник можно разбить на группы (Иерархия групп и элементов) — тогда появляются реквизиты Родитель и ЭтоГруппа. Например, «Напитки → Чай».
• Владелец: справочник может быть подчинён другому, например договоры принадлежат контрагенту.
• Реквизиты и табличные части: собственные поля (Цена, Единица) и списки строк (например, штрихкоды товара).
• Предопределённые элементы создаются в конфигураторе и доступны в коде по имени: Справочники.Склады.Основной.

// Новый элемент справочника
НовыйТовар = Справочники.Товары.СоздатьЭлемент();
НовыйТовар.Наименование = "Çay 100 q";
НовыйТовар.Цена = 3.5;
НовыйТовар.Записать();

// Поиск и изменение существующего элемента
ТоварСсылка = Справочники.Товары.НайтиПоНаименованию("Çay 100 q");
Если Не ТоварСсылка.Пустая() Тогда
    ТоварОбъект = ТоварСсылка.ПолучитьОбъект();
    ТоварОбъект.Цена = 4;
    ТоварОбъект.Записать();
КонецЕсли;

// Константа
Валюта = Константы.ОсновнаяВалюта.Получить();

Документы

Документ фиксирует хозяйственную операцию, произошедшую в определённый момент: поступление товара, продажу, оплату. Его стандартные реквизиты — Номер, Дата, Проведен и ПометкаУдаления. Номера присваиваются автоматически и могут, например, начинаться заново каждый год. Главная способность документа — проведение: проведённый документ формирует движения в регистрах — это мы разберём в отдельном уроке.

1. 1
   Добавь документ

   Документы → Добавить, имя: ПриходТовара. Синоним автоматически станет «Приход товара». Отметь подсистему Склад.

2. 2
   Создай табличную часть

   На закладке Данные: Табличные части → Товары, реквизиты: Товар (тип СправочникСсылка.Товары), Количество, Цена, Сумма (Число).

3. 3
   Проверь

   Нажми F5, создай новый документ в разделе Склад и добавь несколько строк в табличную часть. Форму платформа построила автоматически — ты её не рисовал.

Приход = Документы.ПриходТовара.СоздатьДокумент();
Приход.Дата = ТекущаяДатаСеанса();

НоваяСтрока = Приход.Товары.Добавить();
НоваяСтрока.Товар = Справочники.Товары.НайтиПоНаименованию("Çay 100 q");
НоваяСтрока.Количество = 10;
НоваяСтрока.Цена = 4;
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;

Приход.Записать();  // номер присвоится автоматически

Перечисления и другие объекты

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