Fonctionnalités
Un utilisateur Baleen peut :
- Configurer une règle de réécriture
- Rechercher une règle
- Supprimer une règle
- Modifier une règle
- Exemples
Ces règles permettent aux utilisateurs de continuer à accéder à un contenu déplacé en toute transparence.
Notes :
- Si le service de gestion de cache est activé, l'ajout/modification/suppression de règles prendra effet au clic sur valider
- Si le service de gestion de cache est désactivé, l'ajout/modification/suppression de règles prendra effet à la réactivation du service.
Il est possible d'accéder rapidement à la section de configuration des règles de réécriture "Règles de réécriture" grâce au menu rapide disponible à droite de la page.
Configurer une règle de réécriture
Pour ajouter une règle de réécriture :
- Cliquer sur l'onglet "Paramétrage -> Gestion du contenu"
- Cliquer sur le bouton "Ajouter une nouvelle règle" depuis la section Règles de réécriture.
- Remplir les informations de la pop up :
- Pattern d'URL (Format PCRE)
- Pattern de réécriture (Format PCRE)
- Gestion des paramètres dURL (QueryString)
- Conserver les paramètres d'URL
- Supprimer les paramètres d'URL
- Cliquer sur Ajouter
- La règle s'affiche dans le tableau des règles de réécriture
Lorsqu’un utilisateur voudra accéder à l’URL source, il sera alors redirigé vers l’URL cible automatiquement.
Les différentes réécriture prises en compte sont les suivantes :
- Simple réécriture au sein du même domaine
- Réécriture au sein du même domaine de patterns
- Réécriture au sein du même domaine avec possibilité de capturer des groupes (queryString, extension, ...)
- Ordre de réécriture : si une réécriture appartient à deux règles définies, alors c’est la règle dont la source est la plus précise qui l’emportera.
Lorsque l'option "Conserver les paramètres d'URL" est choisie, les paramètres d'URL source seront alors transmis à l'URL cible. Il est pas possible de supprimer la prise en compte des paramètres en sélectionnant l'option "Supprimer les paramètres d'URL". (voir Exemples)
Rechercher une règle de réécriture
Si des règles ont été ajoutées précédemment, une barre de Recherche "Rechercher parmi les règles existantes", au dessus du tableau des règles, permet de rechercher une règle spécifique par le nom du pattern d'URL :
- Commencer à taper le nom du pattern d'URL
- Le tableau s'actualise alors pour afficher les pattern correspondants.
Il est également possible de trier la liste de règles :
- En jouant avec les flèches disponibles à droite de la colonne URL l'origine pour trier la liste en fonction du nom de l'URL source par ordre alphabétique (croissant ou décroissant)
- En jouant avec les flèches disponibles à droite de la colonne Pattern de réécriture pour trier la liste en fonction du pattern de destination par ordre alphabétique (croissant ou décroissant)
Supprimer une règle de réécriture
Pour supprimer une règle :
- Cliquer sur le bouton de suppression à côté du nom de la règle à supprimer
- Valider
Modifier une règle de réécriture
Pour modifier une règle :
- Cliquer sur le bouton de modification à côté du nom de la règle à modifier
- La pop up de modification de la règle de réécriture s'affiche
- Modifier le pattern d'URL, de réécriture ou la gestion des paramètres d'URL
- Cliquer sur Ajouter pour valider la modification.
Exemples
Exemple de simple réécriture au sein du même domaine :
Exemple :
>> Règle configurée :
- Pattern source : /url_rewriting/rules.html
- Pattern de réécriture: /rewriting_rules.html
>> Comportement observé :
- URL Saisie : https://mywebsite.com/url_rewriting/rules.html
- Résultat : https://mywebsite.com/rewriting_rules.html
Exemple de réécriture au sein du même domaine de patterns :
Exemple :
>> Règle configurée :
- Pattern source : /url_rewriting/.*\.js$
- Pattern de réécriture: /js/script.js
>> Comportement observé :
- URL Saisie : https://mywebsite.com/url_rewriting/script.js
- Résultat : https://mywebsite.com/js/script.js
Exemple de réécriture au sein du même domaine avec possibilité de capturer des groupes :
Exemple 1: Paramètres d'URL transmis
>> Règle configurée :
- Pattern source : /rewriting.html
- Pattern de réécriture: /rewriting_with_qs.html
- Conserver les paramètres d'URL : coché
>> Comportement observé :
- URL Saisie : https://mywebsite.com/rewriting.html?id=baleen
- Résultat : https://mywebsite.com/rewriting_with_qs.html?id=baleen
Exemple 2 : Paramètres d'URL non transmis
>> Règle configurée :
- Pattern source : /rewriting.html
- Pattern de réécriture: /rewriting_with_qs.html
- Supprimer les paramètres d'URL : coché
>> Comportement observé :
- URL Saisie : https://mywebsite.com/rewriting.html?id=baleen
- Résultat : https://mywebsite.com/rewriting_with_qs.html
Exemple 2: Extension
>> Règle configurée :
- Pattern source : \.([a-zA-Z]{2,4})$
- Pattern de réécriture: /rewriting_extension.$1
>> Comportement observé :
- URL Saisie : https://mywebsite.com/test.js
- Résultat : https://mywebsite.com/rewriting_rules.js
- Ordre de réécriture : si une réécriture appartient à deux règles définies, alors c’est la règle dont la source est la plus précise qui l’emportera.
Exemple 1:
>> Règle A configurée :
- Pattern source : /rewrite_rules/(.*)
- Pattern de réécriture: /global/rewrite/$1
>> Règle B configurée :
- Pattern source : /rewrite_rules/script/js/(.*)
- Pattern de réécriture: /script/rewrite/$1
>> Comportement observé :
- URL Saisie : https://mywebsite.com/rewrite_rules/script/js/main.js
- Résultat : https://mywebsite.com/script/rewrite/main.js
Exemple 2:
>> Règle A configurée :
- Pattern source : /rewrite_rules/(.*)
- Pattern de réécriture: /global/rewrite/$1
>> Règle B configurée :
- Pattern source : /rewrite_rules/script/js/(.*)
- Pattern de réécriture: /script/rewrite/$1
>> Comportement observé :
- URL Saisie : https://mywebsite.com/rewrite_rules/css/style.css
- Résultat : https://mywebsite.com/global/rewrite/style.css