Panoramica

La struttura del feed di dati end-to-end di ordini è definita dallo schema di inventario relazionale. Il feed di dati end-to-end relativo agli ordini è costituito dalle seguenti entità di primo livello:

• Entità Restaurant: i ristoranti che servi.
• Entità Service: tempi, luogo e condizioni del servizio.
• Entità Menu: dettagli del menu di ogni ristorante.

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

Figura 1: relazione complessiva delle entità del feed di dati end-to-end di Ordina: Servizio, Ristorante e Menu.

Nota: per scoprire come generare librerie client per i tuoi feed, consulta la sezione Genera librerie client della pagina Strumenti.

Linee guida generali

• Ristoranti per file: ogni file di dati deve rappresentare un ristorante con le relative entità Service e Menu. Utilizza nomi file che possono aiutarti a cercare un ristorante in un file.

• Formato file di dati: i file di dati devono essere formattati in file JSON separati da una nuova riga (formato ndjson).

• Valori DateTime e Time: per le proprietà che richiedono un valore DateTime o Time, utilizza i formati specificati in 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 le entità. Ad esempio, supponiamo di definire un'entità Service con la proprietà @id impostata su a16. Non puoi creare un'altra entità Service con un @id di a16. Tuttavia, puoi utilizzare a16 come valore @id di un'entità Menu.

• Generare ID: mantieni gli ID stabili, non utilizzare UUID o cambiare/generare ID casuali tra un caricamento del feed e l'altro. In questo modo è più facile ricevere assistenza 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 codice client nella sezione Strumenti è disponibile per convalidare il feed di dati end-to-end di ordini.