Custom Cards Import RU

Импорт своих карточек

Загрузка карточек из вашего файла - удобно, когда список ведётся где-то ещё или собирается скриптом. API ключи не нужны. Находится в Настройки → Импорт → Свои карточки.

Формат файла

Один файл за один импорт. Принимаются два формата:

• JSON - массив объектов или один объект для одной карточки.
• CSV - одна строка заголовка с названиями колонок, затем по карточке на строку. Работают обычные правила кавычек CSV, поэтому значение может содержать запятые и переносы строк, если обернуть его в кавычки.

Обязательны только два поля у каждой карточки: название (title) и тип (type - тип медиа: игра, фильм, сериал, аниме, манга, книга и т.д.). Всё остальное - по желанию.

Необязательные поля карточки покрывают то же, что есть у обычной карточки: альтернативное название, описание, год, жанры, ссылка, URL обложки, платформа, формат манги / аниме и объёмы прогресса (серии, главы, страницы, части).

Личные поля можно заполнить прямо в файле: статус, ваша оценка, заметка, счётчик повторов, даты начала и завершения, потраченное время, отметка избранного, прогресс по сериям / сезонам и теги. Теги, которых ещё нет, создаются автоматически.

Шаблоны

На экране импорта есть две кнопки скачивания, дающие готовый файл для заполнения:

• шаблон CSV только со строкой заголовка
• шаблон JSON, который описывает сам себя - подсказки в нём начинаются с _, и импорт их игнорирует, поэтому шаблон импортируется как есть, если хотите посмотреть, как всё ляжет

Как импортировать

1. Откройте Настройки → Импорт → Свои карточки
2. При желании скачайте шаблон как отправную точку, заполните и сохраните свой файл
3. Выберите файл JSON или CSV
4. Выберите целевую коллекцию - новую или существующую
5. Проверьте предпросмотр (ниже), отметьте, какие строки взять, и подтвердите

Предпросмотр

Прежде чем что-либо записать, файл читается и проверяется, а предпросмотр показывает сводку: Распознано · Ошибки · Дубликаты.

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

У списка есть чекбокс на каждую строку плюс выделить всё / снять всё, так что вы решаете, что именно импортировать. Пока не подтвердите, библиотека не меняется.

Обложки

Если у строки есть URL обложки (http или https), картинка скачивается только после подтверждения импорта и только для тех строк, что вы реально взяли. Если обложка не скачалась, карточка всё равно создаётся, а на ней остаётся короткая пометка.

Платформы

Текст платформы сопоставляется со списком платформ приложения без учёта регистра - можно писать как краткое название, так и полное. Если ничего не совпало, текст сохраняется как есть в виде произвольного названия платформы.

Заполнение одной карточки из файла

Необязательно набирать каждое поле руками. Когда вы создаёте или редактируете отдельную свою карточку, можно загрузить файл JSON или CSV - те же форматы, что принимает массовый импорт, - и он заполнит форму за вас. Выберите файл, и поля подставятся. Перед сохранением всё ещё можно поправить.

В форме создания есть свои поля Мои заметки и Теги (теги - списком через запятую), и загруженный файл заполняет их из колонок comment и tags. При создании заметка сохраняется как личный комментарий элемента, а теги проходят через общую систему тегов - отсутствующие создаются автоматически. В форме редактирования этих двух полей нет: заметку и теги там меняют на экране деталей элемента.

См. также

• Импорт / Экспорт - формат коллекций .xcollx и полные резервные копии
• Детали элемента - что означает каждое поле карточки