Des outils sont à votre disposition sur ce site Web et dans le Centre d'actions. Cette page explique comment valider le schéma de fichier de données, importer des fichiers de données et effectuer des tests.
Valider vos flux
L'outil de validation du flux de données vérifie la mise en forme, la structure et les propriétés de votre fichier de données. Étant donné que l'outil d'ingestion du flux de données nécessite une mise en forme spécifique (une entité par ligne, par exemple), l'outil de validation garantit que vous pouvez importer votre flux de données.
Pour valider un flux de données en mode prévisualisation, procédez comme suit:
- Accédez à l'outil de validation du flux de données.
- Sélectionnez Validate Single Entity (Valider une seule entité) si votre fichier JSON ne décrit qu'une seule entité. Si votre fichier JSON contient plusieurs entités, sélectionnez Validate Feed (Valider le flux).
- Collez le fichier JSON du flux de données dans la zone de texte.
- Indiquez si vous souhaitez valider une seule entité ou l'intégralité de votre flux.
- Cliquez sur Valider.
Les avertissements ou erreurs présents dans le fichier du flux de données s'affichent au-dessus du champ de texte. Si vous rencontrez des erreurs, assurez-vous de vérifier la documentation de référence pour identifier les champs obligatoires manquants et les valeurs de propriété non valides.
Importez et testez votre flux de données dans les tests rapides
Une fois le fichier de flux de données validé, utilisez l'outil de test rapide pour importer et tester le flux. Les tests rapides permettent de développer et de tester rapidement et de façon itérative des fichiers de flux individuels.
Pour importer et tester un flux de données à l'aide de la fonctionnalité Tests rapides, procédez comme suit:
- Dans le Centre Actions, accédez à Tableaux de bord > Tests rapides.
- Utilisez la fonctionnalité Importer un fichier pour importer le fichier de flux de données à tester. Le fichier doit être au format NDJSON.
Une fois l'importation terminée, cliquez sur Envoyer.
Le système traite à présent le fichier du flux de données. Ce processus peut prendre quelques minutes. Le tableau s'actualise automatiquement. Il n'est donc pas nécessaire d'actualiser la page.
Une fois le flux traité, vous pouvez consulter l'état et les résultats du traitement, tels que les erreurs, les avertissements et les entités obsolètes. Pour supprimer les entités obsolètes, assurez-vous d'utiliser la date de dernière modification.
Une fois que votre flux a été traité avec l'état Opération réussie, cliquez sur Test rapide.
Remplissez une API de traitement de test et indiquez si vous souhaitez utiliser des paiements réels ou non pendant les tests. Notez que vous pouvez utiliser les tests rapides sans URL de traitement, mais vous ne pourrez pas régler votre panier ni passer de commandes.
Cliquez sur Quick Test (Test rapide). Un nouvel onglet s'ouvre. Assurez-vous donc d'autoriser les pop-ups pour éviter d'empêcher l'ouverture du nouvel onglet.
Cliquez sur le restaurant de votre choix pour consulter son menu et suivre le processus de commande. Vérifiez que votre inventaire est exact.
Si vous souhaitez importer un nouveau fichier et le tester, vous pouvez importer le fichier de flux. Il n'est pas nécessaire de relancer le test. Vous pouvez simplement actualiser le nouvel onglet (UI de recherche de restaurants) chargé précédemment.
Tester les flux de bac à sable
Les tests de bac à sable permettent de tester de bout en bout l'inventaire des flux de bac à sable à l'aide de l'interface du bac à sable. Les tests en bac à sable permettent l'ingestion de flux complet, les mises à jour en temps réel, les tests de traitement et les mises à jour asynchrones des commandes. À la différence des tests rapides, les tests en bac à sable vous permettent d'exécuter des scénarios complets dans plusieurs restaurants.
- Configurez les URL de repère et de fichier de données pour l'environnement de bac à sable dans Configuration > Flux.
- Importez les fichiers de flux dans les emplacements spécifiés, puis vérifiez que le flux est ingéré en affichant l'historique des flux.
- Une fois les flux de bac à sable ingérés, vous pouvez afficher les restaurants fournis dans les flux de bac à sable de l'interface de bac à sable.
- Pour accéder à l'interface de bac à sable, sélectionnez Tableaux de bord > Rapport sur l'état des restaurants.
- Sélectionnez l'environnement de bac à sable.
- Cliquez sur le lien "cliquez ici" en haut de la page.
- Recherchez le restaurant souhaité.
Ressources supplémentaires
En plus des étapes décrites ci-dessus, vous pouvez utiliser les outils de débogage pour tester votre flux d'inventaire et résoudre les problèmes associés.
Pour obtenir des conseils supplémentaires, reportez-vous aux outils suivants:
- La page Statistiques sur l'ingestion de flux fournit des détails sur vos ingestions de flux, y compris le nombre d'entités comportant des erreurs. Reportez-vous à ces statistiques pour vous assurer que la plupart de vos entités (si ce n'est pas toutes) sont validées.
- Dans les statistiques d'ingestion, vous pouvez également sélectionner des détails de l'entité spécifiques pour résoudre les problèmes liés aux entités qui échouent.
- Utilisez l'outil Inventory Viewer pour diagnostiquer les problèmes propres aux restaurants, tels que les restaurants qui n'apparaissent pas après l'importation.