Principe
Il s’agit tout simplement d’utiliser le 🌎planificateur de tâches Windows pour lancer une ligne de commande. Vous pouvez utiliser soit le langage de scripts classique (cmd) soit de PowerShell.
Ex : C:\Vigilens\app\Vigilens.exe /vglAuto=“C:\Vigilens\Work\Archives\DEMO\Cohérence\Cohérence 1 min” /vglUser=“SCHEDULE_FR”
Paramétrage
Il se fait dans le menu Exécution automatique de l’AdminTool.
Il faut définir la liste des utilisateurs qui pourront se connecter via une ligne de commande.
Assistant
Dans le Designer se trouve un Assistant à la planification. Utilisez-le pour créer la structure de la commande, et enrichissez-la ensuite avec notre guide de syntaxe ci-dessous.
Utilisateur
Si on veut être sûr qu’il restera une connexion libre pour exécuter un travail planifié, il peut être utile de créer un utilisateur spécifique avec un profil de type “Arva Reporting Dedicated”.
Syntaxe
/vglForceInstall
- Permet de saisir un nouveau répertoire partagé. cette option est commune à Arva Reporting Designer et à l’AdminTool.
/vglExe=NomDeLaRequete
- Exécution de la requête passée en paramètre
- ne permet d’exécuter que des requêtes partagées.
- NomDeLaRequete représente le chemin relatif de la requête par rapport au répertoire partagé, tel qu’il apparaît dans l’interface Arva Reporting .
/vglAuto
- Exécution automatique de toutes les requêtes présentes dans le répertoire saisi interactivement par l’utilisateur.
- pour un process totalement automatique, utiliser /VglDir
/vglDir=NomDuDossier
- Exécution automatique de toutes les requêtes présentes dans le répertoire passé en paramètre
- NomDuDossier représente le chemin complet du répertoire à traiter, tel qu’il apparaît dans un explorateur de dossiers depuis la machine exécutant la ligne de commande.
/vglDirConf
Saisie du profil utilisé pour le traitement automatique (/vglDir)
/vglUser=NomUtilisateur
- Utilisée en combinaison avec l’option /vglDir pour spécifier un utilisateur autre que l’utilisateur par défaut (sous réserve que ce dernier ait été renseigné par /vglDirConf)
/vglMail=AdresseMail
- Utilisée en combinaison avec l’option /vglDir pour demander l’envoi par mail du résultat d’exécution (log).
/vglNumFormat=DecimalesMilliers
- Les valeurs numériques restituées utiliseront :
- le premier caractère précisé comme séparateur de décimales
- le second précisé comme séparateur de milliers
/vglOutput=TypeSortie
- Ce paramètre optionnel s’utilise avec le paramètre /vglExe.
- Force un type de sortie autre que celui prévu au niveau de la requête.
- Les valeurs possibles sont :
- Grid : Ecran de restitution (défaut)
- PDF : Fichier PDF
- XLS : Fichier Excel
- TXT : Fichier texte
/vglPDFType=TypeFichierPDF
- Spécifie le type de sortie PDF.
- Les valeurs possibles sont :
- 0 Grille
- 1 Etat
- Ce paramètre est obligatoire avec le paramètre vglOutput=PDF .
/vglPDFModel=ModeleImpression
- Spécifie le modèle d’état ou d’impression de la grille.
- ce paramètre est obligatoire avec le paramètre vglOutput=PDF
/vglMaxLineNumber=Valeur
- Spécifie le nombre maximum d’enregistrements à restituer.
- Au-delà l’exécution de la requête s’arrête et renvoie un message d’erreur.
- Ce paramètre permet de sécuriser l’emploi des ressources machine.
Passage de paramètres
- Les valeurs des paramètres à l’exécution sont spécifiées dans la ligne de commande en utilisant leur code court
- syntaxe : /CodeCourt=ValeurSelectionnee
- On peut ne pas les prendre en compte (autoriser toutes valeurs) par le caractère * en lieu et place de la valeur de sélection
Retour
L’application renvoie les codes de retour suivant :
- 0 ⇒ Tout s’est bien passé
- 10 ⇒ Connexion impossible
- 100 ⇒ Echec de l’initialisation OLE
- 1000 ⇒ Echec de l’initialisation des statistiques
- 10000 ⇒ Problème de licence
- 9999 ⇒ Erreur inconnue