Configuration du fournisseur de données OData v4, configurations requises et bonnes pratiques

Article
03/15/2023

Cette rubrique décrit comment configurer le fournisseur de données OData v4 ainsi que les configurations requises et les bonnes pratiques recommandées pour utiliser le fournisseur de données OData v4 avec un service Web OData v4.

Bonnes pratiques de fournisseur de données OData v4

Microsoft Dataverse exige que toutes les tables aient un attribut ID, cet ID étant connu comme identifiant unique et la valeur devant être un guid. Vous pouvez mapper uniquement les colonnes d'ID vers les colonnes externes avec le type de données Edm.Guid. Vous ne pouvez pas mapper un type de données Edm.Int32 vers une colonne de type de données Identificateur unique dans Dataverse.
Les tables OData avec des propriétés Nullable doivent être définies pour correspondre à la colonne mappée dans la table virtuelle. Par exemple, une propriété de table OData avec la valeur Nullable=False doit avoir la colonne mappée dans l'attribut Champ requis Dataverse défini sur Contrainte obligatoire.
Pour extraire les plusieurs requêtes, par exemple lors du chargement des données dans une grille, contrôlez la taille de l'ensemble de données renvoyé depuis la source de données externe à l'aide des paramètres de requête de filtre et de sélection.
S’il n’est pas déjà activé, les administrateurs système doivent activer le traçage du plug-in. Une fois activées, toutes les erreurs du point de terminaison OData sont recueillies dans le journal de traçage du plug-in. Pour plus d'informations : Guide de l'administrateur : Boîte de dialogue Paramètres du système – onglet Personnalisation
Vous ne pouvez pas utiliser le fournisseur de données OData v4 pour vous connecter à un autre environnement.

Mappage de type de données

Le tableau suivant répertorie les mappages de type de données de table OData avec les types de données Dataverse.

Type de données OData	Dataverse Type de données
`Edm.Boolean`	Deux options
`Edm.DateTime`	Date et heure
`Edm.DateTimeOffset`	Date et heure
`Edm.Decimal`	Nombre décimal ou devise
`Edm.Double`	Nombre à virgule flottante
`Edm.Guid`	Identificateur unique
`Edm.Int32`	Nombre entier
`Edm.Int64`	Nombre entier
`Edm.String`	Ligne unique de texte ou plusieurs lignes de texte

Les types de données EDM OData qui ne sont pas pris en charge pour le mappage avec les tables virtuelles

Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte

Ajouter une source de données en utilisant le fournisseur de données OData v4

Cette procédure vous montre comment utiliser le fournisseur de données prêt à l'emploi OData comme source de données de la table virtuelle.

Accédez à Paramètres > Administration > Sources de données d'entités virtuelles.
Dans la barre d'outils Actions, sélectionnez Nouveau.
Dans la boîte de dialogue Sélectionner un fournisseur de données, sélectionnez une source de données parmi celles qui suivent, puis sélectionnez OK.
- Fournisseur de données OData v4. Dataverse comprend un fournisseur de données Odata v4 qui peut être utilisé pour se connecter aux sources de données qui prennent en charge la norme ouverte OData v4.
- Fournisseur de données personnalisé. Si vous avez importé un plug-in de fournisseur de données, ce dernier apparaîtra ici. Informations supplémentaires : Documentation pour développeurs : Se familiariser avec les tables virtuelles
Dans la page de propriétés Nouvelle source de données, complétez les colonnes suivantes, puis enregistrez la ligne.
- Nom. Tapez un nom descriptif de la source de données.
- Uri. Si vous utilisez le fournisseur de données OData, entrez l'uri du service Web OData. Par exemple, si vous utilisez le fournisseur OData pour vous connecter à un service Web hébergé dans Azure, l'URI peut ressembler à celle-ci : https://contosodataservice.azurewebsites.net/odata/.
- Délai d'attente en secondes. Saisissez le nombre de secondes pour patienter pour une réponse du service Web avant l'expiration de la demande de données. Par exemple, saisissez 30 pour attendre un maximum de trente secondes avant que l'expiration ne survienne.
- Mode Pagination. Sélectionnez l’utilisation de la pagination côté client ou côté serveur pour contrôler comment les résultats de la requête sont paginés. La valeur par défaut est la pagination côté client. Avec la pagination côté serveur, le serveur contrôle comment les résultats sont paginés en utilisant le paramètre $skiptoken, qui est ajouté à la chaîne de requête. Pour plus d'informations : Ignorer l'option de requête du système de jeton ($skiptoken)
  - Retourner le comptage en ligne. Renvoie le nombre total de lignes dans le jeu de résultats. Ce paramètre est utilisé pour activer la fonctionnalité de page suivante lorsque vous envoyez des données vers une grille. Utilisez une valeur false (Faux) si votre point de terminaison OData ne prend pas en charge le paramètre OData $inlinecount. La valeur par défaut est false (Faux).
- Paramètres de requête. Éventuellement, vous pouvez ajouter des paramètres personnalisés de chaîne de requête ou d'en-tête pour la connexion au service Web OData, comme des paramètres d'authentification au service externe. Cliquez sur Chaîne de requête pour basculer entre les paramètres et les valeurs d'en-tête et de chaîne de requête. Il est possible d'ajouter jusqu'à 10 chaînes de requête ou d'en-tête.

Voir aussi

Création et modification de tables virtuelles qui contiennent des données provenant d'une source de données externe

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é).

Share via