分類設定檔案格式

JSON檔案格式遵循JSON行(JSONL)的慣例。 檔案的每行必須包含一個JSON物件，其中每個物件代表單一分類記錄。

JSON結構

每個JSON物件都必須包含：

• key （必要）：分類記錄的唯一識別碼

• data （更新所需）：包含分類欄名稱及其值的物件

• action （選用）：要執行的動作。 支援的值包括：

  • update （預設）
  • delete-field
  • delete-key

• enc （選用）：資料編碼規格。 支援的值包括：

  • utf8或UTF8 （預設）
  • latin1 或 LATIN1

所有JSON欄位名稱(key、data、action、enc)都區分大小寫，且必須為小寫。

JSON範例

基本更新記錄：

{"key": "product123", "data": {"Product Name": "Basketball Shoes", "Brand": "Brand A", "Category": "Sports"}}

使用指定的編碼更新：

{"key": "product456", "enc": "utf8", "data": {"Product Name": "Running Shoes", "Brand": "Brand B"}}

刪除特定欄位：

{"key": "product789", "action": "delete-field", "data": {"Brand": null, "Category": null}}

刪除整個金鑰：

{"key": "product999", "action": "delete-key"}

JSON驗證規則

• key欄位為必填，不能為Null或空白。
• 對於update動作，data欄位為必要項，不得為空白。
• 針對delete-field動作，data欄位必須包含要刪除的欄位。
• 對於delete-key動作，data欄位不得存在。
• 支援的編碼值不區分大小寫，並包含標準字元集名稱。

CSV （逗號分隔值）檔案使用逗號來分隔分類資料欄位。

CSV結構

• 標題列：第一列必須包含欄標題，第一欄必須是索引鍵欄。 後續欄應該符合分類集結構描述中的名稱
• 資料列：每個後續列都包含分類資料
• 分隔符號：欄位以逗號分隔
• 引號：包含逗號、引號或新行的欄位應該包含在雙引號中

CSV範例

基本分類資料：

Key,Product Name,Brand,Category,Price
product123,"Basketball Shoes",Brand A,Sports,89.99
product456,"Running Shoes",Brand B,Sports,79.99
product789,"Winter Jacket",Brand C,Clothing,149.99

刪除整個金鑰：

Key,Product Name,Brand,Category,Price
product999,~deletekey~,,,

刪除特定欄位（混合更新內容）：

Key,Product Name,Brand,Category,Price
product123,"Updated Product Name",Brand A,Sports,89.99
product456,,~empty~,~empty~,79.99

CSV格式規則

• 包含逗號的欄位必須括在雙引號中。
• 包含雙引號的欄位必須將引號加倍("")，才能逸出引號。
• 空白欄位代表該分類的null值。
• 欄位周圍的前置和尾端空格會自動裁剪。
• 系統會保留引號欄位內的特殊字元（定位字元、換行字元）。

刪除作業：

• 在任何欄位中使用~deletekey~來刪除整個索引鍵及其所有分類資料
• 在特定欄位中使用~empty~以僅刪除那些分類值（保留其他欄位不變）
• 使用~empty~時，您可以在相同檔案中混合刪除與更新

TSV （定位字元分隔值）和TAB檔案使用定位字元來分隔分類資料欄位。

TSV和標籤結構

• 標題列：第一列必須包含欄標題，第一欄必須是索引鍵欄。 後續的欄應該符合分類設定結構描述中的名稱。
• 資料列：每個後續列都包含分類資料。
• 分隔符號：欄位是以定位字元(\t)分隔。
• 引號：一般不需要引號，但有些實作支援引號欄位。

TSV和TAB範例

基本分類資料：

Key    Product Name    Brand    Category    Price
product123    Basketball Shoes    Brand A    Sports    89.99
product456    Running Shoes    Brand B    Sports    79.99
product789    Winter Jacket    Brand C    Clothing    149.99

刪除整個金鑰：

Key    Product Name    Brand    Category    Price
product999    ~deletekey~

刪除特定欄位（混合更新內容）：

Key    Product Name    Brand    Category    Price
product123    Updated Product Name    Brand A    Sports    89.99
product456        ~empty~    ~empty~    79.99

TSV/TAB格式規則

• 欄位以單一定位字元分隔。
• 空白欄位（連續索引標籤）代表Null值。
• 通常不需要特別報價。
• 會保留前置和尾端空格。
• 欄位中應避免使用換行字元。

刪除作業：

• 在任何欄位中使用~deletekey~來刪除整個索引鍵及其所有分類資料。
• 在特定欄位中使用~empty~以僅刪除那些分類值（保留其他欄位不變）。
• 使用~empty~時，您可以在相同的檔案中混合刪除與更新。