# Jira Ticket Extractor - Mise à jour ## Nouvelles fonctionnalités ### 1. Labels des tickets Les labels sont maintenant automatiquement extraits et affichés dans le tableau avec un design visuel distinctif (badges verts). **Affichage :** - Chaque label apparaît comme un badge individuel - Labels triés et espacés pour une meilleure lisibilité - Si aucun label n'est présent, affiche " - " **Statistiques :** - **Labels différents** : Nombre total de labels uniques dans l'extraction - **Avec labels** : Nombre de tickets qui ont au moins un label ### 2. Go Live Date (Champ personnalisé) Le système supporte maintenant l'extraction et l'édition de dates personnalisées comme la "Go Live Date". **Configuration :** 1. **Identifiez l'ID du champ personnalisé dans Jira :** - Allez dans un ticket Jira - Cliquez sur le paramètre de la date "Go Live Date" - Regardez l'URL ou l'inspecteur d'éléments pour trouver l'ID (ex: `customfield_10206`) - Ou demandez à votre administrateur Jira 2. **Configurez dans le formulaire d'extraction :** - Dans le champ "Champs personnalisés", entrez : `customfield_10206:Go Live Date` - Format : `customfield_ID:NomAffiché` - Pour plusieurs champs, séparez par des virgules : ``` customfield_10206:Go Live Date, customfield_10002:Production Date, customfield_10003:Release Date ``` **Affichage automatique :** - Les colonnes personnalisées sont automatiquement ajoutées au tableau - Les champs contenant "date" dans le nom sont automatiquement formatés - La date est affichée au format français (ex: 15 jan 2025) ### 3. Édition des dates (Due Date & Go Live Date) ⭐ NOUVEAU Vous pouvez maintenant modifier les dates directement depuis l'interface et les mettre à jour dans Jira ! **Comment modifier les dates :** 1. **Extrayez d'abord les tickets** avec les champs personnalisés configurés 2. **Les colonnes de date sont maintenant éditables** : - **Due Date** : toujours éditable - **Go Live Date** (ou tout champ personnalisé contenant "date") : éditable 3. **Sélectionnez une nouvelle date** dans le sélecteur de date 4. **Cliquez sur le bouton "Update"** pour enregistrer les modifications dans Jira **Fonctionnalités de mise à jour :** - Le bouton "Update" est désactivé tant que vous ne modifiez aucune date - Dès que vous changez une date, le bouton s'active - Le bouton affiche un spinner pendant la mise à jour - Un message de confirmation apparaît après une mise à jour réussie - Les modifications sont appliquées en temps réel dans Jira **Exemple :** ``` 1. Entrez : customfield_10206:Go Live Date 2. Cliquez sur "Lancer l'extraction" 3. Modifiez la Due Date ou Go Live Date dans le tableau 4. Cliquez sur "Update" pour envoyer à Jira ``` ### 4. Roadmap Draw.io ⭐ NOUVEAU Générez une roadmap visuelle au format Draw.io (.drawio) importable dans draw.io/diagrams.net ! **Contenu de la roadmap :** - **Ticket Key** : Identifiant du ticket (ex: PROJ-123) - **Summary** : Titre/description du ticket - **Status** : Statut avec code couleur - **Assigné** : Personne responsable du ticket - **Timeline** : - **Début** = Due Date - **Fin** = Go Live Date (customfield_10206) **Comment utiliser :** 1. **Extrayez les tickets** avec au moins la Due Date et idéalement la Go Live Date 2. **Cliquez sur l'onglet "Roadmap"** dans l'interface 3. **Filtrez si nécessaire** : - "Tous les tickets" : Affiche tout - "En cours uniquement" : Seulement les tickets en cours (In Progress) - "Avec dates uniquement" : Seulement les tickets qui ont des dates 4. **Aperçu interactif** : La roadmap est affichée directement dans l'interface 5. **Téléchargez le .drawio** : Cliquez sur "Télécharger le .drawio" 6. **Importez dans Draw.io** : Ouvrez le fichier sur app.diagrams.net **Fonctionnalités :** - Preview interactive dans l'interface - Code couleur selon le statut : - 🟢 Vert : Done/Fermé/Résolu - 🔵 Bleu : En cours/Review - 🟡 Orange : To Do/Open/Backlog - 🔴 Rouge : Bloqué - ⚪ Gris : Autre - Timeline avec dates sur l'axe horizontal - Chaque ticket affiche : Key, Summary, Assigné, Statut - Format XML Draw.io standard, compatible avec draw.io/diagrams.net **Exemple d'utilisation :** ``` 1. Configurez : customfield_10206:Go Live Date 2. Cliquez sur "Lancer l'extraction" 3. Onglet "Roadmap" → Vous voyez la timeline 4. Filtrez si nécessaire (ex: "En cours uniquement") 5. Cliquez sur "Roadmap Draw.io" pour télécharger 6. Importez le fichier sur app.diagrams.net ``` ## Tableau de bord mis à jour Le tableau de statistiques affiche maintenant : - **Tickets** : Nombre total de tickets extraits - **Statuts** : Nombre de statuts différents - **Non assignés** : Tickets sans assigné - **En retard** : Tickets dépassés et non terminés - **Labels différents** : Nombre de labels uniques - **Avec labels** : Tickets ayant au moins un label ## Tableau amélioré Nouvelles colonnes : - **Due Date** : Maintenant éditable avec un sélecteur de date - **Labels** : Affiche tous les labels du ticket sous forme de badges - **Go Live Date** (ou autres champs date) : Éditable si configuré - **Actions** : Bouton "Update" pour envoyer les modifications à Jira - **Colonnes personnalisées** : S'ajoutent automatiquement selon la configuration Nouveaux onglets : - **Tableau** : Vue tabulaire des tickets avec édition des dates - **Roadmap** : Visualisation timeline des tickets et export Draw.io - **JSON Brut** : Données JSON brutes ## Recherche et filtrage La barre de recherche fonctionne maintenant sur : - Résumé, clé du ticket - Statut, assigné, priorité - **Labels** : Vous pouvez chercher un label spécifique - **Go Live Date** et autres champs personnalisés ## JSON brut Les données JSON incluent maintenant : - `labels`: Tableau de tous les labels du ticket - Tous les champs personnalisés configurés ## Exemple d'utilisation ### Extraction simple avec labels : ``` - Username: votre@email.com - API Token: votre-token - Clé du projet: PROJ - Champ personnalisé: (laisser vide pour n'extraire que les labels) ``` ### Extraction et édition avec Go Live Date : ``` - Username: votre@email.com - API Token: votre-token - Clé du projet: PROJ - Champ personnalisé: customfield_10206:Go Live Date ``` Après extraction : 1. Modifiez les dates dans le tableau 2. Cliquez sur "Update" pour synchroniser avec Jira ### Extraction avec plusieurs champs personnalisés : ``` - Champ personnalisé: customfield_10206:Go Live Date, customfield_10002:Production Date, customfield_10003:Release Version ``` ## Démarrage ```bash # Installer les dépendances npm install # Démarrer le serveur npm start ``` Puis ouvrez `index.html` dans votre navigateur. ## Notes importantes - Le serveur (server.js) extrait déjà les labels automatiquement - aucune configuration nécessaire - Les champs personnalisés doivent être explicitement configurés via l'option "customFields" - Les champs personnalisés de type date sont automatiquement reconnus et formatés - Pour modifier des dates dans Jira, assurez-vous que votre utilisateur a les droits d'**écriture** sur les tickets - Les dates sont envoyées à Jira au format ISO (YYYY-MM-DD) - Le bouton "Update" envoie uniquement les champs modifiés pour optimiser les performances