Desarrollar soluciones de SharePoint

  • Artículo

En Visual Studio están disponibles varias plantillas de tipo de proyecto de SharePoint para crear sitios y elementos de sitio de SharePoint. Para obtener una lista de los tipos de proyectos disponibles, vea Plantillas de proyecto y de elementos de proyecto de SharePoint. A continuación se ofrece una descripción de los elementos y las propiedades de un proyecto de SharePoint.

Para obtener información sobre los complementos de SharePoint, vea Creación de complementos de SharePoint.

Elementos de un proyecto de SharePoint

Los nodos de un proyecto SharePoint se conocen como elementos de SharePoint. Los elementos de SharePoint pueden contener uno o varios archivos secundarios, a los que se denomina archivos de elementos de SharePoint, como los archivos de configuración XML, los formularios .aspx, etc.

En lugar de crear los proyectos utilizando plantillas de proyecto que se rellenan con archivos de elementos de proyecto, puede utilizar la plantilla Proyecto vacío para crear un proyecto de SharePoint vacío y, a continuación, agregar los elementos de proyecto manualmente. Opcionalmente, los proyectos de SharePoint también pueden contener uno o más archivos de características (para la activación en SharePoint) y un archivo empaquetado en el que distribuir el proyecto.

Nodos especiales

Cada proyecto de SharePoint contiene dos nodos a los que no se pueden cambiar el nombre, eliminar, cortar, copiar ni arrastrar del proyecto. Estos nodos son los siguientes:

  • Características

  • Paquete

    Ambos nodos aparecen en todos los proyectos SharePoint aun cuando no se hayan definido característica ni paquetes para el proyecto.

Nodo Características

El nodo Características contiene una o más características de proyecto de SharePoint. Una característica es un contenedor de extensiones para SharePoint. Una vez implementada la característica en el servidor de SharePoint, puede incluirse en las definiciones de sitios o los administradores de SharePoint pueden activarla individualmente en sitios de SharePoint. Para más información, vea Trabajar con características.

Al agregar un elemento, como un tipo de contenido o una instancia de lista, a un proyecto SharePoint, se agrega a una característica del nodo Características . El ámbito del elemento determina si se agrega a una característica nueva o existente. Si el nuevo elemento tiene el mismo ámbito que una característica existente, se agrega a esa característica. De lo contrario, se agrega a una nueva característica.

Para agregar una característica manualmente, ejecute el comando Agregar característica del menú contextual del nodo Características. Puede ver o cambiar el contenido de una característica utilizando el Diseñador de características. Para obtener más información, vea Cómo: para personalizar una característica de SharePoint.

Cuando una característica se agrega a un proyecto de SharePoint, aparece en el Explorador de soluciones como un nodo con el nombre predeterminado Featurex.feature, donde x es un número único. Una vez implementada en el servidor de SharePoint, un administrador de SharePoint puede activarla y ponerla a disposición de los usuarios del sitio de SharePoint.

Nodo Paquete

El nodo Paquete contiene un archivo único que actúa como el mecanismo de distribución para el proyecto de SharePoint. Este archivo, conocido como un paquete de solución, está basado en CAB con una extensión .WSP. Un paquete de solución es un archivo implementable y reutilizable que contiene un conjunto de características, definiciones del sitio y ensamblados que se aplican a los sitios de SharePoint y que es posible habilitar o deshabilitar individualmente. El nodo Paquete también contiene siempre un archivo que se denomina Package.wspdef, un archivo de definición XML para el paquete. Una vez que se implementa un paquete en el servidor que ejecuta SharePoint, el administrador de SharePoint puede instalarlo y activar sus características.

Puede ver o cambiar el contenido del paquete en el Diseñador de paquetes si hace doble clic en el nodo de paquete o abre su menú contextual y elige Abrir. Para obtener más información, vea Creación de paquetes de solución de SharePoint.

Propiedades de proyectos y elementos de proyecto de SharePoint

Los proyectos de SharePoint, al igual que otros proyectos de Visual Studio, muestran las propiedades en la ventana Propiedades y en la página Propiedades. Las propiedades que se muestran dependen del nodo que está seleccionado.

Cuando un proyecto, un elemento de proyecto o un nodo de archivo de elemento de proyecto de SharePoint se selecciona en el Explorador de soluciones, aparecen las siguientes propiedades en la ventana Propiedades o en la página del propiedades:

Propiedades de proyecto

Nombre de propiedad Descripción
Configuración de implementación activa Especifica la serie de pasos realizados durante la implementación. Para obtener más información, vea Cómo: para editar una configuración de implementación de SharePoint.
Destino de implementación del ensamblado Determina dónde se encuentran los ensamblados de aplicación de SharePoint . Los valores de ubicación de ensamblados válidos son GlobalAssemblyCache (valor predeterminado) o WebApplication.

Si la propiedad Sandboxed Solution está establecida en true, esta propiedad estará deshabilitada.
Retraer automáticamente después de depurar Especifica si la solución implementada se retrae automáticamente de SharePoint tras ejecutar la aplicación en modo de depuración en Visual Studio. Cuando está activada, la solución se retracta si el IDE vuelve a la Vista de diseño tras la depuración. Cuando está desactivada, la solución no se retrae. Para más información, vea Retracción de una solución.
Editar configuración Especifica la configuración de implementación que se va a usar en el proyecto. Para obtener más información, vea Cómo: para editar una configuración de implementación de SharePoint e Implementación, publicación y actualización de paquetes de solución de SharePoint.
Habilitar depuración de Silverlight (en lugar de depuración de script) Cuando está activada, el depurador de Silverlight se incorpora al proceso de depuración. Cuando está desactivada, el depurador de script se incorpora al proceso de depuración. Para más información, vea la información general sobre depuración de Silverlight.
Incluir ensamblado en paquete Especifica si el ensamblado del proyecto se empaqueta en tiempo de compilación o no.
Línea de comandos posterior a la implementación Especifica los comandos que se van a ejecutar después de implementar la solución de SharePoint. Esta línea admite los comandos de proceso por lotes así como la resolución de variables de MSBuild. Para obtener más información, consulta How to: Set SharePoint Deployment Commands.
Línea de comandos anterior a la implementación Especifica los comandos que se van a ejecutar antes de implementar la solución de SharePoint. Esta línea admite los comandos de proceso por lotes así como la resolución de variables de MSBuild. Para obtener más información, consulta How to: Set SharePoint Deployment Commands.
Archivo de proyecto Nombre del archivo que contiene la información sobre el proyecto, incluyendo el modo de compilación, la configuración y otros datos.
Carpeta de proyecto Ubicación del archivo de proyecto en el sistema. (Solo lectura).
Sandboxed Solution Especifica si el proyecto se debería implementar como una solución en espacio aislado, también conocida como solución creada por el usuario. Las soluciones en espacio aislado no son necesariamente de confianza. Un valor de true significa que el proyecto se implementa como una solución en un espacio aislado y un valor de false significa que el proyecto se implementa como una solución de granja. Para obtener más información, vea Sandboxed Solution Considerations y Differences Between Sandboxed and Farm Solutions.
Dirección URL del sitio Especifica la dirección URL del sitio de destino de este proyecto.
Elemento de inicio Especifica el primer elemento del proyecto que se va a ejecutar.

Cuando se elige un archivo de elemento de SharePoint (como un flujo de trabajo o una característica del nodo Características), las propiedades siguientes aparecen en la ventana Propiedades:

Propiedades de elementos de proyecto

Nombre de propiedad Descripción
Resolución de conflictos de implementación Especifica la acción que se realiza al implementar un elemento de proyecto cuyas propiedades son idénticas a las de un elemento que ya está en el servidor. Para obtener más información, consulta Troubleshooting SharePoint Packaging and Deployment.
Propiedades de características Especifica un conjunto de valores (almacenados como pares clave-valor) que se incluye con una característica cuando se implementa en SharePoint. Una vez implementada la característica, se puede obtener acceso a los valores de propiedad en el código. Para obtener más información, consulta Providing Packaging and Deployment Information in Project Items.
Receptor de características Proporciona código que se ejecuta cuando se producen determinados eventos con una característica de un elemento de proyecto. Para obtener más información, consulta Providing Packaging and Deployment Information in Project Items.
Nombre de carpeta Nombre de la carpeta de elementos de proyecto de SharePoint.
Referencias de salida del proyecto Especifica una dependencia, como un ensamblado, que el elemento de proyecto necesita ejecutar. Para obtener más información, consulta Providing Packaging and Deployment Information in Project Items.
Entradas de controles seguros Especifica controles que están seguros para que los usuarios los editen. Para obtener más información, consulta Providing Packaging and Deployment Information in Project Items.

Propiedades de archivos de elementos de proyecto

Nombre de propiedad Descripción
Acción de compilación Especifica cómo se relaciona el archivo con los procesos de implementación y compilación. Para más información, vea las propiedades del archivo.
Copiar en el directorio de salida Especifica si los archivos de origen se copiarán en el directorio de salida. Puede ser uno de los siguientes valores:

- No copiar
- Copiar siempre
- Copiar si es posterior

Para más información, vea las propiedades del archivo.
Herramienta personalizada Especifica el nombre de una herramienta, si existe, que transforma el archivo en tiempo de diseño y coloca la salida de la transformación en otro archivo. Por ejemplo, un archivo del conjunto de datos (.XSD) que tiene una herramienta personalizada predeterminada. Para más información, vea las propiedades del archivo.
Espacio de nombres de la herramienta personalizada Espacio de nombres en el que se copia la salida de la herramienta personalizada. Para más información, vea las propiedades del archivo.
Ubicación de implementación Ruta de acceso completa del archivo en el servidor de SharePoint. Esta ruta de acceso se compone de las subpropiedades Raíz de la implementación y Ruta de acceso de la implementación.
Ruta de acceso de la implementación Ruta de acceso relativa del archivo en el archivo del servidor de SharePoint Servidor, como Workflow1\. La ruta de acceso completa del archivo se crea concatenando el valor de Deployment Path al final del valor de Deployment Root .

Al seleccionar un valor de RootFile para la propiedad Tipo de implementación, se cambia la propiedad Raíz de implementación a <SharePointRoot>\, lo que da lugar a una ruta de acceso completa de <SharePointRoot>\Workflow1\. Para obtener más información, vea Empaquetado e implementación de soluciones de SharePoint.
Deployment Root String. Carpeta raíz donde se implementa el archivo en el servidor de SharePoint. Por ejemplo, <SharePointRoot>\Template\Features\<FeatureName>\.

El valor de la propiedad Deployment Root viene determinado por el valor de Deployment Type .
Tipo de implementación Tipo de implementación del archivo, que determina su valor Deployment Root . Puede ser uno de los siguientes valores:

NoDeployment: <ningún valor>

ElementManifest: <SharePointRoot>\Template\Features\<FeatureName>\

ElementFile: <SharePointRoot>\Template\Features\<FeatureName>\

TemplateFile: <SharePointRoot>\Template\

RootFile: <SharePointRoot>\

GlobalResource: <SharePointRoot>\Resources\

ClassResource: <ClassResourcePath>\

Para obtener más información, vea DeploymentType.
Nombre de archivo Nombre del archivo o carpeta para el archivo de elementos.
Ruta de acceso completa Ubicación del archivo del elemento. (Solo lectura).
Title Descripción
Plantillas de proyecto y de elementos de proyecto de SharePoint Describe el proyecto de SharePoint y las plantillas de elementos de proyecto disponibles en Visual Studio.
Cómo: Agregar elementos a un proyecto de SharePoint Describe cómo agregar elementos nuevos o existentes a un proyecto de SharePoint en Visual Studio.
Tutorial: Creación de una columna, un tipo de contenido y una lista de sitios para SharePoint Ofrece instrucciones paso a paso para crear un campo de clientes, un tipo de contenido, una definición de lista y una instancia de lista.
Cómo: para crear un receptor de eventos Se describe cómo agregar un receptor de eventos al proyecto creado en Tutorial: Creación de una columna, un tipo de contenido y una lista de sitios para SharePoint.
Creación de soluciones de flujo de trabajo de SharePoint Describe cómo crear proyectos de flujo de trabajo que incluye formularios de asociación y formularios de iniciación de flujos de trabajo.
Creación de páginas para SharePoint Describe cómo se pueden crear páginas para SharePoint como páginas de aplicación, páginas de sitio, páginas maestras y diseños de página.
Creación de elementos web para SharePoint Describe cómo se agregan controles que permiten a los usuarios modificar directamente el contenido, el aspecto y el comportamiento de las páginas del sitio de SharePoint a través de un explorador.
Creación de controles reutilizables para elementos web o páginas de aplicación Describe cómo se crean los controles de usuario que pueden usar las páginas de la aplicación y los elementos web que se ejecutan en SharePoint.
Integración de datos profesionales en SharePoint Describe cómo integrar los datos de los servicios Web y las aplicaciones de servidor back-end en una aplicación de SharePoint.
Creación de definiciones de sitio para SharePoint Describe cómo crear las definiciones del sitio: plantillas que se utilizan para crear sitios de SharePoint.
Importar elementos de un sitio de SharePoint existente Describe cómo importar elementos, como tipos de contenido y módulos, de un sitio de SharePoint existente en un proyecto SharePoint de Visual Studio.
Utilizar módulos para incluir archivos en la solución Describe cómo utilizar los módulos para implementar los archivos del proyecto de Visual Studio en el sitio de SharePoint.
Examen de las conexiones de SharePoint mediante el Explorador de servidores Describe cómo examinar los sitios locales de SharePoint mediante el Explorador de servidores.
Inclusión de información de empaquetado e implementación en los elementos del proyecto Describe cómo utilizar las propiedades de los elementos de proyecto para proporcionar información de empaquetado y distribución de los proyectos, como entradas de controles seguros, referencias de salida del proyecto y propiedades de las características.
Cómo: para agregar y quitar carpetas asignadas Describe cómo se pueden agregar las carpetas asignadas a un proyecto para facilitar el acceso a los recursos de SharePoint.
Consideraciones sobre las soluciones de espacio aislado Describe los problemas asociados a las soluciones en recintos de seguridad.
Seguridad para las soluciones de SharePoint Describe cuestiones de seguridad relacionadas con el desarrollo de soluciones de SharePoint en Visual Studio.
Cuadro de diálogo Selector de URL (desarrollo de SharePoint en Visual Studio) Describe un cuadro de diálogo que se puede usar para agregar las referencias de la ruta de acceso a los recursos en el proyecto o en el servidor de SharePoint local.

Consulte también