INSTRUCTIONS


SOMMAIRE

 

Utilisation

Instructions

Exécution
Fichiers
Répertoire
Téléchargement
Processus
Accessoires
Gestion des
mise à jour
Gestion des références

Tests

 


UTILISATION

Utilisation des tests:

IF Test
   ...
 
  Code
  
...
IF_END
Effectue le Code  si le Test est valide



IFNOT
Test
   ...
  
Code
  
 ...
IF_END
Effectue le Code  si le Test est non-valide

 

IF Test
    ...
  
Code Valide
  
 ...
ELSE
    ...
  
Code Non Valide
  
 ...
IF_END
Effectue le Code Valide si le Test est valide si non il exécute le code non valide

 

IFNOT Test
    ...
  
Code Non Valide
  
 ...
ELSE
    ...
  
Code Valide
  
 ...
IF_END
Effectue le Code non valide si le Test est non valide si non il exécute le test valide

L'opérateur ELSE est supporté depuis la version V1.02
 

Il est possible d'imbriquer des tests.

Les paramètres entre crochets des instruction sont optionnelles.

La version indiqué à coté de l'instruction indique la version minimum de Updater.exe supportant cet instruction.


INSTRUCTIONS

 

EXECUTION

END
Arrête l'exécution de updater.

CLOSE
Arrête et Ferme Updater sur le champs.

SLEEP Millisecondes
Suspend l'exécution durant le nombre de millisecondes.

RUN Fichier
Exécute le Fichier script Updater, poursuit l'exécution dans ce nouveau fichier jusqu'au [END_SCRIPT] et revient a l'appelant.

EXIT
Arrête l'exécution du script courant et reprend à l'appelant. Si le END est exécuté dans le script principale, EXIT équivaut a END.

NEXT_RUN libellé_du_bouton  url/chemin_script
Cette instruction arrête l'exécution de Updater, affiche le libellé au bouton de la console.
Lorsque l'utilisateur clique sur le bouton le script spécifié est exécuté. .
Instruction supportée à partir de la version V1.05

 

FICHIERS

COPY source destination
Copie le fichier source vers la destination.
L'exécution continue si le fichier source n'existe pas.
Si la destination existe le fichier est remplacé.

MOVE source destination
Déplace le fichier source vers la destination.
L'exécution continue si le fichier source n'existe pas.
Si la destination existe le fichier est remplacé.

RENAME source destination
Renomme le fichier source en destination.
L'exécution continue si le fichier source n'existe pas.
Si la destination existe le fichier est remplacé.

DELETE fichier
Supprime le fichier
L'exécution continue si le fichier n'existe pas.

GET_FILE_INFO fichier
Affecte %VAR% avec la version du fichier spécifié, si Updater ne peut pas extraire la version, %VAR% est affecté à 0.0.0.0
Instruction supportée à partir de la version 1.11

 

REPERTOIRE

MKD [Répertoire]
Création du Répertoire.
(Si les répertoires intermédiaire n'existe pas il sont aussi automatiquement créés)
Si le répertoire n'est pas spécifié c'est le contenue de la variable %PATH%qui est utilisé
L'exécution continue si le répertoire existe déjà.

RMD [Répertoire]
Supprime le Répertoire, Si il contient des fichiers ou des dossiers ils sont alors aussi supprimés.
Si le répertoire n'est pas spécifié c'est le contenue de la variable %PATH%qui est utilisé
L'exécution continue si le répertoire n'existe pas.

PURGE [Répertoire]
Supprime le contenue du Répertoire spécifié.
Si le répertoire n'est pas spécifié c'est le contenue de la variable %PATH% qui est utilisé
L'exécution continue si le répertoire n'existe pas.
Instruction supportée à partir de la version 1.13

SELECT_PATH
Ouvre une fenêtre pour que l'utilisateur puisse choisir un répertoire.
Le répertoire sélectionné est stocké dans la variable% PATH%.
Si l'utilisateur Annule la fenêtre la variable %PATH% n'est pas affectée.

 

TELECHARGEMENT

GET Url [Répertoire] [fichier_local]
Téléchargement du fichier distant à l'Url dans le Répertoire local
Si le Répertoire n'est pas spécifié le fichier est téléchargé dans le répertoire spécifié par la variable %PATH%.
Si le nom du fichier local n'est pas spécifié le nom du fichier local téléchargé est identique au nom du fichier sur le serveur.
L'exécution est arrêté en erreur si le téléchargement échoue.
Si le fichier existe dans le Répertoire le fichier est remplacé.
Le parametre "fichier_local" est supporté à partir de la version 1.15

NGET Url [Répertoire] [fichier_local]
Téléchargement du fichier distant à l'Url dans le Répertoire local si celui si n'existe pas.
Si non l'exécution continue.
Si le Répertoire n'est pas spécifié le fichier est téléchargé dans le répertoire spécifié par la variable %PATH%.
Si le nom du fichier local n'est pas spécifié le nom du fichier local téléchargé est identique au nom du fichier sur le serveur.
L'exécution est arrêté en erreur si le téléchargement échoue.
Le parametre "fichier_local" est supporté à partir de la version 1.15

UPDATE Url [Répertoire] [Nombre/Date/Version] [fichier_local]
Téléchargement du fichier distant à l'Url dans le Répertoire local si le fichier n'existe pas ou si la valeur date/nombre/version spécifiée est supérieur à la référence trouvée en local.(Le nom de la référence est le nom du fichier)
Si le Répertoire n'est pas spécifié le fichier est téléchargé dans le répertoire spécifié par la variable %PATH%.
Si la valeur de test n'est pas spécifié c'est le contenue de la variable %UPDATE% qui est utilisée.
Si le nom du fichier local n'est pas spécifié le nom du fichier local téléchargé est identique au nom du fichier sur le serveur.
L'exécution est arrêté en erreur si le téléchargement échoue.
Si le fichier existe dans le Répertoire le fichier est remplacé, dans le cas d'un exe c'est à la charge du programmeur de tester et de tuer si besoin le processus.
Le parametre "fichier_local" est supporté à partir de la version 1.15

 

PROCESSUS

SHELL programme [paramètre] [opération]
Lance l'exécution d'un exécutable ou une commande avec les paramètres spécifiés.
L'opération par défaut est "open" peut être (print, open,etc... )
Les paramètres spécifié sur la ligne de commande sont séparés par des espaces sur Windows. Dans certains cas, il est nécessaire de passer les guillemets a la ligne de commande.

SHELL_WAIT programme [paramètre] [opération]
Identique à SHELL Lance l'exécution d'un exécutable ou une commande avec les paramètres spécifiés et attend la fin de son exécution. L'opération par défaut est "open" peut être (print, open )

WIN_WAIT Titre [Classe]
Attend la fermeture de la fenêtre de titre ou de classe spécifié.

WIN_CLOSE Titre [Classe]
Fermeture la fenêtre de titre ou de classe spécifié en envoyant un message WM_CLOSE.

WAIT Nom [Chemin]
Attend la fermeture de tous les processus de Nom ou de Chemin+Nom complet spécifié.
Problématique avec les versions antérieur à la V1.07 lorsque le chemin est spécifié.

KILL Nom [Chemin]
Tue toutes les applications de nom ou de Chemin+Nom complet spécifié.
Problématique avec les versions antérieur à la V1.07 lorsque le chemin est spécifié.

 

ACCESSOIRES

CLEAR
Efface les messages de la console.

PRINT Message [Icône]
Affiche le message sur la console.
Icônes supporté à partir de la version V1.02
ICO_BLANK, ICO_INFO, ICO_WARN, ICO_ERROR, ICO_OK, ICO_CHECK, ICO_UNCHECK
Icônes supporté à partir de la version V1.05
ICO_DOWNLOAD, ICO_FOLDER, ICO_FILE, ICO_PROCESS, ICO_DELETE, ICO_REGISTRY, ICO_INI, ICO_ACCESSORY
Par défaut ICO_BLANK est utilisé

MSG Message [Titre] [Icônes]
Affiche une fenêtre de message avec un bouton OK.
Ceci suspend l'exécution jusqu'a la validation de l'utilisateur.
Icônes peut avoir la valeur: ICO_INFO, ICO_WARN, ICO_ERROR, ICO_QUESTION
Paramètre Icônes supporté à partir de la version V1.02

OPEN_URL Url
Ouvre un nouveau navigateur sur l'Url spécifiée.

SET_INI_KEY Fichier.ini Section Clef Valeur
Modifie la Valeur de la Clef de la Section du fichier.ini spécifié.

GET_INI_KEY Fichier.ini Section Clef
Lit la Valeur de la Clef de la Section du fichier.ini spécifié, la valeur est retournée dans %VAR%
Instruction supportée à partir de la version V1.06

SET_REG_KEY Chemin Clef Valeur
Modifie la valeur de la Clef de type REG_SZ du registre spécifiée par le Chemin.
Chemin doit être de la forme: RACINE\..\..
( RACINE= HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE ou HKEY_CLASSES_ROOT )

GET_REG_KEY Chemin Clef
Lit la valeur de la Clef du registre de type REG_SZ spécifiée par le Chemin, la valeur est retournée dans %VAR%
Chemin doit être de la forme: RACINE\..\..
( RACINE= HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE ou HKEY_CLASSES_ROOT )
Instruction supportée à partir de la version V1.06

SET_LOGO [Fichier]
Affiche l'image JPEG ou BMP spécifiée par le fichier sur la console.
Si le fichier est vide, c'est le logo par défaut qui est affiché sur la console.
La fenêtre principale est redimensionnée (par rapport a la largeur du logo + CONSOLE_WIDTH et par rapport à la hauteur du logo), après l'appel de SET_LOGO
 (Préféré le JPEG pour la taille plus légère)
Pour les versions antérieur à la V1.05 le logo doit faire 150x400

SET_LINK Url [Libellé]
Paramètre le lien de la console. Affecte une Url et/ou un libellé au lien.
Si le libellé est vide, le libellé du lien est alors l'Url

SHORTCUT Raccourcis.lnk Cible [Description] [Répertoire de travail] [Fichier_Icon] [IconNum]
Créer un Raccourcis vers un programme, commande ou fichier Cible spécifié.
Si aucun fichier Icône n'est spécifié, il est possible de spécifié le N° de l'icône (IconNum) Windows.
Exemple standard:
SHORTCUT "%WIN_MENU_PRGM_PATH%\MyShortcut.lnk"  "%WIN_PATH%\Notepad.exe"
Exemple avec description:
SHORTCUT "%WIN_MENU_PRGM_PATH%\MyShortcut.lnk"  "%WIN_PATH%\Notepad.exe" "Voici un lien..."
Exemple avec répertoire de travail:
SHORTCUT "%WIN_MENU_PRGM_PATH%\MyShortcut.lnk"  "%WIN_PATH%\Notepad.exe"  "Voici un lien..."  %WIN_PATH%
Dans ces exemple le raccourcis "MyShortcut", situé dans le "Menu démarrer" pointe vers le "Notepad.exe" du répertoire de "Windows".(Sur un click droit sur un raccourcis Windows, le répertoire de travail correspond à la notion "Démarrer dans:", il est conseillé de le spécifier)

ODBC Opération Driver Attribut
Cette fonction permet de manipuler les Alias (DSN) ODBC. Elle utilise la fonction "SQLConfigDataSource" de la dll de windows "odbccp32.dll" (dispo depuis win98). C'est pourquoi il faut formater les attributs (cela rend l'instruction assez puissante).
Opération peut prendre les valeurs:
ODBC_ADD, ODBC_MODIFY, ODBC_REMOVE, ODBC_ADD_SYS, ODBC_MODIFY_SYS, ODBC_REMOVE_SYS.
(Les opération _SYS évolue dans les DSN Système)
Instruction supportée à partir de la version V1.04

SHOW
Cette fonction permet d'afficher la console dans le cas ou un script s'exécute en mode invisible.
Instruction supportée à partir de la version V1.05

HIDE
Cette fonction permet de cacher la console dans le cas ou un script s'exécute en mode visible.
Instruction supportée à partir de la version V1.05

DEBUG Flag
Cette instruction permet d'activer ou désactiver les messages de debug durant le processus
Flag peut être: ON ou OFF. Il est conseillé d'utiliser ce mode lors de la création ou la mise au point des scripts.
Instruction supportée à partir de la version V1.05

PLAY fichier.wav
Cette fonction permet de jouer le fichier sonore (.wav) spécifié.
Instruction supportée à partir de la version V1.07

SET_FILE_EXT_ASSO extention  nom_du_type  description  application
Cette fonction permet d'associer une application à une extention de fichier. Vous devez spécifier un nom de type de ficheir unique et ne description
Exemple:
SET_FILE_EXT_ASSO  "upd"  "Updater.Script"  "Fichier Script Updater"  "%APP_PATH%\UpdaterEdit.exe"
Cette exemple associe les fichiers .upd à l'éditeur de script.
Les icônes sont rafraîchi après un reboot de la machine ou si explorer.exe est redémarré.
Instruction supportée à partir de la version V1.11

PURGE_TMP Flag
Cette instruction permet d'activer ou de désactiver la purge automatique du répertoire "\Temp" lorsque le script principale se termine.
Instruction supportée à partir de la version V1.13

 

GESTION DES MISES A JOUR

REG_UPDATE Nom [Nombre/Date/Version]
Enregistre le Nombre, la Date ou laVersion de la dernière mise à jour. C'est la validation de la mise à jour complète.
Si la valeur n'est pas spécifié c'est le contenue de la variable %UPDATE% qui est enregistré

 

GESTION DES REFERENCES

REG_REF Nom Valeur
Enregistre la référence avec son nom et sa valeur (Texte, Chemin, Nombre, Version ou Date)
Le Nom de la référence peut est un chemin de fichier (Instruction UPDATE)


SET_REF Nom Valeur
Enregistre la référence avec son nom et sa valeur  (Texte, Chemin, Nombre, Version ou Date)
Le Nom de la référence peut est un chemin de fichier (Instruction UPDATE)
Instruction supportée à partir de la version V1.09


GET_REF Nom
Récupère la valeur de la référence enregistrée précédemment. La valeur est retournée dans %VAR%
Instruction supportée à partir de la version V1.08
 

TEST

TEST UTILISATEUR:

MSG_OK Message [Titre] [icônes]
Affiche une boite de dialogue avec un bouton OUI et un bouton NON.
Ce test est valide si l'utilisateur clique sur le bouton OUI, si il clique NON ou ferme la fenêtre il est non valide.

SELECT_PATH_OK
Ce test est valide si l'utilisateur à choisi un répertoire si non il est non valide (Annulation).
Le résultat du choix est stocké dans la variable PATH.

TEST SUR LES FICHIERS:

FILE_EXIST Fichier
Ce test est valide si le fichier spécifié existe si non il est non valide.

 

TEST SUR LES REPERTOIRES:

FOLDER_EXIST Répertoire
Ce test est valide si le répertoire spécifié existe si non il est non valide.

 

TEST SUR LES REFERENCES LOCALES:

REF_EXIST Nom
Ce test est valide si la référence spécifiée par le nom existe en local si non il est non valide.

REF_UPTODATE Nom [Nombre/Version/Date]
Ce test est valide si la valeur spécifiée par le nom de la référence existe et est égale ou supérieur à la valeur spécifié.
Il est non valide autrement ou si le contenue de la référence est de type différent ou vide
Si la valeur de test n'est pas spécifié c'est le contenue de la variable %UPDATE% qui est utilisée.

REF_EQUAL Nom  Nombre/Version/Date
Ce test est valide si la valeur de la référence spécifiée par le nom est égale a la valeur si non il est non valide.

REF_UPPER Nom  Nombre/Version/Date
Ce test est valide si la valeur de la référence spécifiée par le nom est supérieur a la valeur si non il est non valide.
Les valeurs doivent être du même type.
Instruction supportée à partir de la version 1.11

REF_LOWER Nom  Nombre/Version/Date
Ce test est valide si la valeur de la référence spécifiée par le nom est inférieur a la valeur si non il est non valide.
Les valeurs doivent être du même type.
Instruction supportée à partir de la version 1.11

REF_UPPER_OR_EQUAL Nom  Nombre/Version/Date
Ce test est valide si la valeur de la référence spécifiée par le nom est supérieur ou égale a la valeur si non il est non valide.
Les valeurs doivent être du même type.
Instruction supportée à partir de la version 1.11

REF_LOWER_OR_EQUAL Nom  Nombre/Version/Date
Ce test est valide si la valeur de la référence spécifiée par le nom est inférieur ou égale a la valeur si non il est non valide.
Les valeurs doivent être du même type.
Instruction supportée à partir de la version 1.11

 

TEST SUR LES PROCESSUS:

IS_RUNNING Nom [Chemin]
Ce test est valide si au moins un  processus de Nom ou de Chemin+Nom complet spécifié est en route. si non le test est non valide.

IS_OPEN Titre [Classe]
Ce test est valide si au moins une fenêtre de titre ou de classe spécifié est ouverte, si non le test est non valide.

 

TEST DIVERS

IS_INSTALLED Applicatif
Application peut être:
BDE (Borland Database Engine)
Ce test est valide si l'applicatif  est installé sur la machine si non il est non valide (Annulation).

EQUAL ValeurA ValeurB
Ce test est valide si la valeurA est égale à la valeur B, utile pour comparer des variables.
Instruction supportée à partir de la version 1.02

IS_EQUAL ValeurA ValeurB
Ce test est valide si la valeurA est égale à la valeur B, utile pour comparer des variables.
Instruction supportée à partir de la version 1.11

IS_LOWER ValeurA ValeurB
Ce test est valide si la valeurA est inférieur à la valeur B, utile pour comparer des variables.
Les valeurs peuvent être des nombres, dates ou versions il doivent être du même type.
Instruction supportée à partir de la version 1.11

IS_UPPER ValeurA ValeurB
Ce test est valide si la valeurA est supérieur  à la valeur B, utile pour comparer des variables.
Les valeurs peuvent être des nombres, dates ou versions il doivent être du même type.
Instruction supportée à partir de la version 1.11

IS_LOWER_OR_EQUAL ValeurA ValeurB
Ce test est valide si la valeurA est inférieur ou égale à la valeur B, utile pour comparer des variables.
Les valeurs peuvent être des nombres, dates ou versions il doivent être du même type.
Instruction supportée à partir de la version 1.11

IS_UPPER_OR_EQUAL ValeurA ValeurB
Ce test est valide si la valeurA est supérieur ou égale  à la valeur B, utile pour comparer des variables.
Les valeurs peuvent être des nombres, dates ou versions il doivent être du même type.
Instruction supportée à partir de la version 1.11