La struttura del feed di dati end-to-end di ordinazione è definita dallo schema dell'inventario relazionale. Il feed di dati end-to-end di ordinazione è costituito dalle seguenti entità di primo livello:
Restaurant
entità: i ristoranti che offri.- Entità
Service
: tempi, località e condizioni del servizio. Menu
entità: i dettagli del menu di ogni ristorante.
Il seguente diagramma mostra come le entità Service
, Restaurant
e Menu
rappresentano un singolo ristorante:
Linee guida generali
Ristoranti per file: ogni file di dati deve rappresentare un ristorante con le entità
Service
eMenu
correlate. Usa nomi file che possono aiutarti a cercare un file relativo a un ristorante.Formato file di dati: i file di dati devono essere formattati in file JSON separati da nuova riga (formato ndjson).
Valori DateTime e Time: per le proprietà che richiedono un valore
DateTime
oTime
, utilizza i formati specificati nei formati DateTime e Time. Ad esempio,2017-05-01T06:30:00+05:30
perDateTime
eT08:08:00+05:30
perTime
.ID: utilizza una proprietà
@id
per identificare tutte le entità univoche all'interno di un tipo di entità. La lunghezza massima è di 300 caratteri. Un@id
è un identificatore univoco dell'entità di quel tipo, ma gli ID possono sovrapporsi tra più entità. Ad esempio, supponiamo che tu definisca un'entitàService
con la proprietà@id
impostata sua16
. Non puoi creare un'altra entitàService
con@id
dia16
. Tuttavia, puoi utilizzarea16
come valore@id
di un'entitàMenu
.Generazione ID: mantieni stabili i tuoi ID. Non utilizzare UUID o altrimenti modifica/causi gli ID in modo casuale tra un caricamento del feed e l'altro. Ciò consente un'assistenza più semplice per i problemi relativi alle entità.
Valori null: non utilizzare il valore
null
al posto degli oggetti. Se un oggetto è facoltativo, devi ometterlo dal feed.
Librerie client
Il generatore di codici cliente nella sezione Strumenti è disponibile per convalidare il feed di dati end-to-end di ordine.