====== Outils ======
Plusieurs outils externes à Actiona peuvent être utilisés avec ce dernier afin d'étendre les fonctionnalités du logiciel. Pour ajouter un outil vous pouvez vous baser sur l'exemple donné [[fr:tools_example|ici]].

===== Windows =====

Il est possible de lancer une commande DOS ou un programme à partir d'Actiona.

  - Une action 'Commande' dans Actiona. Le parametre 'commande' =  fichier '.bat'.
  - Ce fichier '.bat' contient la commande DOS ou le programme.
 

Exemple d'action 'commande' dans Actiona
{{ :fr:devel:action_commande.jpg?400 |}}

Dans la suite, il y a d'abord les programmes livrés avec Windows puis ceux qu'il faut installer. 
  
 **Programmes livrés avec Windows**
Sauf indication contraire, tous ces programmes (ou ces commandes DOS) sont utilisables sous Windows XP,7 ,8 et 10. 

Pour obtenir tous les paramètres d'une commande, saisir 'CetteCommande/?' en ligne de commande.

**Quelques exemples**

==== robocopy ====

 Réplication de répertoires.	
  
Sans doute un des utilitaires les plus riches en possibilités.\\
Une doc. bien faite :  http://courstechinfo.be/OS/Robocopy.html

Comme il est dit dans cette documentation :  
<code>

RoboCopy est comparable à la commande XCOPY mais possède plus d'options et offre donc plus de possibilités pour la configuration des scripts de sauvegarde.

RoboCopy est aussi nettement plus rapide que XCopy pour la recherche des fichiers à copier.

Robocopy est capable de reprendre une copie momentanément interrompue par une défectuosité des transmissions sur le réseau. 

Les options de RoboCopy sont trop nombreuses pour pouvoir deviner facilement ce qu'elles donnent comme résultat.
La commande RoboCopy ne fonctionne bien que si elle configurée dans un fichier de commande testé avec soin. 
</code>
		

Exemple : Copier toute l'arborescence sous D:\envirs vers G:\save\envirs, 
 en supprimant côté cible les fichiers qui n'existent plus côté source.

Même principe que vu plus haut (une action 'commande' et un fichier.bat).
		
Le fichier bat :
<code>
chcp 1252
ROBOCOPY D:\envirs   G:\save\envirs  /MIR  /NP
</code>			  
  * La commande 'chcp 1252' évite les problèmes d'accent.
  * /MIR : Supprime coté image ce qui n'existe plus côté source.
  * /NP  : Pas d'affichage lors de l'exécution

\\
\\

==== schtasks ====

   
 Créer, supprimer, afficher les taches planifiées 
		
Une option particuliere 'onidle' permet de lancer un ".bat" si le PC est inactif depuis N minutes.
	
Cette option peut être utilisée pour le suivi des scripts Actiona.\\
Dans l'exemple donné ci-après, un mail sera automatiquement envoyé pour avertir qu'il y a souci.

<note warning>Si tous les cas d'erreur sont gérés dans le script, il est plus simple d'utiliser directement la commande "envoi d'e-mail" apparue dans la version 3.9 d'Actiona.</note>

Sinon, solution proposée : \\
 * En début de script Actiona, lancement  d'une tache qui sera executée si le PC est inactif plus de N minutes. \\		   
 * En fin de script, delete de cette tache. \\

	 	
1) En début de script Actiona : 
Créer une action 'commande' qui lance 'create_task_test_inactivite.bat' 
	 
Contenu de  'create_task_test_inactivite.bat'  :
<code>
schtasks /delete /tn test_inactivite /f 
schtasks /create /tn test_inactivite /tr "C:/temp/envoyer_msg.bat" /sc onidle /i 3
</code>	
//Si PC inactif plus de 3 minutes, execution de 'envoi_msg.bat'//
		  
Contenu de  'envoi_msg.bat' :
<code>	
schtasks /delete /tn test_inactivite /f	    
c:\php\php.exe C:\temp\envoi_msg.php 
</code>		
		
Contenu de envoi_msg.php 
<code>	
<?php
//===========
// A paramétrer
//===========
$serveur_smtp= "smtp.XXX";
$to = 'zz1@YY1';
$from = 'zz2@YY2';

$subject = 'PB lors du traitement [description] Via  Actiona  ';
$message = "Traitement  interrompu à " .  date("D M j G:i:s");  ;
//===========


//===========
// Ne pas toucher
//===========
ini_set('SMTP',$serveur_smtp);
$headers = "From: $to" . "\r\n" .
"Reply-To: $from " . "\r\n" .
'X-Mailer: PHP/' . phpversion();
mail($to, $subject, $message, $headers);
?>
</code>

2) En fin de script Actiona :
Créer une action 'commande' qui lance 'delete_task_test_inactivite.bat'
		 
Contenu de 'delete_task_test_inactivite.bat' : 
<code>
schtasks /delete /tn test_inactivite /f 
</code>	

 [[http://autour-de-wanquetin.com/info/test_inactivite.zip|Les fichiers]]	

Pour une 1ere utilisation : \\
 * Choisir un répertoire et copier les fichiers dans ce répertoire. \\
 * Dans ces fichiers, changer c:\temp par le nom de ce répertoire. \\
 * Dans  'create_task_test_inactivite.bat', eventuellement changer le nombre de minutes
 avant que le script ne soit vu comme inactif (et non terminé). \\
 * Dans envoi_msg.bat, indiquer où 'php' a été  installé.  \\ 
 * Dans envoi_msg.php, personnaliser les variables figurant en début de script. 
   
Dans le fichier zip, un exemple de script actiona : test_inactivite.ascr. 

//Le script php 'envoi_msg.php' ne nécessite pas l'installation d'un serveur de type apache.//

\\ 
\\ 
	
==== start ====
Lancer un programme ou ouvrir un fichier. \\
Intérêt : \\
 * Pour Lancer un programme : Pas besoin de donner le chemin du .exe. \\
 * Pour Ouvrir un fichier : Ouverture avec le programme par défaut pour ce type de fichier.\\

Exemples de fichier ".bat"

Ouvrir excel
<code>
start excel
</code>

\\
Ouvrir un  fichier ( ici, avec le programme par défaut prévu pour les fichiers '*.gif')
<code>
start c:\temp\aa.gif
</code>

\\
Ouvrir un fichier avec un programme autre que celui prévu pour le suffixe de ce fichier
<code>
start notepad++   c:\temp\aa.csv
</code>

\\
\\ 
				
==== taskkill ====

 Tuer une tache.	
	
Exemple : tuer Winword 

Dans Actiona, créer action 'Commande' avec commande = D:/temp/kill_process.bat \\ 		
Le fichier kill_process.bat contient :
  taskkill /im WINWORD.exe /F			
//Remarque : il est possible de tuer une tache ("un processus") directement via Actiona lorsque celle ci a été créée dans Actiona.//
Action = 'fermer un processus'.

**FIN : Programmes livrés avec Windows**


----
**Programmes à installer sous Windows** 

**FIN : Programmes à installer sous Windows**
----

===== Linux =====