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 del token en elementos web en espacio aislado de Visual
• Restricciones de caracteres en nombres de proyectos 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
• El error se produce al depurar inicia
• Temas relacionados

Restricciones del token en elementos web en espacio aislado de Visual

Elementos web visuales en soluciones en espacio aislado no pueden procesar tokens estándar, como $SPUrl, que el runtime de SharePoint admite.Como resultado, no satisfacen la dirección URL, y no puede obtener una vista previa del contenido en la vista de diseño en el diseñador visual web de la parte si se hace referencia directamente en un elemento script, como en el ejemplo siguiente:

<script src=”<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Para solucionar esta limitación y resolver el símbolo, refiérale utilizando literales:

<asp:literal ID="Literal1" runat="server" Text="&lt;script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' &gt;&lt;/script&gt;" />

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

Los nombres de proyectos y de elementos 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".

Solución

Para los nombres de proyectos y de elementos de proyecto de SharePoint, utilice sólo los caracteres siguientes:

• 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 implementa sólo contiene estos caracteres válidos.

Errores al crear los campos personalizados

En Visual Studio, los campos personalizados se definen en XML.Se pueden producir errores si un campo no está definido o no se hace referencia mediante un formato específico.

Mensaje de error

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

Solución

El identificador de una definición de campo debe ser un GUID incluido entre llaves, como se muestra en el ejemplo siguiente:

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

Como se muestra en el ejemplo siguiente, una referencia de campo en un tipo de contenido se debe definir con el formato de elemento vacío (<FieldRef />), no con el inicio y los elementos end (<FieldRef></fieldref>):

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

Si el origen XML del campo es incorrecto, no es un archivo XML válido, ni presenta algún otro problema, el error “archivo de análisis de no” aparece.

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 definición de sitio utilizando una versión de que no es inglés Visual Studio (es decir, una versión con una configuración regional Id. distinto de 1033), la ficha Personalizaciones de SharePoint no aparece en el cuadro Seleccionar la plantilla y la nueva plantilla de sitio no aparece en la página Nuevo sitio de SharePoint .

Mensaje de error

Ninguno.

Solució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 en Visual Studio en un sistema limpio.Un sistema limpio es un equipo que tiene una instalación nueva Visual Studio y SharePoint pero ningún proyecto de flujo de trabajo implementado.

Mensaje de error

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

Solució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 Explorador de soluciones, elija el nodo de flujo de trabajo.

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

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.

Solució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.

Solució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. En Explorador de soluciones, abra el archivo de .feature de receptor de eventos en Diseñador de características haciendo doble clic en el archivo o abriendo el menú contextual y elige Abrir.

2. Elija la flecha situada junto a Ámbito, y elija Sitio en la lista que aparece.

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...

Solució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:

• Administración central de SharePoint 2010.Para obtener más información, vea Administración de modelos de Conectividad a datos empresariales (SharePoint Server 2010) en el sitio web de Microsoft TechNet.

• Windows PowerShell.Para eliminar el modelo, escriba este comando en el símbolo del sistema: Remove-SPBusinessDataCatalogModel.Para obtener más información, vea Cmdlets generales (SharePoint Server 2010) en el sitio web de Microsoft TechNet.

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 '/'.

Solución

Para resolver este problema

1. En Explorador de soluciones, elija el archivo de control de usuario, cuya extensión de nombre de archivo sea .ascx.

2. En la barra de menú, elija Ver, 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.

Solució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 projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml no existe.

Solució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 Visual Studio SharePoint, elija la tecla F5 para ejecutarla, y después sigue 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.Este problema se puede evitar configurando los valores de ping del grupo de aplicaciones en IIS.Vea la Ayuda para obtener más información.

Solució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 panel Conexiones , expanda el nodo de servidor de SharePoint y, a continuación el nodo Grupos de aplicaciones .

3. En la página Grupos de aplicaciones , elija el grupo de aplicaciones de SharePoint (normalmente “SharePoint - 80 ") y, a continuación, en el panel Acciones , elija el vínculo Configuración avanzada .

4. Para aumentar el tiempo de espera antes de tiempo de espera de IIS, cambie el valor Haga ping al tiempo de respuesta Máximo (segundos) a un valor mayor de 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.

2. Elija la tecla F5 para ejecutar la solución.

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 '/'.

Solució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.

Para resolver este problema, implemente la solución por, en la barra de menús, eligiendo Generar, Implementar.(No se depura la solución eligiendo la tecla F5.) 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.

Solució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.

El error se produce al depurar inicia

Cuando empieza a depurar una solución de SharePoint en Visual Studio, un error indica que Visual Studio no pudo cargar el archivo web.config porque la clave especificada no estaba 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.

Solución

Para resolver este problema, asegúrese de que coincide con el valor de propiedad URL del sitio de proyecto de SharePoint en Visual Studio la dirección URL que se asigna a la zona predeterminada para las asignaciones de acceso alternativas de la aplicación Web.No puede resolver el error mediante otra zona, como la intranet, para la dirección URL.La dirección URL del sitio para el proyecto y la dirección URL de la zona predeterminada deben coincidir.Para obtener acceso a las asignaciones de acceso alternativas, abra la utilidad Administración central de SharePoint 2010, elija el vínculo Administración de aplicaciones y, a continuación, en Aplicaciones web, elija el vínculo Configure las asignaciones de acceso alternativas .Para obtener más información, vea Creación de zonas para aplicaciones web.

Vea también

Conceptos

Solucionar problemas de empaquetado e implementación de SharePoint

Otros recursos

Compilar y depurar soluciones de SharePoint

Depurar en Visual Studio