Интеграция с Yougile
Модуль предоставляет возможность двусторонней интеграции с Yougile. Поддерживается обмен:
- Задачами проектов (название, метки, сроки)
- Этапами/колонками задач проектов
- Метками задач
- Комментариями по задачам
- Чек-листами
Для связи Yougile и 1C без необходимости публиковать последнюю на вебе используется промежуточный сервис Yandex Cloud
Настройка в Yandex.Cloud
1/ Создайте сервисный аккаунт
2/ Выдайте этому аккаунту роли ymq.writer, ymq.reader и vpc.gateways.user
3/ Перейдите в созданный аккаунт и создайте статический ключ доступа
Сразу сохраните отображенный ключ и его идентификатор, т.к. после закрытия окна они больше не будут отображаться. Они будут вводиться в 1С на следующих шагах
4/ Создайте новую очередь в разделе Message Queue (настройки по умолчанию подходят)
5/ В разделе API Gateway создайте новый шлюз
- Имя произвольное
- После сохранения нового шлюза дождитесь, когда он будет создан, перейдите в него, нажмите "Редактировать" и в разделе "Спецификация" укажите
openapi: 3.0.0
info:
title: Sample API
version: 1.0.0
servers:
- url: <уже заполнен по умолчанию>
paths:
/yougile_webhooks:
post:
x-yc-apigateway-integration:
type: cloud_ymq
action: SendMessage
queue_url: <URL очереди, созданной в п. 4>
folder_id: <Идентификатор папки, можно посмотреть на главной странице консоли в самом верху>
service_account_id: <Идентификатор сервисного аккаунта, созданного в п.1>Настройка в 1С
Для настройки интеграции необходимо перейти в раздел Проекты и управление задачами -> Интеграция Yougile -> Управление интеграцией.
- Нажмите "Загрузить доски" -> "+ Новая компания", авторизуйтесь данными от Yougile и выберите нужную компанию
- Загрузите нужные доски. Если необходимо несколько компаний - повторите пп1-2 для каждой компании
- Откройте ссылку "Настройка подключения и обмена"
- В поле "Адрес вебхука" укажите https://<Идентификатор API-шлюза из п.5 в yandex.cloud>.apigw.yandexcloud.net/yougile_webhooks
- В поле "Адрес очереди YMQ" укажите URL очереди, созданной в п.4 в yandex.cloud
- В поле "Идентификатор ключа YMQ" укажите идентификатор ключа доступа, созданного в п.3 в yandex.cloud
- В поле "Секретный ключ YMQ" укажите секретный ключ, созданный в п.3 в yandex.cloud
- Для каждой загруженной компании в таблице нажмите "Зарегистрировать"
- Укажите расписание обмена (для серверной базы можно указать "каждый день; каждые 900 секунд; повторять после завершения через 5 секунд)
Подключение досок Yougile к проектам ПиУЗ
Загруженные доски можно загрузить в новые проекты или привязать к существующим (текущее содержимое проекта в 1С уйдет в архив и заменится на данные yougile)
По умолчанию обмен идет только из Yougile в сторону 1С. Чтобы изменения в 1С выгружались в Yougile - в нужных досках надо поставить галочку "Выгружать изменения"
