Widget de synchro des réseaux

Le widget Grist des réseaux régionaux : comparer sa liste de lieux avec la base nationale, recevoir les modifications faites au national, y envoyer les siennes, ajouter les lieux qui manquent.

À quoi ça sert ?

Beaucoup de réseaux tiennent leur propre liste de tiers-lieux dans Grist. Le widget la compare, lieu par lieu et champ par champ, avec la base nationale, et aide à réconcilier les deux sans copier-coller, dans les deux sens : recevoir dans votre table ce qui a changé au national, envoyer au national ce que vous avez corrigé chez vous.

Widget de synchro ou copie automatique ?

Deux outils différents, à ne pas utiliser ensemble sur la même table :

  • La copie automatique (table « Documents enfants à synchroniser » du document national) dépose dans votre document une table Tiers_Lieux, copie de la base nationale. Chaque modification d’un lieu au national y est appliquée en quelques secondes, sans vous être montrée, et remplace les valeurs de ce lieu.
  • Le widget de synchro travaille sur votre propre table de lieux, dans les deux sens, et rien ne change sans votre clic : vous voyez chaque écart avant de le prendre ou de l’envoyer.

Lequel utiliser ?

  • Vous consultez, analysez ou publiez les lieux sans les modifier : la copie automatique.
  • Vous travaillez vos lieux au quotidien et voulez les échanger avec la base nationale : le widget, sur votre table.
  • Pour démarrer avec le widget : dans une table de lieux, même vide (une colonne texte pour l’identifiant national suffit), menu ⋯ du widget, « Initialiser la table avec le national… » : il la remplit avec les lieux de votre région.

Pour qui ?

Les membres d’un réseau régional qui ont un compte tiers-lieux et une place dans le document national (une ligne dans la table des droits, avec leur région). Être membre du document national suffit pour comparer ; envoyer au national demande d’en être éditeur. Chacun ne voit que les lieux de sa région, et ceux qui n’ont pas de région.

Installer le widget

  1. Dans votre document Grist, sur la page de votre table de lieux, ajoutez un widget personnalisé avec l’adresse https://donnees.tiers-lieux.fr/widgets/synchro
  2. Donnez-lui l’accès complet au document : il lit votre table et y écrit quand vous le lui demandez.
  3. Associez la colonne qui contient l’identifiant national de chaque lieu (obligatoire). Facultatif : une colonne d’état, où le widget note l’état de chaque lieu, et une colonne de date de modification.
  4. Si votre table nomme ses colonnes autrement que le national (« Nom_du_lieu » pour « nom_tiers_lieu », par exemple), associez-les aussi dans le panneau : chaque colonne nationale y a sa liste. Laissez vide celles qui portent le même nom chez vous, elles sont comparées d’office. Les Réglages du widget, bloc Colonnes, montrent ce qui est comparé. On peut aussi y créer une colonne nationale absente de votre table, remplie avec les valeurs nationales, et compléter la liste de choix d’une colonne. Le panneau ne propose que les colonnes du type national (texte, date, choix…) : une colonne d’un autre type se convertit d’abord dans Grist.
  5. Connectez-vous avec votre compte tiers-lieux.
  6. Table encore vide, ou à refaire : menu ⋯ du widget, « Initialiser la table avec le national… ». Toutes ses lignes sont remplacées par les lieux de votre région, et les colonnes qui manquent sont créées, après un avertissement et la saisie du nom de la table.

Ce qu’il montre

  • Une analyse de votre table : lieux à jour, lieux avec des écarts, lieux présents d’un seul côté, paires probables (le même lieu des deux côtés, sans le même identifiant), lieux à corriger selon les règles de qualité, les mêmes que la colonne « À corriger » du national (doublons, adresse différente de la BAN, région manquante…).
  • Dans « à ajouter ici » : d’abord les lieux de votre région, puis, à part, les lieux sans région au national (adresse absente ou non reconnue), à vérifier et à ajouter un par un. Les lieux rejetés au national sont masqués : le bouton « Rejetés » les montre, avec leur motif.
  • Pour le lieu sélectionné : chaque champ, votre valeur et la valeur nationale, côte à côte.
  • L’historique au national, caché par défaut : une petite horloge sur la case nationale d’un écart montre les dernières modifications de ce champ (date, moyen, avant, après), et la date « Modifié au national le … », en tête du lieu, déplie l’historique du lieu.

Ce qu’on peut faire

  • Recevoir les modifications faites au national : la liste des écarts montre les lieux où le national diffère de votre table, et un clic recopie la valeur nationale, pour un champ, pour tout le lieu (« Tout prendre »), ou pour tous les lieux de la liste d’un coup (« Tout prendre du national », après confirmation : les valeurs de votre table sont alors écrasées par celles du national).
  • Envoyer vos modifications au national, lieu par lieu : pour un champ ou pour tout le lieu (« Tout envoyer », après aperçu). Rien ne part au national pour plusieurs lieux d’un coup. Si quelqu’un a changé la valeur nationale entre-temps, rien n’est écrit et le widget vous montre la nouvelle valeur.
  • Ajouter les lieux qui manquent d’un côté ou de l’autre : relier une ligne à son lieu national, ajouter des lieux nationaux dans votre table (un à un, ou tous ceux de la liste avec « Tout ajouter ici »), créer au national un lieu qui n’y est pas, un à la fois (champs obligatoires et adresse vérifiés) : il prend la région de votre compte.

Bon à savoir

  • Les identifiants, les dates de suivi et quelques colonnes gérées par l’équipe nationale ne se modifient pas depuis le widget.
  • Associer une colonne ne règle que son nom : une adresse tenue en un seul champ ne correspond à aucune colonne nationale (le national la découpe en rue, code postal et ville), et une liste de choix doit reprendre les valeurs nationales pour ne pas sortir en écart.
  • Une adresse BAN est vérifiée avec la Base Adresse Nationale avant d’être envoyée : la ville, le code postal, le département, la région, le code INSEE et les coordonnées doivent être ceux de la BAN. S’ils s’en écartent, « Corriger ici et envoyer » les reprend de la BAN dans votre table, puis envoie l’adresse, en un clic.
  • Une adresse BAN ou une adresse saisie à la main, jamais les deux : envoyer une adresse BAN vide l’adresse saisie à la main, dans votre table et au national. Une adresse saisie à la main ne s’envoie que si le national n’a pas d’adresse BAN pour ce lieu.
  • Chaque envoi est noté dans l’historique de la base nationale, au nom de votre réseau.
  • Le widget n’écrit jamais dans votre document ni au national sans votre clic.

Besoin d’aide ?

Contactez Amélie Chapet (achapet@tierslieux-bfc.fr) ou Guillaume Lung-Tung (guillaume@tierslieux.re), du comité data.