エクスポートマッパー
カテゴリ:
このドキュメントのトピック:
Tridens Monetization の Export Mappers は、支払い記録、請求書データ、イベントログなどの送信データを構造化し、銀行、ERP、請求パートナー、BI ツールなどの外部システムが必要とする形式にするために使用されます。
Export mappers を使用すると、システムデータをエクスポート前にどのように変換およびフォーマットするかを定義し、サードパーティ利用者との互換性を確保できます。
Export Mappers の場所
移動先:Business Configuration > Export
図 1: Export Mappers default page
Export Mapper のタイプ
Export Mappers 画面には、領域固有のエクスポートタイプを表す 3 つの個別タブがあります。Import Mappers と同様に、すべて同じ設定形式を使用します。
利用可能なタブ:
- Payment Mappers
- Invoice Mappers
- Event Mappers
各タブには、新しい export mapper を設定するための Add オプションがあります。
新しい Export Mapper の追加
いずれかのタブで Add ボタンをクリックし、Create Export Mapper フォームを開きます。以下のフィールドは 3 つの mapper タイプすべてに共通です。
図 2: Create Export Mapper page
必須フィールド
表 1: 必須フィールド
| Field | Description |
|---|---|
| Name | mapper の明確で一意な名前（例: ERP_Invoice_Export） |
| Code | 内部システムコード識別子（例: ERP_01） |
| Description | 任意。この export が対象とする内容に関するメモまたは背景 |
| Prefix | 任意。レコードを一意にタグ付けする、または export ファイル名をフォーマットするために使用します |
| Import Mode | 主に importers 用ですが、mapper が双方向同期に使用される場合に表示されることがあります |
| Delimiter | エクスポートファイルの区切り文字を指定します（例: カンマ ,、タブ \t、セミコロン ;） |
ファイルをアップロードした後、システム設定に応じて列からフィールドへのマッピングルールを定義することもできます。
タブの概要
1. Payment Mappers
送信支払いデータ（例: 処理済み取引、決済）を、必要な銀行またはパートナー形式でエクスポートするために使用します。
2. Invoice Mappers
SAP や QuickBooks などの ERP システムまたは外部会計ツールへエクスポートするために、請求および請求書データを構造化します。
3. Event Mappers
記録された使用量イベント、しきい値超過、またはビジネスルールイベントを外部システムまたは監査者へエクスポートします。
ベストプラクティス
Info “Tip” - export 構造を送信先システムのフィールド仕様（例: CSV 列名）に合わせます。 - Prefix フィールドを使用して export をバージョン化またはタイムスタンプ化します。 - export を利用するファイルビューアまたはスクリプトで delimiter を検証します。 - 最初に非本番環境で export マッピングを必ずテストします。
概要
Export Mappers は、構造化され、互換性があり、正確な送信データを外部システムへ届けるのに役立ちます。
必ず次の点を行ってください。
- 各 mapper に明確な名前を付ける
- 代表的なファイル構造をアップロードする
- export フィールドをシステムデータに一致させる
設定後、export mappers はファイル生成を自動化し、コンプライアンスを向上させ、シームレスな連携を可能にします。
