Сервер BOOCO Meteor (v 1.x) / Настройка интеграций с календарными системами

Настройка интеграций c календарными системами

Интеграция c MS Exchange

Интеграция c Office 365

Интеграция с Google Calendar

Интеграция с Яндекс Календарем

◼ Интеграция с 1С:Документооборот

Синхронизация разных календарных систем

Работа с календарными системами

Включение отладочных сообщений

Введение

Микросервис doc1c-sync (ранее — booco1c) синхронизирует календари переговорных комнат в 1С:Документооборот с календарями в BOOCO (синхронизация односторонняя). Использует поле sync. Написан на Java.

Требования

Сервер BOOCO Meteor (v 1.x), развернутый в Docker.

VM options

Dspring.profiles.active=local,default

Ссылки

Swagger

• Ссылка для локального приложения: **http://localhost:8080/api/webjars/swagger-ui/index.html#/**
• или */api/swagger-ui.html, где ***** — адрес этого сервиса

Документы

REST API

Запуск и установка

Конфигурация 1С

• Для работы сервиса необходимо указать данные для NTLM-авторизации (см. NTLM). Имя пользователя должно указываться без имени компьютера.
• При первой установке необходимо настроить расширение 1С:
  1. Загрузить расширение (файл Booco.cfe), убрать безопасный режим.
  2. Опубликовать базу и установить чекбокс Публиковать HTTP сервисы расширений по умолчанию.

Конфигурация Booco

Для работы сервиса синхронизации необходимо указать пользователя (см. BOOCO) и назначить ему права:

• для ресурса booking:
  • read:any — чтение коллекции бронирований BOOCO;
  • create:own или create:any — создание новых бронирований;
  • update:any — обновление существующих бронирований;
• для ресурса venue:
  • read:any — чтение коллекции помещений BOOCO;
  • create:any — создание новых помещений (см. флаг добавления помещений SYNC_VENUE_ADD_NEW) ;
  • update:any — обновление существующих помещений;
• create:own для ресурса log — журналирование сообщений на сервер BOOCO (см. Журналирование).

Режимы работы

• Автоматический — синхронизация происходит с периодичностью, указанной в переменной среды SYNC_DELAY в формате длительности ISO 8601. Включение/выключение автоматической синхронизации управляется переменной среды SYNC_SCHEDULED.
• Ручной — синхронизация происходит при каждом обращении к эндпоинту (см. Swagger).

Запуск проекта

Для запуска проекта можно использовать команду:

./gradlew bootRun --args='--spring.profiles.active=local,default'

Или передать аргумент командной строки (см. VM options), например:

java -Dspring.profiles.active=local,default -jar ./build/libs/integration-service-0.0.1.jar

После запуска можно выполнить проверку, используя Swagger.

Установка контейнера Docker

Сборка проекта:

./gradlew bootJar

Создание образа:

docker build --tag integration-service .

Сохранение образа в .tar-файл:

docker save --output app.tar

Выгрузка в локальный кэш Docker:

docker load --input app.tar

Создание контейнера:

docker compose --project-name booco1c up -d

Остановка контейнера:

docker compose -p booco1c stop

Удаление контейнера:

docker compose -p booco1c down

Установка микросервиса doc1c-sync

1. Войдите на сервер по ssh.
2. Создайте папку /opt/doc1c-sync: