Import Mappers
Категория:
Темы в этом документе:
- Where to Find Mappers
- Import Mapper Types
- Adding a New Import Mapper
- Example Use Case
- Available Tabs Overview
- Best Practices
Import mappers в Tridens Monetization позволяют преобразовывать и согласовывать внешние данные (CSV, flat files и т. д.) в совместимые с системой форматы. При импорте платежных данных, событий или банковских транзакций import mappers гарантируют, что система корректно интерпретирует и загружает структурированные данные из внешних платформ.
Where to Find Mappers
Перейдите в:Business Configuration > Import
Рисунок 1: Import Mappers default page
Import Mapper Types
В верхней части экрана Import Mappers находятся четыре вкладки, каждая из которых представляет отдельную область данных. Во всех вкладках используется одинаковая структура конфигурации:
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
Каждая вкладка позволяет Add a new mapper через форму, показанную на скриншоте.
Adding a New Import Mapper
Нажмите Add в любой из четырех вкладок, чтобы открыть форму Create Mapper. Поля, которые необходимо заполнить, одинаковы для всех типов mapper.
Required Fields
Таблица 1: Required Fields
| Field | Description |
|---|---|
| Name | Уникальное, описательное имя для mapper (например, Bankart Payment Mapper) |
| Code | Системный идентификатор, используемый internally (например, BANKART_01) |
| Description | Optional. Добавьте заметки о назначении или источнике этого mapper |
| Prefix | Optional. Используется для добавления уникальных значений during mapping |
| Import Mode | Определяет структуру входного файла. Варианты: Single или Multi |
| Delimiter | Разделитель файла, обычно запятая ,, табуляция \t или точка с запятой ; |
| File | Загрузите файл шаблона сопоставления (обычно CSV или TXT) |
Рисунок 2: Create Import Mapper page
Example Use Case
Вы импортируете CSV-файл от payment provider (например, Stripe), содержащий столбцы transaction ID, customer ID, amount и status.
Вы создаете Payment Mapper, чтобы сопоставить эти столбцы с полями, которые ожидает Tridens.
Available Tabs Overview
Каждая вкладка в Import Mappers принимает одинаковые поля:
1. Payment Mappers
Используется для импорта необработанных платежных данных из внешних payment systems.
2. Direct Debit Mappers
Сопоставляет данные debit order или mandate из банков или PSP.
3. Event Mappers
Импортирует events (например, usage events, triggers), которые влияют на rating или charging logic.
4. Bank Mappers
Используется для интеграции импортированных bank statements или reconciliation files.
Best Practices
Info “Tip” - Используйте единообразные соглашения об именовании для code и prefix. - Всегда тестируйте mapping file в sandbox environment перед использованием в production. - Выбирайте правильный delimiter в зависимости от источника данных (CSV, TSV и т. д.). - Храните резервные копии mapping templates и test files.
