Error

Syntaxe

Paramètres

Description

Cette fonction permet de créer et de rapporter une erreur personnalisée.

Remarques

• Permet de signaler des erreurs personnalisées de manière contrôlée : La fonction Error est utilisée pour déclencher volontairement une erreur dans une formule, à partir de données structurées. Cela permet au développeur de gérer des cas exceptionnels ou invalides sans laisser l'application réagir de manière imprévisible.
• Compatible avec des scénarios de validation et de logique métier : On peut utiliser Error dans des règles de validation, par exemple pour bloquer la soumission d'un formulaire si des conditions ne sont pas remplies. Cela donne un retour clair à l'utilisateur en lui indiquant précisément la nature de l'erreur rencontrée.
• Prend en charge à la fois des enregistrements simples et des tables d'erreurs : La fonction accepte soit un seul enregistrement (ErrorRecord) contenant des champs comme Message, Code, Severity, soit une table complète (ErrorTable) pour rapporter plusieurs erreurs en une seule fois. Cela permet une gestion fine des erreurs multiples dans un processus.
• Peut être utilisée conjointement avec IfError pour piéger des erreurs : En combinant Error(...) avec IfError(...), on peut non seulement générer des erreurs, mais aussi les intercepter, afficher des messages adaptés à l'utilisateur ou appliquer des stratégies de contournement. Cela améliore la robustesse des applications Power Apps.
• Facilite la construction d'erreurs dynamiques selon le contexte d'exécution : Les champs passés à Error (comme le message ou le code) peuvent être construits dynamiquement à partir de variables, d'entrées utilisateurs ou de résultats d'autres formules. Cela permet de générer des erreurs contextualisées et compréhensibles.
• Indispensable dans les processus complexes de traitement ou d'intégration : Lorsque l'application interagit avec des données sensibles, comme dans un processus d'enregistrement, d'importation ou d'appel d'API, la fonction Error permet d'interrompre proprement l'exécution en cas d'anomalie métier détectée.
• Améliore l'expérience utilisateur avec des messages explicites : Plutôt que de laisser l'utilisateur deviner ce qui ne va pas, Error permet de construire des messages clairs, localisés, et adaptés au contexte. Par exemple : "Le numéro de client n'est pas valide" ou "Impossible d'enregistrer car la date est dans le passé".
• Permet une gestion structurée des erreurs dans les composants réutilisables : Dans un composant personnalisé ou une bibliothèque de fonctions, Error peut servir à uniformiser la manière dont les erreurs sont levées et rapportées. Cela facilite la maintenance du code et l'homogénéité du comportement entre différentes parties de l'application.