Gestion des erreurs avec la fonction Patch dans les applications Canvas

Avantages du contrôle Forms

Les applications de canevas Power Apps Le contrôle Forms vous permet de lancer un formulaire complet et de modifier les champs affichés en un rien de temps. Le contrôle Forms possède également deux propriétés, OnSuccess et OnFailure. Ces propriétés facilitent la gestion des erreurs, car vous pouvez facilement indiquer à votre application ce qu'il faut faire une fois que les données du formulaire ont été envoyées avec succès ou sans succès à votre source de données. En outre, l'utilisation de ces propriétés vous permet d'améliorer l'expérience utilisateur de votre application en informant l'utilisateur de ce qu'il est advenu des données qu'il a tenté d'enregistrer.

Il peut arriver que vous créiez une application de canevas et que vous le fassiez ne veut pas utiliser de formulaire. Vous pouvez créer n'importe quel contrôle qu'un formulaire aurait, puis enregistrer les valeurs dans la source de données à l'aide de la fonction Patch . Toutefois, sans le contrôle Forms, vous perdez la possibilité de déclencher des propriétés telles que OnSuccess ou OnFailure.

La valeur de retour sauve la journée!

Ceci C'est là que la valeur de retour de la fonction Patch est utile. La fonction Patch renvoie l'enregistrement que vous venez de créer ou de modifier. Il sera vide s'il y a eu une erreur. Cet enregistrement renvoyé peut être enregistré en tant que variable ou utilisé dans une instruction With s'il n'est nécessaire que temporairement. Vous pouvez utiliser cette valeur pour alerter vos utilisateurs que l'action a réussi ou s'il y a eu un problème.

L'exemple suivant peut être utilisé pour la propriété OnSelect d'un contrôle Button utilisé pour enregistrer les détails d'un nouveau client dans une table. Si la ligne a été correctement enregistrée dans la source de données, l'utilisateur sera redirigé vers l'écran d'accueil de l'application. En cas d'erreur, l'utilisateur verra un message d'erreur personnalisé sous forme de notification intégrée à l'application.

 Avec (
{
wNewCustomerDetailsRow: Patch (
'Détails du client',
Valeurs par défaut ('Détails du client'),
{
'Prénom': txtCustomerFirstName.Text,
'Nom de famille': txtCustomerLastName.Text,
Courriel: txtCustomerEmail.Text
}
)
},
Si(
IsBlank (wNewCustomerDetailsRow),
Notifier (
"Une erreur s'est produite lors de l'envoi de votre demande.",
NotificationType.Error
),
Naviguer(
'Écran Trouver un employé',
Transition d'écran.Aucun
)
)
) 

Apparition d'erreurs détaillées

Sans la gestion des erreurs ci-dessus, l'application pourrait prêter à confusion pour les utilisateurs finaux car rien n'indiquerait que leur nouvelle demande n'a pas été enregistrée correctement. Les utilisateurs peuvent passer trop de temps à essayer de retrouver un élément ou une ligne qui n'a jamais été ajouté au départ. Cependant, une chose qui pourrait encore conduire à des frustrations est que le problème n’est pas clairement défini. Par conséquent, une amélioration à partir de là consiste à utiliser la fonction Erreurs . L'exemple ci-dessous affiche l'erreur la plus récente de la source de données sur laquelle l'utilisateur a tenté d'écrire, ce qui peut aider l'utilisateur à résoudre le problème par lui-même ou fournir des informations plus utiles au créateur de Power Apps.

 Avec (
{
wNewCustomerDetailsRow: Patch (
'Détails du client',
Valeurs par défaut ('Détails du client'),
{
'Prénom': txtCustomerFirstName.Text,
'Nom de famille': txtCustomerLastName.Text,
                Courriel: txtCustomerEmail.Text
}
)
},
Si(
IsBlank (wNewCustomerDetailsRow),
Notifier (
"Une erreur s'est produite lors de la soumission de votre demande:" & Last (Errors ('Customer Details')). Message,
NotificationType.Error
),
Naviguer(
'Écran Trouver un employé',
Transition d'écran.Aucun
)
)
) 

À propos de l'auteur

Katie Suerth est une consultante Power Platform basée à Chicago. Elle aime travailler avec Power Apps, les applications de canevas et Power Automate.

Plus de cet auteur