Comment importer la liste des associations ou des commerçants
Comment, via le produit csvreplicata, il est possible d'importer un fichier csv contenant la liste des associations ou des commerçants de la commune.
Configuration du produit csvreplicata
Après avoir correctement installé le produit csvreplicata (en tant qu'administrateur du site, Configuration du site --> Ajout/Supression de produits), vous trouverez dans la partie "Configuration des produits d'extension" une rubrique vous permettant de configurer les objets importables/exportables d'un dossier.
Il vous sera dès lors possible de choisir le format de votre fichier csv :
- Encoding : UTF-8
- Delimiter : | (utiliser le pipe est conseillé pour éviter d'avoir des surprises si votre texte contient des ',',';' ou autres)
- String delimiter : " (permet de différencier un champ texte d'un champ numérique par exemple)
- Server Import folder : permet de spécifier où les fichiers d'import sont stockés (peux rester vide)
- Date format : indique le formatage des dates (ici, c'est jours/mois/ans - heures)
- Use plain csv format instead of original : laisser décocher
- Temporary path for export : peut rester vide
La colonne de droite permet de déterminer des champs qui ne seront pas importé/exporté (peut rester vide).
Il vous sera également possible de définir les différents types d'objets importables/exportables.
Pour les bottins associations : sélectionner le type "Association". Le schemata à importer/exporter étant celui par défaut.
Pour les bottins commerçants : sélectionner le type "shop". Les schematas à importer/exporter étant "address" et "général information". Ainsi que les types "SimpleVocabulary", "SimpleVocabularyTerm", "SortedSimpleVocabulary", "VocabularyLibrary". Les schematas étant toujours celui par défaut.
Voici le résultat après avoir inclus tous les types :
La configuration est finie et nous allons pouvoir importer un fichier csv contenant la liste des associations ou des commerçants.
Importation des associations
Le fichier csv doit être formaté comme suit :
1. La première ligne contient 2 colonnes correspondant au chemin où se fera l'importation et la date au format "yyyymmddhhmmss"
2. Les lignes 2 et 3 représentent le mapping des champs qui vont être importés (vous pouvez copier les lignes qui vont être données en exemple au début de votre fichier csv)
Ci-joint, vous trouverez un fichier excel reprenant l'en-tête correct (il ne reste plus qu'à remplir les colonnes).
Fichier joint
Pour bien remplir le fichier, voici un expliquatif des colonnes :
Parent folder : LAISSER VIDE
Identifier : nom de l'association sans caractères spéciaux (accent, blanc ou autre)
Content type : Association (rien d'autre)
label_short_name : copier la colonne Identifier
Les autres colonnes sont des champs propres aux associations. Cependant, la colonne Type d'association reprend les type d'association défini dans la configuration du bottin association (évitez d'avoir trop de types).
Attention : l'adresse du site web doit être au format http://www.nomdusite.be pour qu'il soit interprèté comme étant un site externe.
Dès que le fichier est correctement remplit et convertit au format csv, il ne vous reste plus qu'à aller dans le dossier qui reprendra vos associations où vous y trouverez un onglet csv import/export.
Où il ne vous reste plus qu'à aller chercher votre fichier csv et cliquer sur import.
Importation des commerçants
Le fichier csv doit être formaté comme suit :
1. La première ligne contient 2 colonnes correspondant au chemin où se fera l'importation et la date au format "yyyymmddhhmmss"
2. Les lignes 2 et 3 représentent le mapping des champs qui vont être importés (vous pouvez copier les lignes qui vont être données en exemple au début de votre fichier csv)
Ci-joint, vous trouverez un fichier excel reprenant l'en-tête correct (il ne reste plus qu'à remplir les colonnes).
Fichier joint
Pour bien remplir le fichier, voici un expliquatif des colonnes :
Parent folder : LAISSER VIDE
Identifier : nom de l'association sans caractères spéciaux (accent, blanc ou autre)
Content type : Shop (rien d'autre)
label_short_name : copier la colonne Identifier
Les autres colonnes sont des champs propres aux commerçants. Cependant, la colonne "Shop Type Type of shop" reprend les type de commerce défini dans la configuration bibliothèques de vocabulaire (il faut y indiquer la clé et non la valeur).
Attention : l'adresse du site web doit être au format http://www.nomdusite.be pour qu'il soit interprèté comme étant un site externe.
Dès que le fichier est correctement remplit et convertit au format csv, il ne vous reste plus qu'à aller dans le dossier qui reprendra vos associations où vous y trouverez un onglet csv import/export.
Où il ne vous reste plus qu'à aller chercher votre fichier csv et cliquer sur import.
En conclusion
Les associations ou les commerçants sont importés.
L'importation d'un fichier reprenant la liste des associations ou la liste des commerçants est relativement facile via le produit csvreplicata. Si vous avec un doute sur la structure du fichier, il vous est toujours possible de créer une association ou un shop, ensuite de l'exporter afin de mieux comprendre l'impact de la configuration que vous aurez faite sur le produit.
Il ne reste plus qu'à créer les types de commerces ainsi que de paramétrer la page des associations afin d'avoir la vue "bottin_association_view" par défaut.
