CSV или JSON? Выберите формат для следующего шага.

Одна информация — две разные формы

CSV и JSON — текстовые форматы. Оба можно открыть в текстовом редакторе, передавать между приложениями и использовать для хранения данных. Разница в том, как они описывают эти данные.

CSV представляет таблицу: каждая запись занимает строку, а ячейки разделены запятыми. Названия столбцов обычно находятся в строке заголовка. JSON может представлять объекты, списки, строки, числа, логические значения и null, при необходимости с вложенными структурами.

name,company
Alex,Studio North
Sam,Orbit

[
  {"name": "Alex", "company": "Studio North"},
  {"name": "Sam", "company": "Orbit"}
]

В этих примерах содержатся одни и те же две записи. Ни один формат сам по себе не точнее: выбор зависит от системы, которая будет читать данные дальше.

Выберите CSV для плоской таблицы

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

У простоты есть обратная сторона: CSV не задаёт типы данных. Принимающее приложение само решает, является ли значение текстом, числом или датой. Поэтому код 00123 может превратиться в 123, если не импортировать столбец как текст.

Запятые внутри значений тоже требуют особой обработки. Название компании North, Inc. должно находиться в ячейке, заключённой в кавычки. Кавычки внутри такого значения удваиваются. Корректный конвертер делает это автоматически.

Выберите JSON для структурированных данных

JSON удобен, когда в записи есть необязательные поля, список меток или вложенный адрес. Объект сохраняет эти связи без необходимости укладывать всё в прямоугольную таблицу.

Этот формат также часто используется для данных вебхуков и API приложений. Всегда проверяйте схему принимающей системы: корректный JSON не обязательно имеет структуру, которую принимает интеграция.

При преобразовании CSV в JSON определите, какие столбцы оставить строками, а какие превратить в числа или логические значения. Сохраняйте идентификаторы строками, чтобы не менять их исходное представление.

Преобразуйте с учётом системы-получателя

Для преобразования массива JSON в CSV сначала выберите фиксированный набор столбцов. Решите, как обрабатывать отсутствующие поля, значения null и вложенные объекты. Для вложенного адреса могут понадобиться отдельные столбцы, а для списка — своя таблица.

Это удобно для просмотра записей API, но преобразование туда и обратно не сохраняет всё без потерь. Возврат к JSON не восстановит исходные типы и не отличит отсутствующее поле от null. Сохраните оригинал, если полная структура может понадобиться позже.

Если источник — веб-страница, WebAct поможет извлечь видимую информацию в файл. Платные интеграции также могут отправить результат завершённой задачи в процесс через вебхук. Проверьте результат и схему принимающей стороны, прежде чем подключать последующее действие.