Depurar Scripts en Desktop Studio

Esta página de ayuda corresponde a Desktop Studio. Esta información también está disponible para Studio.

Permisos requeridos: ACD > Studio > Scripts > Depurar

Studio proporciona DOs formas de verificar si hay problemas en sus scripts:

  • Revise si hay errores de sintaxis.
  • Ejecute un seguimiento del script, que le muestra lo que sucede conforme el script procesa cada acción.

Si tiene acciones de Snippet en su script, puede depurar el código del snippet desde la ventana del Snippet editor.

Buscar Errores de sintaxis

Cuando verifica si hay errores de sintaxis, los problemas encontrados en su script aparecen en la pestaña Script Errors . La pestaña muestra todas las advertencias y Errores relacionados con su script, incluso en los fragmentos. Las Advertencias no impiden que su script se ejecute o se guarde, pero los errores sí lo hacen. La mejor práctica es abordar todas las advertencias antes de poner el script en producción, aunque estas no impidan que el script funcione.

Las verificaciones de sintaxis se realizan automáticamente al guardar un script, pero puede ejecutar una verificación de sintaxis en cualquier momento que desee. No podrá ejecutar ni guardar un script que contenga errores. Si intenta ejecutar o guardar un script que tiene errores, Studio muestra una ventana de notificación. Puede consultar la pestaña Script Errors para obtener más información. Los Errores pueden incluir cosas como:

  • Variables mal escritas. Por ejemplo: Línea 2 de Snippet. Función: NameLabel no se ha definido.
  • El uso de una función como parámetro de un método. Por ejemplo: parámetros de función sin terminar.
  • Usar un tipo de datos incorrecto en una función que demanda un tipo específico de datos. Por ejemplo: parámetros de función sin terminar.

Puede que existan algunos errores que no aparezcan en la pestaña Script Errors. Algunos errores de validación aparecen en una ventana de notificación de Errores con detalles sobre el error. Errores de validación incluyen cosas como JSON no válido en la REST API acción. Si intenta guardar cuando el script contiene un error de validación, el script puede revertir a la versión más reciente del script sin el error de validación. Si esto sucede, se perderán todos los cambios no guardados.

Haga doble clic en cualquier advertencia o error en la pestaña Script Errors para ver la acción en el lienzo donde ocurre la incidencia.

  1. En Studio, abre un script.
  2. Haga clic en Validation > Syntax Check.
  3. Haga clic en la pestaña Script Errores para ver los resultados de la verificación de sintaxis.
  4. Haga doble clic en cualquier advertencia o error en la pestaña Script Errors para ver la acción en el lienzo donde ocurre la incidencia.

Seguimientos del Script

Puede hacer seguimiento del rendimiento de su script, generar un script o realizar una llamada de prueba con la herramienta . Esta herramienta rastrea el contacto o el script en ejecución y muestra cada acción que se activó, qué variables se están creando y cuándo, y los valores que tenían las variables en cada punto. Esta es una herramienta útil para probar y depurar sus scripts. Puede ejecutar trazas en interacciones en vivo o simulado.

Sólo puede capturar un seguimiento si se guarda el script. Si intenta capturar un seguimiento del script en un script con cambios sin guardar, Studio le pide que guarde el script. Si tiene errores de compilación en el script, Studio no guardará el script. Debe resolver los errores antes de poder guardar el script y ejecutar el seguimiento. Cualquier errores de validación en el script hacen que Studio revierta a la última versión del script sin el error de validación.' Si ha iniciado un seguimiento, este se ejecuta, pero se ejecutará con la última versión Guardada del script.

Utilice la ventana Trace Output

Cuando ejecuta un seguimiento, la salida aparece en la ventana Salida de seguimiento. Puede usar esta ventana para ver las variables en la secuencia de comandos y ver cómo cambian a medida que avanza el script con cada acciónClosed Performs a process within a Studio script, such as collecting customer data or playing music..

  1. En Studio, abra un script y ejecute un seguimiento o abra un archivo de seguimiento guardado.

  2. En la parte superior derecha de la ventana Trace Output, haga clic en una acción en el panel de detalles del script. Si está viendo un seguimiento en vivo, este panel se actualiza en tiempo real a medida que el script avanza y activa cada acción.

  3. Haga clic en los iconos de la barra de herramientas en la parte superior de la ventana Trace Output para expandir El icono Expandir todo en la ventana Trace Output, un cuadrado con un signo menos dentro de él y una serie de líneas horizontales apiladas junto a él, que representa una lista abierta. o contraer todo El icono Expandir todo en la ventana de Salida de seguimiento, un cuadrado con un signo + dentro y una serie de líneas horizontales apiladas junto a él que representan una lista. de los detalles de las variables en el panel de detalles del script. Esto afecta a cualquier variable que tenga detalles adicionales dentro. Estas variables se indican mediante un + icono junto al nombre.
  4. Haga clic en la pestaña variables en la parte inferior de la ventana para desplazarse por todas las variables presentes en el script cuando se activó la acción seleccionada.

  5. Haga clic en el ícono Tools El ícono de Herramientas de Rastreo, un martillo y una llave inglesa cruzados como una X. y seleccione una opción para cambiar qué variables se muestran en la pestaña variables .

  6. En el panel Properties , puede ver las Propiedades de la acción seleccionada y cómo están configuradas.
  7. Agregar variables a una lista de seguimiento, si desea rastrear variables específicas a través del seguimiento.

Cambiar la visibilidad de la Variable dentro de un seguimiento

Puede cambiar qué conjuntos de variables se muestran en un seguimiento. Esto le permite concentrarse en tipos específicos de variables, según lo que esté buscando en el seguimiento.

  1. En Studio, abra un script y ejecute un seguimiento.
  2. En la barra de herramientas de la ventana Trace Output , haga clic en el ícono Tools El ícono de Herramientas de Rastreo, un martillo y una llave inglesa cruzados como una X..
  3. Seleccione la opción correspondiente al conjunto de variables que desea ver u ocultar en la traza. Las Opciones con una marca de verificación junto a ellas están actualmente visibles en el seguimiento.

Capturar un seguimiento del script

Puede capturar un seguimiento en un script conforme se ejecuta. Puede hacer esto con scripts de producción que procesan contactos en vivo. Esto le permite diagnosticar los problemas que experimenta su centro de contacto o capturar datos para solucionar problemas con el soporte técnico. Puede elegir capturar un seguimiento en la siguiente instancia cuando se ejecute el script, o puede capturar un seguimiento continuo. Un seguimiento continuo captura cada interacción que procesa el script. Cuando captura una sola traza, la información resultante aparece en la ventana Trace Output .

  1. En Studio, abra el script del que desea capturar el seguimiento.
  2. Haga clic en Depurar > Captura de script > Siguiente instancia.
  3. Cuando se inicia una interacción y el script comienza a ejecutarse, se abre la ventana Trace Output . La ventana muestra el seguimiento a medida que se ejecuta el script.

Captura de una traza continua de script

Un seguimiento continuo captura cada interacción que procesa el script. La salida de seguimiento se guarda en archivos en su abonado NiCE CXone. Puede especificar dónde se guardan estos archivos.

  1. En Studio, abra el script del que desea capturar el seguimiento.
  2. Haga clic en Depurar > Captura de script > Continuo. Studio comienza a capturar todas las instancias en ejecución del script.

Ver Archivos de seguimiento

Puede ver los archivos de seguimiento guardados de un seguimiento continuo.

  1. En Studio, haga clic en el menú Depurar y, a continuación, seleccione si desea cargar un archivo de seguimiento ubicado en su sistema o de forma remota en su abonado NiCE CXone.
  2. Seleccione el archivo que desea abrir en la ventana de archivos que aparece.
  3. Haga clic en el botón para abrir el archivo de seguimiento seleccionado. El nombre varía dependiendo de si está abriendo un archivo local o remoto. La ventana Trace Output carga el archivo seleccionado.
  4. Si desea descargar los archivos de rastreo de NiCE CXone a su computadora local, haga clic en el icono de Herramientas El ícono de Herramientas de Rastreo, un martillo y una llave inglesa cruzados como una X. en la ventana Trace Output , luego seleccione Save Trace As.

Captura un seguimiento con un ANI o DNIS específico

Puede establecer un específico ANIClosed Also known as caller ID. Listed phone number of an incoming voice call.o DNISClosed The number dialed on inbound or outbound voice calls. para disparar un rastro cuando una llamada del número especificado ingresa al sistema.

  1. En Studio, abra el script del que desea capturar el seguimiento.
  2. En la barra de herramientas Studio, haga clic en el menú desplegable Trace Script y seleccione Trace when ANI is o Trace when DNIS is.

  3. Ingrese el número de ANI o DNIS que desea utilizar para activar el seguimiento en el campo Insertar <número>.
  4. Click the Capture Next Instance icon A grey sphere. . The number of times you click changes the behavior: 
    • Haga clic una vez para rastrear la siguiente instancia del script que se está ejecutando con el número especificado. El icono se pone rojo.
    • Haga clic DOs veces para rastrear continuamente las instancias futuras del script que se ejecuten con el número especificado. El ícono cambia a DOs círculos rojos.
    • Haga clic tres veces para borrar la captura. El ícono vuelve a su color gris original.
  5. La próxima vez que se ejecute el script con el ANI o DNIS especificado, se capturará un seguimiento y se guardará en un archivo.

Vigilar variables con un seguimiento

Puede crear una lista de variables que especialmente le interesen. La lista de seguimiento le permite rastrear solo estas variables sin tener que buscarlas en el seguimiento. Puede guardar la lista para que cada vez que ejecute un rastreo en ese script en particular, la lista de supervisión se guarde y se cargue en la ventana Trace Output .

  1. En Studio, abra el script al que desea rastrear.
  2. Ejecute un seguimiento inicial del script.
  3. En la ventana Trace Output , haga clic a través de la lista de acciones en el panel de detalles del script. Las variables asociadas con cada acción aparecen en la pestaña variables .
  4. For each variable you want to add to the watch list:
    1. Seleccione la variable en la pestaña variables .
    2. Haga clic en el ícono Add to Watch List El ícono Agregar a la lista de seguimiento: un par de lentes..
  5. You can add a variable manually if you know the name:
    1. En la barra de herramientas de la ventana Trace Output , haga clic en el icono del signo más. Aparece la pestaña Watch List con un campo para una nueva variable.
    2. Ingrese el nombre de la variable que desea observar y presione intro.
  6. Si desea quitar una variable de la lista de vigilancia, selecciónela en la pestaña Lista de vigilancia y haga clic en el ícono de signo menos en la barra de herramientas de la ventana Trace Output .
  7. Para guardar esta lista de supervisión, haga clic en el icono Tools El ícono de Trace Tools, un martillo y una llave cruzados como un X. en la barra de herramientas de la ventana Trace Output y seleccione Guardar lista de seguimiento. La lista se guarda en Studio. Cada vez que ejecuta un trace en este script, la lista de inspección se carga en la ventana Trace Output .
  8. Cuando esté listo para ver las variables en su lista de seguimiento, ejecute un nuevo seguimiento en el script.