Compartir a través de


Solución de problemas de empaquetado e implementación de SharePoint

En este tema se tratan varios problemas que pueden surgir al empaquetar e implementar soluciones de SharePoint.

Habilitación de la depuración mejorada

Para diagnosticar entre Visual Studio, SharePoint y otras capas, puede usar la clave del Registro EnableDiagnostics para ver el seguimiento de la pila. Para obtener más información, vea Depurar soluciones de SharePoint.

Adición de la salida del proyecto al paquete de solución

Puede agregar la salida del proyecto a un paquete mediante el Diseñador de paquetes. Sin embargo, al agregar la salida del proyecto, asegúrese de que la plataforma del proyecto coincide con la plataforma de la solución de SharePoint. Recomendamos que use el objetivo de plataforma Any CPU para los ensamblados que desea implementar en un servidor de SharePoint. Para obtener más información, vea Compilar página, Diseñador de proyectos (Visual Basic) y Configuración avanzada del compilador (Cuadro de diálogo) (Visual Basic).

Advertencias y errores de validación

Las herramientas de desarrollo de SharePoint de Visual Studio realizan pasos de validación para comprobar que el paquete de solución tiene el formato correcto. También puede crear pasos de validación personalizados para las características y paquetes. Para obtener más información, vea Cómo: Crear reglas de validación de características y paquetes personalizados para soluciones de SharePoint.

Resolución de conflictos de implementación

Al implementar una solución de SharePoint, es posible que encuentre colisiones cuando un elemento del servidor tenga el mismo nombre, dirección URL o identificador que un elemento del paquete de solución. Puede cambiar la propiedad Solución de conflictos de implementación para resolver, notificar o omitir colisiones para módulos, elementos web, instancias de lista y tipos de contenido.

En la tabla siguiente se muestra la configuración de la propiedad Deployment Conflict Resolution .

Importancia Description
Automático Detecta colisiones y resuelve los conflictos automáticamente.
Pronto Detecta colisiones e informa a los desarrolladores antes de resolver los conflictos.
Ninguno No detecta colisiones.

Diferencias entre la implementación de F5

Cuando se usa Visual Studio para implementar el proyecto de SharePoint en el servidor de SharePoint local para probar y depurar, hay algunos pasos adicionales que realiza Visual Studio.

  1. Restablezca Internet Information Service (IIS) durante el paso de implementación.

  2. Asocie automáticamente flujos de trabajo.

  3. Establezca el orden de activación de características según la jerarquía del Diseñador de paquetes.

    Puede agregar pasos de implementación personalizados para cambiar aún más el comportamiento de F5 . Para obtener más información, vea Tutorial: Crear un paso de implementación personalizado para proyectos de SharePoint.

Retraso en la visualización de la página de SharePoint al implementar un elemento web visual

La página de SharePoint tarda mucho tiempo en aparecer al implementar un elemento web visual en la carpeta Bin en Windows Vista, Windows 7 o Windows Server 2008. Si cambia los archivos de un directorio ASP.NET de nivel superior, como el directorio Bin, se vuelve a compilar toda la aplicación web. Esto puede provocar un retraso de hasta 25 segundos para que se represente la página de SharePoint.

Mensaje de error

Ninguno.

Resolución

Para solucionar este problema, realice los pasos siguientes:

  1. Instalar la actualización KB967535 como se describe en el artículo de soporte técnico de Microsoft FIX: hay una revisión disponible para corregir dos problemas en ASP.NET en IIS 7.0 para Windows Vista y Windows Server 2008.

  2. Agregue la siguiente línea al archivo Web.config:

    <compilation batch="false" optimizeCompilations="true">
    

Se produce un error en la implementación del proyecto de SharePoint con el error "No se pudo extraer el archivo cab en la solución".

Si el nombre de cualquier elemento de proyecto de SharePoint contiene paréntesis, su solución produce un error en la implementación.

Mensaje de error

Error en el paso de implementación "Agregar solución": no se pudo extraer el archivo cab en la solución.

Resolución

Para solucionar este problema, quite los paréntesis en los nombres de los elementos de proyecto de SharePoint.

Aparece un error al implementar un elemento web visual en un sitio en una aplicación web diferente

La primera vez que implemente un elemento web visual en un sitio en una aplicación web distinta de la que se implementa actualmente (cambiando la propiedad SiteUrl del elemento web visual), se produce un error.

Mensaje de error

Error en el paso de implementación "Agregar solución": ya se ha instalado una característica con el identificador [#] en esta granja de servidores. Use el atributo force para volver a instalar explícitamente la característica.

Resolución

Este error se produce debido a la forma en que las características del elemento web visual se retiran en SharePoint. Para implementar correctamente el elemento web visual, vuelva a implementar la solución eligiendo la tecla F5 .

Aparece la advertencia al implementar controles de usuario anidados

Esta advertencia se produce cuando se implementa una solución de SharePoint que tiene controles de usuario anidados, como un elemento web visual que contiene un control de usuario o un control de usuario que contiene un elemento web visual u otro control de usuario. Esta advertencia ocurre ya sea que agregue un control a un diseñador arrastrándolo desde el Cuadro de herramientas, o usando la directiva `@Register` en la vista de Source.

Mensaje de error

Advertencia 1 El elemento '[Nombre de control]' no es un elemento conocido. Esto puede ocurrir si hay un error de compilación en el sitio web o falta el archivo web.config.

Resolución

Si el sistema de proyectos de Visual Studio no conoce un control de usuario anidado, no puede proporcionar IntelliSense y emite la advertencia. El sistema de proyecto no reconoce un control de usuario anidado si el proyecto no se ha construido y el diseñador no se ha cerrado y vuelto a abrir, o si la opción de retracción automática está habilitada, lo que provoca que el control de usuario se retire del hive de SharePoint después de la depuración.

Para quitar esta advertencia, compile el proyecto y, a continuación, cierre y vuelva a abrir el diseñador, o deshabilite la opción de retracción automática para el proyecto. Para ello, desactive la casilla Retirar automáticamente después de la depuración en la pestaña SharePoint del cuadro de diálogo de propiedades del proyecto.