Импорт статей

ℹ️ О функции импорта

INFRAX позволяет импортировать статьи в базу знаний из CSV файлов. Это удобно для массового добавления статей, миграции контента из других систем или создания базы знаний на основе существующей документации.

Содержание раздела

Обзор функции импорта
Формат CSV файла
Процесс импорта
Права доступа
Валидация и обработка ошибок
Рекомендации

Обзор функции импорта

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

Основные возможности

Массовое создание статей из CSV файла
Поддержка HTML-форматирования в содержимом статей
Выбор статуса публикации для каждой статьи
Автоматическая валидация данных
Проверка на дубликаты заголовков
Детальный отчет о результатах импорта

Поддерживаемые разделители CSV

Система автоматически определяет разделитель в CSV файле:

Запятая (,)
Точка с запятой (;)
Табуляция

Формат CSV файла

Обязательные колонки

CSV файл должен содержать следующие обязательные колонки:

Колонка	Описание	Обязательность
`title`	Заголовок статьи	✅ Обязательно
`content`	Содержимое статьи (может содержать HTML)	✅ Обязательно
`is_published`	Статус публикации: `true`, `false`, `да`, `нет`, `1`, `0`	❌ Необязательно (по умолчанию `true`)

Пример CSV файла

title,content,is_published
"Пример статьи 1","<h1>Заголовок статьи</h1><p>Это содержимое статьи</p>","true"
"Черновик статьи","<p>Это черновик</p>","false"
"Простая статья","Текст без HTML тегов","true"

💡 Скачивание примера

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

HTML-форматирование

В поле content можно использовать HTML-теги для форматирования:

<h1>, <h2>, <h3> — заголовки
<p> — параграфы
<ul>, <ol>, <li> — списки
<strong>, <em> — выделение текста
<pre>, <code> — блоки кода
<a> — ссылки

⚠️ Экранирование кавычек

Если в содержимом статьи используются двойные кавычки, их нужно экранировать удвоением: ""

Пример: "<div class=""example"">Текст</div>"

Процесс импорта

Шаг 1: Открытие окна импорта

Откройте страницу База знаний через главное меню
Нажмите кнопку "Импорт из CSV" в правом верхнем углу

ℹ️ Доступность кнопки

Кнопка "Импорт из CSV" активна только если у вас есть права администратора хотя бы в одной категории базы знаний.

Шаг 2: Выбор категории

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

⚠️ Если нет доступных категорий

Если вы видите предупреждение "Нет доступных категорий", это означает, что у вас нет прав администратора ни в одной из категорий. Обратитесь к администратору системы для получения необходимых прав доступа.

Шаг 3: Загрузка CSV файла

Нажмите кнопку "Выбрать CSV файл"
Выберите подготовленный CSV файл с вашего компьютера
Система отобразит имя выбранного файла и его размер

Ограничения

Расширение файла должно быть .csv
Максимальный размер файла зависит от настроек системы (по умолчанию 20 МБ)
Файл должен быть в текстовом формате CSV

Шаг 4: Запуск импорта

Проверьте правильность выбранной категории и файла
Нажмите кнопку "Импортировать"
Дождитесь завершения процесса импорта

Шаг 5: Просмотр результатов

После завершения импорта система отобразит:

Импортировано: количество успешно созданных статей
Пропущено: количество строк с ошибками
Ошибки импорта: детальный список ошибок с указанием номеров строк

✅ Успешный импорт

После успешного импорта новые статьи появятся в выбранной категории. Список статей обновится автоматически.

Права доступа

Требования к правам

Для импорта статей необходимы следующие права:

Уровень	Требование
Доступ к базе знаний	Право на просмотр раздела "База знаний" в меню
Администрирование категории	Право администратора в выбранной категории

Проверка прав

Система автоматически проверяет права доступа:

При открытии окна импорта отображаются только категории, где у вас есть права администратора
Если нет доступных категорий, выводится соответствующее предупреждение
При попытке импорта сервер дополнительно проверяет права на создание статей

Валидация и обработка ошибок

Проверки при импорте

Система выполняет следующие проверки для каждой строки CSV файла:

Проверка	Описание
Обязательные поля	Наличие колонок `title` и `content`
Пустые значения	Проверка что заголовок и содержимое не пустые
Дубликаты	Проверка что статья с таким заголовком не существует в выбранной категории
Формат файла	Проверка расширения и корректности CSV структуры
Размер файла	Проверка что размер не превышает установленный лимит

Типы ошибок

Ошибки формата

Отсутствует обязательная колонка: CSV файл не содержит title или content
Неверное расширение файла: загружен файл не с расширением .csv
CSV файл пуст: файл не содержит данных
Превышен размер файла: файл слишком большой

Ошибки данных

Пустой заголовок: строка содержит пустое значение в колонке title
Пустое содержимое: строка содержит пустое значение в колонке content
Статья уже существует: статья с таким заголовком уже есть в выбранной категории

Обработка ошибок

При критических ошибках (формат файла, отсутствие колонок) импорт полностью отменяется
При ошибках в отдельных строках эти строки пропускаются, остальные импортируются
Все ошибки отображаются в окне результатов с указанием номера строки
Если импорт прерван из-за ошибки, все изменения откатываются (транзакция)

⚠️ Откат изменений

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