Export - Import

Export

L'export permet d'exporter sous forme de fichier CSV l'ensemble des informations concernant les membres enregistrés, à raison d'une ligne par membre et une colonne par champ. Le script crée un fichier sur le serveur web puis le propose en téléchargement sur le poste de l'utilisateur; pour éviter des collisions au cas où plusieurs utilisateurs lanceraient l'export simultanément, leur pseudo entre dans la composition du nom du fichier. Pour l'enregistrer sur l'ordinateur de l'utilisateur, ce nom peut bien sûr être modifié.

Le fichier créé peut avoir plusieurs utilisations:

1. tout simplement servir de fichier des membres, en particulier la partie "données personnelles", si on a construit un formulaire assez complet et si les membres l'on complété!
2. faire des modifications en masses via un réimport. Seules les lignes à modifier devront être réimportées. Seules les colonnes à modifier seront nécessaires, avec le pseudo, bien sûr.
3. modèle pour faire un fichier de création en masse.

S'il n'y a pas de données personnelles, l'écran est celui-ci :

s'il y a des données personnelles, l'écran est celui-là (Rappel: pour qu'il y ait des données personnelles, il faut créer un formulaire du nom "Sesame" dans le plugin formulaire et les activer dans config générale en répondant autre chose que "non" à la question " Affichage liste des membre" )  :

• En têtes : si coché, ajoute une ligne des entêtes de colonne en début de fichier. Si les (2) autres cases ne sont pas cochées c'est la seule ligne qui existe dans le fichier. Cela peut servir à préparer un squelette de fichier en vue de le remplir pour créer de nouveaux membres via un import; cette ligne est obligatoire pour un import. NOTE: Les entêtes de colonne sont dans le fichier de langue; s'ils ne vous conviennent pas, vous pouvez les personnaliser.
• Données OU Compte GuppY : si coché, inclut dans le fichier les informations gérées par les fonctions "Mon compte" ET "Mes options". La colonne mot de passe est créée mais est laissée vide; elle pourra servir pour un éventuel import.
• Données personnelles : si coché, inclut dans le fichier les informations gérées par la fonction "Mes données personnelles".
   
• Adresses Mél : Si cette case est cochée, les autres options sont ignorées. Cette option sert à contrôler les pseudos qui ont une adresse mél commune. Normalement, cette situation ne devrait pas exister. Il se peut toutefois, qu'il reste des vieux enregistrements qui aient échappé aux contrôles. En tout cas, cette option peut servir à lister juste les adresses mél.

Import

L'import ressemble à l'option "Inscriptions multiples" de la "Gestion des membres" de GuppY". A ceci près qu'il permet de le préparer à l'avance, que ça peut être un export d'une autre application, qu'on peut importer tous les champs GuppY (même si ça n'a pas grand sens pour certains!), qu'ont peut importer les champs du profil Sesame et les données perso quand on a prévu le formulaire Sesame.

En plus d'ajouter de nouveaux membres, l'import permet de modifier des membres existants. Les opérations de création et modification ne sont pas possibles simultanément; pourquoi cela? L'administrateur va vouloir faire des campagnes de création de nouveaux membres ou suppression d'anciens membres ou vouloir faire des modifications en masse comme abonner tous ses adhérents à un nouveau forum; Toutes ces opérations n'ont rien à voir entre elles. Par contre toutes peuvent être préparées sur un fichier LibreOffice ou excel: dans le premier cas, on peut aller du plus simple (pseudo,mél qui sera complété par la suite par le membre lui-même) au plus complet, dans le deuxième cas, on fait un export d'abord puis on sélectionne les lignes à supprimer et on envoie le fichier en "modification, dans le troisième cas, on fait aussi un export, on ne conserve que la colonne abo_forum dans laquelle on ajoute la catégorie voulue et on envoie en modification.

• Création de nouveaux membres : Il suffit des colonnes pseudo et mél pour créer un membre. Si le mot de passe n'est pas fourni il est généré aléatoirement. Si une fiche perso est gérée et s'il y a des champs obligatoires, ils doivent être fournis. Le membre créé reçoit un courriel sur l'adresse qui vient d'être créée pour lui indiquer son pseudo et son mot de passe.
• Modification de membres existants : la colonne pseudo doit être fournie mais le pseudo n'est pas modifiable. Seules les colonnes fournies sont modifiées. Les champs qui sont vides ne sont pas modifiés. Pour effacer un champ qui contient des données (non booléen), il faut mettre "S-U-P". Pour décocher un champ booléen, il faut mettre "off". Pour supprimer un pseudo complètement, avec ses données perso, il faut mettre "S-U-P" dans la colonne mot_passe; les autres colonnes sont ignorées.

Lors de l'importation, des contrôles sont faits, en particulier sur les champs obligatoires des "Données perso", même s'ils ne sont pas présents sur le fichier importé (dans ce cas le contrôle est fait sur la valeur de la fiche). Les erreurs sont affichées à l'écran pour chaque pseudo; s'il y a une ou plusieurs erreurs pour un pseudo celui-ci n'est pas traité. Les pseudos sans erreur sont traités (créés ou modifiés).

Il n'y a plus qu'à corriger les erreurs sur le fichier CSV et à recommencer l'import.

Tous les champs calculés sont recalculés, que ce soit à partir des champs importés ou à partir de champs déjà présents sur la fiche. L'importation est un bon moyen de créer les champs calculés nouvellement définis sur une fiche. Après avoir défini le champ calculé sur le formulaire "Sesame", on fait un export, on supprime toutes les colonnes, sauf le pseudo, et on re-importe le tout; aucun champ n'est modifié, mais tous les calculs sont refaits. 

Il est plus que vivement conseillé de faire une copie des répertoires data/users et data/plugins/sesame avant de faire un import. Normalement (j'aime pas le mot normalement!) il ne devrait pas y avoir de problèmes, j'ai fait des dizaines d'import et je n'ai jamais rien détruit, mai il faut préciser que j'ai toujours envoyé un fichier "propre", conforme à ce que s'attendait à attendre le programme, avec des erreurs sans doute mais qu'il savait traiter. Je ne garantis pas qu'un néophyte, par mauvaise compréhension envoie un fichier tordu pour le programme qui, par vengeance, lui pourrira les répertoires.

Liste des colonnes GuppY et Profil Sesame pour l'import

• pseudo : obligatoire dans tous les cas. Soit il sert à le créer, soit il sert à le rechercher en cas de modification.
• mot_passe :
  • création : si vide, un mot de passe aléatoire est fourni, sinon le mot de passe est contrôlé
  • modification : vide, on ne modifie pas le mot de passe par un import.
    Ou "S-U-P" pour supprimer le membre et toutes ses informations.
• mel : Votre courriel
  • création : obligatoire. Le contrôle de doublon est fait.
  • modification : si vide, il ne sera pas modifié

Champs contenant du texte

En création comme en modification, rien n'est obligatoire. Si vide, en création le champ ne sera pas rempli, en modification, il ne sera pas modifié. Si renseigné, le champ est contrôlé suivant le type de données.

• langue : Votre langue pour le contenu
• signature_forum : Signature forum personnalisée (texte)
• avatar : le numéro d'avatar, sous la forme "ava-NN" où NN est le numéro d'avatar
• site_web : Votre site web
• avatar_externe : une URL pointant sur une image pour remplacer les avatars fournis par GuppY

Champs contenant une valeur booléenne

En création comme en modification, rien n'est obligatoire. Si vide, en création le champ sera décoché, en modification, il ne sera pas modifié. En modification, pour décocher un champ, mettre off.

• affiche_pseudo : Afficher votre pseudo
• pas_autorise_MP : n'est pas autorisé à utiliser la messagerie privée
• pas_autorise_mel : n'est pas autorisé à contacter les membres par courriel
• pas_autorise_profil : n'est pas autorisé à accéder aux profils des membres
• interdit_liste_membres : n'est pas autorisé à accéder à la liste des membres
• interdit_avatar_ext : Interdire les avatars externes pour ce membre
• contact_mel : Les membres peuvent me contacter par courriel
• contact_MP : Les membres peuvent m'envoyer des messages privés
• avertir_MP : M'avertir des messages privés par courriel
• accuse_MP : Accusé de lecture pour les messages privés
• accueil_apres_connexion : Aller à l'accueil après connexion :

Champs contenant une date

En création, la date d'enregistrement peut être fournie, mais ce n'est pas logique; si vide, elle est forcée à la date de l'opération; les autres dates sont ignorées et forcées à vide. En modification, La logique est la même que pour les champs à texte. Lorsqu'elle est fournie, la date doit être sous la forme AAAAMMJJHHMM, les heures et les minutes ne sont pas obligatoires.

• date_enregistrement : Date d'enregistrement de votre compte :
• date_connexion : Dernière connexion le
• date_deconnexion : Dernière déconnexion le
• date_accept_RGPD : Date d'acceptation RGPD

Statuts

Dans GuppY, ces 2 champs sont positionnés concomitamment en fonction du mode d'inscription et du statut enregistré sur la fiche. On aboutit à des combinaisons variées. Ici, il n'y a pas lieu d'envisager tous les cas. En création, les valeurs sont forcées respectivement à on et ok. En modification, si vide, la valeur n'est pas changée, sinon elle est remplacée par la valeur du fichier; attention de mettre des valeurs cohérentes...

• statut :  on ou vide
• flag_inscription : ok ou vide

Profil Sesame

• groupes : vide ou liste des groupes auxquels rattacher le membre
• abo_forum : vide ou x ou liste des numéros de catégorie des forum auxqelles abonner le membre. si x, le membre est abonné à l'ensemble du forum. En création, l'abonnement est forcé à x. Si vous mettez une liste de numéro, vous devez mettre toutes les catégories que vous souhaitez autoriser, ce n'est pas un ajout aux catégories existantes. Si vous voulez modifier les groupes d'appartenance et les abonnements forum, vous devez le faire en 2 passages, les groupes d'abord puis l'abonnement.
• abo_newsletter : Abonné à la lettre d'information du site. vide ou oui ou non.
• autorise_mel (n'est présent que si un formulaire Sesame existe) : Le membre accepte d'être contacté par courriel. Vide ou oui ou non.
• autorise_voirdonperso (n'est présent que si un formulaire Sesame existe) : Le membre accepte de montrer ses données personnelles aux autres membres. Vide ou oui ou non.