meta données pour cette page
  •  

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
admin:import [2026/01/02 09:30] – nicolasadmin:import [2026/01/02 14:36] (Version actuelle) – [Les écrans d'import] nicolas
Ligne 1: Ligne 1:
-|{{:connexe.jpg?40|}} **Sujets connexes**| [[https://cartographie-fonctionnelle.logeas-web.fr/Bdd|Format de la base de données]]\\ [[https://wiki-logeas.fr/certif/lib/exe/detail.php?id=certif%3Adcg&media=certif:technique:9_base_de_donnees_utilisateur.jpg|Schéma]]\\ [[admin:import:utilitaire-prenom]]\\ [[admin:import:split-colonne]]\\ [[admin:import:duplique-enregistrement]]\\ [[admin:import:creer-champ-perso]]|+|{{:connexe.jpg?40|}} **Sujets connexes**| [[https://cartographie-fonctionnelle.logeas-web.fr/Bdd|Format de la base de donnée]]\\ [[https://wiki-logeas.fr/certif/lib/exe/detail.php?id=certif%3Adcg&media=certif:technique:9_base_de_donnees_utilisateur.jpg|Schéma]]\\ [[admin:import:utilitaire-prenom]]\\ [[admin:import:split-colonne]]\\ [[admin:import:duplique-enregistrement]]\\ [[admin:import:creer-champ-perso]]|
  
 ====== Fonctions d'import de LoGeAs ====== ====== Fonctions d'import de LoGeAs ======
- 
 ===== Import d'un fichier ===== ===== Import d'un fichier =====
 Quelques remarques : Quelques remarques :
   * Cette fonctionnalité est à réserver à des personnes ayant une bonne connaissance du produit.\\   * Cette fonctionnalité est à réserver à des personnes ayant une bonne connaissance du produit.\\
-  * Les fonctionnalités sont nombreuses et pas toujours faciles à appréhender.\\ +  * Les fonctionnalité sont nombreuses et pas toujours facile à appréhender.\\ 
-  * L'assistance peut prendre en charge des imports si nécessaire. +  * L'assistance peut prendre en charge des imports si nécessaire 
-  * Il est difficile de décrire une « procédure » type d'import de fichier tant les formats peuvent être variés.\\ +  * Il est difficile de décrire une "procédure" typique d'import de fichier tant les formats des imports peuvent être varié.\\ **Cet utilitaire ce veut un couteau suisse permettant de gérer des formatages initiaux divers de les amender, compléter et tester afin de les rendre compatible avec l'import. De préférence sans outils externes** 
-    **Cet utilitaire se veut un véritable couteau suisse permettant de gérer des formatages initiaux très divers, de les amender, compléter et tester afin de les rendre compatibles avec l'import, de préférence sans outils externes.** +  * **Il n'est pas possible de réimporter des enregistrements déjà existant**
-  * **Il n'est pas possible de réimporter des enregistrements déjà existants.** +
 ==== Présentation globale de l'outil ==== ==== Présentation globale de l'outil ====
 L'outil se divise en trois grands blocs : L'outil se divise en trois grands blocs :
Ligne 18: Ligne 15:
   * **"Intégration dans la base"**   * **"Intégration dans la base"**
  
-Les deux premiers blocs fonctionnent de manière similaire.   +Les deux premiers ont le même fonctionnement, le troisième sert à l'intégration une fois tout les problèmes résolus
-Le troisième permet l'intégration finale une fois l'ensemble des problèmes résolus. +
 ==== Les écrans d'import ==== ==== Les écrans d'import ====
- +=== 1: Import du fichier === 
-=== 1 : Import du fichier === +Sur l'arrivée de l'un de ces écrans il conviens de charger votre fichier (il est généralement conseillé de commencer par le fichier des personnes) à l'aide du bouton **"Choisir un fichier"**. Trois format sont possible (.xls, .xlsx, ou CSV). Pour des problèmes de compatibilité d'accent il est préférable d'utiliser les deux premiers. A noter que c'est format peuvent aussi être généré depuis [[https://fr.libreoffice.org/download/telecharger-libreoffice/|Libre-Office]] ou [[https://www.openoffice.org/fr/|Open-Office]] à défaut d'Excel.\\ 
-À l'arrivée sur l'un de ces écrans, il convient de charger votre fichier (il est généralement conseillé de commencer par le fichier des personnes) à l'aide du bouton **"Choisir un fichier"**.   +La première ligne de la table doit comporter le nom de colonnes, elle sera utiliser comme tel à l'import\\
-Trois formats sont possibles : **.xls**, **.xlsx** ou **.csv**.   +
-Pour des raisons de compatibilité avec les accents, il est préférable d'utiliser les deux premiers formats.   +
- +
-Ces formats peuvent également être générés à partir de [[https://fr.libreoffice.org/download/telecharger-libreoffice/|LibreOffice]] ou [[https://www.openoffice.org/fr/|OpenOffice]] en l'absence d'Excel.\\ +
-La première ligne du fichier doit contenir les noms des colonnes ; elle sera utilisée comme telle lors de l'import. +
 \\ \\
-Dès le chargement, une grille s'affiche avec les données lues ainsi qu'une analyse située en dessous (il est recommandé de traiter les points dans l'ordre).\\ +Dés le chargement une grille s'affiche avec les informations lues et une analyse de celle-ci au dessous (il vaut mieux les traiter dans l'ordre).\\ 
-Plusieurs sous-onglets apparaissent également : +Plusieurs autres sous-onglets sont aussi apparues : 
-  * **"Données"** : grille des données importées +  * **"Données"** : la grille des données importées 
-  * **"Colonnes existantes"** : liste des colonnes présentes dans l'import (permet également certaines actions sur les colonnes) +  * **"Colonnes existantes"** : contiens une liste des colonnes de l'importation (elle permet aussi certaine action sur les colonnes, que l'on retrouve sur le premier ergo) 
-  * **"Colonnes attendues"** : liste des champs connus dans la table cible, avec leur rôle, utile pour les affectations +  * **"Colonnes attendues"** : contiens la liste des champs(colonnes) connues dans la table cible, avec leur rôle, ce qui peut être utile pour vos affectation 
-  * **"Prénom"** : (uniquement pour l'import des personnes) permet des traitements annexes (affectation du sexe, du titre, etc.).   +  * **"Prénom"** : (uniquement disponible dans l'import de personne) permet des traitements annexe (affectation du sexe, du titre..) pour en savoir plus voir [[admin:import:utilitaire-prenom]] 
-    Pour en savoir plus, voir [[admin:import:utilitaire-prenom]] +=== 2: Traitements génériques === 
- +Le logiciel va vous guider et vous proposer des utilitaires pour résoudre les problèmes les plus courant, mais il ne connait pas vos données, il vous reste donc un travail d'analyse important à faire. Avant cela regardons les fonctions disponibles sur le **clic droit** (menu contextuel) sur le titre des colonnes de **l'ergo "Données"**.
-=== 2 : Traitements génériques === +
-Le logiciel vous guide et vous propose des utilitaires pour résoudre les problèmes les plus courants.   +
-Cependant, ne connaissant pas vos données, un travail d'analyse reste indispensable. +
- +
-Avant cela, voyons les fonctions disponibles via le **clic droit** (menu contextuel) sur le titre des colonnes dans l’ergonomie **"Données"**. +
 ^Menu^Action^ ^Menu^Action^
-|**Renommer cette colonne**|Permet de lier une colonne de l'import à une colonne de la table cible.\\ Exemple : une colonne nommée "adresse" dans le fichier importé peut être liée à la colonne **"Adresse3"** de LoGeAs.\\ **Ce traitement peut également être réalisé depuis l'analyse sous la grille lors du traitement des erreurs.**| +|**Renomme cette colonne**|Ce menu permet de lier la colonne de l'import avec une colonne de la table cible.\\ Par exemple dans le fichier importer la colonne qui contiens l'adresse ce nomme "adresse" ce qui n'est pas un champ de la table cible on va donc la lié avec la colonne "Adresse3" qui doit contenir le numéro, nom.. de la rue\\ **A noter que ce traitement peut aussi être fait depuis l'analyse sous la grille lors du traitement des erreurs**| 
-|**Effacer cette colonne**|Supprime la colonne si elle n'est pas pertinente.\\ **Attention : aucune annulation possible. Utilisez le bouton de sauvegarde de la grille (en haut à droite) aussi souvent que nécessaire.**| +|**Efface cette colonne**|Ce menu permet de supprimer la colonne si elle n'est pas pertinente dans le cas en cours\\ Attention il n'y a pas de marche arrière, utilisez le bouton de sauvegarde de la grille (en haut à droite) chaque fois que nécessaire| 
-|**Remplacer dans cette colonne (cellules entières)**|Permet de remplacer une valeur par une autre sur l'ensemble de la colonne.\\ Très utile pour remplacer des abréviations par leur libellé complet.| +|**Remplace dans cette colonne (cellules entières**|Cette utilitaire permet de rechercher dans la colonne les cases qui contiennent une valeur (case entière) pour les remplacer par une autre valeur\\ très utile par exemple pour remplacer une abréviation par le mon intégral| 
-|**Passer en majuscule (MarcChand Nicolas → NICOLAS MARCHAND)**|Utile par exemple pour forcer les noms de villes en majuscules.| +|**Passe en majuscule (MarcChand Nicolas => NICOLAS MARCHAND)**|A utiliser par exemple pour forcer le nom de la ville en majuscule| 
-|**Passer en minuscule (MarcChand Nicolas → nicolas marchand)**| | +|**Passe en minuscule (MarcChand Nicolas => nicolas marchand)**| | 
-|**Passer en Nom Propre (MarcChand Nicolas → Nicolas Marchand)**|Utile notamment pour les prénoms.| +|**Passe en Nom Propre (MarcChand Nicolas => Nicolas Marchand)**|Utile pour les prénoms par exemple| 
-|**Initialiser toutes les valeurs vides de la colonne**|Permet par exemple de remplacer toutes les valeurs vides de la colonne **"Pays"** par "France".| +|**Initialiser toutes les valeurs vides de la colonne à une valeur**| Peut être utiliser par exemple pour remplacer dans la colonne "Pays" toutes les valeurs non initialiser par France| 
-|**Dupliquer les enregistrements (lignes) en fonction d'une colonne**|Permet de créer de nouveaux enregistrements selon les valeurs d'une colonne.\\ Exemple détaillé : [[admin:import:duplique-enregistrement]]| +|**Duplique les enregistrements(ligne) en fonction de colonne**|Cette fonction permet de créer de nouveau en enregistrement(ligne) en fonction des valeurs dans une colonne.\\ Prenons une exemple pour mieux comprendre dans mon fichier de personnes je n'ai pas une ligne par individu mais deux colonnes prenom1 et prenom2 et je voudrais créer une nouvelle ligne pour toute les lignes ou le prenom2 est renseigné pour en savoir voir l'exemple détaillé [[admin:import:duplique-enregistrement]]| 
-|**Diviser la colonne en deux selon différents critères**|Permet par exemple de séparer une colonne contenant à la fois le code postal et la ville.\\ Exemple détaillé : [[admin:import:split-colonne]]|+|**Divise la colonne en deux, selon différent critère**|Permet par exemple sur une colonne contiens à la fois le code postal et la ville d'un générer deux nouvelles colonnes nécessaires pour l'import. voir l'exemple détaillé [[admin:import:split-colonne]]| 
 +**Remarques** : 
 +  * **ATTENTION** Le travail sur les colonnes ne tiens pas compte du filtrage de la grille 
 +  * Vous pouvez commencer par traiter les colonnes que vous connaissez par le biais du menu contextuel ou suivre l'aide ou utiliser le détecteur d'erreur et suivre sa progression 
 +=== 3: Erreurs, Avertissements === 
 +^N° erreur/avertissement^Titre^Explications^Quoi faire?^ 
 +|Erreur 1 à 5|La colonne **"ID"** ou **"Numero"** est obligatoire dans la table X\\ La colonne **"ID"** ou **"Numero"** doit comporter des valeurs uniques|Du à l'historique deux colonnes servent de "Clé primaire" : **"ID"** et **"Numero"**\\ Une clé primaire, c’est simplement un identifiant unique pour chaque ligne d’une table dans une base de données, elle sert à reconnaître une ligne sans ambiguïté. Comme un numéro de carte d’identité pour une personne.\\ |* Créer la colonne si votre fichier ne la comporte pas (utilitaire proposé)\\ * Renommer une des colonnes existante, mais qui serait déclaré sous un autre nom\\ * Une fois celle-ci existante vous pouvez l'initialiser si besoin avec l'utilitaire proposé\\ **Attention, les colonnes Numero et ID doivent être strictement égales**| 
 +|Erreur 6|Dans la table X la colonne C doit exister|Certaine colonne comme par exemple le nom dans les personnes sont obligatoire. La colonne les contenant doit donc exister\\ Parmi c'est colonne la colonne **"Famille"** de la table Personne à un rôle spécial : Elle doit comporter le numero (ID) qui corresponds à la famille dans la table correspondante.| Créer la colonne si votre fichier ne la comporte pas (utilitaire proposé)\\ * Renommer une des colonnes existante, mais qui serait déclaré sous un autre nom| 
 +|Erreur 7|Dans la table X la colonne C la colonne n'a pas toujours une valeur|En lien avec l'erreur précédente, dans une colonne obligatoire tout les enregistrement doivent avoir une valeur|* Normalement l'analyseur vous donne les enregistrement en erreur. Vous pouvez les modifier dans la grille (édition en fin de ligne)\\ * Cas spécifique du champ **"Intitule"** de la table Famille. Souvent on recopie la table des personnes pour créer les famille mais le champ intitulé n'existe pas. Un utilitaire vous permet de le créer plus facilement. Pour en savoir plus [[admin:import:utilitaire-intitule]]\\ * Dans le cas du champ **"famille"** de la table "Personne", il est possible aussi de numéroter en regroupant les personnes ayant des champs commun, par exemple l'adresse| 
 +|Avertissement 13|La colonne **"ClasserSous"** n'existe pas dans l'import de la table Famille|Ce n'est pas une erreur à proprement dit, car la colonne "Classer-Sous" n'est pas obligatoire\\ Mais des lors que vous voulez facilement trier les familles ou retrouver une famille facilement pour lui affecter une nouvelle personne, c'est ce champ qui sert...|* Si vous avez dupliquer vous fichier famille, vous pouvez "renommer" la colonne "Nom"\\ * Sinon vous pouvez la créer vide et la remplir plus tard| 
 +|Erreur 8|Dans la table X la colonne C n'existe pas|Dans votre grille vous avez par exemple une colonne intitulé "Adresse" hors il n'existe pas de colonne dans LoGeAs sous ce nom\\ ou vous avec un champ "Membre de la chorale" et si vous voulez l'importer il faut le créer en tant que champ personnalisé ([[https://wiki-logeas.fr/logeas/doku.php?id=clientlourd:administration:table:gestionchampersonnefamille|pour en savoir plus]])|* Vous pouvez effacer la colonne (voir utilitaire)\\ * Vous pouvez affecter la colonne à une colonne existante dans dans LoGeAs (dans notre exemple Adresse => Adresse3)\\ * Créer un champ personnalisé via l'utilitaire [[admin:import:creer-champ-perso|pour en savoir plus]]| 
 +|Erreur 9 et 10|Les colonnes contenant des booléens doivent exister ...|Bien que non obligatoire, l'utilitaire d'import impose que les colonnes vrai/faux existe et soit initialisée|* Un bouton vous permet de les créer et les initialisé d'un coup ou au coup par coup\\ **J'attire votre attention sur les colonnes lié directement au RGPD (envoyer un mailing, un sms, envoyer les reçu fiscaux par mail ...). Ils sont pas défaut non coché. A vous le cas échéant d'en changer la valeur**| 
 +|Erreur 11|Les clefs de champs uniques sont-elles cohérentes avec le fichier actuel ?|Ce test vérifie que les champs d'index (cf erreur 1 et suivantes) ne rentre pas en conflit avec des enregistrement existant déjà dans la base|Si c'est la cas...\\ **Remarque : Il n'est pas possible de réimporter des enregistrements déjà existant**| 
 +|Erreur 12|Les personnes doivent pointer sur des familles existantes|Le fameux champ "Famille" dont on a parlé plus haut\\ Certaine personnes de votre import on une valeur pour ce champ qui ne corresponds ni l'ID d'une famille de votre import, ni à celle d'une famille existante dans votre fichier|Il faut y remédier manuellement ...| 
 +|Avertissement 14|Certain enregistrement de la colonne "ClasserSous" ne sont pas initialisé| | |
  
-**Remarques :** 
-  * **ATTENTION :** le travail sur les colonnes ne tient pas compte du filtrage de la grille. 
-  * Vous pouvez traiter les colonnes soit via le menu contextuel, soit en suivant l'aide et le détecteur d'erreurs. 
- 
-=== 3 : Erreurs et avertissements === 
-^N°^Titre^Explications^Que faire ?^ 
-|Erreur 1 à 5|La colonne **"ID"** ou **"Numero"** est obligatoire|Ces colonnes servent de clé primaire (identifiant unique).\\ Elles doivent contenir des valeurs uniques.|* Créer la colonne si elle n'existe pas\\ * Renommer une colonne existante\\ * Initialiser la colonne via l'utilitaire proposé\\ **Attention : les colonnes "ID" et "Numero" doivent être strictement identiques.**| 
-|Erreur 6|Une colonne obligatoire n'existe pas|Certaines colonnes sont obligatoires (ex : Nom pour les personnes).\\ La colonne **"Famille"** doit contenir l'ID de la famille correspondante.|Créer ou renommer la colonne concernée| 
-|Erreur 7|Valeur manquante dans une colonne obligatoire|Toutes les lignes doivent être renseignées.|Corriger les lignes en erreur dans la grille| 
-|Erreur 8|La colonne n'existe pas dans LoGeAs|Ex : colonne "Adresse" inexistante dans la base.|Supprimer, renommer ou créer un champ personnalisé ([[admin:import:creer-champ-perso]])| 
-|Erreur 9 et 10|Colonnes booléennes manquantes|Les colonnes vrai/faux doivent exister et être initialisées.|Créer et initialiser les colonnes proposées\\ **Attention aux champs RGPD, initialisés par défaut à faux.**| 
-|Erreur 11|Conflit avec des données existantes|Les clés uniques entrent en conflit avec la base existante.|**Il est impossible de réimporter des enregistrements existants.**| 
-|Erreur 12|Lien personne / famille invalide|La valeur du champ "Famille" ne correspond à aucune famille.|Correction manuelle nécessaire| 
-|Avertissement 13|Colonne "ClasserSous" absente|Colonne facultative mais utile pour le classement.|Créer ou renommer la colonne| 
-|Avertissement 14|Valeurs manquantes dans "ClasserSous"| | | 
- 
-==== Comment faire pour… ==== 
-^Problème^Solution^ 
-|Remplacer des codes numériques par un libellé|Utiliser **"Remplacer dans cette colonne (cellules entières)"**| 
-|Uniformiser la casse des données|Utiliser les fonctions Majuscule / Minuscule / Nom propre| 
-|Séparer Code postal et Ville|Voir [[admin:import:split-colonne]]| 
-|Gérer plusieurs prénoms par foyer|Voir [[admin:import:duplique-enregistrement]]| 
-|Supprimer une ligne|Bouton de suppression en fin de ligne dans la grille| 
-|Importer des données non prévues par LoGeAs|Créer un champ personnalisé ([[admin:import:creer-champ-perso]])| 
  
 +==== Comment faire pour ... ====
 +^Description du probléme...^Les éléments de solutions^
 +|J'ai une colonne qui contiens des chiffres "0" "1" "2"... pour indiquer une tournée de distribution et je voudrais plutôt y indiquer le nom de la tournée en clair|1) Repérez dans la grille la colonne concernée\\ 2) Activer le menu contextuel par le clic droit sur l'entête de colonne\\ 3)Utiliser le menu **"Remplace dans cette colonne (cellules entières)"** en répétant pour chaque tournée|
 +|Le formatage des caractères des colonnes est "aléatoire", je voudrais le rendre homogène|1) Repérez dans la grille la colonne concernée\\ 2) Activer le menu contextuel par le clic droit sur l'entête de colonne\\ 3)Utiliser l'une des menus de formatage\\ Par exemple : Majuscule pour la ville, Nom Propre pour les prénoms ...|
 +|Dans mon import "Code postal" et "Ville" sont dans la même colonne|Voir l'exemple détaillé [[admin:import:split-colonne]]|
 +|Mon fichier de personnes contiens deux colonnes de prénoms comment faire ?|Voir l'exemple détaillé [[admin:import:duplique-enregistrement]]|
 +|Une des lignes doit être effacer (ligne par exemple). Comment faire ?|Dans la grille de l'ergo "Donnée" vous avez un bouton pour effacer une ligne à la fin de celle-ci|
 +|J'ai besoin d'importer des données qui ne sont pas prise en charge par LoGeAs. Commet faire?|Dans les erreur (erreur 8) vous avez la possibilité de créer un champ personnalisé [[admin:import:creer-champ-perso|Voir la documentation]]|
 ==== Exemples ==== ==== Exemples ====
-^Description du fichier source^Lien^ +^Descriptif du fichier source^Lien sur le déroulé^ 
-|Fichier personnes avec plusieurs colonnes de prénoms|[[import:fichier:exemple1]]| +|Fichier uniquement de personne, comportant plusieurs colonne de prénom (pour les différentes personnes du foyer)|[[import:fichier:exemple1]]|