Scripts de depuración

Permisos necesarios: Aplicaciones > Studio > Scripts > Depurar

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

  • Revisar 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 Snippet en su script, puede depurar el código del snippet desde la ventana Snippet Editor.

Revisar si hay errores de sintaxis

Cuando revisa si hay errores de sintaxis, cualquier problema que encuentre en su script aparece en la pestañaScript Errors . La pestaña le muestra todas las advertencias y errores relacionados con su script, incluso en los snippets. Las advertencias no impiden que se ejecute o se guarde el script, pero los errores sí. La mejor práctica es solucionar todas las advertencias antes de poner el script en producción, aunque no impidan que funcione el script.

Las revisiiones de sintaxis se realizan automáticamente cuando guarda un script, pero puede ejecutar una revisió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. Puedes revisar la pestañaScript Errors para más información. Los errores pueden incluir cosas como:

  • Variables mal escritas. Por ejemplo: Snippet Line 2. Function: NameLabel has not been defined.
  • El uso de una función como parámetro de un método. Por ejemplo: Unterminated function parameters.
  • Usar un tipo de datos incorrecto en un método o función que requiere un tipo de datos específico. Por ejemplo: Unterminated function parameters.

Hay algunos errores que pueden no aparecer 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. Los 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, la secuencia de comandos puede volver a la versión más reciente de la secuencia de comandos 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 la pantalla donde ocurre el problema.

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

Seguimientos del Script

Puede realizar un seguimiento del avance y del rendimiento de su script con la herramientaTrace Output . Esta herramienta rastrea el contacto a través del script y muestra los resultados de cada acción que se activó, qué variables se están configurando y en qué momento, y los valores que tenían las variables en cada momento. Esta es una herramienta útil para probar y depurar sus scripts. Puede ejecutar seguimientos en interacciones en vivo o simuladas.

Solo puede ejecutar un seguimiento si se guarda el script. Si intenta ejecutar un seguimiento del script en un script con cambios sin guardar, Studio le pide que guarde el script. Si tiene errores en el script, Studio no guardará el script. Debe resolver los errores antes de poder guardar el script y ejecutar el seguimiento. Cualquier validation errors en el script causa que Studio regrese a la última versión del script sin el error de validación. Si ha iniciado un seguimiento, se ejecuta, pero se ejecutará en la última versión guardada del script.

Use la VentanaTrace Output

Cuando ejecute un seguimiento, la salida aparece en la ventanaTrace Output . 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ónCerrado Realiza un proceso dentro de un estudio de secuencias de comandos, tales como la recogida de datos de clientes, reproducir un mensaje o la música, o la colocación de un contacto a un agente..

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

    La ventana Rastrear Salida, que muestra el resultado de un seguimiento en un script de voz entrante.
    Campo Detalles
    IBVoice El nombre del script. IBVoice es el nombre del script en esta imagen de ejemplo.
    Barra de herramientas

    Debajo del nombre del script está la barra de herramientas de la ventanaTrace Output . Esta barra de herramientas contiene opciones que le permiten:

    • El ícono de las opciones Ver y Diseño en la ventana de resultados de Rastreo. Un rectángulo que parece una ventana vacía.: Cambiar el diseño de la ventanaTrace Output , incluidos los paneles y pestañas que son visibles.
    • El ícono de Herramientas en la ventana de resultados de Rastreo, un martillo y una llave inglesa cruzados en forma de X.: Cambie las variables que están visibles en la pestaña Variables, guarde la lista de observación actual y guarde el seguimiento actual en un archivo en su computadora.
    • El conjunto de íconos en la barra de herramientas de la Ventana de Rastreo que le permite crear y administrar una lista de vigilancia.: Cree y administre una lista de variables que desee observar en este seguimiento.
    • Un conjunto de íconos que le permiten expandir y contraer todas las variables o acciones que contienen información en las listas.: Amplíe o contraiga todas las acciones o variables que contienen información.
    • El ID de contacto y el nombre y la ruta del script que se está rastreando.: Esta parte de la barra de herramientas le muestra el ID de contacto del contacto actual. También le muestra el nombre y la ruta del script que se está rastreando.

    No puede cambiar la ubicación de la barra de herramientas.
    Propiedades

    Al seleccionar una acción en el panel Script Details , el panel Properties muestra todas las propiedades de la acción y sus ajustes de configuración.

    La ubicación predeterminada del panel Properties está en el lado superior izquierdo de la ventana Trace Output debajo de la barra de herramientas.
    Script Details

    El panel Script Details muestra todas las acciones que se activan mientras se ejecuta el script, en el orden en que se activaron. No incluye las acciones que forman parte del script pero que no se activaron, como las acciones que forman parte de una rama que no se ejecutó.

    Cuando hace clic en una acción, aparecen en la pestaña Variables todas las variables del script en ese momento.

    La ubicación predeterminada del panel de Detalles del Script está en el lado superior derecho de la ventana Trace Output debajo de la barra de herramientas.

    Consulte la tabla desplegable en el paso 2 para obtener información sobre los encabezados de las columnas de este panel.
    Variables Pestaña

    Cuando selecciona una variable en el panel Script Details , aparecen en esta pestaña todas las variables actualmente en el script.

    La ubicación predeterminada de la Variables pestaña está en la parte inferior de la Trace Output ventana.
    Watch List Pestaña

    Puede crear una lista de variables de los script de las que desea realizar un seguimiento a medida que se ejecuta la secuencia de comandos. Las variables que agregue aparecen en esta pestaña.

    La ubicación predeterminada de la Watch List pestaña está en la parte inferior de la Trace Output ventana.

  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á observando un seguimiento en vivo, se actualiza este panel en tiempo real a medida que avanza el script y se activa cada acción.

    Campo Detalles
    Script El nombre del script que contiene la acción. Si un script principal genera un subíndice, es posible que vea más de un nombre en la lista.
    Time La hora en que se activó la acción.
    Action El nombre de la acción, incluidos los argumentos de cada una. Los argumentos son todos los ajustes de configuración en las propiedades de la acción.
    Result

    El resultado de la acción que se activó. Esto indica lo que sucedió como resultado de la acción de procesamiento del script. Esta puede ser la rama que siguió el script o la acción que ocurrió como resultado de la activación de la acción.

    Por ejemplo, en la imagen de ejemplo del paso 1 de esta sección, son ramas Default y Error. DirectJump to 4 y StartAt ONRELEASE son el resultado de la activación de estas acciones. DirectJump to 4 indica que el contacto seleccionó una opción en el menú de IVRCerrado Menú telefónico automatizado que permite a las personas que llaman interactuar a través de comandos de voz, entradas de teclas o ambos, para obtener información, enrutar una llamada de voz entrante o ambos. que provocó que saltara el script a la acción con ID de Acción 4. StartAt ONRELEASE indica que el script está actualmente en espera y se reiniciará cuando un agente responda a la interacción.
  3. Haga clic en los iconos de la barra de herramientas en la parte superior de la ventanaTrace Output para ampliar o colapsar todo El icono Expandir todo en la ventana Rastrear Salida, un cuadrado con un + 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.

    Campo Detalles
    Name El nombre de la variable. Las variables con nombres que comienzan con dos guiones bajos son variables del sistema.
    Value El valor de la variable. Captura de pantalla del widget de interaccionesEsto puede cambiar a medida que avanza el script de una acción a otra.
    Type El tipo de variable. Las opciones son Variable para variables estándar de un valor único o UCN.Data.Dynamic para objetos de datos dinámicos.

  5. Haga clic en el Tools icono y seleccione una opción para cambiar las variables que se muestran en la pestaña Variables .

    Campo Detalles
    Show Global Variables in Subs Seleccione esta opción si desea que las variables globales aparezcan en la pestañaVariables . Esto incluye variables globales que se configuran en este script o se configuran en otro script y se pueden usar en éste. Por ejemplo, un subscript.

    Show System Variables

    Seleccione esta opción si desea que las variables predefinidas del sistema aparezcan en la pestañaVariables . Estas son variables que se agrega automáticamente el sistema al script, incluidas las acciones en el script.
    Show Private Members Seleccione esta opción si desea que los miembros privados aparezcan en la pestañaVariables .
  6. Sobre el panelProperties , 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 ventanaTrace Output , haga clic en el Tools ícono .

  3. Seleccione la opción para el conjunto de variables que desee ver u ocultar en el seguimiento. Las opciones con una marca de verificación junto a ellas están actualmente visibles en el seguimiento.

    Campo Detalles
    Show Global Variables in Subs Seleccione esta opción si desea que las variables globales aparezcan en la pestañaVariables . Esto incluye variables globales que se configuran en este script o se configuran en otro script y se pueden usar en éste. Por ejemplo, un subscript.

    Show System Variables

    Seleccione esta opción si desea que las variables predefinidas del sistema aparezcan en la pestañaVariables . Estas son variables que se agrega automáticamente el sistema al script, incluidas las acciones en el script.
    Show Private Members Seleccione esta opción si desea que los miembros privados aparezcan en la pestañaVariables .

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 optar por capturar un seguimiento en la siguiente instancia cuando se ejecuta el script, o puede capturar un seguimiento continuo. Un seguimiento continuo captura cada interacción que procesa el script. Cuando capture un seguimiento único, 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 Debug > Capture Script > Next Instance.
  3. Cuando comienza una interacción y comienza a ejecutarse el script, se abre la ventana Trace Output . La ventana muestra el seguimiento a medida que se ejecuta el script.

Capturar un Seguimiento Continuo del Script

Un seguimiento continuo captura cada interacción que procesa el script. El resultado del seguimiento se guarda en los archivos en su CXone unidad de negocioCerrado Agrupación organizativa de alto nivel utilizado para administrar el soporte técnico, facturación y configuración global para su CXone entornotenant. Puede especificar dónde se guardan estos archivos.

  1. En Studio, abra el script del que desea capturar el seguimiento.
  2. Haga clic en Debug > Capture Script > Continuous. 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ú Debug, luego seleccione si desea cargar un archivo de seguimiento que se encuentra en su sistema o de forma remota en su CXone unidad de negocioCerrado Agrupación organizativa de alto nivel utilizado para administrar el soporte técnico, facturación y configuración global para su CXone entornotenant.
  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. El archivo seleccionado se carga en la ventanaTrace Output .
  4. Si desea descargar archivos de seguimiento de CXone a su computadora local, haga clic en el Tools ícono El ícono de Herramientas de Rastreo, un martillo y una llave inglesa cruzados como una X. en la ventanaTrace Output , luego seleccione Save Trace As.

Capture un Seguimiento con un ANI o DNIS Específico

Puede establecer un específico ANICerrado También conocido como identificador de llamadas. Muestran el número de teléfono de una llamada de voz entrante.o DNISCerrado Identifica el número que marcó el contacto para comunicarse con usted para las llamadas de voz entrantes y el número que el agente o el sistema marcó en las llamadas de voz salientes. 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.

    Imagen de las opciones de rastreo en la barra de herramientas de Studio.
  3. Ingrese el número ANI o DNIS del que desea activar el seguimiento en el campo Insert <number>.
  4. Haga clic en el Capture Next Instance icono . La cantidad de veces que hace clic cambia el comportamiento: 
    • Haga clic una vez para rastrear la siguiente instancia del script que se ejecuta con el número especificado. El ícono se vuelve rojo.
    • Haga clic dos veces para rastrear continuamente futuras instancias del script que se ejecutan 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 seguimiento en ese script en particular, se guarda la lista de seguimiento y se carga en la ventanaTrace Output .

  1. En Studio, abra el script al que desea rastrear.
  2. Ejecute un seguimiento inicial de la secuencia de comandos.
  3. En la ventanaTrace Output , haga clic en la lista de acciones en el panel de detalles del script. Las variables asociadas a cada acción aparecen en la pestañaVariables .
  4. Para cada variable que desee agregar a la lista de seguimiento:
    1. Seleccione la variable en la pestañaVariables .
    2. Haga clic en el Add to Watch List ícono .
  5. Puede agregar manualmente una variable si conoce el nombre:
    1. En la barra de herramientas de la ventanaTrace Output , haga clic en el ícono más. La pestañaWatch List aparece con un campo para una variable nueva.
    2. Ingrese el nombre de la variable que desea observar y presione Enter.
  6. Si desea eliminar una variable de la lista de seguimiento, selecciónela en la pestañaWatch List y haga clic en el ícono del signo menos en la barra de herramientas en la ventanaTrace Output .
  7. Para guardar esta lista de seguimiento, haga clic en el Tools ícono en la barra de herramientas de la ventanaTrace Output y seleccione Save Watch List. La lista se guarda en Studio. Cada vez que ejecuta un seguimiento en este script, la lista de seguimiento se carga en la ventanaTrace Output .
  8. Cuando esté listo para ver las variables en su lista de seguimiento, ejecute un nuevo seguimiento en el script.