Solucionar problemas de soluciones de SharePoint

Los siguientes problemas o alertas pueden producirse al depurar las soluciones de SharePoint mediante el depurador de Visual Studio. Para obtener más información, vea Debugging SharePoint Workflow Solutions.

Este tema contiene las secciones siguientes.

  • Restricciones de caracteres en nombres de proyecto y de elementos de proyecto
  • Errores al crear los campos personalizados
  • Tras la implementación no aparecen en la página de creación del sitio las definiciones del sitio en idiomas distintos del inglés
  • Aparece un error al implementar un proyecto de flujo de trabajo en un sistema limpio
  • El usuario debe actualizar la página de aplicación en el explorador durante la depuración para ver la imagen actualizada
  • Error: La ubicación del sitio de SharePoint no es válida
  • El evento web de eliminación de sitios no se genera en el proyecto de receptor de eventos
  • Aparece un error de implementación después de cambiar el nombre de un identificador en un proyecto de modelo de conectividad a datos profesionales
  • Aparece un error al intentar ver un elemento web visual en SharePoint
  • Aparece un error al ejecutar un flujo de trabajo reutilizable importado que contiene un campo de formulario de tareas
  • Aparece un error al ejecutar una instancia de lista importada con otro nombre
  • IIS finaliza la sesión de depuración de SharePoint
  • La retracción automática deja huérfana la instancia de lista en SharePoint
  • Una versión exportada reemplaza la solución de SharePoint original
  • Aparece un error al iniciar la depuración
  • Temas relacionados

Restricciones de caracteres en nombres de proyecto y de elementos de proyecto

Los nombres de proyecto y de elemento de proyecto solo pueden contener caracteres que sean válidos en una ruta de distribución de SharePoint 2010. No se permite ningún otro carácter.

Mensaje de error

Mensaje de error "Caracteres no válidos".

Resolución

En los nombres de proyecto y de elementos de proyecto de SharePoint, solo se deben usar los siguientes caracteres:

  • Caracteres ASCII alfanuméricos

  • Espacio

  • Punto (.)

  • Coma (,)

  • Subrayado (_)

  • Guión (-)

  • Barra diagonal inversa (\)

Cuando se empaqueta un proyecto, una regla de validación comprueba que la propiedad Ruta de distribución de cada archivo que se va a implementar contenga solo estos caracteres válidos.

Errores al crear los campos personalizados

Los campos personalizados de Visual Studio 2010 se definen en XML. Si un campo no está definido o no se hace referencia a él con un formato concreto, se pueden producir errores.

Mensaje de error

Mensaje de error "Caracteres no válidos" durante el empaquetado.

Resolución

El identificador de una definición de campo debe ser un GUID entre llaves. Por ejemplo,

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Type="Note" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Group="A Custom Group">
</Field>.

Una referencia de campo de un tipo de contenido se debe definir con el formato de elemento vacío (<FieldRef />), no con elementos de inicio y fin (<FieldRef></FieldRef>). Por ejemplo:

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE"/>

Si hay un problema con el origen XML del campo, por ejemplo, que es incorrecto o no es un archivo XML válido, aparece un error que indica que no se puede analizar el archivo.

Tras la implementación no aparecen en la página de creación del sitio las definiciones del sitio en idiomas distintos del inglés

Después de crear e implementar una nueva definición del sitio con una versión de Visual Studio 2010 que no es para el inglés (es decir, una versión con un ID de configuración regional distinto del 1033), la pestaña Personalizaciones de SharePoint no aparece en el cuadro Selección de plantilla y la nueva plantilla del sitio no aparece en la página Nuevo Sitio de SharePoint.

Mensaje de error

Ninguno.

Resolución

Este problema se produce debido a un valor incorrecto de la propiedad Path en el archivo webtemp de configuración de definición del sitio, como webtemp_SiteDefinitionProject1.xml. En la propiedad Path del archivo webtemp, situado bajo Ubicación de implementación, cambie 1033 por el ID de configuración regional adecuado. Por ejemplo, para usar la configuración regional del japonés, cambie el valor a 1041. Para obtener más información, vea Locale IDs Assigned by Microsoft en el sitio web de MSDN.

Aparece un error al implementar un proyecto de flujo de trabajo en un sistema limpio

Este problema se produce si se implementa un proyecto de flujo de trabajo de Visual Studio 2010 en un sistema limpio. Un sistema limpio es un equipo que tiene una instalación nueva de Visual Studio 2010 y SharePoint, pero no tiene ningún proyecto de flujo de trabajo implementado.

Mensaje de error

No se encuentra la lista de SharePoint: Historial del flujo de trabajo.

Resolución

Este error se produce porque falta una lista del historial del flujo de trabajo. Dado que el entorno de desarrollo es un sistema limpio, no se implementa ningún flujo de trabajo y la lista del historial de flujo de trabajo no existe todavía. Para resolver este problema, vuelva a abrir el asistente de flujo de trabajo, lo que hará que se cree la lista del historial de flujo de trabajo.

Para volver a entrar en el asistente de flujo de trabajo

  1. En el Explorador de soluciones, seleccione el nodo del flujo de trabajo.

  2. En la ventana Propiedades, haga clic en el botón de puntos suspensivos (...) de cualquier propiedad que tenga este botón.

El usuario debe actualizar la página de aplicación en el explorador durante la depuración para ver la imagen actualizada

Si está depurando una solución de SharePoint que contiene una página de aplicación con un control en el que se muestra una imagen, como un control de imagen HTML, es necesario actualizar la página en el explorador para mostrar los cambios que se realizan en la imagen.

Error: La ubicación del sitio de SharePoint no es válida

Este problema puede producirse si no se instala SharePoint Server 2010. También puede ocurrir si no se tiene acceso de administrador al sitio web de SharePoint especificado en el Asistente para la personalización de SharePoint.

Mensaje de error

  • La ubicación del sitio de SharePoint no es válida.

Resolución

  • Instale SharePoint Server 2010.

  • Asegúrese de que tiene acceso de administrador al sitio web de SharePoint. Para obtener más información, vea el artículo de Office Online Grant access to the portal site.

El evento web de eliminación de sitios no se genera en el proyecto de receptor de eventos

Cuando crea un proyecto de receptor de eventos y selecciona ciertos eventos web como "Se va a eliminar un sitio", el evento nunca se produce.

Mensaje de error

Ninguno.

Resolución

Este problema se produce porque el ámbito de característica debe ser "Sitio" para poder administrar eventos del nivel de sitio, pero el ámbito de característica predeterminado en los proyectos de receptor de eventos es "Web". Los eventos web afectados son:

  • Se va a eliminar un sitio (WebDeleting)

  • Se eliminó un sitio (WebDeleted)

  • Se va a mover un sitio (WebMoving)

  • Se movió un sitio (WebMoved)

Para corregir el problema, cambie el ámbito de característica del receptor de eventos tal y como se indica a continuación.

Para cambiar el ámbito de característica del receptor de eventos

  1. Abra la característica del receptor de eventos en el Diseñador de características. Para ello, haga doble clic en el archivo .feature en el Explorador de soluciones.

  2. Haga clic en la flecha de lista desplegable situada junto a Ámbito.

  3. Seleccione Sitio en la lista desplegable.

Aparece un error de implementación después de cambiar el nombre de un identificador en un proyecto de modelo de conectividad a datos profesionales

Este problema se produce si cambia el nombre del identificador de una entidad de un modelo de conectividad a datos profesionales (BDC) y, a continuación, intenta implementar la solución.

Mensajes de error

  • <nombre del modelo> tiene los siguientes errores de activación de tipo de contenido externo…

  • El IMetadataObject denominado '<nombre del modelo>' tiene un valor en el campo 'nombre' que está duplicado...

Resolución

Para resolver este problema, elimine el modelo manualmente y, a continuación, implemente de nuevo la solución. Puede eliminar el modelo utilizando cualquiera de las siguientes herramientas:

Aparece un error al intentar ver un elemento web visual en SharePoint

Este problema se produce cuando la propiedad Ruta de acceso del control de usuario no comienza con la cadena "CONTROLTEMPLATES\".

Mensajes de error

  • El archivo '/_CONTROLTEMPLATES/<nombre de proyecto>/<nombre de elemento web>/<nombre de control de usuario>.ascx' no existe.

  • Error del servidor en la aplicación '/'.

Resolución

Para resolver este problema

  1. En el Explorador de soluciones, seleccione el archivo del control de usuario. Este archivo tiene la extensión .ascx.

  2. En el menú Ver, haga clic en Ventana Propiedades.

  3. En la ventana Propiedades, expanda el nodo Ubicación de implementación.

  4. Asegúrese de que el valor de propiedad Ruta de acceso comienza con la cadena "CONTROLTEMPLATES\".

Aparece un error al ejecutar un flujo de trabajo reutilizable importado que contiene un campo de formulario de tareas

Este problema se produce si importa un flujo de trabajo que contiene un formulario de tareas que incluye un campo y, a continuación, ejecuta el nuevo flujo de trabajo en el mismo sistema del que lo importó.

Mensaje de error

Error en el paso de implementación "Activar características": el campo con el id. [Guid] definido en la característica [Guid] se encontró en la colección de sitios actual o en un subsitio.

Resolución

Este error es el resultado de colisiones de identificador de campo que se producen porque el proyecto Importar flujo de trabajo reutilizable de Visual Studio no cambia los identificadores de campo del formulario de tareas. Si implementa un flujo de trabajo importado en el mismo servidor que contiene el flujo de trabajo original, se producen colisiones de identificador de campo.

Para resolver este problema, use la característica Buscar y reemplazar para cambiar el valor del atributo id. de campo en todos los archivos de flujo de trabajo importados.

Aparece un error al ejecutar una instancia de lista importada con otro nombre

Este problema se produce si cambia el nombre de una instancia de lista importada y, a continuación, la ejecuta en Visual Studio.

Mensaje de error

Error de compilación: Error en el paso de implementación "Activar características": el archivo Template\Features\[import project feature name]\Files\Lists\[old list name]\Schema.xml no existe.

Resolución

Al importar una instancia de lista, se agrega un atributo denominado CustomSchema al archivo Elements.xml de la instancia de lista. Elements.xml incluye la ruta de acceso de un archivo schema.xml personalizado para la instancia de lista. Al cambiar el nombre de la instancia de lista en Visual Studio, cambia la ruta de acceso de implementación para el archivo schema.xml personalizado, pero el valor de ruta de acceso del atributo CustomSchema no se actualiza. Como resultado, la instancia de lista no puede encontrar el archivo schema.xml en la ruta de acceso anterior especificada en el atributo CustomSchema cuando se activa la característica.

Para resolver este problema, actualice la ruta de acceso de la ubicación de implementación del archivo schema.xml en el atributo CustomSchema.

IIS finaliza la sesión de depuración de SharePoint

Este problema se produce si establece un punto de interrupción en una solución de SharePoint para Visual Studio, presiona F5 para ejecutarlo y, a continuación, permanece en un punto de interrupción durante más de 90 segundos.

Mensaje de error

Internet Information Services (IIS) ha finalizado el proceso del servidor web que se estaba depurando. Esto se puede evitar configurando los valores de ping del grupo de aplicaciones en IIS. Vea la ayuda para obtener más información.

Resolución

De forma predeterminada, el grupo de aplicaciones de IIS espera 90 segundos a que una aplicación responda antes de cerrarla. Este proceso se conoce como "hacer ping" a la aplicación. Para resolver este problema, puede aumentar el tiempo de espera o deshabilitar el ping de la aplicación por completo.

Para obtener acceso a los valores de grupo de aplicación de IIS

  1. Abra el Administrador de IIS.

  2. En el recuadro Conexiones, expanda el nodo de servidor de SharePoint y, a continuación, haga clic en Grupos de aplicaciones.

  3. En la página Grupos de aplicaciones, seleccione el grupo de aplicaciones de SharePoint (normalmente "SharePoint - 80") y, a continuación, en el recuadro Acciones, haga clic en Configuración avanzada.

  4. Para aumentar el tiempo de espera antes de que se agote en IIS, cambie el valor de Tiempo máximo de respuesta de ping (segundos) a un valor mayor que 90 segundos.

  5. Para deshabilitar el ping en IIS, establezca Ping habilitado en False.

La retracción automática deja huérfana la instancia de lista en SharePoint

Este problema se produce si realiza los siguientes pasos.

  1. Crea una definición de lista que contiene una instancia de lista en Visual Studio 2010.

  2. Ejecuta la solución presionando F5.

  3. Detiene la depuración o cierra el sitio de SharePoint.

  4. Vuelve a abrir el sitio de SharePoint y abre la instancia de lista.

Mensaje de error

Error del servidor en la aplicación '/'.

Resolución

Esto ocurre porque después de cerrar una sesión de depuración de una solución de SharePoint, la característica de retracción automática retrae la solución. La retractación elimina la definición de lista de SharePoint pero no elimina la instancia de lista. La instancia de lista requiere la definición de lista subyacente.

Resolver este problema, en el menú Generar, haga clic en Implementar para implementar la solución. (No use F5 para depurarla). A continuación, elimine la instancia de lista en SharePoint.

Una versión exportada reemplaza la solución de SharePoint original

Si exporta una solución de SharePoint, importa la solución a Visual Studio y, a continuación, vuelve a implementar la solución en el mismo sitio del que la exportó, se reemplaza la solución de SharePoint original. Este problema no se produce si implementa la solución en un servidor que no tiene activada la solución original.

Mensaje de error

Ninguno.

Resolución

Para evitar sobrescribir una solución en el sitio del que se exportó, cambie los GUID de SolutionID y los identificadores de todas las características importadas en el proyecto de Visual Studio.

Aparece un error al iniciar la depuración

Al empezar a depurar una solución de SharePoint en Visual Studio, recibe un error que indica que Visual Studio no pudo cargar el archivo de configuración Web.config porque la clave especificada no se encontró en el diccionario.

Mensaje de error

No se puede cargar el archivo de configuración Web.config. Compruebe que el archivo no contiene elementos XML incorrectos e inténtelo de nuevo. Se produjo el siguiente error: La clave especificada no se encontró en el diccionario.

Resolución

Para resolver este problema, asegúrese de que el valor de propiedad URL del sitio del proyecto de SharePoint en Visual Studio coincide con la dirección URL asignada a la zona predeterminada para las asignaciones de acceso alternativas de la aplicación web. Si se usa otra zona, como la intranet, para la dirección URL, no se resuelve el error. La dirección URL del sitio del proyecto y la dirección URL de la zona predeterminada deben ser la misma. Para obtener acceso a las asignaciones de acceso alternativas, haga clic en Administración de aplicaciones en la utilidad Administración central de SharePoint 2010 y, a continuación, haga clic en el vínculo Configurar asignaciones de acceso alternativas en Aplicaciones web. Para obtener más información, vea Creación de zonas para aplicaciones web.

Vea también

Otros recursos

Solucionar problemas de empaquetado e implementación de SharePoint

Compilar y depurar soluciones de SharePoint

Depurar en Visual Studio

  • Last updated on