{"id":1404,"date":"2014-10-21T12:00:10","date_gmt":"2014-10-21T11:00:10","guid":{"rendered":"http:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/?p=1404"},"modified":"2014-10-21T12:05:36","modified_gmt":"2014-10-21T11:05:36","slug":"aprovisionar-paginas-de-publicacion-de-forma-declarativa","status":"publish","type":"post","link":"https:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/aprovisionar-paginas-de-publicacion-de-forma-declarativa\/","title":{"rendered":"Aprovisionar P\u00e1ginas de Publicaci\u00f3n de forma declarativa"},"content":{"rendered":"

Uno de los grandes problemas que nos encontramos a la hora de abordar un proyecto en SharePoint es la forma en la que vamos a desplegar nuestro desarrollo en los distintos entornos posibles<\/strong> (Integraci\u00f3n, PRE y PRO). Uno de los aspectos m\u00e1s complicados es c\u00f3mo vamos a aprovisionar las p\u00e1ginas de nuestro site. Pero dependiendo del tipo de proyecto en el que estemos trabajando, lo realizaremos de una forma u otra. En este post de hoy, vamos a abordar c\u00f3mo realizar el aprovisionamiento de las p\u00e1ginas de publicaci\u00f3n<\/em>.<\/p>\n

Caracter\u00edsticas de la p\u00e1ginas de publicaci\u00f3n<\/h2>\n

La principal diferencia<\/strong> de este tipo de p\u00e1gina respecto con una p\u00e1gina de colaboraci\u00f3n es que, en este caso, a la p\u00e1gina le tenemos que asignar un PageLayout basado en un tipo de Contenido. Este PageLayout puede ser implementado por nosotros o estar por defecto en nuestro Site. Dependiendo de este aspecto lo realizaremos de una forma u otra.
\n<\/p>\n

Posibilidades de Aprovisionamiento<\/h2>\n

Disponemos de tres formas<\/strong> de crear las p\u00e1ginas:<\/p>\n

    \n
  1. Mediante desarrollo:<\/strong> SharePoint tiene una API muy completa que permite realizar cualquier cosa. La principal desventaja es que es relativamente costoso y engorroso de\u00a0mantener todo esto en c\u00f3digo.<\/li>\n
  2. Mediante M\u00f3dulos<\/strong> (de forma declarativa).<\/li>\n
  3. Haciendo uso de la interfaz :<\/strong> Esta opci\u00f3n NO deber\u00eda realizarse bajo ning\u00fan concepto.<\/li>\n<\/ol>\n

     <\/p>\n

    Mediante desarrollo\u00a0<\/strong><\/h3>\n

    No es la funci\u00f3n de este post entrar en detalle en c\u00f3mo realizarlo mediante desarrollo, pero os dejamos un ejemplo de c\u00f3mo se puede abordar mediante esta soluci\u00f3n:<\/p>\n

    \r\nrivate void ProvisionPage(\r\nPublishingWeb publishingWeb,\r\nstring pageLayoutName,\r\nstring pageTitle,\r\nstring pageDescription,\r\nstring pageFileName)\r\n{\r\nPageLayout[] layouts = publishingWeb.GetAvailablePageLayouts();\r\n\/\/ Name Values of Content Types of Publishing Site\r\nDictionary<string, PageLayout> pageLayouts = new Dictionary<string, PageLayout>();\r\nforeach (PageLayout item in layouts)\r\n{\r\nstring cID = item.Title.ToString();\r\nstring name = item.Name;\r\npageLayouts.Add(cID, item);\r\n}\r\n\r\nPageLayout layout = pageLayouts[pageLayoutName];\r\nif (!PageExists(publishingWeb, pageFileName))\r\n{\r\nPublishingPage newPage2 = publishingWeb.GetPublishingPages().Add(pageFileName, layout);\r\nnewPage2.Description = pageDescription;\r\nnewPage2.Title = pageTitle;\r\nnewPage2.Update();\r\n\r\nSPFile pageFile = newPage2.ListItem.File;\r\nif (pageFile.CheckOutStatus != SPFile.SPCheckOutStatus.None)\r\n{\r\npageFile.CheckIn(\u201cChecked in on feature activation.\u201d);\r\npageFile.Publish(\u201cPublished on feature activation.\u201d);\r\n}\r\n}\r\n}\r\n<\/pre>\n
     <\/p>\n
    Mediante un M\u00f3dulo<\/h3>\n
    \u00bfQu\u00e9 es un m\u00f3dulo?<\/em> Un m\u00f3dulo es un tipo de artefacto que podemos utilizar dentro de la soluci\u00f3n de SharePoint, cuyo funcionamiento es dejar alojados los ficheros que se encuentran dentro de este modulo en una ubicaci\u00f3n f\u00edsica de SharePoint. Pero, adem\u00e1s de desplegar los ficheros f\u00edsicos, tambi\u00e9n es posible a\u00f1adirle par\u00e1metros de configuraci\u00f3n.
    \nUn m\u00f3dulo lo utilizaremos para desplegar desde masterpage, pagelayouts, display templates hasta los ficheros css, js, im\u00e1genes, etc… que se va a utilizar en nuestro desarrollo.<\/p>\n
    Ahora bien, \u00bfc\u00f3mo aprovisionamos una p\u00e1gina de publicaci\u00f3n? Tenemos dos casos<\/strong>:<\/p>\n
      \n
    1. Hacemos uso de un PageLayout desarrollado por nosotros mismos.<\/li>\n
    2. Hacemos uso de un PageLayout por defecto de SharePoint<\/li>\n<\/ol>\n
       <\/p>\n
      Hacemos uso de un PageLayout desarrollado por nosotros\u00a0<\/em><\/h4>\n
      En primer lugar tendremos que tener un Modulo donde indiquemos el despliegue de este PageLayout.<\/p>\n
      OJO!!\u00a0<\/strong>Este PageLayout debe desplegarse antes que nuestra p\u00e1gina. Lo podemos comprobar observando el orden de despliegue de los artefactos que hay en nuestra soluci\u00f3n.
      \n\"OrdenFeatures\"<\/p>\n
       <\/p>\n
      El siguiente paso a realizar es crearnos un Modulo de P\u00e1ginas<\/strong>, donde tendremos que a\u00f1adir un XML similar al siguiente dentro del fichero Elements.xml<\/p>\n
      \r\n?xml version="1.0" encoding="utf-8"?>\r\n<Elements xmlns="http:\/\/schemas.microsoft.com\/sharepoint\/">\r\n  <Module Name="Pages" Url="$Resources:cmscore,List_Pages_UrlName;" >\r\n    <File Path="PageLayouts\\NuestroPageLayout.aspx" Url="Home.aspx" Type="GhostableInLibrary" ReplaceContent="TRUE" IgnoreIfAlreadyExists="TRUE">\r\n      <Property Name="Title" Value="P\u00e1gina de Inicio"\/>\r\n      <Property Name="PublishingPageLayout" Value="~SiteCollection\/_catalogs\/masterpage\/NuestroPageLayout.aspx, P\u00e1gina de inicio"\/>\r\n      <Property Name="ContentTypeId" Value="0x010100C568DB52D9D0A14D9B2FDCC96666E9F2007948130EC3DB064584E219954237AF390064DEA0F50FC8C147B0B6EA0636C4A7D4" \/>\r\n    <\/File>\r\n  <\/Module>\r\n<\/Elements>\r\n<\/pre>\n
       <\/p>\n
      Aspectos<\/strong> que debemos de conocer de este XML<\/strong> :<\/p>\n