🏆 Маппинг данных - что это и зачем? 🏆

Маппинг - это процесс сопоставления полей (данных) из одной системы с соответствующими полями в другой системе.
Это нужно, так как разные системы могут описывать один и тот же объект данных по-разному.

Этот процесс всегда необходим в задачах на интеграции.

Маппинг описывают в виде таблицы.
Допустимо делать и в виде структурированного списка, но по опыту скажу - таблицы удобнее.


➡️ В таблице с маппингом делают несколько основных колонок:

- название параметра на разговорном языке;
- описание, требования к валидации, ФЛК (форматно-логический контроль) и преобразованиям, если это необходимо;
- названия параметра в API каждой системы (например, поле из JSON, поле из xml или другого формата сообщения, query из URL и др);
- название параметра в БД системы, которая отвечает за работу интеграции, если в процессе работы метода надо сохранить данные в БД.
- типы данных в каждой системе и в БД;

Допустима вариативность с колонками. Их может быть больше, а может быть и меньше.


Если говорить про задачу интеграцию системы #EventTasksGA с Todoist для создания задач, то маппинг будет содержать несколько колонок:

- название поля на русском
- название поля в REST API Backend EventTasksGA
- название параметра в API системы Todoist, чтобы установить соответствие с её полями в интеграции
- название поля в БД EventTasksGA, т.к. задача после создания сохраняется в её БД
- описание поля, требования к его обработке и проверкам
- типы данных в API EventTasksGA, API Todoist и БД. Я бы добавила только отдельную колонку “Тип данных в API EventTasksGA”. Все остальные типы данных не так важны или очевидны.


Маппинг помогает разработчикам понять, какие данные нужно получать из внешней системы, с которой интеграция, что важно сохранить в БД или сопоставить с ней, а что нужно просто показать пользователю и не надо держать в памяти программы 🙌

#ИнтеграцииGA