Lista de comprobación para probar los elementos Web de SharePoint

18 de Julio de 2005

Publicado: Noviembre de 2004

Lana Fly
Susan Harney
Microsoft Corporation

Este artículo se aplica a:
Microsoft Windows SharePoint Services
Microsoft Office SharePoint Portal Server 2003

Resumen: utilice esta lista de comprobación para que le ayude con la implementación y el mantenimiento de elementos Web de los productos y las tecnologías Microsoft SharePoint. (11 páginas impresas.)

En esta página

Introducción Introducción
Lista de comprobación de tareas para probar los elementos Web Lista de comprobación de tareas para probar los elementos Web
Conclusión Conclusión

Introducción

Si instala y mantiene los elementos Web de un sitio de portal de Microsoft Office SharePoint Portal Server o de un sitio de grupo de Microsoft Windows SharePoint Services, deberá asegurarse de que los elementos Web son seguros, están bien escritos y se pueden integrar adecuadamente con los demás componentes de la página de elementos Web.

Si comprende las tareas descritas en este artículo, podrá determinar si un elemento Web cumple estos requisitos y aumentar el éxito de la implementación y el mantenimiento del elemento Web.

Nota

Para obtener más información acerca de la creación de elementos Web que cumplan estos criterios, consulte Best Practices for Creating Web Parts for Microsoft SharePoint Products and Technologies (en inglés).

Lista de comprobación de tareas para probar los elementos Web

La siguiente lista de comprobación contiene una serie de tareas diseñadas para ayudarle a determinar la calidad de los elementos Web que se le ha pedido que implemente o mantenga.

Vea los detalles acerca de cómo realizar estas comprobaciones más abajo

Lista de comprobación de tareas

Tarea

.

 

Compruebe que puede agregar el elemento Web correctamente a una zona de elementos Web.

 

Compruebe que los elementos Web estáticos se procesan correctamente y no provocan un error en la página de elementos Web.

 

Compruebe que el elemento Web funciona correctamente independientemente de en qué parte de la página de elementos Web se coloque.

 

Compruebe que los atributos de las propiedades se han definido correctamente.

 

Compruebe que los cambios de los elementos Web realizados en la vista personal no se reflejan en la vista compartida.

 

Compruebe que todas las propiedades públicas pueden enfrentarse a entradas incorrectas.

 

Compruebe que el elemento Web administra todas sus excepciones.

 

Compruebe que el elemento Web se procesa correctamente en Microsoft Office FrontPage.

 

Compruebe que las propiedades del elemento Web que aparecen en el panel de herramientas son fáciles de usar.

 

Compruebe que el elemento Web aparece correctamente en los resultados de búsquedas.

 

Compruebe que puede importar y exportar el elemento Web correctamente.

 

Compruebe que la vista previa del elemento Web se muestra correctamente.

 

Compruebe que el elemento Web puede obtener acceso a sus recursos con diferentes configuraciones de instalación.

 

Compruebe que las propiedades del elemento Web no dependen unas de otras.

 

Compruebe que los elementos Web funcionan correctamente con diferentes combinaciones de configuraciones zonas de elementos Web.

 

Compruebe que el elemento Web se procesa correctamente en función de los permisos de los usuarios.

 

Compruebe que funciona correctamente la adición de varias instancias del mismo elemento Web a una página de elementos Web (o en la misma zona de elementos Web).

 

Compruebe que el almacenamiento en caché del elemento Web funciona correctamente.

 

Compruebe que las solicitudes a otros sitios HTTP o servicios Web son asincrónicas.

Compruebe que puede agregar el elemento Web correctamente a una zona de elementos Web.

La adición de un elemento Web a una zona de elementos Web es la tarea que con más frecuencia realizan los usuarios. Por tanto, es esencial que el elemento Web funcione correctamente para que la experiencia del usuario sea buena.

Para probarlo

  1. Cree una nueva página de elementos Web.

  2. Haga clic en Editar pág. compartida, en Agregar elementos Web y, a continuación, en Importar.

  3. Importe el archivo .dwp del elemento Web.

  4. Agregue el elemento Web a una zona de elementos Web.

Compruebe que los elementos Web estáticos se procesan correctamente y no provocan un error en la página de elementos Web.

Los elementos Web que se colocan fuera de una zona de elementos Web o los elementos Web estáticos, se encuentran en las páginas .aspx, pero no en la zona de elementos Web. Al ser el elemento Web estático un control de formulario Web, ASP.NET procesa el elemento Web. No se pueden guardar los cambios en una vista personal o compartida.

Para probarlo

  1. Abra FrontPage.

  2. Cree una nueva página en blanco.

  3. En la vista Diseño, en el menú Datos, haga clic en Insertar Elemento Web.

  4. En la Galería de elementos Web que aparece en el panel de tareas, arrastre un elemento Web a la página.

  5. Guarde la página con formato .aspx.

  6. Vea la página en el explorador.

    Nota

    Asegúrese de que el elemento Web aparece entre etiquetas <form runat="server">.

  7. Compruebe que el elemento se procesa correctamente (por ejemplo, no debe ser posible guardar cambios en un elemento Web estático).

Compruebe que el elemento Web funciona correctamente independientemente de en qué parte de la página de elementos Web se coloque.

Puede agregar elementos Web a páginas de elementos Web que estén contenidas en una biblioteca de documentos, así como a páginas de elementos Web que estén contenidas en el sitio Web de nivel superior. Deben funcionar correctamente en ambas ubicaciones.

  1. Cree una página de elementos Web en una biblioteca de documentos.

    • Examine el sitio de portal.

    • En el menú Crear, haga clic en Página de elementos Web.

    • En el formulario de creación Nueva página de elemento Web, el valor Ubicación en la que desea guardar muestra las bibliotecas de documentos en las que se puede guardar el elemento Web. Seleccione una biblioteca de documentos y haga clic en Crear.

    • Importe el elemento Web de la galería.

  2. Cree una página de elementos Web en el sitio Web de nivel superior.

    • Abra un sitio de SharePoint en FrontPage.

    • En el menú Archivo, haga clic en Nuevo.

    • En la sección Nueva página del panel de tareas, haga clic en Más plantillas de páginas y, en la ficha Páginas de elementos Web, seleccione una plantilla.

    • Haga clic en una zona para que aparezca la galería (o en el menú Datos, haga clic en Insertar Elemento Web) y, a continuación, importe el elemento Web en una zona.

    • Guarde la página de elementos Web en el sitio Web de nivel superior, por ejemplo, en la misma ubicación en la que se encuentra el archivo default.aspx.

Compruebe que los atributos de las propiedades se han definido correctamente.

Puede especificar las propiedades del elemento Web de dos maneras: como un BLOB XML contenido en el elemento Web o como un atributo del elemento Web.

Debido a la manera en que la infraestructura del elemento Web trata los valores de las propiedades, se recomienda definir las propiedades como tipos simples en vez de como tipos complejos, para que funcionen correctamente si se especifican como atributos del elemento Web.

Para probarlo

  1. Cree un elemento Web estático en FrontPage y, en la vista Código, pruebe a establecer todas las propiedades que tenga el elemento Web como atributos.

  2. Examine la página y vea si la página falla o si se ignora la propiedad.

Compruebe que los cambios de los elementos Web realizados en la vista personal no se reflejan en la vista compartida.

Los cambios realizados en la vista compartida son visibles para todos los usuarios. Los cambios realizados en la vista personal sólo los debe poder ver la persona que los ha realizado.

Para probarlo

  1. Agregue el elemento Web a la vista compartida.

  2. Modifique las propiedades en la vista compartida.

  3. Cambie a la vista personal.

  4. Modifique las propiedades en la vista personal.

  5. Vuelva a la vista compartida y asegúrese de que el elemento Web no utiliza ninguno de los valores cambiados en la vista personal.

Compruebe que todas las propiedades públicas pueden enfrentarse a entradas incorrectas

Al igual que ocurre para todas las aplicaciones o controles de ASP.NET, se deben validar todas las entradas del usuario antes de realizar operaciones con estos datos. Esta validación puede ayudar a proteger no sólo frente a errores accidentales, sino también frente a ataques deliberados como inyección de SQL, ataques mediante secuencias de comandos en sitios cruzados, saturaciones del búfer, etc.

Para probarlo

  1. Compruebe que el elemento Web detecta las entradas no válidas de las propiedades y, además, informa al usuario final de que se han escrito datos incorrectos.

  2. Compruebe que la propiedad no se utiliza para un objetivo diferente al previsto. Por ejemplo, si se ha diseñado un elemento Web que permite a los usuarios vincular direcciones URL, limite el uso de protocolos al HTTP en vez de permitir que se guarde cualquier protocolo (por ejemplo, javascript://).

  3. Compruebe que el HTML del elemento Web codifica el valor de la propiedad al procesar la entrada del usuario en el cliente.

Compruebe todas las maneras posibles de cambiar los valores de las propiedades, por ejemplo:

  • Modificando el archivo .dwp en un editor de texto.

  • Modificando las propiedades en el panel de herramientas.

  • Modificando las propiedades en la vista Código de FrontPage.

  • Utilizando el componente de servicios de páginas de elementos Web (WPSC), que es un modelo de objetos en el cliente que proporciona una manera de establecer propiedades y hacer que persistan desde el explorador cliente.

Compruebe que el elemento Web administra todas sus excepciones.

Un elemento Web debe administrar todas las excepciones, en vez de arriesgarse a la posibilidad de provocar que la página de elementos Web deje de responder.

Para probarlo

Incluya casos de límites y de errores en las propiedades del elemento Web para comprobar que el elemento Web nunca destroza la página por no capturar algunas de sus propias excepciones.

Compruebe que el elemento Web se procesa correctamente en Microsoft Office FrontPage.

Si la organización utiliza FrontPage para personalizar los sitios de SharePoint, compruebe que el elemento Web se procesa correctamente en FrontPage. Para ello, el desarrollador del elemento Web debe implementar la interfaz IDesignTimeHtmlProvider.

Para probarlo

Abra una página de elementos Web que contenga el elemento Web en la vista Diseño de FrontPage. Compruebe que el elemento Web se procesa correctamente y que no aparece un mensaje indicando que no hay ninguna vista previa disponible para ese elemento.

Compruebe que las propiedades del elemento Web que aparecen en el panel de herramientas son fáciles de usar.

Como los usuarios utilizan el panel de herramientas para modificar las propiedades del elemento Web, es importante que los usuarios puedan trabajar fácilmente con las propiedades del elemento Web en él.

Para probarlo

  1. Agregue el elemento Web a una página de elementos Web. Haga clic en Editar pág. compartida, en Modificar elementos Web compartidos y, a continuación, seleccione el elemento Web. Aparecerá el panel de herramientas mostrando las propiedades del elemento Web.

  2. Compruebe que el nombre descriptivo es de fácil comprensión, por ejemplo, una propiedad llamada Mitexto debe aparecer como Mi texto (observe el espacio existente entre las dos palabras).

  3. Asegúrese de que la descripción (la información sobre herramientas que aparece) ayuda al usuario a conocer cómo y por qué debe establecer la propiedad.

  4. Compruebe que el nombre de categoría tiene sentido. (Se utiliza Varios cuando no se ha especificado ninguna categoría para la propiedad, pero no es especialmente útil para el usuario.)

  5. Compruebe que el orden de las propiedades tiene sentido.

  6. Si es adecuado, compruebe que estas propiedades se han localizado mediante el siguiente método:

    Tras instalar los paquetes de idiomas de SharePoint, cree un nuevo subsitio y seleccione otro idioma. Agregue el elemento Web a una página de elementos Web en el nuevo subsitio y compruebe que nombre descriptivo, descripción y categoría aparecen localizadas en el panel de tareas.

Compruebe que el elemento Web aparece correctamente en los resultados de búsquedas.

Como las galerías de elementos Web pueden contener numerosos elementos Web personalizados, la función de búsqueda ayuda a los usuarios a encontrar rápidamente los elementos Web deseados.

La infraestructura del elemento Web utiliza las propiedades Title y Description del elemento Web para crear el conjunto de resultados, por lo que una completa información en estos campos produce elementos Web que se pueden buscar con facilidad.

Para probarlo

  1. Agregue el elemento Web a la galería de elementos Web del sitio dirigiéndose a Configuración del sitio, haciendo clic en Ir a Administración de sitios, en Administrar galería de elementos Web y, a continuación, en Nuevo elemento Web.

  2. Seleccione el elemento Web que desea probar y, a continuación, haga clic en Llenar galería.

  3. Examine una página de elementos Web y, a continuación, haga clic en Editar pág. compartida, en Agregar elementos Web y, a continuación, en Buscar. Escriba el texto de búsqueda adecuado y haga clic en Buscar. Debe aparecer el elemento Web como una de las primeras opciones.

Compruebe que puede importar y exportar el elemento Web correctamente.

De manera predeterminada, siempre que se exporta un elemento Web, todas las propiedades del elemento Web se incluyen en el archivo .dwp. Sin embargo, debido a que las propiedades pueden contener información confidencial, por ejemplo, una fecha de nacimiento, se puede identificar una propiedad como controlada, lo que permite al usuario excluir el valor si se exporta un elemento Web. Sólo las propiedades que se exportan cuando el usuario se encuentra en la vista personal se pueden controlar; en la vista compartida, se exportan todos los valores de las propiedades.

Para probarlo

  1. Agregue un elemento Web de la galería a la página de elementos Web y establezca las propiedades del elemento Web.

  2. En el menú desplegable de cromo del elemento Web, haga clic en Exportar para exportar el elemento Web.

  3. Guarde el .dwp generado en el equipo local y vuelva a importar el elemento Web haciendo clic en Editar pág. compartida, en Agregar elementos Web y en Importar.

  4. Busque el archivo .dwp, haga clic en Cargar y, a continuación, en Importar

  5. Asegúrese de que las propiedades exportadas se importan correctamente.

  6. Compruebe que todas las propiedades que no tendría sentido exportar (por ejemplo, el número de la seguridad social) tienen establecido el atributo ExportControlledProperties. (La casilla de verificación Allow Export Sensitive Properties del panel de herramientas debe estar desactivada.)

Compruebe que la vista previa del elemento Web se muestra correctamente.

Es importante crear vistas previas de los elementos Web de modo que los administradores puedan revisar los elementos incluidos en la galería de elementos Web.

Para probarlo

  1. Vaya a Configuración del sitio, haga clic en Ir a Administración de sitios, en Administrar galería de elementos Web y, a continuación, en el elemento Web. Debe procesarse la vista previa.

  2. Compruebe que no haya errores en las secuencias de comandos.

  3. Compruebe que la vista previa aparece correctamente.

Compruebe que el elemento Web puede obtener acceso a sus recursos con diferentes configuraciones de instalación.

Los recursos de elementos Web no pueden formar parte de la DLL ya que debe ser posible tener acceso a ellos desde una dirección URL. Entre los ejemplos de estos recursos se encuentran imágenes, archivos .js o páginas .aspx.

Para probarlo

Nota

Debido a que un ensamblado de elemento Web se puede instalar tanto en el directorio bin (<%UnidadSistema >\:Inetpub\wwwroot\bin) o en la caché de ensamblados global, debe realizar cada uno de estos pasos con el elemento Web instalado en el bin y otra vez con el elemento Web instalado en la caché de ensamblados global.

Agregue el elemento Web a su página en todos los siguientes escenarios y asegúrese de que es posible tener acceso correctamente a sus recursos:

  • Agregue el elemento Web al sitio Web de nivel superior.

  • Agregue el elemento Web a un subsitio con permisos únicos, en el que el usuario sólo tenga derechos en el subsitio.

  • Agregue el elemento Web a una página de elementos Web dentro de una carpeta de una biblioteca de documentos.

  • Agregue un elemento Web a un sitio con la creación personalizada de sitios habilitada en el servidor virtual.

  • Agregue un elemento Web a un sitio con el modo de encabezado de host habilitado.

  • Agregue el elemento Web a un sitio en el que el sitio Web de nivel superior no sea un sitio de SharePoint, por ejemplo, http://nombreservidor/URLpersonalizada.

  • Agregue el elemento Web a las páginas de elementos Web que estén en diferentes idiomas de subsitios.

Compruebe que las propiedades del elemento Web no dependen unas de otras.

Como no es posible saber con seguridad el orden en el que las propiedades se establecen en el panel de herramientas, se debe evitar escribir propiedades de elementos Web que dependan unas de otras.

Para probarlo

Pruebe diferentes valores de las propiedades en el panel de herramientas.

Nota

Si una propiedad no es visible en la interfaz de usuario o está deshabilitada, puede abrir la página de elementos Web en FrontPage, cambiar a la vista Código y, a continuación, establecer las propiedades modificando el XML. Exporte el elemento Web, guarde el archivo .dwp y, a continuación, modifique el archivo .dwp.

  1. Importe el archivo .dwp en la página y compruebe los valores de las propiedades.

Compruebe que los elementos Web funcionan correctamente con diferentes combinaciones de configuraciones de zonas de elementos Web.

Las zonas de elementos Web tienen propiedades que controlan si un usuario puede hacer que los cambios persistan. Si un usuario intenta guardar los cambios en un elemento Web sin los permisos correctos, puede obtenerse una página rota.

Las siguientes propiedades de zona de elementos Web afectan a los elementos Web de la zona:

  • AllowCustomization. Si es false y el usuario ve la página en la vista compartida, el elemento Web no puede hacer que persista ningún cambio de la base de datos.

  • AllowPersonalization. Si es false y el usuario ve la página en la vista personal, el elemento Web no puede hacer que persista ningún cambio de la base de datos.

  • LockLayout . Si es true, los cambios realizados a las propiedades AllowRemove, AllowZoneChange, Height, IsIncluded, IsVisible, PartOrder, Width y ZoneID no persistirán en la base de datos, independientemente de la vista.

Para probarlo

  1. Cree una página en el explorador y, a continuación, agregue el elemento Web en varias zonas, tanto en las vistas compartida como personal.

  2. Abra FrontPage. Abra una página de elementos Web en un sitio de SharePoint y, en la vista Diseño, haga doble clic en una zona de elementos Web (o haga clic con el botón secundario sobre una zona de elementos Web y, a continuación, en el menú contextual, haga clic en Propiedades del área de elementos Web). A continuación, cambie las propiedades de la zona. También puede cambiar a la vista Código y escribir los atributos del control de la zona de elementos Web.

  3. Vea la página en el explorador.

  4. Compruebe que el elemento no hace que la página deje de funcionar y se comporta correctamente.

  5. Compruebe que cualquier interfaz de usuario que aparezca en el elemento Web indica al usuario que los cambios no persistirán o que se ha deshabilitado la interfaz de usuario, según corresponda a la configuración de la zona.

Compruebe que el elemento Web se procesa correctamente en función de los permisos de los usuarios.

Como el usuario es el que administra el elemento Web en tiempo de ejecución, el elemento Web debe procesarse con una interfaz de usuario que sea apropiada para cada uno de los permisos del usuario.

Para probarlo

  • Pruebe con diferentes cuentas de usuario que tengan únicamente derechos de lector o colaborador.

  • Asegúrese de que la interfaz de usuario se suprime si el usuario final no tiene los permisos necesarios para realizar una determinada acción. (Por ejemplo, si un elemento Web muestra un botón Guardar, debe ocultarse o deshabilitarse si el usuario no tiene permiso para realizar dicha acción.)

  • Active el acceso anónimo al sitio y examine una página de elementos Web que tenga su elemento Web, pero asegúrese de que el botón de inicio de sesión sigue estando visible en la página. (Cuando el botón de inicio de sesión aparece en la página es que todavía no se ha autenticado al usuario.)

Compruebe que funciona correctamente la adición de varias instancias del mismo elemento Web a una página de elementos Web (o en la misma zona de elementos Web).

Si desea que varios elementos Web compartan una secuencia de comandos en el cliente, debe colocar la secuencia de comandos en un archivo externo y registrar la secuencia de comandos en la página para mejorar el rendimiento y simplificar el mantenimiento.

Para probarlo

  1. Agregue varias instancias del elemento Web a la página. Asegúrese de ejecutar cualquier secuencia de comandos en el cliente que sea específica del elemento Web.

  2. Agregue varias instancias del elemento Web a la misma zona de elementos Web. Asegúrese de ejecutar cualquier secuencia de comandos en el cliente que sea específica del elemento Web.

Compruebe que el almacenamiento en caché del elemento Web funciona correctamente.

Para realizar cualquier operación que trabaje con una gran cantidad de datos, utilice la caché de elementos Web para almacenar los valores de las propiedades y acelerar la recuperación de datos.

Los creadores de elementos Web pueden elegir almacenar en caché los datos de varias maneras, pero en última instancia, es el administrador quien decide el tipo de almacenamiento en caché que utiliza un elemento Web.

A continuación, se muestran tres tipos de caché:

  • None, que desactiva el almacenamiento en caché.

  • Database, que utiliza la base de datos de contenido (y requiere que se serialicen todos los objetos).

  • CacheObject, que utiliza el objeto Cache de ASP.NET (el predeterminado).

Para probarlo

El tipo de caché se establece mediante el valor del elemento WebPartCache del archivo web.config.

  1. En el archivo web.config, cambie la instrucción <WebPartCache Storage="CacheObject"> a <WebPartCache Storage="Database"> y asegúrese de que el elemento Web sigue funcionando correctamente.

  2. Cambie la instrucción a <WebPartCache Storage="None"> y asegúrese de que el elemento Web sigue funcionando correctamente.

    Nota

    De manera predeterminada, las excepciones relacionadas con el almacenamiento en caché no las muestra la infraestructura de elementos Web. Sólo con el objetivo de realizar la depuración, puede hacer los siguientes cambios en el archivo web.config.

    En la etiqueta <system.web>, busque la etiqueta <customErrors mode="On"> y cámbiela a <customErrors mode="Off"> para ver la excepción ASP.NET que se genera cuando se produce un error en vez de ser redireccionado a la página de error.

    En la etiqueta <SharePoint>, busque la etiqueta <SafeMode MaxControls="50" CallStack="false"/> y cámbiela a <SafeMode MaxControls="50" CallStack="true"/>. Al hacer esto, se mostrará el mensaje de error de ASP.NET con información sobre la pila de seguimiento.

Compruebe que las solicitudes a otros sitios HTTP o servicios Web son asincrónicas.

Por motivos de rendimiento, debe utilizar un subproceso asincrónico para cualquier operación que trabaje con una gran cantidad de datos.

Para probarlo

  • Consulte al desarrollador para ver si realiza alguna llamada a servicios Web o a otros sitios HTTP. Confirme que las llamadas son asincrónicas.

  • Ejecute algunas pruebas de rendimiento en una página con el elemento Web.

Conclusión

Los elementos Web son elementos clave de los productos y las tecnologías de Microsoft SharePoint. Si sigue las instrucciones descritas en este artículo, podrá asegurarse de que los elementos Web de los que es responsable estarán protegidos, bien escritos y se integrarán bien con los demás componentes de la página.

Recursos adicionales

Información de centro de desarrollo

Artículos

Best Practices for Creating Web Parts for Microsoft SharePoint Products and Technologies (en inglés)

Mostrar: