VENTES: 1-800-867-1389

Comparaison des types de requêtes fixes et flexibles

Mis à jour: février 2014

 

 

Le service Marketplace expose les données à l'aide de flux OData. Protocole Web pour l'interrogation et la mise à jour des données, OData (Open Data Protocol) permet de déverrouiller vos données et de les libérer des silos qui existent aujourd'hui dans les applications. Pour ce faire, le protocole OData applique et utilise les technologies Web telles que HTTP, AtomPub (Atom Publishing Protocol) et JSON pour fournir un accès aux informations de divers services, applications et magasins.

Le protocole OData présente des similitudes avec la manière dont fonctionne Internet. Il utilise des URI pour l'identification des ressources et une interface HTTP uniforme pour interagir avec ces ressources. Il permet à un service d'autoriser les clients à exécuter de façon dynamique des requêtes sur des flux en appliquant des filtres, en effectuant un tri, etc. ou de fournir des méthodes de requête fixe (semblables à d'autres points de terminaison de service Web) selon lesquelles le client doit fournir un ensemble ou sous-ensemble spécifique de paramètres et reçoit un ensemble spécifique de résultats tel que déterminé par le propriétaire du contenu. Le service Marketplace publie des services qui utilisent ces deux types de requêtes. Le type de requête disponible pour un groupe de données est spécifié dans la page Details (Détails) du groupe de données, comme illustré dans l'image ci-dessous.

Un groupe de données de requête flexible vous permet d'ajouter des filtres nom de paramètre/valeur facultatifs lorsque vous interrogez le groupe de données (columnName=dataValue), ainsi qu'un ensemble d'options de requête OData prises en charge par le service Marketplace. Pour plus d'informations sur les options de requête prises en charge par le service Marketplace, consultez la rubrique Options de requête OData prises en charge.

Lorsque vous développez une application qui utilise un groupe de données de requête flexible, vous pouvez utiliser l'option Ajouter une référence de service dans Visual Studio pour générer des classes .NET fortement typées à l'aide desquelles appeler le service OData depuis votre application. Pour plus d'informations, consultez la rubrique Step 2: Add the Service Reference for your Data Service.

Un groupe de données de requête fixe vous permet d'appeler les méthodes de requête prédéfinies que le fournisseur de contenu met à disposition. Une méthode de requête peut inclure un ensemble de paramètres obligatoires et/ou facultatifs qui vous permettent d'ajouter des contraintes de filtrage à votre requête. La liste des paramètres obligatoires et/ou facultatifs pour les groupes de données de requête fixe est incluse dans la page Details (Détails) du groupe de données.

Pour le moment, l'option Ajouter une référence de service dans Visual Studio ne prend pas en charge la génération de code pour les services de données utilisant les requêtes fixes. Les groupes de données prenant en charge les requêtes fixes incluent une classe proxy prédéfinie pour le groupe de données. Le fichier de classe proxy est disponible dans la page Details (Détails) du groupe de données une fois l'abonnement acheté. Les classes proxy utilisent la bibliothèque cliente Service de données WCF pour créer une classe .NET fortement typée pouvant appeler le service OData. Pour plus d'informations, consultez la rubrique Création d'une application de requête fixe.

Pour déterminer le type de requête pris en charge par un groupe de données, consultez la section Identification du type de requête ci-dessous.

Avant de continuer, vérifiez que vous disposez des éléments suivants :

 

Section Description

Exemples d'URI

Exemples d'URI de requête flexible et de requête fixe.

Identification du type de requête

Procédure d'identification de la prise en charge des requêtes flexibles ou fixes par un groupe de données.

 

URI Description

https://api.datamarket.azure.com/data.ashx/contoso.com/salesreport/GetSalesReport?region=northamerica

Requête flexible permettant d'accéder au rapport sur les ventes pour l'Amérique du Nord de Contoso, Ltd.

https://api.datamarket.azure.com/data.ashx/contoso.com/salesreport/GetSalesReport

Requête flexible permettant d'accéder aux données du rapport sur les ventes de Contoso, Ltd.
Aucun paramètre n'étant spécifié, l'ensemble de résultats n'est pas filtré et la requête renvoie tous les rapports sur les ventes présents dans le système.

https://api.datamarket.azure.com/Data.ashx/adatum.com/CensusInfo/GetCensusData

Requête fixe sans paramètre obligatoire permettant d'accéder aux dernières données de recensement du service A. Datum, Inc.

L'appel de GetCensusData correspond à la méthode d'accès aux données dans la classe de service C# téléchargée fournie par le service Marketplace.

https://api.datamarket.azure.com/Data.ashx/thephone-company.com/accountbalance/GetAccountBalance?phonenumber=5551234567

Requête fixe avec un paramètre obligatoire permettant d'accéder aux données d'un solde de compte spécifique du service Marketplace The Phone Company.
Si la paire nom de paramètre/valeur n'est pas fournie, la requête échoue.

L'appel de GetAccountBalance correspond à la méthode d'accès aux données dans la classe de service C# téléchargée fournie par le service Marketplace.

ImportantImportant
Une requête flexible sans paramètre renvoie un ensemble de résultats non filtré.
Une requête fixe avec un nombre incorrect de paramètres (trop ou pas assez de paramètres) échoue.

Pour plus d'informations sur la création d'URI pour interroger les services OData, consultez la section OData URI Conventions du site Web OData.org.

Certains groupes de données autorisent uniquement les requêtes fixes, les requêtes sans paramètre ou avec des paires paramètre obligatoire/valeur. Les autres groupes de données autorisent les requêtes flexibles, les requêtes incluant des paires paramètre facultatif/valeur pour filtrer l'ensemble de résultats. Découvrez le type de requête requis par votre groupe de données.

  1. Cliquez sur l'onglet My Data (Mes données).

  2. Cliquez sur Use (Utiliser) à droite du nom du groupe de données que vous souhaitez utiliser dans votre application.

  3. Faites défiler la page jusqu'à atteindre les onglets sous la description du groupe de données.

  4. Cliquez sur l'onglet Details (Détails).

  5. Recherchez la ligne de texte sous l'URL racine du service indiquant le type de requête. Cet exemple a trait à une requête flexible.


    Figure 1 – Type de requête

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2014 Microsoft