Errors

Syntaxe

Paramètres

Description

Cette fonction permet de fournir des informations sur les erreurs des modifications précédentes apportées à une source de données.

Remarques

• Permet de diagnostiquer les erreurs survenues lors de l'envoi de données : La fonction Errors est essentielle pour récupérer les erreurs générées après une tentative infructueuse de mise à jour, de création ou de suppression dans une source de données. Elle permet au développeur d'identifier ce qui a échoué et pourquoi, au lieu de deviner à l'aveugle.
• Fonctionne de manière contextuelle selon la source de données spécifiée : En fournissant une source de données comme premier paramètre, Errors retourne toutes les erreurs enregistrées pour cette source à la suite d'opérations précédentes. Cela la rend utile dans les applications multi-sources où chaque bloc de données peut échouer indépendamment.
• Le paramètre Record permet un filtrage ciblé des erreurs : En précisant un enregistrement en second paramètre, on peut limiter les erreurs retournées à celles qui concernent uniquement ce record. Cela permet un traitement plus précis, par exemple pour afficher des messages d'erreur spécifiques à une ligne d'un formulaire ou d'une galerie.
• Retourne une table d'erreurs structurée et exploitable : La fonction renvoie une table contenant des colonnes comme Message, Column, Row, et parfois des codes d'erreurs spécifiques à la source de données. Cela permet d'afficher facilement ces informations à l'utilisateur ou de les utiliser dans des logiques conditionnelles.
• Indispensable pour construire une interface utilisateur réactive : En surveillant les erreurs à l'aide de Errors, on peut informer immédiatement l'utilisateur d'un problème (exemple : champ manquant, contrainte violée, valeur non autorisée). Cela améliore fortement l'expérience utilisateur en fournissant des retours clairs et rapides.
• Utile après les fonctions Patch, Remove, Update, Collect,... : Chaque fois qu'une fonction de modification de données est utilisée, il est recommandé de consulter la fonction Errors juste après pour vérifier le succès ou l'échec de l'opération. C'est une bonne pratique dans les applications professionnelles ou critiques.
• Compatible avec la gestion d'erreurs personnalisée : Les messages retournés par Errors peuvent être affichés directement, traduits ou utilisés pour construire des messages personnalisés. Par exemple, si une erreur contient le mot "duplicate", on peut en déduire qu'il s'agit d'une violation d'unicité et afficher un message plus explicite.
• Doit être appelée immédiatement après l'opération concernée : La fonction ne conserve pas un historique permanent des erreurs; elle reflète uniquement les erreurs de la dernière tentative d'envoi de données. Si une nouvelle opération est effectuée, les erreurs précédentes peuvent être effacées ou remplacées. Il faut donc traiter les erreurs sans délai.