create page Dépannage : 10 erreurs courantes + procédure rapport bug
+166
@@ -0,0 +1,166 @@
|
||||
# Dépannage
|
||||
|
||||
Cette page liste les erreurs courantes rencontrées avec l'extension Planification et leur solution. Si ton problème n'est pas ici, voir [Contact](Contact) pour ouvrir une issue.
|
||||
|
||||
## Sommaire
|
||||
|
||||
- [« Aucun technicien sélectionné »](#aucun-technicien-selectionne)
|
||||
- [« Session EasyVista expirée »](#session-easyvista-expiree)
|
||||
- [« EasyVista est inaccessible »](#easyvista-est-inaccessible)
|
||||
- [Auto-update Firefox ne fonctionne pas](#auto-update-firefox-ne-fonctionne-pas)
|
||||
- [Popups épinglés disparus après reload](#popups-epingles-disparus-apres-reload)
|
||||
- [Le planning charge mais reste vide](#le-planning-charge-mais-reste-vide)
|
||||
- [Mauvais groupe affiché (SI-CSS au lieu de SI-EXT, etc.)](#mauvais-groupe-affiche)
|
||||
- [Pastille utilisateur reste sur "?"](#pastille-utilisateur-reste-sur-)
|
||||
- [Refresh de l'extension après mise à jour Chrome](#refresh-de-lextension-apres-mise-a-jour-chrome)
|
||||
- [Récupérer les logs détaillés pour un rapport de bug](#recuperer-les-logs-detaillees-pour-un-rapport-de-bug)
|
||||
|
||||
---
|
||||
|
||||
## « Aucun technicien sélectionné »
|
||||
|
||||
**Symptôme** : message en grand au milieu de l'extension :
|
||||
> *"Aucun technicien sélectionné. Ouvrez ⚙ Paramètres → Équipe pour choisir le groupe EasyVista et cocher les techniciens à afficher."*
|
||||
|
||||
**Cause** : depuis v2026.5.41, l'extension ne livre plus aucun technicien hardcodé. Au 1er install (ou après "Réinitialiser la configuration"), `cfg.team` est vide → le service worker refuse de fetcher avec une équipe vide et lève l'erreur `no_team_configured`.
|
||||
|
||||
**Solution** : voir [Configuration initiale (1er install)](Utilisation#configuration-initiale-1er-install) sur le guide Utilisation. En 30 secondes : pastille initiales → ⚙ Paramètres → Équipe → choisir groupe → cocher les techs → 💾 Enregistrer.
|
||||
|
||||
---
|
||||
|
||||
## « Session EasyVista expirée »
|
||||
|
||||
**Symptôme** : bannière en haut ou écran plein indiquant que la session a expiré, parfois suivi d'un compteur MM:SS qui passe en rouge.
|
||||
|
||||
**Cause** : EasyVista déconnecte automatiquement les sessions inactives après ~30 minutes. L'extension détecte ça quand un fetch retourne 401/403 ou une page de login.
|
||||
|
||||
**Solutions** (par ordre rapide) :
|
||||
1. Cliquer **🔄 Prolonger** dans la pastille utilisateur (popup haut gauche) — envoie un keep-alive et remet le compteur à 30 min.
|
||||
2. Si déjà expirée : cliquer **Ouvrir EasyVista** dans la bannière → te reconnecter via SSO Canton → revenir sur l'onglet Planification → l'extension détecte la nouvelle session automatiquement.
|
||||
3. En télétravail externe : faut passer par `itsma.vd.ch` avec ton compte ForgeRock OpenAM (le SSO Kerberos interne ne fonctionne que sur le LAN DGNSI).
|
||||
|
||||
---
|
||||
|
||||
## « EasyVista est inaccessible »
|
||||
|
||||
**Symptôme** : bannière orange "EasyVista est inaccessible. Données affichées depuis le cache."
|
||||
|
||||
**Causes possibles** :
|
||||
- Maintenance EasyVista côté Canton (rare mais arrive).
|
||||
- Réseau coupé / VPN tombé pour les techs en télétravail.
|
||||
- Bug temporaire EV (timeout, erreur 500).
|
||||
|
||||
**Solutions** :
|
||||
1. Cliquer **Réessayer** dans la bannière (réessaye le fetch sans recharger toute l'extension).
|
||||
2. Vérifier dans un autre onglet que `https://itsma.etat-de-vaud.ch/` ou `https://itsma.vd.ch/` répond.
|
||||
3. Si EV répond : peut-être un problème de session — voir [Session EasyVista expirée](#session-easyvista-expiree).
|
||||
4. Si EV ne répond pas : attendre, c'est probablement temporaire. L'extension continue d'afficher le cache local pendant ce temps.
|
||||
|
||||
---
|
||||
|
||||
## Auto-update Firefox ne fonctionne pas
|
||||
|
||||
**Symptôme** : tu sais qu'une nouvelle version est sortie (collègue qui l'a, mention dans un message), mais ton extension reste sur l'ancienne version même après plusieurs jours.
|
||||
|
||||
**Cause** : Firefox vérifie `firefox-updates.json` toutes les ~24 h. Plusieurs raisons peuvent empêcher la détection :
|
||||
- Tu as installé un `.xpi` **non signé** (mode développeur) — ces extensions ne s'auto-updatent pas.
|
||||
- Le navigateur n'a pas eu de fenêtre temporelle pour faire le check (Firefox fermé pendant des jours).
|
||||
- Le proxy / pare-feu bloque les requêtes vers `gitea.netaplaid.ch`.
|
||||
|
||||
**Solutions** :
|
||||
1. Vérifier la version installée : `about:addons` → cliquer sur "Planification" → onglet "Détails" → numéro de version.
|
||||
2. Forcer la vérification : `about:addons` → menu ⚙ (en haut à droite) → "Vérifier les mises à jour".
|
||||
3. Si pas de mise à jour proposée : vérifier que l'extension est bien signée Mozilla (`about:addons` doit afficher un badge bleu de vérification, pas un avertissement).
|
||||
4. En dernier recours : retélécharger manuellement le `.xpi` signé depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases/latest), drag-and-drop dans `about:addons`.
|
||||
|
||||
➡ **Chrome / Edge** : il n'y a **PAS d'auto-update**. Tu dois toujours retélécharger le `.zip` manuellement à chaque nouvelle version, écraser ton dossier d'install, puis cliquer ⟳ (Recharger) dans `chrome://extensions/`.
|
||||
|
||||
---
|
||||
|
||||
## Popups épinglés disparus après reload
|
||||
|
||||
**Symptôme** : tu avais épinglé une ou plusieurs popups d'intervention (📌), tu rafraîchis le planning ou tu changes de date, et les popups épinglés ont disparu.
|
||||
|
||||
**Cause** : les popups épinglés ne sont **pas persistés entre les rafraîchissements** ni entre les changements de date. C'est un comportement voulu (un popup épinglé est lié à une intervention spécifique d'un jour donné).
|
||||
|
||||
**Solutions** :
|
||||
- Pour garder une vue détaillée d'une intervention : utiliser plutôt le bouton **"Ouvrir"** du popup pour ouvrir la fiche EasyVista dans un nouvel onglet, qui survit aux rafraîchissements.
|
||||
- Pour avoir plusieurs interventions visibles en même temps : utiliser la **vue horizontale** (toggle ⊞ Vue dans la pastille utilisateur), qui montre plus d'infos à la fois.
|
||||
|
||||
---
|
||||
|
||||
## Le planning charge mais reste vide
|
||||
|
||||
**Symptôme** : pas d'erreur, pas de bannière, l'icône de chargement se finit, mais aucune carte de tech n'apparaît.
|
||||
|
||||
**Causes possibles** :
|
||||
1. **Aucun tech coché** dans Paramètres → Équipe → voir [« Aucun technicien sélectionné »](#aucun-technicien-selectionne).
|
||||
2. **Mauvais groupe** sélectionné — voir [Mauvais groupe affiché](#mauvais-groupe-affiche).
|
||||
3. **Date sans planning** : aucun tech n'a d'intervention ni d'absence ce jour-là (rare mais possible un jour férié).
|
||||
4. **Filtre absences** : si tu as la vue horizontale et tous les techs sont absents (vacances scolaires…), ils peuvent être visuellement très condensés.
|
||||
|
||||
**Diagnostic** : ouvre **⚙ Paramètres → Diagnostics** et regarde :
|
||||
- "Date courante" / "Aujourd'hui"
|
||||
- "Session EasyVista" — doit afficher "✓ connecté"
|
||||
- Active **"Logs verbeux"** et regarde la console (F12) pour voir si les fetches passent.
|
||||
|
||||
---
|
||||
|
||||
## Mauvais groupe affiché
|
||||
|
||||
**Symptôme** : tu vois SI-CSS alors que tu travailles dans SI-EXT (ou inverse).
|
||||
|
||||
**Cause** : depuis v2026.5.40 le groupe est configurable. Si tu n'as rien changé depuis le 1er install, tu es sur le défaut SI-CSS (id `191`).
|
||||
|
||||
**Solution** : pastille initiales → ⚙ Paramètres → onglet **Équipe** → sélecteur **"Groupe EasyVista"** en tête → choisir SI-EXT (ou autre). La liste des techs en dessous se rafraîchit automatiquement avec les membres du nouveau groupe. Coche ceux à afficher → 💾 Enregistrer.
|
||||
|
||||
---
|
||||
|
||||
## Pastille utilisateur reste sur "?"
|
||||
|
||||
**Symptôme** : la pastille en haut à gauche affiche "?" au lieu de tes initiales, même après quelques minutes.
|
||||
|
||||
**Cause** : l'extension n'arrive pas à identifier ton utilisateur EasyVista (échec du parsing de la page d'accueil EV après login).
|
||||
|
||||
**Solutions** :
|
||||
1. Vérifier que tu es bien connecté à EV dans un autre onglet.
|
||||
2. Recharger l'extension : `about:addons` ou `chrome://extensions` → ⟳.
|
||||
3. Si le problème persiste : ouvrir une [issue](https://gitea.netaplaid.ch/FroSteel/Planification/issues/new) avec les logs verbeux activés (Diagnostics → Logs verbeux).
|
||||
|
||||
L'extension retente automatiquement la détection toutes les 60 s (max 10 essais), mais une fois échouée, elle abandonne et la pastille reste "?".
|
||||
|
||||
---
|
||||
|
||||
## Refresh de l'extension après mise à jour Chrome
|
||||
|
||||
**Symptôme** : tu as téléchargé une nouvelle version `.zip` Chromium et écrasé ton dossier d'install, mais Chrome affiche toujours l'ancienne version.
|
||||
|
||||
**Cause** : Chrome ne détecte pas automatiquement le changement de fichiers dans un dossier "non empaquetée".
|
||||
|
||||
**Solution** :
|
||||
1. `chrome://extensions/` (ou `edge://extensions/`).
|
||||
2. Trouver la carte "Planification".
|
||||
3. Cliquer le bouton **⟳ (Recharger)** sur la carte (icône circulaire).
|
||||
4. La version affichée doit maintenant correspondre à la nouvelle.
|
||||
|
||||
Si toujours l'ancienne : redémarrer entièrement Chrome après le ⟳.
|
||||
|
||||
---
|
||||
|
||||
## Récupérer les logs détaillés pour un rapport de bug
|
||||
|
||||
Si tu rencontres un bug et que tu veux en faire un rapport propre :
|
||||
|
||||
1. **Activer les logs verbeux** : pastille initiales → ⚙ Paramètres → onglet **Diagnostics** → toggle **"Logs verbeux (debug)"** sur ON.
|
||||
2. **Reproduire** le bug.
|
||||
3. **Ouvrir DevTools** : `F12` (ou clic droit dans la fenêtre extension → Inspecter).
|
||||
4. **Onglet Console** : sélectionner tous les logs (`Cmd+A` ou `Ctrl+A`), copier (`Cmd+C` / `Ctrl+C`).
|
||||
5. **[Ouvrir une issue](https://gitea.netaplaid.ch/FroSteel/Planification/issues/new)** avec :
|
||||
- Description courte du bug
|
||||
- Étapes pour reproduire
|
||||
- Capture d'écran de ce qui pose problème
|
||||
- Logs console copiés (entre triple backticks ``` pour le formatage)
|
||||
- Version de l'extension (visible dans Paramètres → À propos)
|
||||
- Navigateur + OS
|
||||
|
||||
Les logs sont préfixés `[HH:MM:SS.mmm][vX.Y.Z][module][LEVEL]` ce qui permet à l'auteur de retrouver rapidement la cause sans devoir reproduire localement.
|
||||
Reference in New Issue
Block a user