Partager via

Élément property

  • Article

Le nœud property définit une partie spécifique et configurable de données que le composant attend de Microsoft Dataverse.

Disponible pour

Applications pilotées par modèle et applications canevas

Propriétés

Nom  Description Type Requise Disponible pour
default-value La valeur de configuration par défaut fournie au composant. Dans les applications pilotées par modèle, cette propriété n’est autorisée que sur les entrées, car les paramètres liés s’attendent à ce qu’une colonne soit associée. string Facultatif Applications pilotées par modèle
description-key Utilisé dans les écrans de personnalisation comme chaînes localisées qui effectue la description de la propriété. string Facultatif Applications pilotées par modèle et applications canevas
display-name-key Utilisé dans les écrans de personnalisation comme chaînes localisées qui décrit le nom de la propriété. string Oui Applications pilotées par modèle
nom Nom de la propriété. string Oui Applications pilotées par modèle et applications canevas
of-type-group Nom du groupe type comme défini dans le manifeste string Facultatif Applications pilotées par modèle
of-type Définit le type de données de la propriété Voir Utilisation de of-type Facultatif Applications pilotées par modèle et applications canevas
pfx-default-value La valeur de l’expression PFX par défaut fournie au composant. Voir Utilisation de pfx-default-value Facultatif Applications de canevas
Nécessaire Indique si la propriété est requise ou non Booléen Facultatif Applications pilotées par modèle
utilisation active La propriété d’utilisation identifie si la propriété est censée représenter une colonne de table que le composant peut modifier (liaison), des valeurs en lecture seule (entrée) ou des valeurs de sortie liaison, entrée ou sortie Oui Applications pilotées par modèle

Remarques

Cette section contient des instructions sur l’utilisation des attributs de l’élément Property.

Utilisation de of-type

La valeur de la propriété of-type doit être l’une des valeurs suivantes :

Valeur Description
Devise Des valeurs monétaires entre -922 337 203 685 477 et 922 337 203 685 477 peuvent être dans cette colonne.
DateAndTime.DateAndTime Affiche une date et une heure.
DateAndTime.DateOnly Affiche la date uniquement.
Décimal Il est possible d’utiliser une précision jusqu’à 10 chiffres après la virgule pour les valeurs comprises entre -100 000 000 000 et 100 000 000 000 dans cette colonne.
Enum Type de données énumérées.
FP Il est possible d’utiliser une précision jusqu’à cinq chiffres après la virgule pour les valeurs comprises entre -100 000 000 000 et 100 000 000 000 dans cette colonne.
Lookup.Simple Permet une référence unique à une table spécifique. Tous les champs de recherche ont ce type.
Multiple Cette colonne peut contenir jusqu’à 1 048 576 caractères de texte.
MultiSelectOptionSet Vous pouvez personnaliser les formulaires (principal, création rapide et aperçu) et les modèles de courrier électronique en y ajoutant des colonnes à sélection multiple. Lorsque vous ajoutez une colonne à sélection multiple, vous pouvez spécifier plusieurs valeurs que les utilisateurs pourront sélectionner. Lorsque les utilisateurs remplissent le formulaire, ils peuvent sélectionner une, plusieurs ou toutes les valeurs affichées dans une liste déroulante.
Object Type de données d’objet. Ne peut être utilisé qu’avec les propriétés de sortie.
OptionSet Cette colonne propose un ensemble d’options. Chaque option contient une valeur sous forme de nombre et une étiquette. Une fois ajouté à un formulaire, cette colonne affiche un contrôle de manière à ce que les utilisateurs ne puissent sélectionner qu’une seule option.
SingleLine.Email Cela stocke l’heure de la chaîne dans le format valide pour les e-mails. Les contrôles Unified Interface prêts à l’emploi en font automatiquement des liens cliquables.
SingleLine.Phone Cela stocke l’heure de la chaîne dans le format valide pour les téléphones. Les contrôles Unified Interface prêts à l’emploi en font automatiquement des liens cliquables.
SingleLine.Text Cette option affiche simplement du texte.
SingleLine.TextArea Cette option de format permet de visualiser plusieurs lignes de texte. Mais, avec une limite de 4 000 caractères, la colonne Plusieurs lignes de texte est une meilleure option pour les textes longs.
SingleLine.Ticker Cela stocke l’heure de la chaîne dans le format valide pour les Symbole de l’action. Les contrôles Unified Interface prêts à l’emploi en font automatiquement des liens cliquables.
SingleLine.URL Le texte devant fournir un lien hypertexte pour ouvrir la page spécifiée. Les contrôles prêts à l’emploi Unified Interface préfixent automatiquement « https:// » pour saisir des valeurs qui ne commencent pas par un protocole valide. Seuls les protocoles HTTP, HTTPS, FTP, FTPS, OneNote et TEL sont prévus dans cette colonne.
TwoOptions Cette colonne propose deux options. Chaque option contient une valeur sous forme de nombre 0 ou 1 correspondant à une valeur faux ou vrai. Chaque option a également une étiquette pour que les valeurs vrai ou faux puissent être représentées par « Oui » et « Non », « Très intéressé » et « Peu intéressé », « Ouvert » et « Fermé » ou toutes les paires d’étiquettes que vous souhaitez afficher.
Whole.None Cette option affiche simplement un nombre.

Avertissement

Si le fichier manifest.xml contient au moins un jeu de données, les propriétés de type Lookup.Simple doivent être également enveloppées dans l’élément jeu de données.

Éléments de valeur non pris en charge

Les valeurs de propriété of-type suivantes ne sont pas prises en charge actuellement :

active Description
Lookup.Customer Permet une référence unique à un enregistrement de compte ou à un enregistrement de contact. Ces recherches sont disponibles pour les tables Opportunité, Incident, Devis, Commande et Facture. Ces tables ont également des recherches Compte et Contact distinctes, que vous pouvez utiliser si vos clients sont toujours d’un seul type. Vous pouvez également inclure les deux au lieu d’utiliser la recherche Client.
Lookup.Owner Permet une référence unique à un enregistrement d’équipe ou à un enregistrement d’utilisateur. Toutes les tables Équipe ou appartenant aux utilisateurs ont l’une d’elles.
Lookup.PartyList Permet plusieurs références à plusieurs tables. Ces recherches sont disponibles sur les colonnes À et Cc de la table Courrier électronique. Elles sont également utilisées dans les tables Téléphone et Rendez-vous.
Lookup.Regarding Permet une référence unique à plusieurs tables. Ces recherches sont disponibles dans la colonne appropriée utilisée dans les activités.
Raison du statut Colonne système contenant des options qui fournissent plus d’informations sur la colonne Statut. Chaque option est associée à l’une des options Statut disponibles. Vous pouvez ajouter et modifier les options.
Status Colonne système contenant des options qui correspondent généralement à l’état actif et inactif. Certaines colonnes système ont plus d’options, mais toutes les colonnes personnalisées ont uniquement les options de statut Actif et Inactif.
Whole.Duration Cette option de format permet de visualiser une liste d’options de durée. Mais les données stockées dans la base de données sont toujours exprimées en nombre de minutes. La colonne se présente comme une liste déroulante et suggère des options, comme 1 minute, 15 minutes, 30 minutes et ainsi de suite jusqu’à trois jours. Les utilisateurs peuvent choisir ces options. Toutefois, ils peuvent également entrer un nombre de minutes, qui se transforme en période.
Whole.Language Cette option affiche une liste des langues mises en service pour votre organisation. Les valeurs sont affichées sous la forme d’une liste déroulante de noms de langues, mais les données sont stockées sous la forme de nombres à l’aide de codes LCID. Les codes de langue sont des ID de paramètres régionaux à quatre ou cinq chiffres. Les valeurs d’ID de paramètres régionaux valides sont disponibles sur la page Tableau des ID de paramètres régionaux (LCID).
Whole.TimeZone Cette option affiche une liste de sélection de fuseau horaire comme (GMT-12:00) Ligne de date internationale (Ouest) et (GMT-08:00) Pacifique (É.-U. et Canada). Chacune de ces zones est enregistrée comme nombre. Par exemple, pour le fuseau horaire (GMT-08:00) Pacifique (É.-U. et Canada), le TimeZoneCode est 4.

Notes

Les colonnes Fichier ne sont pas prises en charge pour le moment. Pour plus d’informations, consultez Colonnes de fichier

Utilisation de pfx-default-value

Utilisez la valeur de propriété pfx-default-value pour évaluer les événements et les propriétés à l’aide d’expressions Power Fx au lieu de valeurs statiques par défaut. Vous pouvez l’utiliser pour :

  • Dimensionner le contrôle de manière réactive
  • Accéder aux connecteurs
  • Fournir des exemples de données
  • Référencer les propriétés de thème
  • Événements personnalisés

Notes

  • Vous pouvez utiliser n’importe quelle expression Power Fx, mais vous devez garantir que l’expression est valide lors de l’importation du contrôle.
  • Si vous utilisez des guillemets internes ou d’autres caractères spéciaux, placez la valeur entre guillemets simples, par exemple : pfx-default-value='"Test"'
  • Vous pouvez référencer d’autres contrôles (y compris des écrans) et leurs propriétés. Écrivez ces références sous la forme : %ControlName.ID%.ControlProperty. Par exemple : pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Écrivez des énumérations telles que DisplayType et ScreenTransition sous la forme : %EnumName.RESERVED%.EnumValue. Par exemple : pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Si pfx-default-value est inclus, alors il est prioritaire sur default-value.

Éléments parents

Élément Description
control Définit l’espace de noms du composant, sa version et ses informations d’affichage.

Exemple

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

Référence du schéma de manifeste Power Apps component framework
Référence d’API Power Apps component framework
Vue d’ensemble de Power Apps component framework

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).