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