Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
| Nonm | 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 | Disponible pour |
|---|---|---|
| Currency | Des valeurs monétaires entre -922 337 203 685 477 et 922 337 203 685 477 peuvent être dans cette colonne. | Applications pilotées par modèle et applications canevas |
| DateAndTime.DateAndTime | Affiche une date et une heure. | Applications pilotées par modèle et applications canevas |
| DateAndTime.DateOnly | Affiche la date uniquement. | Applications pilotées par modèle et applications canevas |
| Decimal | 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. | Applications pilotées par modèle et applications canevas |
| Enum | Type de données énumérées. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| Lookup.Simple | Permet une référence unique à une table spécifique. Tous les champs de recherche ont ce type. | Applications pilotées par modèle |
| Multiple | Cette colonne peut contenir jusqu’à 1 048 576 caractères de texte. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| Object | Type de données d’objet. Ne peut être utilisé qu’avec les propriétés de sortie. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| SingleLine.Text | Cette option affiche simplement du texte. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| 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. | Applications pilotées par modèle et applications canevas |
| Whole.None | Cette option affiche simplement un nombre. | Applications pilotées par modèle et applications canevas |
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 :
| Valeur | 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. |
Nonte
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
Nonte
- 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, la version et les 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" />
Articles associés
Référence du schéma de manifeste Power Apps component framework
Référence des API Power Apps component framework
Vue d'ensemble de Power Apps component framework