[Qaa-cvs-commit] [qaa] doc

aducou at users.labs.libre-entreprise.org aducou at users.labs.libre-entreprise.org
Fri Jun 24 10:33:04 CEST 2005


Changement dans le répertoire qaa/doc:
---
Reviewing.
---  (par aducou)

Fichiers affectés:
-----------------
manuel_utilisateur.rst modifié     (1.1 -> 1.2)
-------------- next part --------------
Index: qaa/doc/manuel_utilisateur.rst
diff -u qaa/doc/manuel_utilisateur.rst:1.1 qaa/doc/manuel_utilisateur.rst:1.2
--- qaa/doc/manuel_utilisateur.rst:1.1	Fri Jun 24 07:52:35 2005
+++ qaa/doc/manuel_utilisateur.rst	Fri Jun 24 08:32:59 2005
@@ -5,106 +5,140 @@
 :Author: Pierre Gaudin <pierre.gaudin at nereide.biz>
 :Copyrigth: Nereide, neogia.org
 :Revision: 1.1
-:Date: $Date: 2005/06/24 07:52:35 $
+:Date: $Date: 2005/06/24 08:32:59 $
 
 .. sectnum::
 
 .. contents::
 
-Installation de QAA :
-=====================
-QAA est un plugin développer en xul pour le moteur gecko. L'installation se déroule en deux étapes. La première consiste a compiler les sources. Cette étape est facultative si cous possédez déjà une version compilée ce qui est notamment le cas dans le cadre du développement de l'ERP ofbiz Neogia, vous trouverez le plugin dans le répertoire  neogia/qaa/bin. La deuxième étape consiste a installer le plugin dans firefox.
-
-Récupération des sources et compilation :
------------------------------------------
-Afin d'utiliser l'application avec ces dernières modifications vous devez : 
+Installation de QAA
+===================
+QAA est une extension développé en xul pour le moteur Gecko.
+L'installation se déroule en deux étapes. 
+La première consiste à compiler les sources. 
+Cette étape est facultative si vous possédez déjà une version compilée ce qui est notamment le cas dans le cadre du développement de l'ERP ofbiz Neogia. 
+Vous trouverez le plugin dans le répertoire  ``neogia/qaa/bin``. 
+La deuxième étape consiste à installer le plugin dans Firefox.
+
+Récupération des sources et compilation
+---------------------------------------
+Afin d'utiliser l'application avec ses dernières modifications vous devez : 
 
-	- Télécharger les sources à partir du labs via cvs  : 
+	- Télécharger les sources à partir du labs via CVS  : 
 		*cvs -z3 -d:pserver:anonymous at cvs.labs.libre-entreprise.org:/cvsroot/qaa co qaa*
 		
 	- Dans le répertoire créé, compiler les sources via la commande :
 		*make*
 		
-	une archive de type *.xpi* et nommée qaagent doit être créée
+	Une archive de type *.xpi* et nommée *qaagent.xpi* a été créée.
 
-Installation du plugin :
-------------------------
-Lancer Firefox et cliquer dans le menu *Fichier*, *Ouvrir un Fichier*. Sélectionner le fichier précédemment créé (qaagent.xpi). 
-La fenêtre d'installation des plugins s'ouvre alors. Cliquer sur Installer et redémarrer Firefox afin de charger le plugin. Le plugin c'est correctement si dans le menu *Outils* un nouveau sous menu *Quality Assurance Agent* apparais.
+Installation du plugin
+----------------------
+Lancer Firefox et cliquer dans le menu *Fichier*, *Ouvrir un Fichier*. 
+Sélectionner le fichier précédemment créé (qaagent.xpi). 
+La fenêtre d'installation des extensions s'ouvre alors. 
+Cliquer sur *Installer* et redémarrer Firefox afin de charger l'extension. 
+L'extension s'est correctement installée si dans le menu *Outils* un nouveau sous-menu *Quality Assurance Agent* apparait.
 
 Remarque :
-Afin d'éviter tout problème lié au plugin QAA, il faut créer un profile Firefox dédié à l'utilisation de QAA ainsi vous n'aurez pas de problème pour retrouver votre profile par défaut en cas de reconstruction de firefox due a QAA.
+Si vous n'utilisez pas une version stable de l'extension QAA, il peut être utile de créer un profil Firefox dédié à son utilisation.
+Ainsi vous n'aurez pas de problème pour retrouver votre profil par défaut en cas de problème.
+
+Pour ce faire :
 
 	- Lancer Firefox avec l'option -p :
 		*firefox -p*
 		
-	- La fenêtre de gestion des profiles s'ouvre
+	- La fenêtre de gestion des profils s'ouvre.
 	
-	- Créé un nouveau profile nommé *QAA* par exemple
+	- Créé un nouveau profil (nommé *QAA* par exemple).
 	
-	- Une fois le nouveau profile créé choisissé le profile sous leqquel démarré firefox
+	- Démarrer firefox sous ce nouveau profil.
 	
-Modifier alors le fichier makefile afin d'ajouter votre profile
+    - L'installation se fait alors de la façon suivante :
+      *make FIREFOX_PROFILE_NAME=testXPI install*.
+  
+     - Placer un fichier de nom *FIREFOX_PROFILE_NAME* contenant le nom du nouveau profil à côté du fichier Makefile pour que le changement soit permanent.
 
 
 
-Plus d'information a cette adresse :
+Plus d'information sur les profils à cette adresse :
   http://www.mozilla.org/support/firefox/profile
 
-Utilisation de QAA :
-====================
 
-Organisation de l'application :
-------------------------------- 
+Utilisation de QAA
+==================
+
+Organisation de l'application
+----------------------------- 
 La fenêtre principale de l'application se compose de quatre onglets :
 
-	- L'onglet *State tree* affiche une vue arborescente des états d'un script et permet l'édition de chaque état
+	- L'onglet *State tree* affiche une vue arborescente des états d'un script et permet l'édition de chaque état.
 	 
-	- L'onglet *logInfo* affiche l'ensemble des actions et test qui sont effectués lors de l'enregistrement et le parcours d'un script
+	- L'onglet *Log Info* affiche l'ensemble des actions et tests qui sont effectués lors de l'enregistrement et le parcours d'un script.
 	
-	- L'onglet *browser* est constitué d'un navigateur web. C'est a partir de cette interface visuelle que seront enregistrés et joués les scripts
+	- L'onglet *Browser* est constitué d'un navigateur web. C'est a partir de cette interface visuelle que seront enregistrés et joués les scripts.
 	 
-**Remarque** : afin de différencier le mode enregistrement du mode test, l'affichage de la page est de taille réduite en mode teste et de taille normale en mode enregistrement.
-	- L'onglet *debug* affiche ? 
+**Remarque** : afin de différencier le mode enregistrement du mode test, l'affichage de la page est de taille réduite en mode test et de taille normale en mode enregistrement.
 
+	- L'onglet *Debug* permet le débogage.
 
-Création d'un script qaa :
--------------------------- 
-Ouvrir l'application et afficher l'onglet *State tree* . Dans la zone *Start URL* ajouter l'url de démarrage du script. Sélectionnez ensuite dans l'arborescence le noeud *start*.  Ce noeud est le point de départ d'un script.
-Sélectionnez ensuite l'onglet *browser* et cliquer sur *Define action list* afin de charger l'adresse url précédemment saisie et de passer en mode enregistrement. La page est alors chargée dans le navigateur en taille normal. L'enregistrement se fait  directement dans le navigateur. Après chaque changement de page un nouvel état doit être créé. Lors de la création de se nouvel état l'ensemble des champs renseigné est enregistré. Une fois l'ensemble du script enregistré cliqué sur le bouton *end action list definition*. La dernière page affichée est alors affichée en mode reduite signifiant que le mode enregistrment est stoppé. 
 
-Edition d'un script :
----------------------
-
-Edition des états :
-"""""""""""""""""""
-A tout moment lors de la création du script, il est possible de consulter l'arbre des états en cliquant sur l'onglet *State tree*. Pour éditer un état, cliquer avec le bouton droit de la souris sur l'état puis sur *edit state*. Une nouvelle fenêtres s'ouvre alors constituée de trois partie :
+Création d'un script QAA
+------------------------ 
+Ouvrir l'application et afficher l'onglet *State tree*.
+Dans la zone *Start URL* ajouter l'URL de démarrage du script.
+Sélectionner ensuite dans l'arborescence le noeud *Start*.
+Ce noeud est le point de départ d'un script.
+
+Sélectionner ensuite l'onglet *Browser* et cliquer sur *Define action list* afin de charger l'adresse URL précédemment saisie et de passer en mode enregistrement. 
+La page est alors chargée dans le navigateur en taille normale. 
+L'enregistrement se fait directement dans le navigateur. 
+Après chaque changement de page un nouvel état doit être créé. 
+Lors de la création de ce nouvel état, l'ensemble des champs renseignés est enregistré. 
+Une fois l'ensemble du script enregistré, cliquer sur le bouton *End action list definition*. 
+Le navigateur passe alors en mode reduit, signifiant que le mode enregistrement est stoppé. 
+
+Édition d'un script
+-------------------
+
+Édition des états
+"""""""""""""""""
+À tout moment lors de la création du script, il est possible de consulter l'arbre des états en cliquant sur l'onglet *State tree*. 
+Pour éditer un état, cliquer avec le bouton droit de la souris sur l'état puis sur *Edit state*. 
+Une nouvelle fenêtres s'ouvre alors constituée de trois partie :
 
 	- La première partie nomée *State Name* contient le nom de l'état. Vous pouvez le modifier directement dans cette zone. 
-	- La seconde partie contient les actions relatives a l'état. L'ensemble des champs de définition (type, xpath, argument) est directement modifiable dans les différentes zones. Il est également possible d'ajouter une action en cliquant avec le bouton droit de la souris.
-	- La dernière partie contient les tests qui seront effectués. Il s'agit de commande xpath (voir regle Xpath)
+	- La seconde partie contient les actions relatives à l'état. L'ensemble des champs de définition (type, xpath, argument) est directement modifiable dans les différentes zones. Il est également possible d'ajouter une action en cliquant avec le bouton droit de la souris.
+	- La dernière partie contient les tests qui seront effectués. Il s'agit de commande Xpath (voir règle Xpath).
 	
 Une fois les modifications terminées, fermer la fenêtre. Les nouvelles valeurs sont automatiquement enregistrées.
-Il est également possible de modifier un script en éditant le fichier .qaa correspondant a votre scripte.
-
-Ajout d'états a un script :
-"""""""""""""""""""""""""""
-Pour compléter un script ou ajouter une nouvelle branche, afficher l'onglet *State tree* et sélectionner le noeud à partir duquel vous souhaitez commencer. Dans l'onglet *browser* cliquer ensuite sur *Define action list*. Le script est alors joué depuis l'état start jusqu'à l'état sélectionné. Une fois la page affichée en taille normale vous pouvez compléter le script de la même manière que pour un script original.
+Il est également possible de modifier un script en éditant directement le fichier .qaa correspondant, ce fichier étant au format XML.
 
-Enregistrement, chargement  d'un script :
------------------------------------------
-A tout moment vous pouvez enregistrer votre script  en charger un  ou un créer un de nouveau via le menu fichier . 
-Les fichiers créés comporte l'extension *.qaa* . Ce sont des fichiers xml qu'il est possible d'éditer.
+Ajout d'états à un script
+"""""""""""""""""""""""""
+Pour compléter un script ou ajouter une nouvelle branche, afficher l'onglet *State tree* et sélectionner le noeud à partir duquel vous souhaitez commencer. Dans l'onglet *Browser* cliquer ensuite sur *Define action list*. Le script est alors joué depuis l'état *Start* jusqu'à l'état sélectionné.
+Une fois la page affichée en taille normale vous pouvez compléter le script de la même manière que pour un script original.
+
+Enregistrement, chargement  d'un script
+---------------------------------------
+À tout moment vous pouvez enregistrer votre scrip, en charger un ou en créer un nouveau via le menu fichier. 
+Les fichiers créés comporte l'extension *.qaa* . Ce sont des fichiers XML qu'il est possible d'éditer à la main.
 
 
 
+Déroulement d'un script
+-----------------------
+Charger un script via le menu *Fichier*, *Ouvrir*. 
+Une fois le script chargé, les différents états sont affichés dans l'arborescence. 
+Sélectionner l'état final auquel arriver. 
+Afficher ensuite l'onglet *Browser* afin de surveiller le déroulement du script puis cliquer sur *Start*.
+Si aucune erreur n'est rencontrée les pages défilent les unes après les autres en mode miniature jusqu'à la fin du script. 
+En cas d'erreur ou d'impossibilités de charger une page le navigateur reste sur la dernière page chargée affichée.
 
-Déroulement d'un script :
--------------------------
-Charger un script via le menu *fichier*, *ouvrir*. Une fois le script charger, les différents états sont affichés dans l'arborescence. Sélectionner l'état final auquel arriver. Afficher ensuite l'onglet *browser* afin de surveiller le déroulement du script puis cliquer sur *start*. Si aucune erreur n'est rencontrée les pages défilent les unes après les autres en mode miniature jusqu'à la fin du script. En cas d'erreur ou d'impossibilités de charger une page le browser reste sur la dernière page chargée affichée. 
-A tout moment vous pouvez suivre le déroulement du script dans l'onglet *log Info* qui indique le succés ou l'échec de chaque action et test.
+À tout moment vous pouvez suivre le déroulement du script dans l'onglet *Log Info* qui indique le succés ou l'échec de chaque action et test.
 
 
 License du document
 ===================
-Ce document est sous licence GPL
\ No newline at end of file
+Ce document est sous licence `GPL <http://www.gnu.org/copyleft/gpl.html>`_.


More information about the Qaa-cvs-commit mailing list