Import-Mapper
Kategorie:
Themen in diesem Dokument:
- Wo Sie Mappers finden
- Import Mapper Typen
- Hinzufügen eines neuen Import Mappers
- Beispiel-Anwendungsfall
- Übersicht über die verfügbaren Tabs
- Bewährte Methoden
Import Mappers in Tridens Monetization ermöglichen es Ihnen, externe Daten (CSV, Flatfiles usw.) in systemkompatible Formate zu transformieren und auszurichten. Egal ob Sie Zahlungsdaten, Ereignisse oder Banktransaktionen importieren, Import Mappers stellen sicher, dass das System strukturierte Daten von externen Plattformen korrekt interpretiert und aufnimmt.
Wo Sie Mappers finden
Navigieren Sie zu:Business Configuration > Import
Abbildung 1: Standardseite Import Mappers
Import Mapper Typen
Am oberen Rand des Bildschirms Import Mappers finden Sie vier Tabs – jeder steht für eine andere Datendomäne. Alle Tabs teilen die gleiche Konfigurationsstruktur:
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
In jedem Tab können Sie einen neuen Mapper hinzufügen über ein Formular, wie es im Screenshot gezeigt wird.
Hinzufügen eines neuen Import Mappers
Klicken Sie auf die Schaltfläche Add in einem der vier Tabs, um das Formular Create Mapper zu öffnen. Die Felder, die Sie ausfüllen müssen, sind bei allen Mapper-Typen identisch.
Erforderliche Felder
Tabelle 1: Erforderliche Felder
| Feld | Beschreibung |
|---|---|
| Name | Ein eindeutiger, beschreibender Name für den Mapper (z. B. Bankart Payment Mapper) |
| Code | Ein System-Identifikator, der intern verwendet wird (z. B. BANKART_01) |
| Description | Optional. Fügen Sie Notizen zum Zweck oder zur Quelle dieses Mappers hinzu |
| Prefix | Optional. Wird verwendet, um während des Mappings eindeutige Werte anzuhängen |
| Import Mode | Definiert die Struktur der Eingabedatei. Optionen: Single oder Multi |
| Delimiter | Dateitrennzeichen, typischerweise Komma ,, Tabulator \t oder Semikolon ; |
| File | Laden Sie die Mapping-Vorlagendatei hoch (normalerweise im CSV- oder TXT-Format) |
Abbildung 2: Seite Import Mapper erstellen
Beispiel-Anwendungsfall
Sie importieren eine CSV-Datei von einem Zahlungsanbieter (z. B. Stripe), die Spalten für Transaktions-ID, Kunden-ID, Betrag und Status enthält.
Sie erstellen einen Payment Mapper, um diese Spalten an die in Tridens erwarteten Felder anzupassen.
Übersicht über die verfügbaren Tabs
Jeder Tab unter Import Mappers akzeptiert die gleichen Felder:
1. Payment Mappers
Wird für den Import von Roh-Transaktionsdaten aus externen Zahlungssystemen verwendet.
2. Direct Debit Mappers
Ordnet Lastschriftauftrags- oder Mandatsdaten von Banken oder PSPs (Zahlungsdienstleistern) zu.
3. Event Mappers
Importiert Ereignisse (z. B. Nutzungsereignisse, Trigger), die die Bewertungs- oder Abrechnungslogik beeinflussen.
4. Bank Mappers
Wird für die Integration importierter Kontoauszüge oder Abstimmungsdateien verwendet.
Bewährte Methoden
Tipp:
- Verwenden Sie konsistente Benennungskonventionen für Codes und Präfixe.
- Testen Sie Ihre Mapping-Datei immer in einer Sandbox-Umgebung vor der produktiven Nutzung.
- Wählen Sie das richtige Trennzeichen basierend auf Ihrer Datenquelle (CSV, TSV usw.).
- Bewahren Sie Sicherungskopien von Mapping-Vorlagen und Testdateien auf.