Obtenir de l’aide : Corriger l’échec de l’importation en bloc du menu
Dernière mise à jour : 31 mars 2026, 13 h 35
Résoudre les messages d’erreurs courants liés à l’importation en bloc de menus.
Aperçu du message d’erreur pour l’importation en bloc du menu
Il existe deux types d’échecs qui peuvent se produire lors de l’importation de données avec l’outil d’importation en bloc : les échecs de validation des données et les échecs des opérations d’importation.
Lorsqu’elle tente d’importer un fichier CSV, la plateforme Toast valide d’abord les données du fichier CSV pour s’assurer qu’elles sont conformes aux valeurs acceptables décrites à la section Remplir une feuille de calcul d’importation en bloc de menus dans l’article Utiliser l’outil d’importation en bloc de menus. Si l’une des lignes échoue à cette étape de validation, la plateforme Toast affiche les erreurs détectées dans la page du fichier d’importation pour vous informer de l’échec de la validation des données :
Si un fichier d’importation passe l’étape de validation des données, la plateforme Toast commence à importer les lignes du fichier. En cas de problème lors de l’importation d’une ligne, la plateforme Toast ignore cette ligne et continue avec le reste du fichier d’importation. Par exemple, une ligne qui attache un groupe de modificateurs à un article de menu doit préciser l’Identifiant unique global (GUID) Toast de cet article. Si l ' Identifiant unique global (GUID) fourni ne correspond pas à un Identifiant unique global (GUID) existant pour les articles de menu dans la plateforme Toast, l ' opération de fixation échoue et la plateforme Toast passe à la ligne suivante. Ce type d’échec est un échec d’opération d’importation.
Après avoir terminé le traitement d’un fichier d’importation présentant des échecs d’opérations d’importation, la plateforme Toast affiche la page d’importation incomplète. Cette page contient un résumé du nombre d’opérations réussies et échouées, ainsi qu’un ID d’importation pour la tentative d’importation afin de vous aider à la distinguer des autres tentatives d’importation dans l’onglet Historique d’importation.
Les erreurs trouvées dans le fichier et la page d’importation incomplète comportent toutes deux un lien de résumé des erreurs de téléchargement. Vous utilisez ce lien pour télécharger un fichier CSV contenant des informations sur les erreurs dans le fichier d’importation. Le fichier CSV contient une ligne pour chaque erreur rencontrée lors de la tentative d’importation.
Le nom du fichier sommaire des erreurs pour une tentative d’importation qui a échoué aux opérations d’importation est error_summary_<importId>.csv. La partie <importId> du nom du fichier vous permet de faire correspondre le fichier CSV du sommaire des erreurs avec la tentative d’importation incomplète dans l’onglet Importation historique. Le nom du fichier sommaire des erreurs pour une tentative d’importation comportant des erreurs de validation de données est error_summary.csv. Ce nom de fichier ne contient pas d’<importId> car des erreurs de validation des données ont entraîné l’échec de l’importation avant qu’une partie de celle-ci ne soit importée. Par conséquent, aucun ID d’importation n’a été généré.
Réparer et réimporter un fichier CSV d’importation en bloc
La procédure suivante décrit comment corriger les erreurs de validation des données et d’opération d’importation, puis réessayer l’importation. Ces instructions commencent à partir du moment où vous avez soumis un fichier CSV d’importation en bloc et que vous avez été avisé qu’il y avait des échecs.
- Dans la page Erreurs trouvées dans le fichier d’importation incomplet ou dans la page Importation incomplète, sélectionnez Télécharger le sommaire des erreurs pour obtenir un rapport d’erreurs pour les échecs à corriger.
- Indiquez où vous souhaitez enregistrer le sommaire des erreurs et sélectionnez Enregistrer.
- Ouvrez le fichier CSV sommaire des erreurs dans un éditeur de feuille de calcul et inspectez-le pour détecter les erreurs à corriger.
- Ouvrez la copie originale de votre feuille de calcul d’importation dans un éditeur de feuille de calcul et corrigez les lignes qui présentent des problèmes d’importation. N’éditez pas les lignes importées avec succès. Agir ainsi entraîne l’échec de la réimportation.
- Téléchargez la feuille de calcul réparée au format CSV.
- Revenez à l’outil d’importation en bloc et sélectionnez Réessayer.
- Sélectionnez le bouton Téléverser un fichier, repérez et sélectionnez le fichier CSV réparé, puis sélectionnez Ouvrir. Autrement, vous pouvez glisser-déposer le fichier CSV réparé vers la zone avec le contour en pointillés sur la page Téléverser le modèle.
- Sélectionnez Oui! J’accepte de téléverser dans mon menu un fichier contenant [X] modifications qui ne peuvent pas être annulées.
- Sélectionnez Soumettre. Pour les importations partiellement terminées, les lignes réparées sont réimportées et les lignes déjà importées avec succès ne sont pas dupliquées.
- Une fois le fichier CSV importé avec succès, vous êtes redirigé vers l’onglet Historique d’importation et avisé que l’importation a réussi. Une nouvelle entrée est également ajoutée au tableau Importations terminées pour l’importation que vous venez de terminer.
- Si la réimportation devait corriger une importation partiellement terminée, vous devrez peut-être aussi utiliser Toast Web pour réorganiser les entités de menu importées. Pour plus d’informations, consultez Corriger l’ordre des entités de menu réimportées ci-dessous.
Corriger l’ordre des entités de menu réimportées
Après avoir corrigé une importation partiellement terminée, vous devrez peut-être aussi utiliser Toast Web pour réorganiser les entités de menu importées. En effet, les entités précédemment échouées sont ajoutées au bas de leurs entités parentes lorsqu’elles sont réimportées.
Envisagez un fichier d’importation qui crée trois articles de menu (articles A, B et C) et les rattache au même groupe de menus (groupe X). Si, pendant le processus d’importation, la ligne de l’article de menu B échoue, l’importation initiale ressemble à ceci :
- Groupe de menu X
- Article de menu A
- Article de menu C
(Sommaire des erreurs d’importation : Échec de l’importation de l’article de menu B)
Après avoir corrigé la ligne pour l’article de menu B et réimporté, l’ordre des articles de menu est :
- Groupe de menu X
- Article de menu A
- Article de menu C
- Article de menu B
Revenir à un rapport incomplet pour la mise à jour en bloc du menu
Il est possible de quitter la page d’importation incomplète sans corriger ni réessayer l’importation qui a échoué (vous pouvez quitter la page d’importation incomplète en sélectionnant l’icône de fermeture (X), ou en accédant à une autre page de Toast Web, ou en fermant complètement Toast Web). Si vous quittez la page d’importation incomplète avec une importation en bloc échouée en cours, alors la prochaine fois que vous visitez la page de l’outil d’importation en bloc, une notification s’affiche dans l’onglet Commencer, vous indiquant que vous avez une ou plusieurs tentatives d’importation nécessitant une attention particulière. Cette notification reste dans l’onglet Premiers pas jusqu’à ce que vous résolviez le problème lié aux importations en bloc qui ont échoué.
Vous pouvez relancer rapidement le processus de réimportation en sélectionnant le lien Afficher l’historique des importations dans la notification ou en allant dans l’onglet Historique des importations. Toute importation échouée est répertoriée dans le tableau Importations incomplètes. Sélectionnez le lien Corriger et réessayer une importation échouée pour rouvrir la page Importation incomplète de l’importation et poursuivre la procédure fournie ci-dessus.
Ressources supplémentaires