Blank, Coalesce, IsBlanket IsEmpty fonctions

Functions	S’applique à
Blank	Les applications Canvas Copilot Studio Desktop circulent des colonnes de formule Dataverse basées sur des modèles d’applications Power Platform CLI Dataverse
Coalesce IsEmpty	Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages
IsBlank	Les applications Canvas Copilot Studio Desktop circulent des colonnes de formule Dataverse basées sur des modèles d’applications Power Platform CLI Dataverse functions Power Pages

Teste si une valeur est vide ou si une table ne contient aucun enregistrement, et fournit un moyen de créer des valeurs vide.

Vue d’ensemble

Blankest un espace réservé pour « aucune valeur » ou « valeur inconnue ». Par exemple, la propriété Selected d’un contrôle De zone de liste modifiable est vide si l’utilisateur n’a pas effectué de sélection. De nombreuses sources de données peuvent stocker et retourner des valeurs NULL, qui sont représentés dans Power Apps par une valeur vide.

N’importe quelle propriété ou valeur calculée dans Power Apps peut être vide. Par exemple, une valeur booléenne est généralement true ou false. Mais en plus de ces deux, il peut également être vide indiquant que l’état n’est pas connu. De même, dans Microsoft Excel, une cellule de feuille de calcul est initialement vide sans contenu, mais peut contenir les valeurs TRUE ou FALSE, entre autres. Le contenu de la cellule peut être supprimé à nouveau à tout moment, auquel cas elle revient à l’état vide.

Une chaîne vide fait référence à une chaîne qui ne contient aucun caractère. La fonction Len renvoie zéro pour une telle chaîne et elle peut être écrite dans une formule sous la forme de deux guillemets doubles sans rien entre les deux "". Certains contrôles et sources de données utilisent une chaîne vide pour indiquer une condition "sans valeur". Pour simplifier la création de l’application, les fonctions testent les IsBlankCoalesce valeurs vides ou les chaînes vides.

Dans le contexte de la IsEmpty fonction, vide est spécifique aux tables qui ne contiennent aucun enregistrement. La structure de la table peut être intacte et comporter des titres de colonne, mais la table ne comporte aucune donnée. Une table peut être initialement vide, puis être complétée de plusieurs enregistrements (elle n’est donc plus vide), puis les enregistrements peuvent être supprimés (elle est vide de nouveau).

Blank

La Blank fonction retourne une valeur vide . Utilisez ceci pour stocker une valeur NULL dans une source de données qui prend en charge ces valeurs, en supprimant effectivement toute valeur dans le champ.

IsBlank

La IsBlank fonction teste une valeur vide ou une chaîne vide. Le test inclut des chaînes vides pour faciliter la création d’applications, car certaines sources de données et contrôles utilisent une chaîne vide lorsqu’aucune valeur n’est présente. Pour tester spécifiquement une valeur vide à if(Value = Blank(), ... la place de IsBlank. La IsBlank fonction considère les tables vides comme non vides et IsEmpty doit être utilisée pour tester une table.

Lors de l’activation de la gestion des erreurs pour les applications existantes, envisagez de IsBlank remplacer par IsBlankOrError pour préserver le comportement de l’application existant. Avant l’ajout de la gestion des erreurs, une valeur Vide a été utilisé pour représenter à la fois les valeurs nulles des bases de données et les valeurs d’erreur. La gestion des erreurs sépare ces deux interprétations de vides, ce qui peut modifier le comportement des applications existantes qui continuent d’utiliser IsBlank.

La valeur de retour pour IsBlank laquelle il s’agit d’une valeur booléenne true ou false.

Coalesce

La Coalesce fonction évalue ses arguments dans l’ordre et retourne la première valeur qui n’est pas vide ou une chaîne vide. Utilisez cette fonction pour remplacer une valeur Vide ou chaîne vide avec une valeur différente mais laisser non Vide et les valeurs de chaîne non vides inchangées. Si tous les arguments sont des chaînes vides ou vides, la fonction retourne vide, ce qui permet Coalesce de convertir des chaînes vides en valeurs vides .

Coalesce( value1, value2 ) est l’équivalent plus concis de If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) et ne nécessite pas que valeur1 et valeur2 soient évaluées deux fois. La fonction If retourne vide s’il n’y a pas de formule « else » comme c’est le cas ici.

Tous les arguments à Coalesce utiliser doivent être du même type ; par exemple, vous ne pouvez pas combiner de nombres avec des chaînes de texte. La valeur de retour de Coalesce ce type commun est de ce type commun.

IsEmpty

La IsEmpty fonction teste si une table contient des enregistrements. Elle revient à utiliser la fonction CountRows et à vérifier la présence de la valeur zéro. Vous pouvez rechercher des erreurs de source de données en combinant IsEmpty avec la fonction Errors .

La valeur de retour est IsEmpty une valeur booléenne true ou false.

Syntaxe

Blank()

Coalesce( Value1 [, Value2, ... ] )

• Valeurs – Obligatoire. Valeurs à tester. Chaque valeur est évaluée dans l’ordre jusqu’à ce qu’une valeur qui n’est pas vide et qu’aucune chaîne vide ne soit trouvée. Les valeurs après ce point ne sont pas évaluées.

IsBlank( Valeur )

• Valeur – Obligatoire. Valeur à tester pour une valeur Vide ou chaîne vide.

IsEmpty( Tableau )

• Tableau - Obligatoire. Table dans laquelle tester la présence d’enregistrements.

Examples

Blank

1. Créez une application à partir de zéro et ajoutez un contrôle Button.

2. Définissez la propriété OnSelect du bouton sur la formule suivante :

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. Affichez un aperçu de votre application, cliquez ou appuyez sur le bouton que vous avez ajouté, puis fermez l’aperçu.

4. Dans le menu Fichier, cliquez ou appuyez sur Collections.

   La collection Cities apparaît, affichant un enregistrement avec « Seattle » et « Rainy » :

   

5. Cliquez ou appuyez sur la flèche Précédent pour revenir à l’espace de travail par défaut.

6. Ajoutez un contrôle Label et définissez sa propriété Text sur cette formule :

   IsBlank( First( Cities ).Weather )
   

   L’étiquette affiche false, car le champ Weather contient une valeur (« Rainy »).

7. Ajoutez un second bouton, puis définissez sa propriété OnSelect sur la formule suivante :

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. Affichez un aperçu de votre application, cliquez ou appuyez sur le bouton que vous avez ajouté, puis fermez l’aperçu.

   Le champ Weather du premier enregistrement dans Cities est remplacé par un vide, qui supprime la valeur « Rainy » qui s’y trouvait auparavant.

   

   L’étiquette affiche true, car le champ Weather ne contient plus de valeur.

Coalesce

IsBlank

1. Créez une application à partir de zéro, ajoutez un contrôle d’entrée de texte et nommez-le FirstName.

2. Ajoutez un libellé et définissez sa propriété Text sur la formule suivante :

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   Par défaut, la propriété Text d’un contrôle d’entrée de texte est définie sur « Text Input ». Comme le contrôle contient une valeur, il n’est pas vide et l’étiquette n’affiche aucun message.

3. Supprimez tous les caractères du contrôle d’entrée de texte, y compris les espaces.

   Étant donné que la propriété Text ne contient plus de caractères, il s’agit d’une chaîne vide et IsBlank( FirstName.Text ) est vraie. Le message indiquant que le champ est obligatoire s’affiche.

Pour plus d’informations sur la façon d’effectuer la validation à l’aide d’autres outils, reportez-vous à la fonction Validate et à Utilisation des sources de données.

Autres exemples :

IsEmpty

1. Créez une application à partir de zéro et ajoutez un contrôle Button.

2. Définissez la propriété OnSelect du bouton sur la formule suivante :

   Collect( IceCream, {Flavor : « Fraise », Quantity : 300}, {Flavor : « Chocolate », Quantity : 100} )

3. Affichez un aperçu de votre application, cliquez ou appuyez sur le bouton que vous avez ajouté, puis fermez l’aperçu.

   Une collection nommée IceCream est créée et elle contient ces données :

   

   Cette collection contient deux enregistrements et n’est pas vide. IsEmpty( IceCream ) retourne false, et CountRows( IceCream ) retourne 2.

4. Ajoutez un second bouton, puis définissez sa propriété OnSelect sur la formule suivante :

   Clair (Crème glacée)

5. Affichez un aperçu de votre application, cliquez ou appuyez sur le second bouton, puis fermez l’aperçu.

   La collection est maintenant vide :

   

   La fonction Clear supprime tous les enregistrements d’une collection, ce qui produit une collection vide. IsEmpty( IceCream ) retourne true, et CountRows( IceCream ) retourne 0.

Vous pouvez également utiliser IsEmpty pour tester si une table calculée est vide, comme l’illustrent ces exemples :