Миграция из Confluence по API

Настройка конфигурации

Заполните следующие настройки в конфигурации.

CONFLUENCE_URL - укажите URL домена Confluence, по которому будут отправляться API запросы. Это должен быть корректный адрес сервера Confluence;
CONFLUENCE_TOKEN - укажите API токен, необходимый для авторизации и доступа к данным Confluence. Убедитесь, что используется корректный и безопасный токен;
CONFLUENCE_WEBHOOK_SECRET - если планируется использовать вебхуки для интеграции, укажите секретный ключ для вебхука. Этот параметр может быть пустым, если вебхуки не используются;

Получение данных из Confluence

Чтобы начать получать данные из Confluence для интеграции с ispmanager Docs, выполните следующие шаги.

В командной строке выполните команду php artisan sync:confluence get --space={SPACE};
Замените {SPACE} на имена пространств, из которых необходимо получить данные. Имена пространств следует перечислить через запятую.

Структурирование данных

После успешного получения необходимых пространств из Confluence выполните команду php artisan sync:confluence parse --space={SPACE};
Замените {SPACE} на имена пространств, которые были выбраны для импорта.

Пояснение

Обратите внимание!

В ходе структурирования статей могут возникать следующие предупреждения.

Empty ... - это предупреждение указывает на то, что определенный блок данных был пропущен, так как он оказался пустым и не содержит информации.

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

Undefined link - предупреждение указывает на то, что системе не удалось распознать ссылку на другую статью. Это может произойти, если такой статьи не существует в импортированных данных из Confluence. Ссылка будет вставлена как есть, потребуется вручную исправить эту ссылку после импорта.

Импорт данных

После успешной подготовки данных и уверенности в корректности выполнения предыдущих действий выполните следующие шаги.

Выполните команду php artisan sync:confluence import --space={SPACE};
Замените {SPACE} на имена пространств, из которых необходимо импортировать статьи.