Desktop Studio의 디버그 스크립트

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

Required permissions: ACD > Studio > 스크립트 > 디버그

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.

구문 오류 검토하기

구문 오류를 검토할 때는 스크립트에서 검색되는 모든 문제가 Script Errors 탭에 표시됩니다. 스니펫을 포함하여 스크립트와 관련된 모든 경고와 오류가 탭에 표시됩니다. 경고는 스크립트의 실행 또는 저장을 방지하지 않지만, 오류는 방지합니다. 경고 때문에 스크립트의 실행이 막히지 않는다고 해도, 스크립트의 프로덕션을 시작하기 전에 모든 경고를 해결하는 것이 가장 바람직합니다.

스크립트를 저장할 때 구문 검사가 자동으로 이루어지지만, 구문 검사는 언제든지 수행할 수 있습니다. 오류가 포함된 스크립트를 실행 또는 저장할 수 없습니다. 오류가 있는 스크립트를 실행하거나 저장하려 하면 Studio에 알림 창이 나타납니다. 자세한 정보는 Script Errors 탭에서 확인할 수 있습니다. 오류에는 다음과 같은 사항이 포함될 수 있습니다.

  • 변수의 철자가 잘못되었습니다. 예: Snippet Line 2. Function: NameLabel has not been defined.
  • 메서드 매개 변수로 함수를 사용합니다. 예: Unterminated function parameters.
  • 특정한 데이터 유형이 필요한 함수에서 잘못된 데이터 유형 사용. 예: Unterminated function parameters.

Script Errors 탭에 표시되지 않을 수 있는 오류가 몇 가지 있습니다. 일부 유효성 검사 오류는 오류 알림 창에 표시되며, 오류에 관한 세부 정보도 함께 표시됩니다. 유효성 검사 오류에는 REST API 작업 내의 잘못된 JSON 등의 사항이 해당될 수 있습니다. 유효성 검사 오류가 있는 채로 스크립트를 저장하려 할 경우, 스크립트는 유효성 검사 오류가 없는 최신 버전으로 되돌아갈 수 있습니다. 이렇게 되면 저장하지 않은 변경 사항은 사라집니다.

Script Errors 탭에서 경고나 오류를 두 번 클릭하여 이슈가 발생한 캔버스의 작업을 확인할 수 있습니다.

  1. Studio에서 스크립트를 엽니다.
  2. Validation > Syntax Check을(를) 클릭합니다.
  3. Script Errors 탭을 클릭하여 구문 검사 결과를 봅니다.
  4. Script Errors 탭에서 경고나 오류를 두 번 클릭하여 이슈가 발생한 캔버스의 작업을 확인할 수 있습니다.

스크립트 추적

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.

스크립트가 저장될 때만 추적을 실행할 수 있습니다. 저장되지 않은 변경 사항이 있는 상태에서 스크립트 추적 실행을 시도하면 Studio에서 스크립트를 저장하라고 안내합니다. 스크립트에 오류가 있으면 Studio은(는) 스크립트를 저장하지 않습니다. 스크립트를 저장하고 추적을 실행하기 전에 오류를 해결해야 합니다. 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.

Trace 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닫힘 고객 데이터 모음, 메시지 또는 음악 재생 또는 상담원에게 컨택 라우팅과 같은 Studio 스크립트 내에서 프로세스를 수행합니다..

  1. Studio에서 스크립트를 열고 추적을 실행하거나 저장된 추적 파일을 엽니다.

    인바운드 음성 스크립트의 추적 출력을 보여주는 추적 출력 창입니다.
    영역 세부사항
    IBVoice 스크립트의 이름입니다. IBVoice 은(는) 이 예시 이미지에서 스크립트의 이름입니다.
    도구 모음

    스크립트 이름 아래에는 Trace Output 창 툴바가 있습니다. 이 툴바에는 다음을 수행할 수 있는 옵션이 포함되어 있습니다.

    • 추적 출력 창의 보기 및 레이아웃 옵션 아이콘입니다. 빈 창처럼 보이는 직사각형입니다.: 표시되는 창 및 탭을 포함한 Trace Output 창의 레이아웃을 변경합니다.
    • 추적 출력 창의 도구 아이콘입니다. 망치와 스패너가 X 형태로 교차된 모양입니다.: 변수 탭에 표시되는 변수를 변경하고, 현재 조사 목록을 저장하고, 현재 추적을 컴퓨터의 파일로 저장합니다.
    • 조사 목록을 생성 및 관리하는 데 사용할 수 있는 추적 창 툴바의 아이콘 세트입니다.: 이 추적에서 관찰하려는 변수의 목록을 생성 및 관리합니다.
    • 목록에서 내부에 정보가 있는 변수 또는 작업을 모두 확장 또는 축소하는 데 사용하는 아이콘 세트입니다.: 안에 정보가 있는 모든 작업 및 변수를 확장 또는 축소합니다.
    • 컨택 ID 및 추적되는 스크립트의 이름 및 경로입니다.: 이 툴바의 부분은 현재 컨택의 컨택 ID를 보여줍니다. 또한 추적되는 스크립트의 이름 및 경로를 보여줍니다.

    툴바의 위치를 변경할 수 없습니다.
    속성

    Script Details 창에서 작업을 선택하면, Properties 창에 작업의 모든 속성 및 구성 설정이 표시됩니다.

    Properties 창의 기본 위치는 툴바 아래 Trace Output 창 왼쪽 상단에 있습니다.
    Script Details

    Script Details 창에서는 스크립트가 실행될 때 발동하는 모든 작업을 발동한 순서대로 나열합니다. 수행하지 않은 브랜치의 일부인 작업 등 스크립트의 일부이지만 발동하지 않은 작업은 포함되지 않습니다.

    작업을 클릭하면 해당 지점의 스크립트에 속한 모든 변수가 Variables 탭에 표시됩니다.

    스크립트 세부 사항 창의 기본 위치는 툴바 아래의 Trace Output 창 우측 상단에 있습니다.

    2단계의 드롭다운 테이블에서 이 창의 열 제목에 관한 정보를 확인하십시오.
    Variables  탭

    Script Details 창에서 변수를 선택하면 현재 스크립트 내에 있는 모든 변수가 이 탭에 표시됩니다.

    Variables 탭의 기본 위치는 Trace Output 창의 하단에 있습니다.
    Watch List  탭

    스크립트가 실행될 때 추적하려는 스크립트 변수 목록을 생성할 수 있습니다. 추가하는 변수가 이 탭에 표시됩니다.

    Watch List  탭의 기본 위치는 Trace Output 창의 하단에 있습니다.

  2. Trace Output 창의 우측 상단에서 스크립트 세부 사항 창의 작업을 클릭합니다. 라이브 추적을 조사하는 경우, 이 창은 스크립트가 진행되고 각 작업을 발동할 때 실시간으로 업데이트됩니다.

    영역 세부사항
    Script 작업이 포함된 스크립트의 이름입니다. 주요 스크립트에서 하위 스크립트를 생성하면 목록에 두 개 이상의 이름이 표시될 수 있습니다.
    Time 작업이 발동된 시간입니다.
    Action 각 작업의 인수를 포함한 인수의 이름입니다. 인수는 모두 작업 속성의 구성 설정입니다.
    Result

    발동하는 작업의 결과입니다. 작업을 처리하는 스크립트의 결과로 일어난 일을 알려줍니다. 스크립트가 따라간 브랜치 또는 발동한 작업의 결과로 발생한 작업일 수 있습니다.

    예를 들어, 이 섹션 1단계의 예시인 Default 및 Error은(는) 브랜치입니다. DirectJump to 4 및 StartAt ONRELEASE은(는) 발동하는 작업의 결과입니다. DirectJump to 4은(는) 컨택이 IVR닫힘 발신자가 음성 명령, 키 입력 또는 둘 다를 통해 인터랙션하여 정보를 얻거나 인바운드 음성 통화를 라우팅 또는 두 가지를 모두 할 수 있는 자동화된 전화 메뉴입니다. 메뉴에서 옵션을 선택했으며, 이 때문에 스크립트가 액션 ID 4에 해당하는 액션으로 건너뛰었음을 나타냅니다. StartAt ONRELEASE은(는) 스크립트가 현재 대기 중이며, 상담원이 상호작용에 답변하면 재시작할 것임을 나타냅니다.
  3. Trace Output 창의 상단에 있는 툴바의 아이콘을 클릭하여 확장 하거나 스크립트 세부 사항 창에서 모든 변수에 대한 세부 사항을 모두 축소 추적 출력 창의 모두 확장 아이콘입니다. 더하기기 기호가 안에 있는 정사각형이 있고 그 옆에는 목록을 의미하는 차곡차곡 쌓인 가로줄 여러 개 아이콘이 있습니다. 합니다. 그러면 이 안의 추가 세부 정보가 포함된 모든 변수가 영향을 받습니다. 이 변수는 이름 옆에 + 아이콘이 표시되어 구분됩니다.

  4. 창 하단의 Variables 탭을 클릭하여 선택한 작업이 발동되었을 때 스크립트에 존재하던 모든 변수를 스크롤하여 봅니다.

    영역 세부사항
    Name 변수의 이름입니다. 이름이 밑줄 문자 두 개로 시작하는 변수는 시스템 변수입니다.
    Value 변수의 값입니다. 스크립트가 작업을 하나씩 진행하다 보면 변경될 수 있습니다.
    Type 변수의 유형입니다. 옵션은 표준 단일 값 변수에 대해서는 Variable이고, 또는 동적 데이터 개체의 경우에는 UCN.Data.Dynamic입니다.

  5. Tools 아이콘 을 클릭하고 옵션을 선택하여 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. Properties 창에서 선택한 작업의 속성과 구성하는 방식을 볼 수 있습니다.
  7. 추적을 통해 특정한 변수를 추적하려면 조사 목록에 변수를 추가합니다.

추적의 변수 가시성 변경

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. Studio에서 스크립트를 열고 추적을 실행합니다.
  2. Trace Output 창의 툴바에서 Tools 아이콘 을 클릭합니다.

  3. 추적에서 보거나 숨기려는 변수 세트의 옵션을 선택합니다. 옆에 확인란이 있는 옵션은 현재 추적에서 볼 수 있습니다.

    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.

스크립트 추적 캡처

스크립트가 실행될 때 추적을 캡처할 수 있습니다. 라이브 컨택을 처리하는 프로덕션 스크립트로도 이를 수행할 수 있습니다. 컨택 센터에서 겪는 문제를 진단하거나 기술 지원 관련 문제 해결을 위한 데이터를 캡처할 수 있습니다. 스크립트가 실행될 때 다음 인스턴스에서 추적을 캡처하도록 선택하거나 연속 추적 캡처를 수행할 수 있습니다. 연속 추적은 스크립트에서 처리하는 모든 상호작용을 캡처합니다. 하나의 추적을 캡처하면, 결과 정보가 Trace Output 창에 나타납니다.

  1. Studio에서 추적을 캡처하려는 스크립트를 엽니다.
  2. Debug > Capture Script > Next Instance을(를) 클릭합니다.
  3. 상호작용이 시작하고 스크립트가 실행되기 시작하면 Trace Output 창이 열립니다. 스크립트가 실행됨에 따라 창에서 추적을 표시합니다.

연속 스크립트 추적 캡처하기

연속 추적은 스크립트에서 처리하는 모든 상호작용을 캡처합니다. 추적 출력은 CXone 에 파일로 저장됩니다. 파일을 저장할 위치를 지정할 수 있습니다.

  1. Studio에서 추적을 캡처하려는 스크립트를 엽니다.
  2. Debug > Capture Script > Continuous을(를) 클릭합니다. Studio은(는) 실행되는 스크립트의 모든 인스턴스를 캡처하기 시작합니다.

추적 파일 보기

연속 추적에서 저장된 추적 파일을 볼 수 있습니다.

  1. Studio에서 Debug 메뉴를 클릭한 다음 시스템에 있는 추적 파일 또는 CXone 에 원격으로 있는 추적 파일 중 로드하려는 파일을 선택합니다.
  2. 표시되는 파일 창에서 열려는 파일을 선택합니다.
  3. 버튼을 클릭하여 선택한 추적 파일을 엽니다. 이름은 열려는 파일이 로컬 파일인지 또는 원격 파일인지의 여부에 따라 달라집니다. 선택한 파일이 Trace Output 창에서 열립니다.
  4. CXone에서 로컬 컴퓨터로 추적 파일을 다운로드하려는 경우에는 Trace Output 창에서 Tools 아이콘 추적 도구 아이콘입니다. 망치와 스패너가 X 형태로 교차된 모양입니다. 을 클릭한 다음 Save Trace As 파일을 선택합니다.

특정 ANI 또는 DNIS로 추적 캡처

특정 ANI닫힘 발신자 ID라고도 합니다. 들어오는 음성 통화의 나열된 전화번호입니다. 또는 DNIS닫힘 인바운드 음성 통화를 위해 연결된 컨택 수와 상담원 또는 아웃바운드 음성 통화에서 연결된 시스템 수를 확인합니다.를 설정하여 특정 번호가 건 통화가 시스템에 들어올 때 추적을 실행할 수 있습니다.

  1. Studio에서 추적을 캡처하려는 스크립트를 엽니다.

  2. Studio 툴바에서 Trace Script 드롭다운을 클릭한 다음 Trace when ANI is 또는 Trace when DNIS is을(를) 선택합니다.

    Studio 도구 모음의 추적 옵션의 이미지입니다.
  3. Insert <number> 필드에서 추적을 트리거하려는 ANI 또는 DNIS 번호를 입력합니다.
  4. Capture Next Instance 아이콘 을 클릭합니다. 클릭한 횟수에 따라 다음과 같이 동작이 달라집니다. 
    • 1회 클릭: 특정한 번호로 실행되는 스크립트의 다음 인스턴스를 추적합니다. 아이콘이 빨간색으로 변경됩니다.
    • 2회 클릭: 특정한 번호로 실행되는 스크립트의 이후 인스턴스를 계속 추적합니다. 아이콘이 빨간색 원 두 개로 변경됩니다.
    • 3회 클릭: 캡처가 지워집니다. 아이콘이 처음의 회색으로 돌아갑니다.
  5. 스크립트가 특정한 ANI 또는 DNIS로 실행될 때 추적이 캡처되며 파일로 저장됩니다.

추적에서 변수 조사하기

특히 관심 있는 변수 목록을 생성할 수 있습니다. 조사 목록을 사용하면 추적에서 검색할 필요 없이 변수만을 추적할 수 있습니다. 특정 스크립트에서 추적을 실행할 때마다 조사 목록이 저장되고 Trace Output 창으로 로드되도록 목록을 저장할 수 있습니다.

  1. Studio에서 추적할 스크립트를 엽니다.
  2. 스크립트의 초기 추적을 실행합니다.
  3. Trace Output 창에서 스크립트 세부 사항 페이지의 작업 목록을 클릭합니다. 각 작업과 관련된 변수는 Variables 탭에 표시됩니다.
  4. 각 변수에 대해 다음과 같이
      조사 목록에 추가할 수 있습니다.
    1. Variables 탭에서 변수를 선택합니다.
    2. Add to Watch List 아이콘 을 클릭합니다.
  5. 이름을 아는 경우 수동으로 변수를 추가할 수 있습니다.
    1. Trace Output 창의 툴바에서 더하기 기호 아이콘을 클릭합니다. 새로운 변수에 대한 필드가 포함된 Watch List 탭이 표시됩니다.
    2. 조사하려는 변수의 이름을 입력한 다음 Enter 키를 누릅니다.
  6. 조사 목록에서 변수를 제거하려면 Watch List 탭에서 변수를 선택한 다음 Trace Output 창의 툴바에서 빼기 기호 아이콘을 클릭합니다.
  7. 이 조사 목록을 저장하려면 Trace Output 창의 툴바에서 Tools 아이콘 을 클릭한 다음 Save Watch List을(를) 클릭합니다. 목록이 Studio에 저장됩니다. 스크립트에서 추적을 실행할 때마다 조사 목록이 Trace Output 창에 로드됩니다.
  8. 조사 목록에서 변수를 조사할 준비가 되면 스크립트에서 새로운 추적을 실행합니다.