Import Mappers

Import Mappers służą do przekształcania i dopasowywania przychodzących plików danych (takich jak płatności, zdarzenia lub transakcje bankowe) do formatu zrozumiałego dla systemu Tridens Monetization. Zapewniają, że zewnętrzne źródła danych są prawidłowo mapowane na pola wewnętrzne w celu dokładnego przetwarzania i automatyzacji.

Kategoria:

Programowanie i integracja

Tematy w tym dokumencie:

Gdzie znaleźć Mappers
Typy Import Mapper
Dodawanie nowego Import Mapper
- Pola wymagane
Przykładowy przypadek użycia
Przegląd dostępnych kart
Najlepsze praktyki

Importowanie mapperów w Tridens Monetization pozwala na przekształcać i dopasowywać dane zewnętrzne (CSV, pliki płaskie itd.) do formatów zgodnych z systemem. Niezależnie od tego, czy importujesz dane dotyczące płatności, zdarzenia czy transakcje bankowe, narzędzia mapujące import zapewniają, że system poprawnie interpretuje i pobiera ustrukturyzowane dane z platform zewnętrznych.

Gdzie znaleźć Mappers

Przejdź do: Business Configuration > Import

Rysunek 1: Domyślna strona Import Mappers

Typy Import Mapper

U góry ekranu Import Mappers znajdziesz cztery zakładki – każda reprezentuje inną domenę danych. Wszystkie karty mają tę samą strukturę konfiguracji:

Payment Mappers
Direct Debit Mappers
Event Mappers
Bank Mappers

Każda zakładka pozwala dodać nowy mapper przy użyciu formularza pokazanego na zrzucie ekranu.

Dodawanie nowego Import Mapper

Kliknij przycisk Add na dowolnej z czterech zakładek, aby otworzyć formularz Create Mapper. Pola, które należy wypełnić, są identyczne we wszystkich typach map.

Pola wymagane

Tabela 1: Pola wymagane

Pole	Opis
Name	Unikalna, opisowa nazwa programu mapującego (np. `Bankart Payment Mapper`)
Code	Identyfikator systemowy używany wewnętrznie (np. `BANKART_01`)
Description	Opcjonalne. Dodaj notatki na temat celu lub źródła tego narzędzia mapującego
Prefix	Opcjonalne. Służy do dołączania unikalnych wartości podczas mapowania
Import Mode	Definiuje strukturę pliku wejściowego. Opcje: `Single` lub `Multi`
Delimiter	Separator pliku, zwykle przecinek `,`, tabulator `\t` lub średnik `;`
File	Prześlij plik szablonu mapowania (zwykle w formacie CSV lub TXT)

Rysunek 2: Utwórz stronę narzędzia mapowania importu

Przykładowy przypadek użycia

Importujesz plik CSV od dostawcy płatności (np. Stripe), który zawiera kolumny zawierające identyfikator transakcji, identyfikator klienta, kwotę i status. Utworzysz Payment Mapper, aby wyrównać te kolumny z polami oczekiwanymi w Tridens.

Przegląd dostępnych kart

Każda zakładka pod Import Mappers akceptuje te same pola:

1. Payment Mappers

Służy do importowania surowych danych transakcyjnych z zewnętrznych systemów płatności.

2. Direct Debit Mappers

Mapuje dane dotyczące poleceń zapłaty lub upoważnień z banków lub dostawców usług płatniczych.

3. Event Mappers

Importuje zdarzenia (np. zdarzenia użytkowania, wyzwalacze), które wpływają na logikę oceny lub opłat.

4. Bank Mappers

Służy do integracji zaimportowanych wyciągów bankowych lub plików uzgadniających.

Najlepsze praktyki

Informacja “Wskazówka”

Stosuj spójne konwencje nazewnictwa dla kodów i przedrostków.
Zawsze testuj plik mapowania w środowisku piaskownicy przed użyciem w środowisku produkcyjnym.
Wybierz właściwy ogranicznik w oparciu o źródło danych (CSV, TSV itp.).
Przechowuj kopie zapasowe szablonów mapowania i plików testowych.