Encodage Base64 pour Multiples Fichiers Binaires via un Code Personnalisé - Workflow n8n

Les développeurs qui doivent téléverser plusieurs fichiers vers une API qui exige strictement l'encodage Base64.
Les utilisateurs de n8n nécessitant une manipulation avancée des fichiers binaires dépassant les capacités des nœuds n8n standards.
Les spécialistes de l'automatisation à la recherche de modèles n8n robustes pour les tâches de conversion de fichiers.
Toute personne souhaitant tirer parti de la puissance du nœud Code de n8n pour le traitement des données.

Ce modèle de workflow n8n spécialisé répond à un défi d'intégration courant : traiter des archives compressées contenant plusieurs fichiers binaires et les convertir en chaînes Base64 pour la consommation par une API. Alors que les nœuds n8n standards gèrent bien l'encodage Base64 d'un fichier unique, le traitement par lots nécessite une logique personnalisée. Ce workflow n8n apporte une solution solide en combinant le téléchargement de fichiers, la décompression, et un nœud n8n soigneusement conçu exécutant du JavaScript pour parcourir les données binaires extraites et effectuer l'encodage requis. Si vous manipulez souvent des données compressées et que vous avez besoin de transformer leur contenu efficacement, ce modèle n8n est indispensable dans votre boîte à outils.

L'ensemble du processus est lancé par une simple déclenchement manuel n8n, ce qui facilite les tests et le déploiement.

1. Démarrage : Le déclencheur n8n 'When clicking ‘Execute workflow’' lance l'exécution de l'automatisation.


2. Téléchargement : Un nœud n8n Requête HTTP télécharge un fichier ZIP d'exemple contenant les fichiers à traiter.


3. Décompression : Le nœud n8n Compression (Unzip) suivant traite automatiquement le fichier binaire téléchargé, déploie son contenu et produit un élément distinct pour chaque fichier trouvé à l'intérieur du ZIP, chacun possédant sa propre propriété binaire.


4. Encodage (Code Personnalisé) : La fonctionnalité centrale réside dans le nœud Code n8n nommé 'Encode to base64'. Ce nœud utilise du JavaScript personnalisé pour itérer sur les multiples éléments binaires créés par le nœud Unzip n8n. Pour chaque élément, il utilise la fonction intégrée this.helpers.getBinaryDataBuffer pour récupérer de manière sécurisée les données du fichier sous forme de tampon (buffer). Ce tampon est ensuite converti en chaîne Base64, et le résultat est structuré proprement pour les nœuds n8n suivants, fournissant le chemin du fichier et les données encodées.

Pour commencer à utiliser ce puissant modèle de workflow n8n, suivez ces étapes :

1. Importation : Copiez les données JSON fournies et accédez à votre instance n8n.


2. Cliquez sur 'Nouveau' puis sur 'Importer depuis JSON' et collez le code.


3. Aucun Identifiant Requis : Ce workflow n8n spécifique ne nécessite pas d'identifiants externes car il utilise des URL publiques et des nœuds internes à n8n (Requête HTTP, Code, Déclenchement Manuel).


4. Exécution : Cliquez sur le bouton de déclenchement n8n 'Execute Workflow' pour tester le processus immédiatement.


5. Personnalisation : Modifiez le nœud n8n 'Download n8n demo website zip' pour pointer vers l'URL source de votre fichier ZIP spécifique afin d'adapter le workflow n8n à vos besoins. Si votre API cible requiert une structure de sortie différente, ajustez le JavaScript à l'intérieur du nœud Code n8n en conséquence.

Ce workflow n8n s'appuie sur trois nœuds n8n principaux pour réaliser le traitement et la conversion des fichiers :

When clicking ‘Execute workflow’ (Déclencheur Manuel n8n Trigger)
Fonction : Sert de point de départ pour ce workflow n8n à la demande.
Configuration Clé : Aucune configuration requise ; il sert de simple déclencheur manuel n8n.

Download n8n demo website zip (Nœud Requête HTTP n8n)
Fonction : Télécharge le fichier ZIP source depuis un dépôt GitHub distant. Ceci fournit les données binaires nécessaires au traitement.
Configuration Clé : L'URL est définie sur https://github.com/n8n-io/n8n-demo-website/archive/refs/heads/main.zip. Le format de réponse est critique, il doit être réglé sur file pour traiter les données comme binaires.

Unzip (Nœud Compression n8n)
Fonction : Décompresse le fichier ZIP téléchargé. Ceci est essentiel car il convertit un élément d'entrée (le ZIP) en plusieurs éléments de sortie (les fichiers contenus dans le ZIP), les préparant pour le traitement par lots par le nœud n8n suivant.
Configuration Clé : Utilise les paramètres par défaut pour la décompression.

Encode to base64 (Nœud Code n8n)
Fonction : Itère sur tous les fichiers binaires générés par le nœud Unzip n8n. Il utilise du JavaScript personnalisé et les assistants n8n (this.helpers.getBinaryDataBuffer) pour récupérer le tampon brut de chaque fichier, puis convertit ce tampon en une chaîne Base64, compilant les résultats dans un tableau JSON structuré.
Configuration Clé : Contient la logique personnalisée pour l'encodage Base64, assurant un traitement efficace de multiples fichiers binaires en une seule étape dans le workflow n8n.