データテンプレートを使用して外部データを変換する非公開プレビュー
テンプレートで、外部のデータファイルを Stripe オブジェクトにマッピングするためのルールを定義します。
データテンプレートを使用して、外部データを送信先レコードにアップロードし、Stripe プロダクトに合うように変換できます。データテンプレートとは、外部データを送信先レコードに変換するために使用可能な一連のデータ処理の手順を示したものです。
データテンプレートの設定には次のものがあります。
- ファイル内のヘッダーがある行を指定する
- アップロードしたフィールドの変換先のデータ型
- 特定の行をエラーにする条件
- アップロードしたファイルの列を送信先レコードのフィールドにマッピングする方法
データテンプレートを作成する
データテンプレートを作成するには、次の手順を実行します。
- Stripe ダッシュボード > データ管理ページに移動します。
- データテンプレートを選択します。
- データテンプレートを追加をクリックし、詳細ドロワーのステップに従ってデータテンプレートを作成します。
- データテンプレートの詳細ステップで、テンプレートの名前を入力し、サンプルデータが入った CSV ファイルをアップロードします。
注
サンプルファイルのヘッダー名と行は、データテンプレートを使用して変換する予定の CSV ファイルと同じである必要があります。
CSV データを設定する
Stripe が Stripe データ型を使用した外部データを処理する方法を設定します。
- ヘッダーの場所フィールドで、ファイルのヘッダーの行番号を選択します。
- 次に、データ型セクションで、各列のデータ型を確認し、必要に応じて選択します。
- CSV の設定をクリックして、ファイルを解析する方法を確認し、必要に応じて調整します。
送信先レコードタイプを選択
Stripe が Stripe データ型を使用した外部データを処理する方法を設定します。事前に定義された送信先レコードタイプを使用して、ユーザーによってアップロードされたデータを Stripe にマッピングすることができます。適切なレコードタイプを選択して、アップロードされたサンプルファイルの列を確認し、選択した送信先レコードタイプを生成します。
送信先レコードタイプを選択ステップで、送信先レコードタイプを選択し、データを Stripe にアップロードしてマッピングする方法を選択します。
クリーンアップして確認
クリーンアップして確認ステップで、条件を使用してレコードを無視または確認できます。条件は次の 2 種類があります。
- クリーンアップ条件: 条件に一致するレコードを無視するには、クリーンアップ条件を追加します。
- 検証チェック: 検証チェックを追加して、レコードのエラーや問題を特定し、そのようなレコードから Stripe オブジェクトが作成されないようにします。
列をマッピングする
ファイル内の列を Stripe オブジェクト属性に関連付けます。
マッピングオプションには次のものがあります。
- ファイルの列を属性に直接マッピングする
- テキストボックスに文字列値を手動で入力し、ハードコーディングした値を特定の Stripe オブジェクト属性に割り当てる
- データを変換するには、SUM、CONCAT、FIND などのカスタム式を使用します。
データマッピングを追加するには、次の手順を実行します。