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 Futuh Central 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/_health 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 Futuh Central, à l’intérieur du groupe Configuración, repérez le champ Token de autenticación.
  2. Collez le jeton. Le champ s’affiche masqué (type mot de passe) pendant la saisie.
  3. 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 et la route d’origine dans le Hub.
  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 est en pause ou en échec, consultez le dernier enregistrement du Histórico de syncs (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 canon diario (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 hubs (elle s’exécute toutes les 4 heures), 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 Sincronización canon affiche le badge Editado localmente.
  4. Si vous souhaitez plus tard que le Hub mette à jour de nouveau cet enregistrement, contactez l’équipe Futuh : il n’y a pas encore de bouton pour annuler vous-même la modification (retirer la marque Editado localmente nécessite le mode développeur). Un bouton en un clic est prévu dans la feuille de route.

Résolution des problèmes fréquents

Section titled “Résolution des problèmes fréquents”
  • 403 Forbidden dans le Histórico de syncs → jeton expiré ou révoqué. Remplacez le jeton et forcez une synchronisation avec Sincronizar ahora sur un abonnement pour vérifier qu’il fonctionne.
  • 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”