Vous êtes sur la page 1sur 59

DOCUMENTATION

Version 6.9

AUTOMATE D’ARCHIVAGE EN MASSE

DBBATCHCOLD

Mise à jour Mai 2006

Copyright Docubase Systems 2004

Tous droits de reproduction et d'utilisation réservés

IDDN.FR.001.140020.00.S.C.1999.000.20900

DOCUBASE Systems est membre de la DOCUBASE Systems est membre fondateur de

Fédération Nationale des Tiers de Confiance L’Association des Professionnels de la GED

(Collège N°3 - Experts)


DbBatchCold. Version 6.9

TABLES DES MATIERES


CONVENTIONS _______________________________________________________________________ 4

1. BIENVENUE DANS DBBATCHCOLD ________________________________________________ 5


1.1 Présentation générale ......................................................................................................................... 5

2. INSTALLATION DE DBBATCHCOLD ________________________________________________ 6


2.1 Préparation de l’environnement ......................................................................................................... 6
2.2 Enregistrement dans les services de Windows .................................................................................. 6
2.3 Déclaration dans les tables du registre............................................................................................... 7

3. PARAMETRAGE DU MODULE DBBATCHCOLD ______________________________________ 10


3.1 Le fichier DBBATCHCOLD.INI......................................................................................................... 10
3.1.1 MAX_TRT .................................................................................................................................. 10
3.1.2 LOG_FILE_PATH ...................................................................................................................... 11
3.1.3 SCRIPTS_FILE_PATH .............................................................................................................. 11
3.1.4 DEL_FILE_SCRIPT_AT_END ................................................................................................... 11
3.1.5 SCRIPT_GENERAL................................................................................................................... 11
3.1.6 DELAY_START_NOTIF............................................................................................................. 11
3.1.7 DELAY_START_TRT ................................................................................................................ 11
3.2 Le fichier DBBATCHDIRS. INI .......................................................................................................... 12
3.2.1 DIRGET...................................................................................................................................... 12
3.2.2 DIRWORK.................................................................................................................................. 13
3.2.3 TYPES ....................................................................................................................................... 13
3.2.4 HOURS ...................................................................................................................................... 13
3.2.5 SUBDIR...................................................................................................................................... 13
3.3 Le fichier DBBATCHSPOOLS. INI ................................................................................................... 13
3.4 Le fichier PARMSTA.INI................................................................................................................... 14
3.5 Le fichier DBBATCH.INI................................................................................................................... 15
3.5.1 TIMER ........................................................................................................................................ 15
3.5.2 ICON .......................................................................................................................................... 16
3.5.3 LOGFILEPATH .......................................................................................................................... 16

4. DESCRIPTIONS DES VARIABLES POUR LE FICHIER DBBATCHSPOOLS_________________ 18

5. CREATION DES FICHIERS SCRIPTS _______________________________________________ 20


5.1 Descriptions des variables pour les fichiers scripts ......................................................................... 20
5.2 Liste des instructions de DbBatch..................................................................................................... 22
5.3 Descriptif des instructions de DbBatch ............................................................................................. 23
5.4 Exemple de modèle de scripts .......................................................................................................... 43

2
DbBatchCold. Version 6.9

6. L’INTERFACE DU PLANIFICATEUR DE TACHES DBBATCH ____________________________ 45


6.1 En ligne de commande ..................................................................................................................... 45
6.2 En raccourci bureau .......................................................................................................................... 45
6.3 En mode interface ............................................................................................................................. 46
6.4 Description de l’interface................................................................................................................... 46
6.4.1 La barre de menu....................................................................................................................... 46
6.4.2 La barre d’icônes ....................................................................................................................... 50
6.4.3 Zone d’affichage du script.......................................................................................................... 50
6.4.4 Zone d’affichage du journal........................................................................................................ 51
6.4.5 Zone d’information sur le script en cours de traitement............................................................. 52
6.4.6 Zone d’information sur la ligne en cours de traitement.............................................................. 52

7. TABLE D’ILLUSTRATIONS _______________________________________________________ 53

8. GLOSSAIRE ___________________________________________________________________ 54

9. CONTACTS ____________________________________________________________________ 59

3
DbBatchCold. Version 6.9

CONVENTIONS

Renvoi vers le glossaire lors de la première utilisation


(G)
du terme

Aspect de la fenêtre à la première utilisation

NEW Nouvelle fonctionnalité

Nouvelle fenêtre

Interface modifiée par rapport à la version


précédente

INSTALL_HOME Répertoire d’installation

HOST Nom de l’ordinateur

SERVEUR Nom du poste serveur

Obligatoire

Attention à ce point particulier

4
DbBatchCold. Version 6.9

1. BIENVENUE DANS DBBATCHCOLD

1.1 Présentation générale

DBBATCHCOLD est un module permettant une automatisation des tâches en multithreads en temps réel et
suivant des conditions définies dans un fichier script.

DBBATCHCOLD fonctionne sous la forme d’un service Windows. Il se met en attente de fichiers sur des
disques et des répertoires spécifiés.

 Chaque type de fichier à traiter est associé à un type de spool.


 Chaque type de spool est associé à un traitement.
 Chaque traitement est associé à un modèle de script.

Ce modèle est utilisé pour générer un fichier script personnalisé qui est appliqué à chaque fichier spool.

Plusieurs fichiers spool peuvent être traités en parallèle.

5
DbBatchCold. Version 6.9

2. INSTALLATION DE DBBATCHCOLD

2.1 Préparation de l’environnement

Choisir un répertoire d’installation puis l’enrichir avec les fichiers suivants :

Figure 1: Les fichiers nécessaires au fonctionnement du module

Attention, cette documentation ne s’applique uniquement qu’avec les versions citées ci-dessus.

2.2 Enregistrement dans les services de Windows

Pour l’enregistrement du module dans les services Windows :

 Ouvrez une console CMD par le bouton Démarrer, Exécuter…


 puis saisissez CMD dans la cellule Ouvrir :

Puis dans l’invite de commandes :

 placez vous dans le répertoire hébergeant le module puis saisissez :

6
DbBatchCold. Version 6.9

DBBATCHCOLD.EXE -SERVICE

A l’issue de cette manipulation, le succès se traduit par l’ajout de ligne suivante dans la liste des services
Windows

Pour le moment laissez le service en mode arrêté.

2.3 Déclaration dans les tables du registre

Le fichier DBBATCHCOLD.REG indique le répertoire où se trouvent les fichiers de paramétrage à prendre


en compte.

Voici son contenu :

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\DOCUBASE\DbBatchCold]

"ExecPath"="C:\\Docubase\\dbbatchcold"

Afin de renseigner la table de registre, ce fichier doit être modifié avec un éditeur de texte en indiquant le
path adéquat (clé ExecPath),

 Exécutez le en double cliquant dessus.

7
DbBatchCold. Version 6.9

 Confirmez l’action par Oui,

 Valider l’information par le bouton OK.


 Afin de vérifier l’enregistrement, ouvrez la table de registre par le bouton Démarrer, Exécuter…
 puis saisissez

 Validez par le bouton OK.

Figure 2: La base de registre

8
DbBatchCold. Version 6.9

Chercher dans l’arborescence

HKEY_LOCAL_MACHINE\SOFTWARE\DOCUBASE\DbBatchCold

Avec nom de la valeur ExecPath et valeur C:\Docubase\dbbatchcold.

9
DbBatchCold. Version 6.9

3. PARAMETRAGE DU MODULE DBBATCHCOLD

Pour le fonctionnement de DBBATCHCOLD, 5 fichiers de paramétrage sont nécessaires :

DBBATCHCOLD.INI

DBBATCHDIRS. INI

DBBATCHSPOOLS. INI

PARMSTA.INI

DBBATCH.INI

Ces derniers doivent cohabiter avec le fichier DBBATCHCOLD.EXE

3.1 Le fichier DBBATCHCOLD.INI


Il contient les informations générales du module.

Il contient par exemple :

[GENERAL]

MAX_TRT=20

LOG_FILE_PATH=C:Docubase\Dbbatchcold\CSV

SCRIPTS_FILE_PATH= C:\Docubase\Dbbatchcold\Dbbatchtemp

DEL_FILE_SCRIPT_AT_END=Y

SCRIPT_GENERAL= C:\Docubase\Dbbatchcold \script\general.txt

[DELAY]

DELAY_START_NOTIF=1000

DELAY_START_TRT=1000

3.1.1 MAX_TRT
Nombre maximum de traitements simultanés.

Il s’agit du nombre maximum de scripts pouvant être exécutés en parallèle.

10
DbBatchCold. Version 6.9

3.1.2 LOG_FILE_PATH
Répertoire où est créé le fichier DBBATCHCOL.CSV (fichier journal des traitements)

Figure 3: Exemple de fichier CSV

3.1.3 SCRIPTS_FILE_PATH
Répertoire où sont créés les scripts personnalisés.

3.1.4 DEL_FILE_SCRIPT_AT_END
La valeur Y indique que les fichiers scripts sont supprimés après exécution.

La valeur N permet de les sauvegarder pour une vérification ultérieure ou exécution dans DbBatch.exe en
cas d’anomalie.

3.1.5 SCRIPT_GENERAL
Nom complet du fichier de script général qui sera exécuté en parallèle des autres traitements.

Ce script est lancé au démarrage du service.

Il peut servir pour l’arrêt, le démarrage et la sauvegarde des index des bases par exemple.

3.1.6 DELAY_START_NOTIF
Délai en millisecondes entre 2 démarrages de notification.

Augmenter ce paramètre permet d’éviter la réception d’un très grand nombre de fichiers au même moment.

3.1.7 DELAY_START_TRT
Délai en millisecondes entre 2 démarrages de traitements.

11
DbBatchCold. Version 6.9

Augmenter ce paramètre permet d’éviter de lancer un grand nombre de traitements au même moment.

3.2 Le fichier DBBATCHDIRS. INI


Il contient les informations concernant les disques et les répertoires à scruter. Dès qu’un fichier est copié
dans le répertoire spécifié, le service est notifié et lance le traitement du spool.

Il contient par exemple :

[DIR1]

DIRGET= C:Docubase\Dbbatchcold\D1

DIRWORK= C:Docubase\Dbbatchcold \dirwork\D1

TYPES=[*.LST-LST1],[*.PDF-PDF1],[*.TXT-TXT1]

HOURS=[23:00-02:00],[09:00-18:15]

SUBDIR=Y

[DIR2]

DIRGET= C:Docubase\Dbbatchcold\D2

DIRWORK= C:Docubase\Dbbatchcold \dirwork\D2

TYPES=[*.LST-LST2],[*.PDF-PDF2]

HOURS=[06:00-18:00]

SUBDIR=N

[DIRn]

Chaque section DIR correspond un répertoire à scruter.

A utiliser dans le cas ou plusieurs applications exportent leurs spools respectifs par exemple.

3.2.1 DIRGET
Répertoire de dépose des fichiers spools.

Dès réception, les fichiers sont transférés dans le répertoire

12
DbBatchCold. Version 6.9

3.2.2 DIRWORK

DIRWORK

Répertoire de traitement des fichiers spools.

3.2.3 TYPES
[Masque.Extension-Type de spool]

Les spools sont reconnus en fonction d’un masque de fichier.

Exemple : [FAC*.LST-FACTURE]  Filtre tous les fichiers commençant par FAC et ayant l’extension LST

Chaque Masque.Extension est associée à un type de spool dont les paramètres sont décrits dans le fichier

DBBATCHSPOOLS. INI

3.2.4 HOURS
[début-Fin]

Indique les plages horaires pendant lesquelles le service vérifiera la présence de fichiers dans le répertoire
DIRGET et lancera les traitements.

Plusieurs plages sont possible exemple :

[début1-Fin1], [début2-Fin2], [débutn-Finn]

3.2.5 SUBDIR
Y : Les fichiers présents dans les sous-répertoires de DIRGET, s’il existe, sont pris en compte.

N : seuls les fichiers du répertoire DIRGET sont pris en compte.

3.3 Le fichier DBBATCHSPOOLS. INI


Il contient les informations concernant les traitements à appliquer par type de spool.

Il contient par exemple :

[VARIABLES]

VAR1=BASEID

13
DbBatchCold. Version 6.9

VAR2=FRM

[LST1]

SCRIPT=C:\Docubase\Dbbatchcold\script\lst1.txt

FRM = %1[2-4] + %1[8-12]

BASEID = #

[PDF1]

SCRIPT = C:\Docubase\Dbbatchcold\script\pdf1.txt

FRM = # ['_',1] + %1

[PDF2]

SCRIPT= C:\Docubase\Dbbatchcold\script\pdf2.txt

FRM = # ['-',1] + !

[TXT1]

SCRIPT= C:\Docubase\Dbbatchcold\script\txt1.txt

FRM = # ['|',3] + ".FRM"

[VARIABLES]

Les variables qui seront remplacées dans les scripts personnalisés doivent être déclarées dans cette
section.

SCRIPT

Nom complet du modèle de script qui sera personnalisé en fonction du fichier à traiter.

(Voir §4

3.4 Le fichier PARMSTA.INI


Ce dernier doit contenir la section et les clés suivantes.

[DBBATCH]

FONTNAMESCRIPT=Arial

14
DbBatchCold. Version 6.9

FONTSIZESCRIPT=65523

MESSAGELEFT=0

MESSAGERIGHT=1024

MESSAGETOP=475

MESSAGEBOTTOM=692

MESSAGEDOCK=1

SCRDIR=C:\Docubase\dbbatchcold\DBBATCHTMP

Ou la clé SCRDIR indique le répertoire ou seront créé les scripts temporaires

3.5 Le fichier DBBATCH.INI


Ce dernier doit contenir la section et les clés suivantes.

TIMER=3000

ICON=N

LOGFILEPATH=c:\docubase\dbbatchcold\

AetRcFile=c:\docubase\client\dbaet.end

AadRcFile=c:\docubase\client\dbaad.end

AetRcStart=19

AadRcStart=19

AetRcLength=8

AadRcLength=8

AetPaStart=10

AadPaStart=10

AetPaLength=8

AadPaLength=8

3.5.1 TIMER
Exprimé en ms c’est le délai d’attente entre deux instructions. La valeur par défaut est 5000. Les valeurs
recommandées se situent entre 1000 et 30 000.

15
DbBatchCold. Version 6.9

3.5.2 ICON
Y ou N pour le démarrage en mode icône

3.5.3 LOGFILEPATH
Chemin indiquant la localisation du fichier de log DBBATCH.LOG

Par défaut le fichier log sera dans le répertoire courant.

AetRcFile

Chemin indiquant la localisation du fichier résultant du traitement d’archivage d’états DBAET.END

AadRcFile

Chemin indiquant la localisation du fichier résultant du traitement d’archivage automatique DBAAD.END

AetRcStart

Dans le fichier DBAET.END, indique la colonne de départ du champ ″statut″ (1)

AetRcLength

Dans le fichier DBAET.END, indique la longueur du champ ″statut″ (8)

AetPaStart

Dans le fichier DBAET.END, indique la colonne de départ du champ ″nbr de pages archivées″ (10)

AetPaLength

Dans le fichier DBAET.END, indique la longueur du champ ″nbr de pages archivées″ (8)

Remarque : Le nombre entre parenthèses correspond à la valeur par défaut.

Idem pour AAD…

Pour information, ci-dessous le contenu du fichier DBAET.END

16
DbBatchCold. Version 6.9

00000000 00000000 00000000

Remarques : Ce dernier est créé après chaque exécution du DBAET.EXE (module d’archivage des états).

Il est impératif de le supprimer après chaque archivage pour remettre les compteurs à zéro.

17
DbBatchCold. Version 6.9

4. DESCRIPTIONS DES VARIABLES POUR LE FICHIER


DBBATCHSPOOLS

Les variables permettent d’extraire des valeurs à partir du nom du fichier à traiter.

Exemple avec le traitement du fichier ci-dessous :

C:\Docubase\Dbbatchcold \Dirwork\D1\facture_client_x.lst

Nous aurons

%n

Nième niveau de répertoire.

Exemple : %2  Dbbatchcold

Nom du fichier sans l'extension

Exemple : facture_client_x

Extension du fichier

Exemple : lst

"Chaîne"

Ajoute une chaîne de caractères au contenu de la variable

Exemple : %3+".FRM"  Dirwork.FRM

Attention, si l'expression commence par une chaîne de caractères, il faut doubler les guillemets.

Exemple : FRM=""Form""+% 3+".FRM"

18
DbBatchCold. Version 6.9

Dans l'exemple de fichier DbBatchSpools.ini décrit plus haut, nous aurons donc les valeurs suivantes pour le
nom de fichier d’exemple:

C:\Docubase\Dbbatchcold \Dirwork\D1\facture_client_x.lst

[LST1]

FRM = %1[3-8] + %2 [8-11]  FRM = cubasecold

cependant, si les parties ne possèdent pas les caractères requis, elles seront ignorées

Exemple : FRM = %1[3-8] + %3 [8-11]  FRM=cubase

BASEID = #  BASEID = facture_client_x

[PDF1]

FRM = # ['_',1] +%1  FRM = factureDocubase

[PDF2]

FRM = # ['-',1] + !  FRM = facture_client_xlst

Remarques : Dans ce cas spécifique, il n’y a pas de ‘-‘ dans la chaîne donc #['-',1] = #.

[TXT1]

FRM = # ['|',3] + ".FRM"  FRM = .FRM

Remarques : Pas de ‘|‘ dans la chaîne donc #['|', 3] n’existe pas donc vide.

19
DbBatchCold. Version 6.9

5. CREATION DES FICHIERS SCRIPTS

5.1 Descriptions des variables pour les fichiers scripts

Un script personnalisé est généré pour chaque fichier à traiter.

Dans les scripts, toutes les variables du modèle de script sont remplacées par leurs valeurs.

Dans le modèle de script, les noms des variables doivent être entourés par des %

Exemple : %FRM%, %BASEID% (Voir DBBATCHSPOOLS.INI)

Les variables prédéfinies suivantes sont également reconnues et remplacées par les valeurs
correspondantes :

%% : Nom du fichier avec son path

$$ : Path du fichier

@@ : Nom du fichier sans le path et avec l'extension

## : Nom du fichier sans le path et sans l'extension

Exemple : Pour le fichier a traiter, suivant

C:\Spools\factures\A\facture_client_x.lst

Nous aurons :

%% correspondant à C:\Spools\factures\A\facture_client_x.lst

$$ correspondant à C:\Spools\factures\A

@@ correspondant à facture_client_x.lst

## correspondant à facture_client_x

%UNIQUE% Cette variable est remplacée par un nombre unique au format :

20
DbBatchCold. Version 6.9

YYYYMMJJHHMMSSLLLIII

Avec :

YYYY : pour l’année

MM : pour le mois

JJ : pour le jour

HH : pour l’heure

MM : pour les minutes

SS : pour les secondes

LLL : pour les milli-secondes

III : pour un numéro incrémental

%DAY% Le jour courant au format :

YYYYMMJJ

Avec :

YYYY : pour l’année

MM : pour le mois

JJ : pour le jour

%DAY_HOUR% Le jour et l'heure courante :

YYYYMMJJ_HHMMSS

Avec :

YYYY : pour l’année

MM : pour le mois

JJ : pour le jour

21
DbBatchCold. Version 6.9

HH : pour l’heure

MM : pour les minutes

SS : pour les secondes

5.2 Liste des instructions de DbBatch

INSTRUCTION 99:99 Démarrer le script immédiatement (uniquement sur la première ligne du script)

INSTRUCTION HH :MM Planification des instructions suivantes à l’heure spécifiée

INSTRUCTION CAT_F Concaténation de deux fichiers

INSTRUCTION CHDIR Modification du répertoire de travail

INSTRUCTION CNV00 Conversion de fichier avec troncature des enregistrements à n caractères

INSTRUCTION CNV01 Découpage d’un fichier avec enregistrements de longueur fixe

INSTRUCTION CNV02 Conversion de fichier avec suppression des n premières colonnes

INSTRUCTION DCOPY Copie d’un fichier avec une extension datée

INSTRUCTION DIR Changement de répertoire

INSTRUCTION DNAME Copie de fichier avec extension datée

INSTRUCTION DBAAD Exécution du module d’Archivage Automatique de Documents de Docubase

INSTRUCTION DBAET Exécution du module d’Archivage d’Etats de Docubase

INSTRUCTION DIR_C

INSTRUCTION DIR_D

INSTRUCTION ENDIF Clôture des instructions IF précédemment ouvertes

INSTRUCTION EMAIL

INSTRUCTION ERASESuppression de fichier

INSTRUCTION FCOPY Copie forcée de fichier

INSTRUCTION FEXIT Fermeture immédiate du script

INSTRUCTION FLOOPBoucle pour redémarrer depuis le début du script

INSTRUCTION FNAME Renommer ou déplacer un fichier

INSTRUCTION FSAVE Permet d’exécuter un programme externe de sauvegarde

INSTRUCTION FWAIT Sortie du script avec attente de saisie clavier

INSTRUCTION GOTOS Branchement sur un autre fichier script

INSTRUCTION IF_ER AET Bloc d’instructions à exécuter si la dernière session d’archivage DBAET a
généré des erreurs

22
DbBatchCold. Version 6.9

INSTRUCTION IF_ER AAD Bloc d’instructions à exécuter si la dernière session d’archivage DBAAD a
généré des erreurs

INSTRUCTION IF_FE Bloc d’instructions à exécuter si un fichier existe et n’est pas vide

INSTRUCTION IF_PA Bloc d’instructions à exécuter si au moins une page a été acceptée lors de la
dernière session d’archivage

INSTRUCTION IF_WF Instruction de test utilisée après la commande WAITF

INSTRUCTION IFDAY Bloc d’instructions à exécuter en fonction du jour

INSTRUCTION IFNER AET Bloc d’instructions à exécuter si la dernière session d’archivage DBAET n’a
pas généré d’erreur

INSTRUCTION IFNER AAD Bloc d’instructions à exécuter si la dernière session d’archivage DBAAD n’a
pas généré d’erreur

INSTRUCTION IFNFE Bloc d’instructions à exécuter si un fichier n’existe pas ou est vide

INSTRUCTION IFNPA Bloc d’instructions à exécuter si aucune page n’a été acceptée lors de la dernière
session d’archivage

INSTRUCTION IFNWF Instruction de test utilisée après la commande WAITF

INSTRUCTION ISAV2 Sauvegarde des fichiers d’index si ceux-ci ne sont pas corrompus

INSTRUCTION NOERR Remise à zéro du flag des erreurs d’archivage

INSTRUCTION PAUSESuspend l’exécution pendant n minutes

INSTRUCTION PCALL Appel d’un programme externe

INSTRUCTION PRINT Impression d’un fichier (sur l’imprimante par défaut)

INSTRUCTION PURGE Suppression d’un fichier si la dernière session d’archivage s’est bien terminée

INSTRUCTION SPKEY Envoi d’une séquence de touches à un programme

INSTRUCTION RMDOC Suppression des documents référencés dans un fichier AAD (après archivage)

INSTRUCTION TCOPY Copie d’un fichier si le fichier destination n’existe pas

INSTRUCTION WAITF Suspension du script en attendant la présence d’un fichier

INSTRUCTION WRITE Ecrit une chaîne de caractères dans fichier spécifié

INSTRUCTION WTIME Suspend le programme jusqu’à l’heure indiquée

5.3 Descriptif des instructions de DbBatch

☛ Pour information :

Les paramètres des instructions peuvent indifféremment être saisis en majuscules ou en minuscules.

23
DbBatchCold. Version 6.9

Instruction 99:99
Type

Planification de l’exécution

Description

Démarrage immédiat du script.

Cette instruction figure obligatoirement en première ligne du script.

Instruction HH:MM
Type

Planification de l’exécution

Description

Démarrage du script à l’heure indiquée.

Cette instruction figure obligatoirement en première ligne du script.

Syntaxe

HH:MM

Exemple d’utilisation

06:30

Instruction CAT_F
Type

Concaténation de fichiers

Description

Concaténation des deux fichiers passés en argument.

Attention : le fichier destinataire est le premier fichier fourni en argument.

Syntaxe

CAT_F <fichier_destination> <fichier_source>

Le contenu du fichier source est inséré en fin du fichier de destination.

Exemple d’utilisation

CAT_F historique.txt resume.txt

24
DbBatchCold. Version 6.9

Instruction CHDIR
Type

Déplacement dans l’arborescence

Description

Modification du répertoire de travail.

Syntaxe

CHDIR <chemin>

Exemple d’utilisation

CHDIR c:\docubase

Instruction CNV00
Type

Conversion de fichier

Description

Conversion de fichier.

Seuls les n premiers caractères de chaque enregistrement sont conservés.

Syntaxe

CNV00 <fichier_source> <fichier_destination> <nombre_de_caractères>

Exemple d’utilisation

CNV00 input.lst output.lst 80

Il ne sera conservé que les 80 premiers caractères de chaque enregistrement.

Instruction CNV01
Type

Conversion de fichier

Description

Conversion de fichier.

Remaniement d’un fichier comportant des enregistrements de longueur fixe, en fichier avec des
enregistrements de longueur variable. Tous les N caractères, le CR/LF est inséré (carriage return / line feed,
code hexadécimal OD OA).

Les espaces à droite sont tronqués.

Une option supplémentaire permet de tronquer les X premiers caractères de l’enregistrement.

Syntaxe

25
DbBatchCold. Version 6.9

CONV01 <fichier_source> <fichier_destination> <longueur> <troncature>

Exemple d’utilisation

CONV01 input.lst output.lst 80 4

Le fichier ″output.lst″ comportera des enregistrements de 80 positions dont les 4 premiers caractères sont
éliminés.

Instruction CNV02
Type

Conversion de fichier

Description

Conversion de fichier, avec suppression des N premiers caractères.

Syntaxe

CONV02 <fichier_source> <fichier_destination> <longueur>

Exemple d’utilisation

CONV02 input.lst output.lst 2

le fichier ″input.lst″ sera retranscrit en ignorant les 2 premières colonnes.

Instruction DCOPY
Type

Copie de fichier

Description

Duplication du fichier fourni en argument : le fichier de destination aura le même nom, accompagné d’une
extension basée sur la date du jour.

Cette extension est composée de 3 caractères :

Un caractère représentant le mois en cours 1 pour janvier, 2 pour février, … A pour octobre, B pour
novembre, C pour décembre.

deux chiffres représentant le jour du mois en cours.

Dans le cas du nom de fichier contenant plusieurs caractères ".", l'extension est la chaîne suivant le dernier
point.

Syntaxe

DCOPY <fichier>

Exemple d’utilisation

DCOPY c:\docubase\fichier.lst

le fichier ″fichier.lst″ sera copié en ″fichier.b24″ (la date du jour étant le 24 novembre)

26
DbBatchCold. Version 6.9

DCOPY c:\docubase\fichier.tmp.ini

le fichier ″fichier.tmp.ini″ sera copié en ″fichier.tmp.b24″ (la date du jour étant le 24 novembre)

Instruction DIR..
Type

Déplacement dans l’arborescence

Description

Cette commande est équivalente à la commande DOS ″cd ..″ : elle permet de remonter d’un niveau dans
l’arborescence des répertoires.

Syntaxe

DIR . .

Instruction DIR_C
Type

Création de répertoire

Description

Crée le répertoire correspondant au PATH indiqué

Syntaxe

DIR_C path

Exemple d’utilisation

DIR_C C:\temp\test

Crée le répertoire test dans C:\temp

Instruction DIR_D
Type

Création de répertoire

Description

Supprime un répertoire et tout son contenu

Syntaxe

DIR_D path

Exemple d’utilisation

DIR_D C:\temp\test

Supprime le répertoire test dans C:\temp

27
DbBatchCold. Version 6.9

Instruction DNAME

Type

Renommer / déplacement de fichier

Description

Cette commande permet de renommer un fichier en lui adjoignant une extension datée.

Cette extension a le format.AAAAMMJJ

Syntaxe

DNAME <fichier>

Exemple d’utilisation

DNAME spool.txt

le fichier ″spool.txt″ sera renommé en SPOOL.TXT.19981124 (la date du jour étant le 24 novembre 1998)

Instruction DBAAD
Type

Classement de documents

Description

Lance l’exécution du programme Docubase DBAAD (Archivage Automatique de Documents en mode


différé), et attend la fin du traitement.

Les arguments sont ceux du programme DBAAD.

DBBATCH teste que le fichier AAD fourni en paramètre existe bien.

Syntaxe

DBAAD fichier.aad /USER=DUPONT /PASS=XXX /BASEID=DEMO /END

Instruction DBAET
Type

Classement de documents

Description

Lance l’exécution du programme Docubase DBAET (Archivage d’Etats), et attend la fin du traitement.

Les arguments sont ceux du programme DBAET.

DBBATCH teste que l’état fourni en paramètre existe bien.

Syntaxe

DBAET fichier.lst /FRM=fichier.frm /USER=DUPONT /PASS=XXX /BASEID=DEMO /END

28
DbBatchCold. Version 6.9

Instruction EMAIL
Type

Envoi de message

Description

Elle permet d'envoyer un email à un destinataire en précisant le serveur SMTP, l'expéditeur, le destinataire,
le titre et le texte de l'email.

Syntaxe

EMAIL Serveur_SMTP Adresse_expéditeur Adresse_destinataire Titre Texte

Chaque argument peut être délimité ou non par des guillemets.

Exemple d’utilisation

EMAIL smtp.cegedim.fr alain.dupond@docubase-systems.fr pierre.durant@docubase-systems.fr "Test


SMTP" ça marche

Instruction ENDIF
Type

Bloc de commandes

Description

Clôture l’instruction IF précédemment ouverte.

Instruction ERASE
Type

Suppression de fichiers

Description

Suppression de fichier.

Syntaxe

ERASE <fichier>

Exemple d’utilisation

ERASE trace.log

Instruction FCOPY
Type

Copie de fichiers

29
DbBatchCold. Version 6.9

Description

Effectue une copie de fichier. Si le fichier destination existe déjà, celui-ci est remplacé.

Syntaxe

FCOPY <fichier_source> <fichier_destination>

Exemple d’utilisation

FCOPY spool.lst spool.bak

Instruction FEXIT
Type

Arrêt de l’exécution

Description

Pour terminer immédiatement le script en cours.

Se place en dernière ligne du script : les lignes suivantes ne seront pas exécutées.

Instruction FLOOP
Type

Chaînage de scripts

Description

Permet d’exécuter un script en boucle.

Cette instruction se place en dernière ligne du script. L’exécution est enchaînée sur la première ligne du
script.

Instruction FNAME
Type

Renommer / déplacement de fichiers

Description

Renomme le fichier, si et seulement si le fichier destination n’existe pas déjà.

Si le chemin indiqué pour le fichier destination est différent, il s’agit d’un déplacement de fichier.

Syntaxe

FNAME <fichier_source> <fichier_destination>

Exemple d’utilisation

FNAME spool.lst spool.old

30
DbBatchCold. Version 6.9

Instruction FSAVE
Type

Sauvegarde

Description

Permet d’exécuter un programme externe de sauvegarde.

Le script attend que l’exécution du programme externe soit terminée avant de poursuivre sur les instructions
suivantes.

Syntaxe

FSAVE <commande> <arguments>

Exemple d’utilisation

FSAVE ntbackup.exe c:\docubase\*.*

Instruction FWAIT
Type

Arrêt de l’exécution

Description

Pour terminer immédiatement le script en cours. Un message restera affiché à l’écran jusqu’à tant qu’une
touche soit activée.

Se place en dernière ligne du script : les lignes suivantes ne seront pas exécutées.

Instruction GOTOS
Type

Arrêt de l’exécution

Description

Enchaîne l’exécution sur un autre script.

Un script peut s’appeler lui-même.

Il n’y a pas de retour à l’appelant. Il n’y a pas de limite au nombre de GOTOS à enchaîner.

Syntaxe

GOTOS <script>

Exemple d’utilisation

GOTOS suite.scr

31
DbBatchCold. Version 6.9

IF_ER AET

Instruction IF_ER AAD


Type

Instruction de test

Description

Enchaîne sur les instructions suivantes si le classement de documents précédent a donné lieu à une erreur.
Ces instructions doivent se terminer par la commande ENDIF.

Le classement de documents est piloté par les modules Docubase DBAAD ou DBAET.

Ces modules génèrent les informations pertinentes dans le fichier DBAAD.END (respectivement
DBAET.END)

Exemple d’utilisation

DBAAD lot.aad /USER=STORAGE /BASEID=COMPTA /END

IF_ER

WRITE archive.log Problème d’archivage

ENDIF

Si le module d’archivage a donné lieu à une erreur, le message ″Problème d’archivage″ est écrit dans le
fichier ″archive.log″.

Instruction IF_FE
Type

Instruction de test

Description

Exécute les instructions suivantes si le fichier précisé existe et n’est pas vide.

Ces instructions doivent se terminer par la commande ENDIF.

Syntaxe

IF_FE <fichier>

Exemple d’utilisation

IF_FE flag.txt

WRITE trace.log Fichier trouvé !

PRINT trace.log

ENDIF

32
DbBatchCold. Version 6.9

si le fichier ″flag.txt″ existe, le message ″Fichier trouvé″ est inscrit dans ″trace.log″. Puis ″trace.log″ est
imprimé.

Instruction IF_PA
Type

Instruction de test

Description

Enchaîne sur les instructions suivantes si au moins une page a été archivée lors du classement précédent
(module DBAAD ou DBAET).

Syntaxe

IF_PA DBAAD.END

ou

IF_PA DBAET.END

Exemple d’utilisation

IF_PA DBAET.END

WRITE trace.log Au moins une page a été archivée

PRINT trace.log

ENDIF

si l’archivage a permis de classer au moins une page, le message ″Au moins une page a été archivée″ est
inscrit dans ″trace.log″. Puis ″trace.log″ est imprimé.

Instruction IF_RC
Type

Instruction de test

Description

Analyse le code retour d'un exécutable

Les opérateurs acceptés sont :

= égalité

< strictement inférieur à

> strictement supérieur à

<> différent de

Les lignes de commande suivant IF_RC doivent se terminer par ENDIF

Syntaxe

33
DbBatchCold. Version 6.9

IF_RC opérateur valeur

Exemple d’utilisation

IF_RC = 0

WRITE C:\LOG\DBBATCH.LOG OK

ENDIF

Instruction IF_WF
Type

Instruction de test

Description

L’utilisation de l’instruction IF_WF est liée à celle de la commande WAITF.

Les instructions suivant IF_WF seront exécutées si et seulement si WAITF a trouvé le fichier attendu.

Syntaxe

IF_WF <fichier>

Exemple d’utilisation

WAITF flag.txt 22:30

IF_WF

WRITE trace.log ″Fichier flag.txt trouvé″

ENDIF

Si le fichier ″flag.txt″ est présent avant 22 h 30, alors le message ″Fichier trouvé″ est inscrit dans ″trace.log″.

Instruction IFDAY
Type

Instruction de test

Description

Enchaîne sur les instructions suivantes en fonction du (ou des) jour(s) précisés.

1 correspond à dimanche, 2 à lundi, …, 7 à samedi.

Syntaxe

IFDAY 1234567

Exemple d’utilisation

IFDAY 2

WRITE trace.log ″Nous sommes lundi″

34
DbBatchCold. Version 6.9

ENDIF

IFDAY 56

WRITE trace.log ″Nous sommes jeudi ou vendredi″

ENDIF

IFNER AET

Instruction IFNER AAD


Type

Instruction de test

Description

Enchaîne sur les instructions suivantes si le classement de documents précédant n’a pas généré d’erreur.
Ces instructions doivent se terminer par la commande ENDIF.

Le classement de documents est piloté par les modules Docubase DBAAD ou DBAET.

Ces modules génèrent les informations pertinentes dans le fichier DBAAD.END (respectivement
DBAET.END)

Exemple d’utilisation

DBAAD lot.aad /USER=STORAGE /BASEID=COMPTA /END

IFNER

WRITE archive.log Archivage effectué avec succès

ENDIF

Si le module d’archivage a eu lieu sans erreur, le message ″Archivage effectué avec succès″ est écrit dans
le fichier ″archive.log″.

Instruction IFNFE
Type

Instruction de test

Description

Exécute les instructions suivantes si le fichier précisé est inexistant ou vide.

Ces instructions doivent se terminer par la commande ENDIF.

Syntaxe

IFNFE <fichier>

Exemple d’utilisation

IFNFE flag.txt

35
DbBatchCold. Version 6.9

WRITE trace.log Fichier inexistant ou fichier vide !

PRINT trace.log

ENDIF

Si le fichier ″flag.txt″ n’existe pas ou est vide, le message ″Fichier inexistant ou fichier vide !″ est inscrit dans
″trace.log″. Puis ″trace.log″ est imprimé.

Instruction IFNPA
Type

Instruction de test

Description

Enchaîne sur les instructions suivantes si aucune page n’a été archivée lors du classement précédent
(module DBAAD ou DBAET).

Syntaxe

IFNPA DBAAD.END

ou

IFNPA DBAET.END

Exemple d’utilisation

IFNPA DBAET.END

WRITE trace.log Aucune page n’a été archivée

PRINT trace.log

ENDIF

Si toutes les pages ont été rejetées lors de l’archivage (module DBAAD ou DBAET), le message ″Aucune
page n’a été archivée″ est inscrit dans ″trace.log″. Puis ″trace.log″ est imprimé.

Instruction IFNWF
Type

Instruction de test

Description

L’utilisation de l’instruction IFNWF est liée à celle de la commande WAITF.

Les instructions suivant IFNWF seront exécutées si et seulement si WAITF n’a pas trouvé le fichier attendu.

Syntaxe

IFNWF <fichier>

Exemple d’utilisation

WAITF flag.txt 22 :30

36
DbBatchCold. Version 6.9

IFNWF

WRITE trace.log ″Pas de fichier flag.txt″

ENDIF

Si à 22 h 30 le fichier ″flag.txt″ n’est toujours pas présent, alors le message ″Pas de fichier flag.txt″ est inscrit
dans ″trace.log″.

Instruction ISAV2
Type

Sauvegarde

Description

Cette commande permet de sauvegarder les fichiers d’index Docubase si ceux-ci ne sont pas corrompus.

Cette instruction ne fonctionne qu’à partir de la version 6.11 de Docubase.

Attention à la syntaxe de la commande.

Syntaxe

ISAV2 <chemin_source\nom_de_la_base> <chemin_destination\nom_de_la_base >

Exemple d’utilisation

ISAV2 D:\INDEX\COMPTA\COMPTA D:\SAVINDEX\COMPTA

Instruction NOERR
Type

Réinitialisation du flag d’archivage

Description

Permet de forcer le résultat du module d’archivage de façon à ce qu’aucune erreur n’ait été détectée.

Ainsi les commandes PURGE et RMDOC peuvent être exécutées.

Exemple d’utilisation

DBAAD liste.aad /USER=STORAGE /BASEID=COMPTA /END

NOERR

RMDOC liste.aad

PURGE liste.aad

Cette suite d’instructions permet de supprimer les documents référencés dans le fichier ″liste.aad″, et le
fichier lui-même, quel que soit le résultat de l’archivage.

37
DbBatchCold. Version 6.9

Instruction PAUSE
Type

Temporisation

Description

Permet de suspendre l’exécution du script pendant n minutes.

Syntaxe

PAUSE <nombre>

Exemple d’utilisation

PAUSE 10

Suspend l’exécution du script pendant 10 minutes.

Instruction PCALL
Type

Appel externe

Description

Exécution d’un programme externe.

Cette commande peut s’utiliser avec l’option CAPTION : dans ce cas, on attendra la fin de l’exécution du
programme externe avant de poursuivre sur les instructions suivantes.

Lorsque l’option CAPTION est présente, le script vérifie si le programme externe est déjà lancé afin de ne
pas le relancer une seconde fois.

L’option CAPTION doit mentionner le titre précis de la fenêtre d’exécution du programme externe.

Syntaxe

PCALL <ligne_de_commande>

PCALL <ligne_de_commande>, CAPTION=<titre de la fenêtre>

Exemple d’utilisation

PCALL cmd.exe /c dir /s >liste.txt,CAPTION=C:\WINNT\cmd.exe

Instruction PRINT
Type

Impression de fichier

Description

Pour imprimer un fichier.

L’impression se fait vers l’imprimante par défaut.

38
DbBatchCold. Version 6.9

Un entête avec date et heure devance le contenu du fichier.

Exemple d’utilisation

PRINT trace.log

Instruction PURGE
Type

Suppression de fichier

Description

Pour supprimer un fichier, à condition que la dernière session d’archivage n’ait pas générée d’erreur.

Syntaxe

PURGE <fichier>

Exemple d’utilisation

DBAET spool.lst /FRM=format.frm /USER=STORAGE /BASEID=COMPTA /END

PURGE spool.lst

La suppression du fichier ″spool.lst″ n’aura lieu que si l’archivage s’est effectué sans erreur.

Instruction SPKEY
Type

Envoi d’une séquence de caractères

Description

Pour envoyer une séquence de clés à un programme externe.

Ce programme est identifié par l’option CAPTION, qui doit mentionner le titre précis de sa fenêtre
d’exécution.

Pour spécifier un caractère de contrôle, utiliser la syntaxe suivante :

Alt %

Si elle doit être maintenue enfoncée pendant que


d’autres touches sont saisies, mettre les autres
touches entre parenthèses

Attn {Break}

Retour arrière / Backspace {BACKSPACE} ou {BKSP} ou {BS}

Verr maj / Capslock {CAPSLOCK}

Clearscreen {CLEAR}

39
DbBatchCold. Version 6.9

Ctrl ^

Si elle doit être maintenue enfoncée pendant que


d’autres touches sont saisies, mettre les autres
touches entre parenthèses

Suppr / Delete {DELETE} ou {DEL}

End / Fin {END}

Entrée / Enter {ENTER}

Echap / Escape {ESCAPE} ou {ESC}

Début / Home {HOME}

Flèche basse / Down {DOWN}

Flèche droite / Right {RIGHT}

Flèche gauche / Left {LEFT}

Flèche haute / Up {PGUP}

F1 {F1}

F2 {F2}

F16 {F16}

Impr écran / Printscreen {PRTSC}

Inser {INSERT}

Maj +

Si elle doit être maintenue enfoncée pendant que


d’autres touches sont saisies, mettre les autres
touches entre parenthèses

Verr num / Numlock {NUMLOCK}

Page précédente {PGUP}

Page suivante {PGDN}

Tab {TAB}

+ (+)

^ (^)

% (%)

~ (~)

[ {[}

] {]}

40
DbBatchCold. Version 6.9

{ {{}

} {}}

Syntaxe

SPKEY <séquence de touches>,CAPTION=<titre de la fenêtre>

Exemple d’utilisation

SPKEY %{F4}, CAPTION=DBADMIN

Envoi de la séquence ″Alt F4″ à la fenêtre dont le titre est ″DBADMIN″.

Instruction RMDOC
Type

Suppression de documents à partir d’un fichier AAD

Description

Si la procédure de classement s’est bien terminée, la commande RMDOC permet de supprimer tous les
documents référencés dans le fichier AAD.

Syntaxe

RMDOC <fichier_AAD>

Exemple d’utilisation

DBAAD liste.aad /USER=STORAGE /BASEID=COMPTA /END

RMDOC liste.aad

PURGE liste.aad

Si l’archivage des documents s’est effectué avec succès, les documents en entrée sont supprimés, puis le
fichier ″liste.aad″ est détruit.

Instruction TCOPY
Type

Copie de fichier

Description

Copie le fichier source dans le fichier destination si et seulement si celui-ci n’existe pas déjà.

Syntaxe

TCOPY <fichier_source> <fichier_destination>

Exemple d’utilisation

TCOPY input.lst output.lst

41
DbBatchCold. Version 6.9

Instruction WAITF
Type

Arrêt de l’exécution

Description

Permet de suspendre l’exécution du script en attendant la présence d’un fichier.

Syntaxe

WAITF <fichier>

WAITF <fichier> @<minutes>

WAITF <fichier> <heure>:<minutes>

Le nom peut contenir des caractères de type joker ( ? ou *).

- sans paramètre, l’exécution est suspendue tant que le fichier n’apparaît pas, sans condition de temps.

- avec le paramètre @minutes, l’exécution est suspendue pendant au maximum le nombre de minutes
indiqué. Au-delà de ce temps, l’exécution reprend même si le fichier attendu n’existe pas.

- avec le paramètre heure:minutes, l’exécution est suspendue jusqu’à l’heure indiquée. Au-delà de cet
horaire, l’exécution reprend même si le fichier attendu n’existe pas.

Exemples d’utilisation

WAITF C:\SPOOLS\FIN.TXT

WAITF D:\SPOOLS\REPORT.LST @30

WAITF C:\SPOOLS\ *.LST 04 :30

Instruction WRITE
Type

Ecriture dans un fichier

Description

Ecriture d’une chaîne de caractères à la fin du fichier spécifié.

Si le fichier n’existe pas, celui-ci est créé.

La date et l’heure sont inscrites avant le message.

Syntaxe

WRITE <fichier> <message>

Exemple d’utilisation

WRITE trace.log Début du traitement

42
DbBatchCold. Version 6.9

Instruction WTIME
Type

Planification de l’exécution

Description

Suspend l’exécution du script jusqu’à l’heure indiquée.

Syntaxe

WTIME hh:mm

Exemple d’utilisation

WTIME 06:30

on attend 6 h 30 pour poursuivre l’exécution.

5.4 Exemple de modèle de scripts

99:99

CHDIR C:\docubase\client

DIR_C E:\Spools\tmp\%UNIQUE%

DBAET %% /FRM=\\nom_serveur\FRM\%FRM% /BASEID=%BASE% /WORKDIR= E:\Spools\%UNIQUE%


/SRVDOMAIN=0 /USER=ADMIN /PASS=ADMIN /PACK=ZLIB /TRACE=Y
/LOGCSV=E:\dbbatchcold\dbbatchcold.csv /END

IF_ER AET

WRITE " E:\spools\Logs\Results.txt" %% --->> PAS BIEN ! <<---

ENDIF

IFNER AET

WRITE " E:\spools\Logs\Results.txt" %% --->> BIEN ... ! <<---

ENDIF

ERASE %%

DIR_D E:\Spools\tmp\%UNIQUE%

43
DbBatchCold. Version 6.9

Le module DOCUBASE AUTOMATE DE TRAITEMENT COLD est prêt, il vous reste à lancer le service.

44
DbBatchCold. Version 6.9

6. L’INTERFACE DU PLANIFICATEUR DE TACHES DBBATCH

Le module DBBATCH peut être utilisé seul et indépendamment du service DBBATCHCOLD.

En cas d’anomalie issu des traitements de DBBATCHCOLD, il sera intéressant de pouvoir tester le script
personnalisé via l’interface DBBATCH par une exécution pas à pas du script afin de localiser d’éventuelles
erreurs par exemple.

Le module DBBATCH peut être lancer de plusieurs manières.

6.1 En ligne de commande

Syntaxe

[Path DBBATCH] [Path script]

Exemple d’utilisation

C:\DOCUBASE\CLIENT\OUTILS\DBBATCH.EXE AUTOMATE.INI

Si le le path du script est le même que celui de DBBATCH il est inutile de le déclaré dans la ligne de
commande.

6.2 En raccourci bureau

Créer un raccourci sur le bureau, puis accéder aux propriétés par un clique droit sur l’icône ainsi
créée.

Figure 4: Le raccourci sur le bureau

45
DbBatchCold. Version 6.9

Dans la cellule Cible : saisir le path et le nom du script a utiliser.

6.3 En mode interface

Pour lancer l’interface par le raccourci ou via l’arborescence d’installation

Dès son apparition, nous pouvons lancer les scripts de traitements de plusieurs manières.

Par saisi direct, importation (copier, collé) ou ouverture d’un fichier existant (Ctrl+O).

6.4 Description de l’interface

Figure 5: Description de l'interface

6.4.1 La barre de menu

Elle se situe en partie 1

46
DbBatchCold. Version 6.9

Cette dernière est amovible et peut être entièrement personnalisable.

Voir menu Options un peu plus bas dans ce chapitre.

Menu Fichier

Menu pour créer, ouvrir, enregistrer, imprimer, régler les impressions ou quitter le module DBBATCH.

Remarques : Dans ce menu, les quatre derniers scripts utiliser seront listés afin de les ouvrir plus
rapidement.

Menu Edition

Menu permettant d’annuler la dernière action, couper, copier, coller, tous sélectionner ainsi qu’une
recherche ou un éventuel remplacement de caractères présent dans le script.

Menu Exécuter

47
DbBatchCold. Version 6.9

Menu pour choisir un mode de lecture du script.

Lecture depuis le début, lecture pas à pas, retour au début du script et arrêt.

Attention, après un arrêt par Stop, le script ne restera pas sur la position précédente mais retourne en début
de script.

Menu Option

Ce menu permet de régler et de personnaliser le module DBBATCH.

L’interface peut être réglée pour un démarrage en mode plein écran, en icône ou en taille standard
Microsoft.

Il est également possible d’indiquer le répertoire de localisation du fichier journal DBBATCH.LOG.

En activant le bouton Nous avons accès aux paramètres des polices systèmes afin de personnaliser
les scripts pour un meilleur confort en visualisation.

48
DbBatchCold. Version 6.9

Dans le menu Options , Personnalisé… tous les menus et barres d’outils pourront être personnalisés.

Menu ?

Ce menu permet d’informer l’utilisateur sur la version du module ainsi qu’un accès de l’aide en ligne.

Remarques : L’aide en ligne n’est pas encore disponible.

49
DbBatchCold. Version 6.9

6.4.2 La barre d’icônes

Elle se situe dans la partie 2 de la figure 5

a Nouveau fichier

b Ouvrir fichier

c Enregistrer

d Couper sélection

e Copier sélection

f Coller sélection

g Imprimer

h Options

i Aide

j A propos

k Exécuter le script

l Exécuter le script pas à pas

m Revenir au début du script

n Arrêter l’exécution du script

a Nouveau fichier

Figure 6: Les icônes

6.4.3 Zone d’affichage du script

Elle se situe dans la partie 3 de la figure 5

50
DbBatchCold. Version 6.9

Cette fenêtre est aussi une zone de saisie. Le script peut être créé avec la possibilité de tester l’exécution
pour chaque ligne de saisie.

6.4.4 Zone d’affichage du journal

Elle se situe dans la partie 4 de la figure 5

L’affichage est sous forme de tableau contenant les champs :

Dates des traitements

Heures des traitements

No de ligne incrémenter

Messages

Remarque : Pour chaque traitement, cette zone est contenu dans le fichier journal DBBATCH.LOG voir
Partie1 menu Option.

51
DbBatchCold. Version 6.9

Attention, ne pas confondre avec le fichier journal au format CSV de


DBBATCHCOLD. Ce sont deux fichiers bien distincts.

6.4.5 Zone d’information sur le script en cours de traitement

Elle se situe dans la partie 5 de la figure 5. Elle nous informe sur le nom du script en cours de traitement

Permet d’un seul coup d’œil de vérifier l’identité du fichier script affiché dans la zone script (voir Partie 3)

6.4.6 Zone d’information sur la ligne en cours de traitement

Elle se situe dans la partie 6 de la figure 5. Elle nous informe sur le numéroo de la ligne en cours de
lecture

52
DbBatchCold. Version 6.9

7. TABLE D’ILLUSTRATIONS

Figure 1: Les fichiers nécessaires au fonctionnement du module .................................................................... 6

Figure 2: La base de registre............................................................................................................................. 8

Figure 3: Exemple de fichier CSV ................................................................................................................... 11

Figure 4: Le raccourci sur le bureau................................................................................................................ 45

Figure 5: Description de l'interface .................................................................................................................. 46

Figure 6: Les icones ........................................................................................................................................ 50

53
DbBatchCold. Version 6.9

8. GLOSSAIRE

Affaire (DBP) Une affaire est l’élément de base traitée dans DBP. Une
affaire suit un cycle de vie dans DBP selon une procédure.
Elle subit successivement des traitements effectués par des
utilisateurs autorisés, dans des temps définis.

Administrateur L'administrateur est un utilisateur de Docubase Content


Management, qui possède au moins un droit
d'administration.

Administration Le module d'administration offre la possibilité de gérer les


utilisateurs et leurs droits d'accès aux différents modules de
RhéaWeb et les droits des utilisateurs sur les documents
contenus dans les bases documentaires. Cette gestion des
droits, se réalise à travers la gestion des groupes et des
rôles.

Le module d'administration permet également la création


des bases documentaires, des outils (convertisseurs) et
paramètres (fond de page) qui leurs sont associés. Il offre
la possibilité de définir des formulaires (recherche et
indexation) pointant sur les bases documentaires et
regroupés en activités attachées aux utilisateurs à travers
les groupes.

Base Une base rassemble un groupe de données ayant des


caractéristiques communes, interrogeables via les
catégories du formulaire de recherche.

Briefcase Encore appelé porte documents, Le briefcase peut être


considéré comme un espace de travail temporaire où des
documents qui sont utilisés fréquemment par l’utilisateur,
sont stockés.

Catégorie Une catégorie est un champ décrivant l'une des


caractéristiques d'un document

Corbeille Une corbeille est une requête permettant de filtrer les


affaires.

Dictionnaire Le dictionnaire regroupe toutes les valeurs possibles d'une


catégorie.

DASD DASD : Gestion du stockage de documents à durée de vie limitée


Direct s‘apparentant à une arborescence dans l’explorateur.
Access
Storage
Device
Domaine Fonctionner en client serveur implique que l’on peut
dialoguer avec différents serveurs. Cette communication
s’effectue dans les deux sens pour les besoins des
requêtes ou du stockage. A chaque serveur sont liés un
ensemble de bases. C’est cet ensemble serveur bases et
ses dépendances qui constitue un domaine.

DN Distinguish Adresse d’un nom dans le LDAP. Chaque entrée est

54
DbBatchCold. Version 6.9

Name référencée de manière unique dans le DIT (Directory


Information Tree ) par son distinguished name (DN). Le DN
représente le nom de l'entrée sous la forme du chemin
d'accès à celle-ci depuis le sommet de l'arbre. On peut
comparer le DN au path d'un fichier Unix. Par exemple,
mon DN correspondant à l'arbre ci-contre est :
Tableau 1: Structure du LDAP uid=,ou=rôle,dc=cegedim,dc=fr

Fond de page Fichier de paramétrage de la visualisation du document.

Formulaire d'indexation Un formulaire d'indexation est associé à chaque document.


Ce formulaire est rempli préalablement au classement du
document. Il regroupe les critères déterminants du
document.

Formulaire de recherche Le formulaire de recherche est utilisé pour saisir les critères
de sélection des documents.

FrameWork Ensemble de services à l’origine du fonctionnement du


moteur de DIS

LDAP Lightweight LDAP est le protocole d'annuaire sur TCP/IP. Initialement


Directory frontal d'accès à des annuaires X500, LDAP est devenu en
Access 1995, un annuaire natif . Les annuaires électroniques sont
Protocol un type de base de données spécialisées permettant de
stocker des informations de manière hiérarchique et offrant
des mécanismes simples pour rechercher l'information, la
trier, l'organiser selon un nombre limité de critères.

Multilogon Autorisation de l’utilisation d’un même profil pour accéder à


Docubase de deux postes différents

Procédure Une procédure est un ensemble d’actions à effectuer pour


un type d’affaire

Recherche L'action de recherche de documents consiste à interroger la


base documentaire, afin d'obtenir une liste de documents
répondant aux critères saisis dans le formulaire de
recherche.(DCM)

La recherche dans DBP s’effectue sur des affaires.

Requête Une requête est un ensemble de critères de recherche


visant à sélectionner des documents.

Rôle Le rôle est un profil type ou un modèle de profil. Il permet


d'attribuer à un ensemble d'utilisateurs, un ensemble de
droits communs d'utilisation de l'application Docubase
Content Management

Service On peut définir par service la présentation des colonnes


affichées dans la liste des affaires présentes dans une
corbeille DBP

Statut Les statuts sont des codifications pour attribuer aux affaires
un qualificatif relatif à leur état. Typiquement lorsque une
action a été effectuée concernant une affaire, cette action a
eu pour conséquence de faire passer l’affaire d’un statut n-
1 à un statut n

55
DbBatchCold. Version 6.9

Statuts personnalisés Les statuts personnalisés sont des statuts destinés à


qualifier les affaires, par une action de l'utilisateur, ces
statuts ne sont pas attribués aux affaires de manière
automatique.

Type action A considérer comme une action

Type d’affaire Un type d’affaire est un ensemble auquel peuvent être


rattachés des affaires parce qu’elles ont trait à un même
secteur d’activité de l’entreprise. Exemple pour une société
d’assurances, secteur public, secteur privé, personnes
physiques etc…

Type de pièces Tout comme les affaires, les pièces peuvent faire partie de
grands groupes de pièces Exemple le type Pièces
comptables auquel seront rattachés Grands livres, bilans
etc…

Workflow Module de gestion de circulation des documents.

WORM Write Once Gestion de documents à durée de vie longue


Read Many
Thread Ces « processus légers », également appelés « fils
d'exécution », sont similaires aux processus en cela qu'ils
représentent tous deux l'exécution d'un ensemble
d'instructions du langage machine d'un processeur. Du
point de vue de l'utilisateur ces exécutions semblent se
dérouler en parallèle. Toutefois là où chaque processus
possède sa propre mémoire virtuelle, les processus légers
appartenant au même processus père partagent une même
partie de sa mémoire virtuelle.

TCP/IP TCP/IP est une suite de protocoles. Le sigle TCP/IP signifie


Adresse IP «Transmission Control Protocol / Internet Protocol».

TCP/IP représente d'une certaine façon l'ensemble des


règles de communication sur internet et se base sur la
notion adressage IP, c'est-à-dire le fait de fournir une
adresse IP à chaque machine du réseau afin de pouvoir
acheminer des paquets de données.

Port De nombreux programmes TCP/IP peuvent être exécutés


simultanément sur Internet Chacun de ces programmes
travaille avec un protocole, toutefois l'ordinateur doit
pouvoir distinguer les différentes sources de données.

Ainsi, pour faciliter ce processus, chacune de ces


applications se voit attribuer une adresse unique sur la
machine, codée sur 16 bits: un port

Socket Combinaison adresse IP + port, une adresse unique au


monde.

HTML Hypertext Le HTML (« HyperText Mark-Up Language ») est un


Markup langage dit de « marquage » (de « structuration » ou de
Language « balisage ») dont le rôle est de formaliser l'écriture d'un
document avec des balises de formatage. Les balises
permettent d'indiquer la façon dont doit être présenté le
document et les liens qu'il établit avec d'autres documents.

URL Uniform Une URL est un format de nommage universel pour

56
DbBatchCold. Version 6.9

Resource désigner une ressource sur Internet. Il s'agit d'une chaîne


Locator de caractères ASCII imprimables qui se décompose en cinq
parties:

 Le nom du protocole : c'est-à-dire en quelque


sorte le langage utilisé pour communiquer
sur le réseau. Le protocole le plus largement
utilisé est le protocole HTTP, le protocole
permettant d'échanger des pages Web au
format HTML. De nombreux autres
protocoles sont toutefois utilisables (FTP,
News,Mailto, Gopher,...)

 Identifiant et mot de passe : permet de


spécifier les paramètres d'accès à un serveur
sécurisé. Cette option est déconseillée car le
mot de passe est visible dans l'URL

 Le nom du serveur : Il s'agit d'un nom de


domaine de l'ordinateur hébergeant la
ressource demandée. Notez qu'il est possible
d'utiliser l'adresse IP du serveur, ce qui rend
par contre l'URL moins lisible.

 Le numéro de port : il s'agit d'un numéro


associé à un service permettant au serveur
de savoir quel type de ressource est
demandée. Le port associé par défaut au
protocole est le port numéro 80. Ainsi,
lorsque le service Web du serveur est
associé au numéro de port 80, le numéro de
port est facultatif

 Le chemin d'accès à la ressource : Cette


dernière partie permet au serveur de
connaître l'emplacement auquel la ressource
est située, c'est-à-dire de manière générale
l'emplacement (répertoire) et le nom du
fichier demandé.

Xlat.cod Table de conversion des caractères ASCII utilisée par DE


pour homogénéiser les formats de stockage des caractères
extraits des spools ou saisis pour constituer des index.
Ainsi quelque soit la façon dont les mots sont libellés, ils
seront convertis en majuscule non accentuée, tout signe de
ponctuation sera supprimé etc…L’objectif recherché est de
pouvoir retrouver tous les documents indexés avec un mot
générique : Exemple : Ainsi que vous saisissiez l’index
Francaise ou française ou Francaise correspondant à la
catégorie « Nationalité » tous ces termes pointeront vers la
forme générique équivalente « FRANCAISE » et aucun
document indexé phonétiquement avec ce terme ne sera
oublié lors de la requête.

XML XML (entendez eXtensible Markup Language et traduisez


Langage à balises étendu, ou Langage à balises
extensible) est en quelque sorte un langage HTML amélioré
permettant de définir de nouvelles balises. Il s'agit
effectivement d'un langage permettant de mettre en forme

57
DbBatchCold. Version 6.9

des documents grâce à des balises (markup).

Contrairement à HTML, qui est à considérer comme un


langage défini et figé (avec un nombre de balises limité),
XML peut être considéré comme un métalangage
permettant de définir d'autres langages, c'est-à-dire définir
de nouvelles balises permettant de décrire la présentation
d'un texte (Qui n'a jamais désiré une balise qui n'existait
pas ?).
La force de XML réside dans sa capacité à pouvoir décrire
n'importe quel domaine de données grâce à son
extensibilité. Il va permettre de structurer, poser le
vocabulaire et la syntaxe des données qu'il va contenir.

DE Docubase Entreprise Ancienne gamme de produits fonctionnant principalement


en mode client /serveur lourd
DIS Docubase Information Suite Nouvelle gamme de produits listés ci-dessous faisant suite
à Docubase Entreprise et fonctionnant en client léger
DIC Docubase Vega for Image Capture et traitement de documents numérisés
DEC Docubase Thetis for Email Capture et traitement de messages électroniques
DOC Docubase Thetis for Office Capture et traitement de documents MSOffice
DRC Docubase Titan for Report Capture et traitement d’états informatiques
DC Docubase Calypso for Invoice, for Capture et traitement de documents semi structurés
Bank statement
DFP Docubase Calypso for Forms Capture et traitement de documents structurés
(formulaires)
DCM Docubase Rhea for Content Gestion de Dossiers
Management
DBP Docubase Telesto for Business Gestion de Corbeilles électroniques
Processing
DF Docubase Framework
DDT Docubase Development Tools for APIs de développement
C/C++ Development Tools for Java

58
DbBatchCold. Version 6.9

9. CONTACTS

Nous restons à votre disposition pour toutes informations

Agence Sud-est Siège Social


Immeuble «Le Discover» 137 rue d’Aguesseau

84 boulevard Vivier Merle 92641 Boulogne-Billancourt Cedex

69485 LYON CEDEX 03 Téléphone : 01.49.09.22.85

Téléphone : 04 26 84 16 40 Télécopie : 01.49.09.28.53

Télécopie : 04 26 84 16 41

lyon@docubase-systems.fr sales@docubase-systems.fr

DOCUBASE SYSTEMS - Groupe CEGEDIM www.docubase.com

59

Vous aimerez peut-être aussi