Depurar Scripts en Desktop Studio

This help page is for Desktop Studio. This information is also available for CXone Studio.

Permisos necesarios: Aplicaciones > Studio > Scripts > Depurar

Studio provides two ways you can check for issues in your scripts:

  • Check for syntax errors.
  • Run a script trace, which shows you what's happening as the script processes each action.

If you have Snippet actions in your script, you can debug the snippet code from within the Snippet editor window.

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 una función que demanda un tipo específico de datos. 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

You can track the progress and performance of your script with the tool. This tool traces the contact through the script and displays the results of each action that fired, what variables are being set and when, and the values the variables held at each point. This is a helpful tool to test and debug your scripts. You can run traces on live interactions or simulated ones.

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. Any validation errors in the script cause Studio to revert to the last version of the script without the validation error. If you've started a trace, it runs, but will run on the last saved version of the script.

Use la VentanaTrace Output

When you run a trace, the output appears in the window. You can use this window to view the variables in the script and see how they change as the script progresses through each actionCerrado Realiza un proceso dentro de un scripts de Studio, tales como la recopilación de datos de clientes, reproducir un mensaje o música, o el enrutamiento 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. Esto 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 .

    Field Details
    Show Global Variables in Subs Select this option if you want global variables to appear in the Variables tab. This includes global variables that are set in this script or are set in another script and can be used in this script. For example, a subscript.

    Show System Variables

    Select this option if you want pre-defined system variables to appear in the Variables tab. These are variables added to the script automatically by the system, including the actions in the script.
    Show Private Members Select this option if you want private members to appear in the Variables tab.
  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

You can change which sets of variables show in a trace. This allows you to focus on specific kinds of variables, depending on what you're looking for in the trace.

  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.

    Field Details
    Show Global Variables in Subs Select this option if you want global variables to appear in the Variables tab. This includes global variables that are set in this script or are set in another script and can be used in this script. For example, a subscript.

    Show System Variables

    Select this option if you want pre-defined system variables to appear in the Variables tab. These are variables added to the script automatically by the system, including the actions in the script.
    Show Private Members Select this option if you want private members to appear in the Variables tab.

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 tenant. 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 tenant.
  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.