Introducción a REST con SharePoint
Antes de comenzar, para que quienes no conocen SharePoint les hago una pequeña introducción:
SharePoint es una plataforma de colaboración en donde equipos de trabajo pueden interartuar compartiendo documentos, automatizando flujos de trabajo, utilizando sitios de trabajo, así como utilizar herramientas de colaboración como wikis, blogs, foros, listas de información, etc. Es una plataforma muy utilizada en entornos empresariales, especialista para la creación de sitios de proyecto en donde los equipos de trabajo comparten información, y también para la automatización de cualquier proceso de negocio de la empresa, a través de flujos de trabajo.
Ya conociendo un aspecto básico de la plataforma, es muy común que la información cargada en esta plataforma pueda ser consumida por otras plataformas, para lo cual podemos tener un siguiente escenario:
“Tener una biblioteca documental en SharePoint con documentos de la empresa y queremos acceder a ella a través de un aplicativo web en cualquier plataforma, como por ejemplo java o php”.
Teniendo este escenario, podemos pensar en construir servicios web que se integren, en este caso no será necesario.
Ya que la plataforma SharePoint ya tiene implementado una arquitectura REST el cual te permite acceder, modificar, eliminar cualquier tipo de objeto que se encuentre dentro de un sitio SharePoint, y pone a disposición de desarrolladores una forma simple de integrar aplicaciones.
Arquitectura REST en SharePoint.
En SharePoint podemos obtener acceso a los métodos CRUD de los objetos, para tener una referencia se muestra la siguiente imagen
¿Y cómo accedemos a la información desde un sitio de SharePoint ?
Podemos utilizar el siguiente modelo para consultar cualquier tipo de información.
Aquí un ejemplo de un sitio en SharePoint que muestra una biblioteca documental con contenido
A esta biblioteca documental, gracias a la implementación que pone a disposición de la plataforma SharePoint, podemos acceder a su información en formato JSON o XML de la siguiente forma.
- Caso : Listar todos los elementos de la biblioteca Oportunidades.
- URL : HTTP://nombredelsitio/lists/getbytitle(‘listname’)/items
- En nuestro caso sería: https://visionitpe.sharepoint.com/sites/CRM/_api/web/lists/getbytitle(‘Oportunidades’)/items
- En nuestro caso listaría en formato JSON o XML todos los elementos de la biblioteca.
Espero les sea de utilidad.
Referencias:
- https://msdn.microsoft.com/es-es/library/office/fp142380.aspx
- https://msdn.microsoft.com/en-us/library/office/jj164022.aspx