Opérateurs et identificateurs dans Power Apps

S’applique à : Applications canevas Applications pilotées par modèle

Certains de ces opérateurs dépendent de la langue de l’auteur. Pour plus d’informations sur la prise en charge des langues dans les applications de canevas, voir Applications globales.

Opérateurs in et exactin

Utilisezr les opérateurs in et exactin pour rechercher une chaîne dans une source de données, telle qu’une collection ou une table importée. L’opérateur in identifie les correspondances indépendamment de la casse, tandis que l’opérateur exactin identifie les correspondances uniquement si elles présentent la même casse. Prenons un exemple :

1. Créez ou importez une collection nommée Inventory et affichez-la dans une galerie en suivant la première procédure présentée dans l’article Afficher des images et du texte dans une galerie.

2. Définissez la propriété Items de la galerie sur la formule suivante :
   Filter(Inventory, "E" in ProductName)

   La galerie affiche tous les produits, sauf Callisto, car le nom de ce produit est le seul qui ne contient pas la lettre que vous avez spécifiée.

3. Remplacez la propriété Items de la galerie par cette formule :
   Filter(Inventory, "E" exactin ProductName)

   La galerie affiche uniquement Europa, car ce nom est le seul contenant la lettre que vous avez spécifiée dans le cas indiqué.

Opérateurs ThisItem, ThisRecord et As

Quelques contrôles et fonctions appliquent des formules à des enregistrements individuels d’une table. Pour faire référence à l’enregistrement individuel dans une formule, utilisez l’une des méthodes suivantes :

Opérateur ThisItem

Par exemple, dans ce qui suit le contrôle Gallery, la propriété Items est définie sur la source de données Employés (comme la table Employés incluse avec l’exemple Northwind Traders) :

Employees

Le premier élément de la galerie est un modèle qui est répliqué pour chaque employé. Dans le modèle, la formule de l’image utilise ThisItem pour faire référence à l’élément actuel :

ThisItem.Picture

De même, la formule du nom utilise également ThisItem :

ThisItem.'First Name' & " " & ThisItem.'Last Name'

Opérateur ThisRecord

ThisRecord est utilisé dans les fonctions qui ont une portée de l’enregistrement. Par exemple, nous pouvons utiliser la fonction Filter avec notre propriété de galerie Items pour afficher uniquement les prénoms commençant par M :

Filter( Employees, StartsWith( ThisRecord.Employee.'First Name', "M" ) )

ThisRecord est facultatif et implicite en utilisant directement les champs, par exemple, dans ce cas, on aurait pu écrire :

Filter( Employees, StartsWith( 'First Name', "M" ) )

Bien que facultatif, utiliser ThisRecord peut rendre les formules plus faciles à comprendre et peut être nécessaire dans des situations ambiguës où un nom de champ peut également être un nom de relation. ThisRecord est facultatif tandis que ThisItem est toujours nécessaire.

Utilisez ThisRecord pour référencer l’ensemble de l’enregistrement avec Patch, Collect et d’autres fonctions d’étendue d’enregistrement. Par exemple, la formule suivante définit le statut de tous les employés inactifs sur actif :

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees,
              Patch( Employees, ThisRecord, { Status: 'Status (Employees)'.Active } ) ) )

Opérateur As

Utilisez l’opérateur AS pour nommer un enregistrement dans une fonction de galerie ou d’étendue d’enregistrement, en remplaçant la valeur par défaut ThisItem ou ThisRecord. Le nom de l’enregistrement peut faciliter la compréhension de vos formules et peut être nécessaire dans des situations imbriquées pour accéder aux enregistrements dans d’autres étendues.

Par exemple, vous pouvez modifier la propriété Items de notre galerie afin qu’elle utilise As pour identifier que nous travaillons avec un employé :

Employees As Employee

Les formules de l’image et du nom sont ajustées pour utiliser ce nom pour l’enregistrement actuel :

Employee.Picture

Employee.'First Name' & " " & Employee.'Last Name'

As peut également être utilisé avec les fonctions d’étendue d’enregistrement pour remplacer le nom par défaut ThisRecord. Nous pouvons appliquer cela à notre exemple précédent pour clarifier l’enregistrement avec lequel nous travaillons :

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees As Employee,
              Patch( Employees, Employee, { Status: 'Status (Employees)'.Active } ) ) )

Lors de l’imbrication des galeries et des fonctions d’étendue d’enregistrement, ThisItem et ThisRecord font toujours référence à la portée la plus interne, laissant les enregistrements dans les portées externes non disponibles. Utilisez As pour rendre toutes les portées d’enregistrement disponibles en donnant à chacune un nom unique.

Par exemple, cette formule produit un motif d’échiquier sous forme de chaîne de texte en imbriquant deux fonctions ForAll :

Concat(
    ForAll( Sequence(8) As Rank,
        Concat(
            ForAll( Sequence(8) As File,
                    If( Mod(Rank.Value + File.Value, 2) = 1, " X ", " . " )
            ),
            Value
        ) & Char(10)
    ),
    Value
)

Définir la propriété Text d’un contrôle Label sur cette formule affiche :

Découvrons ce qui se passe ici :

• Nous commençons par itérer une table sans nom de 8 enregistrements numérotés à partir de la fonction Sequence. Cette boucle s’applique pour chaque rangée du tableau, qui est communément appelée Rang et donc nous lui donnons ce nom.
• Pour chaque ligne, nous parcourons une autre table sans nom de 8 colonnes, et nous donnons le nom commun Fichier.
• Si Rank.Value + File.Value est un nombre impair, le carré obtient un X, sinon un point. Cette partie de la formule fait référence aux deux boucles ForAll, rendues possibles grâce à l’opérateur As.
• Concat est utilisé deux fois, d’abord pour assembler les colonnes puis les lignes, avec un Char (10) ajouté pour créer une nouvelle ligne.

Un exemple similaire est possible avec des contrôles Gallery imbriqués au lieu de fonctions ForAll. Commençons par la galerie verticale pour le Rang. Ce contrôle Gallery aura une formule Items de :

Sequence(8) as Rank

Dans cette galerie, nous placerons une galerie horizontale pour le Fichier, qui sera répliquée pour chaque Rang, avec une propriété Items de :

Sequence(8) as File

Et enfin, dans cette galerie, nous ajouterons un contrôle Label qui sera répliqué pour chaque Fichier et chaque Rang. Nous allons le dimensionner pour remplir tout l’espace et utiliser la propriété Fill pour fournir la couleur avec cette formule :

If( Mod( Rank.Value + File.Value, 2 ) = 1, Green, Beige )

Opérateurs Self et Parent

Il existe trois façons de faire référence à un contrôle et à ses propriétés dans une formule :

Self et Parent sont des opérateurs et non des propriétés des contrôles eux-mêmes. Il n’est pas possible de faire référence à Parent.Parent, Self.Parent ou à Parent.Self.

Noms d’identifiants

Les noms des variables, sources de données, colonnes et autres objets peuvent contenir tout Unicode.

Utilisez des guillemets simples autour d’un nom contenant un espace ou un autre caractère spécial.
Utilisez deux guillemets simples pour représenter un guillemet simple dans le nom. Les noms qui ne contiennent pas de caractères spéciaux ne nécessitent pas de guillemets simples.

Voici quelques exemples de noms de colonnes que vous pourriez rencontrer dans un tableau et comment ils sont représentés dans une formule :

Les guillemets doubles sont utilisés pour désigner des chaînes de texte.

Afficher les noms et les noms logiques

Certaines sources de données telles que SharePoint et Microsoft Dataverse ont deux noms différents pour faire référence à la même table ou colonne de données :

• Nom logique : un nom qui est garanti unique, ne change pas après avoir été créé, n’autorise généralement pas d’espaces ou d’autres caractères spéciaux et n’est pas localisé dans différentes langues. En conséquence, le nom peut être cryptique. Ces noms sont utilisés par les développeurs professionnels. Par exemple, cra3a_customfield. Ce nom peut également être appelé nom du schéma ou juste nom.

• Nom d’affichage - Un nom convivial et destiné à être vu par les utilisateurs finaux. Ce nom peut ne pas être unique, peut changer au fil du temps, peut contenir des espaces et tout caractère Unicode et peut être localisé dans différentes langues. Correspondant à l’exemple ci-dessus, le nom d’affichage peut être Champ personnalisé avec une espace entre les mots.

Étant donné que les noms d’affichage sont plus faciles à comprendre, les applications canevas les proposent comme choix et ne suggèrent pas de noms logiques. Bien que les noms logiques ne soient pas suggérés, ils peuvent toujours être utilisés s’ils sont tapés indirectement.

Par exemple, imaginez que vous ayez ajouté un Champ personnalisé à une table dans Dataverse. Un nom logique vous sera attribué par le système que vous ne pourrez modifier que lors de la création du champ. Le résultat ressemblerait à :

Lors de la création d’une référence à un champ de comptes, il vous sera suggéré d’utiliser ’Champ personnalisé’ puisque c’est le nom complet. Les guillemets simples doivent être utilisés car ce nom contient un espace :

Après avoir sélectionné la suggestion, ’Champ personnalisé’ s’affiche dans la barre de formule et les données sont récupérées :

Bien que cela ne soit pas suggéré, nous pourrions également utiliser le nom logique de ce champ. Cela entraînera la récupération des mêmes données. Les guillemets simples ne sont pas obligatoires, car ce nom ne contient ni espaces ni caractères spéciaux :

En coulisses, un mappage est maintenu entre les noms d’affichage vus dans les formules et les noms logiques sous-jacents. Étant donné que les noms logiques doivent être utilisés pour interagir avec la source de données, ce mappage est utilisé pour convertir automatiquement le nom complet actuel en nom logique et c’est ce qui est vu dans le trafic réseau. Ce mappage est également utilisé pour reconvertir en noms logiques, pour basculer vers de nouveaux noms d’affichage, par exemple, si un nom complet change ou si un créateur dans une autre langue modifie l’application.

Levée des ambiguïtés d’un nom

Étant donné que les noms d’affichage ne sont pas uniques, le même nom complet peut apparaître plusieurs fois dans la même table. Lorsque cela se produit, le nom logique sera ajouté à la fin de nom complet entre parenthèses pour l’un ou plusieurs des noms en conflit. En s’appuyant sur l’exemple ci-dessus, s’il y avait un deuxième champ avec le même nom complet de Champ personnalisé avec un nom logique de cra3a_customfieldalt alors les suggestions montreraient :

Des chaînes de désambiguïsation de nom sont ajoutées dans d’autres situations où des conflits de noms se produisent, tels que les noms de table, de choix et d’autres éléments Dataverse.

Opérateur de levée des ambiguïtés

Certaines fonctions créent des étendues d’enregistrement pour accéder aux champs de table lors du traitement de chaque enregistrement, telles que Filter, AddColumns et Sum. Les noms de champs ajoutés à l’étendue d’enregistrement remplacent les mêmes noms qui se trouvent ailleurs dans l’application. Dans ce cas, vous pouvez toujours accéder aux valeurs en dehors de l’étendue d’enregistrement avec l’opérateur de levée d’ambiguïtés @ :

• Pour accéder aux valeurs des étendues d’enregistrements imbriquées, utilisez l’opérateur @ avec le nom de la table actuellement utilisé à l’aide de ce modèle :
  Table[@FieldName]
• Pour accéder à des valeurs globales, telles que des sources de données, des collections et des variables de contexte, utilisez le modèle [@NomObjet] (sans désignation du tableau).

Pour plus d’informations et d’exemples, consultez les étendues d’enregistrement.