Meilleures pratiques de scriptage

Les informations contenues dans cette page d’aide s’appliquent à la fois à Studio et à Desktop Studio.

Pour vous assurer que vos scripts sont efficaces, suivez ces meilleures pratiques de l'industrie.

Gestion des variables et des fichiers

Tous les noms de variables doivent être significatifs.
Utilisez des caractères de soulignement ( _ ) au lieu d'espaces dans tous les noms de fichiers.
Utilisez des chemins absolus lorsque possible. Ils sont clairs et décrivent exactement où se trouve un fichier. Les chemins absolus sont largement pris en charge dans Studio. Toutefois, certaines actions peuvent uniquement prendre en charge les chemins relatifs. Si vous essayez un chemin absolu et qu'il ne fonctionne pas, mais qu'un chemin relatif fonctionne, utilisez le chemin relatif. Si vous savez que les deux types fonctionnent, il est préférable d'utiliser le chemin absolu.
Utilisez toujours le mot-clé ASSIGN lors de l'attribution d'une valeur à une variable dans une action SNIPPET. Lorsque vous utilisez la recherche avancée, vous pouvez rapidement localiser où une variable a été créée si vous incluez le mot-clé ASSIGN. Sans cela, les résultats de recherche vous montrent chaque instance où la variable apparaît dans votre script.

Chaque script doit avoir un point d'entrée et de sortie clair.

Incluez toujours une action BEGIN. Cela établit le point de départ de l'exécution du script.
Assurez-vous que chaque chemin inclut une action de terminaison. Chaque branche logique devrait éventuellement mener à un point de terminaison approprié afin d'éviter que les scripts ne restent actifs indéfiniment. Il existe plusieurs actions de terminaison selon le type de script.

Les éléments non connectés peuvent encombrer votre logique et faire en sorte que des contacts La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels. restent bloqués.

Supprimez les actions orphelines, c'est-à-dire les actions qui ne sont pas connectées au flux. Celles-ci augmentent votre nombre d'actions et votre score de complexité sans ajouter de valeur.
Connectez la condition de branche Default pour chaque action. Cela permet d'éviter des problèmes lorsque quelque chose d'inattendu se produit et que le script ne peut prendre aucune des autres branches. Pour les actions qui en disposent, se fier à la condition de branche onError peut ne pas être suffisant. Certaines situations peuvent survenir qui ne sont pas des erreurs et qui ne sont pas gérées par les autres conditions de branche. Si vous n'avez pas de branche Default connectée et que quelque chose se produit qui n'est pas couvert par les autres branches, le script et le contact restent bloqués à cet endroit dans le script.
Connectez toutes les branches lorsque vous utilisez des actions de décision comme IF ou CASE, assurez-vous que chaque branche de Sortie est connectée à une destination. Les branches non câblées peuvent provoquer l'échec du script si la logique atteint une branche sans chemin.
Modifiez la propriété Ajouter une légende de chaque action pour l'identifier de manière unique ainsi que ce qu'elle fait dans le script. Cela facilite la lecture et la compréhension du flux d'un script. De plus, les légendes de certaines étiquettes apparaissent dans les rapports, comme le rapport IVR Press Path. Avoir des noms uniques rend les rapports plus utiles.

Des scores de complexité élevés provenant du validateur de script peuvent indiquer un script difficile à dépanner ou à maintenir.

Modularisez les scripts volumineux. Utilisez l'action RUBSUB pour diviser votre script en sous-scripts plus petits et fonctionnels. Ceci est particulièrement utile pour les scripts que le validateur de script classe comme Très Complexes.
Surveillez la profondeur des dépendances afin d'éviter des chaînes d'actions excessivement longues. Si votre logique est trop profonde, cherchez des moyens de simplifier le flux ou utilisez des sous-scripts pour aplatir l'architecture.
Limitez la complexité des branches. Un trop grand nombre de points de décision dans un script unique peut rendre la logique difficile à suivre. Visez un flux propre et lisible.
Utilisez l'action Note et l'action Annotation pour ajouter des commentaires à votre script. Vous pouvez les utiliser pour expliquer le flux du script, le but du script et le raisonnement derrière la logique de script. Vous pouvez également ajouter des commentaires au code Snippet dans les action Snippet. en utilisant deux barres obliques (//).
Revoir la densité des propriétés. Si une action nécessite un nombre inhabituellement élevé de propriétés configurées, vérifiez que l'action est utilisée correctement et qu'elle n'est pas trop complexe. La façon dont vous configurez les actions individuelles a une incidence sur les performances générales du script.

Maintenez de bonnes pratiques de sécurité et de gestion des ressources dans vos scripts.

Utilisez Integration Hub pour stocker les mots de passe, les secrets et les autres informations qui ne doivent pas être incluses dans le script lui-même. Integration Hub peut également être utilisé pour certains appels API.
Effectuez des appels API à l'aide de l'action RESTAPI ou utilisez Integration Hub, ou en utilisant l'une des autres méthodes prises en charge.
Comprenez les limitations et recommandations pour travailler avec du code personnalisé dans une action SNIPPET.
Comprenez l'incidence que le fait de travailler avec des fichiers dans vos scripts peut avoir sur votre système NiCE CXone.