Как добавить кнопку «Связанные документы» в 1С: инструкция для разработчиков и пользователей

2. Способ 1: Добавление кнопки через конфигуратор (для администраторов)

Этот метод подходит, если у вас есть права на изменение конфигурации. Мы рассмотрим процесс на примере 1С:Управление торговлей 11.4, но алгоритм аналогичен для большинства типовых решений.

Шаги:

1. Откройте конфигуратор в режиме 1С:Предприятие (не путать с пользовательским режимом!). Для этого:
• 🖥️ Запустите 1С:Предприятие 8.3.
• Выберите нужную базу и нажмите Конфигуратор (или удерживайте Shift при запуске).

• 📌 Нажмите правой кнопкой на панели → Добавить команду.
• Укажите имя команды, например, СвязанныеДокументы.
• В свойствах команды задайте Заголовок = "Связанные документы" и Действие = "ВыполнитьКоманду".

Теперь нужно написать обработчик для кнопки. Перейдите во вкладку Модуль формы и добавьте процедуру:

Процедура СвязанныеДокументы(Команда)
// Получаем текущий документ
ТекущийДокумент = ЭтотОбъект.ТекущийДокумент();

// Формируем запрос для поиска связанных документов
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   СвязанныйДокумент.Ссылка КАК Ссылка,
|   СвязанныйДокумент.Вид() КАК ВидДокумента
|ИЗ
|   Документ.ЗаказПокупателя.СвязанныеДокументы КАК СвязанныйДокумент
|ГДЕ
|   СвязанныйДокумент.Владелец = &ТекущийДокумент";

Запрос.УстановитьПараметр("ТекущийДокумент", ТекущийДокумент);
Результат = Запрос.Выполнить();

// Отображаем результат в таблице
ТаблицаРезультатов = Результат.Выгрузить();
Форма = ТаблицаРезультатов.ПолучитьФорму();
Форма.Открыть();
КонецПроцедуры

Проверьте права доступа (нужны права администратора)

Создайте резервную копию базы (обязательно!)

Убедитесь, что форма документа не заблокирована для изменений

Закройте все сеансы пользователей в базе-->

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

3. Способ 2: Использование внешней обработки (без изменений конфигурации)

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

Алгоритм:

1. Скачайте готовую обработку для добавления кнопки (например, «Связанные документы для УТ 11» с Инфостарта).
2. Откройте 1С в пользовательском режиме и перейдите в Файл → Открыть.
3. Выберите скачанный файл обработки (.epf или .erf).
4. В открывшемся окне обработки укажите:
   • 📋 Тип документа (например, ЗаказПокупателя).
   • 🔗 Параметры связей (если обработка поддерживает настройку).
5. Нажмите Добавить кнопку в форму — обработка автоматически внедрит элемент в интерфейс.

💡 Полезный совет: Перед использованием обработки проверьте её совместимость с вашей версией 1С. Например, обработка для УТ 11.3 может не работать в УТ 11.4 из-за изменений в структуре метаданных.

4. Способ 3: Программное добавление кнопки (для разработчиков)

Этот метод подразумевает написание кода на встроенном языке 1С:Предприятие. Он гибкий и позволяет настроить кнопку под специфические требования бизнес-процессов. Рассмотрим пример для документа ПоступлениеТоваровУслуг.

Код для модуля формы документа:

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

Процедура СвязанныеДокументы(Команда)
ТекущийДокумент = ЭтотОбъект.Объект;

// Используем менеджер связей (если есть в конфигурации)
Если ТипЗнч(ТекущийДокумент.СвязанныеДокументы) = Тип("ДеревоЗначений") Тогда
ТаблицаСвязей = ТекущийДокумент.СвязанныеДокументы();
Иначе
// Альтернативный запрос, если менеджера связей нет
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|   СвязанныйДокумент.Ссылка КАК Ссылка
|ИЗ
|   Документ.ПоступлениеТоваровУслуг.Связи КАК СвязанныйДокумент
|ГДЕ
|   СвязанныйДокумент.Источник = &ТекущийДокумент";

Запрос.УстановитьПараметр("ТекущийДокумент", ТекущийДокумент);
Результат = Запрос.Выполнить();
ТаблицаСвязей = Результат.Выгрузить();
КонецЕсли;

// Открываем форму списка связанных документов
ФормаСписка = ТаблицаСвязей.ПолучитьФорму();
ФормаСписка.Открыть();
КонецПроцедуры

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

Запрос.Текст =
"ВЫБРАТЬ
|   СвязиОбъектов.ОбъектСвязи КАК Ссылка
|ИЗ
|   РегистрСведений.СвязиОбъектов КАК СвязиОбъектов
|ГДЕ
|   СвязиОбъектов.ОбъектИсточник = &ТекущийДокумент";

Для отладки кода используйте Сообщить() или ЗаписьЖурналаРегистрации, чтобы проверить, какие документы попадают в выборку. Например:

Для Каждого Строка Из ТаблицаСвязей Цикл
Сообщить(Строка.Ссылка.Представление());
КонецЦикла;

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

При добавлении кнопки «Связанные документы»** пользователи часто сталкиваются с проблемами. Рассмотрим самые распространённые:

• 🚨 Ошибка: «Метод объекта не обнаружен (ПолучитьСвязанныеДокументы)»
  Причина: В вашей конфигурации не реализован стандартный метод для получения связей.
  Решение: Используйте альтернативный запрос (см. пример в Способе 3) или создайте собственный метод в модуле объекта.
• 🔍 Кнопка не показывает все связанные документы
  Причина: Запрос в коде не учитывает все виды связей (например, только реализации, но не счета).
  Решение: Расширьте условие в запросе или проверьте настройки регистра СвязиОбъектов.
• 🔄 После обновления 1С кнопка исчезла
  Причина: Обновление перезаписало форму документа.
  Решение: Повторно добавьте кнопку через конфигуратор или используйте расширение конфигурации (см. следующий раздел).

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

1. Есть ли у текущего документа реально связанные объекты (откройте их вручную через журнал).
2. Правильно ли указаны параметры в запросе (например, Владелец или Источник).
3. Не блокируются ли связи на уровне прав доступа (проверьте роли пользователя).
Что делать, если кнопка тормозит при открытии?

Если формирование списка связанных документов занимает более 5 секунд, проблема может быть в:

1. Сложном запросе — оптимизируйте его, добавив индексы или ограничив выборку по датам.

2. Большом объёме данных — используйте постраничный вывод (метод `УстановитьДанныеСтраницы`).

3. Блокировках в базе — проверьте активные транзакции через `Администрирование → Монитор производительности`.

6. Альтернативные методы: расширения конфигурации и BSL

Если вы работаете с 1С:ERP 2.5 или КА 2.4, где стандартные формы сильно защищены от изменений, используйте расширения конфигурации. Этот метод позволяет добавлять элементы в интерфейс без редактирования исходного кода.

Инструкция:

1. В конфигураторе выберите Файл → Открыть расширение конфигурации.
2. Создайте новое расширение или откройте существующее.
3. В дереве расширения найдите форму документа (например, Документ.ЗаказПокупателя.Форма.ФормаДокумента).
4. Добавьте новую команду в КоманднаяПанельФормы (аналогично Способу 1).
5. Напишите обработчик в модуле расширения:

   #Если Клиент Тогда
   Процедура СвязанныеДокументы(Команда)
   // Ваш код здесь
   КонецПроцедуры
   #КонецЕсли

6. Сохраните расширение и обновите конфигурацию базы.

Преимущества расширений:

• 🔧 Совместимость с обновлениями 1С (не слетает при апдейтах).
• 🛡️ Безопасность — исходная конфигурация не изменяется.
• 🔄 Легкий откат — достаточно отключить расширение.

Для 1С:Бухгалтерии 3.0 можно использовать BSL-скрипты (Библиотека Стандартных Подсистем). Пример кода для добавления кнопки через BSL:

Процедура ДобавитьКомандуСвязанныеДокументы(Форма)
Команда = Форма.Команды.Добавить("СвязанныеДокументы");
Команда.Заголовок = НСтр("ru = 'Связанные документы'");
Команда.Действие = Новый Действие("СвязанныеДокументыВыполнить");
КонецПроцедуры

Процедура СвязанныеДокументыВыполнить(ПараметрВыполненияКоманды)
// Логика получения связанных документов
КонецПроцедуры

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

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

Шаги по настройке прав:

1. В конфигураторе откройте Администрирование → Пользователи и права.
2. Выберите роль, которой нужно дать доступ (например, Бухгалтер или МенеджерПоПродажам).
3. Перейдите на вкладку Права и найдите раздел Документы.
4. Установите флаги:
   • 📌 Чтение для видов документов, которые должны отображаться в связанных.
   • 📌 Просмотр для формы документа, куда добавляется кнопка.
   • 📌 Использование дополнительных отчётов и обработок (если кнопка реализована через обработку).
5. Сохраните изменения и обновите права пользователей (Администрирование → Обновление информации о правах).

⚠️ Внимание: В некоторых конфигурациях (например, 1С:ERP) права на связанные документы могут регулироваться отдельно через механизм Роли доступа к данным. Проверьте настройки в разделе Администрирование → Настройка прав доступа.

8. Оптимизация работы кнопки для больших баз

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

• 🔧 Индексирование полей: Убедитесь, что в запросе используются индексированные поля (например, Ссылка, Дата, Контрагент).
• 📅 Ограничение по дате: Добавьте в запрос условие по периоду (например, последние 6 месяцев):

  ГДЕ
  СвязанныйДокумент.Дата МЕЖДУ &НачалоПериода И &КонецПериода

• 📊 Кэширование результатов: Сохраняйте список связанных документов в временную таблицу или регистр сведений, если кнопка используется часто.
• ⚡ Асинхронное выполнение: Для тяжелых запросов используйте ВыполнитьАсинхронно(), чтобы не блокировать интерфейс.

Пример оптимизированного запроса для 1С:УТ 11:

Запрос.Текст =
"ВЫБРАТЬ ПЕРВЫЕ 100
|   СвязанныйДокумент.Ссылка КАК Ссылка
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК СвязанныйДокумент
|ГДЕ
|   СвязанныйДокумент.ЗаказПокупателя = &ТекущийДокумент
|   И СвязанныйДокумент.Дата > ДобавитьМесяц(ТекущаяДата(), -6)
|
|УПОРЯДОЧИТЬ ПО
|   СвязанныйДокумент.Дата УБЫВ";

💡 Полезный совет: Если кнопка используется часто, создайте отчёт со связанными документами и разместите его в панели навигации. Это разгрузит форму документа и ускорит работу.

💡

Для баз с более чем 50 000 документов обязательно используйте ограничение по дате и индексированные поля в запросах.

Как проверить, индексировано ли поле?

Откройте конфигуратор → найдите таблицу документа (например, `Документ.РеализацияТоваровУслуг`) → откройте её свойства → вкладка `Данные` → раздел `Индексы`. Если нужного поля нет в списке, добавьте его в индекс.

FAQ: Частые вопросы по кнопке «Связанные документы»

🔹 Можно ли добавить кнопку в мобильное приложение 1С?

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

1. Использования расширений конфигурации с поддержкой мобильного клиента.
2. Настройки отображения через МобильноеПриложениеКлиентСервер.
3. Проверки совместимости с версией платформы (не ниже 8.3.18).

В некоторых случаях проще создать отдельный отчёт для мобильного приложения.

🔹 Почему кнопка не работает в облачной версии 1С?

В облачных решениях (например, 1С:Фреш) ограничены возможности изменения конфигурации. Решения:

• Используйте внешние обработки (если разрешено в тарифе).
• Обратитесь в поддержку 1С для включения функции через дополнительные настройки.
• Используйте отчёты с параметрами вместо кнопки (например, отчёт «Связи документов»).

⚠️ Внимание: В бесплатных тарифах 1С:Фреш изменение интерфейса может быть заблокировано.

🔹 Как сделать, чтобы кнопка показывала только определённые виды документов?

Отредактируйте запрос в обработчике кнопки, добавив фильтр по виду документа. Пример для 1С:БП 3.0:

Запрос.Текст =
"ВЫБРАТЬ
|   СвязанныйДокумент.Ссылка КАК Ссылка
|ИЗ
|   Документ.Связи КАК СвязанныйДокумент
|ГДЕ
|   СвязанныйДокумент.Источник = &ТекущийДокумент
|   И СвязанныйДокумент.ВидДокумента В (&ВидыДокументов)";

Запрос.УстановитьПараметр("ВидыДокументов", Новый Массив(
Тип("Документ.СчетФактураВыданный"),
Тип("Документ.ПлатежноеПоручениеИсходящее")
));

🔹 Можно ли экспортировать список связанных документов в Excel?

Да, для этого модифицируйте обработчик кнопки, добавив экспорт через ЗаписьДанныхXML или ТабличныйДокумент. Пример:

Процедура СвязанныеДокументы(Команда)
// ... (код получения связанных документов)
ТаблицаРезультатов = Результат.Выгрузить();

// Экспорт в Excel
ТабличныйДокумент = Новый ТабличныйДокумент;
ТабличныйДокумент.Вывести(ТаблицаРезультатов);
ТабличныйДокумент.Записать("C:\Temp\СвязанныеДокументы.xlsx", ТипФайлаТабличногоДокумента.XLSX);
КонецПроцедуры

Для автоматизации добавьте в форму кнопку Экспортировать.

🔹 Как убрать кнопку, если она больше не нужна?

Способ удаления зависит от метода добавления:

• 🔧 Через конфигуратор: Откройте форму документа и удалите команду из КоманднаяПанельФормы.
• 📄 Через обработку: Удалите файл обработки (.epf) из списка внешних обработок.
• 🔄 Через расширение: Отключите расширение в конфигураторе (Файл → Расширения конфигурации).

После удаления обновите конфигурацию базы (Конфигурация → Обновить конфигурацию базы данных).