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

Введение

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

Требования

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

VM options

Dspring.profiles.active=localdefault

Ссылки

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:
Copy

sudo mkdir /opt/doc1c-sync
cd /opt/doc1c-sync

3. Скачайте docker-compose.yml:
Copy

 sudo curl https://www.booco.ru/install/doc1c-sync/docker-compose.yml --output docker-compose.yml

4. Скачайте шаблон файла с переменными окружающей среды .env:
Copy

sudo curl https://www.booco.ru/install/doc1c-sync/.env --output .env

5. Укажите необходимые параметры в файле .env:
Copy

sudo nano .env

Переменные среды

1С

1C Web-client

BOOCO

BOOCO Web-client

Синхронизация

Помещения (Venues)

Журналирование (Logging)

Режимы работы (Schedule)