Практика системного анализа · 4 минуты
CSV открылся, но код изменился: как принять выгрузку в целевой программе
Как проверить CSV в целевой программе: сохранить ведущие нули, прочитать запятую внутри значения, сверить число строк и типы после выбранного импорта.
Файл может пройти проверку формата, а при открытии превратить код 0012 в число 12. Если выгрузка нужна для дальнейшей работы, принимать надо и файл, и результат его чтения в согласованной программе. Иначе команда проверит один контракт, а пользователь получит другой.
Учебная выгрузка из двух строк
Оператор получает список товаров с кодом, названием и количеством. Пример полностью вымышленный. В учебном договоре код — строка; ведущие нули значимы. Разделитель — запятая. Кодировка — UTF-8; текст с запятой заключают в кавычки.
code,name,quantity
0012,"Чай, зелёный",3
0100,Кофе,4| Поле | После корректного импорта | Что ловит проверка |
|---|---|---|
| code первой строки | Текст 0012 | Потерю нулей при выводе типа |
| name первой строки | Чай, зелёный | Разбиение значения на две колонки |
| quantity второй строки | Число 4 | Сдвиг колонок или неверный тип |
| Число строк | 2 без заголовка | Включение заголовка в данные |
Не подменяйте ожидаемые значения визуальным сходством. У ячейки с кодом 12 может быть формат отображения 0000. Она покажет 0012, но при следующей выгрузке нули могут пропасть. Для ключа проверьте значение и тип, а не только картинку.
Согласовать способ открытия
Запишите целевую программу и путь импорта. Двойной щелчок по файлу и импорт с явным типом столбца могут дать разные результаты. Если команда поддерживает только второй путь, он должен быть понятен оператору и воспроизводим. Если продукт обещает открытие без настройки, проверьте именно его или согласуйте другой формат выгрузки.
Артефакт приёмки включает файл, параметры чтения и таблицу ожидаемых значений после импорта. Добавьте сценарий дальнейшего использования: сопоставление кода 0012 с исходным товаром. Совпадение сумм не поймает ошибку ключа.
LLM может подготовить учебные строки с разделителем внутри значения и ведущими нулями. Проверяющий читает результат подходящим парсером, а затем проверяет целевую программу. В этой статье сам файл дан для будущей проверки; запуск офисного приложения не заявлен.
Проверка формы и смысла данных разобрана в материале про контракт API. Для записи принятого способа чтения подойдёт журнал решений.
Вопросы по CSV
Достаточно, что файл открывается?
Нет. Нужно убедиться, что значения и типы полей не изменились.
Почему код нельзя сравнивать как число?
В этом контракте ведущие нули входят в ключ.
Как проверить запятую в названии?
После чтения значение «Чай, зелёный» должно занимать одну колонку.
Зачем записывать способ импорта?
Автоматическое определение типов и явный импорт могут дать разный результат.
Что считать готовым артефактом?
Контрольный файл и ожидаемые значения для выбранного способа чтения.
Автор: Иннокентий Бодров, автор Аналитической мастерской.