Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:manual [2013/03/06 21:25] – [L'action Code] niconil
+++ fr:manual [2025/07/26 12:38] (Version actuelle) – matos
@@ Ligne 1: / Ligne 1: @@
 ====== Manuel Utilisateur ======
-//Ce manuel constitue pour partie en une première agrégation de pages éparses rédigées initialement par d'autres contributeurs; qu'ils en soient remerciés ici.//
+//Ce manuel est constitué pour partie de pages éparses rédigées initialement par d'autres contributeurs; qu'ils en soient remerciés ici.//
-//En les assemblant ces pages forment un premier manuel de présentation et d'utilisation des concepts d'Actionaz.//
+//Ces pages assemblées forment un premier manuel de présentation et d'utilisation des concepts d'Actiona.//
-//Dans Actionaz, il est possible d'utiliser un langage de script pour paramétrer ou coder certaines actions. Le langage en question suit la spécification ECMAScript-262 accessible et manipulable par la classe QtScript de la librairie Qt. Le langage Javascript qui suit les mêmes spécifications est très proche de ce langage.  Par abus de langage, dans la page qui suit, nous désignons le langage de script mis à disposition dans Actionaz comme Javascript ce qui n'est pas strictement vrai, mais qui en pratique ne fait que peu de différences.//
+//Dans Actiona, il est possible d'utiliser un langage de script pour paramétrer ou coder certaines actions. Le langage en question suit la spécification ECMAScript-262 accessible et manipulable par la classe QtScript de la bibliothèque Qt. Le langage Javascript qui suit les mêmes spécifications est très proche de ce langage.  Par abus de langage, dans la page qui suit, nous désignons le langage de script mis à disposition dans Actiona comme Javascript ce qui n'est pas strictement vrai, mais qui en pratique ne fait que peu de différences.//
 ----
 ====== Présentation du logiciel ======
-**Actionaz** est un logiciel d'automatisation.
+**Actiona** est un logiciel d'automatisation.
-Il permet l'exécution de scripts d'actions. Un script est en effet une liste d'actions qui permettent d'interagir avec le système d'exploitation et les applications. Il y a des actions qui déplacent la souris ou effectuent un clic à une coordonnée, des actions qui simulent l'appui sur une touche du clavier, qui lisent la base de registres, qui téléchargent le contenu d'une URL, en tout il y en a plusieurs dizaines. Mais on peut aussi écrire des actions dans un langage similaire au Javascript. Cette possibilité démultiplie les possibilités d'**Actionaz**.
+Il permet l'exécution de scripts d'actions. Un script est en effet une liste d'actions qui permettent d'interagir avec le système d'exploitation et les applications. Il y a des actions qui déplacent la souris ou effectuent un clic à une coordonnée, des actions qui simulent l'appui sur une touche du clavier, qui lisent la base de registres, qui téléchargent le contenu d'une URL, en tout il y en a plusieurs dizaines. Mais on peut aussi écrire des actions dans un langage similaire au Javascript. Cette possibilité démultiplie les possibilités d'**Actiona**.
-===== Quels usages pour Actionaz ? =====
+===== Quels usages pour Actiona ? =====
-Dès que vous effectuez des taches répétitives, des requêtes quotidiennes, que vous souhaitez reproduire exactement la même série d'actions, Actionaz peut vous aider.
+Dès que vous effectuez des taches répétitives, des requêtes quotidiennes, que vous souhaitez reproduire exactement la même série d'actions, Actiona peut vous aider.
 Cela peut être pour programmer un //bot// dans un jeu, déclencher des tests d'une application en développement pour détecter une régression, interroger des applications dépourvues d'interface autre que l'interface homme-machine.
-===== Pourquoi choisir Actionaz ? =====
+===== Pourquoi choisir Actiona ? =====
-  * L'interface conviviale d'Actionaz permet de constituer graphiquement sa liste d'actions sans avoir à apprendre la syntaxe d'un nouveau langage.
+  * L'interface conviviale d'Actiona permet de constituer graphiquement sa liste d'actions sans avoir à apprendre la syntaxe d'un nouveau langage.
   * Pour une personne qui à déjà une connaissance du Javascript, elle pourra enrichir les actions standard avec du des actions Code exécutant du Javascript
 ===== Quelques caractéristiques =====
-Actionaz est un logiciel libre (sous licence GPL v3) écrit en C++ et s'appuyant sur la bibliothèque Qt.
+Actiona est un logiciel libre (sous licence GPL v3) écrit en C++ et s'appuyant sur la bibliothèque Qt.
-Actionaz est aussi multi plate-forme (windows et linux)
+Actiona est aussi multi plate-forme (windows et linux)
 ===== Pour les anciens =====
-Si vous utilisiez déjà Actionaz 2, voir les [[fr::Actionaz 3 changes|changements qu'apporte Actionaz 3]].
+Si vous utilisiez déjà Actionz 2, voir les [[fr::Actionaz 3 changes|changements qu'apporte Actionaz 3]].
 ====== Créons notre premier script ! ======
-Après avoir ouvert Actionaz, vous devriez voir cet écran :
+Après avoir ouvert Actiona, vous devriez voir cet écran :
 {{ :fr:ecran_principal.jpg?direct& |}}
-Il s'agit de la fenêtre principale d'Actionaz. Dans cette fenêtre, vous pouvez créer votre script, l'enregistrer, l'exécuter et avoir accès à toutes les fonctionnalités du programme. Vous pouvez voir qu'à l'ouverture, un nouveau script est automatiquement affiché. Vous pouvez ainsi directement commencer à créer votre script en glissant des actions, situées dans la **//fenêtre nouvelle action//** sur la gauche, vers la fenêtre de script qui se trouve au centre.
+Il s'agit de la fenêtre principale d'Actiona. Dans cette fenêtre, vous pouvez créer votre script, l'enregistrer, l'exécuter et avoir accès à toutes les fonctionnalités du programme. Vous pouvez voir qu'à l'ouverture, un nouveau script est automatiquement affiché. Vous pouvez ainsi directement commencer à créer votre script en glissant des actions, situées dans la **//fenêtre nouvelle action//** sur la gauche, vers la fenêtre de script qui se trouve au centre.
-Commençons progressivement : Tout d'abord, nous allons enregistrer notre script sous le répertoire de votre choix. Pour cela, allez dans "**Fichier -> Enregistrer script sous…**" ou utiliser le raccourci clavier //Ctrl + S//. L’application vous demandera alors de nommer votre script et d’enregistrer dans un répertoire. Appelons-le ici "//premierScript//". Lorsque vous fermerez Actionaz, vous pourrez ainsi récupérer votre script sauvegardé en allant dans "**Fichier -> Ouvrir script **" une fois que vous ré-ouvrirez l'application.
+Commençons progressivement : Tout d'abord, nous allons enregistrer notre script sous le répertoire de votre choix. Pour cela, allez dans "**Fichier -> Enregistrer script sous…**" ou utiliser le raccourci clavier //Ctrl + S//. L’application vous demandera alors de nommer votre script et d’enregistrer dans un répertoire. Appelons-le ici "//premierScript//". Lorsque vous fermerez Actiona, vous pourrez ainsi récupérer votre script sauvegardé en allant dans "**Fichier -> Ouvrir script **" une fois que vous ré-ouvrirez l'application.
 ===== Hello World ! =====
@@ Ligne 80: / Ligne 77: @@
 Et pour ce faire, il suffit simplement de cliquer sur ce bouton : {{:fr:execution.png?nolink&|}}
-Vous devriez voir apparaître le résultat de votre script, et votre premier mot en tant qu'utilisateur d'Actionaz !
+Vous devriez voir apparaître le résultat de votre script, et votre premier mot en tant qu'utilisateur d'Actiona !
 {{ :fr:11-09-05_22_03_21.jpg?direct& |}}
@@ Ligne 96: / Ligne 93: @@
 Le troisième bouton est réservé à un usage expert de l'application, appelé "Debug". Nous y reviendrons plus tard.
+<note important>Lors de l'exécution d'un script, notez que par défaut la séquence de Touche pour arréter Actiona est <key>Ctrl</key>+<key>Alt</key>+<key>Q</key>. //[NdA : Vous me remercierez plus tard]//</note>
 ==== Console ====
@@ Ligne 106: / Ligne 105: @@
 Lorsque vous cliquez sur "OK" dans la boite de dialogue, l'exécution se termine et vous revenez sur la fenêtre principale. Normal, puisque le script ne contient qu'une seule action. Lors de l'exécution d'un script, s'il ne reste aucune action à effectuer, l'exécution se termine.
-Voilà, vous venez de créer et d'exécuter votre premier script **Actionaz** !
+Voilà, vous venez de créer et d'exécuter votre premier script **Actiona** !
-<note tip>En téléchargeant Actionaz, vous vous êtes peut-être demandé s'il était possible "d'exporter" le script sous forme d'exécutable, ou en d'autres termes dans un fichier qui ne nécessite pas Actionaz pour être lancé. Et bien oui, c'est possible ! (uniquement sous windows)
+<note tip>En téléchargeant Actiona, vous vous êtes peut-être demandé s'il était possible "d'exporter" le script sous forme d'exécutable, ou en d'autres termes dans un fichier qui ne nécessite pas Actiona pour être lancé. Et bien oui, c'est possible ! (uniquement sous windows)
-Pour cela, vous pouvez aller dans "Fichier -> Exporter -> Exécutable (SFX)". Vous devrez choisir le nom de l'exécutable ainsi que sa destination. Après, une boite de dialogue apparaîtra avec plusieurs champs, vous permettant de configurer l'exécutable : apparition de la console, de la fenêtre d'exécution, possibilité de laisser Actionaz ouvert etc...
+Pour cela, vous pouvez aller dans "Fichier -> Exporter -> Exécutable (SFX)". Vous devrez choisir le nom de l'exécutable ainsi que sa destination. Après, une boite de dialogue apparaîtra avec plusieurs champs, vous permettant de configurer l'exécutable : apparition de la console, de la fenêtre d'exécution, possibilité de laisser Actiona ouvert etc...
-Créer un exécutable n'est utile que lorsque vous voulez exporter votre script vers un système ne possédant pas Actionaz. Il s'agit d'une opération lourde et longue, aussi veillez à ne la réaliser que si votre script est achevé car il ne pourra pas être modifié par la suite. Uniquement écrasé.
+Créer un exécutable n'est utile que lorsque vous voulez exporter votre script vers un système ne possédant pas Actiona. Il s'agit d'une opération lourde et longue, aussi veillez à ne la réaliser que si votre script est achevé car il ne pourra pas être modifié par la suite. Uniquement écrasé.
 </note>
@@ Ligne 118: / Ligne 117: @@
 ====== Pour aller plus loin ======
-Dans ce premier script nous avons déjà pu voir certains composants essentiels d'Actionaz. Nous allons revenir sur certains d'entre eux.
+Dans ce premier script nous avons déjà pu voir certains composants essentiels d'Actiona. Nous allons revenir sur certains d'entre eux.
 ===== Détail d'une action =====
-Un script d'Actionaz est composé d'actions qui sont exécutées séquentiellement.
+Un script d'Actiona est composé d'actions qui sont exécutées séquentiellement.
 Chaque action possède :
@@ Ligne 161: / Ligne 160: @@
 {{:fr:exceptions.png|}}
-Les exceptions sont des évènements pouvant être déclenchés durant l'exécution d'une action.
+Les exceptions sont des événements pouvant être déclenchés durant l'exécution d'une action.
 Il s'agit le plus souvent d'une erreur dans le paramétrage de l'action. Une exception est également déclenchée lorsque la durée d'exécution maximum d'une action est écoulée.
@@ Ligne 183: / Ligne 182: @@
 Dans les zones attendant du texte on peut introduire un nom de variable précédé du caractère '$', qui sera évalué au moment de l'exécution.
-On peut aussi pour tous les paramètres saisir du code //Javascript// qui sera évalué pour déterminer la valeur du paramètre. C'est un mécanisme puissant d'Actionaz (voir le prochain paragraphe : [[fr:manual:#le_triangle_rouge|le triangle rouge]])
+On peut aussi pour tous les paramètres saisir du code //Javascript// qui sera évalué pour déterminer la valeur du paramètre. C'est un mécanisme puissant d'Actiona (voir le prochain paragraphe : [[fr:manual:#le_triangle_rouge|le triangle rouge]])
 Le type attendu dans un paramètre n'est pas explicite, mais fortement sous-entendu. un paramètre dénommé //Variable// va attendre un nom de variable, un paramètre dénommé //Texte// sous-entend une chaîne de caractères. Pour désigner une touche dans l'action //Touche// c'est une chaîne de caractères qui va décrire la Touche.
@@ Ligne 194: / Ligne 193: @@
   * Une chaîne //simple// : <key>votre Nom est : Dupont</key>
-  * Un nom de variable précéde du caractère //$// : <key>$Nom</key>
+  * Un nom de variable précède du caractère //$// : <key>$Nom</key>
   * Un mélange des deux : <key>votre Nom est : $Nom</key>
@@ Ligne 245: / Ligne 244: @@
 En cliquant sur le petit triangle rouge à droite des paramètres nous autorisons la saisie de code //Javascript//.
   * La première instruction permet de récupérer l'année sur 4 chiffres pour la stocker dans le paramètre //Texte//.
   * La seconde peut-être plus étonnante, permet de choisir le niveau de message (Information, Avertissement ou Erreur) par l'usage de code également. Dans notre exemple après 15 heures nous affichons un message de type //Avertissement//, et de type //Information// sinon.
-Mais ce n'est pas tout, Actionaz a enrichi le langage //Javascript// d'objets qui lui sont spécifiques. Ces types d'objet se rajoutent à ceux déjà disponibles dans le langage de base. Par exemple vous avez accès aux objets spécifiques suivant :
+===== L'action Code =====
+De la même manière qu'un paramètre peut être évalué à l'aide de code //Javascript//, il est possible d'intégrer du code dans une action. Il s'agit de l'action [[fr:actions:actioncode|Code]]. Cette action exécutera le script que vous aurez saisi. Elle permet a des utilisateurs avertis d'étendre les possibilités d'actiona lorsqu'on se limite à l'utilisation des actions prédéfinies.
+<note tip>Vous pouvez aussi inclure du code au moment de l'exécution, pour ce faire il vous suffit d'inclure un fichier contenant le code que vous aurez pu généré à l'action précédente ! Cela se fait par l'instruction <key>include(nomDeFichier)</key> où le fichier inclus contient du code //Javascript//.</note>
+Mais ce n'est pas tout, Actiona a enrichi le langage //Javascript// d'objets qui lui sont spécifiques. Ces types d'objet se rajoutent à ceux déjà disponibles dans le langage de base. Par exemple vous avez accès aux objets spécifiques suivant :
   * Console (vous permet d'interagir avec la Console)
   * Point (pour manipuler des données de position)
@@ Ligne 254: / Ligne 259: @@
 L'intégralité de ces objets spécifiques sont décrits dans la partie [[fr:code|code]].
+===== Équivalence entre Actions et Code =====
+Cette notion, n'est pas évidente lorsque l'on découvre Actiona, mais la plupart des actions //graphiques// sont traduisibles en instructions //Javascript//.
-===== L'action Code =====
+Pour l'affectation de variables c'est trivial.
-De la même manière qu'un paramètre peut être évalué à l'aide de code //Javascript//, il est possible d'intégrer du code dans une action. Il s'agit de l'action Code. Cette action exécutera le script que vous aurez saisi. Elle permet a des utilisateurs avertis d'étendre les possibilités d'actionaz lorsqu'on se limite à l'utilisation des actions prédéfinies.
+Pour manipuler la console, on a vu auparavant un exemple, où à l'aide de l'objet Console on pouvait réaliser les mêmes opérations que l'action Console.
-<note tip>Vous pouvez aussi inclure du code au moment de l'exécution, pour ce faire il vous suffit d'inclure un fichier contenant le code que vous aurez pu généré à l'action précédente ! Cela se fait par l'instruction <key>include(nomDeFichier)</key> où le fichier inclus contient du code //Javascript//.</note>
+Tout cela est possible car les actions Actiona manipulent souvent des objets mis à disposition dans le langage de script.
-===== Équivalence entre Actions et Code =====
+<note>Prenons un peu d'avance sur les versions futures d'Actiona. Aujourd'hui il existe un objet spécifique dénommé SQL. Il permet de se connecter et de requêter un serveur Sql. Ça marche dès à présent. Maintenant aucune action graphique ne permet de faire une requête SQL, car elle reste à coder ! (Mais cela viendra, soyez patients, ou prenez votre clavier) C'est une autre façon de montrer l'équivalence entre code et actions.</note>
-  * Certaines actions peuvent être remplacées par une action Code et vice-versa
 ===== Les formats de fichiers =====
-...
+Les scripts édités avec Actiona sont sauvegardés avec l'extension //ascr//. Ce sont des fichiers texte de type XML.
+Mais il existe un autre format les fichiers //acod// que le binaire //actiona// ne prend pas directement en charge. Un fichier //acod// est un script écrit en //Javascript//. C'est comme s'il s'agissait d'un script limité à une grosse action Code.
+Il n'y a pas d'éditeur de fichier //acod//.
 ===== Actexec =====
-...
+Avec **//actiona//** il y a un autre binaire **//actexec//** qui est limité à l'exécution de script actiona. Actexec pourra exécuter une script //ascr// ou un fichier //acod//, mais ne permettra pas d'opération d'édition.
@@ Ligne 289: / Ligne 294: @@
   * lire les [[fr:tutorials|tutoriaux]] disponibles
   * parcourir la [[fr:actions|liste des actions]]
-  * consulter la [[fr:code|liste des objets]] spécifiques à Actionaz que je peux manipuler dans mes actions Code
+  * consulter la [[fr:code|liste des objets]] spécifiques à Actiona que je peux manipuler dans mes actions Code
   * rester informé sur les nouvelles versions d'Actionaz ([[fr:changelog|changelog]])
-  * savoir obtenir de l'aide de la communauté ([[http://jmgr.net/forum|le forum Actionaz]])
+  * savoir obtenir de l'aide de la communauté ([[http://jmgr.net/forum|le forum Actiona]])
@@ Ligne 298: / Ligne 303: @@
 Retour à la page d'[[fr:start|accueil]]
-Autres langues disponibles : [[en:manual|(en)]]