Importation de données à l’aide d’un fichier CSV avec le module Drupal Feeds

Introduction

Lorsqu’il s’agit de gérer du contenu dans Drupal, le module Feeds offre un moyen puissant et convivial d’importer des données à partir de diverses sources. Dans ce guide, nous nous concentrerons sur la façon d’importer des données à l’aide d’un fichier CSV avec le module Feeds de Drupal 10. Que vous soyez nouveau sur Drupal ou que vous cherchiez à rationaliser votre processus de gestion de contenu, ce didacticiel étape par étape vous aidera. tu te lances.

Pourquoi choisir le module flux pour les importations CSV ?

Le module Feeds se distingue par sa facilité d’utilisation et sa flexibilité. Voici pourquoi vous pourriez opter pour Feeds plutôt que pour d’autres solutions de migration :

• Interface conviviale : Configurez et gérez les importations directement depuis l’interface utilisateur de Drupal, aucun codage requis.
• Sources de données flexibles : Importez à partir de fichiers locaux, de répertoires, d’URL ou d’autres sources.
• Importations planifiées : Gardez vos données à jour automatiquement.
• Prise en charge de plusieurs sources : Gérez facilement diverses sources de données.

Formats de données pris en charge

Le module Feeds prend en charge une variété de formats de fichiers pour les importations de données :

• CSV (Valeurs séparées par des virgules) : Couramment utilisé pour les données de feuilles de calcul.
• TSV (Tab-Separated Values) : similaire au CSV mais utilise des tabulations comme délimiteurs.
• XML (eXtensible Markup Language) : Idéal pour les données structurées et les hiérarchies complexes.
• OPML (Outline Processor Markup Language) : souvent utilisé pour décrire des données ou des flux RSS.

Installation du module de flux

Pour commencer, vous devez installer le module Feeds. Suivez ces étapes :

Install the Module with Composer: Open your terminal and run the following command to install the Feeds module:

composer require 'drupal/feeds'

Enable the Module: After installation, enable the module using Drush or through the Drupal admin interface:

drush en feeds

Configuration du flux d’importation pour CSV

Une fois le module Feeds installé, vous devrez configurer votre configuration d’importation :

1. Accédez aux types de flux : Accédez à admin > structure > types de flux et cliquez sur Ajouter un type de flux.
   

   Ajout d’un type de flux

2. Configurez le flux d’importation : Saisissez un nom et une description pour votre type de flux. Ce nom aidera à identifier le but de l’importateur.
3. Configurer le récupérateur : Le Fetcher détermine la manière dont les données seront importées.
   1. Extensions de fichiers autorisées : txt csv tsv xml opml (nous pouvons ajouter un format de fichier selon nos besoins)
   2. Répertoire de téléchargement : Importez des données à partir de fichiers dans un dossier système.
   3. Fetcher propose plusieurs options pour les flux :
      1. Télécharger à partir de l’URL : Cette méthode récupère les données d’un fichier situé à une URL spécifiée. Il est idéal pour importer des données à partir de sources externes accessibles via HTTP/HTTPS.
      2. Annuaire: Récupère les données des fichiers stockés dans un répertoire désigné sur le serveur. Convient pour accéder aux fichiers régulièrement mis à jour ou gérés dans un dossier de serveur spécifique.
      3. Télécharger le fichier : Permet aux utilisateurs de télécharger un fichier directement depuis leur ordinateur local. Idéal pour les importations manuelles ponctuelles ou les tests avec des fichiers locaux.
4. Configurez l’analyseur : L’analyseur gère le format de vos données source. Pour les fichiers CSV :
   1. Parser lit les données de la source, les interprète en fonction de leur format et les rend disponibles d’une manière structurée avec laquelle Drupal peut travailler.
   2. Ajustez les paramètres de l’onglet Paramètres de l’analyseur pour qu’ils correspondent à la structure de votre fichier CSV.
5. Configurer le processeur : Le processeur crée du contenu dans Drupal sur la base des données importées. Configurez les paramètres du processeur :
   

   Image du processeur de flux

   1. Mettre à jour les éléments de contenu existants : choisissez si vous souhaitez mettre à jour les enregistrements existants.
   2. Insérer de nouveaux éléments de contenu : sélectionnez cette option pour ajouter de nouveaux enregistrements.
   3. Langue : définissez la langue du contenu importé.
   4. Propriétaire : définissez le propriétaire du contenu par défaut.

Mappage des champs de CSV vers Drupal

Image de mappage de flux Drupal

1. Accéder aux paramètres de mappage : Accédez à l’onglet Mappage dans la configuration du type de flux.
2. Mapper la source aux champs cibles :

• Définissez comment les champs de votre CSV (source) correspondent aux champs de Drupal (cible).
• Cliquez sur « Sélectionner une cible » pour choisir le champ Drupal approprié.
• Pour chaque champ cible, cliquez sur Sélectionner une source et choisissez la colonne CSV correspondante.
• Assurez-vous qu’au moins un champ est marqué comme Unique pour éviter les entrées en double.

Exemple Pour mapper une colonne CSV pour un titre à un champ de titre Drupal :
Source: Sélectionnez le nom de la colonne dans le CSV.
Cible: Choisissez le champ Drupal (par exemple, Titre).

3. Enregistrer le mappage : Après avoir configuré les mappages de champs, enregistrez votre configuration.

Importer des données à partir d’un fichier CSV

Une fois votre type de flux configuré, vous êtes prêt à importer des données :

1` Image d’importation de contenu de flux

1. Accédez à Flux : Accédez à Contenu > Flux et cliquez sur le lien +Ajouter un flux.
2. Sélectionnez votre type de flux : Choisissez le type de flux que vous avez configuré pour les importations CSV.
3. Téléchargez votre fichier CSV :
   1. Saisissez un titre pour le flux.
   2. Sélectionnez le fichier CSV que vous souhaitez importer.
   3. Cliquez sur Enregistrer et importer.

4. Surveillez le processus d’importation :
Le module Feeds traitera le fichier CSV et créera ou mettra à jour le contenu en fonction de votre configuration.

Après une importation réussie du flux, accédez à Contenu -> Flux, Modifier le flux et cliquez sur l’onglet Article, vous verrez toutes vos données de flux importées.

Flux Drupal Résultat

Options de personnalisation pour des scénarios spécifiques

Le module Feeds propose également des options de personnalisation pour des scénarios spécifiques :

• Récupérateurs personnalisés : développez ou utilisez des récupérateurs personnalisés pour gérer des sources de données uniques ou des formats non pris en charge par défaut.
• Analyseurs personnalisés : si le format de vos données s’écarte considérablement des formats standard, des analyseurs personnalisés peuvent être créés pour interpréter correctement vos données.
• Processeurs avancés : personnalisez les processeurs pour gérer des transformations de données complexes ou intégrez-les à d’autres modules Drupal.

Pour plus de détails, reportez-vous à ce document drupal.org : https://www.drupal.org/docs/contributed-modules/feeds/creating-a-custom-feeds-workflow

Cas d’utilisation du plugin Feed Tamper

Le module Feed Tamper de Drupal 10 est une extension du module Feeds qui offre des fonctionnalités supplémentaires pour manipuler et transformer les données pendant le processus d’importation. Il permet aux utilisateurs d’appliquer diverses transformations et modifications aux données importées dans Drupal, ce qui peut être particulièrement utile lorsqu’il s’agit de données qui doivent être formatées ou ajustées avant d’être stockées. Cela peut inclure des opérations telles que la modification des formats de données, la concaténation de champs ou l’application d’une logique personnalisée. Essentiellement, Feed Tamper fournit un moyen de prétraiter les données afin qu’elles répondent aux exigences spécifiques de votre site Drupal.

1. Principales fonctionnalités du plugin Feed Tamper
   
   Manipulation des champs : modifiez les valeurs des champs lors de l’importation, par exemple en coupant le texte, en modifiant la casse ou en appliquant des transformations personnalisées.
   Logique conditionnelle : appliquez des modifications en fonction de certaines conditions ou critères, permettant une gestion plus dynamique des données.
   Formatage des données : formatez les données pour qu’elles correspondent aux exigences du champ Drupal ou aux normes spécifiques au site.
   Traitement personnalisé : implémentez des règles de traitement de données complexes à l’aide de plugins ou d’une logique personnalisée.
2. Exemple de cas d’utilisation

Importez des données produit à partir d’un fichier CSV avec des champs tels que nom_produit, description, prix et date.

• Mettre le nom du produit en majuscule : Ajoutez un plugin de falsification « Transformation de texte » pour mettre en majuscule product_name.
• Tronquer la description : Utilisez un plugin « Text truncate » pour limiter la description à 200 caractères.
• Format de prix de conversion : Appliquez un plugin « Remplacer » pour nettoyer les valeurs de prix en supprimant les symboles monétaires.
• Date de format : Utilisez un plugin « Format de date » pour convertir la date de MM/JJ/AAAA en AAAA-MM-JJ.

Conclusion

Dans ce guide, nous avons exploré le processus d’importation de données dans Drupal à l’aide du module Feeds avec un fichier CSV. En tirant parti de la puissance des flux, vous pouvez simplifier la gestion des données et automatiser facilement les mises à jour du contenu. Le composant Parser est essentiel pour transformer vos données CSV brutes dans un format structuré que Drupal peut gérer, garantissant ainsi un processus d’importation fluide et efficace. Que vous gériez un blog, un site de commerce électronique ou tout autre type de site Web Drupal, la maîtrise des importations de données via Feeds peut améliorer considérablement votre flux de gestion de contenu. Avec son interface conviviale et la prise en charge de divers formats de données, Feeds vous permet de garder le contenu de votre site Web frais et dynamique sans codage approfondi.

VOUS TROUVEZ CELA UTILE ? PARTAGEZ-LE