Другое · 6 мин
Как добавить кнопку движения документа в 1С
Пошаговая инструкция по добавлению кнопки движений документа в 1С: где стандартная кнопка, как создать команду, проверить результат и избежать ошибок.
Кнопка движения документа в 1С открывает сводку изменений, которые документ вносит в регистры накопления, бухгалтерии и другие регистры при проведении. Она помогает быстро проверить, какие суммы и по каким аналитикам записались, без открытия отдельных отчётов.
В типовой конфигурации такая кнопка уже может присутствовать на панели действий формы документа. Если её нет, добавить свою команду можно средствами конфигуратора, не меняя поставляемую конфигурацию напрямую — лучше использовать расширение конфигурации.
Ниже разбирается порядок добавления кнопки движения на форму документа, условия появления стандартной команды и способы проверки, что движение действительно открывается.
Что показывает кнопка движения документа
Кнопка движения предназначена для просмотра регистровых записей, которые создаёт документ в момент проведения. Это могут быть движения по остаткам товаров, расчётам с контрагентами, налогам или производственным ресурсам в зависимости от конфигурации.
Открытая форма движений обычно содержит таблицу с измерениями, ресурсами и периодами. Пользователь может отфильтровать данные по документу, увидеть регистр и проверить корректность проводок без перехода в отдельные отчёты.
Где находится стандартная кнопка движений
В управляемых формах команда движения часто размещается на панели действий формы документа или в меню «Ещё». Её наличие зависит от того, настроен ли документ на создание движений в регистрах накопления и бухгалтерии.
Если документ не формирует регистровые записи, стандартная кнопка движения может отсутствовать или быть скрыта. Это не неисправность, а следствие отсутствия движений для показа.
- 1Откройте конфигурацию в режиме правки и создайте расширение конфигурации
- 2Перейдите к форме нужного документа и добавьте команду на панель действий
- 3Напишите обработчик команды, который открывает форму движений документа
- 4Сохраните расширение, обновите конфигурацию и проверьте кнопку в пользовательском режиме
Когда нужно добавлять собственную кнопку
Своя кнопка оправдана, если стандартной команды нет, она скрыта правами доступа, либо нужно открывать движения с предустановленными фильтрами по текущему документу. Также кнопка полезна, когда форма документа упрощена и стандартная панель действий не отображается.
Не стоит дублировать стандартную кнопку, если она уже работает: это только усложняет поддержку и может запутать пользователей. Лучше проверить права и настройки формы перед созданием новой команды.
Как добавить кнопку на форму документа
Откройте конфигуратор, создайте расширение конфигурации и включите в него форму документа. На панели действий формы добавьте новую команду, укажите ей представление и картинку по выбору.
В модуле формы опишите процедуру обработчика команды. В ней получите ссылку на текущий документ и вызовите механизм открытия формы движений, передав документ в качестве параметра.
Программная реализация вывода движений
Реализация зависит от типа приложения: управляемое или обычное. В управляемом приложении форма движений открывается через стандартные методы платформы с указанием регистра и отбора по документу.
Перед открытием убедитесь, что документ проведён: у непроведённого документа движений нет, и форма может открыться пустой. Это нормальное поведение, а не ошибка кода.
Проверка результата и типичные ошибки
После обновления конфигурации откройте документ в пользовательском режиме, проведите его и нажмите новую кнопку. Должна открыться форма с движениями по выбранному документу.
Если форма пустая, проверьте, создаёт ли документ движения в регистрах, и соответствует ли отбор в коде номеру документа. Пустая таблица часто означает отсутствие движений, а не поломку кнопки.
Ограничения и безопасные границы самостоятельной работы
Самостоятельная правка допустима для добавления команд и вывода существующих движений. Создание новых регистров или изменение структуры движений требует глубокого понимания конфигурации и может нарушить учёт.
Работайте на копии базы или в тестовой среде. Перед внесением изменений в рабочую базу сделайте резервную копию и согласуйте правки с ответственным за конфигурацию сотрудником.
Как проверить результат
Кнопка видна и активна после проведения документа
Кнопка отсутствует или не реагирует на нажатие
Открыта таблица с записями по текущему документу
Форма не открывается или открывается пустая при наличии движений
Альтернативы кнопке движения
Если программировать кнопку нет возможности, можно использовать стандартный отчёт по регистрам с отбором по документу. Это требует больше действий пользователя, но не требует изменения конфигурации.
Другой вариант — встроенная команда «Движения», если она есть в конфигурации. Перед созданием своей кнопки убедитесь, что стандартная команда действительно недоступна для данного документа.
Что важно запомнить
Кнопку движения добавляют через расширение конфигурации, проверяют на проведённом документе и не правят поставляемую конфигурацию напрямую.
Можно ли добавить кнопку движения без программирования?
Создать новую команду на форме документа без кода не получится, но иногда стандартная кнопка движений уже есть и просто скрыта из-за прав доступа или настроек формы. В таких случаях достаточно включить команду или выдать соответствующие права, не внося изменений в конфигурацию.
Почему кнопка движения не видна на форме документа?
Самая частая причина — документ не создаёт движения в регистрах, поэтому платформа не отображает команду. Также кнопка может быть скрыта правами пользователя, убрана с панели действий или форма документа может быть упрощённой без стандартной панели.
Что делать, если форма движений открывается пустой?
Пустая форма обычно означает, что у выбранного документа нет зарегистрированных движений, например документ не проведён. Также стоит проверить отбор в коде обработчика: если он ищет движения по другому полю или неверному номеру документа, результатов не будет.
Нужно ли править типовую конфигурацию напрямую?
Нет, прямое изменение поставляемой конфигурации небезопасно: при обновлении правки могут исчезнуть или вызвать конфликты. Правильный путь — создать расширение конфигурации, добавить в него форму документа и новую команду, а затем обновить конфигурацию в рабочей базе.
Одна кнопка подходит для нескольких документов?
Кнопка привязана к конкретной форме документа, поэтому для каждого вида документа нужно добавлять свою команду на его форму. Логика обработчика может быть схожей, но сама кнопка и её параметр — документ — относятся к отдельной форме.