Panoramica

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:

Il seguente diagramma mostra come le entità Service, Restaurant e Menu rappresentano un singolo ristorante:

Diagramma della relazione di classe per il menu del servizio del ristorante
Figura 1: relazione complessiva delle entità del feed di dati end-to-end di ordinazione: Servizio, Ristorante e Menu.

Linee guida generali

  • Ristoranti per file: ogni file di dati deve rappresentare un ristorante con le entità Service e Menu 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 o Time, utilizza i formati specificati nei formati DateTime e Time. Ad esempio, 2017-05-01T06:30:00+05:30 per DateTime e T08:08:00+05:30 per Time.

  • 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 su a16. Non puoi creare un'altra entità Service con @id di a16. Tuttavia, puoi utilizzare a16 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.