Solución de problemas en el empaquetado e implementación de SharePoint
En este tema se tratan diversos problemas que pueden producirse al empaquetar e implementar soluciones de SharePoint.
Habilitación de la depuración mejorada
Si desea realizar un diagnóstico entre Visual Studio, SharePoint y otras capas, puede usar la clave del Registro EnableDiagnostics para ver el seguimiento de la pila. Para más información, consulte Depuración de soluciones de SharePoint.
Adición de la salida del proyecto al paquete de solución
Puede agregar la salida del proyecto a un paquete a través del Diseñador de paquetes. Sin embargo, cuando agregue la salida del proyecto, asegúrese de que la plataforma del proyecto coincide con la plataforma de la solución de SharePoint. Se recomienda usar el destino de plataforma Any CPU en los ensamblados que desee implementar en un servidor de SharePoint. Para más información, consulte Compilación de página, Diseñador de proyectos (Visual Basic) y Cuadro de diálogo Configuración avanzada del compilador (Visual Basic).
Errores y advertencias 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 se crea de forma correcta. También puede crear pasos de validación personalizados para sus características y paquetes. Para obtener más información, vea Cómo: para crear reglas personalizadas de validación de características y paquetes para soluciones de SharePoint.
Resolución de conflictos en la implementación
Al implementar una solución de SharePoint, pueden producirse colisiones cuando un elemento del servidor tiene el mismo nombre, dirección URL o identificador que un elemento del paquete de solución. Puede cambiar la propiedad Deployment Conflict Resolution para resolver, notificar u omitir las colisiones de los módulos, elementos web, instancias de lista y tipos de contenido.
En la tabla siguiente se muestran los valores de la propiedad Deployment Conflict Resolution.
| Valor | Descripción |
|---|---|
| Automático | Detecta las colisiones y resuelve los conflictos automáticamente. |
| Prompt | Detecta las colisiones y las notifica al desarrollador de software antes de resolver los conflictos. |
| None | No detecta las colisiones. |
Diferencias entre la implementación con F5
Cuando se usa Visual Studio para implementar un proyecto de SharePoint en el servidor de SharePoint local para su comprobación y depuración, hay algunos pasos adicionales que Visual Studio realiza.
Restablece Internet Información Services (IIS) durante el paso de implementación.
Asocia automáticamente los flujos de trabajo.
Establece 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 el comportamiento de F5. Para más información, consulte Tutorial: Creación de un paso de implementación personalizado para proyectos de SharePoint.
Retraso al mostrar la página de SharePoint cuando se implementa un elemento web visual
La página de SharePoint tarda mucho en aparecer cuando se implementa un elemento web visual en la carpeta Bin de Windows Vista, Windows 7 o Windows Server 2008. Si se cambian los archivos de un directorio de ASP.NET de nivel superior, como el directorio Bin, se volverá a compilar toda la aplicación web. Esto puede generar un retraso de hasta 25 segundos en la presentación de la página de SharePoint.
Mensaje de error
Ninguno.
Solución
Para evitar este problema, siga estos pasos:
Instale la actualización KB967535 que se describe en el artículo de Soporte técnico de Microsoft REVISIÓN: existe una revisión disponible para solucionar dos problemas de ASP.NET en IIS 7.0 para Windows Vista y Windows Server 2008.
Agregue la línea siguiente al archivo Web.config.
<compilation batch="false" optimizeCompilations="true">
Al implementar del proyecto de SharePoint se produce el siguiente error: "Error al extraer el archivo cab de la solución"
Si el nombre de algún elemento de proyecto de SharePoint contiene paréntesis, se produce un error en la implementación de la solución.
Mensaje de error
En el paso 'Agregar solución' de la implementación se ha producido el siguiente error: "Error al extraer el archivo cab de la solución".
Solución
Para evitar este problema, quite los paréntesis de los nombres de elementos de proyecto de SharePoint.
Aparece un error al implementar un elemento web visual en un sitio de una aplicación web diferente
La primera vez que implementa un elemento web visual en un sitio de otra aplicación web distinta de la que está implementando en la actualidad (mediante la modificación de la propiedad SiteUrl del elemento web visual), se produce un error.
Mensaje de error
En el paso 'Agregar solución' de la implementación se produce el siguiente error: "Ya se ha instalado una característica con Id. [#] en este conjunto de servidores. Use el atributo fuerza para volver a agregar la característica de modo explícito".
Solución
Este error se produce debido al modo en que se retractan las características de elementos web visuales en SharePoint. Para implementar el elemento web visual correctamente, implemente de nuevo la solución. Para ello, presione la tecla F5.
Aparece una advertencia al implementar controles de usuario anidados
Esta advertencia se produce al implementar una solución de SharePoint que contiene controles de usuario anidados, como un elemento web visual que incluye un control de usuario o un control de usuario que incluye un elemento web visual u otro control de usuario. Esta advertencia se produce si agrega un control a un diseñador arrastrándolo desde el cuadro de herramientas o mediante la directiva @Register en la vista Origen.
Mensaje de error
Advertencia 1 El elemento '[Nombre de control]' es desconocido. Esto se puede producir si hay un error de compilación en el sitio web o no se encuentra el archivo web.config.
Solución
Si el sistema de proyectos de Visual Studio no reconoce un control de usuario anidado, no puede proporcionar IntelliSense y genera la advertencia. El sistema de proyectos no reconoce un control de usuario anidado si no se ha compilado el proyecto y el diseñador no se ha cerrado y se ha vuelto a abrir, o si está habilitada la opción de retracción automática, que hace que el control de usuario se retire del subárbol de SharePoint después de la depuración.
Para quitar esta advertencia, compile el proyecto y, a continuación, cierre el diseñador y vuelva a abrirlo, o deshabilite la opción de retracción automática en el proyecto. Para ello, desactive la casilla Retraer automáticamente después de depurar en la pestaña SharePoint del cuadro de diálogo de propiedades del proyecto.