Addons INSC 

(c) PyG : dev@cornalys.com -- v0.1 20/11//2003
Code sous licence GNU/GPL

Objectif

Permet d'inscrire un grand nombre de stagiaires en une seule fois à partir d'un fichier texte correctement formatté.

Screenshots / Démonstration

Capture

Fonctionnalités  

• Détection des fichiers mal formattés
• Détection des doublons dans le fichier
• Détection des doublons entre le fichier et la base de données
• Détection des champs obligatoires vides et des lignes vides
• Affichage de tableaux synoptiques avant l'insertion/mise à jour de données dans la base
• Possibilité de voir/imprimer les requêtes générées avant leur execution
• Possibilité de générer de log/pass préformattés sous conditions
• Possibilité de choisir un skin ganesha par défaut
• Mode "test" : les requêtes sont générées mais ne sont pas réellement effectuées
• Possibilité de saisir plusieurs groupes permettant d'inscrire automatiquement le stagiaire concerné à chacun de ces groupes

Utilisation

Vous devez pour cela fournir un fichier formatté de la façon suivante :

Prénom;Nom;(login);(password);(email);(adresse);(cp);(ville);(skin);(g1,g2,...,gn);(sessions)[RC]
Prénom;Nom;(login);(password);(email);(adresse);(cp);(ville);(skin);(g1,g2,...,gn);(sessions)[RC]
(...)
Prénom;Nom;(login);(password);(email);(adresse);(cp);(ville);(skin);(g1,g2,...,gn);(sessions)[RC]

où :
* les champs entre parenthèses sont optionnels,
* [RC] représente un retour chariot,
* g1, g2,etc. réprésentent les identifiants des groupes auxquels on souhaite inscrire le stagiaire (qu'on peut relever côté admin).
* dans cette version, il n'est pas tenu compte du dernier champ (sessions).

Attention :
- Les champs Prénom et Nom sont obligatoires !
- Aucun champ ne doit contenir de points-virgules !
- Ce format (données séparées par des points-virgules) est parfaitement géré par de nombreuses applications : "Enregistrer au format .csv" pour Excel ou OpenOffice.org, par exemple. Choisissez bien "séparateur = point-virgule" !

Options 

• Tenir compte de la première ligne : Si oui, l'addon considère que la première ligne du fichier contient les données d'un stagiaire. Si non, l'addon ne tient pas compte de la première ligne (lors d'un export .csv depuis un tableur, la première ligne contient souvent les intitulés de champs).
• Doublons = arrêt : Rend impossible le passage à l'étape 3 si des doublons login/pass sont reperés entre les données du fichier et la base de données Ganesha
• Doublons = Mettre à jour : Met à jour les données du stagiaire Ganesha avec les informations de son "double" du fichier.
• Doublons = groupes uniquement : laisse le stagiaire Ganesha tel quel dans la base, mais l'inscrit malgré tout à la liste de groupes indiqués par son "double" du fichier.

INSTALLATION

Téléchargez le fichier

1- copiez le dossier "addons" et son contenu au même niveau que les dossiers chat, cv, ou formations de votre plateforme ganesha
2- éditez le fichier insc_config.inc.php et mettez les parametres de votre base (n'oubliez pas de passer "ADDON_INSC" à 1 lorsque vous voudrez passer du mode "test" au mode "réel").
3- apellez http://monganesha.com/addons/insc/
4- des fichiers d'exemples (.txt, .csv, Excel, OpenOffice) sont à votre disposition dans le dossier insc/exemples/ Certains génèrent volontairement des erreurs !

Précautions

• L'auteur de cet addon (béni soit-il ;) ne pourra être tenu responsable des pertes ou modifications de données sur votre base Ganesha !
• Faites des sauvegardes !
• Entrainez-vous sur des bases "crash_tests" avant de travailler sur vos données en production
• Vérifiez bien le format des champs : certains sont testés, d'autres pas. Ainsi, rien ne vous empêche de mettre "20" voire "toto" comme valeur pour le skin, l'addon "INSC" ne fera pas la différence
• Par précaution, n'insérez pas plus de 100 stagiaires d'un coup, cela pourrait surcharger le serveur MySQL. Découpez plutôt votre fichier texte
  

Bugs

Ca ne marche pas ?

Un bug est identifié pour les serveurs ayant une configuration "magic_quotes=On".

Pour le corriger, remplacez, dans le fichier /addons/insc/requetes.php la ligne N°6 :
$requetes = $HTTP_POST_VARS['requetes'];
par
$requetes = stripslashes($HTTP_POST_VARS['requetes']);