Référence sur les formules pour Power Apps

Notes

Avez-vous consulté le nouveau Microsoft Power Fx ?

Les formules combinent de nombreux éléments, à savoir :

  • Les fonctions acceptent des paramètres, effectuent une opération et renvoient une valeur. Par exemple, Sqrt(25) renvoie 5. Les fonctions sont modélisées d’après les fonctions Microsoft Excel. Certaines fonctions ont des effets secondaires, par exemple SubmitForm. Elles sont appropriées uniquement dans une formule de comportement comme Button.OnSelect.
  • Les signaux renvoient des informations sur l’environnement. Par exemple, Location renvoie les coordonnées GPS actuelles de l’appareil. Les signaux n’acceptent aucun paramètre et n’ont aucun effet secondaire.
  • Les énumérations renvoient une valeur constante prédéfinie. Par exemple, Color est une énumération qui a des valeurs prédéfinies pour Color.Red, Color.Blue, et ainsi de suite. Les énumérations courantes sont indiquées ici. Les énumérations spécifiques aux fonctions sont décrites avec la fonction.
  • Les opérateurs nommés, par exemple ThisItem et Self, fournissent un accès aux informations depuis un conteneur.

D’autres éléments incluent :

A

Abs  : valeur absolue d’un nombre.

Acceleration  : lit le capteur d’accélération de votre appareil.

Acos  : renvoie l’arc sinus d’un nombre calculé en radians.

Acot  : renvoie l’arc cotangente d’un nombre calculé en radians.

AddColumns  : renvoie une table pour laquelle des colonnes ont été ajoutées.

And  : logique booléenne AND. Renvoie true si tous les arguments sont true. Vous pouvez également utiliser && comme opérateur.

App  : fournit des informations sur l’application en cours d’exécution et un contrôle du comportement de l’application.

Asin  : renvoie l’arc sinus d’un nombre calculé en radians.

Assert  : s’évalue à true ou à false dans un test.

As – Nomme l’enregistrement actuel dans des fonctions de galerie, de formulaire et d’étendue d’enregistrement telles que ForAll, With, et Sum.

AsType – traite une référence d’enregistrement comme un type de table spécifique.

Atan  : renvoie l’arc tangente d’un nombre calculé en radians.

Atan2  : renvoie l’arc tangente d’après des coordonnées (x,y) calculé en radians.

Average  : calcule la moyenne d’une expression de table ou d’un jeu d’arguments.

B

Back  : affiche l’écran précédent.

Blank : retourne une valeur vide qui peut être utilisée pour insérer une valeur NULL dans une source de données.

C

Calendar  : récupère des informations sur le calendrier pour les paramètres régionaux actuels.

Char  : traduit un code de caractère en une chaîne.

Choices  : retourne une table des valeurs possibles pour une colonne de liste de choix.

Clear  : supprime toutes les données d’une collection.

ClearCollect  : supprime toutes les données d’une collection, puis ajoute un ensemble d’enregistrements.

ClearData  : efface une ou plusieurs collections d’un hôte d’application tel qu’un appareil local.

Clock  : récupère des informations sur l’horloge pour les paramètres régionaux actuels.

Coalesce  : remplace les valeurs vides tout en laissant les valeurs non vides inchangées.

Collect  : crée une collection ou ajoute des données à une source de données.

Color  : définit une propriété sur une valeur de couleur prédéfinie.

ColorFade  : atténue une valeur de couleur.

ColorValue  : traduit un nom de couleur CSS ou un code hexadécimal en une valeur de couleur.

Compass  : renvoie votre en-tête de boussole.

Concat  : concatène les chaînes d’une source de données.

Concatenate  : concatène les chaînes.

Concurrent  : évalue plusieurs formules entre elles en même temps.

Connection  : renvoie des informations sur votre connexion réseau.

Count  : compte les enregistrements de la table contenant des nombres.

Cos  : renvoie le cosinus d’un angle calculé en radians.

Cot  : renvoie la cotangente d’un angle calculé en radians.

CountA  : compte les enregistrements de la table qui ne sont pas vides.

CountIf  : compte les enregistrements de la table qui satisfont à une condition.

CountRows  : compte les enregistrements d’une table.

D

DataSourceInfo  : fournit des informations sur une source de données.

Date  : renvoie une valeur date/heure, d’après les valeurs année, mois et jour.

DateAdd  : ajoute des jours, mois, trimestres ou années à une valeur de date/heure.

DateDiff  : soustrait deux valeurs de date et affiche le résultat en jours, mois, trimestres ou années.

DateTimeValue  : convertit une chaîne de date et d’heure en une valeur date/heure.

DateValue  : convertit une chaîne composée seulement d’une date en une valeur date/heure.

Day  : récupère la partie jour d’une valeur date/heure.

Defaults  : renvoie les valeurs par défaut d’une source de données.

Degrees  : convertit les radians en degrés.

Disable  : désactive un signal, par exemple Location pour lire des données GPS.

Distinct  : offre un récapitulatif des enregistrements d’une table en supprimant les doublons.

Download  : télécharge un fichier à partir du web sur l’appareil local.

DropColumns  : renvoie une table dont une ou plusieurs colonnes ont été supprimées.

E

EditForm  : réinitialise un contrôle de formulaire pour la modification d’un élément.

Enable  : active un signal, par exemple Location pour lire des données GPS.

EncodeUrl  : encode des caractères spéciaux à l’aide de l’encodage des URL.

EndsWith  : vérifie si une chaîne de texte se termine par une autre chaîne de texte.

Errors  : fournit des informations d’erreur sur les modifications apportées précédemment à une source de données.

exactin – Vérifie si une chaîne de texte est contenue dans une autre chaîne de texte ou tableau, en fonction de la casse. Également utilisé pour vérifier si un enregistrement est dans une table.

Exit  : Quitte l’application en cours d’exécution et déconnecte éventuellement l’utilisateur actuel.

Exp  : renvoie e élevé à la puissance.

F

Filter  : renvoie une table filtrée selon un ou plusieurs critères.

Find  : vérifie si une chaîne apparaît dans une autre et renvoie l’emplacement.

First  : renvoie le premier enregistrement d’une table.

FirstN  : renvoie le premier jeu d’enregistrements (N enregistrements) d’une table.

ForAll  : calcule les valeurs et effectue des actions pour tous les enregistrements d’une table.

G

GroupBy  : renvoie une table dont les enregistrements sont regroupés.

GUID  : convertit une chaîne GUID en une valeur GUID, ou crée une valeur GUID.

H

HashTags  : extrait les hashtags (#strings) d’une chaîne.

Hour  : renvoie la partie heure d’une valeur date/heure.

I

If  : renvoie une valeur si une condition est vraie et une autre valeur dans le cas contraire.

IfError  : détecte les erreurs et fournit une valeur alternative, ou prend des mesures.

in – Vérifie si une chaîne de texte est contenue dans une autre chaîne de texte ou tableau, indépendamment de la casse. Également utilisé pour vérifier si un enregistrement est dans une table.

IsBlank  : recherche une valeur blank.

IsBlankOrError – Vérifie un valeur ou erreur Vide.

IsEmpty  : recherche une table vide.

IsError  : Recherche une erreur.

IsMatch  : compare une chaîne à un modèle. Les expressions régulières peuvent être utilisées.

IsNumeric  : recherche une valeur numérique.

IsToday  : vérifie si une valeur date/heure est celle du jour.

IsType – vérifie si une référence d’enregistrement fait référence à un type de table spécifique.

J

JSON  : génère une chaîne de texte JSON pour une table, un enregistrement ou une valeur.

L

Language  : renvoie la balise de langue de l’utilisateur actuel.

Last  : renvoie le dernier enregistrement d’une table.

LastN  : renvoie le dernier jeu d’enregistrements (N enregistrements) d’une table.

Launch  : lance une page web ou une application canevas.

Left  : renvoie la partie la plus à gauche d’une chaîne.

Len  : renvoie la longueur d’une chaîne.

Ln  : renvoie le logarithme naturel.

LoadData  : charge une collection à partir d’un hôte d’application tel qu’un appareil local.

Location  : renvoie votre emplacement sous forme de coordonnées sur une carte en utilisant le système GPS (Global Positioning System) et d’autres informations.

LookUp  : recherche un enregistrement unique dans une table en fonction d’un ou de plusieurs critères.

Lower  : convertit les lettres d’une chaîne de texte en minuscules.

M

Match  : extrait une sous-chaîne en fonction d’un modèle. Les expressions régulières peuvent être utilisées.

MatchAll  : extrait plusieurs sous-chaînes en fonction d’un modèle. Les expressions régulières peuvent être utilisées.

Max  : valeur maximale d’une expression de table ou d’un jeu d’arguments.

Mid  : renvoie la partie centrale d’une chaîne.

Min  : valeur minimale d’une expression de table ou d’un jeu d’arguments.

Minute  : récupère la partie minute d’une valeur date/heure.

Mod  : renvoie le reste d’une division.

Month  : récupère la partie mois d’une valeur date/heure.

N

Navigate  : modifie l’écran qui s’affiche.

NewForm  : réinitialise un contrôle de formulaire pour la création d’un élément.

Not  : logique booléenne NOT. Renvoie true si son argument est false et renvoie false si son argument est true. Vous pouvez également utiliser l’opérateur !.

Notify  : affiche un message de bannière à l’utilisateur.

Now  : renvoie la valeur date/heure actuelle.

O

Or  : logique booléenne OR. Renvoie true si tous les arguments sont true. Vous pouvez également utiliser || comme opérateur.

P

Param  : paramètres d’accès passés à une application canevas lors de son lancement.

Parent  : permet d’accéder aux propriétés d’un contrôle de conteneur.

Patch  : modifie ou crée un enregistrement dans une source de données ou fusionne des enregistrements en dehors d’une source de données.

Pi  : renvoie le nombre π.

PlainText  : supprime les balises HTML et XML depuis une chaîne.

Power  : renvoie un nombre élevé à la puissance. Vous pouvez également utiliser ^ comme opérateur.

Proper  : convertit la première lettre de chaque mot en une chaîne en majuscules et convertit le reste en minuscules.

R

Radians  : convertit les degrés en radians.

Rand  : renvoie un nombre pseudo-aléatoire.

ReadNFC – Lit une balise NFC (Near Field Communication).

Refresh  : actualise les enregistrements d’une source de données.

Relate – Les enregistrements Relate de deux tables via une relation un-à-plusieurs ou plusieurs-à-plusieurs.

Remove  : supprime un ou plusieurs enregistrements spécifiques à partir d’une source de données.

RemoveIf  : supprime les enregistrements d’une source de données en fonction d’une condition.

RenameColumns  : renomme les colonnes d’une table.

Replace  : remplace une partie d’une chaîne par une autre chaîne, d’après la position de départ de la chaîne.

RequestHide – Cache un formulaire SharePoint.

Reset  : réinitialise un contrôle d’entrée à sa valeur par défaut, en ignorant les modifications de l’utilisateur.

ResetForm  : réinitialise un contrôle de formulaire pour la modification d’un élément existant.

Revert  : recharge et efface les erreurs des enregistrements d’une source de données.

RGBA  : renvoie une valeur de couleur pour un ensemble de composants rouges, verts, bleus et alphanumériques.

Right  : renvoie la partie la plus à droite d’une chaîne.

Round  : arrondit au nombre le plus proche.

RoundDown  : arrondit au nombre précédent le plus grand.

RoundUp  : arrondit au nombre suivant le plus petit.

S

SaveData  : enregistre une collection vers un hôte d’application tel qu’un appareil local.

Search  : recherche les enregistrements d’une table contenant une chaîne dans l’une de leurs colonnes.

Second  : récupère la partie seconde d’une valeur date/heure.

Select  : simule une action de sélection sur un contrôle, entraînant l’évaluation de la formule OnSelect.

Self – Donne accès aux propriétés du contrôle en cours.

Sequence – Générer un tableau de nombres séquentiels, utile lors d’une itération avec ForAll.

Set  : définit la valeur d’une variable globale.

SetFocus  : déplace le focus d’entrée vers un contrôle spécifique.

SetProperty  : simule des interactions avec les contrôles d’entrée.

ShowColumns  : renvoie une table contenant uniquement les colonnes sélectionnées.

Shuffle  : réorganise les enregistrements d’une table de manière aléatoire.

Sin  : renvoie le sinus d’un angle calculé en radians.

Sort  : renvoie un tableau trié selon une formule.

SortByColumns  : renvoie un tableau trié d’après une ou plusieurs colonnes.

Split  : fractionne une chaîne de texte en une table de sous-chaînes.

Sqrt  : renvoie la racine carrée d’un nombre.

StartsWith  : vérifie si une chaîne de texte commence par une autre chaîne de texte.

StdevP  : renvoie l’écart type de ses arguments.

Substitute  : remplace une partie d’une chaîne par une autre chaîne, en mettant les chaînes en correspondance.

SubmitForm  : enregistre l’élément d’un contrôle de formulaire dans la source de données.

Sum  : calcule la somme d’une expression de table ou d’un jeu d’arguments.

Switch  : correspond à un ensemble de valeurs, puis évalue une formule correspondante.

T

Table  : crée une table temporaire.

Tan  : renvoie la tangente d’un angle calculé en radians.

Text  : convertit n’importe quelle valeur, et met en forme un nombre ou une valeur de date/heure en une chaîne de texte.

ThisItem – Renvoie l’enregistrement de l’élément actuel dans une galerie ou un contrôle de formulaire.

ThisRecord – Renvoie l’enregistrement de l’élément actuel dans une fonction d’étendue d’enregistrement, telle que ForAll, With, et Sum.

Time  : renvoie une valeur date/heure, d’après les valeurs heure, minute et seconde.

TimeValue  : convertit une chaîne composée d’une heure seulement en une valeur date/heure.

TimeZoneOffset  : retourne la différence entre l’heure UTC et l’heure locale de l’utilisateur, exprimée en minutes.

Today  : renvoie la valeur date/heure actuelle.

Trace  : fournit des informations supplémentaires dans les résultats de vos tests.

Trim  : supprime les espaces supplémentaires situés aux extrémités et à l’intérieur d’une chaîne de texte.

TrimEnds  : supprime les espaces supplémentaires situés aux extrémités d’une chaîne de texte uniquement.

U

Ungroup  : supprime un regroupement.

Unrelate – supprime la relation entre les enregistrements de deux tables dans une relation un-à-plusieurs ou plusieurs-à-plusieurs.

Update  : remplace un enregistrement dans une source de données.

UpdateContext  : définit la valeur d’une ou plusieurs variables de contexte de l’écran actuel.

UpdateIf  : modifie un jeu d’enregistrement dans une source de données d’après une condition.

Upper  : convertit les lettres d’une chaîne de texte en majuscules.

User  : renvoie des informations sur l’utilisateur actuel.

V

Validate  : vérifie si la valeur d’une colonne unique ou d’un enregistrement complet est valide pour une source de données.

Value  : convertit une chaîne en nombre.

VarP  : renvoie la variance de ses arguments.

ViewForm  : réinitialise un contrôle de formulaire pour l’affichage d’un élément existant.

W

Weekday  : récupère la partie semaine d’une valeur date/heure.

With  : calcule des valeurs et effectue des actions pour un seul enregistrement, y compris des enregistrements inline de valeurs nommées.

Y

Year  : récupère la partie année d’une valeur date/heure.