跳至內容
Coverton 部落格
在這篇文章中
表格和數據

將 JSONL 轉換為 JSON:檢查結構與格式

將 JSONL 轉換,將每個非直線的值整合到一個序列,每個線必須包含一個完整的 JSON 值,因此它的輸入結構與傳統 JSON 物件不同,在多個線上格式化。

開啟工具如何使用這個工具 ↓
將 JSONL 轉換為 JSON
此圖展示工具的操作流程,並非上傳檔案的處理結果。

如何使用這個工具

  1. 選擇 JSONL, NDJSON, TXT 格式的檔案。每批最大檔案數:1。
  2. 查看JSON 縮排,然後開始處理。
  3. 下載 JSON 結果並檢查其內容和品質。

選擇正確的設定

選擇二空間、四空間或零輸出,零建立小型JSON,但結果仍然是一個序列,而不是一個JSONL檔案,每行儲存一個記錄。

支援的輸入
  • JSONL, NDJSON, TXT
輸出
  • JSON
可用設定
  • JSON 縮排

處理前的準備

先定義一列的意義與各欄的規則

轉換資料前,先釐清一列代表一筆訂單、一個商品,還是同一商品的一項選項。紀錄單位不同,合併、移除重複的依據也不同。結果用於另一系統匯入,或給人閱讀的報表,也會影響欄名與順序。格式變化不會補出缺少值或業務規則,應拿真正的匯入範本核對必填項。不能因兩列名稱相同就認定重複,也不能只用列數衡量內容完整。先決定應保留的紀錄與要展示的欄位,再選對應處理。

讀取表格時先選對標題列與工作表。說明列被當成資料時,整個檔案的欄名、紀錄數量都可能錯位。同義欄的拼法與前後空格不同,可能產生額外欄,應在原件統一。CSV還需確認編碼、分隔符及引號內的換行。文字亂碼時先檢查解碼方式,不要直接覆寫成猜測值。公式欄也要了解工具讀的是檔案中已保存的計算結果,或有其他實際支援;不要假設匯入一定會重新計算來源活頁簿。

商品代碼與長識別碼要與計算數字區分。需要留下開頭零或最後幾位時,先看來源字元是否還在。已遺失的零、截短的識別碼,不能靠轉換推測恢復。日期的月日順序、小數點及千位分組也需要原始規則。規則混用的資料應先分開,不要對整欄套一種解釋後就認為全部正確。無法解讀的紀錄留在報告中逐一查核原意;看起來像數字的值,未必能當金額相加,識別碼欄也未必適合當數值排序。

比較或連接時,選擇能區分紀錄的實際鍵,確認舊新檔或主表、參照表的順序。忽略空格與大小寫可能把不同代碼合在一起,應依代碼規則決定。移除重複前先比較同鍵的金額與狀態,再選保留首筆或末筆。參照表同鍵重複可能阻止連接;多值展開會複製其他欄,使同一金額出現在多個結果列。彙總前要了解紀錄為何增加,不能把每個新增列都當成新交易。保留原始列位置的報告,可協助回查。

搭配原始列與報告解釋結果變化

處理後應能說明列數增減的原因。合併核對各檔的紀錄數與來源,拆分檢查空值形成的群組,對應欄位則檢查值是否去了正確位置。JSON巢狀結構與平面表能表達的內容不同,應挑文字、空值和陣列的實際紀錄查看。欄名一樣、畫面相近,不足以證明類型與結構沒有變化。目標表若無法表示來源層級,必須按用途判斷如何使用結果,不能把產生成功當作結構完全保留的證明。

驗證或移除重複報告提供來源列號時,要回該位置看具體值。沒有錯誤只針對已給的規則,不代表所有業務條件成立。群組總和、平均可選一整組與原件核算,也要確認計數選項數的是什麼。計算欄有幣別符號或文字時,了解含義後再整理。缺少值報告若不自動補值,就作為檢查依據,不要期待結果已補齊。記錄所用規則與人工確認範圍,可避免下次把有限檢查報告誤當成通用保證。

列印用表、尺寸圖及代碼標籤,要同時核對顯示值與實物尺寸。不可假設輸出會換算單位或發給新商品代碼。QR碼、條碼產生後,逐項對應名稱和編碼,依使用尺寸列印掃描。處理編碼或Base64,也要區分字元編碼與位元組表示:可還原的編碼不是加密,輸出字串不等於壓縮內容。XML與JSON等不同資料模型的格式,需要檢查欄位及結構表示,不能只看副檔名有沒有變;後續系統需要什麼應先確認。

下載後,在真正使用的軟體重新匯入。看CSV識別碼是否被改成數值、日期,以及公式結果是否符合來源程式保存的值。亂碼已寫進原件、長數字已截短或欄根本不存在時,重複執行不會補回事實。失敗時先讀錯誤所指的欄與規則,區分來源問題與設定問題。把未解決列及已確認值一起留下,方便下次追蹤修改範圍。匯入範本的順序、必填和類型,還應依接收系統核對,不能只用匯出檔可開啟作為驗收標準。

輸入和輸出範例

兩個有效 JSON 線 → 兩元素 JSON 線

範例描述了工作流程。結果取決於來源檔案和設定。

儲存前檢查結果

將輸入的無線計算與結果的序列長度進行比較. 示例第一個、中間和最後一個專案,以審查值和其順序。

結果與預期不符時

一個線上的多個 JSON 值或多個 JSON 值的物件不受支援. 在重新處理之前,修復一個失敗的線,以包含一個完整的 JSON 值。

使用限制

  • JSON 不允許註解或尾隨逗號。解析受 JavaScript 的數值精度限制。
  • 檢查字元編碼、分隔符號和列名。 JavaScript 中大數字可能會失去精確度; CSV 不保留所有類型和巢狀結構。
  • 每個非空白行必須包含一個完整的 JSON 值。錯誤的行會停止轉換。 JSON 到 JSONL 需要一個陣列。

選擇下一項處理

將 JSON 轉換為 JSONL

將 JSON 序列轉換為 JSONL 時,接收系統預計每行值為 1 個。

讓序列路徑為頂級序列空白 對於一個物件內部,輸入一個定位路徑,如 data.items 並確認該位置的值是序列。

開啟工具

將 CSV 轉換為 JSON

CSV 第一列提供每筆資料所對應 JSON 物件的鍵名。儲存格值會以字串儲存;將結果交給需要數字或布林值的系統前,請先檢查資料型別。

選擇來源編碼並使用自動解析度檢測或選擇實際解析度 解決空或重複標題,並確保每個行都有與標題相同的列數。

開啟工具
Coverton將 JSONL 轉換為 JSON
開啟工具

本指南介紹可在瀏覽器中使用的公開工具。請保留原始檔案的副本,並在分享前檢查處理結果。

此翻譯是在軟體協助下完成的。您也可以閱讀英文版本。 閱讀英文