Übersicht JSON Dateien

Das ioCanto Schema besteht aus verschiedenen Datentypen. Es wird empfohlen die JSON-Files nach Datentypen aufzubereiten und dementsprechend zu benennen.

Wenn Daten importiert und die Files sequenziell, also zu verschiedenen Zeitpunkten geliefert werden, so muss die nachfolgende Reihenfolge der Datentypen eingehalten werden:

Position	Datentyp (Basis für Filename)	Pflicht
1	product_abstract	Ja
2	product_concrete	Ja
3	product_price	Ja
4	order_deadline	Ja
5	delivery_calendar	Ja
6	handling_calendar	Ja
7	customer_invitation	Ja
8	merchant_relationship	Ja
9	product_restrictions	Nein
10	product_promotion	Nein
11	product_media	Nein
12	on_demand_storage	Nein
13	shopping_list	Nein
14	sales_order_amendment	Nein
15	sales_order (Hinweis: Nur für Export!)	Nein

Datenfiles dürfen auch gleichzeitig übertragen werden. In diesem Fall wird vom System geprüft, welche Files zur Abholung bereit liegen. Danach werden sie automatisch in der richtigen Reihenfolge verarbeitet. Dies gilt sowohl für den Initialimport, wie auch spätere (Delta-)Imports.

Es wird empfohlen, pro Datentyp ein eigenständiges Datenfile zu erstellen. Es ist jedoch praktikabel, die Datentypen customer_invitation und merchant_relationship in einem Datenfile zusammenzufassen.

Namenskonvention

Es gilt:

Der Filename muss die Endung .json haben.
Der Filename soll idealerweise mit dem spezifischen Datentyp beginnen (Gross- oder Kleinschreibung spielt keine Rolle)
Der Filename darf keine Leerzeichen enthalten.
Der Filename darf nur aus lateinischen Buchstaben (a-z A-Z), Zahlen (0-9), Bindestrichen (-) und Unterstrichen (_) bestehen.
Es wird empfohlen, nebst dem spezifischen Filenamen zumindest eine weitere Klassifizierung mitzugeben, wie z.B. das Aufbereitungsdatum ggf. mit Uhrzeit und - falls ein File kundenspezifisch sein sollte - die Kundenummer oder den Kundennamen. Dabei ist der Datentyp mit der Zusatzklassifizierung durch einen Bindestrich zu trennen.

Beispiel eines korrekten und präferierten Filenamens:

product_abstract-15072024-170103.json Enthält nebst dem Filenamen das Datum und Uhrzeit der Aufbereitung.

Beispiele eines unzulässigen Filenamens:

`abstract!15072024$.json`	Enthält Leerzeichen und nicht zugelassene Sonderzeichen.
`27012023.xls`	Falsche Endung, `.xls` statt `.json`.

Beispiele eines suboptimalen Filenamens:

`27012023.json`	Enthält nicht den spezifischen Datentypen, man weiss nicht, was das File beinhaltet.
`product.json`	Enthält zu wenig Informationen zum spezifischen Datentypen, könnte sich um das `product_abstract`, das `product_concrete`, den `product_price`, oder eine Kombination aus allem handeln. Ausserdem fehlt das empfohlene Aufbereitungsdatum inkl. Uhrzeit.
`import.json`	Enthält nicht den spezifischen Datentypen, man weiss nicht, was das File beinhaltet. Ausserdem fehlt das empfohlene Aufbereitungsdatum inkl. Uhrzeit.