インポートマッパー
カテゴリ:
このドキュメントのトピック:
Tridens Monetization の Import mappers を使用すると、外部データ（CSV、フラットファイルなど）をシステム互換形式に変換して整合できます。支払いデータ、イベント、銀行取引のいずれをインポートする場合でも、Import mappers によって、システムは外部プラットフォームからの構造化データを正しく解釈して取り込めます。
Mappers の場所
移動先:Business Configuration > Import
図 1: Import Mappers default page
Import Mapper のタイプ
Import Mappers 画面の上部には 4 つのタブがあり、それぞれ異なるデータ領域を表します。すべてのタブは同じ設定構造を共有します。
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
各タブでは、スクリーンショットに示すようなフォームを使用して Add a new mapper できます。
新しい Import Mapper の追加
4 つのタブのいずれかで Add ボタンをクリックし、Create Mapper フォームを開きます。入力が必要なフィールドは、すべての mapper タイプで同じです。
必須フィールド
表 1: 必須フィールド
| Field | Description |
|---|---|
| Name | mapper の一意で説明的な名前（例: Bankart Payment Mapper） |
| Code | 内部で使用されるシステム識別子（例: BANKART_01） |
| Description | 任意。この mapper の目的またはソースに関するメモを追加します |
| Prefix | 任意。マッピング中に一意の値を追加するために使用します |
| Import Mode | 入力ファイルの構造を定義します。オプション: Single または Multi |
| Delimiter | ファイル区切り文字。通常はカンマ ,、タブ \t、またはセミコロン ; |
| File | マッピングテンプレートファイル（通常は CSV または TXT 形式）をアップロードします |
図 2: Create Import Mapper page
ユースケース例
取引 ID、顧客 ID、金額、ステータスの列を含む CSV ファイルを支払いプロバイダー（例: Stripe）からインポートするとします。
それらの列を Tridens が期待するフィールドに整合させるため、Payment Mapper を作成します。
利用可能なタブの概要
Import Mappers 配下の各タブは、同じフィールドを受け付けます。
1. Payment Mappers
外部支払いシステムから生の取引データをインポートするために使用します。
2. Direct Debit Mappers
銀行または PSP からの口座引き落とし注文や委任データをマッピングします。
3. Event Mappers
レーティングまたは課金ロジックに影響するイベント（例: 使用量イベント、トリガー）をインポートします。
4. Bank Mappers
インポートされた銀行明細または照合ファイルを連携するために使用します。
ベストプラクティス
Info “Tip” - code と prefix には一貫した命名規則を使用します。 - 本番環境で使用する前に、必ず sandbox 環境でマッピングファイルをテストします。 - データソース（CSV、TSV など）に基づいて正しい delimiter を選択します。 - マッピングテンプレートとテストファイルのバックアップコピーを保持します。
