Дополнительные отчеты и обработки. Пример 3: Выгрузка данных в XML файл

Обработку Демо: Выгрузка данных в XML файл можно загрузить по ссылке (имя файла обработки _ДемоВыгрузкаДанныхВXMLФайл.epf).

Содержание

Описание обработки

Установка обработки

Подготовка данных

Использование обработки

Отладка и изменение обработки

Описание обработки

Обработка удовлетворяет следующим требованиям:

возможность отладки кода обработки;
полноценная работа обработки в приложениях сервиса 1cFresh во всех видах клиентов (в том числе, в веб-клиенте).

Обработка запрашивает в функции СведенияОВнешнейОбработке разрешение на чтение и запись данных каталога временных файлов (функция РазрешениеНаИспользованиеКаталогаВременныхФайлов общего модуля РаботаВБезопасномРежиме).

1. Описания других разрешений, которые могут быть запрошены дополнительным отчетом и обработкой, приведены в документации БСП, Глава 4. Программный интерфейс — Профили безопасности — Интерфейс (ссылка).

2. Если дополнительным отчетом или обработкой в функции СведенияОВнешнейОбработке не были запрошены необходимые разрешения, то при выполнении отчета/обработки в приложении будет вызвано исключение.

Установка обработки

Установка в локальное приложение (для проверки обработки)

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

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

Для установки обработки нужно:

Запустить Демонстрационную конфигурацию «Библиотека стандартных подсистем».
Выбрать пользователя Администратор и войти в конфигурацию.
Выбрать раздел меню Интегрируемые подсистемы.
Выбрать команду Дополнительные отчеты и обработки. Будет выведена форма Дополнительные отчеты и обработки.
Нажать кнопку Добавить из файла....
Если будет выведено окно Предупреждение безопасности, нажать в нем кнопку Продолжить.
Выбрать в диалоговом запросе файл _ДемоВыгрузкаДанныхВXMLФайл.epf и нажать кнопку Открыть.
В форме Дополнительная обработка (создание) нажать ссылку Не определено справа от надписи Размещение, включить флажок в строке Раздел «Интегрируемые подсистемы» и нажать кнопку OK.
В форме Дополнительная обработка (создание) нажать слово Нет в колонке Быстрый доступ, и нажать кнопку ... или клавишу F4.
В окне Быстрый доступ к команде «Выгрузить в XML файл данные по заказам за день» надо нажать кнопку >> (Добавить всех пользователей) и затем кнопку OK.
В форме Дополнительная обработка (создание) нажать кнопку Записать и закрыть.
Если будет выведено сообщение Для применения изменений в открытых окнах необходимо их закрыть и открыть заново, то в нем следует нажать кнопку OK.

Установка в приложение сервиса Фреш

Обработка Демо: Выгрузка данных в XML файл совместима с приложениями сервиса Фреш, в которые встроена Библиотека стандартных подсистем. В частности, можно установить обрабоку в приложение Демонстрационная конфигурация «Библиотека стандартных подсистем», если оно размещено в сервисе.

Особенности подготовки, загрузки и установки дополнительных отчетов и обработок в сервисе Фреш

Порядок установки дополнительных отчетов и обработок в приложения сервиса Фреш

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

Авторизация разработчиков. Оператор сервиса по заявке обслуживающей организации должен дать определенным пользователям абонента этой обслуживающей организации права разработчика дополнительных отчетов и обработок:
- порядок подачи заявки на авторизацию разработчика в сервисе 1cfresh.com описан в статье по ссылке;
- действия оператора по авторизации разработчиков описаны в документе Облачная подсистема Фреш в разделе Разработчики расширений, дополнительных отчетов и обработок главы Адаптация приложений.
Приглашение разработчиков. Разработчик может создавать и загружать в сервис дополнительные отчеты и обработки не только для своей обслуживающей организации, но и для любого абонента сервиса, если владелец этого абонента направит приглашение разработчику, как это описано в статье по ссылке.
Разработка дополнительного отчета или обработки. Разработчик должен разработать дополнительный отчет или обработку. Требования, предъявляемые к дополнительным отчетам и обработкам в сервисе 1cfresh.com, описаны в статье по ссылке.
Подготовка комплекта поставки. Разработчик должен подготовить комплект поставки дополнительного отчета или обработки — zip-файл, содержащий файл дополнительного отчета или обработки и xml-файл манифеста со сведениями, необходимыми для публикации дополнительного отчета или обработки в сервисе. Порядок подготовки комплекта поставки описан в статье по ссылке. При подготовке комплекта поставки разработчик:
- использует локальную версию информационной базы того прикладного решения, для которого предназначен дополнительный отчет или обработка;
- указывает, в каких разделах командного интерфейса прикладного решения будет доступен дополнительный отчет или обработка, или варианты отчета (если они имеются), задает значения параметров дополнительного отчета или обработки, применяемые по умолчанию, и т.д.
Загрузка в сервис. Разработчик загружает комплект поставки дополнительного отчета или обработки в сервис, как это описано в статье по ссылке. При загрузке разработчик указывает абонента сервиса, который будет владельцем (правообладателем) дополнительного отчета или обработки.
Аудит. Как правило, в сервисе Фреш используется аудит дополнительных отчетов и обработок. В этом случае дополнительный отчет или обработка могут использоваться в приложениях сервиса только после успешного прохождения аудита. Порядок прохождения аудита описан в статье по ссылке.
Предоставление доступа к дополнительному отчету и обработке. Владелец абонента сервиса, для которого разработчик загрузил дополнительный отчет или обработку, может установить этот дополнительный отчет или обработку в совместимые приложения абонента сразу после успешного прохождения аудита.

Но если владелец (правообладатель) дополнительного отчета или обработки — это обслуживающая организация или провайдер сервиса, то они могут дать право на установку этого дополнительного отчета или обработки также и другим абонентам сервиса:
- владелец или оператор обслуживающей организации могут дать такое право своим обслуживаемым абонентам (см. статью по ссылке);
- администратор сервиса может дать право на установку дополнительных отчетов и обработок, принадлежащих провайдеру, указанным им абонентам сервиса или всем абонентам сервиса. Это описано в документе Облачная подсистема Фреш в разделе Настройка прав доступа главы Адаптация приложений.
Установка в приложения абонента. Владелец абонента, который имеет доступ к дополнительному отчету или и обработке, может установить отчет/обработку в приложения этого абонента, как описано в статье по ссылке, а также удалить отчет/обработку из приложений абонента.

После установки дополнительного отчета или и обработки в приложение пользователи этого приложения смогут использовать отчет/обработку, если им им в приложении предоставлено такое право.

Статьи о подготовке, загрузке и установке дополнительных отчетов и обработок в сервисе Фреш

Использование обработки

Опишем порядок запуска обработки Демо: Выгрузка данных в XML файл в приложении Демонстрационная конфигурация «Библиотека стандартных подсистем». Для приложений других конфигураций порядок запуска может несколько отличаться.

Для запуска обработки нужно:

Запустить Демонстрационную конфигурацию «Библиотека стандартных подсистем».
Выбрать пользователя Администратор и войти в конфигурацию.
Выбрать раздел меню Бизнес-процессы и задачи, в нем выбрать справочник Демо: Заказы покупателя и создать несколько заказов покупателя за какой-либо день.
Выбрать раздел меню Интегрируемые подсистемы.
Выбрать команду Демо: Дополнительные обработки (под надписью Сервис).
В выведенном окне Дополнительные обработки (Раздел «Интегрируемые подсистемы») выбрать имя нужной обработки: Выгрузить в XML файл данные по заказам за день. И нажать кнопку Выполнить.
Ввести в поле Дата заказов дату, за которую надо вывести заказы.
Нажать кнопку Сформировать файл.
Нажать гиперссылку Получить файл, расположенную под кнопкой Сформировать файл.
Выбрать в выведенном запросе, надо ли открыть или сохранить сформированный файл.

Сформированный файл выглядит примерно следующим образом (вид файла может отличаться в зависимости от используемой программы просмотра):

Отладка и изменение обработки

Обработку можно отлаживать и изменять. Для этого нужно выполнить следующие действия.

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