Prácticas recomendadas de secuencias de comandos

La información de esta página de ayuda 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 del sector.

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.
Use rutas absolutas siempre que sea posible. Son claras y describen exactamente dónde se encuentra un archivo. Las rutas absolutas son ampliamente compatibles en Studio. Sin embargo, algunas acciones pueden admitir solo rutas relativas. Si intenta usar una ruta absoluta y no funciona, pero una ruta relativa sí, 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 SNIPPET. Cuando usa 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 búsqueda muestran cada instancia en la que aparece la variable en su script.

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

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

Quite las acciones huérfanas, es decir, las acciones que no están conectadas al flujo. Estas aumentan su recuento de acciones y la puntuación de complejidad sin agregar valor.
Conecte la condición de rama predeterminada (Default) 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 únicamente en la condición de rama onError puede no ser suficiente. Pueden ocurrir situaciones que no sean errores y que no estén cubiertas por las demás condiciones de rama. Si no tiene una rama predeterminada conectada y sucede algo que no está cubierto por las demás ramas, el script y el contacto quedan atascados en ese punto del script.
Conecte todas las ramas al usar 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 hacer que el script falle si la lógica llega a una rama sin ruta.
Cambie la propiedad Agregar leyenda de cada acción para identificarla de manera única y lo que hace en el script. Esto facilita la lectura y 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.

Las puntuaciones de complejidad alta del validador de scripts pueden indicar un script que es difícil de solucionar o mantener.

Modularice los scripts grandes. Use la acción RUBSUB para dividir su script en subscripts funcionales más pequeños. Esto es particularmente útil para los scripts que el validador de scripts clasifica como Muy Complejos.
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 use 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 obtener un flujo claro y legible.
Use la Note acción y la Annotation Acción de Anotación para agregar comentarios a su script. Puede usarlas 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 las acciones Snippet acción, usando 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é usando correctamente y que no esté sobrecomplicada. 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 debe incluirse en el script en sí. Integration Hub también se puede usar para algunas llamadas de API.
Realice llamadas de API usando 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.