Штрих-М: Документация

Форма «Дополнительные отчеты и обработки» предназначена для хранения в программе дополнительных отчетов и обработок.

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

Дополнительные отчеты и обработки разрабатываются в режиме Конфигуратора, для этого надо обращаться к разработчику. Также можно получить их из интернета.
Для того чтобы использовать дополнительные отчеты и обработки, необходимо установить флажок «Дополнительные отчеты и обработки» (раздел «Администрирование» — «Печатные формы, отчеты и обработки»). После этого становится доступной команда «Дополнительные отчеты и обработки». По умолчанию флажок включен.

В форме «Дополнительные отчеты и обработки» выводятся:

• «Наименование» — полное наименование отчета или обработки;
• «Вид» — существует несколько видов дополнительных отчетов и обработок (см. ниже), указывается разработчиком. В зависимости от вида различаются функции;
• «Публикация» — видимость дополнительных отчетов и обработок, также обозначается цветом. Красным цветом выделены дополнительные отчеты и обработки в режиме отладки, которые доступны только администратору. Серым цветом отображаются дополнительные отчеты и обработки, которые отключены. Помеченные на удаление дополнительные отчеты и обработки также становятся неактивными и отображаются серым цветом, а также специальным значком;
• «Версия» — отображается номер версии данной обработки (указывается разработчиком);
• «Ответственный» — пользователь программы, который назначен ответственным за данный отчет или обработку. Отслеживает состояние дополнительного отчета или обработки, обновляет версии и т.п. (по умолчанию «Администратор»).

С помощью команды «Еще» — «Изменить форму» в список можно добавить дополнительные колонки:

• «Имя объекта» — включает вид и другие сведения. Заполняется разработчиком, в программе проставляется по умолчанию;
• «Режим совместимости разрешений» — версия программы, для которой обработка используется;
• «Комментарий» — подробная информация о дополнительном отчете или обработке;
• «Использует хранилище вариантов» — свойство для дополнительных отчетов. Принимает значения «Да», если дополнительный отчет хранит данные в хранилище вариантов программы;
• «Использовать для формы списка» — принимает значение «Да», если команда, которая вызывает дополнительный отчет или обработку, располагается в окнах списков;
• «Использовать для формы объекта» — принимает значение «Да», если команда, которая вызывает дополнительный отчет или обработку, располагается в окнах элементов списков;
• «Информация» — описание дополнительной обработки или отчета, которое было написано разработчиком;
• «Имя файла» — расширение и имя файла дополнительной обработки (отчета);
• «Безопасный режим» — принимает значение «Да», если дополнительный отчет или обработка выполняется в безопасном режиме. Как правило, большинство обработок должны выполняться в безопасном режиме. Это гарантирует, что они не содержат «ненадежный программный код, который выполняется на сервере. Однако некоторые обработки могут требовать выполнения в небезопасном режиме. Об этом программа размещает предупреждение. Такие обработки следует загружать только из надежных источников (поставщиков) или перед загрузкой самостоятельно выполнять их аудит. Подробнее о безопасном режиме работы см. документацию по платформе «1С:Предприятие».

По команде «Создать» программа предложит выбрать файл внешнего отчета или обработки на компьютере (укажите путь к каталогу на диске) и настроить его параметры. Набор сведений зависит от назначения обработки или отчета. Если указан неверный файл, то программа выдаст сообщение об ошибке, например, сообщение о том, что дополнительная обработка предназначена для другой версии программы.

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

• «Файл» — «Открыть»;
• сочетание клавиш Ctrl+O.

В открывшемся окне выбора файла укажите файл внешнего отчета или обработки.

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

• нажмите «Создать группу» и введите наименование группы. Можно подчинить новую группу другой группе. Для этого в поле «Родитель» выберите группу из списка;
• перетащите в группу нужные дополнительные отчеты и обработки с помощью мыши.

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

• по полю «Вид» — выберите один из видов дополнительных отчетов и обработок из списка для отбора, например, «Отчет»;
• по полю «Публикация» — выберите нужное состояние для отбора, например, «Используется»;
• по полям «Вид» и «Публикация» — можно сочетать два вида отбора в больших списках.

С помощью команды «Загрузить из файла» можно обновить обработку во внутреннем хранилище программы. Укажите путь к файлу, нажмите «Открыть».

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

Существует несколько видов дополнительных отчетов и обработок:

• «Глобальные отчеты и обработки» — используются независимо от данных программы, также называются общими. Команды для их использования размещаются в разделах программы. С помощью глобальных отчетов и обработок можно загружать данные в программу, производить обновление или очистку индекса полнотекстового поиска и т.д. Они содержат команды, вызываемые только из разделов командного интерфейса. Команды не зависят от конкретных объектов программы. Список доступных разделов для размещения команд определен разработчиком заранее и включен в файл дополнительного отчета или обработки, его невозможно изменить.;
• «Назначаемые дополнительные отчеты и обработки» — предназначены для конкретных документов или списков программы, которых может быть несколько, при этом список доступных назначений определен разработчиком заранее и включен в текст дополнительного отчета или обработки, поэтому при настройке дополнительного отчета или обработки можно только выбирать из этого списка. К этому типу относятся несколько видов дополнительных отчетов и обработок:
  • «Отчет» — назначаемый дополнительный отчет. С его помощью можно выдать отчет по определенному объекту программы.
  • «Заполнение объекта» — назначаемая дополнительная обработка, которая позволяет автоматически заполнить или очистить один или несколько элементов списка.
  • «Печатная форма» — назначаемая дополнительная обработка, с помощью которой можно расширить количество печатных форм документа.
  • «Создание связанных объектов» — назначаемая дополнительная обработка, которая позволяет быстро заполнить списки с помощью копирования элементов.

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

Функция СведенияОВнешнейОбработке() Экспорт

  ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");\\
  ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработки<...>();\\
  ПараметрыРегистрации.Версия = "...";\\
  Команда = ПараметрыРегистрации.Команды.Добавить();\\
  Команда.Представление = НСтр("ru = '<Представление команды>'");\\
  Команда.Идентификатор = "<Имя команды>";\\
  Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКоманды<...>();\\
  Команда.ПоказыватьОповещение = <Истина/Ложь>;\\
  Возврат ПараметрыРегистрации; \\

КонецФункции Подробнее см. на сайте ИТС.