К статье
Практический материал

Другое · 7 мин

Кнопка ввода на основании в документе 1С

Практическая инструкция по добавлению кнопки ввода на основании в документ 1С: настройка в конфигураторе, команды формы, права доступа, проверка и частые ошибки.

Задача добавить кнопку ввода на основании возникает, когда пользователю нужно быстро создать новый документ, опираясь на данные текущего. В 1С это реализуется через командную панель формы документа: команда вызывается из модуля формы, а при нажатии формируется целевой документ с заполнением реквизитов из источника. Стандартная функция «Ввод на основании» уже присутствует во многих конфигурациях, но собственная кнопка оправдана, если логика заполнения нестандартная или требуется дополнительная проверка.

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

Кнопка должна быть доступна только тем ролям, которым разрешено создавать целевой документ, и только в тех состояниях исходного документа, когда ввод на основании логически допустим. Например, для проведенного или закрытого документа создание нового на его основании может быть недопустимо. Результат проверяется в режиме предприятия: открывается документ-источник, нажимается кнопка, открывается форма нового документа с заполненными полями.

Что понимать под кнопкой ввода на основании

Это команда на форме документа, которая инициирует создание другого документа, используя текущий как источник данных. В типичном сценарии открывается форма нового документа, поля заполняются значениями из исходного, а пользователь только корректирует и проводит созданный документ. Стандартный механизм 1С часто реализует такой ввод автоматически, но собственная кнопка нужна при нестандартном наборе реквизитов, дополнительных условиях или интеграции с другими подсистемами.

Кнопка не меняет саму структуру документа-источника и не записывает его повторно, если в обработке не предусмотрено дополнительное сохранение. Она только порождает новый объект. Поэтому риск повреждения исходного документа при корректной реализации минимален, но ошибки в модуле формы могут привести к неполному заполнению или отказу в создании целевого документа.

Где настраивается кнопка в конфигураторе

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

Важно различать клиентский и серверный контекст. Создание документа и запись лучше выполнять на сервере или через сеанс, а получение данных текущего документа — в клиентской части формы. Используйте синтаксис-помощник конфигуратора для проверки имен свойств и методов, так как опечатки в именах реквизитов приводят к ошибкам во время выполнения.

Порядок добавления команды
  1. 1
    Откройте документ и его форму в конфигураторе.Добавьте команду на командную панель формы с уникальным именем.Напишите обработчик нажатия в модуле формы.Настройте права доступа и условие видимости команды.Проверьте в режиме предприятия на копии конфигурации.

Управляемая форма

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

Обычная форма

В обычных формах кнопка размещается на командной панели, а обработка нажатия пишется в процедуре формы с параметром кнопки. Логика создания документа аналогична, но взаимодействие с формой может отличаться от управляемого приложения. Перед внесением изменений уточните тип используемой формы, так как перенос кода между управляемой и обычной формой без доработки не работает.

Права, роли и видимость команды

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

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

Как проверить результат и ограничения

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

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

Альтернативы и частые ошибки

Вместо собственной кнопки можно использовать стандартный ввод на основании, если он покрывает нужную логику, либо отчёт с действием над выбранными документами. Частые ошибки: опечатки в именах реквизитов, отсутствие проверки обязательных полей, попытка записи документа без прав, игнорирование состояния источника и правка без резервной копии. Также не рекомендуется дублировать стандартную команду без видимой пользы для пользователя.

Если после добавления кнопки пользователи жалуются на исчезновение команды после обновления, причина может быть в перезаписи объекта конфигурации. В этом случае изменения нужно перенести в расширение или повторно применить после релиза с проверкой совместимости.

Итог

Что важно запомнить

Кнопка добавляется через команду формы документа, проверяется в режиме предприятия, защищается правами и тестируется на копии конфигурации перед вводом в эксплуатацию.

Нужно ли программирование для стандартного ввода на основании?

Если стандартный механизм 1С уже реализует создание целевого документа из текущего, отдельная кнопка и программирование могут не потребоваться. Собственная кнопка оправдана при нестандартном наборе полей, дополнительных проверках или особых правах доступа.

Можно ли добавить кнопку в типовую конфигурацию без доработки поставщика?

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

Почему кнопка может не отображаться у некоторых пользователей?

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

Что делать, если созданный документ не сохраняется?

Проверьте заполнение обязательных реквизитов, права пользователя на запись целевого документа и корректность обработчика нажатия. Журнал регистрации и сообщения об ошибках помогут найти причину, а тестовый пример на копии конфигурации позволит безопасно воспроизвести проблему.