Fragmenten debuggen

Deze pagina is bedoeld voor Desktop Studio. Momenteel ondersteunt CXone Studio de op deze pagina beschreven opties niet.

U kunt de fragmenten debuggen in het venster Snippet -editor. Met de debugger kunt u de variabelen in de fragmentcode zien. Dit kan u helpen bij oplossen van problemen in uw code. Er zijn vijf opties voor het debuggen van fragmenten:

  • Controleer de syntaxis in het fragment. U kunt dit op elk ogenblik doen tijdens het coderen van een fragment. Dit maakt geen gebruik van de debugger-tool.
  • Debug het volledige fragment om variabelen en hun waarden te zien nadat het volledige fragment werd uitgevoerd.
  • Stel een onderbrekingspunt in om debugging te stoppen op een bepaalde regel in de code.
  • Doorloop elke regel in de fragmentcode en kijk hoe de variabelen en hun waarden regel voor regel wijzigen.
  • Gebruik TRACE-verklaringen voor het uitvoeren van gegevens naar het Trace -deelvenster in het venster Snippet -editor.

Als uw code daarnaast dynamische objecten of arrays bevat, kunt u hun inhoud zien en de manier waarop deze verandert.

Afbeelding van het venster Fragmenteigenschappen met verschillende debug-elementen.

Syntaxis fragment controleren

U kunt Studio de syntaxis in een fragment laten controleren.

  1. Open een script in Studio die een Snippet-actie bevat.
  2. Dubbelklik op de Snippet-actie.
  3. Voeg een Snippet-code toe op het tabblad Text View , als het nog geen code bevat.

  4. Klik op het Check Syntax pictogram onderaan in het Snippet editorvenster.

    Als er geen syntaxisfouten zijn gevonden, toont het statusveld naast het pictogram Syntaxis controleren het bericht Okay.

    Als er syntaxisfouten zijn gevonden, verschijnt een foutbericht die de fout beschrijft. De beschrijving bevat het nummer van de regel waar de fout zich bevindt. Daarnaast toont het statusveld naast het pictogram Syntaxis controleren, het bericht Error at line [#].

  5. Corrigeer eventuele syntaxproblemen die zijn aangetroffen.
  6. U kunt een of meer regels in de fragmentcode selecteren en op het Comment out selected lines pictogram klikken. Dit is nuttig als u een fout wilt overslaan en controleren op eventuele resterende fouten.
  7. U kunt een of meer als commentaar gemarkeerde regels in de fragmentcode selecteren en op het Uncomment the selected lines pictogram klikken.

De Debuggertool gebruiken

  1. Open een script in Studio die een Snippet-actie bevat.
  2. Dubbelklik op de Snippet-actie.
  3. Add Snippet code on the Text View tab, if it doesn't already contain some.
  4. On the right side of the Snippet editor window, click the Debugger tab.
  5. Click the down-arrow button on the right side of the Debug icon An icon of a window with a green right-facing triangle. On the right side of the icon is a down-facing black triangle that opens a drop-down menu. and select StartAn icon of a green play button triangle..

  6. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

    The Snippet editor window, showing the errors pane at the bottom of the window.
    1. Correct the errors.
    2. When the errors have been corrected, click the Close or Clear Trace Output icons An X. to close the error pane.
    3. Start the debugger again.
  7. View the contents of the Variables as Text tab. The tab shows the variables and their values when all of the code has been executed if you didn't set a breakpoint.
  8. You can select one or more lines in the snippet code and click the Comment out selected lines icon An icon with open and closed angle brackets next to each other with a blue forward slash between them.. This is helpful if you want to remove some code to see how the outcome of the debugging changes.
  9. You can select one or more lines of commented-out code and click the Uncomment the selected lines icon An icon with open and closed angle brackets next to each other with a forward slash between them. A large red forward slash crosses the other characters. to add those lines back into the snippet.

Debuggen met een onderbrekingspunt

U kunt een onderbrekingspunt instellen als u de debugging wilt stoppen op een bepaalde regel in de fragmentcode. Hiermee kunt u de variabelen en waarden zien wanneer u gedeeltelijk het fragment hebt doorlopen, zonder dat u er regel voor regel moet doorlopen.

  1. Open een script in Studio die een Snippet-actie bevat.
  2. Dubbelklik op de Snippet-actie.
  3. Add Snippet code on the Text View tab, if it doesn't already contain some.

  4. Click in the column to the left of the line numbers in the Snippet editor window. A red circle appears at that line number.

    Image showing the red sphere and highlighted red line of code of a breakpoint.
  5. On the right side of the Snippet editor window, click the Debugger tab.
  6. Click the down-arrow button on the right side of the Debug icon An icon of a window with a green right-facing triangle. On the right side of the icon is a down-facing black triangle that opens a drop-down menu. and select StartAn icon of a green play button triangle..

  7. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

    The Snippet editor window, showing the errors pane at the bottom of the window.
    1. Correct the errors.
    2. When the errors have been corrected, click the Close or Clear Trace Output icons An X. to close the error pane.
    3. Start the debugger again.
  8. View the contents of the Variables as Text tab. The tab shows the variables and their values at the breakpoint, if you set one. The line where the debugging paused for the breakpoint is highlighted in the Snippet Editor window.
  9. If you're done with the breakpoint, click the red circle again to clear it.
  10. Set another breakpoint, if you need one.
  11. To continue debugging from the breakpoint, click the Resume icon An icon of a green play triangle..
  12. To stop debugging, click the Stop Debugging A black square. icon.

Doorloop de fragmentcode

U kunt de debuggertool gebruiken om de fragmentcode regel voor regel te doorlopen. Hiermee kunt u zien hoe de variabelen en hun waarden wijzigen naarmate elke regel wordt uitgevoerd.

  1. Open een script in Studio die een Snippet-actie bevat.
  2. Dubbelklik op de Snippet-actie.
  3. Add Snippet code on the Text View tab, if it doesn't already contain some.
  4. On the right side of the Snippet editor window, click the Debugger tab.
  5. Click the down-arrow button on the right side of the Debug icon An icon of a window with a green right-facing triangle. On the right side of the icon is a down-facing black triangle that opens a drop-down menu. and select StartAn icon of a green play button triangle..

  6. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

    The Snippet editor window, showing the errors pane at the bottom of the window.
    1. Correct the errors.
    2. When the errors have been corrected, click the Close or Clear Trace Output icons An X. to close the error pane.
    3. Start the debugger again.
  7. View the contents of the Variables as Text tab. It displays the variables in the code and their values when the snippet code starts.
  8. Click the Step icon An icon to move to the next line in the snippet.
  9. Repeat steps the preceding two steps for each line in the snippet.
  10. If you want to skip the remaining lines of code, click the Resume icon An icon of a green play button triangle.. The Variables as Text tab displays the variables and their values when all of the snippet code has executed.
  11. To stop debugging, click the Stop Debugging A black square. icon, then repeat this process starting from step 3.

Inhoud van dynamische objecten en arrays weergeven

You can view the contents of dynamic objects in the Snippet editor window when you run the debugger. This allows you to verify that the object holds the data it's supposed to at each step in your code.

  1. In Studio, double-click on a Snippet action.
  2. Add snippet code, if necessary.
  3. On the Debugger tab, click the Variables as Tree tab.
  4. On the Debugger tab, click the down arrow next to the Start Debugging icon An image of a triangular green play buttonand select Step Into A series of horizontal lines with an arrow pointing from one line to the one beneath it.. If you don't want to step through the code line by line, click the Start Debugging icon.
  5. Click the Step A series of horizontal lines with an arrow pointing from one line to the one beneath it. icon and observe the contents on the Variables as Tree tab. Each time you click Step, this field updates with the variables and objects in the script after the previous line of code. Skip this step if you clicked Start Debugging.
  6. When you have stepped through all lines of code or if you clicked Start Debugging, the Variables as Tree tab displays all variables, objects, and their contents at the end of the snippet.

  7. You can click the + icon next to any string arrays or dynamic objects in the code to expand them. If the content is another array or object, you can continue to expand the tree to see what each entity contains.

    The Snippet editor window in debug mode, showing the contents of objects and arrays on the Variables as Tree tab.

Debuggen met TRACE

Met het TRACE -trefwoord kunt u debuggen met de hulp van registratie. Dit trefwoord werkt alleen wanneer u de debuggertool gebruikt in de het Snippet editor-venster. Wanneer u het opneemt in uw fragmentcode en de debugger uitvoert, wordt er tekst uitgevoerd naar het paneel Trace dat onderaan in het venster Snippet -editor verschijnt.

Afbeelding van het venster Fragment-eigenschappen met verschillende debug-elementen.

Het TRACE -trefwoord wordt genegeerd buiten het Snippet -editorvenster. Dit werkt alle met de debuggertool.

De syntaxis is: TRACE "<text>"

Tekst binnen dubbele aanhalingstekens wordt uitgevoerd naar het venster Snippet -editor. Het verschijnt in het Trace -venster onderaan in het venster.

U kunt variabelesubstitutie gebruiken tussen de dubbele aanhalingstekens om de waarde van variabelen af te drukken. Bijvoorbeeld:

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

De uitvoer van dit voorbeeld is:

I = 1

I = 2

I = 3

I = 4

I = 5