Depurar Scripts en Desktop Studio

Required permissions: ACD > 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 action 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.

   Ver Imagen de la ventana Ventana de Rastrear Salida

   
   Más información sobre los campos en este paso

   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: : Cambiar el diseño de la ventanaTrace Output , incluidos los paneles y pestañas que son visibles. : 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. : Cree y administre una lista de variables que desee observar en este seguimiento. : Amplíe o contraiga todas las acciones o variables que contienen información. : 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.

   Obtenga más información sobre los campos en este paso

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

   Obtenga más información sobre los campos en este paso

   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 .

   Learn more about fields in this step

   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.

   Learn more about fields in this step

   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 en la ventanaTrace Output , luego seleccione Save Trace As.

Capture un Seguimiento con un ANI o DNIS Específico

Puede establecer un específico ANI También conocido como identificador de llamadas. Muestran el número de teléfono de una llamada de voz entrante.o DNIS 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.

   Ver imagen del menú desplegable Rastrear Script con la opción ANI seleccionada

   
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.