Scripts et plugins
Objectif
Écrire des scripts personnalisés pour un site, une catégorie de compte, un espace de travail ou un site interne, et étendre la connexion ou le traitement de page via les plugins de site.
Prérequis
- Le site ou l'espace de travail cible a été créé.
- Le compte courant dispose des permissions de configuration de site, gestion des plugins ou configuration de site interne.
- La structure des pages et le flux de connexion du site cible sont connus.
Étapes
- Dans la liste des sites, cliquez sur « Gérer les plugins ».
- Créez un plugin en indiquant son nom, sa version, ses remarques et le site associé.
- Téléversez le fichier de plugin ou ouvrez la page de configuration du plugin.
- Ajoutez un script dans la configuration en renseignant le nom, l'URL de correspondance, le type de script, le sélecteur et le contenu.
- Après enregistrement, accédez au site cible avec un compte de test.
- Pour des besoins spécifiques par catégorie de compte, espace de travail ou site interne, ajoutez les scripts dans les pages de configuration correspondantes.
Recommandations de conception
| Élément | Recommandation |
|---|---|
| Nommage | Utiliser le format « site-usage-version », par exemple crm-login-v1 |
| URL de correspondance | Cibler précisément la page de connexion ou le chemin visé, éviter une correspondance globale |
| Sélecteur | Préférer des attributs stables, comme name, data-* ou un ID clair |
| Gestion des erreurs | Prévoir la tolérance aux éléments absents, lenteurs réseau et doubles redirections |
| Remarques de version | Noter la version du site cible, la raison du changement et le compte de test |
Processus de publication
- Écrire le script dans un plugin ou site de test.
- Exécuter le flux complet de connexion avec un compte de test.
- Vérifier que le portail, les liens de collaboration et les espaces de travail se comportent comme prévu.
- Exporter ou documenter la version du plugin.
- Publier sur le site de production et conserver une version de retour arrière.
Validation
- Le nouveau plugin apparaît dans la liste.
- Lors de l'accès au site cible, le plugin ou script s'exécute selon les règles de correspondance.
- Connexion, redirection, remplissage de données ou amélioration de page correspondent au résultat attendu.
- Si le site cible charge lentement ou déclenche une seconde authentification, le script ne bloque pas la page.
Problèmes fréquents
- Les scripts de page conviennent au traitement du DOM, des formulaires et comportements de page.
- Toute modification de plugin doit d'abord être validée en test pour éviter d'affecter la connexion des utilisateurs de production.