La structure de votre flux de données de commande de bout en bout est définie par le schéma d'inventaire relationnel. Le flux de données de classement de bout en bout comprend les entités de niveau supérieur suivantes:
- Entités
Restaurant
: restaurants que vous desservez. - Entités
Service
: durée, emplacement et conditions de votre service. - Entités
Menu
: informations relatives au menu de chaque restaurant.
Le schéma suivant montre comment les entités Service
, Restaurant
et Menu
représentent un seul restaurant:
Consignes générales
Restaurants par fichier: chaque fichier de données doit représenter un restaurant avec ses entités
Service
etMenu
associées. Utilisez des noms de fichiers qui vous aideront à rechercher un fichier pour un restaurant.Format du fichier de données: les fichiers de données doivent être mis en forme dans des fichiers JSON séparés par un retour à la ligne (format ndjson).
Valeurs de date et d'heure: pour les propriétés qui nécessitent une valeur
DateTime
ouTime
, utilisez les formats spécifiés dans les formats de date et d'heure. Par exemple,2017-05-01T06:30:00+05:30
pourDateTime
etT08:08:00+05:30
pourTime
.ID: utilisez une propriété
@id
pour identifier toutes les entités uniques au sein d'un type d'entité. Il ne doit pas dépasser 300 caractères. Un@id
est un identifiant unique de l'entité de ce type, mais les ID peuvent se chevaucher entre les entités. Par exemple, supposons que vous définissiez une entitéService
avec la propriété@id
définie sura16
. Vous ne pouvez pas créer une autre entitéService
avec un@id
défini sura16
. Cependant, vous pouvez utilisera16
comme valeur@id
d'une entitéMenu
.Génération d'ID: vos identifiants doivent rester stables. N'utilisez pas d'UUID et ne modifiez pas les ID de manière aléatoire entre les importations de flux. Cela permet de résoudre plus facilement les problèmes liés aux entités.
Valeurs nulles: n'utilisez pas la valeur
null
à la place des objets. Si un objet est facultatif, vous devez l'omettre de votre flux.
Bibliothèques clientes
Le générateur de code client de la section "Outils" est disponible pour valider votre flux de données de bout en bout des commandes.