Dateiformate für Klassifizierungssätze

Das JSON-Dateiformat folgt den Konventionen für JSON-Zeilen (JSON). Die Datei muss ein JSON-Objekt pro Zeile enthalten, wobei jedes Objekt einen einzelnen Klassifizierungseintrag darstellt.

JSON-Struktur

Jedes JSON-Objekt muss Folgendes enthalten:

• key (erforderlich): Die eindeutige Kennung für den Klassifizierungsdatensatz

• data (für Aktualisierungen erforderlich): Ein Objekt, das Klassifizierungsspaltennamen und deren Werte enthält

• action (optional): Die auszuführende Aktion. Folgende Werte werden unterstützt:

  • update (Standard)
  • delete-field
  • delete-key

• enc (optional): Datenkodierungsspezifikation. Folgende Werte werden unterstützt:

  • utf8 oder UTF8 (Standard)
  • latin1 oder LATIN1

Bei allen JSON-Feldnamen (key, data, action, enc) wird zwischen Groß- und Kleinschreibung unterschieden.

JSON-Beispiele

Einfache Update-Aufzeichnung:

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

Mit angegebener Kodierung aktualisieren:

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

Bestimmte Felder löschen:

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

Löschen eines gesamten Schlüssels:

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

JSON-Validierungsregeln

• Das key ist ein Pflichtfeld und darf weder null noch leer sein.
• Für update Aktionen ist das data erforderlich und darf nicht leer sein.
• Für delete-field Aktionen muss das Feld data die zu löschenden Felder enthalten.
• Für delete-key Aktionen darf das Feld data nicht vorhanden sein.
• Bei den unterstützten Kodierungswerten wird nicht zwischen Groß- und Kleinschreibung unterschieden und es werden standardmäßige Zeichensatznamen einbezogen.

CSV-Dateien (kommagetrennte Werte) verwenden Kommas, um Klassifizierungsdatenfelder zu trennen.

CSV-Struktur

• Kopfzeile: Die erste Zeile muss Spaltenüberschriften enthalten, und die erste Spalte muss die Schlüsselspalte sein. Die nachfolgenden Spalten sollten mit den Namen Ihres Klassifizierungssatz-Schemas übereinstimmen.
• Datenzeilen: Jede nachfolgende Zeile enthält Klassifizierungsdaten
• Trennzeichen: Felder werden durch Kommas getrennt
• Anführungszeichen: Felder mit Kommas, Anführungszeichen oder Zeilenumbrüchen sollten in doppelte Anführungszeichen gesetzt werden

CSV-Beispiele

Grundlegende Klassifizierungsdaten:

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

Löschen eines gesamten Schlüssels:

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

Bestimmte Felder löschen (mit Aktualisierungen gemischt):

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

CSV-Formatierungsregeln

• Felder, die Kommas enthalten, müssen in doppelte Anführungszeichen gesetzt werden.
• Felder, die doppelte Anführungszeichen enthalten, müssen die Anführungszeichen durch Verdoppelung umgehen ("").
• Leere Felder stellen Null-Werte für diese Klassifizierung dar.
• Führende und nachfolgende Leerzeichen um Felder werden automatisch abgeschnitten.
• Sonderzeichen (Tabulatoren, Zeilenumbrüche) in Anführungszeichen werden beibehalten.

Löschvorgänge:

• Verwenden Sie ~deletekey~ in einem beliebigen Feld, um den gesamten Schlüssel und alle zugehörigen Klassifizierungsdaten zu löschen
• Verwenden Sie ~empty~ in bestimmten Feldern, um nur diese Classification-Werte zu löschen (andere Felder bleiben intakt)
• Bei Verwendung von ~empty~ können Sie Löschungen mit Aktualisierungen in derselben Datei kombinieren

TSV- (Tabulatorgetrennte Werte) und TAB-Dateien verwenden Tabulatorzeichen, um Klassifizierungsdatenfelder zu trennen.

TSV- und TAB-Struktur

• Kopfzeile: Die erste Zeile muss Spaltenüberschriften enthalten, und die erste Spalte muss die Schlüsselspalte sein. Die nachfolgenden Spalten sollten mit den Namen Ihres Klassifizierungssatz-Schemas übereinstimmen.
• Datenzeilen: Jede nachfolgende Zeile enthält Klassifizierungsdaten.
• Trennzeichen: Felder werden durch Tabulatorzeichen (\t) getrennt.
• Anführungszeichen: Im Allgemeinen ist keine Anführungszeichen erforderlich, aber einige Implementierungen unterstützen zitierte Felder.

TSV- und TAB-Beispiele

Grundlegende Klassifizierungsdaten:

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

Löschen eines gesamten Schlüssels:

Key    Product Name    Brand    Category    Price
product999    ~deletekey~

Bestimmte Felder löschen (mit Aktualisierungen gemischt):

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

TSV/TAB-Formatierungsregeln

• Felder werden durch einzelne Tabulatorzeichen getrennt.
• Leere Felder (aufeinander folgende Registerkarten) stellen Null-Werte dar.
• Normalerweise ist kein spezielles Angebot erforderlich.
• Leerzeichen am Anfang und Ende bleiben erhalten.
• Zeilenumbrüche innerhalb von Feldern sollten vermieden werden.

Löschvorgänge:

• Verwenden Sie ~deletekey~ in einem beliebigen Feld, um den gesamten Schlüssel und alle zugehörigen Klassifizierungsdaten zu löschen.
• Verwenden Sie ~empty~ in bestimmten Feldern, um nur diese Classification-Werte zu löschen (andere Felder bleiben intakt).
• Bei Verwendung von ~empty~ können Sie Löschungen mit Aktualisierungen in derselben Datei mischen.