Prácticas recomendadas de secuencias de comandos

La información de esta página de ayuda se aplica tanto a Studio como a Desktop Studio.

Para garantizar que sus Scripts sean eficientes y fáciles de mantener, siga estas prácticas recomendadas de la industria.

Gestión de variables y archivos

Todos los nombres DE variables deben ser significativos.
Utilice caracteres de subrayado (_ ) en lugar de espacios en todos los nombres de archivo.
Utilice rutas absolutas cuando sea posible. SOn claras y describen exactamente dónde se ubica un archivo. Las rutas absolutas SOn ampliamente compatibles en Studio. Sin embargo, es posible que algunas acciones admitan solo rutas relativas. Si intenta una ruta absoluta y no funciona, pero una ruta relativa sí funciona, use la ruta relativa. Si sabe que ambos tipos funcionan, es mejor usar la ruta absoluta.
Siempre use la palabra clave ASSIGN al asignar un valor a una variable en una acción de SNIPPET. Cuando utiliza la búsqueda avanzada, puede ubicar rápidamente dónde se creó una variable si incluye la palabra clave ASSIGN. Sin ella, los resultados de la búsqueda le muestran todas las instancias en las que aparece la variable en su secuencia de comandos.

Cada script debe tener un punto de entrada y un punto de salida claros.

Siempre incluya una acción BEGIN. Esto establece el punto de partida para la ejecución del script.
Asegúrese de que cada ruta incluya una acción de terminación. Cada rama lógica debe conducir finalmente a un punto de terminación adecuado para evitar que los scripts permanezcan activos indefinidamente. Existen varias acciones de terminación según el tipo de script.

Los elementos no conectados pueden saturar su lógica y provocar que los contact The person interacting with an agent, IVR, or bot in your contact center. se queden atascados.

Quite las acciones huérfanas, que SOn acciones que no están conectadas al flujo. Estas aumentan su Action Count y su puntaje de complejidad sin agregar valor.
Conecte la condición de rama Default (predeterminada) para cada acción. Esto ayuda a evitar problemas cuando ocurre algo inesperado y el script no puede tomar ninguna de las otras ramas. Para las acciones que la tienen, confiar en la condición de la rama onError puede no ser suficiente. Puede haber situaciones que ocurran que no sean errores y no sean manejadas por las otras condiciones de bifurcación. Si no tiene conectada una rama Default y ocurre algo que no está contemplado en las demás ramas, el script y el contacto se quedan atascados en ese punto del script.
Conecte todas las ramas cuando use acciones de decisión como IF o CASE, asegúrese de que cada rama de salida esté conectada a un destino. Las ramas no conectadas pueden provocar que el script falle si la lógica llega a una rama sin ninguna ruta.
Cambie la propiedad Agregar leyenda de cada acción para identificarla de forma única y lo que hace en el script. Esto facilita la lectura y la comprensión del flujo de un script. Además, las leyendas de algunas etiquetas aparecen en los informes, como el informe IVR Press Path. Tener nombres únicos hace que los informes sean más útiles.

Puntuaciones de complejidad alta provenientes del validador de script pueden indicar un script que es difícil de solucionar problemas o mantener.

Modularice los scripts grandes. Use la acción RUNSUB para dividir su script en subscripts más pequeños y funcionales. Esto es particularmente útil para los scripts que el validador de scripts clasifica como Muy Complejo.
Supervise la profundidad de dependencia para evitar cadenas de acciones excesivamente largas. Si su lógica es demasiado profunda, busque formas de optimizar el flujo o utilice subscripts para aplanar la arquitectura.
Limite la complejidad de las ramas. Demasiados puntos de decisión en un único script pueden dificultar el seguimiento de la lógica. Procure un flujo claro y fácil de leer.
Utilice la acción Note action y la acción Annotation action para agregar comentarios a su script. Puede utilizarlas para explicar el flujo del script, el propósito del script y el razonamiento detrás de la lógica de scripting. También puede agregar comentarios al código de Snippet en la Snippet action. utilizando DOs barras diagonales (//).
Revise la densidad de propiedades. Si una acción requiere una cantidad inusualmente alta de propiedades configuradas, verifique que la acción se esté utilizando correctamente y que no sea demasiado complicada. La forma en que configura las acciones individuales afecta el rendimiento general del script.

Mantenga buenas prácticas de seguridad y gestión de recursos en sus Scripts.

Use Integration Hub para almacenar contraseñas, secretos y otra información que no deba incluirse en el script mismo. Integration Hub también se puede usar para algunas Llamadas a la API.
Realice Llamadas a la API con la acción RESTAPI o Use Integration Hub, o utilizando uno de los otros métodos admitidos.
Comprenda las limitaciones y recomendaciones para trabajar con código personalizado en una acción SNIPPET.
Comprenda el impacto que puede tener trabajar con archivos en sus Scripts sobre su sistema NiCE CXone.