Salut,
Je viens de me rendre compte que j'ai fait une bêtise : vous envoyer
individuellement des fichiers PDF lourds sans savoir si vous aviez tous
l'ADSL. Je m'excuse.
Version 0.1 doc uutilisateur basé sur premier jet de Jean-Claude pour
vos commentaires, ajouts et corrections.
------ clgestion_doc-0.1.txt --------------
clGestion
Équipe clGestion
DATE
Abstract
Documentation utilisateur du logiciel libre clGestion :
gestion des Comités locaux d'ATTAC, version 0.1
Table des Matières
1 Première partie
1.1 Objectif et public visé
1.2 Description de clGestion
1.3 Téléchargement de clGestion
1.4 OpenOffice.org
1.4.1 Liens directs sur OpenOffice.org (liste limitée)
1.4.1.1 Téléchargement application
1.4.1.2 Téléchargement documentations
1.4.1.3 Études et retour d'expérience
1.4.1.4 Livres, etc.....
1.4.2 Pourquoi OpenOffice.org à ATTAC
2 Deuxième partie
2.1 Installation de clGestion
2.1.1 Retour sur le fonctionnement d'ATTAC
2.1.2 Répertoire de travail
2.1.3 Création du fichier de gestion
2.2 Utilisation de clGestion
2.2.1 Sélection de groupe
2.2.2 Fichier adhérents
1 Première partie
1.1 Objectif et public visé
Cette documentation est destinée aux utilisateurs de clGestion.
Il existe aussi un mode d'emploi express, clgestion_doc_exp-0.1
, qui donne la marche à suivre mais sans explication.
Il est conseillé de s'abonner à la liste [EMAIL PROTECTED]
Pour les développeurs, se référer à...
Ce document existe aux formats .sxw, .pdf et .html. Le
premier format est celui du traitement de texte
d'OpenOffice, oowriter. En ouvrant ce fichier dans
OpenOffice, l'utilisateur accède directement à des
boutons de commande pas-à-pas de clGestion. La version
PDF convient très bien à une impression sur papier
tandis que la version HTML est pratique à consulter en
ligne ou en local dans le navigateur de son choix.
1.2 Description de clGestion
Le classeur clgestion.sxc contient les macros
développées pour faciliter la gestion de comités locaux
avec le tableur d'OpenOffice. Ce classeur ne fonctionne
pas avec d'autres logiciels tableurs. Il se présente
d'abord à l'utilisateur sous la forme d'une page de
garde, feuille À-propos, avec le logo, les références
du site et des macros. En cours de développement, donc
malgré quelques fonctionnalités non encore implémentées
et d'autres pas tout à fait au point, clGestion peut,
dans sa version actuelle, 0.1, ...
À terme, clGestion permettra à tout militant d'ATTAC
qui connaît les bases de la bureautique de gérer
complètement et plus facilement un ou plusieurs comités locaux.
clGestion est un assemblage de 3 macros écrites en
BASIC et intégrée au tableur d'OpenOffice :
moduleDemarrage Cette première fonctionnalité sert à
initialiser la gestion des adhérents. Elle utilise 2
classeurs, clgestion.sxc contenant les macros, et
france.sxc, liste des communes de France.
moduleAdhesions Cette deuxième fonctionnalité sert à
traiter les fichiers transmis par le service des adhésions.
moduleCompta Cette troisième fonctionnalité n'est pas
encore réalisée et consistera en une petite gestion
comptable. En particulier, y sera gérée la
répartition financière entre les groupes d'un même
département en s'appuyant sur la gestion des adhérents.
1.3 Téléchargement de clGestion
clGestion peut être téléchargé depuis les sites :
* clgestion.gna.org/telechargement/clgestion_0.1.zip
* ...
1.4 OpenOffice.org
clGestion est un ensemble de macros OpenOffice.org. Il
nécessite donc l'installation de cette suite. Encore
peu connue en comparaison de la suite MSOffice, il est
conseillé aux débutants de prendre le temps de visiter
le site du pan francophone
[http://fr.openoffice.org||http://fr.openoffice.org]. Les plus pressés
pourront
suivre les quelques liens ci-bas vers des pages plus
ciblées sur ce produit phare du mouvement du logiciel
libre. Pour une introduction au logiciel libre, voir
l'Association francophone des utilisateurs de logiciel
libre (AFUL)[http://www.aful.org||http://www.aful.org].
En tout état de cause, il n'y a pas lieu de
s'inquiéter, un tableur reste un tableur, peu importe
qui en est l'éditeur. Ceux et celles qui connaissent
Excel n'auront aucune difficulté d'adaptation sur le
plan technique. En revanche, il est compréhensible que
certains éprouvent quelques "réticences" à changer de
suite bureautique, même si les outils et méthodes
restent à peu de choses près identiques. Les habitudes
acquises...
1.4.1 Liens directs sur OpenOffice.org (liste limitée)
Téléchargement application
[http://fr.openoffice.org/about-downloads.html||http://fr.openoffice.or
g/about-downloads.html]
Téléchargement documentations
Études et retour d'expérience
Livres, etc.....
1.4.2 Pourquoi OpenOffice.org à ATTAC
Demander une contributiuon spécifique pour ce paragraphe.
2 Deuxième partie
2.1 Installation de clGestion
2.1.1 Retour sur le fonctionnement d'ATTAC
Rappel de quelques règles de fonctionnement d'ATTAC
ayant une incidence sur l'utilisation de clGestion :
* Il peut y avoir plusieurs groupes locaux dans un département.
* Le national ne reverse qu'à un seul groupe dans un
même département, à charge pour ce dernier de
reverser la part revenant aux autres groupes du
département, proportionnellement au nombre
d'adhérents. Le versement est fait par virement à
chaque trimestre.
* Le national transmet régulièrement le fichier des
adhérents du mois, du trimestre ou de l'année.
2.1.2 Répertoire de travail
La première chose à faire est de définir le chemin du
répertoire qui sera réservé à la gestion du comité
local. Par défaut, clGestion cherchera ses documents
dans :
* c:\Mes Documents\ATTAC, sous Windows,
* /home/ATTAC, sous Linux.
clGestion ne crée pas automatiquement ce répertoire.
C'est à chaque utilisateur de le faire à l'aide de son
gestionnaire de fichiers.
Il est possible d'indiquer à clGestion qu'il devra
chercher un autre chemin par défaut. mais pour ce
faire, il faut modifier manuellement la constante
gvChemin dans l'entête du module modAdhésions à l'aide
de l'éditeur de macros d'OpenOffice. Cette opération
n'est conseillée qu'aux utilisateurs connaissants les
arcanes de l'écriture de macros. Chemins suggérés :
* c:\Documents and Settings\Mes Documents\ATTAC
* c:\ATTAC
* /home/utilisateur/ATTAC
Il suffit ensuite de télécharger ou, si c'est déjà
fait, de copier les classeurs clgestion.sxc et
france.sxc dans ce répertoire par défaut.
2.1.3 Création du fichier de gestion
Après avoir lancé OpenOffice, il faut ouvrir le fichier
clgestion.sxc et démarrer la macro moduleDemarrage, le
plus simple étant de cliquer sur l'icône drapeau,
premier bouton à gauche dans la barre d'outils du
classeur clgestion.
Si cette barre ou cet icône n'apparaît pas, la macro
peut être lancée comme suit :
* parcourir le menu : Outils -> Macros -> Macro;
* double cliquer sur ATTAC dans le tableau des modules
de macros, à gauche dans la boîte de dialogue qui
s'est ouverte;
* double cliquer sur la macro moduleDemarrage ou la
sélectionner dans la liste et cliquer sur le bouton exécuter.
Le dialogue Département s'ouvre. Saisir le code du
département dans le champ Département et valider. Cette
boîte de dialogue peut être fermée avec le menu fenêtre
de votre gestionnaire de fenêtres (le X en haut à
droite pour les utilisateurs de l'interface graphique
de Windows), ce qui provoque l'arrêt de l'exécution de
la macro moduleDemarrage.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_departement.png>
Developpeur : Une erreur de saisie, par exemple le
département 690 au lieu de 69, ne provoque pas l'arret
de la macro et produira une feuille de communes vide.
Le dialogue Comités du département remplace le
précédent. Saisir le nom de chacun des comités locaux
du département et ajouter à la liste en cliquant sur le
bouton Ajouter.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_comites_departement.png>
Il est toujours possible de supprimer un comité de la
liste en cliquant sur le bouton Supprimer.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_comites_departement_sup.
png>
Il existe aussi un menu contextuel (clic sur bouton
droit de la souris au-dessus du champ de saisie) qui
permet de coller du texte ou d'ajouter des caractères spéciaux.
Valider lorsque la liste est complète.
clGestion crée ensuite la feuille communes du
département en traitant automatiquement le classeur
france.sxc, base de données des communes de France. Ce
classeur est fermé automatiquement par clGestion
lorsqu'il n'en a plus besoin. Selon la puissance de
votre configuration matérielle, cette tâche peut
prendre plus d'une minute. Mais elle ne sera exécutée
qu'une seule fois pour l'initialisation de clGestion.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_france.png>
S'affiche enfin à l'écran le classeur comité_local.sxc
comprenant deux feuilles : groupes et communes.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_groupes.png>
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_communes.png>
La phase d'installation est terminée. Il est maintenant
possible d'utiliser clGestion pour gérer un ou
plusieurs comités locaux.
2.2 Utilisation de clGestion
Toujours à partir du classeur clgestion.sxc, démarrer
la macro moduleAdhésions, le plus simple étant de
cliquer sur l'icône groupe, deuxième bouton à gauche
dans la barre d'outils du classeur clgestion.
Si cette barre ou cet icône n'apparaît pas, la macro
peut être lancée comme suit :
* parcourir le menu : Outils -> Macros -> Macro;
* double cliquer sur ATTAC dans le tableau des modules
de macros, à gauche dans la boîte de dialogue qui
s'est ouverte;
* double cliquer sur la macro moduleAdhésions ou la
sélectionner dans la liste et cliquer sur le bouton exécuter.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_macro_moduleAdhesions.pn
g>
2.2.1 Sélection de groupe
Au premier lancement, clGestion affiche le dialogue
spécification de groupe qui permet de sélectionner le
groupe auquel il faut le rattacher. clGestion crée
ensuite la feuille groupe dans laquelle seront
uniquement reportés ou mis à jour les adhérents
concernés. Une fois cette feuille créée, cette question
ne sera plus posée.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_specgroupe.png>
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_groupes.png>
2.2.2 Fichier adhérents
Après la création de la feuille de groupe, clgestion
demande le fichier d'adhérents transmis par le service
des adhésions. Il faut lui spécifier à l'aide du
gestionnaire de fichiers OpenOffice qui s'ouvre
automatiquement à cet effet. Ce fichier doit se trouver
dans le répertoire de travail par défaut (ex. : c:\Mes
Documents\ATTAC ou /home/ATTAC/), sinon il faut
indiquer le chemin complet à l'aide du gestionnaire de
fichiers d'OpenOffice.
Le fichier adhérents est normalement fourni au format
Plain Text, extension .txt. Il n'est pas nécessaire de
le convertir au format de fichiers .xls puisque
clGestion utilise le tableur d'OpenOffice et non pas
Excel pour gérer les comités locaux.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_fichieradherents.png>
clGestion affiche ensuite le dialogue trimestre
d'adhésion qui permet de spécifier à quel trimestre ...
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_trimestreadhesion.png>
Une feuille pour cette période est créé avec un nommage
particulier.
L'exécution de cette macro peux prendre un certain
temps. En effet, le chargement en lui même est assez
rapide mais il faut ensuite rattacher les adhérents à
une commune afin de savoir quel en est le groupe de
rattachement car une commune égale un groupe.
L'écriture du nom de la commune dans l'adresse et dans
la liste des communes pouvant être différente, cette
opération n'est pas fiable à 100% et des confirmations
sont demandées. Pendant le déroulement, on voit
l'avancement dans les colonnes colonnes P et Q.
Lorsqu'il y a un doute, c'est-à-dire lorsque la macro
constate un pourcentage de fiabilité inférieur à 7%
entre les deux communes les plus probables, clgestion
demande confirmation en proposant une liste de noms de
communes avec la probabilité la plus forte en tête et
un maximum de 10 possibilités.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_commune_ambigu.png>
Après affectation d'une commune à chaque adhérent,
clGestion demande à quel groupe appartient la commune
lorsque cette info est inconnue.
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_groupe_a_commune.png>
<Fichier graphique :
/home/reinhardt/clgestion_doc/images/clgestion_feuille_trimestre.png>
Ces informations ainsi que les codes postaux sont
reportés dans la liste des communes, soit en 4e
colonne, et plus aucune question ne sera posée par la suite.
Enfin, les adhérents du groupe choisi au début sont
reportés dans la feuille du groupe, éventuellement pour
publipostage ultérieur, et le nombre d'adhérents
reportés, par formule, dans l'onglet groupes pour la
période visée.
