디버그 스크립트

필수 권한: 애플리케이션 > 스튜디오 > 스크립트 > 디버그

Studio은(는) 스크립트에서 문제를 검토하는 방법을 두 가지 제공하는데, 그 방법은

  • 구문 오류 검토, 그리고
  • 스크립트 추적 실행입니다. 이를 수행하면 스크립트가 각 작업을 처리하면서 일어나는 일을 보여줍니다.

스크립트에 Snippet 작업이 있는 경우에는 Snippet Editor 창에서 스니펫 코드를 디버그할 수 있습니다.

구문 오류 검토하기

구문 오류를 검토할 때는 스크립트에서 검색되는 모든 문제가 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 탭에서 경고나 오류를 두 번 클릭하여 이슈가 발생한 캔버스의 작업을 확인할 수 있습니다.

스크립트 추적

Trace Output 도구로 스크립트의 진행 상황과 성과를 추적할 수 있습니다. 이 도구는 스크립트를 통해 컨택을 추적하고 시행된 각 작업의 결과, 설정된 변수의 종류와 시기, 각 지점에서 보유된 변수의 값을 표시합니다. 스크립트를 테스팅 및 디버그하기에 유용한 도구입니다. 라이브 상호작용 또는 시뮬레이션된 상호작용에 대해 추적을 실행할 수 있습니다.

스크립트가 저장될 때만 추적을 실행할 수 있습니다. 저장되지 않은 변경 사항이 있는 상태에서 스크립트 추적 실행을 시도하면 Studio에서 스크립트를 저장하라고 안내합니다. 스크립트에 오류가 있으면 Studio은(는) 스크립트를 저장하지 않습니다. 스크립트를 저장하고 추적을 실행하기 전에 오류를 해결해야 합니다. 스크립트에 validation errors가 발생하면 Studio이(가) 유효성 검사 오류가 발생하지 않은 스크립트의 마지막 버전으로 돌아갑니다. 추적을 시작하면 실행되지만 가장 최근에 저장된 스크립트 버전으로 실행됩니다.

Trace Output 창 사용하기

추적을 실행할 때는 Trace Output 창에 출력이 표시됩니다. 이 창을 사용하여 스크립트의 변수를 보고 각 작업닫힘 고객 데이터 모음, 메시지 또는 음악 재생 또는 상담원에게 컨택 라우팅과 같은 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 탭에 표시되는 변수를 변경합니다.

    필드 세부 정보
    Show Global Variables in Subs 전역 변수가 Variables 탭에 표시되기를 원하면 이 옵션을 선택하십시오. 이 스크립트에서 설정된 전역 변수 또는 다른 스크립트에서 설정되었으며 이 스크립트에서 사용할 수 있는 전역 변수가 포함됩니다. 예를 들면 하위 스크립트가 이에 해당합니다.

    Show System Variables

    사전 정의된 시스템 변수가 Variables 탭에 표시되기를 원하면 이 옵션을 선택하십시오. 스크립트 내의 작업을 포함하여 시스템에 의해 스크립트에 자동으로 추가되는 변수가 있습니다.
    Show Private Members 비공개 구성원이 Variables 탭에 표시되기를 원하면 이 옵션을 선택하십시오.
  6. Properties 창에서 선택한 작업의 속성과 구성하는 방식을 볼 수 있습니다.
  7. 추적을 통해 특정한 변수를 추적하려면 조사 목록에 변수를 추가합니다.

추적의 변수 가시성 변경

추적에서 표시할 변수 세트를 변경할 수 있습니다. 추적에서 찾는 사항에 따라 특정한 종류의 변수에 집중할 수 있습니다.

  1. Studio에서 스크립트를 열고 추적을 실행합니다.
  2. Trace Output 창의 툴바에서 Tools 아이콘 을 클릭합니다.

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

    필드 세부 정보
    Show Global Variables in Subs 전역 변수가 Variables 탭에 표시되기를 원하면 이 옵션을 선택하십시오. 이 스크립트에서 설정된 전역 변수 또는 다른 스크립트에서 설정되었으며 이 스크립트에서 사용할 수 있는 전역 변수가 포함됩니다. 예를 들면 하위 스크립트가 이에 해당합니다.

    Show System Variables

    사전 정의된 시스템 변수가 Variables 탭에 표시되기를 원하면 이 옵션을 선택하십시오. 스크립트 내의 작업을 포함하여 시스템에 의해 스크립트에 자동으로 추가되는 변수가 있습니다.
    Show Private Members 비공개 구성원이 Variables 탭에 표시되기를 원하면 이 옵션을 선택하십시오.

스크립트 추적 캡처

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

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

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

연속 추적은 스크립트에서 처리하는 모든 상호작용을 캡처합니다. 추적 출력은 CXone 사업부닫힘 고급 조직 그룹화는 CXone 환경을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다. 에 파일로 저장됩니다. 파일을 저장할 위치를 지정할 수 있습니다.

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

추적 파일 보기

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

  1. Studio에서 Debug 메뉴를 클릭한 다음 시스템에 있는 추적 파일 또는 CXone 사업부닫힘 고급 조직 그룹화는 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. 조사 목록에서 변수를 조사할 준비가 되면 스크립트에서 새로운 추적을 실행합니다.