CHECK

ND-Faciliti ExecAction ›› Balises ›› Standard ››
Parent Previous Next


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