Fragmentos de depuración

Puede depurar los snippets desde la ventana del editor Snippet . El depurador le permite ver las variables en el código de snippets. Esto puede ayudarlo a resolver problemas en su código. Hay cinco opciones para depurar snippets:

Además, si su código contiene matrices u objetos dinámicos, puede ver su contenido y como cambia.

Imagen de la ventana Snippet Properties, que muestra los diferentes elementos de depuración.

Revisar la sintaxis del snippet

Puede solicitar que Studio compruebe la sintaxis de un snippet.

  1. En Studio, abra un script que contenga una acción Snippet.
  2. Haga doble clic en la acción Snippet.
  3. Agregue el código Snippet en la pestaña Text View , si aún no lo contiene.

  4. Haga clic en el Check Syntax ícono en la parte inferior de la ventana del editorSnippet .

    Si no se encuentran errores de sintaxis, el campo de estado junto al ícono de Revisar sintaxis muestra el mensaje Okay.

    Si se encuentran errores de sintaxis, aparece un mensaje de error que lo describe. La descripción incluye el número de línea donde se encuentra el error. Además, el campo de estado junto al ícono de Revisar sintaxis muestra el mensaje Error at line [#].

  5. Corrija cualquier problema de sintaxis que se haya encontrado.
  6. Puede seleccionar una o más líneas en el código del snippet y hacer clic en el Comment out selected lines icono . Esto es útil si desea omitir un error y verificar si hay errores restantes.
  7. Puede seleccionar una o más líneas comentadas en el código del snippet y hacer clic en el Uncomment the selected lines icono .

Utilice la Herramienta de depuración

  1. En Studio, abra un script que contenga una acción Snippet.
  2. Haga doble clic en la acción Snippet.
  3. Agregue código Snippet en la pestaña Text View , si aún no contiene algunos.
  4. En el lado derecho de la ventana Snippet Editor, haga clic en la pestaña Debugger.
  5. Haga clic en el botón de flecha hacia abajo en el lado derecho del Debug icono y seleccione StartUn icono con un triángulo de botón de reproducción verde..

  6. Si hay algún error de sintaxis en el código, se expande la ventana Snippet Editor. Todos los errores en el código aparecen en un panel en la parte inferior de la ventana. Si no hay errores, vaya al siguiente paso.

    La ventana del editor de Snippets, que muestra el panel de errores en la parte inferior de la ventana.
    1. Corrija los errores.
    2. Cuando se hayan corregido los errores, haga clic en el Close o los Clear Trace Output iconos para cerrar el panel de errores.
    3. Inicie nuevamente el depurador.
  7. Vea el contenido de la pestaña Variables as Text . La pestaña muestra las variables y sus valores cuando se ha ejecutado todo el código si no definió un punto de interrupción.
  8. Puede seleccionar una o más líneas en el código del snippet y hacer clic en el Comment out selected lines icono . Esto es útil si desea eliminar algún código para ver cómo cambia el resultado de la depuración.
  9. Puede seleccionar una o más líneas de código comentado y hacer clic en el Uncomment the selected lines icono para volver a agregar esas líneas al snippet.

Depurar con un punto de interrupción

Puede definir un punto de interrupción si desea que se detenga la depuración en una línea específica del código del snippet. Esto le permite ver las variables y los valores conforme avanza el snippet sin pasar por él línea por línea.

  1. En Studio, abra un script que contenga una acción Snippet.
  2. Haga doble clic en la acción Snippet.
  3. Agregue código Snippet en la pestaña Text View , si aún no contiene algunos.

  4. Haga clic en la columna a la izquierda de los números de línea en la ventana Snippet Editor. Aparece un círculo rojo en ese número de línea.

    Imagen que muestra la esfera roja y la línea roja de código resaltada de un punto de interrupción.
  5. En el lado derecho de la ventana Snippet Editor, haga clic en la pestaña Debugger.
  6. Haga clic en el botón de flecha hacia abajo en el lado derecho del Debug icono y seleccione StartUn icono con un triángulo de botón de reproducción verde..

  7. Si hay algún error de sintaxis en el código, se expande la ventana Snippet Editor. Todos los errores en el código aparecen en un panel en la parte inferior de la ventana. Si no hay errores, vaya al siguiente paso.

    La ventana del editor de Snippets, que muestra el panel de errores en la parte inferior de la ventana.
    1. Corrija los errores.
    2. Cuando se hayan corregido los errores, haga clic en el Close o los Clear Trace Output iconos para cerrar el panel de errores.
    3. Inicie nuevamente el depurador.
  8. Vea el contenido de la pestaña Variables as Text . La pestaña muestra las variables y sus valores en el punto de interrupción, si define uno. Se resalta en la ventana Snippet Editor la línea donde se detuvo la depuración para el punto de interrupción.
  9. Si ha terminado con el punto de interrupción, vuelva a hacer clic en el círculo rojo para borrarlo.
  10. Defina otro punto de interrupción, si lo necesita.
  11. Para continuar con la depuración desde el punto de interrupción, haga clic en el Resume ícono Un ícono con un triángulo de reproducción verde..
  12. Para detener la depuración, haga clic en el icono Stop Debugging .

Paso a paso del Código de Snippets

Puede usar la herramienta de depuración para recorrer el fragmento de código línea por línea. Esto le permite ver cómo cambian las variables y sus valores a medida que se ejecuta cada línea.

  1. En Studio, abra un script que contenga una acción Snippet.
  2. Haga doble clic en la acción Snippet.
  3. Agregue código Snippet en la pestaña Text View , si aún no contiene algunos.
  4. En el lado derecho de la ventana Snippet Editor, haga clic en la pestaña Debugger.
  5. Haga clic en el botón de flecha hacia abajo en el lado derecho del Debug icono y seleccione StartUn icono con un triángulo de botón de reproducción verde..

  6. Si hay algún error de sintaxis en el código, se expande la ventana Snippet Editor. Todos los errores en el código aparecen en un panel en la parte inferior de la ventana. Si no hay errores, vaya al siguiente paso.

    La ventana del editor de Snippets, que muestra el panel de errores en la parte inferior de la ventana.
    1. Corrija los errores.
    2. Cuando se hayan corregido los errores, haga clic en el Close o los Clear Trace Output iconos para cerrar el panel de errores.
    3. Inicie nuevamente el depurador.
  7. Vea el contenido de la pestaña Variables as Text . Muestra las variables en el código y sus valores cuando comienza el código del snippet.
  8. Haga clic en el Step icono para pasar a la siguiente línea del snippet.
  9. Repita los dos pasos anteriores para cada línea del snippet.
  10. Si desea omitir las líneas de código restantes, haga clic en el Resume icono . La pestaña Variables as Text muestra las variables y sus valores cuando se ha ejecutado todo el código del snippet.
  11. Para detener la depuración, haga clic en el icono Stop Debugging y luego repita este proceso a partir del paso 3.

Ver contenido de las Matrices y objetos dinámicos

Puede ver el contenido de los objetos dinámicos en la ventana del editor Snippet cuando ejecute el depurador. Captura de pantalla del widget de interaccionesEsto le permite verificar que el objeto contenga los datos que se supone que debe contener en cada paso de su código.

  1. En Studio, haga doble clic sobre una acción Snippet.
  2. Agregue el código del snippet de ser necesario.
  3. En la pestaña Debugger , haga clic en la pestaña Variables como Árbol.
  4. En la pestaña Debugger , haga clic en la flecha hacia abajo junto al ícono Iniciar Depuración y seleccione Step Into Una serie de líneas horizontales con una flecha que apunta de una línea a la que está debajo.. Si no desea recorrer el código línea por línea, haga clic en el ícono Empezar a depurar.
  5. Haga clic en el ícono Paso Una serie de líneas horizontales con una flecha que apunta de una línea a la que está debajo. y observe el contenido de la pestaña Variables as Tree. Cada vez que haga clic en Paso, se actualiza este campo con las variables y los objetos del script después de la línea de código anterior. Omita este paso si hizo clic en Empezar a depurar.
  6. Cuando haya recorrido todas las líneas de código o si haya hecho clic en Iniciar Depuración, la pestaña Variables as Tree muestra todas las variables, objetos y su contenido al final del snippet.

  7. Puede hacer clic en el ícono + junto a cualquier matriz de cadenas u objetos dinámicos del código para expandirlos. Si el contenido es otra matriz u objeto, puede continuar expandiendo el árbol para ver qué contiene cada entidad.

    La ventana del editor de fragmentos en modo de depuración, que muestra el contenido de los objetos y las matrices en la pestaña de Variables como árbol.

Depurar usando TRACE

La palabra claveTRACE  le permite depurar mediante el registro. Esta palabra clave solo funciona cuando se usa la herramienta de depuración en la ventana del editorSnippet . Cuando la incluya en el código de su snippet y ejecute el depurador, el texto se envía al Trace panel que aparece en la parte inferior de la ventana del Snippet editor.

Imagen de la ventana Snippet Properties, que muestra los diferentes elementos de depuración.

Se ignora la TRACE palabra clave fuera de la ventana del Snippet editor. Únicamente funciona con la herramienta de depuración.

La sintaxis es: TRACE "<text>"

El texto entre comillas dobles se envía a la ventana del Snippet editor. Aparece en el Trace panel en la parte inferior de la ventana.

Puede usar la sustitución de variables entre las comillas dobles para imprimir el valor de las variables. Por ejemplo:

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

La salida de este ejemplo es:

I = 1

I = 2

I = 3

I = 4

I = 5