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

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
[[tp7:Start|Начальная страница]] <- [[tp7:Администрирование|Администрирование]] <- [[tp7:Администрирование:Печ_формы_отчеты|Печатные формы, отчеты и обработки]]
===== Дополнительные отчеты и обработки =====
Форма «**Дополнительные отчеты и обработки**» предназначена для хранения в программе дополнительных отчетов и обработок.

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

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

В форме «**Дополнительные отчеты и обработки**» выводятся:
  * «**Наименование**» — полное наименование отчета или обработки;
  * «**Вид**» — существует несколько видов дополнительных отчетов и обработок (см. ниже), указывается разработчиком. В зависимости от вида различаются функции;
  * «**Публикация**» — видимость дополнительных отчетов и обработок, также обозначается цветом. Красным цветом выделены дополнительные отчеты и обработки в режиме отладки, которые доступны только администратору. Серым цветом отображаются дополнительные отчеты и обработки, которые отключены. Помеченные на удаление дополнительные отчеты и обработки также становятся неактивными и отображаются серым цветом, а также специальным значком;
  * «**Версия**» — отображается номер версии данной обработки (указывается разработчиком);
  * «**Ответственный**» — пользователь программы, который назначен ответственным за данный отчет или обработку. Отслеживает состояние дополнительного отчета или обработки, обновляет версии и т.п. (по умолчанию "Администратор").
С помощью команды «**Еще**» — «**Изменить форму**» в список можно добавить дополнительные колонки:
  * «**Имя объекта**» —  включает вид и другие сведения. Заполняется разработчиком, в программе проставляется по умолчанию;
  * «**Режим совместимости разрешений**» — версия программы, для которой обработка используется;
  * «**Комментарий**» — подробная информация о дополнительном отчете или обработке; 
  * «**Использует хранилище вариантов**» — свойство для дополнительных отчетов. Принимает значения "Да", если дополнительный отчет хранит данные в хранилище вариантов программы; 
  * «**Использовать для формы списка**» — принимает значение «Да», если команда, которая вызывает дополнительный отчет или обработку, располагается в окнах списков; 
  * «**Использовать для формы объекта**» — принимает значение «Да», если команда, которая вызывает дополнительный отчет или обработку, располагается в окнах элементов списков;
  * «**Информация**» — описание дополнительной обработки или отчета, которое было написано разработчиком;
  * «**Имя файла**» — расширение и имя файла дополнительной обработки (отчета);
  * «**Безопасный режим**» — принимает значение «Да», если дополнительный отчет или обработка выполняется в безопасном режиме. Как правило, большинство обработок должны выполняться в безопасном режиме. Это гарантирует, что они не содержат "ненадежный программный код, который выполняется на сервере. Однако некоторые обработки могут требовать выполнения в небезопасном режиме. Об этом программа размещает предупреждение. Такие обработки следует загружать только из надежных источников (поставщиков) или перед загрузкой самостоятельно выполнять их аудит. Подробнее о безопасном режиме работы см. документацию по платформе «1С:Предприятие».
==== Добавление дополнительных отчетов или обработок ====
По команде «**//Создать//**» программа предложит выбрать файл внешнего отчета или обработки на компьютере (укажите путь к каталогу на диске) и настроить его параметры. Набор сведений зависит от назначения обработки или отчета. Если указан неверный файл, то программа выдаст сообщение об ошибке, например, сообщение о том, что дополнительная обработка предназначена для другой версии программы.
==== Внешние отчеты и обработки ====
Имена внешних отчетов и обработок должны быть уникальны в пределах сеанса. В случае, если осуществляется подключение (программное или интерактивное) внешнего отчета (обработки) с именем, совпадающим с именем уже загруженного внешнего отчета (обработки), то будет произведено отключение старого отчета (обработки) и подключение нового (за исключением случая, когда производится повторное подключение того же самого внешнего отчета (обработки) – в данном случае загрузка выполнена не будет, а будет использован подключенный отчет (обработка)).
Для открытия отчета или обработки воспользуйтесь одним из следующих способов:
  * «**Файл**» — «**Открыть**»; 
  * сочетание клавиш Ctrl+O.
В открывшемся окне выбора файла укажите файл внешнего отчета или обработки.
==== Группировка дополнительных отчетов и обработок ====
Если список большой, то для удобства его использования можно сгруппировать дополнительные отчеты и обработки по различным признакам. Для этого введите необходимое количество групп:
  * нажмите «**Создать группу**» и введите наименование группы. Можно подчинить новую группу другой группе. Для этого в поле «**Родитель**» выберите группу из списка;
  * перетащите в группу нужные дополнительные отчеты и обработки с помощью мыши.
==== Отборы ====
Если дополнительных отчетов и обработок в списке много, то для удобства поиска можно воспользоваться отборами:
  * по полю «**Вид**» — выберите один из видов дополнительных отчетов и обработок из списка для отбора, //например, «Отчет»//;
  * по полю «**Публикация**» — выберите нужное состояние для отбора, //например, «Используется»//;
  * по полям «**Вид**» и «**Публикация**» — можно сочетать два вида отбора в больших списках.
==== Загрузка из файла ====
С помощью команды «**//Загрузить из файла//**» можно обновить обработку во внутреннем хранилище программы. Укажите путь к файлу, нажмите «**//Открыть//**».
==== Выгрузка в файл ====
С помощью команды «**Еще**» - «**Выгрузить в файл**» можно выгрузить дополнительный отчет или обработку из хранилища в файл на диске компьютера. Укажите папку на компьютере, нажмите «**//Сохранить//**». Имя файлу присваивается автоматически, имеется возможность его переименовать.
==== Виды дополнительных отчетов и обработок ====
Существует несколько видов дополнительных отчетов и обработок:
  * «**Глобальные отчеты и обработки**» — используются независимо от данных программы, также называются общими. Команды для их использования размещаются в разделах программы. С помощью глобальных отчетов и обработок можно загружать данные в программу, производить обновление или очистку индекса полнотекстового поиска и т.д. Они содержат команды, вызываемые только из разделов командного интерфейса. Команды не зависят от конкретных объектов программы. Список доступных разделов для размещения команд определен разработчиком заранее и включен в файл дополнительного отчета или обработки, его невозможно изменить.;
  * «**Назначаемые дополнительные отчеты и обработки**» — предназначены для конкретных документов или списков программы, которых может быть несколько, при этом список доступных назначений определен разработчиком заранее и включен в текст дополнительного отчета или обработки, поэтому при настройке дополнительного отчета или обработки можно только выбирать из этого списка. К этому типу относятся несколько видов дополнительных отчетов и обработок: 
    * «**Отчет**» — назначаемый дополнительный отчет. С его помощью можно выдать отчет по определенному объекту программы. 
    * «**Заполнение объекта**» — назначаемая дополнительная обработка, которая позволяет автоматически заполнить или очистить один или несколько элементов списка. 
    * «**Печатная форма**» — назначаемая дополнительная обработка, с помощью которой можно расширить количество печатных форм документа. 
    * «**Создание связанных объектов**» — назначаемая дополнительная обработка, которая позволяет быстро заполнить списки с помощью копирования элементов.
==== Последовательность создания дополнительной обработки (отчета) ====
Создать внешнюю обработку (отчет).\\
Регистрация дополнительной обработки в информационной базе происходит на основании сведений, которые поставляет сама обработка. Эти сведения должны возвращаться в виде структуры в функции «**СведенияОВнешнейОбработке**».
==== Пример реализации функции «СведенияОВнешнейОбработке» с использованием программного интерфейса ====
Функция СведенияОВнешнейОбработке() Экспорт\\
    ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");\\
    ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработки<...>();\\
    ПараметрыРегистрации.Версия = "...";\\
    Команда = ПараметрыРегистрации.Команды.Добавить();\\
    Команда.Представление = НСтр("ru = '<Представление команды>'");\\
    Команда.Идентификатор = "<Имя команды>";\\
    Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКоманды<...>();\\
    Команда.ПоказыватьОповещение = <Истина/Ложь>;\\
    Возврат ПараметрыРегистрации; \\
КонецФункции
Подробнее см. на сайте ИТС.