Table des matières | DéfinitionsSATO 4.4, Manuel de référence (dernière modification de ce chapitre en avril 2011)
Scénario  
Le SCÉNARIO est un fichier de commandes SATO. Le scénario prend la forme d'un fichier en format texte portant le suffixe «.csa». Le plus souvent, on rédige ces scénarios en y copiant des commandes consignées dans le journal à la suite d'une expérimentation sur le corpus.
Exploration :
AFFICHER
EXPORTER
Exploitation :
APPLIQUER
Gestion :
DÉFINIR
ÉDITER
SUPPRIMER
Configuration :
CARACTÉRISER { DÉFILEMENT | EXPORTATION | JOURNALISATION }

Scénarios à exécution automatique

Afficher
Syntaxe :
SCÉNARIO AFFICHER fichier

AFFICHER affiche à l'écran le contenu du scénario.

Le paramètre fichier est le nom du fichier qui contient le scénario. Le fichier porte le suffixe «.csa» pour «commandes SATO».


Appliquer
Syntaxe :
SCÉNARIO APPLIQUER fichier

APPLIQUER permet de faire exécuter un scénario.

Le paramètre fichier est le nom du fichier qui contient le scénario. Le fichier porte le suffixe «.csa» pour «commandes SATO».


Définir

DÉFINIR permet de créer un fichier scénario.

Syntaxe :
SCÉNARIO DÉFINIR fichier

Le paramètre fichier est le nom du fichier qui contient le scénario. Le fichier porte le suffixe «.csa» pour «commandes SATO». Un nom de fichier devrait être composé de lettres minuscules sans accents, de chiffres et des caractères «-» et «_». Il ne doit pas contenir d'espaces et ne doit pas débuter par «-».

Chaque commande dans un fichier scénario se termine par une fin de ligne (touche Retour ou Entrée sur le clavier). Un double astérisque «**» en fin de ligne indique que la commande n'est pas terminée et se poursuit sur la ligne suivante.

Il est possible d'inscrire des commentaires dans un scénario. Ces commentaires n'ont d'autres fins que de documenter le fichier de commandes. Ces commentaires sont introduits par un astérisque «*» en colonne 1 suivi d'un espace et du texte du commentaire.


Éditer

ÉDITER permet d'éditer un scénario afin de lui apporter des modifications.

Syntaxe :
SCÉNARIO ÉDITER fichier

Le paramètre fichier est le nom du fichier qui contient le scénario. Le fichier porte le suffixe «.csa» pour «commandes SATO».

Chaque commande dans un fichier scénario se termine par une fin de ligne (touche Retour ou Entrée sur le clavier). Un double astérisque «**» en fin de ligne indique que la commande n'est pas terminée et se poursuit sur la ligne suivante.

Il est possible d'inscrire des commentaires dans un scénario. Ces commentaires n'ont d'autres fins que de documenter le fichier de commandes. Ces commentaires sont introduits par un astérisque «*» en colonne 1 suivi d'un espace et du texte du commentaire.


Supprimer

SUPPRIMER permet de supprimer un ou plusieurs fichiers scénarios.

Syntaxe :
SCÉNARIO ÉDITER liste-de-fichiers

Le paramètre liste-de-fichiers contient la liste des noms de fichiers à supprimer. Ces fichiers portent le suffixe «.csa» pour «commandes SATO».


Exporter
Syntaxe :
SCÉNARIO EXPORTER fichier

EXPORTER dépose dans le fichier d'exportation le contenu du scénario.

Le paramètre fichier est le nom du fichier qui contient le scénario. Le fichier porte le suffixe «.csa» pour «commandes SATO».


Caractériser

CARACTÉRISER permet de modifier certains paramètres de fonctionnement des scénarios. DÉFILEMENT, EXPORTATION et JOURNALISATION.


Caractériser Défilement
Syntaxe :
SCÉNARIO CARACTÉRISER DÉFILEMENT {?|?? variable|= EXPERT|= NORMAL= PARTIEL}

Le paramètre DÉFILEMENT sert à préciser le mode de défilement des scénarios à l'écran. Trois valeurs sont possibles pour ce paramètre : EXPERT, NORMAL et PARTIEL.

- EXPERT : il n'y aura pas d'affichage des commandes du scénario. Cet attribut présume que l'objectif du scénario est de réaliser une tâche dont les résultats seront exploités par la suite. C'est là la valeur implicite du paramètre DÉFILEMENT.

- NORMAL : l'affichage des commandes du scénario se fera en mode normal avec contrôle d'écran lorsque la page est remplie.

- PARTIEL : l'affichage des résultats du scénario ne sera actif que pour les commandes dont l'affichage est l'aspect principal.

On modifie généralement le paramètre DÉFILEMENT avant d'appeler le scénario pour en conditionner le fonctionnement.

L'opérateur ? provoque l'affichage de la valeur du paramètre sélectionné. L'opérateur ?? indique que le contenu du paramètre sera copié dans une variable pour une utilisation future. Le paramètre variable contient le numéro de la variable.


Caractériser Exportation
Syntaxe :
SCÉNARIO CARACTÉRISER EXPORTATION {?|?? variable|= OUI|= NON}

Le paramètre EXPORTATION, suivi de l'alternative = OUI ou = NON, permet de déterminer si les résultats des commandes exécutées par un scénario doivent ou non être inscrits dans le fichier d'exportation. La valeur de départ du paramètre est NON).

L'opérateur ? provoque l'affichage de la valeur du paramètre sélectionné. L'opérateur ?? indique que le contenu du paramètre sera copié dans une variable pour une utilisation future. Le paramètre variable contient le numéro de la variable.


Caractériser Journalisation
Syntaxe :
SCÉNARIO CARACTÉRISER JOURNALISATION {?|?? variable|= OUI|= NON}

Toutes les commandes fournies à SATO en mode interactif sont automatiquement inscrites dans le journal. Cependant, les commandes faisant partie d'un scénario ne sont pas automatiquement inscrites dans le journal. Le paramètre JOURNALISATION suivi de l'alternative = NON ou = OUI permet de maintenir ce choix (NON) ou de forcer la journalisation des commandes exécutées à partir d'un scénario (OUI).

L'opérateur ? provoque l'affichage de la valeur du paramètre sélectionné. L'opérateur ?? indique que le contenu du paramètre sera copié dans une variable pour une utilisation future. Le paramètre variable contient le numéro de la variable.


Scénarios à exécution automatique

S'il existe, dans le répertoire de l'usager, un scénario de commandes SATO dont le nom est «satoini.csa», ce fichier sera exécuté au démarrage du programme SATO. Cela permet de faire exécuter automatiquement des commandes permettant de configurer une session de travail avec SATO. De même s'il existe un scénario portant le même nom que le fichier corpus, mais avec le suffixe «.csa», ce fichier sera exécuté automatiquement après le chargement du corpus dans SATO.