| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| fr:manual [2013/03/06 21:10] – [L'action Code] niconil | fr:manual [2021/02/13 11:23] (Version actuelle) – modification externe 127.0.0.1 |
|---|
| ====== Manuel Utilisateur ====== | ====== 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'Actionaz.// |
| |
| | //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 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 Actionaz comme Javascript ce qui n'est pas strictement vrai, mais qui en pratique ne fait que peu de différences.// |
| | |
| //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.// | |
| ---- | ---- |
| |
| |
| Le troisième bouton est réservé à un usage expert de l'application, appelé "Debug". Nous y reviendrons plus tard. | 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 Actionaz est <key>Ctrl</key>+<key>Alt</key>+<key>Q</key>. //[NdA : Vous me remercierez plus tard]//</note> |
| |
| ==== Console ==== | ==== Console ==== |
| En cliquant sur le petit triangle rouge à droite des paramètres nous autorisons la saisie de code //Javascript//. | 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 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. | * 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. |
| | |
| | ===== 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'actionaz 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, 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 : | 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'intégralité de ces objets spécifiques sont décrits dans la partie [[fr:code|code]]. | 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 Actionaz, 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. |
| |
| ===== Équivalence entre Actions et Code ===== | Tout cela est possible car les actions Actionaz manipulent souvent des objets mis à disposition dans le langage de script. |
| |
| * Certaines actions peuvent être remplacées par une action Code et vice-versa | <note>Prenons un peu d'avance sur les versions futures d'Actionaz. 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> |
| |
| |
| ===== Les formats de fichiers ===== | ===== Les formats de fichiers ===== |
| |
| ... | Les scripts édités avec Actionaz 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 //actionaz// 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 ===== | ===== Actexec ===== |
| |
| ... | Avec **//actionaz//** il y a un autre binaire **//actexec//** qui est limité à l'exécution de script actionaz. Actexec pourra exécuter une script //ascr// ou un fichier //acod//, mais ne permettra pas d'opération d'édition. |
| |
| |
| Retour à la page d'[[fr:start|accueil]] | Retour à la page d'[[fr:start|accueil]] |
| |
| Autres langues disponibles : [[en:manual|(en)]] | |
| |
| |
| |
