Exportation des données Zammad vers des fichiers Excel structurés - Workflow n8n

Administrateurs système Zammad ayant besoin de sauvegardes régulières ou de migrations de données.
Analystes de données chargés d'auditer ou de générer des rapports sur les attributions d'utilisateurs, de rôles et de groupes Zammad.
Utilisateurs n8n à la recherche de modèles n8n pratiques démontrant la manipulation complexe de données et le traitement multi-chemins.
Développeurs ayant besoin d'extraire des données de configuration via une combinaison automatisée de nœuds n8n.

La gestion des données Zammad, en particulier pour l'audit ou le reporting en masse, nécessite souvent l'exportation d'objets clés tels que les utilisateurs et les rôles. Ce workflow n8n complet résout le problème fastidieux de l'exportation manuelle en fournissant un chemin d'exécution unique et automatisé. Il extrait simultanément quatre types de données principaux — Utilisateurs, Organisations, Rôles et Groupes — en utilisant à la fois des connexions de nœuds Zammad n8n dédiées et des Requêtes HTTP flexibles.

La valeur fondamentale de ce modèle n8n réside dans son parallélisme et la standardisation des données. Après avoir récupéré les données brutes, des opérations dédiées du nœud n8n 'Set' nettoient et standardisent la sortie pour chaque type d'objet (par exemple, mapper les identifiants de groupe et combiner les identifiants de rôle pour les utilisateurs). Enfin, les flux de données nettoyés sont convertis directement en fichiers XLSX distincts, prêts à l'emploi, démontrant une utilisation efficace du nœud n8n de conversion de fichiers.

Ce workflow n8n commence par le déclencheur (trigger) n8n 'Manual Trigger', permettant une exécution à la demande.

1. Configuration des variables : Le processus utilise d'abord un nœud n8n 'Set' ('Basic Variables') pour définir l'zammadbaseurl et la zammadapikey. Ces variables sont essentielles pour les nœuds HTTP Request ultérieurs.


2. Extraction de données en parallèle : Le workflow n8n se divise en quatre branches parallèles pour récupérer les données :

1. Structuration des données : Quatre opérations dédiées du nœud n8n 'Set' (par exemple, 'Zammad Univeral User Object') normalisent les données JSON récupérées. Par exemple, le nœud Set Utilisateur consolide les identifiants de rôle et de groupe en chaînes de caractères propres, rendant les données compatibles avec les feuilles de calcul.


2. Contrôle de flux : Des portes logiques (gates) de nœuds n8n 'If' servent de remplacement pour s'assurer que les données existent avant de continuer. Ces nœuds sont inclus dans ce modèle n8n pour une personnalisation facile, permettant aux utilisateurs d'implémenter des critères de filtrage spécifiques (par exemple, n'exporter que les utilisateurs actifs).


3. Conversion de fichiers : Enfin, quatre opérations de nœud n8n 'Convert to File' convertissent chaque flux de données structuré en son fichier XLSX correspondant (ZammadUsers.xslx, ZammadOrganizations.xlsx, etc.), achevant l'automatisation complète grâce à cette structure de workflow n8n efficace.

Pour déployer ce workflow n8n, suivez ces étapes :

1. Importation : Copiez le code JSON fourni et importez-le directement dans votre instance n8n en utilisant le menu 'Nouveau' et en sélectionnant 'Importer depuis JSON'.


2. Informations d'identification Zammad (Credentials) : Ce workflow n8n utilise deux méthodes pour la connexion Zammad :

1. Test : Exécutez le workflow n8n à l'aide du bouton 'Tester le workflow'. Les fichiers XLSX résultants seront disponibles dans la sortie des étapes finales du nœud n8n 'Convert to Excel'.

Manual Trigger (déclencheur n8n) : Initie l'intégralité du processus d'exportation des données manuellement.
Basic Variables (nœud Set n8n) : Configuration essentielle pour les requêtes HTTP. Il injecte de manière sécurisée l'URL de base et la clé API Zammad en tant que variables de flux (zammadbaseurl, zammadapikey) à utiliser par les étapes de nœud HTTP Request n8n suivantes.
Get all Users / Get all Organizations (nœud Zammad n8n) : Utilise l'information d'identification Zammad dédiée pour récupérer tous les éléments de la ressource sélectionnée avec l'opération getAll.
Get all Roles / Get all Groups (nœud HTTP Request n8n) : Récupère les données de rôles et de groupes en utilisant une URL dynamique et une authentification par jeton porteur (bearer token), tirant les valeurs de la configuration du nœud n8n Basic Variables.
Zammad Univeral User Object (nœud Set n8n) : Transforme les données utilisateur brutes. La configuration clé comprend le mappage des tableaux roleids et groupids en chaînes séparées par des virgules en utilisant l'expression JSON ={{ $json.roleids.join() }}.
Filter X if needed (nœud If n8n) : Utilisé comme porte de contrôle de flux standard. Actuellement configuré pour vérifier si l'objet d'entrée existe, agissant comme un passage direct, mais prêt pour une logique de filtrage personnalisée.

• Convert to Excel X (nœud Convert to File n8n) : Action finale de ce workflow n8n. Il prend le tableau JSON standardisé et le génère en tant que fichier XLSX, attribuant des noms de fichiers uniques comme ZammadUsers.xslx et Zammad_Roles.xlsx.