VENTAS: 1-800-867-1389

Comparar tipos de consultas flexibles y fijas

Actualizado: febrero de 2014

 

 

Marketplace expone datos mediante fuentes OData. El Open Data Protocol (OData) es un protocolo web para consultar y actualizar datos que proporciona una manera de desbloquear los datos y liberarlos de los silos que existen en las aplicaciones de hoy en día. Para ello, OData aplica y amplía las tecnologías web, tales como HTTP, protocolo de publicación Atom (AtomPub) y JSON, para proporcionar acceso a información desde una variedad de aplicaciones, servicios y almacenes.

OData es coherente con la manera en que funciona la Web; usa URI para la identificación de recursos y una interfaz uniforme basada en HTTP para interactuar con dichos recursos. OData proporciona a un servicio la capacidad para permitir a los clientes generar consultas dinámicamente mediante fuentes al agregar filtros, ordenamiento, etc. También permite a un servicio proporcionar métodos de consultas fijas (similares a otros extremos de servicio web) en los que el cliente debe proporcionar un conjunto o subconjunto específico de parámetros y recibe un conjunto de resultados específico según lo determina el propietario del contenido. Marketplace publica servicios que hacen uso de ambos tipos de consultas. El tipo de consulta disponible para un conjunto de datos se especifica en la página Details (Detalles) correspondiente, tal como se muestra en la imagen siguiente.

Un conjunto de datos de consultas flexibles permite agregar filtros de nombre o valor de parámetro opcional al consultar el conjunto de datos (columnName=dataValue), así como una variedad de opciones de consulta OData que admite Marketplace. Para obtener más información sobre las opciones que admite Marketplace, consulte Opciones de consultas OData admitidas.

Cuando desarrolla una aplicación que usa un conjunto de datos de consultas flexibles, use la opción Agregar referencia de servicio de Visual Studio para generar clases .NET fuertemente tipadas que podrá usar para llamar al servicio OData desde la aplicación. Consulte Step 2: Add the Service Reference for your Data Service para obtener más información.

Un conjunto de datos de consultas fijas permite llamar a métodos de consulta predefinidos que el anunciante de contenido pone a la disposición de los usuarios. Un método de consulta puede tener un conjunto de parámetros obligatorios u opcionales que permiten agregar filtros restringidos a la consulta. Puede obtener una lista de los parámetros obligatorios u opcionales de cualquier conjunto de datos de consultas fijas incluido en la página de detalles del conjunto de datos.

La opción Agregar referencia de servicio de Visual Studio actualmente no admite la generación de código para los servicios de datos que admiten consultas fijas. Los conjuntos de datos que admiten consultas fijas proporcionan una clase proxy previamente creada para ellos. El archivo de clase proxy está disponible en la página de detalles del conjunto de datos una vez adquirida la suscripción. Las clases proxy usan la biblioteca cliente de servicios de datos de WCF para crear una clase .NET fuertemente tipada que puede llamar al servicio OData. Consulte Crear una aplicación de consultas fijas para obtener más información.

Para determinar el tipo de consulta que admite un conjunto de datos, consulte la sección Determinar el tipo de consulta a continuación.

Antes de continuar, asegúrese de disponer de lo siguiente:

  • Una cuenta Windows Live ID válida. Si no dispone de un Live ID, vaya a la página de inicio de Windows Live y regístrese.

  • Una cuenta de Marketplace válida. Si no dispone de una cuenta de Marketplace, vaya a Crear la cuenta de Marketplace y siga las instrucciones que se indican.

  • Una suscripción al conjunto de datos Data.gov 2006-2008 Crime in the United States. Si no se ha suscrito a ningún conjunto de datos, vaya a Suscribirse a una oferta de datos y siga las instrucciones que se indican.

 

Sección Descripción

Ejemplos de URI

Ejemplos de URI de consultas flexibles y consultas fijas.

Determinar el tipo de consulta

Pasos que se deben llevar a cabo para determinar si un conjunto de datos admite consultas flexibles o fijas.

 

URI Descripción de URI

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

Consulta flexible para obtener acceso a los datos de informes de ventas de Contoso, Ltd. para Norteamérica.

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

Consulta flexible para obtener acceso a los datos de informes de ventas de Contoso, Ltd.
Dado que no se especificó ningún parámetro, el conjunto de resultados no está filtrado y la consulta devuelve todos los informes de ventas almacenados en el sistema.

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

Consulta fija sin parámetros obligatorios para obtener acceso a los datos de censo más recientes del servicio A. Datum, Inc.

La llamada a GetCensusData es el método de acceso a datos en la clase de servicio C# descargada que proporciona Marketplace.

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

Consulta fija con un parámetro obligatorio para obtener acceso a datos específicos de saldo de cuenta del servicio de Marketplace de The Phone Company.
Si el par de nombre y valor del parámetro obligatorio no se proporciona, la consulta no se realiza correctamente.

La llamada a GetAccountBalance es el método de acceso a datos en la clase de servicio C# descargada que proporciona Marketplace.

ImportantImportante
Una consulta flexible sin parámetros devuelve un conjunto de resultados sin filtrar.
Una consulta fija con el número incorrecto de parámetros (insuficientes o demasiados) produce un error.

Para obtener más información sobre la creación de URI para consultar los servicios OData, consulte OData URI Conventions (URI de OData: convenciones) en OData.org.

Algunos conjuntos de datos permiten solo consultas fijas, consultas sin parámetros o con pares obligatorios de parámetro y valor. Otros conjuntos de datos permiten consultas flexibles, consultas que incluyen pares opcionales de parámetro y valor para filtrar el conjunto de resultados. Averigüe qué tipo de consulta requiere el conjunto de datos.

  1. Haga clic en la ficha My Data (Mis datos).

  2. Haga clic en Use (Usar) a la derecha del nombre del conjunto de datos que desea usar para la aplicación.

  3. Desplácese hacia abajo en la página, hasta las fichas debajo de la descripción del conjunto de datos.

  4. Haga clic en la ficha Details (Detalles).

  5. Busque la línea de texto debajo de la dirección URL raíz del servicio que indica el tipo de consulta. Este ejemplo corresponde a una consulta flexible.


    Figura 1: tipo de consulta

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft