Configurer une tâche Exécuter commande externe

Created On21 juillet 2018

Last Updated On11 octobre 2024

byartakabedi

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-cicontiennent 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
pdf_2_pdf_text	Python	Génère un PDF texte à partir de PDF image numérisé. Le script pdf_2_pdf_text.py applique une reconnaissance de caractères sur les images. Une fois cette phase effectuée, vous pouvez soumettre le fichier en sortie à des fonctions comme PDFSplitter pour l’extraction des critères d’indexation (RAD et LAD). Attention : Ce script nécessite l’installation d’autres modules qu’il convient de déclarer dans les chemins d’accès aux exécutables (PATH).
sftp_2_damaris_rm	Python	Ce script propose un grand nombre de fonctions pour transférer des fichiers vers et depuis Damaris RM. Il existe également sous la forme d’un module exécutable pour Microsoft Windows ne nécessitant aucune installation. Vous pouvez intégrer ce module dans une chaîne de capture et de dématérialisation de vos documents. sftp_2_damaris_rm utilise les API Web Service comme l’application Microsoft Windows Damaris Transfer.
pyFolders_2_rm	Python	Ce script balaye un répertoire et indexe les documents qui s’y trouvent en utilisant les noms des répertoires et sous-répertoires, ainsi que les noms des fichiers. pyFolders_2_rm est souvent utilisé pour la reprise d’historique de documents archivés dans un répertoire partagé de votre Entreprise.