Aperçu

La structure de votre flux de données de bout en bout pour les commandes est définie par le schéma d'inventaire relationnel. Le flux de données de bout en bout de commande comprend les entités de niveau supérieur suivantes:

• Entités Restaurant : restaurants que vous desservez.
• Entités Service : horaires, emplacement et conditions de votre service.
• Entités Menu : détails du menu de chaque restaurant.

Le diagramme suivant montre comment les entités Service, Restaurant et Menu représentent un seul restaurant:

Figure 1:Relation globale des entités du flux de données de bout en bout de commande: service, restaurant et menu.

Remarque :Pour savoir comment générer des bibliothèques clientes pour vos flux, consultez la section Générer des bibliothèques clientes de la page "Outils".

Consignes générales

• Restaurants par fichier: chaque fichier de données doit représenter un restaurant avec ses entités Service et Menu associées. Utilisez des noms de fichiers qui peuvent vous aider à rechercher un restaurant dans un fichier.

• Format de 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/heure et d'heure: pour les propriétés qui nécessitent une valeur DateTime ou Time, utilisez les formats spécifiés dans la section Formats de date/heure et d'heure. Par exemple, 2017-05-01T06:30:00+05:30 pour DateTime et T08:08:00+05:30 pour Time.

• ID: utilisez une propriété @id pour identifier toutes les entités uniques d'un type d'entité. Sa longueur maximale est de 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 sur a16. Vous ne pouvez pas créer une autre entité Service avec une valeur @id de a16. Toutefois, vous pouvez utiliser a16 comme valeur @id d'une entité Menu.

• Génération d'ID: maintenez vos ID stables. N'utilisez pas d'UUID ni ne modifiez/randomisez les ID entre les importations de flux. Cela facilite l'assistance pour les problèmes liés aux entités.

• Valeurs nulles: n'utilisez pas la valeur null à la place d'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" vous permet de valider votre flux de données de bout en bout pour les commandes.