Configuration du fournisseur de données OData v4, configuration et bonnes pratiques
Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Configuration du fournisseur de données OData v4
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
Votre instance nécessite que toutes les entités aient un attribut ID. Cet ID est connu sous la forme d’un identificateur unique et la valeur doit être un guid. Vous pouvez mapper uniquement les champs d’ID vers les champs externes avec le type de données EDM.Guid. Vous ne pouvez pas mapper un type de données EDM.Int32 vers un champ de type de données uniqueidentifer.
Les entités OData avec des propriétés Nullable doivent être définies pour correspondre au champ mappé dans l’entité virtuelle. Par exemple, une propriété d’entité OData avec la valeur Nullable=False doit avoir le champ mappé avec l’attribut Champ requis 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 : Boîte de dialogue Paramètres système - onglet Personnalisation
Mappage de type de données
Le tableau suivant répertorie les mappages de type de données EDM OData avec le type de données approprié.
| Type de données OData | 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 entités 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 l’entité 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. Votre environnement 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. Pour plus d’informations : Se familiariser avec les entités virtuelles
Dans la page de propriétés Nouvelle source de données, complétez les champs suivants, puis enregistrez l’enregistrement.
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 à
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 : Option de requête du système de jeton d’évitement ($skiptoken)
- Retourner le comptage en ligne. Renvoie le nombre total d’enregistrements 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 $inclinecount. 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. Sélectionnez 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 d’entités virtuelles qui contiennent des données provenant d’une source de données externe
TechnNet Blog : Interagir avec des données issues de systèmes externes à l’aide des nouvelles entités virtuelles