Обработку Демо: Загрузка данных из XML файла можно загрузить по ссылке (имя файла обработки _ДемоЗагрузкаДанныхИзXMLфайла.epf).
Содержание
Описание обработки
Обработка Демо: Загрузка данных из XML файла показывает пример загрузки данных из XML-файла. Этот пример удовлетворяет следующим требованиям:
- контроль структуры исходного файла с данными;
- предоставление примера исходного файла с данными;
- ограничение максимального объема загружаемых данных разумным значением, соответствующим назначению обработки;
- возможность отладки кода обработки;
- полноценная работа обработки в приложениях сервиса Фреш во всех видах клиентов (в том числе, в веб-клиенте).
При выполнении обработки из указанного пользователем XML-файла загружаются сведения о котировках драгоценных металлов. Структура XML-файла должна соответствовать структуре XML-файлов с котировками драгоценных металлов, выдаваемых веб-сервисом Центрального банка России.
Максимальный объем загружаемых данных не должен превышать четырех элементов, поскольку ЦБ РФ отслеживает котировки только по четырем драгоценным металлам — золоту, серебру, платине и палладию.
При каждом запуске обработки сведения о драгоценных металлах синхронизируются по артикулу с элементами справочника Демо: Номенклатура. Котировки драгоценных металлов записываются в реквизит Цена этого справочника.
Обработка запрашивает в функции СведенияОВнешнейОбработке разрешение на чтение и запись данных каталога временных файлов (функция РазрешениеНаИспользованиеКаталогаВременныхФайлов общего модуля РаботаВБезопасномРежиме).
Установка обработки
Установка в локальное приложение (для проверки обработки)
Перед тем, как загружать обработку в сервис Фреш, рекомендуется проверить ее работоспособность в локальной версии приложения, то есть, в информационной базе нужной конфигурации, развернутой на компьютере пользователя.
Опишем, как проверить работоспособность обработки Демо: Загрузка данных из XML файла для Демонстрационной конфигурации «Библиотека стандартных подсистем». Эта конфигурация входит в «1С:Библиотеку стандартных подсистем», которую можно скачать на сайте 1С:Обновление программ.
Для установки обработки в локальное приложение этой конфигурации нужно:
- Запустить Демонстрационную конфигурацию «Библиотека стандартных подсистем».
- Выбрать в этой конфигурации раздел Интегрируемые подсистемы.
- Выбрать команду Дополнительные отчеты и обработки. Будет выведена форма Дополнительные отчеты и обработки.
- Нажать кнопку Добавить из файла....
- Если будет выведено окно Предупреждение безопасности, нажать в нем кнопку Продолжить.
- Выбрать в диалоговом запросе файл _ДемоЗагрузкаДанныхИзXMLфайла.epf и нажать кнопку Открыть.
- В форме Дополнительная обработка (создание) нажать ссылку
Не определено справа от надписи Размещение, включить флажок в строке Раздел «Интегрируемые подсистемы» и нажать кнопку OK.
- В форме Дополнительная обработка (создание) нажать слово Нет в колонке Быстрый доступ, и нажать кнопку ... или клавишу F4.
- В окне Быстрый доступ к команде «Загрузить сведения о котировках драгоценных металлов из XML файла» надо добавить себе быстрый доступ к команде запуска обработки. Проще всего это сделать, нажав кнопку >> (Добавить всех пользователей) и затем кнопку OK.
- В форме Дополнительная обработка (создание) нажать кнопку Записать и закрыть.
- Если будет выведено сообщение Для применения изменений в открытых окнах необходимо их закрыть и открыть заново, то в нем следует нажать кнопку OK.
Установка в приложение сервиса Фреш
Обработка Демо: Загрузка данных из XML файла совместима с приложениями сервиса Фреш, в которые встроена Библиотека стандартных подсистем. В частности, можно установить обрабоку в приложение Демонстрационная конфигурация «Библиотека стандартных подсистем», если оно размещено в сервисе.
Особенности подготовки, загрузки и установки дополнительных отчетов и обработок в сервисе Фреш
Особенности подготовки, загрузки и установки дополнительных отчетов и обработок в сервисе Фреш
- Пользователь сервиса, ааторизованный как разработчик дополнительных отчетов и обработок должен с помощью локальной версии нужного приложения создать комплект поставки дополнительного отчета или обработки и загрузить его в сервис Фреш.
- После прохождения аудита (если в сервисе включен аудит) дополнительный отчет или обработка может устанавливаться в приложения сервиса.
- Право на установку имеет владелец абонента, если дополнительный отчет или обработку разработчик загрузил в сервис именно для этого абонента или если право на установку было предоставлено абоненту обслуживающей организацией или провайдером сервиса.
Порядок установки дополнительных отчетов и обработок в приложения сервиса Фреш
Порядок установки дополнительных отчетов и обработок в приложения сервиса Фреш
Если в сервисе Фреш используется централизованный каталог дополнительных отчетов и обработок, то для установки дополнительных отчетов и обработок в приложения сервиса должны быть выполнены следующие действия.
Авторизация разработчиков. Оператор сервиса по заявке обслуживающей организации должен дать определенным пользователям абонента этой обслуживающей организации права разработчика дополнительных отчетов и обработок:
- порядок подачи заявки на авторизацию разработчика в сервисе 1cfresh.com описан в статье по ссылке;
- действия оператора по авторизации разработчиков описаны в документе Облачная подсистема Фреш в разделе Разработчики расширений, дополнительных отчетов и обработок главы Адаптация приложений.
- Приглашение разработчиков. Разработчик может создавать и загружать в сервис дополнительные отчеты и обработки не только для своей обслуживающей организации, но и для любого абонента сервиса, если владелец этого абонента направит приглашение разработчику, как это описано в статье по ссылке.
- Разработка дополнительного отчета или обработки. Разработчик должен разработать дополнительный отчет или обработку. Требования, предъявляемые к дополнительным отчетам и обработкам в сервисе 1cfresh.com, описаны в статье по ссылке.
Подготовка комплекта поставки. Разработчик должен подготовить комплект поставки дополнительного отчета или обработки — zip-файл, содержащий файл дополнительного отчета или обработки и xml-файл манифеста со сведениями, необходимыми для публикации дополнительного отчета или обработки в сервисе. Порядок подготовки комплекта поставки описан в статье по ссылке. При подготовке комплекта поставки разработчик:
- использует локальную версию информационной базы того прикладного решения, для которого предназначен дополнительный отчет или обработка;
- указывает, в каких разделах командного интерфейса прикладного решения будет доступен дополнительный отчет или обработка, или варианты отчета (если они имеются), задает значения параметров дополнительного отчета или обработки, применяемые по умолчанию, и т.д.
- Загрузка в сервис. Разработчик загружает комплект поставки дополнительного отчета или обработки в сервис, как это описано в статье по ссылке. При загрузке разработчик указывает абонента сервиса, который будет владельцем (правообладателем) дополнительного отчета или обработки.
- Аудит. Как правило, в сервисе Фреш используется аудит дополнительных отчетов и обработок. В этом случае дополнительный отчет или обработка могут использоваться в приложениях сервиса только после успешного прохождения аудита. Порядок прохождения аудита описан в статье по ссылке.
Предоставление доступа к дополнительному отчету и обработке. Владелец абонента сервиса, для которого разработчик загрузил дополнительный отчет или обработку, может установить этот дополнительный отчет или обработку в совместимые приложения абонента сразу после успешного прохождения аудита.
Но если владелец (правообладатель) дополнительного отчета или обработки — это обслуживающая организация или провайдер сервиса, то они могут дать право на установку этого дополнительного отчета или обработки также и другим абонентам сервиса:
- владелец или оператор обслуживающей организации могут дать такое право своим обслуживаемым абонентам (см. статью по ссылке);
- администратор сервиса может дать право на установку дополнительных отчетов и обработок, принадлежащих провайдеру, указанным им абонентам сервиса или всем абонентам сервиса. Это описано в документе Облачная подсистема Фреш в разделе Настройка прав доступа главы Адаптация приложений.
- Установка в приложения абонента. Владелец абонента, который имеет доступ к дополнительному отчету или и обработке, может установить отчет/обработку в приложения этого абонента, как описано в статье по ссылке, а также удалить отчет/обработку из приложений абонента.
После установки дополнительного отчета или и обработки в приложение пользователи этого приложения смогут использовать отчет/обработку, если им им в приложении предоставлено такое право.
Запуск обработки
Опишем порядок запуска обработки Демо: Загрузка данных из XML файла в приложении Демонстрационная конфигурация «Библиотека стандартных подсистем». Для приложений других конфигураций порядок запуска может несколько отличаться.
Для запуска обработки нужно:
- Запустить Демонстрационную конфигурацию «Библиотека стандартных подсистем».
- Выбрать в этой конфигурации раздел Интегрируемые подсистемы.
- Выбрать команду Демо: Дополнительные обработки (под надписью Сервис).
- В выведенном окне Дополнительные обработки (Раздел «Интегрируемые подсистемы») выбрать имя команды Загрузить сведения о котировках драгоценных металлов из XML файла.
- Нажать кнопку Выполнить.
Использование обработки
При запуске обработки выводится следующая форма:
Нужно выполнить следующие действия:
- Нажать кнопку Выбрать файл для загрузки.
В выведенном диалоге открытия файла выбрать XML-файл с исходными данными и нажать кнопку Открыть.
- Нажать кнопку Загрузить данные.
Если XML-файл с исходными данными подготовлен правильно, то будет выдано сообщение об успешном выполнении обработки:
А если при обработке данных возникли ошибки — то сообщение об ошибке, например:
Просмотр результатов выполнения обработки
Опишем порядок просмотра результатов выполнения обработки Демо: Загрузка данных из XML файла в приложении Демонстрационная конфигурация «Библиотека стандартных подсистем». Для приложений других конфигураций этот порядок может несколько отличаться.
Для просмотра результатов выполнения обработки следует:
- Выбрать в Демонстрационной конфигурации «Библиотека стандартных подсистем» раздел Органайзер.
- Выбрать команду Демо: Номенклатура (под надписью Присоединенные файлы).
- Будет выведен справочник Демо: Номенклатура. В нем должны быть строки с названиями драгоценных металлов: Золото, Палладий, Платина и Серебро. Если открыть карточку, соответствующую любой из этих строк справочника, то в реквизите Цена будет указана котировка драгоценного металла, прочтенная из XML-файла.
Отладка и изменение обработки
Обработку можно отлаживать и изменять. Для этого нужно выполнить следующие действия.
- С помощью Конфигуратора включить внешнюю обработку в состав конфигурации.
- Выполнить отладку, запуская обработку через меню Все функции.
- Сохранить отлаженную/измененную обработку как внешнюю обработку.
- Удалить отлаженную обработку из состава конфигурации
- Использовать отлаженную внешнюю обработку в подсистеме Дополнительные отчеты и обработки, как это описано выше.
См. также: