Aller au contenu

Connecter votre instance au Hub Central

Configurer l’endpoint du Hub Central

Section titled “Configurer l’endpoint du Hub Central”

Le client est préconfiguré avec un enregistrement pointant vers le Hub Central géré par l’Asamblea de Cooperación Por la Paz. Dans la plupart des cas, il n’est pas nécessaire d’y toucher : vérifiez et continuez.

  1. Ouvrez Federación Futuh → Configuración Federación → Hubs configurados (libellés en espagnol dans l’interface).
  2. Vérifiez qu’il existe un enregistrement nommé Hub Central Futuh avec l’URL https://hub.futuh.coop.
  3. Vérifiez que le champ Actif est coché.
  4. Si vous souhaitez vous fédérer avec un Hub alternatif (cas rare : pilotes, tests), modifiez l’URL. Elle doit répondre à l’endpoint /api/v1/canon/healthcheck avec le code 200.

Saisir le jeton d’authentification

Section titled “Saisir le jeton d’authentification”

Le Hub vérifie que votre instance dispose d’une cotisation Futuh active via un jeton Bearer à chaque requête. Le jeton arrive par e-mail lors du renouvellement de la cotisation.

  1. Dans l’enregistrement Hub Central Futuh, ouvrez l’onglet Authentification.
  2. Collez le jeton dans le champ Jeton de fédération. Le champ est de type mot de passe et est chiffré en base de données.
  3. Cliquez sur Tester la connexion. Le message Connexion correcte · Hub répond avec canon_version X.Y.Z doit apparaître.
  4. Enregistrez.

Vérifier les abonnements canon actifs

Section titled “Vérifier les abonnements canon actifs”

Votre instance s’abonne automatiquement aux types canon dont ont besoin les modules installés. Si vous avez Radar, les bases réglementaires BDNS et les attributions arrivent ; si vous avez Incidencia Política, les parlementaires et les commissions arrivent.

  1. Ouvrez Federación Futuh → Configuración Federación → Subscriptions activas.
  2. Vérifiez la liste. Chaque abonnement déclare le modèle de destination, l’URL d’origine et la fréquence de synchronisation.
  3. Vérifiez que les modèles consommés par vos modules apparaissent comme Actifs (quatre ou plus dans une installation typique).
  4. Si un abonnement figure comme En pause, consultez le dernier enregistrement du journal de synchronisation (c’est généralement un jeton expiré ou un changement majeur de version canon).

Configurer la fréquence du cron de pull

Section titled “Configurer la fréquence du cron de pull”

La synchronisation canon s’exécute via une action planifiée quotidienne. Dans la plupart des instances, cela suffit, mais l’intervalle est ajustable.

  1. Ouvrez Paramètres → Technique → Actions planifiées.
  2. Localisez Futuh Federation: Pull diario canon hubs (nom interne _cron_federation_pull_all).
  3. Vérifiez l’intervalle Chaque jour et l’état Actif.
  4. Si vous avez besoin de mises à jour plus fréquentes (campagne avec délais quotidiens), changez l’intervalle à Chaque heure. La charge sur le Hub est modeste.
  5. La deuxième action, Futuh Federation: Healthcheck cada 4h, avertit l’administrateur après trois échecs consécutifs. Laissez-la telle quelle.

Marquer les modifications manuelles sur des données canon

Section titled “Marquer les modifications manuelles sur des données canon”

Quand votre organisation modifie manuellement un enregistrement provenant du Hub (par exemple, vous corrigez l’e-mail d’un parlementaire que le Hub n’a pas encore mis à jour), Futuh marque l’enregistrement comme modifié manuellement et cesse de le remplacer lors des synchronisations suivantes.

  1. Ouvrez n’importe quel enregistrement fédéré (par exemple, un parlementaire dans Contacts → Parlementaires).
  2. Modifiez le champ et enregistrez.
  3. Vérifiez que l’onglet Synchronisation canon affiche le badge Modifié manuellement.
  4. Si vous souhaitez plus tard accepter ce que dit le Hub, cliquez sur Rétablir le canon : le prochain cron remplacera vos modifications.

Résolution des problèmes fréquents

Section titled “Résolution des problèmes fréquents”
  • 403 Forbidden dans le journal de synchronisation → jeton expiré ou révoqué. Remplacez le jeton et cliquez sur Tester la connexion.
  • 404 Not Found sur un modèle précis → l’abonnement pointe vers un canon que le Hub ne publie plus (un changement majeur de version a eu lieu). Consultez l’avis dans l’onglet Messages de l’enregistrement : il contient un lien vers la note de mise à niveau du module d’origine.
  • Cron en état d’échec après une installation récente → après l’installation d’un module qui ajoute des crons, il faut redémarrer le conteneur Odoo pour que le registre se recharge. Si vous ne pouvez pas redémarrer, lancez le cron manuellement une fois depuis Actions planifiées.

Prochaines étapes

Section titled “Prochaines étapes”