BatchCommandExecutionFr

From LLL

Exécution de commandes par lots[edit]

Le point Exécution de commandes par lot permet de uploader à partir de votre ordinateur client un fichier de commandes (et un fichier de mot de passes) sur le serveur LLL, et d'exécuter faire ce fichier de commandes "en batch". Ceci est surtout utile en début d'année scolaire, quand il faut créer des dizaines d'utilisateurs d'un coup. Dans ce cas, le fichier de commande pourrait par exemple être générée automatiquement à partir de la base de données du secrétariat. Deux variantes sont disponibles:

Ancienne variante (format fixe)[edit]

Cette variante est invoquée en utilisant le formulaire du haut de la page.

Le format d'une ligne du fichier de commandes est le suivant:

login:ordre:catégorie:Nom, Prénom:[catégorie date classe]:Alias Mail

Format d'une ligne du fichier de mot de passe: login:password

La signification des ordres est la suivante:

N création d'un nouvel utilisateur
D suppression d'un utilisateur
H suspension (on Hold) temporaire d'un utilisateur
A réactivation d'un utilisateur suspendu.
M changement de classe, nom, prénom ou alias d'un utilisateur

Les autres paramètres sont décrits dans le chapitre sur la création d'utilisateurs. Pour la catégorie, utiliser son code de 3 lettres.

Nouvelle variante (format libre)[edit]

Cette variante est invoquée en utilisant le formulaire du bas de la page.

Avant d'utiliser cette variante pour la première fois, il faut d'abord définir le format en choisissant Nouveau dans le sélecteur Format de fichier, puis en cliquant sur le bouton Éditer définition de format.


On arrive alors sur un masque qui sert à définir le format. Le masque comporte les champs suivants:

Opération à faire Créer/Modifier: Les utilisateur du fichier de commande sont crées (s'il n'existent pas encore) ou modifiés (s'ils existent déjà)%%% Détruite: Les utilisateurs du fichier de commande sont détruits%%% Changer de définition: Les utilisateurs sont modifiés
Nom du format Nom permettant de désigner ce format (le système permet de gérer plusieurs formats, afin de permettre par exemple de stocker les définition d'enseignants sous un autre format que les définitions d'étudiants)
Format d'une ligne de fichier Cette ligne définit le format. Elle comporte une ligne type telle qu'elle apparaît dans le fichier de commandes. À la place des données figurent des séquences %code qui désignent la nature de cette donnée (voir tableau code champs, répété en bas de la page même)
Catégorie Catégorie de l'utilisateur. Si ce champ est laissé vide, la valeur fournie par le code %t est prise.
Parrain Utilisateur qui est marqué responsable de la création (ou classe). Si ce champs est laissé vide, soit la valeur fournie par le code %c est prise (élèves), soit le nom de l'utilisateur qui va faire l'exécution de commandes par lots (non élèves).


Voici la signification des codes % de la ligne Format d'une ligne de fichier:

%% Le signe pour-cent
%l Nom de login (optionnel)
%o Opération
%t Type (élève, enseignant, etc.)
%p Prénom
%n Nom
%c Classe/Parrain
%a Alias mail (optionnel)
%P Mot de passe (optionnel)
%d Date
%s Numéro de sécurité social (optionnel)
%i Ignore


Le format est maintenant prêt à l'utilisation.

Pour l'utilisation, les champs suivants sont disponibles:

Fichier de définitions des utilisateurs Fichier de définition des utilisateurs, sous le format défini précédemment
Fichier contenant les mots de passe Celui-ci est optionnel. S'il est fournit, il doit être sous le format login:motdepasse. S'il n'est pas fourni, le système va prendre le mot de passe soit dans le champ %p du fichier principal (si définit), soit en choisir un au hasard (pour les nouveaux utilisateurs)
Liste d'utilisateurs existants qui doivent recevoir un nouveau mot de passe Normalement, le système n'attribue pas de nouveau mot de passe aux utilisateurs existants qui changent simplement de classe. Cette option permet de forcer l'attribution de nouveau mot de passe même à des utilisateurs existants.
Essai Si cette case est cochée, le fichier est seulement analysé pour sa correction syntaxique. Aucune opération n'est exécutée. Ceci permet de valider le fichier avant de procéder.
Format de fichier Nom de la définition de format à utiliser
Éditer définition de format Éditer la définition de format (ou en créer une nouvelle)
Envoi Démarrer l'exécution de commandes par lots (après avoir renseigné les autres champs nécessaires