Scripts personnalisés et agent de magasin
Ajoutez du JavaScript de vitrine et choisissez les compétences disponibles dans un projet de magasin.
Les scripts personnalisés modifient le comportement de la vitrine, tandis que l’agent de magasin modifie les compétences que Runner peut utiliser pour le projet actuel. Les deux sont des paramètres spécifiques au magasin et doivent être examinés avec soin supplémentaire.
Ce que couvre ce guide
Vous pourrez ajouter et enregistrer un script, le mettre en pause sans le supprimer, et ajouter ou désactiver une compétence pour le projet actuel uniquement.
Disponibilité et conditions préalables
- Ouvrez Paramètres depuis le projet prévu.
- Le JavaScript personnalisé peut modifier le comportement de la vitrine. Ajoutez uniquement le code que vous comprenez et en lequel vous avez confiance.
- Les actions de compétence dépendent des compétences d’espace de travail disponibles et de la possibilité de configurer une compétence système.
- La page Agent complète et la porte du plan contrôlent toujours la disponibilité plus large des compétences.
Chemins d’accès
- Scripts : Paramètres → Store : nom du magasin → Scripts Personnalisés
- Compétences du projet : Paramètres → Store : nom du magasin → Agent
Contrôles des scripts personnalisés
| Entrée ou bouton | Pourquoi c’est utile | Ce qui se passe ensuite |
|---|---|---|
| Ajouter un script | Créez une entrée de script de vitrine. | Une nouvelle ligne de script activée s’ouvre avec du code JavaScript vide. |
| Ligne de script | Développez ou réduisez son éditeur. | Nom du script et Code JavaScript deviennent visibles. |
| Icône d’œil / d’œil caché | Activez ou désactivez un script. | La ligne locale change d’état ; sélectionnez Enregistrer les modifications pour l’appliquer. |
| Icône de suppression | Supprimez un script de la liste en attente. | La ligne disparaît sans deuxième boîte de dialogue ; Enregistrer les modifications applique la suppression. |
| Enregistrer les modifications | Appliquez chaque modification de script en attente. | Runner enregistre la liste complète des scripts et affiche un message de succès ou d’erreur. |
Runner permet jusqu’à dix entrées de script. Le bouton Enregistrer les modifications reste désactivé lorsque rien n’a changé.
Les captures de cette page montrent l’interface en anglais.
L’éditeur vierge vous permet de consulter les champs du script avant l’installation. Aucun script de suivi n’a été enregistré dans cet exemple.
Ajouter ou modifier un script
- Ouvrez Magasin → Scripts Personnalisés.
- Sélectionnez Ajouter un script.
- Entrez un Nom du script clair et un Code JavaScript de confiance.
- Laissez le script activé uniquement s’il doit s’exécuter sur la vitrine.
- Vérifiez toutes les autres lignes car Enregistrer les modifications applique la liste entière.
- Sélectionnez Enregistrer les modifications et attendez Enregistré.
- Vérifiez la vitrine en toute sécurité après l’enregistrement.
Runner essaie d’empêcher une erreur de script de bloquer la page, mais cela ne rend pas le code inconnu sûr. Un script peut toujours affecter la confidentialité, les performances, le suivi et l’expérience client.
Inspectez d’abord un brouillon de script
Pour un premier aperçu, sélectionnez Ajouter un script, nommez-le Store analytics et désactivez son contrôle visuel. Laissez le code vide et ne sélectionnez pas Enregistrer les modifications. Cela vous permet d’identifier l’éditeur et l’état désactivé avant d’ajouter du code provenant d’un fournisseur de confiance. Lorsque vous enregistrez un vrai script, rouvrez la liste et vérifiez à la fois son code et son état activé.
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Pour les compétences du projet, choisissez Agent sous l’en-tête du magasin. Cette image montre son entrée ; il ne montre pas qu’une compétence est ajoutée ou désactivée.
Contrôles de l’agent de magasin
| Entrée ou bouton | Pourquoi c’est utile | Ce qui se passe ensuite |
|---|---|---|
| Ligne de compétence active | Voyez quelle compétence est disponible dans ce projet. | La ligne affiche le nom, la description et le type Système ou Personnalisé. |
| Désactiver | Supprimez une compétence configurable de ce projet uniquement. | La compétence quitte la liste active de ce projet ; elle n’est pas supprimée globalement. |
| Ajouter une compétence | Ajoutez une compétence d’espace de travail disponible à ce projet. | La sélection d’une compétence listée l’active pour le projet actuel. |
| Créer une compétence personnalisée… | Créez une nouvelle capacité personnalisée. | L’éditeur de compétence s’ouvre, puis la liste du projet s’actualise après succès. |
Configurer les compétences du projet
- Ouvrez Magasin → Agent.
- Vérifiez les compétences actuellement actives.
- Sélectionnez Ajouter une compétence, puis choisissez une compétence disponible ou Créer une compétence personnalisée….
- Attendez le message de succès et confirmez que la compétence apparaît.
- Utilisez Désactiver lorsqu’une compétence configurable doit cesser de s’appliquer à ce projet.
- Ouvrez Agent dans la navigation du projet pour obtenir des détails complets sur les compétences, mettre en pause, modifier, importer ou supprimer des actions.
États et limites
- Les modifications de script restent locales jusqu’à ce que Enregistrer les modifications réussisse.
- La suppression d’une ligne de script n’a pas de confirmation séparée avant Enregistrer les modifications.
- L’atteinte de dix scripts désactive Ajouter un script.
- L’agent de magasin peut afficher le chargement, une erreur, Aucune compétence activée ou la liste active.
- Les compétences système fixes n’affichent pas Désactiver.
- La désactivation dans l’agent de magasin modifie la portée de ce projet ; elle ne supprime pas ou ne met pas en pause globalement la compétence.
Dépannage
- Si un script s’exécute toujours, confirmez que son état désactivé a été suivi par Enregistrer les modifications.
- Si l’enregistrement échoue, la liste précédemment enregistrée reste inchangée ; corrigez le code ou réessayez après l’erreur.
- Si Ajouter une compétence n’a pas l’entrée attendue, vérifiez la page Agent complète et le plan actuel.
- Si Désactiver est absent, la compétence système n’est pas configurable pour ce projet.
- Si une nouvelle compétence apparaît globalement mais pas ici, ajoutez-la au projet à partir de l’agent de magasin.