Interfaz de REST de SharePoint Foundation

Última modificación: miércoles, 01 de diciembre de 2010

Hace referencia a: SharePoint Foundation 2010

Disponible en SharePoint Online

La nueva interfaz de transferencia de estado de representación (REST) en Microsoft SharePoint Foundation 2010 proporciona acceso a las listas y bibliotecas como un servicio de datos relacionales. Un concepto básico de cualquier interfaz de REST es el recurso; en SharePoint Foundation, las listas y elementos se representan como recursos HTTP a los que se puede tener acceso mediante direcciones URL remotas.

Las operaciones en la interfaz de REST de SharePoint Foundation constituyen un conjunto estándar de operaciones para servicios web con REST. Las operaciones de lectura, creación, actualización y eliminación se asignan directamente a verbos GET, POST, PUT y DELETE HTTP. Esto elimina la necesidad de tener capas intermedias entre el cliente y el servidor, y resulta útil para la interoperabilidad ya que permite que las aplicaciones de otras plataformas se conecten fácilmente a SharePoint Foundation. La interoperabilidad es una de las ventajas de la nueva interfaz de REST de SharePoint Foundation, pero esta interfaz también proporciona una gran experiencia de desarrollo a través de la integración con los servicios de datos de ADO.NET, en los que se basa.

La interfaz de REST usa convenciones flexibles de direcciones URL para consultar datos, lo que permite filtrar, ordenar y seleccionar información de listas de SharePoint Foundation directamente desde el explorador. También se puede recuperar información de las listas de SharePoint Foundation mediante varias representaciones, incluida la compatibilidad con estándares de AtomPub, Atom y la notación de objetos JavaScript (JSON). Las representaciones estándar para las listas de SharePoint Foundation hacen que los datos de la lista estén disponibles para los clientes conforme a los estándares, desde lectores de fuente Atom sencillos hasta clientes más avanzados que permiten a los usuarios finales analizar grandes cantidades de datos en Microsoft Excel. Las características avanzadas de los servicios de datos de ADO.NET también son compatibles con la interfaz de REST de SharePoint Foundation, como el procesamiento por lotes de varias operaciones en una única solicitud, el control de simultaneidad a través de HTTP ETags, la paginación de grandes conjuntos de datos y el acceso a secuencias de documentos en bibliotecas de documentos de SharePoint.

La siguiente tabla muestra direcciones URL de ejemplo que implementan la interfaz de REST.

Dirección URL

Descripción

http://myserver/_vti_bin/ListData.svc

La escritura de la dirección URL del servicio de REST devuelve un documento de servicio Atom estándar que describe las colecciones de información que están disponibles en el sitio de SharePoint Foundation.

http://myserver/_vti_bin/ListData.svc/Projects

La escritura de un nombre después de la dirección URL del servicio devuelve datos de lista de SharePoint Foundation en formato XML como una fuente Atom estándar que contiene entradas para cada elemento de lista y las propiedades de cada uno, así como propiedades de navegación representadas como vínculos Atom. Las propiedades de navegación representan relaciones con otras listas de SharePoint Foundation formadas mediante columnas de búsqueda.

http://myserver/_vti_bin/ListData.svc/$metadata

La interfaz de SharePoint Foundation devuelve el XML del modelo de datos de entidad que describe los tipos de entidad para cada lista en el sitio web.

http://lsspf4719/sites/TestWebs/_vti_bin/listdata.svc/Employees(2)

Devuelve el elemento de lista especificado por identificador (2) como una fuente Atom con una entrada que corresponde al elemento solicitado.

http://lsspf4719/sites/TestWebs/_vti_bin/listdata.svc/Employees?$orderby=Name

Ordena la fuente Atom por nombre.

http://lsspf4719/sites/TestWebs/_vti_bin/listdata.svc/Employees?$filter=Project/Title eq 'My Project Title'

Usa una propiedad de navegación para filtrar la lista por título de un proyecto relacionado.

Al aprovechar las nuevas funciones del almacén de datos de SharePoint Foundation, las consultas de REST proporcionan un mecanismo flexible para trabajar con datos de lista de SharePoint Foundation en formato XML, y cualquier aplicación que puede enviar direcciones URL de REST a SharePoint Foundation puede recuperar sus datos de lista. Por ejemplo, la interfaz de REST usa la nueva característica de uniones de listas, de modo que cuando SharePoint Foundation recibe una consulta de servicios de datos de ADO.NET que implementa la característica de uniones, la consulta se traduce en una consulta de Lenguaje de marcado de aplicaciones de colaboración (CAML) nativa.

Vea también

Conceptos

Consultas a SharePoint Foundation con los servicios de datos de ADO.NET

Combinaciones de lista y proyecciones

Otros recursos

WCF REST Programming Model