Configurer une tâche Exécuter commande externe

Introduction

La solution Damaris RM vous permet de lancer une commande externe.

 

Quelles commandes ?

Une commande externe peut être un script lançable à partir d’une ligne de commande du système d’exploitation.

Damaris RM fonctionnant sous Microsoft Windows et sous Linux vous offre la possibilité de lancer des commandes de type :

• Sous Microsoft Windows
  • Des scripts .BAT
  • Des scripts Python .py
• Sous Linux
  • Des shell .sh
  • Des scripts Python .py

Comment configurer une tâche de ce type ?

Copiez votre script dans le répertoire executeCommand/script présent dans l’arborescence de votre Société.

Ensuite, à partir de Damaris RM, créez un tâche de type “Exécuter Commande” où dans la ligne de commande vous inscrivez le nom du fichier.

Vous n’avez pas à préciser le chemin d’accès vers le script.

 

Le contenu du fichier script

Attention : Il faut garder à l’esprit que c’est le service Tomcat qui lance le script en question.

De ce fait, il est important de bien régler les droits d’accès à la fois du script lui-même, mais également les objets que le script va utiliser.

Par exemple, si dans votre script vous allez copier des fichiers d’un répertoire vers un autre, vérifiez que l’utilisateur de Tomcat a bien les droits d’accéder aux deux répertoires.

 

Dans le fichier script, il convient d’utiliser des références absolues vers les répertoires.

 

Liste des scripts disponibles

Voici la liste des scripts disponibles et leurs fonctions :

Script	Langage	Description
ClipbarcodeCheckInRelocate	Python	Ce script transforme un fichier CSV en entrée contenant deux colonnes. Une colonne le code article ou code boite et une colonne l’adresse de localisation. Il génère ensuite des actions Clipbarcode de retour de l’article / boite et de sa relocalisation à l’adresse indiquée. Il convient de l’enchaîner avec une tâche Clipbarcode dans Damaris RM.
cpFiles	Python	Ce script lit les répertoires Jukebox de Damaris LDS, dans le cas où ceux-ci contiennent un fichier séparé pour chaque fichier archivé. Ceci ne concerne que les documents de type natif ou image. Il copie et renomme également les fichiers LDS liés aux documents. La sortie de cette tâche devient l’entrée des tâches de type Extracteur d’Index. Ce script est généralement utilisé lors de reprises d’historiques Damaris LDS vers Damaris RM.
createCSV	Python	Crée des fichiers CSV compatibles avec Damaris ArchiveImport à partir de fichiers CSV incompatibles en entrée. Le résultat de ce script peut être utilisé pour des tâches Damaris ArchiveImport.
Excel2UserImport	Python	Crée un fichier XML compatible avec Importation Utilisateurs de Damaris RM. En entrée vous pouvez utiliser un fichier de type CSV où les informations de base vont être utilisées pour créer le XML. Le résultat de ce scripte peut être utilisé dans la fonction “IMPORT” du menu Utilisateurs dans Damaris RM.
SpoolFormatting	Python	Ce script reformate un fichier spool texte en entrée comportant des codes sauts. A la sortie, il génère un fichier texte où les codes sauts sont traduits. Vous pouvez utiliser le résultat de ce script dans une tâche de type FDI Générateur.
Scanned2Clipbarcode	Python	Ce module formate les données brutes entrantes depuis des lecteurs de code-à-barres en format compatible avec Damaris ClipBarcode. NB : Depuis Damaris RM version 5.4, la tâche planifiée ClipBarcode est à même de gérer les données brutes et de les traduire. De ce fait, ce module devient obsolète à partir de cette version de Damaris RM