Elysia Tools
Навигация
Workflow Playbook
Извлекайте поля JSON по путям, преобразуйте payload с помощью JSONata и фиксируйте происхождение каждого поля, не выдавая это за проверку бизнес-смысла.
Темы
Этот процесс подходит инженерам данных, разработчикам интеграций и аналитикам, которым нужен преобразованный JSON, доступный для проверки другим человеком. Начните с репрезентативного входного примера, короткого списка полей и примера результата или целевой структуры. Не изменяйте исходный вход. До запуска определите, как считать отсутствующие пути, null, массивы и производные значения.
Используйте инструмент запросов JSONPath, чтобы найти исходные пути и посчитать запрошенные, найденные, пустые и отсутствующие значения. Так ошибка пути станет видна до того, как скроется внутри большого выражения. После проверки выбора перейдите в студию запросов и преобразований JSONata. Сохраните выражение и сравните результат с ожидаемым примером, проверяя переименованные ключи, вложенные объекты, отфильтрованные элементы и вычисляемые поля.
Используйте трассировщик происхождения JSON-данных, чтобы связать каждое поле результата с исходным путём или зависимостями, из которых оно получено. Пакет приёмки должен содержать примеры входа и выхода, подсчёты полей, выражение JSONata и заявление о покрытии для каждого поля результата. Отсутствующие или неразрешённые пути остаются видимыми как пробелы. Результат документирует происхождение преобразования, но не обещает правильность бизнес-интерпретации или downstream-приложения. Для близких задач форматирования и конвертации используйте JSON Format и JSON Convert.
Руководство по рабочему процессу
Откройте репрезентативный payload, определите границы объектов и массивов и перечислите ожидаемые поля результата до написания преобразования.
Выполните выражения JSONPath, сохраните найденные значения и запишите количества запрошенных, найденных, пустых и отсутствующих полей.
Примените выражение JSONata к выбранным данным, сравните результат с ожидаемым примером и отметьте переименованные, отфильтрованные, вложенные и производные поля.
Свяжите каждое поле результата с входными путями или зависимостями через этап JSONata, проверьте покрытие lineage и оставьте нерешённые пробелы для ревью.
Используйте инструмент запросов JSONPath для поиска и подсчёта значений по путям. Используйте студию запросов и преобразований JSONata, когда значения нужно переименовать, отфильтровать, вложить или объединить в новый payload.
Решите это до преобразования. Скопированное поле сохраняет исходный путь, вычисляемое поле содержит зависимости и выражение, а отсутствующее поле остаётся явно отмеченным, а не заполняется догадкой.
Перед принятием сохраните пару вход-выход, подсчёт запрошенных и созданных полей и покрытие происхождения для каждого поля результата.