# Manual de Accerciser v0.2.0

2006
2007
2008
IBM Corporation
2007-2010
Jorge González (jorgegonz@svn.gnome.org)
Proyecto de documentación de GNOME
Eitan
Isaacson
Equipo de Accerciser

     eitan@ascender.com

Peter
Parente
Equipo de Accerciser

     pparent@us.ibm.com

Manual de Accerciser v0.2.0
2007-06-29

Eitan Isaacson eitan@ascender.com

Equipo de Accerciser

Este manual describe la versión 0.1.5 de Accerciser.

Este manual describe el uso de Accerciser.

## Comentarios

Para informar de un fallo, o hacer alguna sugerencia concerniente a la aplicación Accerciser o este manual, siga las indicaciones en la Página de comentarios de GNOME.

## Introducción

Accerciser es un explorador de accesibilidad interactivo escrito en Python para el escritorio GNOME. Usa AT-SPI para inspeccionar y controlar los widgets, permitiéndole comprobar si una aplicación está proporcionando la información correcta a las tecnologías de asistencia y entornos de trabajo de prueba automáticos. Accerciser tiene un entorno de complementos simple que puede usar para crear sus vistas personalizadas de la información de accesibilidad.

En esencia, Accerciser es la siguiente generación de la herramienta at-poke.

## Inicio

### Para iniciar Accerciser

Puede iniciar Accerciser de las siguientes formas:

Menú Aplicaciones

  Elija el elemento del menú Programación Accerciser.

Línea de comandos

  Escriba el siguiente comando en una ventana de consola y después pulse Retorno:

  `accerciser`

### Al iniciar Accerciser

Se mostrará la siguiente ventana cuando inicie Accerciser.

#### Ventana principal de Accerciser

Muestra la ventana principal de Accerciser. Contiene la barra de título, la barra de menú, el árbol accesible, el área izquierda de visualización de complemento y el área inferior de visualización de complemento. La barra de menú contiene los menús de Archivo, Editar, Ver y Ayuda.

La ventana principal de Accerciser contiene los siguientes elementos:

Barra de menú

  La barra de menú contiene comandos para gestionar los complementos, gestionar y usar los marcadores, refrescar la vista de árbol accesible y acceder a este sistema de ayuda.

Vista de árbol accesible

  La vista de árbol accesible le permite ver todos los accesibles, comenzando por el nivel del escritorio. Seleccionar un accesible lo hace disponible para futuras inspecciones usando los complementos cargados.

Vista derecha de complemento

  Esta es una de las dos vistas de complemento predeterminadas. Cuando Accerciser se ejecuta por primera vez, la mayoría de los complementos residirán aquí. Puede arrastrar las solapas de complementos a la vista inferior de complemento o al escritorio para mostrar dos o más complementos simultaneamente.

Vista inferior de complemento

  Puede arrastrar complementos a o desde esta área igual que en la vista derecha de complemento.

### Gestión de la vista de complementos

Accerciser tiene dos modelos para ver complementos. El modo de vista actual se puede conmutar pulsando Ver Vista individual de complementos o pulsando Controlt. Cuando el modo individual está activado, todos los complementos se pondrán en la vista de complemento superior derecha ordenados alfabéticamente, útil para los usuarios de lectores de pantalla que no pueden usar el flexible esquema espacial de mostrado de complementos de Accerciser. Cuando la vista individual de complemento está desactivada se pueden arrastrar y soltar solapas de complementos en las diferentes vistas de complementos, o se pueden arrastrar al escritorio para mostrar el complemento dado en una nueva vista. También se puede manipular el emplazamiento de los complementos con el menú contextual del complemento que puede aparecer tanto de la solapa del complemento como del diálogo de preferencias del mismo.

## Uso

Puede usar Accerciser para inspeccionar cualquier widget accesible mostrado en la vista de árbol usando los complementos disponibles. El primer paso es seleccionar un accesible a inspeccionar usando uno de los siguientes métodos:

### Seleccione un accesible a través de la ventana de árbol.

Use la vista en árbol para navegar por la jerarquía de objetos accesibles originarios del escritorio. Desplegar un nodo del árbol revela sus hijos inmediatos mientras que plegarlo los oculta. Cada nodo muestra un icono para su aplicación asociada o el rol del widget y, si está disponible, su nombre accesible. La segunda columna lista el número de nodos que se mostrarán si el elemento de despliega.

### Uso de los marcadores

Accerciser permite marcar los accesibles seleccionados para examinarlos posteriormente. Esto puede ser útil si la aplicación objetivo debe reiniciarse, por ejemplo, después de reconstruirla. Para marcar el accesible seleccionado actualmente pulse Marcadores Añadir marcador... o pulse Controld.

Los marcadores a accesibles en Accerciser están definidos por el nombre de la aplicación y una «ruta» en la jerarquía interna del accesible de la aplicación al accesible marcado. Cuando la aplicación objetivo está en un estado diferente (ej. múltiples marcos de nivel superior) puede que la ruta no sea correcta.

Los marcadores se pueden gestionar accediendo al diálogo de edición de marcadores a través de Marcadores Editar marcadores....

## Complementos predeterminados

Accerciser viene con varios complementos predeterminados. Estos complementos le permiten ver una variedad de información acerca del accesible actualmente seleccionado en la vista de árbol y sus vecinos. Los complementos predeterminados disponibles en la versión 0.1.5 son los siguientes:

### Visor de interfaces

Este complemento muestra información acerca de los interfaces disponibles para el accesible de vista de árbol seleccionado. Los interfaces no soportados se sombrean. Bajo cada expansor hay disponibles varios instrumentos para ver y controlar un interfaz.

#### Visor de interfaces

Los interfaces que están soportados por el accesible seleccionado se mostrarán como sensitivos.

### Monitor de eventos

Este complemento monitoriza los tipos de eventos seleccionados desde la vista en árbol accesible, desde la aplicación de vista en árbol o de todo el escritorio.

#### Monitor de eventos

La parte inferior de la ventana del monitor de eventos le permite seleccionar el tipo y la fuente de los eventos.

Presionando ControlAltl en cualquier parte del escritorio, se resaltará el último evento registrado para una referencia posterior. Consulte la para saber cómo cambiar esta combinación de teclas.

### Consola IPython

Este complemento es una consola IPythin completa. Pulse Tab para mostrar completo el comando actual. Pulse Retorno para ejecutar cualquier código Python válido. Los comandos en la consola tienen acceso al accesible actualmente seleccionado en el árbol accesible a través de la variable `acc`. Además, todas las funciones y constantes del paquete pyatspi están disponibles, como locales, en la consola. Lo más importante de esto son las funciones para consultar otros interfaces de accesibilidad. Por ejemplo, para consultar el interfaz de texto: `t = acc.queryText()` . También se permite importar desde el directorio de trabajo actual o desde ruta Python.

### Examinador API

Este complemento muestra las interfaces, métodos y atributos soportados por el accesible seleccionado en la vista de árbol.

#### Examinador API

El examinador API.

### Script grabador

El script grabador de Accerciser permite a los usuarios grabar la interacción del teclado con otras aplicaciones del escritorio para autorizar los scripts de prueba para el IU. Actualmente el complemento soporta la generación de scripts para tres plataformas: Dogtail, LDTP y el API integrado de Accerciser. Una vez que pulse el botón «Grabar» se grabará toda interacción de teclado en un script que podrá ser ejecutado más tarde, como un script individual.

#### Script grabador

Es script grabador.

### Selección rápida

Este complemento proporciona combinaciones de teclas globales para permitir una rápida selección de los accesibles a través del IU de la aplicación objetivo. Al pulsar ControlAlta se seleccionará el accesible del widget que tuvo el foco por última vez en Accerciser. Al pulsar ControlAltt se seleccionará el accesible del widget que está bajo el puntero.

### Validación

Este complemento comprueba los problemas de accesibilidad de las aplicaciones y genera un informe incluyendo la gravedad y la descripción de los problemas. El informe enlaza los errores con la documentación acerca de cómo solucionar los problemas comunes. El complemento es extensible con esquemas de prueba que definen reglas de validación.

Para ejecutar el validador, seleccione un elemento en el árbol de accesibilidad. El complemento comprobará el accesible seleccionado y todos sus descendientes. Después seleccione un esquema que usar para la comprobación. A continuación pulse el botón Validar para iniciar la comprobación. Pulse de nuevo el botón mientras se está ejecutando la comprobación para cancelarla.

La tabla de informe mostrará la gravedad y descripción de todos los errores cuando termine la comprobación. Pulse dos veces sobre una fila de la tabla para mostrar el accesible asociado en el árbol. Con un elemento seleccionado, pulse el botón Ayuda para obtener información acerca de cómo resolver el problema.

## Preferencias

Hay algunos elementos en Accerciser que son configurables:

### Disposición de complementos

Hay dos métodos para configurar la disposición de los complementos en Accerciser. Primeramente, debe elegir Editar Preferencias para activar el diálogo Preferencias. Éste diálogo contiene solapas para cada sección, seleccione la solapa Complementos. Bajo esta sección encontrará una lista de todos los complementos disponibles. Pulse con el botón derecho del ratón sobre cualquiera de los complementos listados para configurar su vista.

Puede querer evitar el diálogo Preferencias usando arrastrar y soltar para mover las solapas de los complementos. Arrastrar una solapa de un complemento a la parte inferior o derecha del área de los complementos en la ventana principal, moverá el complemento. Arrastrar una solapa al escritorio creará una nueva ventana de complemento y soltará el complemento en ella.

### Configuración global de teclas rápidas

Algunos elementos en Accerciser pueden activar cierta funcionalidad a través de las teclas rápidas. La combinación de teclas rápidas puede cambiarse a través del diálogo Preferencias, para hacerlo debe seleccionar Editar Preferencias para activar el menú Preferencias. Éste diálogo contiene solapas para cada sección, seleccione la solapa Teclas rápidas globales. Bajo esta sección encontrará una lista de todas las teclas rápidas disponibles. Cambie la combinación de teclas a su gusto.

## Acerca de Accerciser

Eitan Isaacson (eitan@ascender.com) escribió Accerciser. Para obtener más información acerca de Accerciser, visite la página de Accerciseren GNOME Live!.

Para informar de un fallo, o hacer alguna sugerencia concerniente a esta aplicación o este manual, siga las indicaciones en este documento.

Se permiten la redistribución y uso en formas binaria y fuentes, con o sin modificación bajo los términos de la licencia BSD.