Import Mappers
Catégorie:
Sujets dans ce document :
- Où trouver les Mappers
- Types d’Import Mappers
- Ajout d’un nouvel Import Mapper
- Exemple de cas d’utilisation
- Présentation des onglets disponibles
- Bonnes pratiques
Les import mappers dans Tridens Monetization vous permettent de transformer et d’aligner les données externes (CSV, fichiers plats, etc.) dans des formats compatibles avec le système. Qu’il s’agisse d’importer des données de paiement, des événements ou des transactions bancaires, les import mappers garantissent que le système interprète et ingère correctement les données structurées provenant de plateformes externes.
Où trouver les Mappers
Naviguez vers :Business Configuration > Import
Figure 1 : Page par défaut des Import Mappers
Types d’Import Mappers
En haut de l’écran Import Mappers, vous trouverez quatre onglets, chacun représentant un domaine de données différent. Tous les onglets partagent la même structure de configuration :
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
Chaque onglet vous permet d’ajouter un nouveau mapper à l’aide d’un formulaire comme celui présenté dans la capture d’écran.
Ajout d’un nouvel Import Mapper
Cliquez sur le bouton Add dans l’un des quatre onglets pour ouvrir le formulaire Create Mapper. Les champs à remplir sont identiques pour tous les types de mappers.
Champs obligatoires
Table 1 : Champs obligatoires
| Champ | Description |
|---|---|
| Name | Un nom unique et descriptif pour le mapper (par ex. Bankart Payment Mapper) |
| Code | Un identifiant système utilisé en interne (par ex. BANKART_01) |
| Description | Facultatif. Ajoutez des notes sur l’objectif ou la source de ce mapper |
| Prefix | Facultatif. Utilisé pour ajouter des valeurs uniques pendant le mappage |
| Import Mode | Définit la structure du fichier d’entrée. Options : Single ou Multi |
| Delimiter | Délimiteur de fichier, généralement virgule ,, tabulation \t ou point-virgule ; |
| File | Téléchargez le fichier modèle de mappage (généralement au format CSV ou TXT) |
Figure 2 : Page Create Import Mapper
Exemple de cas d’utilisation
Vous importez un fichier CSV d’un fournisseur de paiement (par ex. Stripe) qui comprend des colonnes pour l’ID de transaction, l’ID client, le montant et le statut.
Vous allez créer un Payment Mapper pour aligner ces colonnes avec les champs attendus dans Tridens.
Présentation des onglets disponibles
Chaque onglet sous Import Mappers accepte les mêmes champs :
1. Payment Mappers
Utilisé pour importer des données de transaction brutes à partir de systèmes de paiement externes.
2. Direct Debit Mappers
Mappe les données d’ordre de débit ou de mandat provenant des banques ou des PSP (ang. Payment Service Providers).
3. Event Mappers
Importe des événements (par ex. événements d’utilisation, déclencheurs) qui affectent la logique de tarification ou de facturation.
4. Bank Mappers
Utilisé pour intégrer les relevés bancaires importés ou les fichiers de rapprochement.
Bonnes pratiques
Conseil :
- Utilisez des conventions de nommage cohérentes pour les codes et les préfixes.
- Testez toujours votre fichier de mappage dans un environnement sandbox avant toute utilisation en production.
- Choisissez le bon délimiteur en fonction de votre source de données (CSV, TSV, etc.).
- Conservez des copies de sauvegarde des modèles de mappage et des fichiers de test.
