Импорт картриджей из CSV-файла
В этой инструкции описано, как добавить в Severcart несколько картриджей одновременно. Вместо создания каждого картриджа вручную вы подготавливаете файл со списком картриджей и загружаете его в систему. В результате каждый картридж из файла появится в разделе «Картриджи» с указанными характеристиками.
Примечание
Импорт доступен только при наличии оплаченной лицензии и прав на добавление картриджей.
Подготовка CSV-файла
CSV-файл — это текстовый файл, в котором каждая строка описывает один картридж, а значения полей разделяются запятыми.
Требования к файлу:
- Файл должен быть в кодировке UTF-8
- Первая строка файла — заголовки колонок
- Каждая следующая строка — данные одного картриджа
- Штрихкоды в файле не должны повторяться
Поля файла
| Поле | Обязательность | Описание |
|---|---|---|
| Штрихкод | обязательное | Уникальный номер картриджа |
| Производитель | обязательное | Название производителя картриджа |
| Название | обязательное | Название картриджа (добавляется в справочник автоматически, если отсутствует) |
| Тип | необязательное | Тип картриджа. Используется только при добавлении нового названия. Если не указан, будет назначен тип по умолчанию |
| Статус | обязательное | Текущее состояние картриджа |
| Помещение | обязательное | Место хранения картриджа |
| Филиал | необязательное | Филиал, к которому относится помещение |
| Комментарий | необязательное | Пояснение к картриджу |
| Перезаправки | необязательное | Количество перезаправок |
| Количество страниц | необязательное | Количество напечатанных страниц |
Допустимые статусы
В поле Статус укажите один из разрешённых статусов — цифрой или текстом:
| Значение | Статус |
|---|---|
| 1 | Полон и на складе |
| 3 | Пуст и на складе |
Предупреждение
Остальные статусы («Пустые и на списании», «Списан», «Утилизирован», «В использовании», «Заправляются», «Заправленные и на списании») не поддерживаются при импорте. Строки с такими статусами будут отклонены.
Поиск названий в справочнике
Приложение ищет название картриджа в справочнике по паре производитель + название. Если такого названия нет, система создаст его автоматически. Сначала ищется точное совпадение по производителю и названию, затем — название без учёта производителя; если совпадений нет, новое название добавляется в справочник.
Если производителя нет в справочнике, система создаст его автоматически.
При создании нового названия системе требуется тип картриджа. Если в файле указано поле Тип, будет использовано указанное значение (тип также добавляется в справочник автоматически). Если поле Тип не заполнено, новому названию будет назначен тип «Картридж» по умолчанию.
Поиск помещений
Помещение и филиал система находит по названию. Если помещение ещё не создано, оно будет добавлено автоматически.
Скачивание файла-примера
Чтобы не подготавливать файл с нуля, скачайте готовый шаблон:
- Откройте страницу импорта картриджей
- Нажмите ссылку
Файл для примера - Откройте скачанный файл и замените примеры данными своих картриджей
- Сохраните файл в кодировке UTF-8
В файле-примере обязательные поля отмечены звёздочкой *.
Импорт картриджей
Открытие страницы импорта
- В главном меню выберите
/ Картриджи / Заправленные / - Нажмите кнопку
Импорт из CSV
Откроется страница импорта.
Выбор файла
- Перетащите подготовленный файл в область загрузки или нажмите на неё и выберите файл на диске
- Убедитесь, что в области загрузки отображается имя выбранного файла
- Нажмите кнопку
Загрузка
Severcart проверит файл и покажет результат.
Примечание
Если в файле есть ошибки, они появятся во всплывающем уведомлении с указанием номера строки. Исправьте ошибки и загрузите файл снова.
Проверка данных перед импортом
После успешной загрузки откроется окно «Импорт картриджей из CSV-файла». Проверьте, что в списке корректно отображаются:
- штрихкод картриджа
- производитель и название
- тип картриджа (если указан в файле)
- статус
- помещение и филиал
- дополнительные параметры
Подтверждение импорта
Если данные верны, нажмите кнопку Импорт. Чтобы отменить загрузку без
создания картриджей, нажмите Закрыть.
Результат
После подтверждения система создаст картриджи и уведомит вас о результате:
- «Картридж успешно импортирован» — создан один картридж
- «Картриджи успешно импортированы» — создано несколько картриджей
Созданные картриджи появятся в разделе «Картриджи». Если система не сможет создать ни одного картриджа, вы получите соответствующее уведомление, и данные не будут добавлены.
Устранение неполадок
Проблема: «CSV-файл пуст или не содержит заголовков.»
Решение: Проверьте, что файл не пуст и первая строка содержит названия
колонок.
Проблема: «Строка N: требуется баркод.»
Решение: В строке N не указан штрихкод. Заполните обязательное поле
Штрихкод.
Проблема: «Строка N: недопустимое значение статуса.»
Решение: В строке N указан неподдерживаемый статус. Используйте одно из
допустимых значений: «Полон и на складе», «Пуст и на складе».
Проблема: «В CSV-файле не найдено ни одной строки с допустимыми данными.»
Решение: Проверьте файл: возможно, в нём только заголовки, либо все
строки содержат ошибки.
Проблема: Сообщение о дубликате штрихкода.
Решение: Штрихкод уже используется в системе или повторяется в файле.
Укажите уникальные штрихкоды.
Проблема: Кодировка файла повреждена (странные символы).
Решение: Сохраните файл в кодировке UTF-8 и повторите загрузку.