Проекты
Документация по проектной деятельности
- РусКлимат
- Целевая архитектура авторизации по схеме SSO
- Загрузка пользователей и товаров из файлов обмена
- Интеграция с Power BI
- Автозагрузка карт из СУЛ
- Инструкции
РусКлимат
Целевая архитектура авторизации по схеме SSO
Общая схема взаимодействия
Диаграмма последовательности операций
@startuml
title "Авторизация по схеме SSO"
participant mobile as "Мобильное приложение"
participant bonus as "СУЛ"
participant sso as "Identity provider"
mobile -> bonus: Запрос ресурса + jwt
bonus -> bonus: Проверка jwt
alt #LightGreen ok
bonus -> mobile: Данные
else #Pink error
bonus -> mobile: Редирект на Identity provider
mobile -> sso: Запрос авторизации
sso -> mobile: Страница авторизации
mobile -> sso: credentials
sso -> mobile: Редирект на ресурс + jwt
mobile -> bonus: Ресурс
bonus -> bonus: Проверка jwt
bonus -> mobile: Данные
end
@endumlЗагрузка пользователей и товаров из файлов обмена
Загрузка выполняется из файлов обмена, выгружаемых из НСИ. Загрузка выполнена в виде внешней обработки, которая не требует наличия установленного расширения для интеграции с СУЛ.
Обработка выполнена по технологии реализации дополнительных отчетов и обработок БСП.
Для использования обработки её необходимо загрузить в конфигурацию
После загрузки, нужно указать настройки, выполнив команду "Настройка"
Настройки подключения к сервису СУЛ включают в себя адрес сервиса, логин и пароль учетной записи, выданные при регистрации.
Адрес сервиса обязательно указывать в формате <Схема>://<Хост>:<Порт>
По кнопке "Проверить подключение", можно убедиться в корректности настроек соединения с сервисом.
Возможно два варианта получения данных:
- Получение из сетевого или локального каталога. Для этого нужно указать полный путь к сетевому каталогу, из которого обработка будет читать файлы обмена. При установке галок, также указать имена файлов обмена.
- Получение данных из сервиса НСИ. Для этого указывается адрес сервиса, логин, пароль и код узла в сервисе.
При необходимости можно указать расписание выполнения команды "Выгрузка".
В результате выполнения команды "Выгрузить"(как вручную, так и по расписанию), обработка считывает соответствующий файл или получает данные из сервиса НСИ, выполняет выгрузку в СУЛ и удаляет файл.
Важно в НСИ настроить регистрацию и выгрузку только объектов типа Номенклатура и Контрагент, остальные объекты в сообщении обмена будут игнорироваться.
Актуальная версия обработки
Интеграция с Power BI
Общие положения
Интеграция реализована в виде конфигурации для платформы 1С:Предприятие 8.3 (8.3.21.1624). Принцип работы конфигурации заключается в получении необходимых данных через API сервиса системы управления лояльностью. Данные логически делятся на сущности. Под сущностью понимается отдельный независимый набор данных. Каждая сущность получается отдельно и записывается в один или несколько файлов в формате csv, после чего передаётся на FTP сервер или в локальный/сетевой каталог. Описание сущностей можно увидеть здесь.
Выгрузка каждой сущности выполняется итерационно, начиная с определенной отметки времени. После чего сохраняется очередная отметка времени, начиная с которой будет выполняться следующий сеанс выгрузки.
Первый запуск
При первом запуске в режиме предприятия автоматически заполняются настройки сущностей. По-умолчанию создаются новые настройки каталога и для каждой сущности устанавливается этот каталог. Каждая сущность будет выгружаться каталог по-умолчанию. Изменить настройки можно в разделе Обмен -> Сущности. Таким образом, при необходимости можно выгрузить сущности на разные сервера и/или в разные каталоги на серверах.
В разделе Настройки -> Каталоги нужно указать путь к каталогу выгрузки
Основной экран
На начальном экране можно увидеть состояние выгрузки и указать различные настройки.
Сначала необходимо указать настройки соединения с системой управления лояльностью:
Настройки сохранятся только в случае успешной проверки подключения, при этом пароль не сохраняется в базе и при очередном изменении настроек его нужно ввести снова.
Затем настроить расписание регламентного задания выгрузки данных:
При необходимости возможно выполнить ручную выгрузку:
Ручная выгрузка недоступна, пока выполняется фоновая выгрузка данных
Автозагрузка карт из СУЛ
Автозагрузка карт выполняется о расписанию. Обработка проверяет карты сервиса, если карта не найдена в базе розницы - она создается.
Обработка выполнена по технологии реализации дополнительных отчетов и обработок БСП.
Для использования обработки её необходимо загрузить в конфигурацию
Далее можно указать расписание команды загрузки или выполнить её вручную.
Обработка подключается к сервису СУЛ, используя текущие настройки подключения в расширении интеграции с СУЛ. Обработка выбирает все карты, дата активации которых больше даты последнего сеанса загрузки карт. Для каждой карты попавшей в отбор создается новая карта в Рознице, если карта еще не существует в Рознице. Карты создаются порциями по 500 элементов в одной транзакции. В случае возникновения ошибки обработка пишет в журнал регистрации событие с идентификатором BSREST.АвтосозданиеКарт.Ошибка.
Актуальная версия обработки
Инструкции
Инструкции к различным элементам системы и обработкам
Списание по отложенным чекам с ошибкой 327
Для получения отчета и выгрузки данных для обработки в СУБД нужно воспользоваться обработкой <...>
Формирование отчета для согласования списания с заказчиком
Для начала нужно сформировать отчет и передать заказчику для согласования дальнейших действий.
После согласования, формируем начальные данные для обработки на сервере СУБД. Это делается нажатием на кнопку "Заполнить" и выгрузкой табличных частей в виде файлов в формате xls или txt.
...
Удаление записей из базы учетной системы
Для удаления обработанных записей нужно перейти в форму списка регистра отложенных операций, отфильтровать записи по коду ошибки 327, выделить все записи и удалить их.
