导入映射器
导入映射器用于转换和对齐传入数据文件（例如付款、事件或银行交易），使其成为 Tridens Monetization 系统能够理解的格式。它们确保外部数据源正确映射到内部字段，以便准确处理和自动化。
分类:
本文档主题：
Tridens Monetization 中的导入映射器允许您将外部数据（CSV、平面文件等）转换并对齐为系统兼容的格式。无论是导入付款数据、事件还是银行交易，导入映射器都能确保系统正确解释并摄取来自外部平台的结构化数据。
在哪里查找映射器
导航到：Business Configuration > Import
图 1： 导入映射器默认页面
导入映射器类型
在 Import Mappers 屏幕顶部，您会看到四个选项卡，每个选项卡代表一个不同的数据领域。所有选项卡共享相同的配置结构：
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
每个选项卡都允许您使用截图中所示的表单添加新的映射器。
添加新的导入映射器
在四个选项卡中的任意一个点击 Add 按钮，以打开 Create Mapper 表单。所有映射器类型需要填写的字段都相同。
必填字段
表 1： 必填字段
| 字段 | 描述 |
|---|---|
| Name | 映射器的唯一且具有描述性的名称（例如 Bankart Payment Mapper） |
| Code | 内部使用的系统标识符（例如 BANKART_01） |
| Description | 可选。添加有关此映射器用途或来源的说明 |
| Prefix | 可选。用于在映射期间附加唯一值 |
| Import Mode | 定义输入文件的结构。选项：Single 或 Multi |
| Delimiter | 文件分隔符，通常为逗号 ,、制表符 \t 或分号 ; |
| File | 上传映射模板文件（通常为 CSV 或 TXT 格式） |
图 2： Create Import Mapper 页面
示例用例
您正在从付款提供商（例如 Stripe）导入一个 CSV 文件，其中包含交易 ID、客户 ID、金额和状态等列。
您将创建一个 Payment Mapper，以将这些列与 Tridens 中预期的字段对齐。
可用选项卡概览
Import Mappers 下的每个选项卡都接受相同字段：
1. Payment Mappers
用于从外部支付系统导入原始交易数据。
2. Direct Debit Mappers
映射来自银行或 PSP 的借记订单或授权数据。
3. Event Mappers
导入影响评级或计费逻辑的事件（例如使用事件、触发器）。
4. Bank Mappers
用于集成导入的银行对账单或对账文件。
最佳实践
Info “Tip” - 对代码和前缀使用一致的命名约定。 - 在生产使用之前，始终先在沙盒环境中测试映射文件。 - 根据数据源（CSV、TSV 等）选择正确的分隔符。 - 保留映射模板和测试文件的备份副本。
