Comment importer ou exporter des règles de redirection en masse ?

L'import de règles est un moyen productif d'ajouter de nombreuses règles à la fois. redirection.io prend en charge plusieurs formats d'importation, adaptés à divers usages.

• Le CSV de règles de redirection vous permet d'importer des règles de redirection définies dans des fichiers .csv. Ce fichier peut contenir des marqueurs, que vous pouvez utiliser dans le formulaire de création de règle.
• L'import CSV de balises méta est conçue pour importer en masse des règles de balises méta à l'aide d'un fichier .csv.
• L'import JSON vous permet d'importer en masse tous les types de règles, en utilisant un format exhaustif pour vos règles.

Il est également possible de supprimer des règles en masse, en important la liste des identifiants des règles à supprimer.

Import CSV de règles de redirection

L'écran d'import est accessible depuis l'écran "Liste des règles" :

1. Rendez-vous sur le tableau de bord de votre projet
2. Cliquez sur le lien "Règles"
3. Cliquez sur le bouton "Importer", dans le coin supérieur droit de la page, puis choisissez "Importer des règles de redirection (CSV)"
4. Sélectionnez un fichier CSV contenant les redirections que vous souhaitez configurer. L'outil d'import aide à définir le rôle de chaque colonne, l'ordre des colonnes n'est donc pas important.
5. Dans la section "Format et colonnes du fichier", vous pouvez configurer le format du fichier CSV, ignorer la première ligne et choisir pour chaque colonne du fichier CSV le type de données qu'elle contient.
6. L'étape Marqueurs permet de définir les propriétés des chaînes de marqueurs qui ont été incluses dans le fichier. Chaque occurrence d'une chaîne de marqueur sera remplacée par un marqueur redirection.io
7. À l'étape "Exécuter l'import", vous pouvez choisir d'ignorer les erreurs dans le fichier importé. Si cet interrupteur est coché, l'outil d'import fera de son mieux pour importer toutes les règles qu'il est possible et sûr de créer, et il ignorera les erreurs ou les avertissements. Si l'option n'est pas cochée, l'import sera plus strict et échouera complètement même s'il n'y a qu'une seule erreur.
8. Une fois démarrée, la durée de l'import dépend du nombre de règles à importer - cela prend généralement quelques secondes, mais peut prendre plusieurs minutes s'il y a des dizaines de milliers de règles. S'il y a des erreurs dans le fichier d'import, l'outil d'import permettra de télécharger un fichier CSV contenant les lignes erronées, afin que vous puissiez les corriger et essayer à nouveau d'importer le fichier de redirections.

Format du fichier d'import

L'outil d'import de redirection.io est plutôt flexible et permissif. Voici quelques conseils à connaître :

• l'ordre des colonnes n'a pas d'importance ;
• le CSV peut inclure une ligne d'en-tête, ou pas ;
• les imports peuvent inclure des marqueurs ;
• le fichier CSV peut également être utilisé pour créer des réponses 404 ou 410.

L'ordre des colonnes n'est pas important

La seule exigence pour les fichiers importés est le format du fichier, qui doit être un fichier CSV valide.

Une fois que vous avez sélectionné le fichier à importer, l'outil d'import affiche les 100 premières lignes du fichier. Il permet d'ignorer la première ligne (s'il s'agit d'une ligne d'en-tête) et de définir le rôle de chaque colonne. Les rôles de colonnes qui peuvent être mappés sont : URL source, URL cible, Code de statut, Priorité, Balises. Ces colonnes peuvent apparaître dans n'importe quel ordre dans le fichier CSV.

Les trois colonnes suivantes sont obligatoires :

• URL source* : C'est l'URL qui déclenchera une réponse de redirection. Il peut s'agir d'une URL commençant par / ou :// ou http:// ou https://
• URL cible* : C'est l'URL vers laquelle l'utilisateur sera redirigé. Il peut s'agir d'une URL commençant par / ou :// ou http:// ou https://
• Code de statut* : C'est le code de statut à utiliser pour la redirection. Assurez-vous de choisir un code de statut de redirection valide

Il peut y avoir deux colonnes facultatives :

• Priorité : une valeur numérique pour définir la priorité de la règle. Les règles de priorité plus élevée prendront le pas sur celles de priorité inférieure
• Balises : balises séparées par des virgules à associer à la règle

Le fichier CSV peut inclure une ligne d'en-tête, ou non

Le fichier importé peut contenir une ligne d'en-tête, ou non. Lors de l'import, vous pouvez modifier les options d'import pour ignorer la première ligne. Ainsi, ces deux fichiers sont valides pour exécuter un import :

Source URL;Target URL;Status Code
/some-source;/some-target;302
/this-is-not-found;;404
/this-is-gone;;410

et

/some-source;/some-target;302
/this-is-not-found;;404
/this-is-gone;;410

Les fichiers importés peuvent définir des marqueurs

Les marqueurs sont une excellente fonctionnalité de redirection.io pour créer des règles qui peuvent être appliquées à de nombreuses URL à la fois.

À la troisième étape de l'import des règles, vous pouvez définir quelles chaînes doivent être remplacées par un marqueur. Par exemple, vous pourriez importer le fichier CSV suivant :

Source URL;Target URL;Status Code;Priority;Tags
/products/[CATEGORY_NAME];/shop/[CATEGORY_NAME];301;10;shop,category
/products/[CATEGORY_NAME]/[PRODUCT_ID]-[PRODUCT_NAME].html;/shop/[PRODUCT_ID]-[PRODUCT_NAME];301;10;shop,product
/products/[ANYTHING];/shop;302;1;shop

Des chaînes spécifiques ont été utilisées dans le fichier CSV d'exemple :

• [CATEGORY_NAME]
• [PRODUCT_ID]
• [PRODUCT_NAME]

Ces chaînes sont des espaces réservés qui sont remplis lors de l'import avec les marqueurs redirection.io. Cela peut être fait directement à la 3ème étape du formulaire d'import, ou dans la configuration des templates de marqueurs si vous pensez que ces marqueurs seront fréquemment utilisés dans votre projet :

Une fois l'import exécuté, trois règles seront créées avec les marqueurs configurés :

Publiez les règles, et elles seront appliquées à votre site web en quelques secondes.

Les imports peuvent également définir des actions 404 et 410

L'outil d'importation a été conçu pour aider à importer de grandes collections de redirections, mais il peut également être utilisé pour créer des règles avec des actions de code de status personnalisé, par exemple pour renvoyer une 404 ou une 410. Il vous suffit d'ajouter une colonne "Code de statut" dans le fichier CSV :

Source URL;Target URL;Status Code
/some-source;/some-target;302
/this-is-not-found;;404
/this-is-gone;;410

Importer des ensembles de règles très volumineux

L'outil d'import a été conçu pour importer de très grands fichiers de redirection. Le nombre de règles qui peuvent être créées avec un seul import dépend de la taille de chaque URL, mais vous pouvez vous attendre à pouvoir charger environ 500 000 règles de redirection en un seul import, et cela devrait prendre environ 10 minutes pour se terminer.

Lors de l'import de fichiers de redirection volumineux, nous vous conseillons de cocher l'option "Ignorer les erreurs d'import". S'il y a des erreurs dans le fichier, vous pourrez télécharger un fichier CSV à la fin de l'import, ne contenant que les lignes avec des erreurs. Une fois ces erreurs corrigées, vous pourrez ensuite réimporter ce fichier pour que votre plan de redirection soit complété dans les plus brefs délais.

Import CSV de règles de balises méta

Comme pour l'import CSV de redirections, l'import de balises méta est possible via un fichier CSV. Le processus est fondamentalement le même :

1. Rendez-vous sur le tableau de bord de votre projet
2. Cliquez sur le lien "Règles"
3. Cliquez sur le bouton "Importer", dans le coin supérieur droit de la page, puis choisissez "Importer des balises méta (CSV)"
4. Sélectionnez un fichier CSV contenant les balises méta que vous souhaitez configurer. L'outil d'import aide à définir le rôle de chaque colonne, l'ordre des colonnes n'est donc pas important.
5. Dans la section "Format et colonnes du fichier", vous pouvez configurer le format du fichier CSV, ignorer la première ligne et choisir pour chaque colonne du fichier CSV le type de données qu'elle contient.
6. À l'étape suivante, cliquez sur le bouton "Démarrer l'import" et, après quelques secondes, vous devriez voir les règles nouvellement créées apparaître sous la liste des règles. Publiez-les, et les balises méta de votre site web seront mises à jour !

Format du fichier CSV des balises méta

Le fichier importé peut contenir une ligne d'en-tête, ou non, et l'ordre des colonnes n'a pas d'importance. Votre fichier CSV peut même inclure des colonnes que vous ne souhaitez pas importer. Lors de l'import, vous pouvez ajuster les options d'import pour ignorer la première ligne.

Voici un exemple de fichier CSV valide pour l'import de balises méta. Bien sûr, vous pouvez y inclure plus de colonnes :

URL,Title,Description,Tags
/products/gaming-chairs,Gaming Chairs,Comfortable and stylish gaming chairs.,"furniture, gaming, chairs"
/products/laptop-bags,Laptop Bags,Protect your laptop with our durable bags.,"laptop, bags, accessories"
/products/smartphones,,Find the latest smartphones with cutting-edge technology.,"electronics, smartphones, tech"
/products/sports-watches,Sports Watches,Stay active with our sports watch collection.,"sports, watches, accessories"
/products/wireless-earbuds,Wireless Earbuds,Experience premium sound with our wireless earbuds.,"electronics, earbuds, wireless"

Pour faciliter la lecture, voici à quoi ressemble le contenu de ce fichier :

Comme la cellule Title pour l'URL /products/smartphones est vide, la règle créée pour cette URL ne contiendra aucune modification de la balise <title>.

Limites des fichiers importés

La limite de taille des fichiers d'import est assez élevée et dépend principalement de la taille des URL définies dans le fichier. Vous devriez pouvoir importer plusieurs centaines de milliers de règles avec un seul fichier. Si cela ne fonctionne pas, veuillez diviser l'import en plusieurs fichiers plus petits.

Import JSON

L'import JSON est à la fois plus complet et plus compliqué que les fonctions d'import CSV. Ce format d'import vous permet de créer des règles avancées, incluant tous les types de déclencheurs et d'actions pris en charge par redirection.io. D'un autre côté, il peut être un peu délicat à écrire et nécessitera sans aucun doute l'intervention d'un développeur.

Pour faire simple, la syntaxe prise en charge pour le fichier d'import JSON est la même que celle des payloads de l'API publique de redirection.io.

Un bon point de départ, si vous souhaitez écrire un fichier d'import de règles JSON, est d'abord d'exporter votre projet en JSON, de modifier le fichier ainsi téléchargé avant de le réimporter.

1. Sous "Paramètres" > "Règles", localisez le bloc "Export & import de l'ensemble de règles".
2. Cliquez sur le bouton "Exporter l'ensemble de règles en fichier json"
3. Modifiez ce fichier
4. Importez-le en utilisant le bouton "Importer l'ensemble de règles"

Suppression en masse de règles

Vous pouvez supprimer des règles en masse dans le manager de redirection.io de deux manières différentes :

• En sélectionnant des règles à l'aide de filtres : c'est idéal lorsque les règles que vous souhaitez supprimer partagent des propriétés communes.
• En important un fichier TXT ou CSV : cette méthode est utile si vous avez une liste spécifique d'identifiants de règles à supprimer, par exemple pour des règles en doublon ou des règles associées à certaines pages produit.

Suppression de règles à l'aide des filtres

1. Rendez-vous sur la page de la liste des règles
2. Utilisez les filtres pour sélectionner les règles que vous souhaitez supprimer. Par exemple, vous pourriez vouloir supprimer les règles créées il y a plus de deux ans, ou les règles qui n'ont pas été déclenchées au cours de la dernière année
3. En bas de la colonne des filtres, cliquez sur le bouton "Supprimer les règles", puis choisissez l'option "Supprimer les règles sélectionnées"
4. Confirmez la suppression des règles.
5. Les règles sélectionnées seront désormais marquées comme "à supprimer". Elles seront définitivement retirées de la liste des règles de votre projet lors de la prochaine publication.

Suppression de règles avec une liste d'identifiants de règles

Cette seconde méthode est à privilégier lorsque vous ne pouvez pas facilement isoler les règles à supprimer à l'aide de filtres, car elles ne partagent pas de propriétés communes. Par exemple, si vous devez supprimer des règles en double ou des règles liées à un ensemble spécifique de pages produit.

Dans de tels cas, redirection.io vous permet de supprimer des règles en fonction de leurs identifiants (ID). Ces identifiants se trouvent dans le fichier d'exportation CSV des règles.

Le processus global comprend trois étapes :

1. Exportez les règles sous forme de fichier CSV. Ce fichier contient une ligne par règle, avec plusieurs colonnes (URL du trigger, code de statut, cible, date de création de la règle, etc., et bien sûr l'ID de la règle)
2. Modifiez ce fichier pour ne conserver que les règles à supprimer. À l'aide de votre logiciel de feuille de calcul préféré, isolez les lignes des règles que vous souhaitez supprimer
3. Importez ce fichier pour supprimer les règles associées. Enregistrez le fichier CSV modifié et utilisez-le pour supprimer les règles listées.

Une fois que le fichier CSV contient uniquement les règles à supprimer :

1. Rendez-vous sur la page de la liste des règles
2. Cliquez sur le bouton "Supprimer les règles", puis choisissez l'option "Supprimer les règles à l'aide d'un fichier CSV"
3. Choisissez votre fichier CSV modifié
4. Les colonnes du fichier CSV s'afficheront en aperçu. Sélectionnez la colonne qui contient les identifiants de règle ; les autres colonnes seront ignorées
5. Démarrez l'import de ce fichier de suppression de règles
6. En quelques secondes, les règles de votre fichier CSV seront marquées comme "à supprimer". Elles seront définitivement retirées de la liste des règles de votre projet lors de la prochaine publication.

Associer des tags aux règles importées

Par défaut, redirection.io suggère d'associer un tag horodaté aux règles qui sont créées par un import. Vous pouvez ajouter d'autres tags si vous le souhaitez. Nous vous recommandons d'associer toujours des tags aux règles importées, afin de faciliter la gestion des règles dans votre liste de règles à l'avenir. Par exemple, si vous souhaitez trouver toutes les règles créées par un import, il vous suffit de sélectionner le bon tag dans la liste des règles. Ainsi, il sera aisé de supprimer ces règles pour les remplacer par une version qui serait plus à jour.

Exports des logs et des règles

redirection.io permet d'exporter les logs ou les règles sous forme de fichiers CSV. Dans la liste des logs ou dans la liste des règles, choisissez les colonnes à afficher, utilisez les filtres de votre choix, et cliquez sur l'icône "Exporter", en haut à droite de la liste. Cela déclenchera le téléchargement d'un fichier CSV contenant les colonnes choisies, en utilisant les bons filtres.