Élément property
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
DisplayTypeetScreenTransitionsous la forme :%EnumName.RESERVED%.EnumValue. Par exemple :pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)' - Si
pfx-default-valueest inclus, alors il est prioritaire surdefault-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" />
Rubriques connexes
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é).
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour