Blogger invitado: Rob Yonaitis, fundador de HiSoftware - Personalización de la barra de edición del sitio para incluir la validación del contenido para el panorama del contenido web en MOSS

En las últimas semanas, muchas personas me han preguntado cómo implementar la validación del contenido como un nuevo elemento en el menú para los usuarios en Microsoft SharePoint, de forma tal que se pueda realizar la validación y también incluir orientación e instrucciones. Otro pedido ha sido la posibilidad de evaluar la accesibilidad en otros idiomas además del inglés; más precisamente, en español, italiano y francés. Esta respuesta cubrirá todos estos asuntos. Este documento cubre la validación del contenido para:

• Accesibilidad
• Control de los enlaces
• Validez del marcado(markup) (X)HTML

Para seguir las instrucciones, sólo se necesita tener instalado el SharePoint, o puede simplemente descargar el Microsoft Office SharePoint Server 2007 VHD que contiene todo el software necesario. El enlace para descargar es este: (http://www.microsoft.com/downloads/details.aspx?FamilyID=67f93dcb-ada8-4db5-a47b-df17e14b2c74&DisplayLang=en). Como herramientas de evaluación, se mencionarán los siguientes enlaces:

• El software Hera de la Fundación Sidar: http://sidar.org/hera/
• El servicio de validación de markup del W3C: http://valitador.w3.org/
• El servicio de control de enlaces del W3C: http://valitador.w3.org/checklink/

Para satisfacer los fines de esta evaluación y código, este documento hará referencia a estos sitios externos y la validación se va a ejecutar externamente. Sin embargo, esto no siempre será posible, por eso se recomiendo la descarga de los servidores de validación a su servidor local, para no tener que preocuparse por que los datos del servidor anden circulando por la web. Este ejemplo es autosuficiente y no requiere de referencias externas. Si le parece que falta algo, por favor contacte al creador: Robert B. Yonaitis @ ryonaitis@gmail.com.

Figura 1 - Interfaz de MOSS con el producto final con la validación del contenido integrada.

Fíjese que el elemento en el menú "Validación" contiene estas tres pruebas: Validar la accesibilidad con Hera, Validar los enlaces con el Control de Enlaces del W3C y Validar el marcado (markup) con el W3C Validator. Para crear este elemento en el menú necesitamos seguir los siguientes pasos:

1. Edite el archivo CustomEditingMenu.XML usando SharePoint Designer
2. Realice un IIS Reset en la máquina de Litwaredemo
3. Evalúe sus páginas.

Con este método, no se necesita compilar ni escribir códigos fuente. Así que, ¡comencemos!

Edición del archivo CustomEditingMenu.XML

Para AGREGAR elementos al Menú de Edición es necesario modificar o agregar el archivo CustomEditingMenu.XML. Por defecto, la imagen litwaredemo viene con un archivo CustomEditingMenu.XML en blanco. Este archivo es el que editaremos para proporcionar la validación del contenido.

1. Abra WIN03_MOSS.VHD
2. Abra el SharePoint Designer desde el LITWAREDEMO VHD al sitio de MOSS.

a. Seleccione Inicio
b. Seleccione Todos los programas
c. Seleccione Microsoft Office
d. Seleccione Microsoft Office SharePoint Designer
e. Seleccione Archivo del Menú de SharePoint Designer
f. Seleccione Sitio Abierto del Menú de Share Point Designer
g. Introduzca http://localhost/ en la casilla de ingreso del nombre del sitio
h. Seleccione Abrir
i. Regístrese si es necesario: El usuario y la contraseña por defecto son: Administrator / pass@word1

3. Busque en la lista _catalogs / masterpage / Editing Menu
4. Abra el archivo CustomEditingMenu.XML en el SharePoint Designer
5. Reemplace su contenido con el siguiente (nota: se asume que el archivo no ha sido modificado antes y que se trabajará con la imagen desde cero).

<?xml version="1.0" encoding="utf-8" ?>
<Console>
  <references>
    <reference TagPrefix="cms"
    assembly="Microsoft.SharePoint.Publishing, Version=12.0.0.0,
    Culture=neutral, PublicKeyToken=71e9bce111e9429c"
    namespace=
    "Microsoft.SharePoint.Publishing.WebControls.EditingMenuActions" />
  </references>
  <structure>
    <ConsoleNode ConfigMenu="Add" Sequence="600"
      NavigateUrl="BLOCKED SCRIPT" AccessKey="L" DisplayText="Validation"
      UserRights="EmptyMask" UseResourceFile="false"
      RequiredStates="InSharedView" ID="LinksMenu" >
      <ConsoleNode
        DisplayText="Validate Accessibility with Hera"
        UseResourceFile="false"
        ImageUrl="/_layouts/images/ActionsSettings.gif"
        UserRights=" AddAndCustomizePages"
        RequiredRightsMode="Any"
        PermissionContext="CurrentSite"
        IsSiteRelative="False"

NavigateUrl="BLOCKED SCRIPTwindow.open('http://www.sidar.org/hera/index.php?url='+window.location+'?PagePreview=true');"
        ChangedNodeID="">
      </ConsoleNode>
      <ConsoleNode
        DisplayText="Validate Links with the W3C Link Checker"
        UseResourceFile="false"
        ImageUrl="/_layouts/images/ActionsSettings.gif"
        UserRights=" AddAndCustomizePages"
        RequiredRightsMode="Any"
        PermissionContext="CurrentSite"
        IsSiteRelative="False"

NavigateUrl="BLOCKED SCRIPTwindow.open('http://validator.w3.org/checklink?uri='+window.location+'?PagePreview=true+&amp;hide_type=all&amp;depth=&amp;check=Check');"
        ChangedNodeID="">
      </ConsoleNode>
      <ConsoleNode
        DisplayText="Validate Markup with the W3C Validator"
        UseResourceFile="false"
        ImageUrl="/_layouts/images/ActionsSettings.gif"
        UserRights=" AddAndCustomizePages"
        RequiredRightsMode="Any"
        PermissionContext="CurrentSite"
        IsSiteRelative="False"

NavigateUrl="BLOCKED SCRIPTwindow.open('http://validator.w3.org/check?uri='+window.location+'?PagePreview=true');"
        ChangedNodeID="">
      </ConsoleNode>
    </ConsoleNode>
  </structure>
</Console>

6. Seleccione Archivo | Guardar del Menú del SharePoint Designer
7. Registre el archivo si es necesario
8. Publique una Versión Mayor
9. Cierre SharePoint Designer
10. Desde el Menú Comenzar, seleccione Comenzar | Ejecutar
11. Escriba IISRESET en la casilla de ingreso de texto
12. Presione OK
13. Cuando el IISRESET se haya completado, abra su página http://litwaredemo/pages/default.as

Verá que ahora tiene tres elementos en el menú debajo del elemento Validación

Algunas explicaciones de los nodos

Este documento cubre un terreno muy amplio y creo que es tiempo de volver un poco atrás y explicar un poco la validación, para esto utilizaremos el nodo de validación de accesibilidad de Hera.

 <ConsoleNode
        DisplayText="Validate Accessibility with Hera"
        UseResourceFile="false"
        ImageUrl="/_layouts/images/ActionsSettings.gif"
        UserRights=" AddAndCustomizePages"
        RequiredRightsMode="Any"
        PermissionContext="CurrentSite"
        IsSiteRelative="False"

NavigateUrl="BLOCKED SCRIPTwindow.open('http://www.sidar.org/hera/index.php?url='+window.
location+'?PagePreview=true');"
        ChangedNodeID="">

En el nodo Console necesitamos establecer los valores requeridos para implementar la Validación de la Accesibilidad. La mayoría de los elementos son fáciles de entender pero, de todas formas, adjunto una

Explicación: 

• DisplayText - El atributo DisplayText (mostrar texto) se utiliza para nombrar el texto del elemento del menú que el usuario verá en la Figura 1 de este documento, y puede ser configurada por el creador del sitio.
• UseResourceFile - Por defecto, está seleccionada la opción "falso" para todas las validaciones
• ImageURL - Este atributo asigna la imagen del elemento del menú que será el archivo actionssettings.gif y puede ser configurada por el creador del sitio.
• UsersRights  - El atributo UsersRights describe los derechos necesarios para ver el nodo que se está describiendo. Para ver una lista completa de los valores disponibles, que luego podrá personalizar, diríjase a la siguiente página de MSDN: http://msdn.microsoft.com/en-us/library/microsoft.sharepoint.spbasepermissions.aspx
• RequiresRightsMode - El atributo RequiredRightsMode está preestablecido en "alguno" por defecto.
• PermissionContext - El atributo PermissionContext está establecido en el CurrentSite. Para ver una lista completa de los valores disponibles, que luego podrá personalizar, diríjase a la página de MSDN: http://msdn.microsoft.com/en-us/library/microsoft.sharepoint.utilities.permissioncontext.aspx
• IsSiteRelative - El atributo IsSiteRelative está marcado como falso. Esto es muy importante, ya que le avisa al sistema que el enlace NavigateUrl no es relativo al sitio de MOSS en el que uno se encuentra, de modo que este no reconocerá las páginas llamadas al sitio actual. Si no estuviera marcado como falso, el enlace terminaría siendo algo como esto: http://litwaredemo/Pages/BLOCKED SCRIPTwindow.open('http://www.sidar.org/hera/index.php?url='+window.location+'?PagePreview=true');"
• NavigateURL - El atributo NavigateURL es donde se define qué página evaluar y en qué sitio evaluaremos el sitio, y en este ejemplo entra Hera. Observe que Hera detectará el idioma de su buscador y le proporcionará la página en el idioma correspondiente.

Figura 2 - Informe de Hera

Cierre

El documento que acaba de leer está diseñado para que funcione con sitios que están disponibles en la web. Si usted hará esto en una intranet, deberá descargar e instalar los programas de evaluación en su servidor. Todas las herramientas de evaluación seleccionadas para este documento se pueden descargar. Observe que el NavigateURL cambiará si usted utiliza un servidor de validación diferente del que usamos en este ejemplo.

Próximos documentos

• Cómo desplegar esta solución como una característica en un grupo de servidores
• Cómo crear un workflow simple que aproveche estos elementos
• Cómo crear sitios MOSS que generen xhtml válido