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

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

примечание

Если Confluence размещается в инфраструктуре вашей компании, для интеграции разрешите сетевой доступ к API Confluence из Jay Knowledge Hub.

Какие данные будут загружены

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

предупреждение

Проверьте, что страницы выбранного пространства не содержат конфиденциальную информацию. Все загруженные данные будут доступны для индексации и использования. Ваши клиенты или сотрудники смогут получить к ним доступ, когда будут обращаться к базе знаний.

Токен доступа к Confluence

Чтобы предоставить базе знаний доступ к Confluence, необходимо получить токен:

1. В Confluence нажмите на свой аватар в правом верхнем углу и перейдите в меню Настройки.
2. В боковой панели выберите Личные маркеры доступа.
3. Нажмите Создать маркер. Заполните параметры и нажмите Создать.
4. Скопируйте токен доступа.

Подробнее о токенах доступа читайте в документации Confluence.

Создание интеграции

Чтобы загрузить данные из Confluence:

1. Перейдите в раздел Интеграции и нажмите Подключить.

   Если при создании проекта вы выбрали Подключить интеграцию с Confluence, то попадете на страницу новой интеграции автоматически.

   

2. Укажите настройки интеграции:

   • Название — отображается в разделе Источники в виде префикса к названиям страниц, загруженных из этой интеграции.

   • Автоматически синхронизировать данные — включите для поддержания актуальности базы знаний, отключите для однократной загрузки.

     подсказка

     Не допускайте размещения некорректных или конфиденциальных данных в выбранном пространстве Confluence, ведь они автоматически появятся в базе знаний при очередной синхронизации.

   • Автоматически перезапускать процесс индексации — включите, чтобы переиндексировать базу знаний после очередной синхронизации.

   • Ссылка на Confluence — домен, например https://example.atlassian.com.

   • Пространство — имя пространства.

   • Токен доступа из настроек профиля — см. подраздел Токен доступа выше.

   примечание

   Все настройки впоследствии можно изменить.

3. Нажмите Подключить.

Статус интеграции сразу после создания — «Идет обновление». Когда статус сменится на «Подключено», вы можете просмотреть загруженные страницы в разделе Источники.

к сведению

В дополнение к данным из Confluence вы можете загрузить файлы вручную.

После загрузки данных нужно проиндексировать базу знаний.

Принудительная синхронизация

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

1. Перейдите в раздел Интеграции.

2. Нажмите напротив интеграции и выберите Синхронизировать.

   

3. Чтобы обновленные данные стали доступны пользователям, которые обращаются к базе знаний, запустите переиндексацию. Для этого нажмите Индексировать вверху страницы.

Изменение настроек

Чтобы изменить настройки интеграции, перейдите в раздел Интеграции, нажмите напротив интеграции и выберите Редактировать.

Удаление интеграции

Чтобы удалить интеграцию и все ее данные из базы знаний:

1. Перейдите в раздел Интеграции, нажмите напротив интеграции и выберите Удалить.

2. Перейдите в раздел Источники и удалите страницы, загруженные из этой интеграции:

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

3. Чтобы запустить переиндексацию, нажмите Индексировать вверху страницы.

примечание

Удаление отдельных источников из действующей интеграции нецелесообразно: они будут загружены обратно с очередным обновлением.