Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== Configuration des Actions ======
+[[:france#objets|{{  :objects.png}}]][[:france|{{  :rocrail-logo-35.png}}]]
+[[:france|Content]] -> [[:france#objets|Objets]] ->   [[timed-actions-fr|Actions]]
+  * **Configuration des Actions** | [[:actionctrl-fr|Contrôle des Actions]] | [[:actionctrl-fr#Action-système|Actions système]] | [[:actioncond-fr|Condition des Actions]] | [[:xmlscripting-fr|Script XML]] | [[action-example-fr|Exemple]]
+\\
+=====Onglet Index=====
+{{:actions:actions-index-fr.png}}
+====Entêtes de colonne du tableau====
+**Identifiant:** Identifiant unique de l'action\\
+**Description:** C'est un texte libre pour décrire l'action plus clairement.\\
+**Type:** L'abréviation du type (voir tableau ci-dessous). Le type est configuré dans l'onglet Définition.\\
+====Double clic====
+Un double clic ouvrira l'__**[[:xmlscripting-fr#edit_on_the_server|Editeur Xml]]**__ si l'action sélectionnée est un script Xml.\\
+====Nouveau====
+Ajoute une nouvelle action à la liste.\\
+Change l'identifiant\\
+L'identifiant et la description d'une action peuvent être changés en sélectionnant la ligne dans la liste puis en écrivant le texte requis dans les champs respectifs. Il est conseillé d'utiliser des identifiants explicites.\\
+====Utilisation====
+Ajoute un symbole "#" (Dièse) devant chaque information de la colonne "Description" pour indiquer si l'action est utilisée dans le plan.\\
+Si le symbole n'apparait pas, cela signifie que l'action correspondante n'est pas utilisée.\\
+Pour faire de nouveau disparaître le symbole dans la colonne, il faut fermer la fenêtre et l'ouvrir de nouveau.\\
+====Copier====
+Copie l'action sélectionnée. C'est une aide pour définir des actions du même genre.\\
+====Supprimer====
+Supprime l'action sélectionnée.\\
+====Documentation====
+Ouvre le navigateur WEB par défaut avec toutes les actions dans un format imprimable.\\
+====Test====
+Test inconditionnel de l'action sélectionnée.\\
+//Toutes les variables sont configurées comme dans le cas du mode automatique.//\\
+\\
+=====Définition=====
+{{:actions:action-def-fr.png}}
+==== Type & Identifiant ====
+Ces deux champs définissent l'objet qui pourrait réaliser l'action.
+Le Type peut être sélectionné dans la liste déroulante (voir tableau ci-dessous).
+L'identifiant d'un objet existant de la catégorie du Type peut être sélectionné dans la liste déroulante, sinon il est laissé vide.\\
+ \\
+Pour les types Locomotive et fonction l'identifiant d'une locomotive existante sera disponible pour la sélection.\\
+\\
+Le champ Identifiant pour les types locomotive et fonction peut être laissé vide si les objets suivants sont utilisés pour déclencher l'action:
+  * Capteur **<sup>1)</sup>**
+  * Itinéraire
+  * Aiguillage
+  * Horaire
+Dans ce cas le Contrôle d'Action de ces objets remettra automatiquement l'identifiant de la locomotive qui déclenche l'action à l'action elle-même.\\
+Cela rend possible de définir des actions pour les locomotives et leurs fonctions qui s'appliquent à n'importe quelle locomotive qui à ce moment se trouve sur cet itinéraire/capteur**<sup>1)</sup>**/aiguillage/horaire, sans avoir à définir une nouvelle action pour chaque locomotive.\\
+Par exemple: Les feux peuvent être allumés (fonction F0) quand un itinéraire particulier est emprunté ou qu'un sifflet est actionné avant d'entrer dans un tunnel.\\
+Il est aussi possible de déclencher telle action en utilisant les conditions.\\
+**<sup>1)</sup>** Un capteur fournit l'identifiant de la locomotive que s'il est assignée à un bloc et __**[[block-routes-fr#capteur_sans_evenement|sans évènement]]**__.\\
+\\
+==== Sous-Identifiant ====
+A utiliser uniquement avec les __**[[:variable-fr#sous_identifiant_d_action|Variables]]**__.\\
+====Commande====
+La commande qui sera réalisée par l'objet dans le champ Type est sélectionnée ici. Seules les commandes pouvant être réalisées par le Type sélectionné sont disponibles dans la sélection (voir tableau ci-dessous)\\
+===Bouton trois points (...) ===
+Peut être utilisé pour sélectionner le chemin vers un programme externe ou un script de type Externe. (Voir note sur Externe ci-dessous.)
+===Double guillemet===
+Optionnel si le serveur Rocrail fonctionne sous Windows pour ajouter un guillemet supplémentaire:
+<code>
+""c:\programs\test\speak.exe" "Hello World""
+</code>
+Sans cette option la commande serait comme suit:
+<code>
+"c:\programs\test\speak.exe" "Hello World"
+</code>
+===Asynchrone===
+Le programme externe, script externe ou script XML sera exécuté de façon asynchrone pour empêcher le blocage des objets appelants.\\
+Dans certains cas il est préférable d'attendre jusqu'à ce que le process externe soit terminé. (Par exemple: [[:text:text-webcam-server-fr|WebCam]])\\
+====Paramètre====
+Quelques commandes requièrent un paramètre supplémentaire (voir tableau ci-dessous).\\
+\\
+==== Types, Commandes & Paramètres ====
+^  Type  ^  Type \\ abbr.  ^ ID  ^  Commandes  ^  Paramètre  ^ Description ^
+| Sortie     | co | Sortie     | on, off, flip, active((L'état actif de sortie est uniquement virtuel et ne peut pas être visualisé avec des I/O réels .)), value, lock, unlock | 0...65535 \\ lockid (//unlockid//) | La valeur de la commande est uniquement supportée par les librairies SRCP et BiDiB. |
+| AccGroup     | accgroup | AccGroup     | on, off, flip |  |  |
+| Capteur     | fb | Capteur     | on, off, flip, reset, setcounterval | Nouvelle valeur du compteur; Relative si préfixé avec un signe. \\ La valeur calculé du compteur est remise à zéro si elle est négative. |Le capteur peut être tourné On, Off ou Flipped. Sur réinitialisation, le compteur du capteur sera réglé à 0. |
+| Externe   | ext | -          | //A script, program, **[[#playback|record]]** or **[[#playback|XML Script]]** name.// | Les paramètres indiqués ici seront ajoutés à l'appel du programme² | Les espaces dans le chemin du programme ne sont pas autorisé. \\ Si ce n'est pas évitable, utilisez un  fichier fluide avec des guillemets **"** pour le chemin /fichier. \\ Les paramètres s'effectuent dans un fichier fluide avec ''%1 %2 ...'' \\ Dans le cas d'un __**[[:xmlscripting-fr|Script Xml]]**__ le champ de paramètre peut être utilisé pour appeler une seule fonction. |
+| Aiguillage     | sw | Switch     | straight, turnout, left, right, lock, unlock | force \\ lockid (//unlockid//) | |
+| Itinéraire      | st | Route      | set, lockset, lock, unlock, open, closed, class | lockid (//unlockid//) | Les commandes 'vérouillage'permettent de définir manuellement les itinéraires protégés par le vérouillage de tous les aiguillages. (Logiciel CTC) \\ Le vérrou est optionnel et doit être également utilisé pour le dévérouillage s'il est réglé. L'ID d'action est utilisée si elle est laissée vide. \\ L'ensemble des commandes ne colore pas l'itinéraire dans les clients clients. |
+| Système    | sys | -          | stoplocs, stop, go, shutdown, resume, on, off, ebreak, resetfx, time, v0locos, initfield | - | "on/off" sont pour commander l'automode.\\ "resetfx" définit le groupe de fonctions sélectionné 0...7 sur OFF pour toutes les locomotives. (seul UN paramètre est autorisé : 0 = f0-f4, 1 = f5-f8 ...)  \\ "time" au format 00:00 disponible seulement avec **[[:rocrailini-automode-fr#action_timer_60_sec|un temps d'action de 60 secondes]]**. |
+| Signal     | sg | Signal     | red, yellow, green, white, aspect | Aspect number in the range of 0...31. | |
+| Bloc      | bk | Bloc      | schedule, schedule_manual, tour, unlock, white, yellow, green, red, setloco, event, open, closed, acceptident, dispatch, go, reserve, class | //schedule/tour ID//, //loco ID//, //sensor ID// \\ unlock //loco ID// or * \\ schedule_manual: Démarrage en mode semi-automatique | Les commandes de couleur définnissent avant le principal signal défini pour ce bloc. |
+| Staging block | sb | Staging block | unlock, white, yellow, green, red, open, closed, exitopen, exitclosed, compress | //unlock ID// | Les commandes de couleur définissent le signal de sortie défini pour ce bloc \\ Ouvert/Fermé sont pour le coté d'entrée. |
+| Locomotive | lc | Locomotive | go, govirtual, stop, velocity, velocity2, percent dispatch, swap, blockside, carcount, min, mid, cruise, max, consist, assigntrain, releasetrain, binstate_on, binstate_off, class, x-go, pomwrite, Vvar | //go, govirtual: tour, schedule, location or block ID (Une variable peut être aussi utilisée au lieu d'un nom fixe.)\\ velocity¹: pourcentage de la vitesse sur le courant¹\\ velocity2: Vitesse du décodeur sendaire\\ carcount: nombre de voitures ou de remise à 0\\ consist: locoID[,locoID]...\\ binstate: nombre de sortie \\ x-go: Liste des adresses de locomotives séparées par des virgules ou codage par ID ou par des variables.\\ pomwrite: valeur Cv\\ Vvar: Vitesse utilisée// | Remplir le champ de paramètre pour réinitialiser une rame. \\  Si aucune locomotive n'est trouvée et que le champ de paramètre contient une vaiable # une locomotive sera recherché par adresse. Cette option désactive les paramètres supplémentaires.\\ Dans le cas où une destination est définie à l'action GO: __**[[:automatic-en#running_to_a_defined_destination|lisez ceci! (EN)]]**__ |
+| Fonction   | fn | Locomotive\\ Car\\ Operator³ | on, off, flip | //numéro de fonction (juste le nombre, comme 1, pas f1 pour la fonction 1) ou le __**[[loc-fun-fr#description|texte de la description de la fonction]]**__ (Case sensitive).//\\ Une liste de fonction Cv comme "1,2,3". Si la liste commence par un point d'interrogation, "?1,2,3", elle choisira une fonction aléatoirement(N'incluez pas de citation dans la définition de l'action).| Une seule fonction temporisée est prise en charge. En utiliser plusieurs affichera des résultats imprévisibles. Flip active la fonction quand elle est éteinte et vice versa. Flip ne prend pas en charge les fonctions chronomètre. |
+| Plaque tournante   | tt | Turntable | goto, 180, on, off, lighton, lightoff | //numéro de voie (goto) ou fonction (on/off)// | |
+| Plateau   | seltab | Fiddle Yard | goto | //numéro de voie// | |
+| Texte | tx | Text | update, __**[[:variable-fr#etat_et_syntaxe_des_parametres|valeur]]**__, on, off | Les variables de texte dynamiques seront remplacées avec les valeurs réels. Pour les variables intégrées disponibles voir ici: __**[[[:text-fr#variables|Variables]]**__ | Variables: __**[[:variable-fr#etat_et_syntaxe_des_paramètres|Syntaxe]]**__ |
+| Son | sound | - | play, straigh, turnout | Nom du fichier son. | Réglez le périphérique du lecteur son dans l'onglet d'interface(RocNet seulement!). |
+| [[:variable-fr|Variable]] | var | Variable | text, value, add, subtract, min, max, random, start, stop | les nouvelles valeurs. | - |
+| Voiture | car | Car | empty, loaded, maintenance | Le nouveau statut du véhicule . | - |
+| Opérateur | operator | Operator | addcar, removecar, loadcar, emptycar, class | Ajouter, enlever, charger ou supprimer des véhicules. | Une liste d'ID des véhicules séparée par des virgules. |
+| Localisation | location | Locality | minocc, fifo, go, schedule | Définit l'occupation minimale dans cette localisation. \\ Démarer et le calendrier démarera aléatoirement une locomotive. | parametre: numéro minocc ou 0/1 for fifo d'activation ou désactivation |
+| Météo | co | Weather | setweather, weathertheme | Active l'ID sélectionné de météo (thème). | le paramètre "setweather" peut être utilisé pour régler le lever du soleil, midi,le coucher du soleil en quelques  minutes. Par exemple: "360,720,1080[,relatif/absolu]" (06:00,12:00,18:00) |
+| Horloge | clock | - | set | diviseur,heure, minute,seconde | Le temps ne peut être réglé que si le diviseur est > 1. |
+¹ Lorsque la vitesse ou le pourcentage est négatif, l'exécution de l'action permettra non seulement de régler la vitesse de la locomotive, mais aussi de changer de direction. Notez que seule une valeur négative change de direction, ce n'est pas le cas que négatif signifie arrière et positif l'inverse.\\
+² Astuce: pour déboguer le non fonctionnement des appels de programmes externes; Dans les lignes de saisie contenant la commande exécutée cela  ressemble à //OAction  0501  [espeak -vde eins]//\\
+³ Les commandes de fonctions sont envoyées à tous les wagons dans le train de l'opérateur.\\
+====Notes:====
+==Type Externe:==
+Si ce type est employé pour exécuter un programme ou un script externe le chemin du programme ou script (y compris les paramètres) est écrite dans le champ de commande. Le chemin devrait exister sur le serveur, ainsi si vous utilisez le bouton Triple Point (...) sur un ordinateur autre que celui sur lequel le serveur Rocrail est installé cela ne correspondra probablement pas.\\
+Alternativement un programme peut être démarré dans son propre process sous système Unix. (myprog.sh &)\\
+Les fichiers XMLScript doivent être configurés sans chemin, voir __**[[:rocrailini-gen-fr#chemin_de_xmlscript|Chemin de XMLScript]]**__.\\
+==Playback==
+Un fichier son, *.txt, peut aussi être sélectionné en tant que commande externe pour la diffusion.\\
+Voir: **[[rocview:cmdrecorder-fr|Enregistreur de commandes]]**\\
+Les paramètres supplémentaires sont ignorés.\\
+==Script XML==
+A XML script file, *.xml, can also be selected as external command to run.\\
+Voir: **[[xmlscripting-fr|XML Scripting]]**\\
+Les paramètres supplémentaires sont ignorés.\\
+==VLC==
+**Exemple: Lecture de son avec VLC**
+Installer **[[https://www.videolan.org/vlc/|VLC]]**.\\
+Définir une action:\\
+Tapper: “run ext. program”\\
+Par défaut laisser “Double guillemet” et “Asynchrone” inchangés.\\
+Commande: “C:\Program Files (x86)\VideoLAN\VLC\vlc.exe” ou le chemin où VLC est installé.\\
+Paramètre: “C:\sound\Aarau1_Irina.mp3 ''-''''-''play-and-exit ''-''''-''qt-start-minimized ''-''''-''qt-notification=0”.\\
+Explication des paramètres:
+''C:\sound\Aarau1_Irina.mp3'' - le titre (ici un “mp3”) qui sera joué.\\
+''%%--%%play-and-exit'' - le programme VLC est démarré, le son joué et le programme fermé.\\
+''%%--%%qt-start-minimized'' - pas d'affichage de fenêtre.\\
+''%%--%%qt-notification=0'' - Windows ne joue aucun autre son.\\
+Paramètres futurs:\\
+''%%--%%gain=x.xxx'' - volume de lecture, ici x.xxx peut être dans la plage de 0.0 à 8.0.
+L'action peut être déclenchée par l'horloge ou la rétro-signalisation.\\
+==== Durée ====
+La durée de l'action est en unités de 100ms; 10 = 1s. Durée illimitée si égale à zéro.\\
+Seulement utilisé pour les commandes de fonction.\\
+==== Minuterie ====
+Nombre de millisecondes à attendre avant d'exécuter cette action après qu'elle ait été déclenchée.\\
+Cela peut être employé, par exemple, pour activer un sifflet avant un tunnel sans avoir à installer un capteur séparé. L'action peut être déclenchée par le dernier capteur (distant) et être réalisée après le délai juste avant le tunnel.\\
+Un contrôle d'action peut être utilisé pour déclencher plusieurs actions au même moment mais qui peuvent être accomplies avec différents délais l'un après l'autre.\\
+==== Temps d'activation ====
+===Utilisation===
+Si l'action doit être déclenchée à un instant particulier **Utilisation** sera coché et le temps nécessaire sera saisi.\\
+La durée se réfère à l'horloge Rocrail et non à l'horloge réelle. Voilà des situations possibles dans lesquelles il est utile d'avoir l'horloge Rocrail plus rapide que l'horloge réelle, par exemple pour implémenter un contrôle jour/nuit sur 24h.\\
+Si l'option **[[:rocrailini-automode-fr#action_timer_60_sec|Minuterie d'Action 60 sec.]]** dans le serveur Rocrail est configurée, la deuxième valeur est aussi évaluée.\\
+===Tous===
+Cette action sera exécutée toutes les heures + minutes après qu'elle ait été validée par un contrôle d'action avec l'état "on".\\
+Elle peut être désactivée par un contrôle d'action avec l'état "off".\\
+La case **Utilisation** doit être cochée pour activer chaque minuterie.\\
+La case **Aléatoire** doit être décochée.\\
+L'intervalle d'exécution le plus court est de une minute.\\
+===Aléatoire===
+Cette action sera exécutée à intervalle aléatoire.\\
+La durée aléatoire d'activation est respectivement entre 1 minute et la durée d'activation spécifiée. La résolution est à l'échelle des minutes.\\
+La case **Utilisation** doit être cochée pour activer la minuterie aléatoire.\\
+La case **Tous** est sans effet si **Aléatoire** est cochée.\\
+===Activé===
+Option de pré-activation; Aucun événement n'est nécessaire pour évaluer la durée d'activation.\\
+\\
+=====Utilisation=====
+Cet onglet énumère tous les autres objets, //"Identifiant (Type)"//, utilisant l'action sélectionnée sur l'onglet index.\\
+{{:actions:action-use-fr.png}}\\
+Un double clic sur un objet de la liste ouvrira le **[[:actionctrl-fr|Contrôle d'Action]]** correspondant.\\
+\\
+=====Interface=====
+L'adresse de port du lecteur musical.\\
+{{:actions:action-int-fr.png}}\\
+Si la commande de son est straight ou turnout une commande d'aiguillage est générée.((Le nom du fichier est ignoré.))\\
+Si la commande de son est jouée une action est générée qui est supportée par:
+  * RocNet
+  * RocNetNode
+  * Virtual
+ \\
+=====Rapport=====
+{{:actions:actions-overview-fr.png?800}}\\
+Un double clic ouvrira l'objet sélectionné.\\
+====Générer====
+Génère un rapport de toutes les actions utilisées dans tous les objets.\\