M1 — Administration Redmine

Vérifier que les deux conteneurs sont en cours d’exécution :

docker ps

Résultat attendu :

CONTAINER ID   IMAGE            STATUS         PORTS
xxxxxxxxxxxx   redmine:5.1.12   Up X minutes   0.0.0.0:3000->3000/tcp
xxxxxxxxxxxx   postgres:15      Up X minutes

En cas d’erreur, consulter les logs :

docker compose logs redmine
docker compose logs db

Erreurs fréquentes :

• Port 3000 déjà utilisé → modifier "3000:3000" en "3001:3000" dans le docker-compose.yml

• WSL2 non activé → Panneau de configuration → Activer les fonctionnalités Windows → Sous-système Windows pour Linux

Onglet Général

Onglet Affichage

Onglet Authentification

Onglet API

Vérification fonctionnelle : une fois la clé API générée (Mon compte → Clé d’accès API → Réinitialiser), tester depuis PowerShell :

curl -H "X-Redmine-API-Key: VOTRE_CLE_API" http://localhost:3000/projects.json

Résultats attendus :

• {"projects":[...]} → API active et clé valide

• {"errors":["Accès non autorisé"]} → API active, clé incorrecte

• Page HTML (formulaire de login) → API non activée

Onglet Projets

Onglet Utilisateurs

Laisser les valeurs par défaut :

• Option de notification par défaut : Seulement pour ce que je surveille

• Fuseau horaire : aucun (basé sur le navigateur)

Onglet Suivi des demandes

Onglet Suivi du temps

Onglet Fichiers

Laisser les valeurs par défaut (5120 ko max par fichier, 102400 ko en upload groupé).

Cliquer Sauvegarder après chaque onglet — recharger la page pour vérifier le titre et la langue.

Statuts : Administration → Statuts des demandes

Redmine 5.1 pré-installe “Nouvelle demande” et “Nouveau”. Contrôler la liste existante, puis créer les statuts manquants :

• En cours

• En attente client

• Commentaire

• Résolu

• Fermé (cocher Statut fermé)

• Rejeté (cocher Statut fermé)

Workflow : Administration → Workflow → sélectionner Tracker = Anomalie, Rôle = Développeur → Modifier

Matrice à reproduire :

Sauvegarder, puis vérifier en se connectant avec dev.martin et en changeant le statut d’une demande.

Menu : Administration → Trackers → Nouveau tracker

L’ordre d’affichage se règle avec les flèches haut/bas dans la liste des trackers après création.

Étape complémentaire — retour dans Administration → Configuration → onglet Projets

Maintenant que les trackers existent, définir les trackers activés par défaut pour les nouveaux projets :

• Cocher : Anomalie

• Cocher : Évolution

• Laisser décochés : Demande de service, Tâche interne

Sauvegarder.

Menu : Administration → Rôles et permissions → Nouveau rôle

Chef de projet

Configuration générale :

• Demandes assignables : coché

• Visibilité des demandes : Toutes les demandes non privées

• Visibilité du temps passé : Tous les temps passés

• Visibilité des utilisateurs : Tous les utilisateurs actifs

Permissions — décocher tout, puis cocher uniquement :

Développeur

Configuration générale :

• Demandes assignables : coché

• Visibilité des demandes : Toutes les demandes non privées

• Visibilité du temps passé : Tous les temps passés

• Visibilité des utilisateurs : Tous les utilisateurs actifs

Permissions — décocher tout, puis cocher uniquement :

Client

Configuration générale :

• Demandes assignables : décoché

• Visibilité des demandes : Demandes créées par cet utilisateur

• Visibilité du temps passé : Aucun

• Visibilité des utilisateurs : Membres du projet

Permissions — décocher tout, puis cocher uniquement :

Restriction par tracker — section “Suivi des demandes” en bas du formulaire

Cette section apparaît après les permissions générales. Elle affine les droits par tracker. Conserver la ligne Tous les trackers pour les 3 rôles — ne pas cocher les lignes individuelles (Anomalie, Évolution, Assistance) qui héritent automatiquement.

Chef de projet :

Développeur :

Client :

Menu : Administration → Utilisateurs → Nouveau utilisateur

Pour chaque compte :

1. Renseigner Login, Prénom, Nom, Email (fictif)

2. Définir un mot de passe temporaire (ex : Formation2026!)

3. Cocher Doit changer son mot de passe à la prochaine connexion

4. Statut : Actif

5. Sauvegarder

Vérifier dans Administration → Utilisateurs que les 3 comptes apparaissent avec le statut “Actif”.

Menu : Administration → Listes de valeurs → Activités (suivi du temps) → Nouvelle valeur

Pour chaque activité : saisir le nom, laisser “Actif” coché, laisser “Valeur par défaut” décoché.

Définir “Développement” comme activité par défaut : cocher Valeur par défaut uniquement sur cette entrée.

Vérifier en allant sur un projet → Suivi du temps → Nouvelle entrée : la liste déroulante “Activité” doit afficher les 5 entrées.

Répéter l’opération pour chaque combinaison Tracker / Rôle : Administration → Workflow → sélectionner le tracker et le rôle → Modifier

Évolution / Client — une seule case à cocher :

Demande de service / Client — même matrice qu’Évolution / Client :

Tâche interne / Client — aucune case cochée (matrice vide).

Astuce : utiliser le bouton Copier du workflow pour dupliquer la configuration d’un rôle vers un autre et n’ajuster que les différences. Par exemple, copier Anomalie / Chef de projet vers Évolution / Chef de projet, puis Demande de service / Chef de projet, puis Tâche interne / Chef de projet.

Vérification rapide sans changer de session : Administration → Workflow → sélectionner le tracker et le rôle → Consulter (mode lecture seule).

Réponse attendue à l’étape 2 (création de demande) :

{
  "issue": {
    "id": 42,
    "project": {"id": 1, "name": "Formation Redmine"},
    "tracker": {"id": 1, "name": "Anomalie"},
    "status": {"id": 1, "name": "Nouveau"},
    "priority": {"id": 2, "name": "Normale"},
    "subject": "Anomalie creee via API"
  }
}

Réponse attendue à l’étape 4 : code HTTP 200 OK — corps vide. Vérifier dans l’interface que le statut est bien “En cours” et que la note apparaît dans l’historique.

Erreurs fréquentes :

• 401 Unauthorized → clé API incorrecte ou API REST non activée

• 422 Unprocessable Entity → champ obligatoire manquant (vérifier tracker_id, subject)

• 404 Not Found → project_id ou issue id incorrect

Récupérer les tracker_id de votre instance :

curl -H "X-Redmine-API-Key: VOTRE_CLE_API" `
     http://localhost:3000/trackers.json

Correspondance colonnes CSV → champs Redmine :

Rapport d’import attendu : 10 utilisateurs importés, 0 erreur

Erreur login dupliqué : Redmine affiche Identifiant déjà pris sur la ligne en doublon — les autres lignes sont importées normalement.

Erreur mail manquant : Redmine affiche Email n'est pas valide — la ligne est ignorée.

Après correction du CSV, ré-importer uniquement la ligne corrigée pour éviter les doublons.

Vérifier via Administration → Utilisateurs : filtrer par date de création pour isoler les comptes importés.

Menu : Administration → Champs personnalisés → Nouveau champ → sélectionner “Demandes”

Environnement

• Format : Liste

• Valeurs possibles : saisir chaque valeur sur une ligne séparée

• Cocher les trackers : Anomalie, Demande de service

• Requis : oui — Valeur par défaut : Développement

Référence client

• Format : Texte

• Longueur max : 20

• Expression régulière : ^[A-Z]{2}-[0-9]{4,6}$

• Cocher les trackers : Anomalie, Évolution, Demande de service

• Visibilité : restreindre aux rôles Chef de projet et Client

Criticité métier

• Format : Booléen

• Cocher le tracker : Anomalie uniquement

• Cocher Utilisé comme filtre

Message d’erreur attendu pour ABC dans Référence client : Référence client n'est pas valide

Utilisation du filtre : dans la liste des demandes → Ajouter un filtre → Criticité métier → Oui

Nœud 2 — GET Projets

• Type : HTTP Request

• URL : http://redmine:3000/projects.json

• Authentication : Header Auth

• Header name : X-Redmine-API-Key

• Header value : clé API admin

• Réponse : JSON → $.projects contient le tableau

Nœud 3 — GET Trackers

• Identique, URL : http://redmine:3000/trackers.json

• Réponse : JSON → $.trackers

Nœud 4 — Code (JavaScript)

const projects = $('GET Projets').all().map(i => i.json.projects).flat();
const trackers = $('GET Trackers').all().map(i => i.json.trackers).flat();

const projectRows = projects.map(p => ({
  id: p.id,
  identifier: p.identifier,
  name: p.name,
  description: p.description || '',
  created_on: p.created_on
}));

const trackerRows = trackers.map(t => ({
  id: t.id,
  name: t.name
}));

return [{ json: { projects: projectRows, trackers: trackerRows } }];

Nœud 5 — Lire fichier (Read/Write Files from Disk)

• Opération : Read File(s) From Disk

• Chemin : /data/redmine-export.xlsx

• Le fichier est transmis en binaire au nœud suivant

Nœud 6 — Mettre à jour Excel (Spreadsheet File)

• Opération : Update

• File format : XLSX

• Sheet name : Projets (premier passage), puis dupliquer le nœud pour Trackers

• Input data : relier la sortie du nœud Code

Nœud 7 — Écrire fichier (Read/Write Files from Disk)

• Opération : Write File to Disk

• Chemin : /data/redmine-export.xlsx

• Le fichier écrasé est immédiatement visible sur le disque hôte dans C:\redmine-formation\

URL de téléchargement : après exécution, vérifier directement le fichier sur le disque hôte — inutile de télécharger depuis n8n.