|

|
CHECK
|
Description :
La balise CHECK sert pour la vérification aussi bien en externe (fichiers, répertoires, processus) ou en internet (code retour de la balise EXEC ou ACTION).
Elle sert donc à conditionner certain passage.z
Contrairement à un IF en programmation, elle ne comporte pas de ELSE.
L'attribut "name" est sensible à la casse.
Type des attributs :
Obligatoire :
type : Détermine le type de structure a vérifier.
value : Valeur à vérifier. Que ce soit pour un fichier en mode MD5 ou taille ou date de modification, nom d'un groupe, clef de base de registre ou version de système d'exploitation.
mode: Pour certaines vérification cette option est obligatoire.
Optionnel (en fonction du contexte) :
name : Permet de spécifier le nom d'une étiquette afin d'en vérifier la valeur.
mode : Configure le mode de vérification du type spécifié (
type). Peut être obligatoire pour certaines vérifications.
location : Emplacement à vérifier ou chemin fichier ou emplacement et / ou clef dans le registre. Paramètre pouvant accepter les valeurs de type "expand".
blockTag : Condition de passage dans la balise check.
Description des attributs :
Attributs
|
Options
|
Comment l'utiliser ?
|
Type
|
file : vérifie un fichier.
directory : vérifier un répertoire.
ADgroup : vérifier un groupe Active Directory (mode utilisateur).
registry : vérifie dans la base de registre.
sysver : version du système d'exploitation.
process : vérifie un nom de processus en mémoire.
date : Vérifie par rapport à une date ou une période.
exec : Vérification du code retour d'une exécution d'un programme.
action : Vérification l'état de l'action.
memo : Vérification d'un contenu de mémorisation.
freespace : Espace disque.
msgbox : Retour des boites à message où l'utilisateur a cliquer sur un bouton.
lib : Retour des boites à message où l'utilisateur a cliquer sur un bouton.
|
Pour le type exec, action, memo :
Les options true, false et ignored
|
Name
|
Pour le type exec :
Nom de la directive exec qui a été lancé.
Pour le type action :
Nom de l'action à vérifier
|
Inscrire le nom de l'étiquette du nom de l'action ou de l'exec.
|
Mode
|
Pour le type file :
test : mode par défaut, teste juste la présence.
md5 : Vérification en MD5
size : Vérification en taille du fichier (octets)
Pour le type date :
punctual : mode par défaut, test une date ponctuelle ou une série de date
period : test la date sur une période de temps.
stopdate : Si la date dépasse celle indiqué
startdate : à partir de la date.
Pour le type exec, action, memo, lib :
equal : mode par défaut, test le code retour si égale.
dif : test si la valeur est différente de la valeur à tester.
cont : test si la valeur contient la valeur à tester. Ce mode fait une recherche de chaîne de caractères
Pour le type msgbox :
equal : mode par défaut, test le code retour si égale.
dif : test si la valeur est différente de la valeur à tester.
Pour le type registry :
key : test une clef de base de registre.
value : test une valeur de base de registre.
|
|
Location
|
Pour le type registry :
Emplacement de la clef ou de la valeur.
Pour le type file :
 Chemin du fichier.
Pour le type freespace :
 Unité à verifier.
|
Les valeurs peuvent contenir des chaînes d'abstraction.
|
Value
|
Pour le type sysver :
win_nt351
win_nt4
win_95
win_98
win_2000
win_xp
win_7
win_7_32
win_7_64
win_vista
win_vista_32
win_vista_64
win_8
win_8_32
win_8_64
win_s2003
win_s2008
win_s2012
win_me
win_other
Pour le type process :
Le nom d'exécutable.
Pour le type registry :
Contenu de la valeur si besoin pour le test.
Pour le type ADgroup :
Le nom du groupe ou des groupes
Pour le type file :
la valeur du MD5 ou de la taille en octets.
Pour le type date :
En mode punctual :
"jj/mm/aaaa". Il est possible de placer plusieurs dates séparé par une virgule.
En mode period :
"jj/mm/aaaa". Il est possible de placer périodes de dates séparé par une virgule.
En mode stopDate :
"jj/mm/aaaa". Il n'est pas possible de placer plusieurs date.
En mode startDate :
"jj/mm/aaaa". Il n'est pas possible de placer plusieurs date.
Pour le type exec :
valeur à comparer (code retour du programme)
Pour le type lib :
valeur à comparer (code retour de la fonction)
Pour le type action :
valeur à comparer (true, false, ignored)
Pour le type msgbox :
valeur à comparer (yes, no, ok, cancel, continue, retry)
|
Pour le type registry :
le contenu de la valeur n'est pas obligatoire. Si rien n'est spécifié, ça sera juste la valeur ou la clef qui sera testé.
Pour le type ADgroup :
Attention pour spécifier un nom de groupe, il faut obligatoirement charger les groupes sur la "racine action".
Il est possible de spécifier plusieurs nom de groupe séparé par des virgules. Si l'utilisateur fait parti d'un groupe alors le vérification est validé.
Pour le type date :
En mode period, StopDate, StartDate :
Il est possible de spécifier plusieurs date, il faut séparer par des virgules les valeurs. (ex: jj/mm/aaaa,jj/mm/aaaa).
Pour le type action :
Les options true, false et ignored correspondent à 1, 0 et -2.
Ne pas utiliser à l'intérieur de l'action que l'on vérifie.
En effet celle-ci n'étant pas terminé, il ne sera pas possible de pouvoir la vérifier au niveau du retour.
Pour le type exec :
Il est possible de spécifier plusieurs code retour d’exécutions.
Pour le type lib :
Il est possible de spécifier plusieurs code retour d’exécutions. avec des ","
|
BlockTag
|
0 ou pie : Passage si existe (par défaut).
pie : Pass If Exist
1 ou pne : Passage si n'existe pas.
pne : Pass if Not Exist
2 ou signalerror : Remonte en erreur si l'expression (à l'aide de mode, type et value) n'est pas "vrai".
|
Si l'attribut n'est pas spécifié l'option sera automatiquement généré à "pie" par défaut.
|
Exemple :
Pour vérifier un fichier en mode MD5 :
<CHECK type="file" mode="md5" location="#temp#\essai.xml" value="dsdf6s51sdfsd5651sfd">
...
...
</CHECK>
|
Pour vérifier un répertoire :
<CHECK type="directory" location="c:\" blockTag="1">
...
...
</CHECK>
|
Pour vérifier une appartenance dans un groupe de l'utilisateur :
<CHECK type="ADGroup" value="SUPER_GROUPE,MON_DEUXIEME_GROUPE">
...
...
</CHECK>
|
Pour vérifier la version du système d'exploitation :
<CHECK type="sysver" value="win_2000,win_xp">
...
...
</CHECK>
|
Pour vérifier le code retour d'une application lancé avec la balise EXEC :
<CHECK type="exec" name="MonProgrammeLancement" value="0,3010">
...
...
</CHECK>
|
Pour vérifier la date ou une période de temps :
<CHECK type="date" mode="startdate" value="19/10/2010">
<MSGBOX title="startDate" text="Date valide" type="ok" />
</CHECK>
<CHECK type="date" mode="stopdate" value="19/10/2010">
<MSGBOX title="stopDate" text="Date valide" type="ok" />
</CHECK>
<CHECK type="date" mode="period" value="17/10/2010|18/10/2010,20/10/2010|21/10/2010">
<MSGBOX title="period" text="Date valide" type="ok" />
</CHECK>
<CHECK type="date" value="17/10/2010,18/10/2010,19/10/2010">
<MSGBOX title="ponctuel" text="Date valide" type="ok" />
</CHECK>
|
Pour conditionner le lancement d'une action :
<CHECK type="file" mode="md5" location="#temp#\essai.xml" value="dsdf6s51sdfsd5651sfd">
<ACTION name="COPY" version="0" descriptionAction="Essai en expand encore !">
<COPY type="file" sourceLocation="F:\Projets\ndf_execAction\essai.log" targetLocation="d:\temp\azertyu\iop\qsd\fghj\toto.txt" mode="createDir"/>
</ACTION>
</CHECK>
|
Créé avec HelpNDoc Personal Edition: Création d'aide CHM, PDF, DOC et HTML d'une même source