Importer et exporter des producteurs et parcelles

Dans Paramètres → Import et export, préparez des fichiers CSV de producteurs et de parcelles. Chaque type propose un modèle vide, un exemple rempli et l’export des données existantes.

Partir d’un modèle ou d’un export

1. Choisissez Producteurs ou Parcelles.
2. Sélectionnez Télécharger le modèle pour les en-têtes seuls ou Télécharger un exemple pour des lignes remplies. Colonnes et formats explique les champs dans l’application.
3. Exporter les données existantes télécharge les données de l’organisation sélectionnée dans les mêmes colonnes. L’export des parcelles inclut leur géométrie GeoJSON actuelle. Reprenez les identifiants externes des producteurs dans le fichier des parcelles.
4. Remplacez les exemples fictifs du Burkina Faso et du Togo par vos noms, identifiants, cultures et coordonnées. Ce ne sont pas des relevés terrain vérifiés.
5. Importez les producteurs avant les parcelles. Chaque producer_external_id doit déjà exister.

Toutes les pages de l’export sont chargées avant le téléchargement. Une erreur ne produit pas de fichier partiel. Une organisation vide donne uniquement les en-têtes. L’export contient les données de base des producteurs et les versions actuelles des parcelles, y compris les dossiers inactifs existants. Il ne constitue pas une sauvegarde complète de l’historique, des statuts, documents ou évaluations.

Les dossiers existants sont ignorés

L’import crée des dossiers sans les mettre à jour. Les producteurs sont reconnus par identifiant externe ou par nom et pays ; les parcelles par identifiant externe. Conservez l’identifiant d’une parcelle exportée lors du réimport pour éviter une création supplémentaire.

Colonnes des producteurs

Colonne	Obligatoire	Format et signification
name	Oui	Nom du producteur.
country_code	Oui	Code pays à deux lettres, par ex. BF ou TG.
external_id	Non	Identifiant externe unique. Généré par Via si vide.
producer_type	Non	individual, cooperative, estate ou company. Par défaut : individual.
region	Non	Région ou zone administrative, en texte.
locality	Non	Ville ou village, en texte.
address	Non	Adresse, en texte.
postal_code	Non	Texte conservant les zéros initiaux.
phone	Non	Texte, par ex. avec +226 ou +228.
email	Non	Adresse e-mail contenant @.
cooperative	Non	Nom exact d’une coopérative active existante. La créer d’abord ou laisser vide.

external_id,name,country_code
PR-BF-EXAMPLE,Exploitation exemple Burkina Faso,BF

Colonnes des parcelles

Colonne	Obligatoire	Format et signification
producer_external_id	Oui	Identifiant externe exact d’un producteur existant, repris de son export.
name	Oui	Nom de la parcelle.
crop	Oui	Code de culture tel que maize ou cocoa. L’application liste les codes disponibles pour l’organisation. Les libellés traduits ne sont pas des codes.
external_id	Non	Identifiant unique de la parcelle, généré si vide.
area_ha	Pour un point	Surface supérieure à 0 et jusqu’à 4 ha. La surface d’un polygone est calculée depuis sa limite.
latitude	Sans geometry	Latitude WGS84 de −90 à 90, avec longitude.
longitude	Sans geometry	Longitude WGS84 de −180 à 180. Les longitudes ouest sont négatives.
geometry	Alternative aux coordonnées	Géométrie GeoJSON Point ou Polygon, pas un Feature ni une FeatureCollection. Prioritaire sur les colonnes latitude/longitude.
valid_from	Non	Date au format AAAA-MM-JJ. Par défaut : date d’import.

Point ou limite de parcelle

Un point jusqu’à 4 ha nécessite une latitude, une longitude et une surface. Exemple fictif de 3 ha :

producer_external_id,external_id,name,crop,area_ha,latitude,longitude
PR-BF-EXAMPLE,PL-BF-EXAMPLE,Parcelle exemple,maize,3,10.78,-4.42

Au-delà de 4 ha, indiquez une limite polygonale. Les coordonnées GeoJSON utilisent toujours la longitude avant la latitude. Fermez l’anneau en répétant sa première coordonnée à la fin. Le fichier d’exemple contient déjà un polygone correctement cité dans le CSV ; laissez le tableur gérer les guillemets à l’enregistrement.

Vérifier et importer

1. Téléversez le fichier avec Choisir un fichier CSV.
2. Sélectionnez Vérifier. L’aperçu n’écrit aucune donnée.
3. Corrigez les erreurs puis téléversez à nouveau. Les lignes ignorées peuvent correspondre à des identifiants existants, des producteurs inconnus ou des coopératives manquantes.
4. Si l’aperçu est correct, sélectionnez Importer les enregistrements. Les lignes en erreur ou ignorées ne sont pas créées.

Chaque fichier d’import accepte 1 000 lignes de données. Divisez les exports plus grands en conservant les en-têtes dans chaque partie. CSV et TSV acceptent la virgule, le point-virgule ou la tabulation, avec un seul séparateur par fichier. Utilisez UTF-8 pour les accents. Le point décimal est recommandé ; une virgule décimale nécessite des guillemets ou un autre séparateur.

Traitez les identifiants, téléphones et codes postaux comme du texte dans le tableur. L’export protège les textes ressemblant à des formules par une apostrophe initiale ; Via reconnaît et retire ce marqueur lors du réimport. Les guillemets, séparateurs et adresses multilignes sont conservés.

Droits et contrôle

La vérification et l’import nécessitent le droit d’écriture pour le type sélectionné. L’export des producteurs nécessite leur droit de lecture. L’export des parcelles nécessite leur droit de lecture et Exporter les parcelles. L’export reste limité à l’organisation sélectionnée.

Après l’import, vérifiez le producteur associé, les coordonnées et la limite cartographiée. Poursuivez si nécessaire avec le screening forestier et la vérification terrain. L’import d’une géométrie ne constitue pas une évaluation.