Импорт статей
В INFRAX на странице База знаний доступны два сценария импорта: Импорт из CSV и Импорт из Confluence. Обе кнопки показываются только если у вас есть права на создание статей хотя бы в одной категории.
Обзор импорта
Импорт помогает быстро перенести статьи в базу знаний из CSV-файла или из Confluence. В текущей версии интерфейса отдельной функции экспорта статей на этой странице нет, а ссылка на пример CSV служит только для загрузки шаблона.
Что доступно сейчас
- Импорт из CSV - массовое создание статей в выбранной категории
- Импорт из Confluence - пошаговый перенос страниц выбранного пространства
- Скачивание примера CSV - готовый шаблон с колонками и примером строки
- Фильтр прав доступа - в списках показываются только категории, где у вас есть права администратора
- Отчет по импорту - количество импортированных и пропущенных записей, а также список ошибок
Если у вас нет прав на создание статей ни в одной категории, модальные окна импорта показывают предупреждение "Нет доступных категорий" и не дают выбрать файл или страницу для импорта.
Формат CSV файла
Первая строка CSV должна содержать названия колонок из таблицы ниже. В колонке content можно передавать оформленный HTML-текст статьи.
| Колонка | Описание | Статус |
|---|---|---|
title |
Заголовок статьи | Обязательно |
content |
Содержимое статьи, включая HTML | Обязательно |
is_published |
Статус публикации | Необязательно |
Пример CSV
title,content,is_published
"Пример статьи 1","<h1>Заголовок статьи</h1><p>Это содержимое статьи</p>","true"
"Черновик статьи","<p>Это черновик</p>","false"
"Простая статья","Текст без HTML тегов","true"Как обрабатывается is_published
- Публикацией считаются значения
1,true,да,yesиопубликовано - Если колонка не указана, статья сохраняется как опубликованная
- Любое другое значение трактуется как черновик
В окне импорта есть ссылка "Скачать пример CSV файла". Она загружает готовый шаблон с текущей локализацией базы данных.
Поддерживаемые разделители
- запятая (
,) - точка с запятой (
;) - табуляция
Допустимый размер файла задаёт администратор установки. Если файл превышает предел, интерфейс сообщит об этом до импорта; разделите большой файл на несколько частей.
Импорт из CSV
Шаг 1: Открытие окна импорта
- Откройте страницу База знаний
- Нажмите кнопку "Импорт из CSV" в правом верхнем углу
Кнопка "Импорт из CSV" активна только если у вас есть права администратора хотя бы в одной категории базы знаний.
Шаг 2: Выбор категории
- Выберите категорию в поле "Категория для импорта"
- В списке показываются только категории, где вы можете создавать статьи
- Если доступных категорий нет, появится предупреждение "Нет доступных категорий"
Шаг 3: Выбор файла
- Нажмите "Выбрать CSV файл"
- Выберите локальный файл с расширением
.csv - После выбора в окне показываются имя файла и его размер
На что обращать внимание
- Импорт идет только в выбранную категорию
- Файл должен быть корректным CSV с колонками
titleиcontent - Содержимое статьи можно хранить с HTML-разметкой
- Перед запуском стоит проверить уникальность заголовков в целевой категории
Шаг 4: Запуск и результат
- Нажмите "Импортировать"
- Дождитесь завершения процесса
- В результатах проверьте число импортированных и пропущенных строк
- Если есть проблемы, откройте список ошибок и исправьте исходный CSV
Окно результата выводит Импорт завершен, количество Импортировано, количество Пропущено и список Ошибки импорта, если они есть.
Импорт из Confluence
Confluence импорт запускается через отдельный мастер. Он получает страницы выбранного пространства, при необходимости создает подкатегории из иерархии и переносит вложения в базу знаний.
Шаг 1: Подключение к Confluence
- Откройте "Импорт из Confluence"
- Введите URL Confluence и Personal Access Token
- Токен создается в профиле Confluence через Настройки -> Personal Access Tokens
- Нажмите "Подключиться"
Что делает мастер
- Проверяет соединение и автоматически переходит к выбору пространства после успешной проверки
- Загружает список пространств Confluence
- Показывает дерево страниц выбранного пространства
- Стартует с полностью выбранными страницами, которые можно снять через "Снять выбор"
Шаг 2: Выбор пространства
- Выберите пространство Confluence
- После выбора нажмите "Далее"
- Если пространство не найдено, мастер покажет пустое состояние
Шаг 3: Настройки импорта
- Выберите Целевую категорию
- При необходимости включите "Создавать подкатегории из иерархии"
- При необходимости включите "Публиковать статьи сразу"
- Оставьте нужные страницы выделенными в дереве
Как работает импорт страниц
- Дерево страниц строится из иерархии выбранного пространства
- Кнопка "Выбрать все" выделяет все найденные страницы
- Кнопка "Снять выбор" очищает все отметки
- Счетчик показывает, сколько страниц выбрано
Шаг 4: Запуск импорта
- Нажмите "Импортировать"
- На шаге результата отображается индикатор Импортируем статьи из Confluence…
- После завершения появится сводка с количеством импортированных и пропущенных страниц
INFRAX загружает вложения страниц Confluence в хранилище файлов статей и заменяет ссылки на них локальными путями. Если страница содержит вложения, они импортируются вместе со статьей.
Токен должен иметь права на чтение выбранного пространства и его вложений. Для импорта в INFRAX также нужны права администратора в целевой категории.
Права доступа
Импорт статей доступен только пользователям, у которых есть права просмотра базы знаний и права администратора хотя бы в одной категории.
| Уровень доступа | Что требуется |
|---|---|
| База знаний | Право на просмотр раздела База знаний в меню |
| Категория | Право администратора в целевой категории |
Как это работает в интерфейсе
- В списке категорий показываются только доступные для импорта категории
- Если доступных категорий нет, импортер показывает предупреждение и блокирует продолжение
- При выборе целевой категории для Confluence мастер использует тот же набор разрешенных категорий
Проверки и ошибки
CSV проверки
| Проверка | Что делает система |
|---|---|
| Расширение файла | Принимаются только файлы .csv |
| Размер файла | Проверяется системный лимит загрузки |
| Обязательные колонки | Должны быть title и content |
| Пустой файл | Если нет строк данных, импорт останавливается |
| Дубликаты | Статьи с таким же заголовком в выбранной категории пропускаются |
Ошибки на уровне строк
- Пустой
title- строка пропускается - Пустой
content- строка пропускается - Совпадающий заголовок в той же категории - строка пропускается
- Некорректная строка CSV с другим числом колонок - такая строка игнорируется при чтении
При критической ошибке CSV или Confluence импорта транзакция откатывается, поэтому частично сохраненные данные не остаются в базе знаний.
Ошибки Confluence
- Ошибка подключения показывается сразу после проверки URL и токена
- Ошибки загрузки пространств и страниц показываются отдельными модальными сообщениями
- Если импорт Confluence завершается с ошибкой, итоговый экран показывает текст ошибки вместо успешного результата
Рекомендации
Подготовка CSV
- Используйте ссылку "Скачать пример CSV файла" как шаблон
- Проверяйте уникальность заголовков внутри целевой категории
- Перед загрузкой убедитесь, что HTML в поле
contentкорректен - Используйте UTF-8, если в файле есть кириллица
Импорт больших объемов
- Разбивайте большие наборы данных на несколько файлов
- Проверяйте результат после каждой загрузки
- Если есть пропуски, исправляйте исходный CSV и повторяйте импорт
- Учитывайте лимит размера файла, заданный в системе
Импорт из Confluence
- Сначала проверьте соединение с Confluence отдельным токеном
- Выбирайте целевую категорию заранее, чтобы не смешивать разные темы
- Включайте создание подкатегорий только если хотите повторить структуру пространства
- После импорта проверьте вложения и опубликованность статей
Проверка после импорта
- Откройте несколько импортированных статей и проверьте отображение
- Проверьте, что вложения и ссылки на них перенеслись корректно
- Посмотрите список пропущенных строк и устраните причины ошибок
- Если импортировали черновики, опубликуйте их только после проверки