Solucionar problemas de implementación y empaquetado de SharePointTroubleshoot SharePoint packaging and deployment

En este tema se tratan diversos problemas que pueden producirse al empaquetar e implementar soluciones de SharePoint.This topic covers various problems that you might encounter when you package and deploy SharePoint solutions.

Habilitar la depuración mejoradaEnable enhanced debugging

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.To diagnose between Visual Studio, SharePoint, and other layers, you can use the EnableDiagnostics registry key to view the stack trace. Para obtener más información, consulte soluciones de SharePoint depurar.For more information, see Debug SharePoint solutions.

Agregar resultados del proyecto al paquete de soluciónAdd project output to the solution package

Puede agregar la salida del proyecto a un paquete a través del Diseñador de paquetes.You can add the project output to a package through the Package Designer. 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.However, when you add the project output, make sure that the platform of the project matches the platform of the SharePoint solution. Se recomienda que use el cualquier CPU plataforma de destino para los ensamblados que desea implementar en un servidor de SharePoint.We recommend that you use the Any CPU platform target for the assemblies that you want to deploy to a SharePoint server. Para obtener más información, consulte página compilación, Diseñador de proyectos (Visual Basic) y cuadro de diálogo de configuración de compilador avanzada (Visual Basic).For more information, see Compile Page, Project Designer (Visual Basic) and Advanced Compiler Settings Dialog Box (Visual Basic).

Errores y advertencias de validaciónValidation warnings and errors

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.The SharePoint development tools in Visual Studio perform validation steps to verify that the solution package is correctly formed. También puede crear pasos de validación personalizados para sus características y paquetes.You can also create custom validation steps for your Features and packages. Para obtener más información, consulte Cómo: crear características personalizadas y un paquete de reglas de validación para las soluciones de SharePoint.For more information, see How to: Create custom feature and package validation rules for SharePoint solutions.

Resolución de conflictos de implementaciónDeployment conflict resolution

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.When you deploy a SharePoint solution, you may find collisions when an item on the server has the same name, URL, or ID as an item in your solution package. Puede cambiar el Deployment Conflict Resolution propiedad para resolver, notificar u omitir las colisiones de los módulos, partes Web, las instancias de lista y tipos de contenido.You can change the Deployment Conflict Resolution property to resolve, report, or ignore collisions for modules, Web parts, list instances, and content types.

La tabla siguiente muestra la configuración de la Deployment Conflict Resolution propiedad.The following table demonstrates the settings for the Deployment Conflict Resolution property.

ValorValue DescripciónDescription
AutomáticoAutomatic Detecta las colisiones y resuelve los conflictos automáticamente.Detects collisions and resolves the conflicts automatically.
PreguntarPrompt Detecta las colisiones y las notifica al desarrollador de software antes de resolver los conflictos.Detects collisions and reports them to the developer before resolving the conflicts.
NingunaNone No detecta las colisiones.Does not detect collisions.

Diferencias entre la implementación y F5Differences between F5 deployment

Cuando se usa Visual StudioVisual 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 StudioVisual Studio realiza.When you use Visual StudioVisual Studio to deploy your SharePoint project to the local SharePoint server for testing and debugging, there are some additional steps that are performed by Visual StudioVisual Studio.

  1. Restablece Internet Información Services (IIS) durante el paso de implementación.Reset the Internet Information Service (IIS) during the deployment step.

  2. Asocia automáticamente los flujos de trabajo.Automatically associate workflows.

  3. Establece el orden de activación de características según la jerarquía del Diseñador de paquetes.Set the feature activation order according to the hierarchy in the Package Designer.

    Puede agregar pasos de implementación personalizado para cambios adicionales la F5 comportamiento.You can add custom deployment steps to further change the F5 behavior. Para obtener más información, consulte Tutorial: crear un paso de implementación personalizado para proyectos de SharePoint.For more information, see Walkthrough: Create a custom deployment step for SharePoint projects.

Retrasar la aparición de la página de SharePoint al implementar el elemento web visualDelay displaying SharePoint page when Deploy visual web part

La página de SharePoint tarda mucho en aparecer cuando se implementa un elemento web visual en la carpeta Bin de Windows VistaWindows Vista, Windows 7Windows 7 o Windows Server 2008Windows Server 2008.The SharePoint page takes a long time to appear when deploying a Visual Web part to the Bin folder on Windows VistaWindows Vista, Windows 7Windows 7, or Windows Server 2008Windows Server 2008. Si se cambian los archivos de un directorio de ASP.NETASP.NET de nivel superior, como el directorio Bin, se volverá a compilar toda la aplicación web.If you change any files in a top-level ASP.NETASP.NET directory, such as the Bin directory, the entire Web application recompiles. Esto puede generar un retraso de hasta 25 segundos en la presentación de la página de SharePoint.This can cause a delay of up to 25 seconds for the SharePoint page to render.

Mensaje de errorError message

Ninguno.None.

ResoluciónResolution

Para evitar este problema, siga estos pasos:To work around this problem, perform the following steps:

  1. Instale la actualización KB967535 tal como se describe en el artículo de Microsoft Support corregir: hay disponible una revisión para solucionar dos problemas de ASP.NET en IIS 7.0 para Windows Vista y Windows Server 2008.Install update KB967535 as outlined in the Microsoft Support article FIX: A hotfix is available to fix two problems in ASP.NET on IIS 7.0 for Windows Vista and Windows Server 2008.

  2. Agregue la línea siguiente al archivo Web.config.Add the following line to the Web.config file:

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

Implementación de proyectos de SharePoint se produce un error con el error "No se pudo extraer el archivo cab de la solución"SharePoint project deployment fails with error "Failed to extract the cab file in the solution"

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.If the name of any SharePoint project item contains parentheses, its solution fails on deployment with an error.

Mensaje de errorError message

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".Error occurred in deployment step 'Add Solution': Failed to extract the cab file in the solution.

ResoluciónResolution

Para evitar este problema, quite los paréntesis de los nombres de elementos de proyecto de SharePoint.To work around this problem, remove any parentheses in the names of SharePoint project items.

Aparece un error al implementar un elemento web visual a un sitio en una aplicación web diferenteError appears when deploying a visual web part to a site on a different web application

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.The first time that you deploy a visual Web part to a site on a Web application other than the one on which it is currently deployed (by changing the visual Web part's SiteUrl property), you get an error.

Mensaje de errorError message

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.Error occurred in deployment step 'Add Solution': A feature with ID [#] has already been installed in this farm. Use el atributo fuerza para volver a agregar la característica de modo explícito".Use the force attribute to explicitly re-install the feature.

ResoluciónResolution

Este error se produce debido al modo en que se retractan las características de elementos web visuales en SharePoint.This error occurs due to the way visual Web part features are retracted in SharePoint. Para implementar correctamente el elemento Web visual, implementar la solución eligiendo la F5 clave.To successfully deploy the visual Web part, deploy the solution again by choosing the F5 key.

Aparece la advertencia al implementar controles de usuario anidadosWarning appears when deploying nested user controls

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.This warning occurs when you deploy a SharePoint solution that has nested user controls, such as a visual Web part that contains a user control or a user control that contains a visual Web part or another user control. Esta advertencia se produce si agrega un control a un diseñador arrastrándolo desde el cuadro de herramientas o mediante el @Register la directiva en la vista del origen.This warning occurs whether you add a control to a designer by dragging it from the Toolbox or by using the @Register directive in the Source view.

Mensaje de errorError message

Advertencia 1 el elemento ' [nombre del Control]' no es un elemento conocido.Warning 1 Element '[Control Name]' is not a known element. Esto se puede producir si hay un error de compilación en el sitio web o no se encuentra el archivo web.config.This can occur if there is a compilation error in the Web site, or the web.config file is missing.

ResoluciónResolution

Si el Visual StudioVisual Studio sistema del proyecto no es consciente de un control de usuario anidado, no puede proporcionar IntelliSense y emite la advertencia.If the Visual StudioVisual Studio project system is not aware of a nested user control, it cannot provide IntelliSense and it emits the warning. El sistema del proyecto no tiene constancia de un control de usuario anidado si no se compila el proyecto y no se cierra y se vuelva a abrir el diseñador, o si la retracción automática está habilitada, lo que hace que el control de usuario se retire del subárbol de SharePoint después de la depuración.The project system is unaware of a nested user control if the project is not built and the designer is not closed and re-opened, or if the auto-retract option is enabled, which causes the user control to be retracted from the SharePoint hive after debugging.

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.To remove this warning, either build the project and then close and then reopen the designer, or disable the auto-retract option for the project. Para ello, desactive la retraer automáticamente después de depurar casilla de verificación en la SharePoint ficha del cuadro de diálogo Propiedades del proyecto.To do this, clear the Auto-retract after debugging check box on the SharePoint tab of the project properties dialog box.

Vea tambiénSee also

Empaquetar e implementar soluciones de SharePointPackage and deploy SharePoint solutions