Чек-лист составлен в предположении, что для сервиса Фреш развернуты рабочий экземпляр сервиса и тестовый (подготовительный) экземпляр сервиса. Чек-лист является примерным, он не может использоваться напрямую. Рекомендуется использовать его как образец для составления собственного чек-листа, учитывающего особенности вашего сервиса Фреш.

Внимание

При настройке интеграции с порталом 1С:ИТС у вас должны быть:

  1. Логин и пароль для доступа к API fresh-integration.1c.ru
  2. Идентификатор вашего сервиса (36-значный GUID) для загрузки тарифов и услуг

Эти данные необходимы для доступа вашего сервиса к порталу 1С:ИТС и последующей работы интеграции.

Внимание

Интеграция с порталом 1С:ИТС использует подсистему тарификации. Контроль тарификации в Менеджере Сервиса включается по константе – Использовать контроль тарификации.

Для каждого пункта чек-листа рекомендуется указать ответственных за его выполнение (колонка Ответственный).

Системные требования

  1. Если предполагается интеграция с внешней учетной системой с API в интернете, нужен доступ к интернету.
  2. Версия менеджера сервиса должна быть не ниже 1.1.42.

Включение интеграции с Порталом 1С:ИТС

Проверки рекомендуется выполнять в день включения интеграции с Порталом 1С:ИТС.

ОписаниеОтветственный
1

В рабочем экземпляре сервиса в Портал 1С:ИТС нужно передавать данные абонентов. 
Для корректной работы у справочника Абоненты должны быть правильно настроены дополнительные сведения, содержащие данные:

  • КПП, имя для разработчиков – КПП
  • Телефон, имя для разработчиков – Телефон
  • Электронная почта, имя для разработчиков – ЭлектроннаяПочта

Если они не созданы, их нужно создать: Главное → Настройки конфигурации → Дополнительные сведения

Далее для абонента создать строковые дополнительные сведения:

Убедиться что имена для разработчиков соответствуют указанным.


2

Устанавливаем расширение интеграции с порталом – ИнтеграцияПорталом1СИТС_1_0_x_x.cfe

Снимаем флаг – Безопасный режим.

3

Для внутренней публикации менеджера сервиса должна быть активна публикация HTTP-сервисов расширений по умолчанию:

<httpServices publishExtensionsByDefault="true">

это позволит приложениям получать тикеты через HTTP сервис менеджера сервиса - tickets

  • Проверить публикацию вызовом на внутренний адрес менеджера сервиса + /hs/tickets
    (например, если  http://ngx-int/int/sm – это адрес внутренней публикации менеджера сервиса из константы, то адрес HTTP сервиса Tickets будет – http://ngx-int/int/sm/hs/tickets)
    Получить внутренний адрес менеджера сервиса можно вызовом функции:

    РаботаВМоделиСервиса.ВнутреннийАдресМенеджераСервиса()
  • 404 (Not found) – сервис не опубликован
  • Запрос авторизации – сервис опубликован
После авторизации пользователем RemoteAccess в консоли отладки видим ответ 405 (Method not allowed) - публикация настроена правильно (например, в браузере Google Chrome консоль отладки открывается по кнопке F12).

4

Получаем от портала данные учетной записи менеджера сервиса для Портала 1С:ИТС:

Адрес API

https://fresh-integration.1c.ru/api/

Логин

<логин>

Пароль

<пароль>

Идентификатор

<идентификатор>


5

Включаем интеграцию: Администрирование → Настройки интеграции → Интеграция с внешними учетными системами

Установить значение констант:

  • ИнтеграцияСВнешнимиУчетнымиСистемами = Да
  • КоличествоДнейХраненияОтправленныхСообщений = 1 

6

Загружаем правила интеграции с порталом (файл Настройки_1.xml): команда меню Интеграция → Учетные системы, кнопка Загрузить настройки интеграции

Появятся новые элементы справочников:

  • Справочник Учетные системы
    • Портал 1С:ИТС
  • Справочник Правила трансляции объектов
    • Выгрузка
      • Абоненты (Справочник) - Выгрузка
      • Подписка (Документ) - Выгрузка с заполнением пустых полей
      • Пользователи абонентов (Справочник) - Выгрузка
      • Тарифы (Справочник) - Выгрузка
    • Правила обработки ответов
      • Абоненты (Справочник) - Обработка ошибок ответа
      • Абоненты (Справочник) - Отправка пользователей абонента
      • Подписка (Документ) - Проверка удаления подписки
  • Справочник Условия использования
    • Абонент интегрирован, пользователь активирован
    • Основная, проведена или помечена на удаление
    • Это не группа и не пометка удаления

7

Заполняем полученные от портала настройки в элемент справочника Учетные системы Портал 1С:ИТС  (раздел Интеграция)

На вкладке Исходящие запросы:

  • Адрес сервиса = https://fresh-integration.1c.ru/api/
  • Таймаут = 5
  • Пользователь и Пароль

Если используется прокси, нужно включить переключатель "Использовать прокси" и по гиперссылке "Настроить прокси..." нужно указать:

  • Сервер = <Адрес прокси-сервера>
  • Порт = <Порт прокси-сервера>
  • Пользователь и Пароль при наличии

На вкладке Исходящие запросы → Выгрузка: POST, PUT, DELETE:

  • Устанавливаем флаг Это поставщик услуг и указываем поставщика услуг Портал 1С:ИТС – на этого поставщика будут загружены Тарифы и услуги.

На вкладке Дополнительно:

  • Идентификатор сервиса = <Полученный от поддержки идентификатор сервиса Фреш>
  • Способ отправки изменений = Изменение

8

Загружаем тарифы портала: Управление тарифами → Тарифы поставщиков услуг → Загрузить тарифы Портала 1С:ИТС.
Будут загружены данные в списки из раздела Управление тарифами:

  • Тарифы поставщиков услуг
  • Услуги
  • Регистрации составов тарифов

Примечание

Кнопка загрузки тарифов появляется только при установленном и включенном расширении интеграции с Порталом 1С:ИТС.

Регистрации составов тарифов оформляются на момент загрузки. Дату регистраций можно изменить, тогда состав услуг будет действовать с указанной даты.


9

Заполняем в тарифах (раздел Управление тарифами → ссылка Тарифы) сведения о тарифах поставщика (то есть, тарифы портала 1С:ИТС), предоставляемых в составе тарифов сервиса Фреш.

  • Управление тарифами – Тарифы
  • Открываем тариф
  • на закладке Тарифы поставщиков добавляем соответствующий загруженный тариф портала

Если тарифы ранее не использовались, то нужно завести новые тарифы:

  • Наименование – произвольно, для удобства аналогично тарифам портала
  • В табличной части Услуги - для тестового тарифа достаточно указать услугу – Количество прав пользователей на запуск приложений, Неограниченно.
  • На закладке Тарифы поставщиков – указать соответствующий тариф портала

10

Для проверки работы интеграции создать штучные подписки на тарифы Портала (раздел Управление тарифами → ссылка Подписки),  в подписке указать:

  • Обслуживающая организация – абонент с заполненным реквизитом «Идентификатор», равным коду партнера без указания цифр после тире, например, если код партнера 12345-57, то указывается 12345.
  • Абонент – в областях которого предполагается использовать услуги Портала 1С:ИТС.
  • Тариф – тариф, содержащий тариф поставщика с услугами портала.
  • Дата начала и Дата окончания - в соответствие со сроком тарифа портала (указан в описании тарифа поставщика).

После заполнения данных подписку нужно провести и проверить передачу подписок в Портал 1С:ИТС.


11

Выгрузка первоначальных данных по Абонентам и Пользователям абонентов:

  • В Учетные системы → Портал 1С:ИТС на вкладке Исходящие запросы → Выгрузка: POST, PUT, DELETE включить переключатель Выгрузка по расписанию.
  • Настроить расписание выгрузки: каждый день, каждые 60 секунд.
  • Записать элемент.
  • После записи элемента сработают регламентные задания:
    • Интеграция: Портал 1С:ИТС / Заполнение начальных данных – выполнится несколько раз и по завершению заполнения отключится. Можно форсировать ручным выполнением этого регламентного задания.
    • Интеграция: Портал 1С:ИТС / Выгрузка данных – будет периодически выполняться для определения объектов к выгрузке

После завершения заполнения данных начнется установка объектов к выгрузке в следующем порядке:

  • Абоненты
  • Пользователи, абоненты которых интегрировались

Следует дождаться завершения передачи данных по абонентам до выполнения следующего пункта.

Примечание

Регламентные задания для информационной базы должны быть включены.


12

Выгрузить первоначальные данных по подпискам, если подписки на тарифы, включающие тарифы портала оформлялись ранее.

Перепровести подписки для портала, нажав кнопку Перепровести активные подписки для портала 1С:ИТС.

Подписки должны начать передаваться в портал

Примечание

Контроль за передачей данных можно осуществлять в форме элемента учетной системы по гиперссылкам Объекты интеграции и Объекты интеграции к отправке

Можно ускорить передачу.Для этого нужно выделить нужные сообщения и нажать кнопку Отправить сообщения  на форме Сообщения универсальной интеграции