# Manuel d'Accerciser v0.2.0

2006
2007
2008
IBM Corporation
2007
Robert-André Mauchin (zebob.m@pengzone.org)
2008
Claude Paroz (claude@2xlibre.net)
Projet de documentation GNOME
Eitan
Isaacson
Équipe d'Accerciser

     eitan@ascender.com

Peter
Parente
Équipe d'Accerciser

     pparent@us.ibm.com

Manuel d'Accerciser v0.2.0
29/06/2007

Eitan Isaacson eitan@ascender.com

Équipe d'Accerciser

Ce manuel documente la version 0.2.0 d'Accerciser.

Ce manuel documente l'utilisation d'Accerciser.

## Votre avis

Pour rapporter une anomalie ou émettre une suggestion concernant Accerciser ou ce manuel, procédez comme indiqué sur la page de réactions sur GNOME.

## Introduction

Accerciser est un explorateur d'accessibilité interactif en Python pour le bureau GNOME. Il utilise AT-SPI pour inspecter et commander les composants graphiques (widgets), vous permettant ainsi de vérifier si une application fournit des informations correctes aux aides techniques et environnements de tests automatisés. Accerciser a une structure de greffon simple que vous pouvez utiliser pour créer des vues personnalisées des informations d'accessibilité.

Par définition, Accerciser est un outil at-poke de dernière génération.

## Premiers pas

### Lancement d'Accerciser

Vous pouvez lancer Accerciser des manières suivantes :

Menu Applications

  Choisissez l'élément de menu Programmation Accerciser.

Ligne de commande

  Saisissez la commande suivante dans une fenêtre de terminal et appuyez sur la touche Entrée :

  `accerciser`

### Démarrage d'Accerciser

Lors du démarrage d'Accerciser, la fenêtre suivante est affichée.

#### Fenêtre principale d'Accerciser

Affiche la fenêtre principale d'Accerciser. Contient la barre de titre, la barre de menus, l'arbre d'accessibilité, la zone d'affichage des greffons de droite et la zone d'affichage des greffons du bas. La barre de menus comporte les menus Fichier, Édition, Signets, Affichage et Aide.

La fenêtre principale d'Accerciser contient les éléments suivants :

Barre de menus

  La barre de menus contient les commandes pour gérer les greffons, organiser et utiliser les signets, actualiser l'arbre d'accessibilité et accéder au sommaire de l'aide.

Arbre d'accessibilité

  L'arbre d'accessibilité permet de voir tous les éléments accessibles dès le niveau du bureau. En sélectionnant un élément accessible, vous pouvez l'inspecter plus en détails en utilisant les greffons chargés.

Zone des greffons de droite

  C'est l'une des deux zones de greffons. Lorsqu'Accerciser est lancé pour la première fois, la plupart des greffons seront placés ici. Vous pouvez déplacer les onglets de greffons vers la zone de greffons du bas ou vers le bureau pour afficher deux greffons ou plus simultanément.

Zone des greffons du bas

  Vous pouvez déplacer des greffons à partir de cette zone ou vers celle-ci comme pour la zone des greffons de droite.

### Gestion des zones de greffons

Accerciser a deux modes pour accéder aux greffons. Vous pouvez basculer le mode de vue actuel avec le menu Affichage Vue unique des greffons ou en appuyant sur CTRL T. Lorsque la vue unique est activée, tous les greffons sont placés dans la zone des greffons en haut à droite et classés par ordre alphabétique. Ceci peut être utile pour les utilisateurs de lecteur d'écran qui ne font pas usage de la disposition spatiale flexible des greffons.Lorsque la vue unique est désactivée, les onglets de greffons peuvent être glissés et déposés dans les différentes zones de greffons, ou déplacés sur le bureau pour créer une nouvelle zone pour le greffon. La position des greffons peut également être modifiée avec le menu contextuel de greffon, qui peut être affiché soit depuis l'onglet du greffon, soit depuis la boîte de dialogue des préférences du greffon.

## Utilisation

Vous pouvez utiliser Accerciser pour inspecter n'importe quel composant accessible dans l'arbre en utilisant les greffons disponibles. La première étape est de sélectionner un élément accessible à inspecter en utilisant l'une des méthodes suivantes :

### Sélection d'un élément accessible via l'arbre d'accessibilité

Utilisez l'arborescence pour naviguer dans la hiérarchie des objets accessibles dont la racine est le bureau. Le développement d'un nœud de l'arbre présente ses fils immédiats, alors qu'ils disparaissent si vous le repliez. Chaque noeud dispose d'une icône correspondant à son application ou à son rôle de composant, ainsi que son nom d'élément accessible, le cas échéant. La deuxième colonne présente la liste des nœuds qui seront affichés si l'élément est développé.

### Utilisation des signets

Accerciser permet d'insérer des signets pour les éléments accessibles sélectionnés afin de les examiner ultérieurement. Ceci peut être pratique si l'application cible doit être redémarrée, par exemple après l'avoir reconstruite. Pour insérer un signet sur l'élément accessible sélectionné, cliquez sur Signets Ajouter un signet ou appuyez sur Ctrl D.

Dans Accerciser, les signets vers les éléments accessibles sont définis par un nom d'application et un « chemin » vers l'élément accessible dans la hiérarchie des éléments accessibles interne à l'application. Quand l'application cible est dans un état différent (par ex. plusieurs cadres de niveau supérieur), le chemin peut ne pas être correct.

Les signets peuvent être gérés en accédant à la boîte de dialogue d'édition des signets via le menu Signets Éditer les signets.

## Greffons par défaut

Accerciser est fourni avec de nombreux greffons par défaut. Ces greffons vous permettent de visualiser des informations variées concernant l'élément accessible sélectionné dans l'arbre et ses voisins. Les greffons suivants sont disponibles dans la version 0.1.5 :

### Visionneur d'interface

Ce greffon affiche des informations concernant les interfaces disponibles pour l'élément accessible sélectionné dans l'arbre. Les interfaces non prises en charge sont grisées. Différents instruments pour visualiser et contrôler une interface sont disponibles sous chaque icône d'extension.

#### Visionneur d'interface

Les interfaces prises en charge par l'élément accessible sélectionné sont affichées comme sensitives.

### Moniteur d'événements

Ce greffon surveille les types d'événements sélectionnés depuis l'élément accessible sélectionné dans l'arbre, pour une application donnée, ou pour le bureau complet.

#### Moniteur d'événements

La partie basse de la fenêtre du moniteur d'événements vous permet de choisir le type et la source des événements.

Vous pouvez mettre en évidence le dernier événement journalisé pour un usage futur en appuyant sur Ctrl Alt L n'importe où sur le bureau. Référez-vous à pour modifier cette combinaison de touches.

### Console IPython

Ce greffon est une console

### Navigateur d'API

Ce greffon affiche les interfaces, méthodes et attributs pris en charge par l'élément accessible sélectionné dans l'arbre.

#### Navigateur d'API

Le navigateur d'API

### Enregistreur de script

L'enregistreur de script de Accerciser permet aux utilisateurs d'enregistrer les interactions du clavier avec les autres applications du bureau afin de générer des scripts de test de l'interface utilisateur. Le greffon prend actuellement en charge la construction de script pour trois plateformes : Dogtail, LDTP, et une API intégrée à Accerciser. Dès que vousavez cliqué sur le bouton « Enregistrer », chaque interaction du clavier est enregistrée dans un script qui pourra être lancé plus tard en tant que script autonome.

#### Enregistreur de script

L'enregistreur de script

### Sélection rapide

Ce greffon fournit des raccourcis globaux pour sélectionner rapidement des éléments accessibles via l'interface utilisateur de l'application cible. Vous pouvez sélectionner l'élément accessible du dernier widget actifen appuyant sur Ctrl Alt A. Pour sélectionner l'élément accessible du widget situé sous le pointeur, appuyez sur Ctrl Alt T.

### Validation

Ce greffon contrôle les problèmes d'accessibilité dans les applications et génère un rapport intégrant la sévérité et la description des problèmes. Dans le rapport, les erreurs sont liées à la documentation pour indiquer comment remédier aux problèmes courants. Le greffon peut être complété par des schémas de test définissant des règles de validation.

Pour lancer une validation, sélectionnez d'abord un élément dans l'arbre d'accessibilité. Le greffon testera l'élément sélectionné ainsi que tous ses descendants. Sélectionnez ensuite un schéma à utiliser pour le test. Puis cliquez sur le bouton Valider pour lancer le test. Vous pouvez interrompre le test en cliquant une nouvelle fois sur ce bouton.

Lorsque le test est terminé, le tableau du rapport montre la sévérité et la description de toutes les erreurs. Faites un double-clic sur une ligne du tableau pour afficher dans l'arbre les éléments accessibles correspondants. Lorsqu'un élément est sélectionné, cliquez sur Aide pour obtenir des informations sur la manière de résoudre le problème.

## Préférences

Certains éléments d'Accerciser sont paramétrables :

### Agencement des greffons

Il y a deux méthodes pour configurer l'agencement des greffons dans Accerciser. Vous pouvez tout d'abord utiliser le menu Édition Préférences pour afficher la boîte de dialogue Préférences. Celle-ci contient des onglets pour chaque section. Sélectionnez l'onglet Greffons pour afficher la liste de tous les greffons disponibles. Faites un clic droit sur l'un d'entre eux pour configurer son affichage.

Vous pouvez également glisser-déposer les onglets de greffons pour les déplacer vers la zone de greffon du bas ou de droite. En déplaçant un onglet sur le bureau, vous créez une nouvelle fenêtre, dans laquelle vous pouvez déposer des greffons.

### Configuration globale des raccourcis

Certains éléments d'Accerciser peuvent activer certaines fonctionnalités via des raccourcis. Les combinaisons de raccourcis peuvent être modifiées par la boîte de dialogue Préférences (menu Édition Préférences). Cliquez ensuite sur l'onglet Raccourcis généraux. Une liste des fonctions des raccourcis disponibles y est présente. Modifiez les raccourcis comme vous le souhaitez.

## À propos d'Accerciser

Accerciser a été écrit par Eitan Isaacson (eitan@ascender.com). Pour plus d'informations concernant Accerciser, référez-vous à la page GNOME Live d'Accerciser.

Pour rapporter une anomalie ou émettre une suggestion concernant cette application ou ce manuel, procédez comme indiqué sur la page de réactions sur GNOME.

La redistribution et l'utilisation sous forme de sources et binaires, avec ou sans modifications, sont permises selon les conditions de la licence BSD.