Что это
Бесплатная проверка файла CSV на соответствие договорённому формату. Понимает кавычки, запятые внутри значений, точки с запятой, табуляции и выгрузки из Excel и работает целиком в браузере.
Проверка CSV по договорённости
Файл от партнёра снова сломан. Узнайте точно, какой столбец и какие строки.
Опишите ожидаемые столбцы, добавьте CSV от партнёра, и CSV Guard проверит каждый заголовок и каждую строку. Вы увидите переименованные и пропавшие столбцы, неверные даты, дубли, сломанные числа и опасные ячейки с номерами строк, а также получите доказательную записку для ответа.
- Переименован
- Не тот формат даты
- Повтор ID
Для кого
Для операционных команд, которые загружают данные партнёров, инженеров данных, основателей, которые нянчатся с хрупким импортом, и поддержки, застрявшей между двумя поставщиками.
Какую проблему решает
Импорт падает с туманной ошибкой или, хуже того, молча загружает неверные данные. Здесь у каждой проблемы есть столбец, строки и пример, так что исправление начинается с фактов, а не с долгой переписки.
Проверить файл
Файлы читаются в этой вкладке. Ничего не загружается и не сохраняется.
По одному столбцу в строке с типом и необязательными флагами, или просто вставьте ожидаемую строку заголовков.
Вставьте содержимое или откройте файл. Запятые, точки с запятой, табуляции и вертикальные черты определяются автоматически.
Проверки ещё не было
Вставьте схему и CSV или загрузите пример, чтобы увидеть полный отчёт.
Записка содержит примеры значений из файла. Проверьте её, прежде чем отправлять за пределы команды.
Формат схемы
Опишите договорённость один раз и используйте её для каждой поставки.
order_id int required unique
email email required
amount decimal required
currency enum:EUR|USD|TRY
created_at date required
sku textСначала имя
Пишите имя столбца точно так, как договорились. Сопоставление ловит и другой регистр, пробелы и мелкие опечатки и говорит, что именно нашло.
Затем тип
text, int, decimal, date, email, url, bool или enum: с разрешёнными значениями через вертикальную черту.
Затем флаги
required значит без пустых ячеек, unique значит без повторов. Не пишите их, если они не нужны.
Или только заголовок
Вставьте ожидаемую строку заголовков, и столбцы будут проверены только на наличие и порядок.
Как пользоваться
Опишите договорённость
Перечислите ожидаемые столбцы с типами и флагами. Храните описание рядом с кодом импорта.
Добавьте файл
Вставьте CSV или откройте файл. Разделитель, кавычки и переводы строк определятся сами.
Прочитайте проблемы
Ошибки ломают импорт или загружают неверные данные. Предупреждения стоит исправить, но они вас не остановят.
Отправьте доказательства
Скопируйте записку в переписку с партнёром или скачайте проблемы в CSV для своей команды.
Полезно знать
- Даты ожидаются в формате ISO. Форматы, где первым идёт день или месяц, помечаются, потому что их легко перепутать.
- Файлы до 20 МБ нормально обрабатываются в большинстве браузеров. Крупные лучше разделить.
- Файлы Excel сначала нужно сохранить как CSV.
- Типы проверяются по каждому значению. Столбец может пройти проверку, даже если одно значение покажется человеку странным.
Вопросы
Файл загружается на сервер?
Нет. Разбор и проверки идут на этой странице, файл не покидает ваше устройство.
Почему ячейки с формулами считаются ошибкой?
Ячейка, начинающаяся с = или @, может выполниться как формула, когда файл откроют в таблице. Это известная атака, инъекция в CSV.
Что такое метка порядка байтов?
Невидимый символ, который некоторые программы ставят в начало файлов UTF 8. Он может прилипнуть к имени первого заголовка и сломать сопоставление.
Может он исправить файл за меня?
Он точно говорит, что и где исправить. Автоматическая правка данных партнёра спрятала бы проблему вместо того, чтобы её решить.