Muy buenas a todos,
Hace unos meses, escribí acerca del nuevo modelo de desarrollo para SharePoint OnLine y SharePoint OnPremises propuesto por Microsoft e incluso una de mis colaboraciones en CompartiMOSS giró en torno a este tema.
Nuevo modelo de desarrollo de Sharepoint. Adaptando nuestras soluciones de granja
Número #24 de CompartiMOSS y nueva colaboración con la revista
Como ya decía en aquella ocasión, trabajar con las API cliente se podría hacer tanto por medio de la API REST, con la API CSOM o JSOM o incluso PowerShell. Tenía muchas ganas de ver cómo se podría trabajar con éste último y para un proyecto en el que estoy trabajando recientemente decidí que ya era el momento.
La primera intención, fue desarrollar mis propios Cmdlets o mis propios Scripts con funciones para realizar las distintas operaciones que fuese necesitando. Finalmente decidí previamente indagar por la cuenta de GitHub de OfficeDev/Pnp, donde encontré un gran trabajo especifico sobre PowerShell, proporcionando una gran cantidad de Cmdlets desarrollados que permiten trabajar con las API Cliente, concretamente CSOM, y PowerShell. Por supuesto, trabajo que decidí utilizar, y que os recomiendo a todos.
https://github.com/OfficeDev/PnP-powershell
En el artículo de hoy, os quiero mostrar cómo instalar y configurar en nuestro servidor estos Cmdlets y cómo se pueden usar algunos de ellos a modo de ejemplo. No obstante, en la página de Pnp hay una documentación muy buena sobre todas las opciones de que disponemos.
Instalando los Cmdlets en el servidor
Para poder tener disponibles todos los Cmdlets de PowerShell tendremos que seguir los siguientes pasos:
1.- En primer lugar descargar el proyecto Visual Studio desde la cuenta de GitHub de OfficeDev/Pnp-PowerShell.
2.- Para poder instalar el proyecto, es necesario descargar e instalar las WiX Tools en nuestro equipo.
3.- A continuación abrimos la solución que descargamos anteriormente y para poder crear la solución, necesitamos agregar dos paquetes desde Nugets. El primero de ellos es el OfficeDev Core para SharePoint Online o OnPremises, en función de para qué lo vayamos a usar.
4.- El siguiente paquete es la librería ADAL para la autenticación.
5.- Tras esto ya se puede hacer el build del proyecto lo cual dejará instalados los Cmdlets en nuestro equipo
Si ahora abrimos por ejemplo el IDE de PowerShell, en la lista de comandos disponibles, si ponemos en el cajón de búsqueda SPO, filtrará todos los comandos que se han añadido.
Usando los nuevo Cmdlets
A continuación voy a mostrar un breve ejemplo de cómo podríamos usar los nuevos Cmdlets con PowerShell.
Connect-SPOnline -Url $url -Credentials (Get-Credential) Add-SPOField -DisplayName "Example" -InternalName "Example" -Group "ExampleSPO" -Type Integer Add-SPOField -DisplayName "Example1" -InternalName "Example1" -Group "ExampleSPO" -Type Text Add-SPOField -DisplayName "Example2" -InternalName "Example2" -Group "ExampleSPO" -Type Choice -Choices "uno","dos","tres" Add-SPOContentType -Name "ContentTypeExample" -Description "Description to Content Type" -Group "ExampleSPO" Add-SPOFieldToContentType -Field "Example" -ContentType "ContentTypeExample" Add-SPOFieldToContentType -Field "Example1" -ContentType "ContentTypeExample" Add-SPOFieldToContentType -Field "Example2" -ContentType "ContentTypeExample" New-SPOList -Title "List Title" -Template GenericList -EnableContentTypes Add-SPOContentTypeToList -List "List Title" -ContentType "ContentTypeExample" -DefaultContentType
En el código de ejemplo se muestra cómo conectarse a un sitio de SharePoint OnLine, crear columnas de sitio, un tipo de contenido y asociarlo a una lista que se ha creado previamente.
Y esto es todo por hoy, por si aún no lo conocíais, espero que os sea de utilidad y que en la medida de lo posible, podáis usarlo en vuestros proyectos.
Hasta la próxima.
El Blog del Programador 