CSVから金融JSONへの変換ツール
貼り付けたCSV表をJSONレコードに変換します。引用テキスト、元の見出し、安全に数値化できない値はそのまま保持します。
仕組み
ヘッダー行とデータ行を含むテーブルを貼り付けます。パーサーはサポートされている区切り文字をチェックし、引用符で囲まれた区切り文字、エスケープされた引用符、および引用符で囲まれたセル内の改行を処理します。
コンバーターは、日付、シンボル、タイプ、数量、価格、金額の正確に正規化された別名のみをマップします。他のヘッダーは変更されません。 1 つのフィールドにマップされる繰り返しエイリアスは、元のヘッダーの下に留まり、警告が生成されます。
日付、記号、種類、その他のテキストは文字列のままです。数量、価格、および金額の値は、その列に入力されたすべての値が有限で安全な単純な 10 進数である場合にのみ数値になります。それ以外の場合、列はテキストのままになり、コンバーターがその理由を説明します。
結果を使用する前に、列の概要、警告、および JSON を確認してください。このツールは、取引の調整、ブローカーの輸出の検証、通貨の換算、投資と税金のルールの解釈を行いません。
手順
- ヘッダーとデータ行を含む CSV テーブルを貼り付けます
- 列マッピングと警告を確認します
- JSON レコードを確認してコピーします
動作する例
表示された入力には、先頭にゼロがあるシンボルと、カンマ、二重化した引用符、改行を含むメモ列があります。ユニットテストでも同じ入力を解析します。
結果では symbol を 00123 のまま保持し、quantity を 2、price を 12.5 に変換します。メモは英語の文言、句読点、改行を含めて表示どおり保持されます。セルの内容は翻訳されません。
このコンバーターを使用する場合
別のプログラムが貼り付けられた CSV テーブルからの JSON レコードを必要とする場合、このコンバーターを使用します。これは、トランザクション分析ではなく、基本的なフォーマット変換を目的としています。
出力を使用する前に、列の概要と行数をソーステーブルと比較し、宛先システムのスキーマを確認してください。
よくある間違い
マップされたフィールド名をソース データの検証として扱わないでください。たとえば、価格にマップされた値は、一致するソース列からコピーされます。市場価格との照合は行われません。
行数、マップされていないヘッダー、警告、単位、受信側システムの必要なスキーマを確認するまで、JSON をインポートしないでください。通貨記号とロケールの小数点区切り文字は、解釈されずにテキストとして保持されます。
解析ルールと前提条件
CSV 引用ルールを使用してレコードを解析する
サポートされている区切り文字をカンマ、セミコロン、タブ、パイプから選択してください
正確な正規化されたヘッダー エイリアスをマップする
空白以外のすべての値が安全な単純な小数である場合にのみ、数量、価格、または金額の列を変換します。
レコードを JSON としてシリアル化する
テキストフィールドと不明な列はテキストのまま保持されます。認識された数値列に、単純な小数形式として安全でない値、たとえば不正な文字列、通貨記号、精度が安全でない数値が含まれる場合、その列の空でない値はすべて文字列のままになり、警告が表示されます。空のセルは空文字列のままで、数値変換に影響しません。通貨や日付の地域形式は推測しません。
制限と前提条件
パーサーは最大 1,000,000 文字と 10,000 レコードを受け入れます。引用符付きフィールドを含む表で、カンマ、セミコロン、タブ、パイプの区切り文字をサポートします。すべての CSV 形式や証券会社の出力形式に対応するわけではありません。ヘッダー行が 1 行あり、正規化後のヘッダーが重複せず、各レコードのフィールド数が同じである必要があります。完全一致するヘッダー別名だけをマップします。日付とテキストは変更せず、単純な小数値だけを数値に変換します。不確かな値はテキストのままです。通貨の推定、市場データの検証、取引の照合、税務上の扱いの判定は行いません。貼り付けた CSV はこの端末のブラウザー内に保存されます。
重要な用語
- デリミタ
- 引用セルの外でフィールドを区切るカンマ、セミコロン、タブ、縦棒です。
- マップされたヘッダー
- 大文字小文字、空白、句読点を正規化した後、既知のエイリアスに完全一致する見出しです。
- 安全な数値
- 有限の小数値として安全な精度で扱える、空欄ではない値です。
関連する質問
の追加 CSV パーサーは形式変換タスクを解決します。ソース テキストを利用可能な状態に保ちながら、行と列を JSON レコードに変換します。取引を調整したり、投資パフォーマンスを計算したりするものではありません。
スクリプトまたはデータのレビューに JSON が必要な場合は、このコンバーターを使用します。出力をインポートする前に、受信側システムのフィールド名と値のタイプを確認してください。
よくある質問
区切り文字検出はどのように機能しますか?
コンバーターは、引用符で囲まれたフィールドを尊重しながら、カンマ、セミコロン、タブ、およびパイプ区切り文字を評価します。引用符で囲まれたセル内の区切り文字はセルを分割しません。複数のセパレーターが同等に妥当なテーブルを生成する場合、コンバーターは黙って 1 つを選択するのではなく、あいまいさを報告します。
引用符と改行はどのように処理されますか?
引用符で囲まれたフィールドには、区切り文字、改行、二重化してエスケープした引用符を含められます。各レコードのフィールド数は同じである必要があります。閉じていない引用符、位置の誤った引用符、またはフィールド数の異なる行がある場合、行番号付きのエラーが表示されます。
どのヘッダーが標準フィールドにマップされますか?
見出しの完全一致エイリアスは英語で判定します。Date、Trade Date、Settlement Date、DateTime、Time は date に、Symbol、Ticker、Instrument、Security は symbol に、Type、Action、Transaction Type、Side は type に、Quantity、Qty、Shares、Units は quantity に、Price、Unit Price、Share Price、Rate は price に、Amount、Total、Value、Proceeds、Net Amount は amount に対応します。それ以外の見出しは元の名前で保持します。完全一致のみのため、Corporate Action は price になりません。
すべてのブローカーはエクスポートを正しく解析しますか?
いいえ。これは、引用符で囲まれたフィールドを含むカンマ、セミコロン、タブ、またはパイプで区切られたテーブル用の一般的なパーサーです。最大 1,000,000 文字と 10,000 レコードを受け入れます。すべてのブローカーのレイアウトを認識したり、ブローカーのスキーマを検証したり、トランザクションを調整したり、アカウント ルールを適用したりするわけではありません。 JSON を他の場所で使用する前に、ソースと出力を確認してください。
貼り付けた CSV はどこに保存されますか?
CSV 解析はブラウザで実行され、貼り付けられたテキストはこのデバイスのブラウザ ストレージに保存されます。このページのパーサーは、CSV コンテンツをアプリケーション サーバーに送信しません。完了したら、共有デバイスのフィールドをクリアします。
関連ツール
このツールはテーブル形式を変換します。ポートフォリオ パフォーマンス計算ツールまたは税ロット ツールは別の質問に答えますが、このパーサーでは計算できないデータが必要になる場合があります。