Как добавить внешнюю обработку или дополнительный отчет в Избранное в 1С?

Программист 1С v8.3 (Управляемые формы) Торговля и дистрибуция
← К списку

При работе в системе 1С часто возникает необходимость быстрого доступа к наиболее востребованным отчетам или обработкам. Раздел «Избранное» — это удобный механизм для таких целей. Однако, когда речь заходит о внешних обработках и дополнительных отчетах, которые не являются частью типовой конфигурации, возникают вопросы о том, как их эффективно включить в этот список. В этой статье мы подробно разберем, как добавить внешнюю обработку или дополнительный отчет в Избранное, используя как пользовательские, так и программные методы.

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

Подготовка внешней обработки или отчета для добавления в Избранное

Прежде чем мы перейдем к методам добавления, важно понять, что внешняя обработка или отчет должны быть правильно подготовлены. Это ключевой момент, который позволит системе 1С корректно работать с ними и включать в список Избранного.

Мы рассмотрим подробнее, что необходимо указать в метаданных вашей внешней обработки:

  1. Сведения о внешней обработке: В модуле объекта внешней обработки необходимо корректно заполнить так называемые «Сведения о внешней обработке». Эти данные сообщают системе 1С о типе и назначении вашего инструмента.
  2. Обязательные параметры:
    • Вид: Определяет, является ли ваш файл «ДополнительнымОтчетом» или «ДополнительнойОбработкой». Это важно для правильной категоризации в системе.
    • Наименование: Название, под которым обработка будет отображаться в списке дополнительных отчетов/обработок и, соответственно, в Избранном. Убедитесь, что оно уникально и понятно.
    • Команды: Это таблица, описывающая, как должна запускаться обработка. Для каждой команды указываются:
      • Представление: Текст, который будет виден пользователю.
      • Идентификатор: Уникальный строковый идентификатор команды.
      • Использование: Определяет действие команды, например, «ОткрытиеФормы» для открытия основной формы обработки, или «ВызовКлиентскогоМетода»/«ВызовСерверногоМетода» для запуска определенных процедур.

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

Метод 1: Добавление через пользовательский интерфейс 1С

Наиболее простой и очевидный способ для конечного пользователя – это использование стандартных механизмов интерфейса 1С. Разберем по шагам, как это сделать после того, как внешняя обработка была зарегистрирована в базе и доступна для запуска:

  1. Регистрация внешней обработки:

    Прежде всего, ваша внешняя обработка должна быть зарегистрирована в базе 1С через раздел «Администрирование» -> «Печатные формы, отчеты и обработки» -> «Дополнительные отчеты и обработки». Здесь вы указываете файл обработки, ее наименование, назначение и разделы программы, в которых будет доступна команда для ее запуска. После регистрации обработка становится доступной в соответствующих разделах программы (например, в меню «Сервис» или в других функциональных разделах, где вы ее разместили).

  2. Открытие обработки:

    Откройте внешнюю обработку или отчет, перейдя в раздел, где вы ее разместили, и выбрав соответствующую команду.

  3. Добавление в Избранное с помощью кнопки «звездочка»:

    В открывшейся форме обработки обратите внимание на верхнюю часть окна. Обычно там присутствует кнопка в виде звезды. Нажатие на эту кнопку (или использование сочетания клавиш Ctrl+D) позволяет добавить текущий объект в список Избранного.

  4. Добавление через меню «Получить ссылку»:

    Другой вариант – находясь в открытой форме обработки, нажмите кнопку «Получить ссылку» (или используйте сочетание клавиш Ctrl+F11). В открывшемся диалоговом окне выберите опцию «Добавить в Избранное».

  5. Добавление через Главное меню (в некоторых версиях):

    В некоторых версиях 1С можно воспользоваться Главным меню: «Главное меню» -> «Сервис» -> «Добавить в Избранное».

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

Метод 2: Программное добавление внешней обработки в Избранное

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

Для программного добавления мы будем использовать объект УправлениеВнешнимиОбработками, который предоставляет методы для работы с зарегистрированными внешними обработками и отчетами.

  1. Создание объекта «Управление внешними обработками»:

    Сначала нам нужно получить экземпляр объекта УправлениеВнешнимиОбработками. Это позволит нам взаимодействовать с подсистемой управления внешними отчетами и обработками.

  2. Получение информации о внешней обработке:

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

  3. Добавление в Избранное:

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

Посмотрим на пример кода, который можно использовать:


// &НаСервере
Процедура ДобавитьОбработкуВИзбранноеНаСервере(ИмяОбработки)
    // Получаем объект "Управление внешними обработками"
    УправлениеОбработками = УправлениеВнешнимиОбработками.Создать();

    // Получаем информацию о внешней обработке по ее имени
    Обработка = УправлениеОбработками.ПолучитьОбработку(ИмяОбработки);

    // Проверяем, что обработка найдена
    Если Обработка <> Неопределено Тогда
        // Добавляем обработку в избранное
        УправлениеОбработками.ДобавитьВИзбранное(Обработка);

        // Сообщаем об успешном добавлении (опционально)
        Сообщение = Новый СообщениеПользователю;
        Сообщение.Текст = "Обработка '" + ИмяОбработки + "' успешно добавлена в избранное.";
        Сообщение.Сообщить();
    Иначе
        // Обработка не найдена
        Сообщение = Новый СообщениеПользователю;
        Сообщение.Текст = "Обработка '" + ИмяОбработки + "' не найдена.";
        Сообщение.Сообщить();
    КонецЕсли;
КонецПроцедуры

// &НаКлиенте
Процедура КомандаДобавитьВИзбранное(Команда)
    // Задаем имя внешней обработки, которую нужно добавить в избранное
    // ВНИМАНИЕ: Замените "ИмяВнешнейОбработки" на точное наименование вашей обработки,
    // под которым она зарегистрирована в справочнике "Дополнительные отчеты и обработки".
    ИмяОбработки = "МояСуперОбработкаДляБухгалтера"; 

    // Вызываем серверную процедуру для добавления в избранное
    ДобавитьОбработкуВИзбранноеНаСервере(ИмяОбработки);
КонецПроцедуры

В приведенном примере мы видим две процедуры: ДобавитьОбработкуВИзбранноеНаСервере, которая выполняется на сервере и содержит основную логику работы с объектами 1С, и КомандаДобавитьВИзбранное, которая выполняется на клиенте и вызывает серверную процедуру, передавая ей имя внешней обработки. Обязательно замените строку ИмяОбработки = "ИмяВнешнейОбработки"; на фактическое наименование вашей обработки.

Заключение

Мы рассмотрели различные подходы к добавлению внешних обработок и дополнительных отчетов в Избранное в 1С. Независимо от выбранного метода – будь то удобные пользовательские функции или мощный программный код – ключевым условием остается правильная подготовка метаданных самой внешней обработки.

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

← К списку