Confluence

Интеграция с Confluence Cloud и Confluence Data Center

Ваш Confluence Data Center должен быть доступен из интернета. Внутренний корпоративный Confluence не подключится.

Доступные операции

Страницы:
  • Создает страницу Confluence.

  • Изменяет существующую страницу Confluence.

  • Изменяет один раздел страницы, не затрагивая остальное.

  • Удаляет страницу Confluence.

  • Возвращает содержимое страницы по ID или по заголовку и ключу пространства.

  • Возвращает дочерние страницы и папки страницы.

  • Переносит страницу к новому родителю или в другое пространство.

  • Копирует страницу в новое место (Cloud — встроенный эндпоинт; Data Center — ручное создание, вложения не копируются).

Шаблоны страниц (только Cloud):
  • Создает страницу, заполненную телом шаблона.

  • Возвращает шаблон страницы по ID вместе с телом в формате storage.

  • Возвращает список шаблонов содержимого страниц.

История и аналитика:
  • Возвращает одну из прошлых версий страницы.

  • Возвращает unified diff между двумя версиями страницы.

  • Возвращает статистику просмотров страницы (только Cloud).

Комментарии:
  • Добавляет комментарий к странице.

  • Отвечает в существующей ветке комментариев.

  • Возвращает комментарии страницы.

  • Добавляет встроенный комментарий, привязанный к фрагменту текста.

  • Возвращает все встроенные комментарии страницы.

Вложения:
  • Загружает вложение в содержимое Confluence (страницу или запись блога).

  • Прикрепляет файл из текущей сессии агента к странице Confluence.

  • Загружает несколько вложений одним пакетом.

  • Скачивает вложение как встроенный ресурс.

  • Скачивает все вложения элемента содержимого.

  • Сохраняет вложение файлом в текущую сессию агента.

  • Возвращает все вложения элемента содержимого с метаданными.

  • Возвращает все изображения, приложенные к странице, как встроенные изображения.

  • Безвозвратно удаляет вложение со всеми его версиями.

Метки:
  • Добавляет метку к содержимому Confluence (странице, записи блога или вложению).

  • Возвращает метки содержимого Confluence.

Права и ограничения:
  • Проверяет, может ли пользователь или группа выполнить операцию с указанным содержимым (только Cloud).

  • Возвращает все назначения прав в пространстве (только Cloud).

  • Возвращает ограничения на просмотр и редактирование страницы.

  • Задает ограничения на просмотр и редактирование страницы.

Пространства:
  • Возвращает иерархию страниц пространства плоским списком.

Поиск:
  • Ищет содержимое Confluence по простому запросу или CQL.

  • Ищет пользователей Confluence через CQL (Cloud) или API участников групп (Data Center).

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork.

Интеграция поддерживает подключение к Confluence Cloud и Confluence Data Center.

Для добавления интеграции:
  1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

  2. В витрине интеграций откройте подключаемую интеграцию Confluence.

  3. На шаге Настройки интеграции укажите Адрес Confluence: https://<компания>.atlassian.net для Cloud, или адрес Data Center.

  4. На шаге Настройка авторизации выберите Тип аутентификации:

    • Логин и пароль — только для Confluence Cloud.

    • Токен доступа — только для Confluence Data Center.

  5. Нажмите Далее, а затем Добавить — интеграция добавится для авторизации пользователями.

Авторизация в интеграции

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

  2. Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.

  3. Перед авторизацией получите токен для вашей версии Confluence:

    Как получить Confluence API Token (Confluence Cloud):
    1. Откройте https://id.atlassian.com и войдите.

    2. Аватар → Account Settings → вкладка Security.

    3. Раздел API tokens → Create and manage API tokens → Create API token.

    4. Введите имя → Create → скопируйте токен (показывается один раз).

    Как получить Confluence PAT (Confluence Data Center / Server):
    1. Войдите в свой Confluence.

    2. Аватар → Settings → Personal Access Tokens.

    3. Create token → введите имя (и срок действия при необходимости) → Create.

    4. Скопируйте токен (после закрытия окна не показывается).

  4. Укажите учетные данные вашего аккаунта Confluence:

    • для Confluence Cloud — почту и API Token;

    • для Confluence Data Center — токен доступа.