Tutorial: Importación de una página maestra personalizada y una página de sitio con una imagen

  • Artículo

En este tutorial, se muestra cómo importar una página maestra personalizada de SharePoint y una página de sitio que tenga una imagen en un proyecto de SharePoint de Visual Studio.

En este tutorial se muestra cómo llevar a cabo las tareas siguientes:

  • Crear una página maestra personalizada y una página de sitio mediante una imagen en SharePoint Designer.

  • Exportar una página maestra personalizada, una imagen y una página de sitio a un archivo de solución de SharePoint (.wsp).

  • Importar e implementar el archivo .wsp en un proyecto de SharePoint de Visual Studio mediante el proyecto Paquete de importación de la solución de SharePoint.

    Nota:

    Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Prerrequisitos

Necesita los componentes siguientes para completar este tutorial:

  • Ediciones compatibles de Microsoft Windows y SharePoint.

  • Visual Studio.

  • SharePoint Designer 2010.

Creación de elementos en SharePoint Designer

En este ejemplo se muestra cómo crear tres elementos en SharePoint Designer para su exportación: una página maestra personalizada, una página de sitio que hace referencia a la página maestra personalizada y un archivo de imagen para que aparezca en la página de sitio. La imagen se agrega a la carpeta /images/ de SharePoint.

Instrucciones para la creación de una página maestra personalizada en SharePoint Designer

  1. En SharePoint Designer, en el panel Navegación, seleccione el objeto de sitio Páginas maestras.

  2. En la cinta Páginas maestras, seleccione Página principal en blanco.

  3. Seleccione la página maestra nueva y, después, en la cinta Páginas maestras, seleccione Editar archivo.

  4. En la parte inferior de SharePoint Designer, seleccione la pestaña Código.

  5. Reemplace el marcado existente por el siguiente.

    <%@ Master Language="C#" %>
<%@ Register tagprefix="SharePoint" namespace="Microsoft.SharePoint.WebControls" assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<html dir="ltr">
<head runat="server">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<SharePoint:RobotsMetaTag runat="server" __designer:Preview="" __designer:Values="<P N='InDesign' T='False' /><P N='ID' T='ctl00' /><P N='Page' ID='1' /><P N='TemplateControl' ID='2' /><P N='AppRelativeTemplateSourceDirectory' R='-1' />"></SharePoint:RobotsMetaTag>
<title>Web Page</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ContentPlaceHolder id="ContentPlaceHolderMain"
        runat="server">
      </asp:ContentPlaceHolder>
</form>
</body>
</html>

  6. Guarde la página, seleccione la pestaña Páginas maestras y cambie el nombre de la página maestra a mybasic1.master.

Adición de una imagen a la base de datos de contenido en SharePoint Designer

Ahora puede agregar una imagen para mostrarla en la página de sitio. La imagen se implementa en la base de datos de contenido de SharePoint.

Instrucciones para la adición de una imagen a la base de datos de contenido en SharePoint Designer

  1. En el panel Navegación, seleccione el objeto de sitio Todos los archivos y, después, en la vista de árbol, elija la carpeta images.

  2. En la cinta Todos los archivos, seleccione Importar archivos, escoja un archivo de su elección y, después, seleccione el botón Aceptar. En este ejemplo, el archivo se denomina myimg1.png.

    Opcionalmente, puede crear una subcarpeta para ayudar a organizar las imágenes.

  3. Cierre el cuadro de diálogo Importar.

Creación de una página de sitio

Esta página de sitio básica usa la página maestra personalizada y muestra la imagen que agregó en el paso anterior.

Instrucciones para la creación de una página de sitio

  1. En el panel Navegación, seleccione el objeto Páginas de sitio.

  2. En la cinta Páginas, seleccione el botón Página, seleccione el tipo de página ASPX y, después, asigne el nombre mycontentpage1.aspx al nuevo archivo.

    Opcionalmente, puede crear una subcarpeta para ayudar a organizar las páginas de sitio.

  3. En la lista de páginas de sitio, seleccione MyContentPage1.aspx para abrir su página de propiedades y, después, en la parte inferior de la página, seleccione el vínculo Editar archivo.

    Si aparece un mensaje y dice que esta página no contiene ninguna región que se pueda editar en modo seguro y pregunta si desea abrir esta página en modo avanzado, seleccione el botón Sí.

  4. En la parte inferior de la página, seleccione el botón Código.

  5. Reemplace el marcado existente por el siguiente.

    <%@ Import Namespace="Microsoft.SharePoint.ApplicationPages" %>
<%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register Tagprefix="Utilities" Namespace="Microsoft.SharePoint.Utilities" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register Tagprefix="asp" Namespace="System.Web.UI" Assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" %>
<%@ Import Namespace="Microsoft.SharePoint" %>
<%@ Assembly Name="Microsoft.Web.CommandUI, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Page Language="C#" Inherits="Microsoft.SharePoint.WebControls.LayoutsPageBase" MasterPageFile="../_catalogs/masterpage/mybasic1.master" meta:progid="SharePoint.WebPartPage.Document" %>

<asp:Content ID="Main" ContentPlaceHolderID="ContentPlaceHolderMain" runat="server">
<img alt="My Image" longdesc="My image from images folder" src="../images/myimg1.png" />
</asp:Content>

  6. Guarde la página de sitio actualizada.

Exportación de los elementos de SharePoint

Exporte los elementos de SharePoint a un archivo de solución de SharePoint (.wsp).

Instrucciones para la exportación de elementos desde SharePoint Designer

  1. En SharePoint Designer, en el panel Navegación, seleccione el objeto Sitio de grupo y, después, en la cinta Sitio, seleccione Guardar como plantilla.

  2. En el cuadro de diálogo Guardar como plantilla, escriba un nombre de archivo y un nombre de plantilla, active la casilla Incluir contenido y, después, seleccione el botón Aceptar.

    Esta acción guarda el contenido del sitio en el archivo .wsp.

  3. Después de exportar la solución, seleccione el vínculo Galería de soluciones para mostrar la lista de archivos de solución disponibles.

  4. Abra el menú contextual del archivo .wsp nuevo y, después, elija Guardar destino como para guardarlo en el sistema.

Importación de elementos en Visual Studio

Importe el archivo .wsp en Visual Studio. Después de importar el contenido, puede personalizarlo, agregar más elementos y, después, implementarlo.

Instrucciones para la importación de elementos desde el archivo .wsp a Visual Studio

  1. En Visual Studio, cree un proyecto Paquete de importación de la solución de SharePoint 2010.

  2. En la página Seleccione los elementos que desea importar, en Módulo de la columna Tipo, active solo las casillas para los archivos de la tabla siguiente para la importación.

    Nombre de archivo Descripción
    _catalogsmasterpage_ Página maestra personalizada.
    images_ Archivo de imagen en el sistema de archivos de SharePoint.
    SitePages_ Página de sitio.

  3. Seleccione el botón Finalizar para importar los elementos seleccionados.

  4. En Explorador de soluciones, seleccione el nodo _catalogsmasterpage_ y establezca el valor de su propiedad Resolución de conflictos de implementación en Automático.

    Esta acción ayuda a garantizar que los conflictos de implementación se resolverán de forma automática.

  5. Si la página maestra nueva tiene el mismo nombre que una página existente, asegúrese de que la página existente no está marcada como Página principal predeterminada o Página principal personalizada en SharePoint Designer.

    Si una página maestra existente está marcada como Página principal predeterminada o Página principal personalizada, obtendrá un error de implementación que indica que no se puede eliminar la página maestra. Para evitar este problema, haga lo siguiente:

    • Si la página maestra existente se establece como Página principal predeterminada, establezca temporalmente otra página maestra como Página principal predeterminada. Después de implementar los archivos en SharePoint, establezca la página maestra nueva como Página principal predeterminada.

    • Si la página maestra existente se establece como Página principal personalizada, establezca temporalmente otra página maestra como Página principal personalizada. Después de implementar los archivos en SharePoint, establezca la página maestra nueva como Página principal personalizada.

  6. En la barra de menús, seleccione Compilar>Implementar solución.

  7. Abra el sitio de SharePoint para ver los elementos implementados.

    Una forma alternativa de importar archivos en Visual Studio e implementarlos en SharePoint es agregar los archivos a módulos en Visual Studio. Para obtener más información, consulte Cómo: Importar una página maestra o un tema y Uso de módulos para incluir archivos en la solución.

Contenido relacionado