DataSet
Fournit des propriétés et des méthodes pour utiliser les données des grilles et des vues.
Disponible pour
Applications pilotées par modèle et applications canevas.
Propriétés
columns
Ensemble de colonnes disponible dans ce jeu de données. Pris en charge dans les applications pilotées par modèle et les applications canevas.
Type : Colonne[]
error
Si une erreur s’est produite dans la récupération des données. Pris en charge dans les applications pilotées par modèle et les applications canevas.
Type : boolean
errorCode
Code d’erreur associé à la dernière erreur produite, le cas échéant.
errorMessage
Message d’erreur associé à la dernière erreur produite, le cas échéant.
Type : number | string
filtering
Filtrage de la colonne pour la requête actuelle. Pris en charge dans les applications pilotées par modèle et les applications canevas. Le filtrage peut être configuré pour un jeu de données en définissant context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). Une fois le filtre défini, l’appel de context.parameters.[dataset_property_name].refresh() récupère les données filtrées de la source de données.
| Valeur | Opérateur conditionnel | Applications pilotées par modèle | Applications canevas |
|---|---|---|---|
| -1 | Aucun(e) | Oui | Oui |
| 0 | Égal à | Oui | Oui |
| 1 | NotEqual | Oui | Oui |
| 2 | GreaterThan | Oui | Oui |
| 3 | Inférieur à | Oui | Oui |
| 4 | GreaterEqual | Oui | Oui |
| 5 | LessEqual | Oui | Oui |
| 6 | J’aime | Oui | Oui |
| 7 | NotLike | Non | Oui |
| 8 | Intérieur | Oui | Oui |
| 12 | Null | Oui | Oui |
| 13 | NotNull | Non | Oui |
| 14 | Hier | Oui | Non |
| 15 | Aujourd’hui | Oui | Non |
| 16 | Demain | Oui | Non |
| 17 | Last7Days | Oui | Non |
| 18 | Next7Days | Oui | Non |
| 19 | LastWeek | Oui | Non |
| 20 | ThisWeek | Oui | Non |
| 22 | LastMonth | Oui | Non |
| 23 | ThisMonth | Oui | Non |
| 25 | Activées | Oui | Non |
| 26 | OnOrBefore | Oui | Non |
| 27 | OnOrAfter | Oui | Non |
| 28 | LastYear | Oui | Non |
| 29 | ThisYear | Oui | Non |
| 33 | LastXDays | Oui | Non |
| 34 | NextXDays | Oui | Non |
| 37 | LastXMonths | Oui | Non |
| 38 | NextXMonths | Oui | Non |
| 49 | contient | Oui | Oui |
| 54 | BeginWith | Non | Oui |
| 55 | DoesNotBeginWidth | Non | Oui |
| 56 | EndsWidth | Non | Oui |
| 57 | DesNotEndWith | Non | Oui |
| 70 | InFiscalPeriodAndYear | Oui | Non |
| 75 | Au-dessus | Oui | Oui |
| 76 | Sous | Oui | Oui |
| 77 | Pas sous | Oui | Oui |
| 78 | AboveOrEqual | Oui | Oui |
| 79 | UnderOrEqual | Oui | Oui |
| 87 | ContainValues | Oui | Oui |
| 88 | DoesNotContainValues | Non | Oui |
Notes
La fonction de filtrage n’est disponible que pour la source de données Dataverse.
Type : Filtering
linking
Définit les informations de la table liée. Pris en charge uniquement dans les applications pilotées par modèle.
Type : Linking
loading
Indique si le jeu de données se charge ou non. Pris en charge dans les applications pilotées par modèle et les applications canevas.
Type : boolean
paging
Statut et actions de pagination. Pris en charge dans les applications pilotées par modèle et les applications canevas. Les informations de pagination peuvent être consultées et configurées pour un jeu de données en utilisant context.parameters.[dataset_property_name].paging .
Notes
La source de données Dataverse ne renvoie pas le totalRecordCount dans l’objet de pagination pour les applications canevas. Au lieu de cela, il utilise hasNextPage et hasPreviousPage pour vérifier s’il y a plus d’enregistrements à récupérer.
Les composants jeu de données peuvent utiliser context.parameters.[dataset_property_name].paging.setPageSize(pageSize) pour modifier le nombre d’enregistrements récupérés par page.
Type : Paging
enregistrements
Mappe des ID à l’objet d’enregistrement complet. Pris en charge dans les applications pilotées par modèle et les applications canevas.
Type : EntityRecord
sortedRecordIds
ID des enregistrements dans le jeu de données, triés en fonction du résultat de la réponse à la requête. Pris en charge dans les applications pilotées par modèle et les applications canevas.
Type : string[]
sorting
Statut du tri pour la requête actuelle. Pris en charge dans les applications pilotées par modèle et les applications canevas. Le tri peut être configuré pour un jeu de données en définissant context.parameters.[dataset_property_name].sorting = [SortStatus]. Une fois le tri configuré, l’appel de context.parameters.[dataset_property_name].refresh() récupère les données triées du source de données.
Notes
La fonction de tri n’est disponible que pour la source de données Dataverse.
De plus, si le tri est reconfiguré, il réinitialisera le filtre context.parameters.[dataset_property_name].filtering
Type : SortStatus[]
Méthodes
| méthode | Description | Disponible pour |
|---|---|---|
| addColumn | Ajoute une colonne à l’ensemble de colonnes. | Applications pilotées par modèle |
| clearSelectedRecordIds | Effacer la liste des ID d’enregistrements sélectionnés. | Applications pilotées par modèle et applications canevas |
| delete | Supprime les enregistrements de la source de données. | Applications canevas |
| getCommands | Commandes pour le jeu de données. | Applications canevas |
| getDataSetCapabilities | Fonctionnalités pour le jeu de données. | Applications canevas |
| getSelectedRecordIds | Récupère tous les ID d’enregistrements sélectionnés. | Applications pilotées par modèle et applications canevas |
| getTargetEntityType | Renvoie le nom du type de table cible. | Applications pilotées par modèle et applications canevas |
| getTitle | Récupère le nom d’affichage de la vue utilisé par la propriété jeu de données. | Applications pilotées par modèle et applications canevas |
| getViewId | Renvoie l’ID de vue utilisé par le paramètre jeu de données. | Applications pilotées par modèle et applications canevas |
| newRecord | Initialise un objet d’enregistrement local pour que le contrôle définisse la valeur. Le contrôle doit invoquer la méthode save() sur le nouvel enregistrement créé pour conserver la modification. |
Applications canevas |
| openDatasetItem | Ouvrez l’élément jeu de données pour une EntityReference donnée. Il vérifie s’il existe une commande avec un ID de bouton de commande Mscrm.OpenRecordItem. S’il existe, il exécute la commande, sinon il accède uniquement au formulaire associé de l’EntityReference. |
Applications pilotées par modèle et applications canevas |
| refresh | Actualise le jeu de données en fonction des filtres, du tri, de la liaison, de la nouvelle colonne. De plus, refresh réinitialisera la pagination à la page 1. | Applications pilotées par modèle et applications canevas |
| retrieveRecordCommand | Récupère les commandes associées de l’enregistrement. S’il existe plusieurs jeux de données dans le manifeste, retrieveRecordCommand renvoie les commandes pour le premier jeu de données. | Applications pilotées par modèle |
| setSelectedRecordIds | Définir les ID des enregistrements sélectionnés. | Applications pilotées par modèle et applications canevas |
Colonnes de recherche
Les colonnes de recherche de la table Dataverse peuvent désormais être récupérées. Pour les applications canevas, si une colonne de recherche est incluse dans le jeu de données, toutes les colonnes de l’enregistrement référencé sont récupérées. GetFormattedValue renvoie la chaîne JSON pour cette colonne. La méthode GetValue renvoie directement l’objet JSON.
Exemple
Pour en savoir plus sur l’implémentation des méthodes de jeu de données, voir Composant de grille DataSet
Articles associés
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é).