Inherits Cloud

Loving Microsoft Cloud, specially Office 365

Etiqueta: Office365

[SPFx] Extendiendo Gulp y ejecutando tareas en serie (o en paralelo)

Como seguramente ya sabréis, el nuevo SharePoint framework hace uso de Gulp para todas las tareas de “compilación”: bundle de archivos JavaScript, generar el package file, etc. Sin embargo, a la hora de crear tus propias tareas de Gulp, no sigue el mecanismo “normal” de Gulp, por lo que no podemos simplemente agregar una nueva “Task” en el “Gulpfile.js”:

image

Para agregar una tarea de Gulp personalizada, tenemos que pasar por el sistema propio de build, y que está definido en el package “@microsoft/sp-build-web

image

image

El objeto build, nos permite llamar a una función “task” y pasar la definición de nuestra tarea. Sería un esqueleto parecido a:

image

Digamos sin embargo, que lo que nos interesa es ejecutar un par de Tasks, pero hacerlo de forma secuencial. Entonces, tenemos que usar las función “serial” del mismo objeto build. El siguiente snippet de codigo ejecuta las tareas “task-1” y “task-2” conjuntas, y de forma secuencial:

Si ejecutamos la tarea, vemos como el resultado es el esperado:

Si lo que nos interesa es ejecutar las tareas en paralelo, el mecanismo es identico, pero utilizando la funcion, “parallel” del objecto build.

Espero que os sirva!

@Luismanez

PnP Provisioning Extensibility Handler para configurar Search Navigation

Desde una de las ultimas release del PnP, ya es posible configurar la Navigation de un site, tanto Estructural, como Managed:

image

Sin embargo, sigue sin poder configurarse la navegación del Search.

image

Para ello podemos crear nuestro propio Provisioning Extensibility Handler.

Primero de todo, veamos como utilizar el Provider desde una template del PnP:

image

Como vemos, estamos definiendo nuestro propio XML para definir los diferentes Search links que queremos provisionar en nuestro site. Además, le decimos al PnP que clase queremos utilizar como custom Provisioning Handler.

Ahora definamos la clase que implementa la interfaz del PnP IProvisioningExtensibilityHandler

image

Como vemos estamos implementando el método Provision, donde lo que hacemos es, primero, deserializar el XML que viene de la template, y lo convertimos a un objeto de negocio SearchNavigation. Esta es una clase custom también, y que definimos como:

image

Para la deserializacion tenemos el siguiente codigo:

image

Finalmente, y haciendo uso de una extension del propio PnP Core que nos permite insertar links a la Search Navigation, tenemos el siguiente código:

image

De esta manera podemos configurar la navegación del search desde una template del PnP.

Espero que os sirva.

 

@luismanez

Provisionando XsltListViewWebPart especificando la View usando el PnP

Todo el merito de este post es para el autor de esta PR del PnP Core, pero lo copio aquí porque me ha parecido muy útil y no quiero perderlo.

https://github.com/SharePoint/PnP-Sites-Core/issues/584

El framework de provisioning del PnP nos permite provisionar un XsltListViewWebPart en cualquier pagina. Sin embargo, hasta hace poco siempre era un problema el querer aplicar una vista especifica para el Webpart provisionado, en realidad no estaba soportado, y habia que hacer algo custom. Yo ya trate con algo así en mi ejemplo del PnP para provisionar Publishing Pages usando un Extensibility Provider, asi que se que es bastante infierno. Por suerte, ahora ya lo podemos hacer directamente con el PnP-Core.

El gran Mikael Svenson explica como hacerlo en este post: https://techcommunity.microsoft.com/t5/SharePoint-Developer/Specify-view-for-XsltListViewWebPart-using-PnP-Provisioning/m-p/37612#M1148

Basicamente, basta con añadir cualquiera de estos parámetros:

  • ViewId (guid of view)
  • ViewGuid (guid of view)
  • ViewName (display name of view)
  • ViewUrl (server relative url of view)

Por ejemplo:

<property name=”ViewName” type=”string”>Sales reports</property>

Espero que os sirva.

@luismanez

SharePoint / Office Dev Patterns & Practices – Liberada la Release de Enero 2017

Como supongo sabréis, soy gran fan del programa SharePoint PnP, así que quería haceros eco de la versión de Enero 2017. Tenéis toda la información detallada en el blog oficial:

 

https://dev.office.com/blogs/pnp-january-2017-release

 

Algunas de las novedades que a mi me parecen mas destacadas:

 

  • Diferentes fixes dentro del framwork de Provisioning
  • Nuevo ejemplo del SP Framework de como llamar a una custom WebAPI securizada con Azure AD desde un webpart del SPFx
  • Posibilidad de exportar la navegacion estructural para sitios de no-publishing
  • PnP JS library usa ahora webpack para el bundle a pnp.min.js
  • Nuevos comandos PowerShell para tratar con la RecycleBin
  • Nuevo comando PowerShell para añadir Image Renditions: Add-PnPPublishiningImageRendition

 

Y entre todas las novedades, este nuevo ejemplo me ha parecido muy interesante react-generic-app ya que muestra como usar el “modern web stack” sin utilizar el nuevo Framework, muy interesante ahora mismo si tienes que empezar un proyecto de SharePoint On Premises.

Nada mas, os animo a descargar la ultima version y empezar a utilizarlo.

 

Saludos!

 

@luismanez

Provisionando Image Renditions con PnP Core y PnP Schema

Una duda bastante recurrente alrededor del framework PnP, es si podemos desplegar/provisionar Image Renditions desde el PnP. La respuesta es si (no hay opción de desplegar una Rendition en concreto, pero podemos usar un “workaround” para desplegar todas las Renditions que necesitemos).

Internamente, cuando se define una Image Rendition en SharePoint, este, simplemente crea un nuevo nodo en un fichero XML, que podéis encontrar en la Master Page Gallery. El nombre del fichero es: PublishingImageRenditions.xml y su contenido es algo como:

 

image

 

Básicamente tenemos un nodo ImageRendition por cada Rendition que queremos definir, con Ancho y Alto de la Rendition.

 

Nota: Cuidado con el nodo NextId, ya que si editamos el fichero a mano, tendremos que darle el valor adecuado, que no es otro que el siguiente ID a asignar en caso de que se agregue posteriormente otra Rendition desde la interfaz de SharePoint.

 

Teniendo en cuenta que las renditions se gestionan desde este fichero, y que el PnP tiene la opción de provisionar ficheros a bibliotecas de SharePoint, el siguiente paso es hacer uso del nodo File dentro del PnP Schema, para desplegar este fichero XML en la Master Page Gallery, para ello, podemos usar el siguiente snippet XML:

 

image

 

El atributo Src define la ubicacion local del fichero, mientras que Folder define la ubicación en SharePoint (en este caso hacemos uso del token ~masterpagecatalog, que el PnP resolvera cuando se aplique la template). Ademas, debemos de especificar el Tipo de Contenido del fichero, que para el caso del fichero de Renditions, es el ID: 0x01010012BCF119622FF14793A8A38D5831F25C.

 

Con todo esto en nuestra PnP template, podremos provisionar nuestras Images Renditions.

 

Espero que os sirva!

 

@luismanez

© 2017 Inherits Cloud

Tema por Anders NorenArriba ↑