스니펫 디버그

Snippet 편집기 창에서 스니펫 코드를 디버그할 수 있습니다. 디버거를 사용하면 스니펫 코드에서 변수를 볼 수 있습니다. 코드에 있는 문제를 해결하는 데 도움이 됩니다. 스니펫 디버그 옵션으로는 다음과 같이 다섯 가지가 있습니다.

  • 스니펫에서 구문을 검사합니다. 스니펫을 코딩할 떄 언제든지 이를 수행할 수 있습니다. 디버거 도구는 사용하지 않습니다.
  • 전체 스니펫을 디버깅하여 전체 스니펫을 실행한 이후 변수와 값을 봅니다.
  • 중단점을 설정하여 코드 내의 특정 줄에서 디버깅을 중단합니다.
  • 스니펫 코드의 각 줄을 단계별로 진행하고 변수와 값이 줄별로 변화하는 방식을 확인합니다.
  • TRACE 문을 사용하여 Snippet 편집기 창의 Trace 창으로 데이터를 출력합니다.

또한, 코드에 정적인 개체 또는 배열이 포함된 경우에는 내용을 보고 변경되는 방식을 확인할 수 있습니다.

다양한 디버깅 요소를 표시하는 Snippet Properties 창의 이미지.

스니펫 구분 검사

Studio이(가) 스니펫에서 구문을 검사하게 할 수 있습니다.

  1. Studio에서 Snippet 작업이 포함된 스크립트를 엽니다.
  2. Snippet 작업을 두 번 클릭합니다.
  3. 이미 코드가 포함되어 있지 않다면 Text View 탭에 Snippet 코드를 추가합니다.

  4. Snippet 편집기 창 하단에서 Check Syntax 아이콘 을 클릭합니다.

    구문 오류를 찾지 못한 경우에는 구문 검사 아이콘 옆의 상태 필드에 Okay 메시지가 표시됩니다.

    구문 오류를 발견한 경우 오류를 설명하는 오류 메시지가 팝업으로 표시됩니다. 설명에는 오류가 위치한 줄 번호가 포함됩니다. 또한, 구문 검사 아이콘 옆의 상태 필드에는 메시지 Error at line [#]이(가) 표시됩니다.

  5. 발견한 구문 문제를 수정합니다.
  6. 스니펫 코드에서 한 개 이상의 줄을 선택한 다음 Comment out selected lines 아이콘 을 클릭할 수 있습니다. 오류를 건너뛰고 남은 오류가 있는지 검사하려는 경우 유용합니다.
  7. 스니펫 코드에서 한 개 이상의 메모가 작성된 줄을 선택한 다음 Uncomment the selected lines 아이콘 을 클릭할 수 있습니다.

디버거 도구 사용

  1. Studio에서 Snippet 작업이 포함된 스크립트를 엽니다.
  2. Snippet 작업을 두 번 클릭합니다.
  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.

중단점으로 디버깅

디버깅이 스니펫 코드의 특정 줄에서 중단하게 하려면 중단점을 설정할 수 있습니다. 그러면 줄을 하나씩 진행할 필요 없이 스니펫 전체적으로 변수와 값을 확인할 수 있습니다.

  1. Studio에서 Snippet 작업이 포함된 스크립트를 엽니다.
  2. Snippet 작업을 두 번 클릭합니다.
  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.

스니펫 코드 단계별 진행

디버거 도구를 사용하여 스니펫 코드를 줄별로 진행할 수 있습니다. 이렇게 하면 각 줄을 실행할 때마다 변수와 값이 변경되는 모습을 확인할 수 있습니다.

  1. Studio에서 Snippet 작업이 포함된 스크립트를 엽니다.
  2. Snippet 작업을 두 번 클릭합니다.
  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.

동적 오브젝트 및 배열 내용 보기

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.

TRACE를 사용한 디버깅

TRACE  키워드를 사용하면 로깅을 사용하여 디버그할 수 있습니다. 키워드는 Snippet 편집기 창에서 디버거 도구를 사용할 때만 사용할 수 있습니다. 스니펫 코드에 이를 포함하고 디버거를 실행하면 텍스트가 Snippet 창 하단에 표시되는 Trace 창으로 출력됩니다.

다양한 디버깅 요소를 표시하는 Snippet Properties 창의 이미지.

TRACE 키워드는 Snippet 편집기 창 외부에서 무시됩니다. 디버거 도구와 작동합니다.

구문은 TRACE "<text>"입니다.

큰따옴표 내의 텍스트는 Snippet 편집기 창으로 출력됩니다. 이는 창 하단의 Trace 창에 표시됩니다.

큰따옴표 사이에서 변수 대체를 사용하여 변수의 값을 출력할 수 있습니다. 예:

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

이 예시의 출력은 다음과 같습니다.

I = 1

I = 2

I = 3

I = 4

I = 5