Добавление кнопки «Ввод на основании» в документ 1С: инструкция для программистов и администраторов

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

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

Все инструкции актуальны для платформы 1С:Предприятие 8.3 (включая последние релизы), но основные принципы применимы и к более ранним версиям. Если вы работаете с управляемыми формами или обычными формами — найдёте решения для обоих случаев.

1. Подготовка: что нужно знать перед добавлением кнопки

Прежде чем приступать к редактированию конфигурации, убедитесь, что вы понимаете несколько ключевых моментов:

• 📌 Тип документа-источника. Кнопка «Ввод на основании» создаётся для конкретного документа (например, Заказ клиента). Уточните, какой именно документ будет источником.
• 📌 Целевые документы. Решите, какие документы должны создаваться на основании исходного (например, Реализация товаров, Счёт на оплату).
• 📌 Права пользователей. Проверьте, что у ролей, которые будут использовать кнопку, есть права на создание целевых документов.
• 📌 Версия платформы. В управляемых формах (8.3+) и обычных формах (8.2) настройка отличается.

Если вы добавляете кнопку в типовую конфигурацию (например, 1С:Бухгалтерия 3.0 или 1С:УТ 11), учтите, что после обновления конфигурации ваши изменения могут сброситься. В таком случае лучше использовать расширения конфигурации или внешние обработки.

⚠️ Внимание: Если документ-источник уже имеет кнопку «Ввод на основании», но она не отображается у пользователей, проблема может быть в настройках ролей или интерфейса. Проверьте права в разделе Администрирование → Настройка прав пользователей.

Также стоит заранее определить, нужна ли вам стандартная кнопка (которая создаёт документы по шаблонам 1С) или кастомная (с уникальной логикой заполнения полей). Во втором случае потребуется написать обработчик на языке 1С:Предприятие.

2. Добавление кнопки в управляемых формах (1С 8.3)

В современных конфигурациях на платформе 8.3 используются управляемые формы. Чтобы добавить кнопку «Ввод на основании», выполните следующие шаги:

1. Откройте конфигуратор 1С в режиме Конфигуратор (права администратора обязательны).

2. Найдите документ, в который нужно добавить кнопку, в дереве объектов (раздел Объекты → Документы).

3. Откройте форму документа (обычно это ФормаДокумента или ФормаОбъекта).

4. Перейдите на вкладку Команды и добавьте новую команду с именем ВводНаОсновании.

5. Настройте свойства команды:

   • 🔹 Имя: ВводНаОсновании
   • 🔹 Заголовок: «Ввод на основании»
   • 🔹 Действие: выберите ВводНаОсновании из списка стандартных действий.
   • 🔹 Использование: Командный интерфейс и Мобильное приложение (если нужно).

6. Сохраните команду и перейдите на вкладку Форма. Добавьте кнопку на панель инструментов или в командную панель формы, привязав её к созданной команде.

Если кнопка не появляется после сохранения, проверьте:

• 🔸 Наличие команды в списке Действия формы.
• 🔸 Видимость кнопки в настройках интерфейса (Все действия → Настройка интерфейса).
• 🔸 Права пользователя на выполнение команды (раздел Администрирование → Роли).

Команда добавлена в раздел "Команды" формы|Кнопка привязана к команде в интерфейсе|Права на команду назначены ролям пользователей|Форма сохранена и обновлена-->

3. Настройка списка документов для ввода на основании

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

Для этого:

1. В конфигураторе откройте объект документа, для которого настраиваете кнопку.

2. Перейдите на вкладку Ввод на основании.

3. Добавьте новые строки в таблицу, указав:

   • 📄 Тип документа (например, РеализацияТоваровУслуг).
   • 🔄 Процедура заполнения (можно оставить стандартную или написать свою).
   • 🔒 Условие доступности (например, только для документов в статусе Проведён).

Пример заполнения таблицы для документа Заказ клиента:

Тип документа	Процедура заполнения	Условие доступности
РеализацияТоваровУслуг	ЗаполнитьНаОснованииЗаказКлиента	Статус = ЗначениеПеречисления.СтатусыДокументов.Проведён
СчётНаОплату	ЗаполнитьСчётНаОплату	Истина
ВозвратТоваровОтКлиента	ЗаполнитьВозвратПоЗаказу	Статус = ЗначениеПеречисления.СтатусыДокументов.Проведён И НЕ ПустаяСсылка(Контрагент)

Если вам нужна своя процедура заполнения, создайте её в модуле документа. Например:

Процедура ЗаполнитьНаОснованииЗаказКлиента(ДокументОснование, НовыйДокумент) Экспорт
НовыйДокумент.Контрагент = ДокументОснование.Контрагент;
НовыйДокумент.Договор = ДокументОснование.Договор;
// Дополнительная логика заполнения
КонецПроцедуры

⚠️ Внимание: Если вы используете расширение конфигурации, процедуры заполнения должны быть описаны в модуле расширения, а не в основном коде. Иначе после обновления конфигурации они пропадут.

4. Добавление кнопки в обычных формах (1С 8.2)

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

1. Откройте форму документа в конфигураторе (раздел Объекты → Документы → [ВашДокумент] → Формы).

2. Добавьте на форму кнопку (Элементы формы → Кнопка).

3. Настройте свойства кнопки:

   • 📌 Имя: КнопкаВводНаОсновании
   • 📌 Заголовок: «Ввод на основании»
   • 📌 Действие: выберите ВводНаОсновании из списка.

4. Разместите кнопку на панели инструментов или в нужном месте формы.

Для обычных форм также доступна настройка списка документов для ввода на основании (аналогично управляемым формам), но находится она в свойствах самого документа, а не формы.

Если кнопка не работает, проверьте:

• 🔹 Привязку кнопки к действию ВводНаОсновании.
• 🔹 Наличие процедур заполнения для целевых документов.
• 🔹 Права пользователя на создание документов.
Что делать, если кнопка не отображается в 1С 8.2?

В обычных формах кнопка может скрываться из-за настроек видимости. Проверьте:

1. Свойство Видимость кнопки (должно быть Истина).

2. Наличие кнопки в коллекции ЭлементыФормы.

3. Отсутствие кода в модуле формы, который программно скрывает кнопку (например, по условию Если НЕ Проведён Тогда...).

5. Типичные ошибки и их решения

Даже опытные программисты 1С сталкиваются с проблемами при настройке кнопки «Ввод на основании». Разберём самые распространённые ошибки и способы их исправления:

Ошибка 1: Кнопка не отображается у пользователей

• 🔧 Причина: Отсутствуют права на команду или документ.
• 🔧 Решение: Проверьте роль пользователя в Администрирование → Пользователи и права. Добавьте права на команду ВводНаОсновании и создание целевых документов.

Ошибка 2: Кнопка есть, но при нажатии ничего не происходит

• 🔧 Причина: Не настроена процедура заполнения или отсутствует связь с документом.
• 🔧 Решение:
  1. Убедитесь, что в таблице Ввод на основании указаны корректные типы документов.
  2. Проверьте, что процедура заполнения экспортирована (ключевое слово Экспорт).

Ошибка 3: При создании документа поля не заполняются

• 🔧 Причина: Ошибка в процедуре заполнения или неверные ссылки на реквизиты.
• 🔧 Решение:
  1. Откройте процедуру заполнения в отладчике (Отладка → Начать отладку).
  2. Проверьте, что имена реквизитов в коде совпадают с именами в целевом документе.

Ошибка 4: Кнопка дублируется или отображается дважды

• 🔧 Причина: Кнопка добавлена и в форму, и в командный интерфейс.
• 🔧 Решение: Удалите дублирующую кнопку (либо из формы, либо из командного интерфейса).

Если проблема не решена, проверьте журнал регистрации (Администрирование → Журнал регистрации) на наличие ошибок при выполнении команды.

6. Дополнительные возможности: кастомизация кнопки

Стандартная кнопка «Ввод на основании» покрывает большинство задач, но иногда требуется расширенная функциональность. Рассмотрим несколько сценариев:

1. Динамический список документов

Если список документов для ввода должен зависеть от условий (например, от типа контрагента), модифицируйте процедуру обработки команды:

Процедура КнопкаВводНаОснованииНажатие(Кнопка)
СписокДокументов = Новый СписокЗначений;

Если ДокументОбъект.Контрагент.ЭтоГруппа Тогда
СписокДокументов.Добавить("ЗаказПоставщику");
Иначе
СписокДокументов.Добавить("РеализацияТоваровУслуг");
СписокДокументов.Добавить("СчётНаОплату");
КонецЕсли;

ВводНаОсновании(СписокДокументов, ДокументОбъект.Ссылка);
КонецПроцедуры

2. Предзаполнение полей по сложной логике

Если стандартного заполнения недостаточно, напишите свою процедуру. Например, для автоматического расчёта цены с учётом скидки:

Процедура ЗаполнитьРеализациюСоСкидкой(ДокументОснование, НовыйДокумент) Экспорт
НовыйДокумент.Контрагент = ДокументОснование.Контрагент;

Для Каждого Строка Из ДокументОснование.Товары Цикл
НоваяСтрока = НовыйДокумент.Товары.Добавить();
НоваяСтрока.Номенклатура = Строка.Номенклатура;
НоваяСтрока.Количество = Строка.Количество;
НоваяСтрока.Цена = Строка.Цена * (1 - ДокументОснование.Скидка/100);
КонецЦикла;
КонецПроцедуры

3. Скрытие кнопки по условию

Если кнопка должна отображаться только для определённых документов (например, только для проведённых), добавьте условие в свойство Видимость:

Процедура ПриОткрытии()
КнопкаВводНаОсновании.Видимость = (ДокументОбъект.Проведён);
КонецПроцедуры

⚠️ Внимание: При кастомизации кнопки через код убедитесь, что ваши изменения не конфликтуют с типовыми механизмами. Например, если вы переопределяете процедуру ВводНаОсновании, сохраните вызов стандартной обработки через ВводНаОснованииСтандартный().

7. Тестирование и отладка

После добавления кнопки обязательно протестируйте её работу в пользовательском режиме:

1. Откройте документ, для которого добавили кнопку.

2. Убедитесь, что кнопка видна и активна (не затенена).

3. Нажмите на кнопку и проверьте, что открывается список доступных документов.

4. Создайте новый документ на основании и убедитесь, что поля заполнены корректно.

5. Проверьте работу кнопки для документов в разных статусах (например, Не проведён, Проведён).

Если возникают ошибки, используйте отладчик 1С:

• 🔍 Запустите отладку (Отладка → Начать отладку).
• 🔍 Установите точку останова в процедуре заполнения.
• 🔍 Пошагово выполните код, чтобы найти ошибку.

Типичные проблемы на этапе тестирования:

• 🚨 Ошибка доступа — проверьте права.
• 🚨 Не заполняются реквизиты — проверьте имена полей в процедуре.
• 🚨 Кнопка неактивна — проверьте условие доступности.

8. Альтернативные способы добавления кнопки

Если редактирование конфигурации невозможно (например, в облачной версии 1С или при отсутствии прав), рассмотрите альтернативные методы:

1. Внешняя обработка

Создайте внешнюю обработку с кнопкой «Ввод на основании» и подключите её к документу через:

• 📎 Файл → Открыть → Добавить внешнюю обработку.
• 📎 Настройку подключаемых обработок в конфигураторе.

2. Расширение конфигурации

Если вы работаете с типовой конфигурацией, используйте расширения:

1. Создайте новое расширение (Конфигурация → Расширения → Добавить).
2. Добавьте в него команду и кнопку для нужного документа.
3. Подключите расширение к базе.

3. Настройка через «Все функции»

В некоторых конфигурациях (например, 1С:УТ 11) кнопку можно добавить через:

• 🔧 Все функции → Настройка интерфейса → Командный интерфейс.
• 🔧 Найдите команду ВводНаОсновании и добавьте её в нужную форму.

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

FAQ: Частые вопросы по кнопке «Ввод на основании»

Можно ли добавить кнопку «Ввод на основании» в справочник, а не в документ?

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

Как сделать, чтобы кнопка отображалась только для определённой роли?

Настройте видимость кнопки через код в модуле формы:

Процедура ПриОткрытии()
КнопкаВводНаОсновании.Видимость = Пользователь.Роли.Найти("Администратор") <> Неопределён;
КонецПроцедуры

Или ограничьте права на команду ВводНаОсновании в настройках ролей.

Почему при нажатии на кнопку появляется пустой список документов?

Это означает, что в таблице Ввод на основании для документа не настроены целевые типы документов. Откройте документ в конфигураторе и заполните таблицу (см. раздел 3).

Можно ли изменить порядок документов в списке «Ввод на основании»?

Да, порядок определяется последовательностью строк в таблице Ввод на основании. Переместите строки в нужном порядке в конфигураторе.

Как добавить свою иконку для кнопки?

В управляемых формах настройте свойство Картинка команды. В обычных формах используйте свойство Изображение кнопки. Иконки можно выбрать из стандартной библиотеки 1С или загрузить свои (формат .png, размер 16x16 или 32x32 пикселя).