Как сделать простой документ в 1С 8

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

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

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

Подготовка: копия базы и доступ к конфигуратору

Любые изменения структуры метаданных делаются только в тестовой копии. Создайте резервную копию через «Администрирование — Выгрузить информационную базу» в режиме предприятия или скопируйте файл 1Cv8.1CD для файловой базы. Если что-то пойдёт не так, восстановление займёт минуты, а не дни.

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

Откройте конфигуратор, войдите в тестовую базу и выполните «Конфигурация — Открыть конфигурацию». Дерево метаданных — основной инструмент дальнейшей работы.

Создание объекта «Документ» в дереве конфигурации

В дереве конфигурации найдите ветку «Документы», нажмите правой кнопкой и выберите «Добавить». Откроется палитра свойств нового объекта. Задайте имя латиницей без пробелов, например ВыдачаМатериалов, — синоним (отображаемое название) платформа сформирует автоматически.

На закладке «Нумерация» проверьте длину номера и периодичность. Для большинства документов подходит автонумерация и периодичность «В пределах года» — тогда каждый год нумерация начнётся заново. Если номер должен быть уникальным без привязки к периоду, выберите «В пределах базы».

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

Добавление реквизитов и табличной части

Реквизиты шапки добавляются на закладке «Данные». Нажмите «Добавить реквизит» и укажите имя и тип. Для простого документа обычно достаточно: «Сотрудник» (тип — СправочникСсылка.Сотрудники или ФизическиеЛица), «Склад» (СправочникСсылка.Склады), «Комментарий» (Строка неограниченной длины).

Если документ содержит список строк — например, перечень выдаваемых материалов — добавьте табличную часть через «Добавить табличную часть». Внутри неё создайте реквизиты: «Номенклатура» (СправочникСсылка.Номенклатура), «Количество» (Число, длина 15, точность 3), «Цена» (Число, 15.2). Реквизит «Сумма» можно посчитать автоматически в модуле формы.

Проверьте свойство «Проверка заполнения» у обязательных реквизитов: значение «Выдавать ошибку» не даст провести документ с пустым полем. Это простейшая защита от неполных данных без единой строки кода.

1. 1
   Создайте копию базы и откройте её в конфигураторе
2. 2
   В ветке «Документы» добавьте новый объект и задайте имя
3. 3
   Настройте нумерацию и режим проведения
4. 4
   Добавьте реквизиты шапки и табличную часть
5. 5
   Создайте форму документа через конструктор
6. 6
   Обновите конфигурацию базы данных (F7)
7. 7
   Проверьте создание и проведение документа в режиме предприятия

Создание формы документа

На закладке «Формы» нажмите кнопку добавления у «Основная форма документа». Запустится конструктор: оставьте тип «Форма документа» и нажмите «Готово». Платформа автоматически разместит все реквизиты и табличную часть на форме.

В редакторе формы перетащите элементы в удобном порядке: сначала номер и дата (они добавляются платформой автоматически), затем реквизиты шапки, ниже — табличная часть. Для колонки «Сумма» можно добавить автоподсчёт: в модуле формы создайте обработчик события «ПриИзменении» у поля количества и напишите расчёт.

&НаКлиенте
Процедура МатериалыКоличествоПриИзменении(Элемент)
    Строка = Элементы.Материалы.ТекущиеДанные;
    Строка.Сумма = Строка.Количество * Строка.Цена;
КонецПроцедуры

Если форма не нужна с индивидуальной логикой, можно вообще не создавать её — платформа сгенерирует форму автоматически при открытии. Но явная форма удобнее для доработок.

Проведение и движения по регистрам

Если документ должен влиять на учёт — например, списывать остатки — нужен регистр. Для простого случая создайте регистр сведений или регистр накопления «ОстаткиМатериалов» с измерением «Номенклатура» и ресурсом «Количество». В свойствах документа на закладке «Движения» отметьте этот регистр галочкой.

Нажмите кнопку «Конструктор движений» в модуле объекта — платформа сама сформирует код проведения по табличной части. Для простого документа этого достаточно: конструктор создаст цикл по строкам и запись движений.

Помните: конструктор затирает существующий код процедуры «ОбработкаПроведения». Если вы уже дописывали логику вручную, сохраните её перед запуском конструктора.

Обновление конфигурации и проверка результата

Нажмите F7 («Обновить конфигурацию базы данных»). Платформа покажет список изменений структуры — подтвердите. При появлении окна реструктуризации дождитесь завершения, не прерывая процесс: прерывание может повредить базу.

Запустите режим предприятия (F5 или «Сервис — 1С:Предприятие»). Новый документ появится в меню, если вы добавили его в подсистему на закладке «Подсистемы» свойств документа. Без подсистемы найти его можно через «Все функции — Документы».

Создайте документ, заполните реквизиты, добавьте строки в табличную часть и проведите. Затем откройте движения документа (кнопка «Перейти — Движения» или журнал регистров) и убедитесь, что записи появились.

Альтернатива: расширение конфигурации вместо изменения

Если конфигурация типовая и находится на поддержке, правильный путь — расширение. Через «Конфигурация — Расширения конфигурации» создайте новое расширение и добавьте документ в него. Структура основной конфигурации не меняется, обновления проходят штатно, а ваш объект живёт отдельно.

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

Частые вопросы